Удаленная фискализация

Отправка уведомления об обработке документа

В случае, если в запросе отправки чека на печать в параметре callback_url, либо в личном кабинете Lifepay в разделе Фискализация -> Настройки был указан URL для уведомлений, Lifepay после обработки документа (смена статуса в “обработан”, “ожидает повтора”, “ошибка”) сформирует уведомление на указанный URL.

Тип запроса:

POST

Пример данных печати фискального документа продажи:


data: { "mode": "print", "type": "payment", "uuid": "0bf63680-1c0d-5af8-b10c-eb456c603cc7", "ext_id": null, "status": "printed", "attempt": 1, "command": "fiscalPrint", "printer": "atol", "datetime": "2017-05-11T16:51:24+03:00", "repeat_at": null, "error_code": null, "user_login": null, "fiscal_data": { "inn": "7725311535", "fnSn": "9999078900000753", "summ": 293.45, "fdNum": "1755", "kkmSn": "00106304012797", "kktNum": "10630414102016", "ofdUrl": "testgate.ofd.ru", "address": "115280, Москва, Ленинская слобода 19, ЭТАЖ 5, КОМНАТА 21Е1", "fdValue": "1441613171", "checkNum": "8", "username": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"СМАРТЛАЙН\"", "ofdStatus": { "fnError": 0, "ofdError": 0, "networkError": 0 }, "fdDatetime": "May 11, 2017 9:34:00 AM", "checkSession": "153" }, "callback_data": null, "error_message": null, "customer_email": null, "customer_phone": null, "printer_serial": "00106304012797", "purchase_amount": 293.45 }

Пример данных печати z-отчета:


data: { "mode": "print", "type": null, "uuid": "811a3d39-206f-5a14-b386-435639c68ac8", "ext_id": null, "status": "printed", "attempt": 1, "command": "zReport", "printer": "atol", "datetime": "2017-05-11 09:40:05.235234+03", "repeat_at": null, "error_code": null, "user_login": null, "fiscal_data": { "inn": "7725311535", "fnSn": "9999078900000753", "fdNum": "1756", "kkmSn": "00106304012797", "kktNum": "10630414102016", "ofdUrl": "testgate.ofd.ru", "address": "115280, Москва, Ленинская слобода 19, ЭТАЖ 5, КОМНАТА 21Е1", "fdValue": "2418475449", "revenue": 2685.45, "checkNum": "0", "username": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"СМАРТЛАЙН\"", "cashInSum": 0, "ofdStatus": { "fnError": 0, "ofdError": 0, "networkError": 0 }, "cashOutSum": 0, "fdDatetime": "May 11, 2017 9:39:00 AM", "incomeTotal": { "mcSum": 0, "cardSum": 200, "cashSum": 2485.45, "stornoSum": 0 }, "checkSession": "153", "outcomeTotal": { "mcSum": 0, "cardSum": 0, "cashSum": 0, "stornoSum": 0 }, "taxIncomeTotal": { "vat10Sum": 171.85, "vat18Sum": 35.24 }, "taxOutcomeTotal": { "vat10Sum": 0, "vat18Sum": 0 }, "discountIncomeTotal": { "sum": 0 }, "discountOutcomeTotal": { "sum": 0 } }, "callback_data": null, "error_message": null, "customer_email": null, "customer_phone": null, "printer_serial": "00106304012797", "purchase_amount": null }

Описание общих полей

Параметр Тип Описание
mode Строка Режим печати/отправки чека. Возможные значения:
print - распечатать чек (по умолчанию),
email - отправить электронный чек по email и/или смс,
print_email - распечатать чек и отправить по email и/или смс.
type Строка Тип. Возможные значения:
payment - приход;
refund - возврат прихода.
uuid Строка Уникальный идентификатор документа. При запросе отправки чека на печать возвращается в ответе в случае успешного создания.
ext_id Строка Идентификатор в сторонней системе, переданный в запросе отправки чека на печать.
status Строка Статус обработки документа. Возможные значения:
queued - в очереди;
in_progress - обрабатывается;
waiting_for_retry - ожидает повтора;
printed - обработан;
fail - ошибка;
attempt Целое Номер попытки печати.
command Строка Команда. Возможные значения:
fiscalPrint - печать фискального чека;
chequeCorrection - печать чека коррекции;
zReport - закрытие смены;
openSession - открытие смены;
xReport - печать x-отчета;
chpuPrint - печать дубликата фискального чека;
printer Строка Принтер, который использовался для печати. Возможные значения:
atol - АТОЛ;
shtrih - ШТРИХ;
mstar - МСТАР;
winbond - чекопечатающее устройство Winbond;
printer_serial Строка Серийный номер принтера.
datetime Строка Время обновления информации по документу в формате ISO 8601
repeat_at Строка Планируемое время повторной печати чека после неуспешной обработки в формате ISO 8601
error_code Строка Код ошибки от принтера.
error_message Строка Описание ошибки от принтера.
user_login Строка Логин пользователя, который совершил транзакцию с последующей фискализацией.
callback_data Строка|Объект|Массив Пользовательские данные, переданные в запросе отправки на печать.
customer_email Строка Email покупателя.
customer_phone Строка Телефон покупателя.
purchase_amount Вещественное Сумма покупки/возврата. Вычисляется по позициям в чеке.

Описание поля fiscal_data

Параметр Тип Фискальный чек z-отчет Описание
inn Строка + + ИНН организации
fnSn Строка + + Серийный номер фискального накопителя
summ Вещественное + - Сумма чека
fdNum Строка + + Номер фискального документа
kkmSn Строка + + Заводской номер ККМ
kktNum Строка + + Номер ККТ
ofdUrl Строка + + URL адрес (доменное имя) ОФД
address Строка + + Адрес расчета
fdValue Строка + + Фискальный признак фискального документа
checkNum Строка + + Номер документа (чека) в фискальном накопителе
username Строка + + Наименование организации
ofdStatus json + + Статус отправки документа в ОФД
fdDatetime Строка + + Дата и время фискального документа
checkSession Строка + + Номер смены
revenue Вещественное - + Выручка
cashInSum Вещественное - + Сумма всех внесений наличных
cashOutSum Вещественное - + Сумма всех выплат наличных
incomeTotal json - + Приход
outcomeTotal json - + Возврат прихода
taxIncomeTotal json - + Приход налогов по типам
taxOutcomeTotal json - + Возврат налогов по типам
discountIncomeTotal json - + Сумма скидок в приходе
discountOutcomeTotal json - + Сумма скидок в возврате прихода
Описание поля ofdStatus
Параметр Тип Описание
fnError Целое Код ошибки ФН
ofdError Целое Код ошибки ОФД
networkError Целое Код ошибки сети
Описание поля incomeTotal
Параметр Тип Описание
mcSum Вещественное Сумма прихода по мобильной коммерции
cardSum Вещественное Сумма прихода безналичным оплатам
cashSum Вещественное Сумма прихода наличным оплатам
stornoSum Вещественное Сумма сторно по приходу
Описание поля outcomeTotal
Параметр Тип Описание
mcSum Вещественное Сумма возврата прихода по мобильной коммерции
cardSum Вещественное Сумма возврата прихода безналичным оплатам
cashSum Вещественное Сумма возврата прихода наличным оплатам
stornoSum Вещественное Сумма сторно по возврату прихода
Описание поля taxIncomeTotal
Параметр Тип Описание
vat10Sum Вещественное Сумма налогов по приходу со ставкой 10%
vat18Sum Вещественное Сумма налогов по приходу со ставкой 18%
Описание поля taxOutcomeTotal
Параметр Тип Описание
vat10Sum Вещественное Сумма налогов по возврату прихода со ставкой 10%
vat18Sum Вещественное Сумма налогов по возврату прихода со ставкой 18%
Описание поля discountIncomeTotal
Параметр Тип Описание
sum Вещественное Сумма скидок по приходу
Описание поля discountOutcomeTotal
Параметр Тип Описание
sum Вещественное Сумма скидок по возврату прихода