Перейти к содержанию

Отправка колбэка

Отправка коллбэка с информацией о чеке при изменении статуса. Колбэк задается в личном кабинете Мерчанта в технических настройках магазина. Необходимо выбрать тип колбэка SMZ Receipt Callback.

Метод: POST

Параметры

Название Тип данных Описание
receipt_id integer Уникальный идентификатор чека
status string Cтатус чека
message string Cообщение об ошибке, в случае неуспешного пробития чека
remote_url string Url адрес сформированного чека
merchant_inn string ИНН ЮЛ
merchant_name string Название ЮЛ
client json Информация самозанятого, связанный с чеком
{
  "receipt_id": 22,
  "status": "canceled",
  "message": null,
  "receipt_url": "https://lknpd.nalog.ru/api/v1/receipt/660911425203/211ff3ctvd/print",
  "merchant_name": "Рога и Копыта",
  "merchant_inn": "4086969419",
  "client": {
    "inn": "660911425203"
  }
}

Заголовки

Также в заголовках запроса передаются:

  • X-Api-Key - уникальный идентификатор магазина
  • X-Signature - подпись запроса

Формирование подписи:

sha256({api-key}{request_body}{secret-key})

где request_body - тело запроса в формате строки:

{\"receipt_id\":22,\"status\":\"canceled\",\"message\":null,\"receipt_url\":\"https://lknpd.nalog.ru/api/v1/receipt/660911425203/211ff3ctvd/print\",\"merchant_name\":\"РогаиКопыта\",\"merchant_inn\":\"4086969419\",\"client\":{\"inn\":\"660911425203\"}}

Доставка колбэка

Отправка колбэка считается успешной, если ответ от сервера мерчанта вернёт статус HTTP-код 200. Любой другой HTTP-код в ответе означает, что запрос не доставлен.

Если первая отправка была неуспешной, то будет предпринято еще 5 попыток каждые 10 минут.