Страница 1 из 1

Неактуальная документация API

Добавлено: 26 ноя 2018, 19:59
Tonik992
Доброго дня.

На сайте тех. поддержки содержится неактуальная документация по API, в частности возвращаемое значение метода RegisterCheck.
https://kkmserver.ru/UnitServer#Primer

То, что описано в документации:

Код: Выделить всё

    // Возвращается JSON:
    //{
    //    "CheckNumber": 1,    // Номер документа
    //    "SessionNumber": 23, // Номер смены
    //    "URL": "https://ofd.ru/rec/7708806062/0000000006018032/9999078900002287/106/4160536402",
    //    "QRCode": "t=20170904T140900&s=0.01&fn=9999078900002287&i=106&fp=4160536402&n=1",
    //    "Command": "RegisterCheck",
    //    "Error": "",  // Текст ошибки если была - обязательно показать пользователю - по содержанию ошибки можно в 90% случаях понять как ее устранять
    //    "Status": 0   // Ok = 0, Run(Запущено на выполнение) = 1, Error = 2, NotFound(устройство не найдено) = 3, NotRun = 4
    //}
То, что возвращается по факту:

Код: Выделить всё

{
  "CheckNumber": 2000,
  "SessionNumber": 50,
  "SessionCheckNumber": 82,
  "URL": "http://taxcom.ru/ofd/",
  "QRCode": "t=20111111T154900&s=5430.00&fn=1110000100111111&i=1111&fp=1112225333&n=1",
  "Command": "RegisterCheck",
  "Error": "",
  "Status": 0,
  "IdCommand": "e4d170f5-e489-4b8a-9e1d-9c3a589a3f06",
  "NumDevice": 1,
  "UnitName": "Atol:  ККТ с передачей данных в ОФД (54-ФЗ)",
  "Url": null,
  "LoginAdmin": null,
  "PassAdmin": null,
  "Verson": null,
  "List": null
}
Один из важных параметров для реализации нашего бизнес-приложения - SessionCheckNumber, но его нет в документации.

Прошу администрацию при возможности актуализировать документацию по API.
Спасибо.

Re: Неактуальная документация API

Добавлено: 27 ноя 2018, 00:19
Audim
Какая версия kkmserver?
Какая модель ККТ?

Re: Неактуальная документация API

Добавлено: 27 ноя 2018, 13:57
Tonik992
ККМ сервер 2.1.22.15
АТОЛ 22Ф (FPrint-22ПТК)

Re: Неактуальная документация API

Добавлено: 27 ноя 2018, 21:58
Вторник
2.1.22.25, АТОЛ 55Ф

В ответе присутствует SessionCheckNumber:

Код: Выделить всё

2018-11-27 17:53:55,577 kkmserver-api [DEBUG] response: {"CheckNumber":40922,"SessionNumber":770,"SessionCheckNumber":43,"URL":"https://cash.kontur.ru/CashReceipt/...

Re: Неактуальная документация API

Добавлено: 27 ноя 2018, 22:21
Вторник
И месяц назад тоже было:

Код: Выделить всё

2018-10-28 00:15:44,861 kkmserver-api [DEBUG] response: {"CheckNumber":34693,"SessionNumber":709,"SessionCheckNumber":12,"URL":"https://cash.kontur.ru/CashReceipt/...
Не могу точно назвать версию KkmServer, но кажется это была 2.1.19.10.

Re: Неактуальная документация API

Добавлено: 27 ноя 2018, 23:24
andrew
SessionCheckNumber это номер чека внутри смены.
viewtopic.php?f=2&t=252&p=1645

Re: Неактуальная документация API

Добавлено: 28 ноя 2018, 13:33
Tonik992
У меня в ответе всё есть, я об этом писал.
Вся суть поста в том, что в документации к API этого поля нет. Как и некоторых других полей, которые у меня в ответе.

Основной документ, с которым я работаю при разработке/доработке, это документация на сайте https://kkmserver.ru/UnitServer#Primer
Но она неактуальная. Там не найти про поле SessionCheckNumber ничего. Суть поля ясна, если разбирать ответ -)

Re: Неактуальная документация API

Добавлено: 28 ноя 2018, 16:50
Tonik992
andrew писал(а):SessionCheckNumber это номер чека внутри смены.
viewtopic.php?f=2&t=252&p=1645
Есть еще одна особенность незадокументированная:
Если печатается фискальный чек на ККТ, у которой установлен МГМ, то SessionCheckNumber в свойствах не будет. Код возврата такой:

Код: Выделить всё

{
  "CheckNumber": 1,
  "SessionNumber": 1,
  "QRCode": "Ошибка чтения регистра 51/0/0 ",
  "Command": "RegisterCheck",
  "Error": "",
  "Status": 0,
  "IdCommand": "96ce0738-c4c9-4f1b-b454-43fe2dfcffa1",
  "NumDevice": 2,
  "UnitName": "Тест Антон",
  "Url": null,
  "LoginAdmin": null,
  "PassAdmin": null,
  "Verson": null,
  "List": null
}