Ответ и статусы

актуальная

Формат ответа один для приёма документа и для статуса, на обоих каналах.

Пример

JSON

{
  "id": "07b2f33c-0eaf-4353-abbf-794654654654",
  "status": "OK",
  "qr": "https://…/ticket?date=20261102T101500&type=3&…&sum=61000",
  "amount": 610.00,
  "cashless": true,
  "shiftNumber": "42",
  "receiptNumber": "17",
  "fdNumber": "3160",
  "fpd": "1359586714023",
  "gnsDate": "20261102T101500",
  "rnKKM": "0000000000000000",
  "fnKKM": "0000000000000000",
  "kkmID": "65f1234567890abcdef12345"
}

Поля

Поле	Описание
`id`	GUID документа из запроса. В ответе `PROCESSING` поля нет
`status`	`OK`, `PROCESSING`, `ERROR`, `PAID`, `CANCELLED`, см. ниже
`info`	пояснение, при `ERROR` текст ошибки. Отказ налоговой приходит как есть, JSON строкой: `{"code":"400","error":"…"}`
`qr`	готовая ссылка проверки чека в ГНС. Кодируйте её в QR как есть. При `fiscal: false` поля нет
`amount`	сумма документа в сомах
`cashless`	признак безналичной оплаты
`shiftNumber`	номер смены
`receiptNumber`	порядковый номер чека в смене. Не путать с `fdNumber`. По TCP приходит сразу, по HTTP в ответе на статус его может не быть, тогда возьмите из поиска чека
`fdNumber`	номер фискального документа, он нужен для возврата
`fpd`	фискальный признак документа
`gnsDate`	дата и время документа, формат `20261102T101500`
`rnKKM`, `fnKKM`	регистрационный номер кассы и номер фискального модуля
`kkmID`	идентификатор кассы на сервере, постоянен для кассы. Вместе с `id` это ключ для поиска чека
`print`	печатные поля, только по запросу `needPrint: true`
`link`	ссылка на HTML-копию. Заполняется только старым синхронным методом и в `receipt-v2`, в ответах v4 пусто
`status_code`, `gnsResult`	служебные, обычно пусто. В операциях со сменой `gnsResult` содержит теги документа, см. смена

Часть полей может не прийти вовсе. Считайте отсутствие поля и null одним и тем же.

Статусы

Статус	Значение	Что делать
`OK`	в ответе на приём: документ принят. В ответе на статус: чек пробит, реквизиты в ответе	завершить операцию, сохранить `qr` и `fdNumber`
`PROCESSING`	документ в работе или ждёт очереди	спросить статус ещё раз
`PAID`	нефискальный документ `fiscal: false`: оплата картой прошла, чека нет	завершить операцию
`ERROR`	отказ, причина в `info`	см. ошибки
`CANCELLED`	оплата отменена на терминале: клиент не приложил карту, кассир отменил	считать документ непроведённым, для новой попытки новый `id`

Любой другой статус считайте неуспехом и сверяйте документ вручную: не повторяйте операцию автоматически.

Касса с SAM-картой

OK по чеку на кассе с фискальной SAM-картой значит «чек фискализирован», а не «документ уже в ГНС». Подробно на странице про нюансы каналов.