Закажите обратный звонок
Введите свои данные и мы Вам перезвоним
Нажимая на кнопку, вы даете согласие на обработку персональных данных и соглашаетесь c политикой конфиденциальности.
Заказ Салют-08Ф
Введите свои данные и мы Вам перезвоним для уточнения заказа
Нажимая на кнопку, вы даете согласие на обработку персональных данных и соглашаетесь c политикой конфиденциальности.
Заказать банковский терминал Салют-08
Введите свои данные и мы Вам перезвоним для уточнения заказа
Нажимая на кнопку, вы даете согласие на обработку персональных данных и соглашаетесь c политикой конфиденциальности.
Заказ Салют-12Ф
Введите свои данные и мы Вам перезвоним для уточнения заказа
Нажимая на кнопку, вы даете согласие на обработку персональных данных и соглашаетесь c политикой конфиденциальности.
Введение
Сервер работает по протоколу JSON-RPC 2.0. На данный момент сервер работает по версии формат фискальных данных 1.05.

С помощью POST запросов отправляем данные (строку с JSON-RPC 2.0) на сервер по адресу, указанному в настройках кассы.

Данные отправлять в запросе как "x-www-form-urlencoded" с ключом "jsonrpc".

Внимание! Перед использованием сервера убедитесь, что время на кассовом терминале, на котором запущен сервер, установлено правильно. После открытия фискального режима время изменить уже не получится.

Все параметры методов являются обязательными, кроме тех, которые помечены меткой (не обяз.).

Коды ошибок соответствуют JSON-RPC 2.0. Описание ошибок содержит сообщение о причине ошибки.


Метод "openFiscalRegime"
Необходимые данные:

name — наименование пользователя(организации), тег 1048, является обязательным полем. Тип переменной - строка. Пример «Рога и копыта». Максимальная длина переменной составляет 256 символа.

inn — ИНН пользователя(организации), тег 1018, является обязательным полем. Тип переменной - строка. Пример «1234567890». Имеет длину 10 или 12 символов.

cashier — фамилия и инициалы кассира, тег 1021, является обязательным полем. При работе в автоматическом режиме не указывается. Тип переменной - строка. Пример «Иванов И.И». Максимальная длина переменной составляет 64 символа.

cashierInn — ИНН кассира, тег 1203, является не обязательным полем. При работе в автоматическом режиме не указывается. Тип переменной - строка. Пример «1234567890». Имеет длину 10 или 12 символов.

ofdInn — ИНН ОФД, тег 1017, является обязательным полем в случае применения ККТ в режиме передачи данных. При работе в автономном режиме переменная принимает значение равное «000000000000». Тип переменной - строка. Пример «1234567890». Имеет длину 10 или 12 символов.

ofdName — наименование ОФД, тег 1046, является обязательным полем в случае применения ККТ в режиме передачи данных. Типа переменной - строка. Пример «Тестовый ОФД». Максимальная длина переменной составляет 256 символов.

email — адрес электронной почты отправителя чека, тег 1117, указывается во всех случаях, за исключением случая применения ККТ в автономном режиме.. Тип переменной - строка. Пример «test@test.ru». Максимальная длина переменной составляет 64 символа.

rnKkt — регистрационный номер ККТ, тег 1037, является обязательным полем. Тип переменной - строка. Пример «0000000001026963». Имеет фиксированную длину 20 символов.

paymentAddress — адрес расчетов, тег 1009, включаются в состав ФД во всех случаях, за исключением регистрации ККТ для развозной и (или) разносной торговли (оказания услуг, выполнения работ) и при регистрации ККТ в автоматических устройствах, в случае применения ККТ в режиме передачи данных в составе нескольких автоматических устройств. Тип переменной - строка. Пример «ул. Ленина 234». Максимальная длина переменной составляет 256 символа.

placePayment — место расчетов, тег 1187, включаются в состав ФД во всех случаях, за исключением регистрации ККТ для развозной и (или) разносной торговли (оказания услуг, выполнения работ) и при регистрации ККТ в автоматических устройствах, в случае применения ККТ в режиме передачи данных в составе нескольких автоматических устройств. Тип переменной - строка. Пример «бутик №4». Максимальная длина переменной составляет 256 символа.

timerReconnectOfd — интервал соединения с ОФД указывается в секундах. Тип переменной - целое. Пример «30».

timerRequestFisDoc — интервал опроса ФН указывается в секундах. Тип переменной - целое. Пример «30».

ofdSite — сайт ОФД, является обязательным полем в случае применения ККТ в режиме передачи данных. Тип переменной - строка. Пример «109.73.43.4».

ofdPort — порт сайта ОФД, является обязательным полем в случае применения ККТ в режиме передачи данных. Тип переменной - целое. Пример «19086».

taxationSystems — список применяемых систем налогообложения. Является обязательным параметром содержит сведения о системах налогообложения, которые могут применяться пользователем при применении регистрируемого экземпляра ККТ. Тип переменной - список строк. Пример «ENVD, ESN, OSN, PATENT ,USN_INCOME, USN_INCOME_CONSUMPTION».

agentTypes — список признаков агента, включается в состав ФД с единичным значением при наличии соответствующих причин. Тип переменной - список строк. Пример «AGENT, ATTORNEY_AGENT, BANK_PAYING_AGENT, BANK_PAYING_SUBAGENT, COMMISSION_AGENT, PAYING_AGENT, PAYING_SUBAGENT».

Режимы применения ккт (не обязательно) — существуют следующие режимы работы ККТ:

encryption — признак шифрования, тег 1056, при наличии offlineMode (признак автономного режима, тег 1002) не указывается, тип переменной - логический.

offlineMode — признак автономного режима, тег 1002, при наличии encryption (тег 1056) не указывается, тип переменной - логический.

autoMode — признак автоматического режима, тег 1001, при наличии в составе ФД реквизита ФД должен содержать реквизит automateNumber (номер автомата, тег 1036), в случае применения ККТ в составе одного автоматического устройства, тип переменной - логический.

bsoRegime — признак АС БСО, тег 1110, тип переменной - логический.

internetRegime (тип логическое значение).

Признак агента (не обязательно) — существуют следующие признаки агентов:


· Банковский платежный агент — usingBankPaymentAgent (тип логическое значение);

· Банковский платежный субагент — usingBankPaymentSubAgent (тип логическое значение);

· Платежный агент — usingPaymentAgent (тип логическое значение);

· Платежный субагент — usingPaymentSubAgent (тип логическое значение);

· Комиссионер — usingCommissionAgent (тип логическое значение);

· АС БСО — bsoRegime (тип логическое значение);

· ККТ для интернет — internetRegime (тип логическое значение).



Системы налогообложения (по умолчанию ОСН), версия формата фискальных данных (по умолчанию будет выбираться 1.05), наименование оператора фискальных данных (ОФД), ИНН ОФД, порт сервера ОФД, интервал опроса ФН (не обязательно по умолчанию будет 30с), интервал соединения с ОФД (не обязательно по умолчанию будет 30с).


Описание: регистрация ККТ  
Примеры JSON-RPC 2.0:
Запрос:
{
   "jsonrpc":"2.0",
   "method":"openFiscalRegime",
   "params":{
      "json":{
         "name":"Инженерный стапель",
         "cashier":"Иванов И. И.",
         "inn":"0275912185",
         "ofdInn":"421534781245",
         "email":"test@test.ru",
         "ofdName":"Первый ОФД",
         "rnKkt":"0000000001026963",
         "paymentAddress":"г.Уфа ул. Пушкина д. 23",
         "placePayment":"Рынок",
         "timerReconnectOfd":"30",
         "ofdSite":"kkm-server-test.1-ofd.ru",
         "ofdPort":"7777",
         "timerRequestFisDoc":"30",
         "taxationSystems":[
            "OSN"
         ],
         "agentTypes":[
            "COMMISSION_AGENT"
         ],
         "usingCommissionAgent":true,
         "taxSite":"www.nalog.ru"
      },
      "needPrint":true
   },
   "id":1
}
Метод "refiscalizationFisDrv"
Описание: перерегистрация ККТ

Параметры (ключ - тип значения):

«json» - String (сериализованный объект класса openFiscalRegime)

Данный метод позволяет произвести перерегистрацию фискального накопителя, в результате чего будет создан отчет о перерегистрации фискального накопителя. При любом изменении настроек регистрации необходима перерегистрация ФН.

Перерегистрация ФН возможна только в том случае, когда ККТ работает с зарегистрированным ФН.

Входные параметры:
  • "json" - String (сериализованный объект класса OpenFiscalRegime параметр cashier обязательный)
  • "refiscalizationReasons" - List<String> (сериализованный список с причинами(ой) перерегистрации, возможные значения причин указаны в разделе "Описание значений параметров", максимальное количество причин в списке - не более 3х)
  • "needPrint" – Boolean (необходимость печати чека)
  • "allowWithoutVerification" – Boolean (перерегистрация без получения подтверждений фискальных документов)

Выходные параметры:

  • "result" - String (сериализованный объект класса OpenFiscalRegime)

Примеры JSON-RPC 2.0:
Примеры запроса при изменении настроек ККТ:
Пример 1: 
{
   "jsonrpc":"2.0",
   "method":"refiscalizationFisDrv",
   "params":{
      "json":{
         "name":"Инженерный стапель",
         "cashier":"Иванов И. И.",
         "ofdInn":"7709364346",
         "email":"test@test.ru",
         "ofdName":"Атлас карт ОФД",
         "rnKkt":"0000000001026963",
         "paymentAddress":"г.Уфа ул. Пушкина д. 23",
         "placePayment":"Рынок",
         "timerReconnectOfd":"30",
         "ofdSite":"109.73.43.4",
         "ofdPort":"19086",
         "timerRequestFisDoc":"30",
         "taxationSystems":[
            "OSN"
         ],
         "taxSite":"www.nalog.ru"
      },
      "refiscalizationReasons":[
         "KKT_PROPS_EDIT"
      ],
      "needPrint":true,
      "allowWithoutVerification":true
   },
   "id":9
}

Примеры запроса при замене ФН без изменения реквизитов:
Пример 2:
Formatted JSON Data
{
   "jsonrpc":"2.0",
   "method":"refiscalizationFisDrv",
   "params":{
      "json":{
         "cashier":"Иванов И. И."
      },
      "refiscalizationReasons":[
         "FIS_DRV_REPLACE"
      ],
      "needPrint":true,
      "allowWithoutVerification":true
   },
   "id":10
}

Примеры запроса при замене ФН с изменением реквизитов:
Пример 3:
{
   "jsonrpc":"2.0",
   "method":"refiscalizationFisDrv",
   "params":{
      "json":{
         "cashier":"Иванов И. И.",
         "paymentAddress":"г.Уфа ул. Пушкина д. 27"
      },
      "refiscalizationReasons":[
         "KKT_PROPS_EDIT",
         "FIS_DRV_REPLACE"
      ],
      "needPrint":true,
      "allowWithoutVerification":true
   },
   "id":9
}