Взаимодействие с ПК (Общие принципы работы)
Взаимодействие с ПК IKASSA multi(Dusik-r) происходит посредством программного интерфейса (API), ПК поставляется совместно с Руководством Программиста.
ПК подразумевает взаимодействие с использованием протоколов, построенных поверх TCP/IP (например - HTTP), посредством реализации протокола на стороне заказчика (клиента или партнера), либо использования стандартного интерфейса (GUI), который реализует базовый функционал ПК на основе протокола взаимодействия и требований.
Важно!
- Операции
ОтменаиКоррекцияне реализованы. - При проведении фискальных операций и формировании X и Z-отчетов информация об операциях совершенных иным способом безналичного расчета отображается как
Др. способыс указанием названия соответствующего способа совершения операции (при указании).
Описание полей исходящий пакетов
Исходящий пакет представляет из себя набор JSON полей:
| Название | Описание | Обязательность |
|---|---|---|
| type | Поле type служит для объявления типа передаваемого сообщения. Список поддерживаемых сообщений со временем может расширяться. | + |
| address | Данное поле требуется для идентификации сервиса (dispatcher), который будет обслуживать данное сообщение | + |
| data | Поле data содержит тело запроса. Тело запроса меняется в зависимости от обслуживающего сервиса, а так же исполняемой функции. | - |
| headers | Поле headers содержит в себе дополнительную информацию, которая требуется для выполнения операции. | - |
| headers.action | Поле headers обязано содержать поле action, в котором содержится название выполняемого метода в рамках сервиса. | + |
Описание полей пакета ответа от ПК
Структура ответа от ПК представляет из себя JSON, со следующими полями
| Название | Описание | Обязательность |
|---|---|---|
| type | Поле type служит для объявления типа передаваемого сообщения. Список поддерживаемых сообщений со временем может расширяться. | + |
| data | Поле data содержит тело запроса. Тело запроса меняется в зависимости от обслуживающего сервиса, а так же исполняемой функции. | - |
Инициализация ПК и СКО
ПК осуществляет опрос СКО, подключенного к ПК, по запросу. При безошибочном взаимодействии с СКО ПК проверяет список атрибутов СКО и сверяет их на соответствие Кода Оператора (далее - КО), и Учетного Номера Плательщика (далее - УНП). В случае несоответствия, СКО помечается, как недоступное, и отправляется событие на сервер ОПКС о несоответствии лицензии подключенному СКО.
ПК поддерживает постоянное подключение к серверам ОПКС.
Отправка документов из СКО на сервера ОПКС
После успешной авторизации по PIN-коду начинается отправка документов из ПК на сервера ОПКС.
Документы извлекаются из СКО последовательно, начиная с самого старого и удаляются из СКО при успешном сохранении на сервер ОПКС по 1 штуке за раз.
Извлечение документов происходит раз в 3 секунды для обеспечения стабильной и быстрой работы с СКО при совершении параллельных отправке документов запросов.