Перейти к содержимому

Получение результата обработки

Метод report АТОЛ Онлайн v5 - получение результата фискализации по uuid, структура payload и проверка кодов маркировки.

Результат регистрации чека на ККТ может быть получен двумя способами:

  1. Callback - если в запросе регистрации был указан service.callback_url, сервис по результатам обработки отправит POST-запрос на этот URL.
  2. Опрос - если callback_url не указан или запрос не пришел в течение 300 секунд с момента отправки чека, запросите результат GET-запросом.

Пакет с результатом одинаков для обоих способов.

Срок хранения - 30 суток

Методом можно пользоваться только для чеков, с даты отправки которых прошло не более 30 суток (фактический срок зависит от настроек сервиса). Для более старых чеков обратитесь в техподдержку АТОЛ Онлайн, указав наименование компании, код группы и период по дате отправки.

Запрос

http
GET https://online.atol.ru/possystem/v5/<group_code>/report/<uuid>
Token: <token>
ПараметрОписание
group_codeИдентификатор группы ККТ
uuidИдентификатор, присвоенный документу при регистрации
tokenАвторизационный токен (заголовок или ?token=)

Ответ

json
{
  "uuid": "2ea26f17-0884-4f08-b120-306fc096a58f",
  "error": null,
  "status": "done",
  "payload": {
    "total": 1598,
    "fns_site": "www.nalog.ru",
    "fn_number": "1110000100238211",
    "shift_number": 23,
    "receipt_datetime": "12.04.2022 20:16:00",
    "fiscal_receipt_number": 6,
    "fiscal_document_number": 133,
    "ecr_registration_number": "0000111118041361",
    "fiscal_document_attribute": 3449555941,
    "ofd_inn": "7709364346",
    "ofd_receipt_url": "https://consumer.1-ofd.ru/v1?fn=9288000100014915&fp=3004144185&i=108",
    "marks_result": [
      { "position": 0, "mark_code": "MDE1MDc1…", "result": 15 }
    ]
  },
  "timestamp": "12.04.2022 20:15:08",
  "group_code": "group1",
  "daemon_code": "prod-agent-1",
  "device_code": "KSR13.00-1-11",
  "external_id": "TRF10601_1",
  "callback_url": ""
}
json
{
  "error": {
    "error_id": "475d6d8d-844d-4d05-aa8b-e3dbdf4defd6",
    "code": 34,
    "text": "Состояние чека не найдено. Попробуйте позднее",
    "type": "system"
  },
  "status": "wait",
  "timestamp": "12.04.2022 18:58:38",
  "callback_url": ""
}

Поля ответа

ПолеТипОписание
uuidstringУникальный идентификатор документа
timestampstringДата и время документа
callback_urlstringURL для ответа после обработки
statusstringdone - зарегистрирован; fail - ошибка; wait - ожидание
group_codestringИдентификатор группы ККТ
daemon_codestringНаименование сервера
device_codestringКод ККТ
external_idstringИдентификатор документа внешней системы
errorobjectОшибка: error_id, code, text, type (system - системная ошибка / agent - ошибка агента на стороне ККТ / driver - ошибка кассы / timeout - превышено время ожидания, 300 с / unknown). При permissive_mode: true дополнительно приходит массив permissive_mode_result с результатами проверки кодов маркировки в ГИС МТ - его состав см. в разделе 5.3 описания протокола v5
warningsobjectcallback_url: «callback_url не соответствует маске» - если URL в запросе был некорректен
payloadobjectРеквизиты фискализации (см. ниже)

Объект payload

ПолеТипТег ФФДОписание
fiscal_receipt_numberinteger1042Номер чека в смене
shift_numberinteger1038Номер смены
receipt_datetimestring1012Дата и время документа из ФН
totalnumber1020Итоговая сумма документа (фактическая - суммирование sum позиций)
fn_numberstring1041Номер ФН
ecr_registration_numberstring1037Регистрационный номер ККТ
fiscal_document_numberinteger1040Фискальный номер документа
fiscal_document_attributeinteger1077Фискальный признак документа (ФПД)
fns_sitestring1060Адрес сайта ФНС
ofd_innstring1017ИНН ОФД
ofd_receipt_urlstring-URL чека на сайте ОФД. Только для Платформа ОФД, Первый ОФД, Такском ОФД
marks_resultarray-Результаты проверки кодов маркировки (если в чеке были КМ)

Массив marks_result

ПолеТипОписание
positionnumberНомер позиции с кодом маркировки в исходном чеке, начиная с 0
mark_codestringКМ, переданный в исходном чеке
resultnumberРезультат проверки (тег 2106, см. ниже)

Значения result (тег 2106)

resultБиты 2106Описание
000000000Проверка КП КМ не выполнена, статус товара ОИСМ не проверен
100000001Проверка в ФН с отрицательным результатом, статус ОИСМ не проверен
300000011Проверка с положительным результатом, статус ОИСМ не проверен
500000101Проверка с отрицательным результатом, статус товара у ОИСМ некорректен
700000111Проверка с положительным результатом, статус товара у ОИСМ некорректен
1500001111Проверка с положительным результатом, статус товара у ОИСМ корректен
1600010000Проверка не выполнена, статус не проверен (ККТ в автономном режиме)
1700010001Проверка в ФН отрицательная (ККТ в автономном режиме)
1900010011Проверка в ФН положительная (ККТ в автономном режиме)

Рекомендованная стратегия опроса

text
1. Отправили чек -> получили uuid (status=wait)
2. Ждете callback 300 секунд (если указывали callback_url)
3. Нет callback -> GET /report/{uuid}
   - status=done -> сохраняете payload (ФД, ФПД, ссылку ОФД)
   - status=wait (code=34) -> повторите позже (чек еще в очереди),
     повторно отправлять чек НЕ нужно
   - status=fail -> анализируете error.code по справочнику ошибок