Подключение онлайн кассы. Настройка API, HTTP; POST, Контейнер JSON

Добрый вечер. Сергей.

В связи с загруженностью, не смог во время отреагировать на заданный Вами вопрос, на данный момент вопрос по интеграции онлайн кассы приоритетный.

Высылаю Вам фото самой онлайн кассы (ОС - Android)

а так же  полный текст APİ,  

Описание API SmartOne Cashbox

В качестве транспорта для API выступает HTTP  проткол, порт  по умолчанию 8008, запросы отправляются методом POST.  Запрос имеет два параметра: data - сообщение и sign - подпись. Контейнером сообщения является JSON. Строка с json кодируется Base64, знаки «равно» экранируются с помощью urlencode.

Подпись генерируется как base64encode от sha1 (в hex) от параметра data + merchantID. Параметр merchantID выдается при регистрации кассы.

Протокол включает а себя следующие запросы:

• /sale - отправка счета продажи в SmartOne Cashbox для оплаты и фискализации
• /refund - отправка счета возврата
• /check_status - проверка состояния счета (только при работе с кассой)
• /x_report – X отчет
• /open_shift – открытие смены
• /close_shift – закрытие смены
• /deposit – внесение в кассу
• /withdraw - инкассация

• Отправка счета в SmartOne Cashbox
• /sale
• 
  

Параметры:

{

 "docNumber":  string, номер документа в системе учета,

 "employeeName": string, ФИО кассира,

 "amount":  integer, сумма документа в копейках,

 "currency": string, наименование валюты,

 "items": список товаров/услуг по счету

    [{

     "itemId": string, код товара/услуги в системе учета

             "itemName": string, наименование товара/услуги

             "itemQRCode": QR-code системы идентификации товара

             "itemQty": integer, кол-во*1000

             "itemAmount": integer, сумма к оплате в копейках

             "discount": integer, сумма скидки в копейках

             "itemTaxes": список налогов по позиции

             [{

                  "taxName": string, наименование налога

                  "taxPrc": integer, процент налога*100

               }

               …

             ]

        }

        ...

    ],

    "payments" : {   блок оплаты

               "cashAmount": integer, сумма оплаты наличными в копейках

               "cashlessAmount": integer, сумма оплаты безналичными в копейках

               "otherAmount": integer, сумма оплаты прочими видами оплат в копейках

    }

}

Необязательные параметры: скидка, qr-code, налоги

Возврат:

{

 "status": "success" | "error"

 "code": integer, код ошибки:

               0 – нет ошибки

               1 – ошибка авторизации

               2 – некорректный формат JSON

               3 – не переданы обязательныве параметры

               4 – сумма по документу не соответсвует сумме по позициям

               5 – внутрення ошибка

               6 – не открыта смена

               7 – тип оплаты не поддерживается

               8 – документ не полностью оплачен (при автоматической фискализации)

"message": string, текст ошибки, опционально

"documentID": integer, код документа в системе SmartOne Cashbox (при использовании кассы)

"fiscalID": string, фискальный код документа (использовать для возврата)

}

• Отправка счета возврата в SmartOne Cashbox
• /refund
• 
  
• Параметры запроса аналогичны счету продажи, дополнительно должен передаваться код документа продажи, товар которого возвращается:
• "parentDocID ": string, фискальный код документа продажи
• Параметры возврата аналогичны счету продажи.
• 
  
• 
  
• 
  
• 
  
• 
  
• Проверка состояния счета (только при работе с кассой)
• /check_status

Параметры:

{ "documentID": код счета }

Возврат:

{

   "status": "success" | "error"

   "code": integer, код ошибки:

               0 – нет ошибки

               1 – ошибка авторизации

               2 – некорректный формат JSON

               3 – не переданы обязательныве параметры

  "docStatus": integer:

               0 – счет не закрыт

               1 – счет закрыт

  "cashAmount": integer, сумма оплаты наличными в копейках

  "cashlessAmount": integer, сумма оплаты безналичными в копейках

  "transactionID": string, код транзакции оплаты картой

  "authCode": string, код авторизации

  "cardNum": string, номер платежной карты (в зависмости от платежной системы)

  "otherAmount": integer, сумма оплаты прочими видами оплат в копейках

  + блок записей счета, описанный в запросе /sale

}

• X отчет
• /x_report

Параметры:

{ "shiftID": код смены (только при работе с кассой), необязательный, по умолчанию – текущая открытая }

Возврат:

{

  "status": "success" | "error"

   "code": integer, код ошибки:

               0 – нет ошибки

               1 – ошибка авторизации

               2 – некорректный формат JSON

               6 – смена не найдена (по указанному коду или нет открытой смены в случае

               отсутствия кода)

               7 – тип оплаты не поддерживается (на кассе нет наличной оплаты)

  "shiftID": integer: код смены  (только при работе с кассой)

  "saleCount": integer: кол-во чеков продажи

  "saleSum": integer: сумма продаж

  "saleCashSum": integer: сумма продаж нал

  "saleCashlessSum": integer: сумма продаж безнал

  "saleCreditSum": integer: сумма продаж кредит

  "saleBonusSum": integer: сумма продаж бонусами

  "saleVatAmounts": integer: сумма налогов с продаж

  "depositCount": integer: кол-во внесений в кассу

  "depositSum": integer: итоговая сумма внесений за смену в копейках

  "withdrawCount": integer: кол-во инкассаций

  "withdrawSum": integer: итоговая сумма инкассаций за смену в копейках

  "moneyBackCount": integer: кол-во чеков возвратов

  "moneyBackSum": integer: сумма возвратов

  "moneyBackCashSum": integer: сумма возвратов нал

  "moneyBackCashlessSum": integer: сумма возвратов безнал

  "moneyBackCreditSum": integer: сумма возвратов кредит

  "moneyBackBonusSum": integer: сумма возвратов бонусами

  "moneyBackVatAmounts": integer: сумма налогов с возвратов

         }

• Открытие смены
• /open_shift

Параметры:

{ "employeeName": string, ФИО кассира,

  "pincode": пин-код (опционально)}

Возврат:

{

  "status": "success" | "error"

  "shiftID": код смены(только при работе с кассой)

  "code": integer, код ошибки:

               0 – нет ошибки

               2 – некорректный формат JSON

               5 – внутрення ошибка

               6 – смена уже открыта

}

• Закрытие смены
• /close_shift

Параметры:

{ "employeeName": string, ФИО кассира }

Возврат:

{

  "status": "success" | "error"

  "code": integer, код ошибки:

               0 – нет ошибки

               2 – некорректный формат JSON

               5 – внутрення ошибка

               6 – не открыта смена

  отчет по смене: (см. X-отчет)

}

• Внесение
• /deposit

Параметры:

{  

  "docNumber":  string, номер документа в системе учета, необязательно

  "employeeName": string, ФИО кассира,

  "amount":  integer, сумма документа в копейках,

  "currency": string, наименование валюты,

}

Возврат:

{

  "status": "success" | "error"

  "code": integer, код ошибки:

               0 – нет ошибки

               2 – некорректный формат JSON

               5 – внутрення ошибка

               6 – не открыта смена

"documentID": integer, код документа в системе SmartOne Cashbox

"fiscalNum": string, фискальный код документа

}

• Икассация
• /withdraw
• 
  
• Параметры запроса аналогичны запросу на внесение.

• Пример

• - merchant ID:
• 9662a13f5b4f46dbb1751bbbf86ed402
• 
  
• - данные запроса:
• {"docNumber":  "123","employeeName": "Иванов","amount":  15000,"currency": "AZN",
•  "items": [{"itemId": "1111", "itemName": "Семечки", "itemQRCode": "", "itemQty": 2000,
•  "itemAmount": 15000,"discount": 0,"itemTaxes": [{"taxName": "НДС","taxPrc": 1800}]}],
•  "payments" : {"cashAmount": 15000,"cashlessAmount": 0,"otherAmount": 0}}
• 
  
• - параметр data:
• eyJkb2NOdW1iZXIiOiAgIjEyMyIsImVtcGxveWVlTmFtZSI6ICLQmNCy0LDQvdC+0LIiLCJhbW91bnQiOiAgMTUwMDAsImN1cnJlbmN5IjogIkFaTiIsCiAiaXRlbXMiOiBbeyJpdGVtSWQiOiAiMTExMSIsICJpdGVtTmFtZSI6ICLQodC10LzQtdGH0LrQuCIsICJpdGVtUVJDb2RlIjogIiIsICJpdGVtUXR5IjogMjAwMCwKICJpdGVtQW1vdW50IjogMTUwMDAsImRpc2NvdW50IjogMCwiaXRlbVRheGVzIjogW3sidGF4TmFtZSI6ICLQndCU0KEiLCJ0YXhQcmMiOiAxODAwfV19XSwKICJwYXltZW50cyIgOiB7ImNhc2hBbW91bnQiOiAxNTAwMCwiY2FzaGxlc3NBbW91bnQiOiAwLCJvdGhlckFtb3VudCI6IDB9fQ%3D%3D
• 
  
• - sha1:
• fce95529d72466191683e02b17a8b1204c165a49
• 
  
• - параметр sign:
• ZmNlOTU1MjlkNzI0NjYxOTE2ODNlMDJiMTdhOGIxMjA0YzE2NWE0OQ%3D%3D

Прошу ознакомиться.

Связь по IP посредством HTTP-запросов - это идеальный вариант для взаимодействия с кассой из 1С. С драйверами часто проблемы разные бывают.

По новым правилам, за контакты в обсуждении задачи, можно на несколько дней "немым" стать. Так что поаккуратнее.

Ватсапа у меня нет. Но есть Скайп. Напишите мне в личные сообщения (я Вам написать не могу, т.к. у Вас заблокированы входящие сообщения), и я Вам там сообщу свой Скайп.