Нотификации - abr-tech/smorodina_kkt_api GitHub Wiki

Нотификации по http(s)

  • Метод: POST
  • Формат: application/json; charset=utf-8
  • Порт http/s: 80/443

Передаваемые параметры

Параметр Тип Описание
ok boolean Успешность выполнения
message string Сообщение об ошибки
code int Код ошибки
result Receipt Объект с данными о чеке
attributes object? Объект с атрибутами

Пример http(s)-нотификации

    {  
      "ok": true,
      "message": "OK",
      "code": 0,
      "receipt": {
          "id": "0133ce16b64ee4ae8e766d7b5b9d3f360d3d",
          "deviceSN": "1400000000000052",
          "deviceRN": "0000000400054952",
          "fsNumber": "9999078900001341",
          "ofdName": "ООО \"Ярус\" (\"ОФД-Я\")",
          "ofdWebsite": "www.ofd-ya.ru",
          "ofdinn": "7728699517",
          "fnsWebsite": "www.nalog.ru",
          "companyINN": "7725713770",
          "companyName": "ООО \"Кинопортал\"",
          "documentNumber": 4110,
          "shiftNumber": 2961,
          "documentIndex": 2667,
          "processedAt": "2018-08-17T10:19:00",
          "content": {
            "type": 1,
            "positions": [
              {
                "quantity": 1,
                "price": 700.00,
                "tax": 1,
                "text": "Билет в кино",
                "paymentMethodType": 4,
                "paymentSubjectType": 4
              }
            ],
            "checkClose": {
              "payments": [
                {
                  "type": 2,
                  "amount": 700.00
                }
              ],
              "taxationSystem": 0
            },
            "customerContact": "[email protected]"
          },
          "change": 0,
          "fp": "364831178"
        },
        "attributes": null
    }  

Ответ на http(s)-нотификацию

В случае успешной обработки нотификации организация должена вернуть ответ c HTTP кодом 200 и с телом сообщения OK без тегов и заглавными латинскими буквами.

NodeJS. Пример ответа на http(s)-нотификацию

res.send("OK");

PHP. Пример ответа на http(s)-нотификацию

<?php
    echo "OK";
?>

Java. Пример ответа на http(s)-нотификацию

Response.status(200).entity("OK").build();

В случае, если ответ «OK» не получен нотификация будет считаться неуспешной

Организация может запросить отправку всех неуспешных нотификаций из архива вызовом метода GetNotifications.