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

Mini web-сервер для печати чеков на фискальных регистраторах из мобильных приложений через HTTP запрос JSON.

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

Сообщение Tonik992 26 ноя 2018, 19:59

Доброго дня.

На сайте тех. поддержки содержится неактуальная документация по 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.
Спасибо.
Tonik992

 
Сообщений: 13
Зарегистрирован: 06 ноя 2018, 13:54

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

Сообщение Audim 27 ноя 2018, 00:19

Какая версия kkmserver?
Какая модель ККТ?
Audim
Администратор
 
Сообщений: 1328
Зарегистрирован: 17 мар 2015, 18:36

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

Сообщение Tonik992 27 ноя 2018, 13:57

ККМ сервер 2.1.22.15
АТОЛ 22Ф (FPrint-22ПТК)
Tonik992

 
Сообщений: 13
Зарегистрирован: 06 ноя 2018, 13:54

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/...
Аватара пользователя
Вторник

 
Сообщений: 151
Зарегистрирован: 16 май 2017, 08:36

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.
Аватара пользователя
Вторник

 
Сообщений: 151
Зарегистрирован: 16 май 2017, 08:36

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

Сообщение andrew 27 ноя 2018, 23:24

SessionCheckNumber это номер чека внутри смены.
viewtopic.php?f=2&t=252&p=1645
andrew

 
Сообщений: 100
Зарегистрирован: 05 июн 2017, 11:41

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

Сообщение Tonik992 28 ноя 2018, 13:33

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

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

 
Сообщений: 13
Зарегистрирован: 06 ноя 2018, 13:54

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

Сообщение Tonik992 28 ноя 2018, 16:50

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
}
Tonik992

 
Сообщений: 13
Зарегистрирован: 06 ноя 2018, 13:54


Вернуться в Форум поддержки KKM web-сервер


Кто сейчас на конференции

Сейчас этот форум просматривают: Google [Bot], Yandex [bot] и гости: 1

cron