Обработка 1С для печати чеков на облачной кассе ККТ АТОЛ.ОНЛАЙН + эквайринг ATOL.PAY

Основное назначение обработки - печать чеков на кассах АТОЛ.ОНЛАЙН из 1С. Обработка + зарегистрированная облачная касса могут использоваться в 1С как альтернатива или дополнение к физическим кассам организации.

На данный момент есть версии обработки для работы с кассами по протоколу API v4 / ФФД 1.05 и по протоколу API v5 / ФФД 1.2. Второй используется для товаров с обязательной маркировкой (Честный Знак). ФФД - формат фискальных данных.

В обработках на управляемых формах добавлен интернет-эквайринг АТОЛ.PAY: cоздание ссылок на форму оплаты по документам 1С и проверка оплаты.

Список параметров передаваемых с 1С для печати чека.

Данные для печати чека берутся с документа 1C. Список поддерживаемых документов дополняется, а также может быть изменен самостоятельно.
В БП 3.0 поддерживаются документы СчетНаОплатуПокупателю (ТЧ Товары), РеализацияТоваровУслуг (ТЧ Товары и Услуги), КорректировкаРеализации (ТЧ Товары и Услуги), ПоступлениеНаРасчетныйСчет (ТЧ РасшифровкаПлатежа).
УНФ 3 и Розница 3 - АктВыполненныхРабот (РаботыИУслуги), ЗаказПокупателя (Запасы, Доставка), РасходнаяНакладная (Запасы, Доставка), КорректировкаРеализации (Запасы, Доставка), ЧекККМ (Запасы), ПоступлениеНаСчет (ТЧ РасшифровкаПлатежа).
УТ 11, КА 2 и ERP 2 - АктВыполненныхРабот (Услуги), ЗаказКлиента (Товары), РеализацияТоваровУслуг (ТЧ Товары и Услуги), КорректировкаРеализации (ТЧ Товары и Услуги), РеализацияУслугПрочихАктивов (Доходы), ЧекККМ (Товары), ПоступлениеБезналичныхДенежныхСредств (ТЧ РасшифровкаПлатежа).
Розница 2 - ЗаказПокупателя (Товары), РеализацияТоваров (Товары), ЧекККМ продажи (Товары).
БП 2.0 - СчетНаОплатуПокупателю (ТЧ Товары и Услуги), РеализацияТоваровУслуг (ТЧ Товары и Услуги), КорректировкаРеализации (ТЧ Товары и Услуги).
УТ 10.3, КА 1.1, УПП 1.3 - ЗаказПокупателя (ТЧ Товары и Услуги), РеализацияТоваровУслуг (ТЧ Товары и Услуги), КорректировкаРеализации (ТЧ Товары и Услуги), ЧекККМ продажи (Товары).

Все параметры передаются одним HTTPS запросом на API АТОЛ.ОНЛАЙН (через промежуточный сервер upd2xml.ru, который выполняет функцию получения токена авторизации и затем основное действие - пробитие чека или получение ссылки на чек), при нажатии кнопки <Пробить чек>. В ответ приходит уникальный идентификатор чека UUID. Второй кнопкой <Получить ссылку на чек> можно запросить url (ссылку) чека на сайте оператора фискальных данных. При этом чек отобразится на форме обработки. Ссылку можно открыть в любом браузере или скопировать и отправить любым способом клиенту. (Добавлено). Кнопка Печать, печатная форма чека для печати копии чека на на чековой ленте 55-57 мм. Тестировалось на термопринтере Xprinter XP-58iih.

• login. Строка до 100 символов. Обязательный. Данный параметр берется в ЛК Атол.Онлайн, в параметрах интегратора.
• pass. Строка до 100 символов. Обязательный. Данный параметр берется в ЛК Атол.Онлайн, в параметрах интегратора.
• group_code. Строка до 100 символов. Обязательный. Данный параметр берется в ЛК Атол.Онлайн, в параметрах интегратора.
• timestamp. Дата и время документа в 1С. В чеке печатается дата и время установленное на кассе, в момент пробития чека.
• external_id. Уникальный идентификатор документа (РеализацииТоваров/РасходнойНакладной) в 1С.
• ИНН организации. Строка до 12 символов. Обязательный. ИНН должен совпадать с ИНН организации который был указан при регистрации кассы.
• Тип налогообложения организации. Выбирается из списка. Должен совпадать с типом налогообложения, указанным при регистрации кассы.
• Место расчетов (адрес) организации. Строка до 256 символов. Обязательный. В данном параметре лучше указывать адрес сайта.
• Email организации. Строка до 64 символов. Обязательный.
• Наименование или ФИО клиента. Строка до 256 символов. Необязательный.
• ИНН клиента. Строка до 12 символов. Обязательный при расчете с юр.лицами.
• Email клиента. Строка до 64 символов. Обязательный.
• Телефон клиента. Строка до 64 символов. Обязательный, если нет email. Для корректной отправки смс заполнять в формате: +[код_страны][номер], без пробелов и прочих разделителей.
• Вид оплаты. Наличный или безналичный расчет.
• Итоговая сумма по чеку. Число (обязательный), целая часть до 8 знаков, дробная не более 2-х. Данная сумма также подставляется в сумму оплаты (нал/безнал). Таким образом на данный момент обработка не подходит для частичных платежей.
• ФИО кассира. Строка до 64 символов. Необязательный.

Список передаваемых параметров по позициям (строкам) чека.

• Наименование. Строка до 128 символов. Обязательный.
• Единица измерения. Строка до 16 символов. Необязательный.
• Признак способа расчета. На данный момент обработка не подходит для частичных платежей, так как итоговая сумма по счету и сумма оплаты всегда совпадают.
• Признак предмета расчета. Выбирается из списка. Автоматически принимает значение товар, для строк с закладки Товары и услага, для строк с закладки Услуги.
• Количество. Число (обязательный), целая часть до 5 знаков, дробная не более 3-х. Максимальное значение – 99 999.999
• Цена. Число (обязательный), целая часть до 8 знаков, дробная не более 2-х. Максимальное значение – 42 949 672.95
• Сумма. Число (обязательный), целая часть до 8 знаков, дробная не более 2-х. Максимальное значение – 42 949 672.95
• Код товара. Массив строк. Необязательный. Используется в обработке ATOL API v5 для передачи кодов маркировки.
  Обработка берет коды маркировки, если они указаны в документе РеализацияТоваров (РасходнаяНакладная), в таблице ШтрихкодыУпаковок.
  Обработка передает только первые 31 символ кодов маркировки: (01) GTIN код товара/продукта + (21) серийный номер.
  (Не реализовано) Чтобы коды маркировки выводились из Честного знака необходимо добавлять код проверки и кодировать строку в base64, т.е. передавать коды в следующем виде:
  01[код_товара]21[серийный_номер][0x1D, он же символ GS]93[код_проверки] - (укороченный формат кода маркировки) данную строку зашифровать в base64
  или
  01[код_товара]21[серийный_номер][0x1D, он же символ GS]91[код_проверки][0x1D, он же символ GS]92[криптохвост] - (стандартный формат кода маркировки) данную строку зашифровать в base64.
• Ставка НДС. Выбирается из списка.
• Сумма НДС. Число (необязательный), целая часть до 8 знаков, дробная не более 2-х.
• Признак агента по предмету расчета. Необязательный: без признака / комиссионер / другой тип агента.
• ИНН поставщика. Строка до 12 символов. Необязательный.

Пример чека.

Примеры работы с обработкой.

Открывать и закрывать смену не надо. На облачной кассе это происходит автоматически.

Для формирования чека на закладке Документы, в списке выбираем нужный документ. На закладке Чек Приход проверяем данные по контрагенту (при необходимости задаем нужные значения): наименование (ФИО), ИНН (если есть), email и телефон. Табличная часть заполняется по документу. При необходимости можно также изменять данные, например установить нужные признак расчета (предоплата, полная передача и т.п.). В поле вид оплаты выбираем наличный или безналичный расчет.

Нажимаем кнопки:
1. Пробить чек. При успешной фискализации обработка получит уникальный идентификатор чека (UUID) в системе АТОЛ.ОНЛАЙН.
2. Получить ссылку на чек. Обработка получает ссылку на чек в ОФД (ОФД вы выбираете при регистрации кассы) и отображает чек на форме обработки. При необходимости чек можно распечатать или отправить повторно.
UUID чека, ссылка на чек сохраняются в 1С для каждого документа, в регистре сведений ДополнительныеСведения или ЗначениеСвойствОбъектов, и всегда доступны после пробития чека.
3. (Добавлено) Печать - Копию чека можно распечатать на термопринтере для чековых лент. Все фискальные данные для проверки чека на сайте ФНС / ОФД и QR-код присутствуют.

Чтобы сделать возврат необходимо открыть нужный чек прихода и установить флажок "Оформить возврат", расположенный снизу, над кнопками "Пробить чек" и "Получить ссылку на чек". Откроется третья закладка Возврат прихода, на нее надо перейти и нажать кнопки "Пробить чек" и "Получить ссылку на чек".

Добавлена возможность печати чеков по документам КорректировкаРеализации (кроме конфигурации РОЗНИЦА 2). Это дает возможность легко оформлять чеки при частичном возврате или обмене товара на другой.

Пробиваем чек по реализации на примере конфигурации БП 3.0.