API взаимодействия с интернет кассой

Общее описание

Взаимодействие с интернет-кассой осуществляется посредством обмена JSON сообщениями с web-сервисом.

Транспорт – https

Формат сообщений – JSON

Интернет-касса генерирует документы согласно ФФД 1.05. Документы генерируются фискальным накопителем(ФН), данный факт накладывает ограничение на кодировку передаваемых строк, обмен сообщениями по http с кассой осуществляется в кодировке UTF-8, но при записи в ФН строки передаются в кодировке CP866 которая поддерживает меньший набор символов, чем UTF-8, например, в CP866 отсутствуют символы «» и в ФН они не будут переданы вместо строки Напиток «Coca-cola» в документе будет Напиток Coca-cola.

Так же интернет-касса не занимается полноценным формато-логическим контролем данных, например, Телефон или электронный адрес покупателя, 1008 согласно ФФД имеет формат +{Н} или {С}@{С}, но интернет-касса примет любую строку от 1 до 64 символов, плюс интернет-касса не занимается контролем наличия/отсутствия различных тэгов агентских данных, поэтому рекомендуется ознакомиться с ФФД https://www.nalog.ru/html/sites/www.new.nalog.ru/doc/pril2_fns229_210317.docx и внимательно следить за форматами, наличием отсутствием тэгов в зависимости от вашего конкретного сценария работы. Еще одним моментом на который стоит обратить внимание, при организации взаимодействия с интернет-кассой, является ненадежность сети и как следствие сбои связанные с сетевым взаимодействием, в виду этого при неудачной отправке документа следует выполнить несколько повторов с приемлемым таймаутом, например, 5 попыток с интервалом 10-20 секунд(цифры приведены для наглядности и могут отличаться в зависимости от конкретной ситуации).

Адреса серверов

testflight https://тестконнект.смородина.онлайн/kktgate/api/v2/

production https://коннект.смородина.онлайн/kktgate/api/v2/

Личный кабинет

Для доступа к личному кабинету получите учетный данные у вашего менеджера.

Change log

Дата	Изменения
2019-03-26	Опубликован API для онлайн касс
2019-08-05	Добавлен APIv2