JSON-API для сервера ККМ. Пример открытия/закрытия смены.

< Назад
Содержание

Программное обеспечение предназначено для печати документов на фискальных регистраторах, онлайн-кассах или автоматизированных системах печати документов(АСПД) через сеть Интернет и ЛВС. Особенно актуально применение программы при печати чеков из терминальных сеансов Windows Server. В условиях подключения к серверу терминалов через интернет, в особенности через сети операторов мобильной связи, существует проблема медленной печати на ККМ. Эту задачу успешно решает «Сервер ККМ». Кроме этого, программа позволяет организовать многопользовательскую печать на ККМ с нескольких компьютеров.

Как использовать

Все вызовы методов — это GET или POST HTTP-запросы к URL   http://localhost:4398/PrintService/api/v1/ с некоторым набором параметров.

Начало работы.

Для того, чтобы приступить к работе с сервером ККМ по JSON-API, необходимо получить токен клиента. Для этого используется POST метод GetToken, В теле запрос передаются следующие параметры:

  • login — имя пользователя
  • password — пароль пользователя

Пример (в целях тестирования нужно использовать «login»: «First», «password»: «Second»):

JSON-запрос получения токена

Пример ответа на запрос:

JSON-ответ получения токена.
  • success — статус запроса (значение true — успешно, false — не успешно)
  • expire — дата окончания действия токена.
  • tokenId — токен.

Пример: Открытие Смены.

Открытие смены осуществляется POST методом Print ( http://localhost:4398/PrintService/api/v1/Print ).

JSON-запрос открытия смены.
  • cashier -кассир
    • name — ФИО кассира
    • vatin — ИНН кассира
  • type: операция, выполняемая Cервером ККМ, в данном примере openShift — открытие смены.
  • idClinet — токен клиента.
  • nameKkm — имя кассы, зарегистрированной на Сервере.

Ответ на запрос:

JSON-ответ открытия смены.
  • success — статус выполнения запроса (значение true — успешно, false — не успешно)
  • response — ответ
    • fnsUrl — url адрес налогового органа.
    • fnNumber — номер фискального накопителя.
    • registrationNumber -РНК.
    • fiscalDocumentDateTime — время ФД.
    • fiscalDocumentSign — Фискальный признак документа.
    • shiftNumber — номер смены.
    • fiscalDocumentNumber — номер фискального документа.
  • requestBody — тело входящего запроса

Пример: Закрытие Смены.

Закрытие смены производится аналогичным образом, с вышеприведенным примером, открытия смены. Отличие заключается в значении параметра «type», оно должно быть задано как closeShift.

Пример запроса и ответа:

JSON-запрос закрытия смены.
JSON-ответ закрытия смены

Авторизация
*
*

6 − четыре =

Регистрация
*
*
*

два + 14 =

Генерация пароля

6 − три =