5.5. Сервис фискализации

Введение

Сервис фискализации используется для регистрации финансовых чеков и счетов в Платёжном Шлюзе SBC и их дальнейшей обработки. Фискализация поддерживается как для первоначальных, так и для рекуррентных транзакций Sale и Preauth через интеграцию Server-To-Server или Form. Подходящий сценарий интеграции см. в соответствующих примерах использования или уточните детали у менеджера службы поддержки. Транзакция с чеком/счётом обрабатывается Платёжным Шлюзом SBC с дополнительными запросами для налогового учёта.

Параметр сервиса фискализации (чек)

Чтобы инициировать транзакцию с использованием сервиса фискализации, Присоединяющаяся сторона отправляет HTTPS POST-запрос на Sale или Preauth с дополнительным параметром.

Параметры запроса	Проверка	Comment
cheque	Описание: Json string	Финансовый чек или счёт. Обязательно для запроса транзакции с фискализацией

Структура строки JSON для параметра чека

Пример простой строки JSON для параметра cheque:

{
  "cheque_type" : 1,
  "tax_system" : 1,
  "positions" : [
    {
      "quantity" : 2,
      "price" : 322.94,
      "tax" : 4,
      "description" : "Product/Service 1"
    },
    {
      "quantity" : 1,
      "price" : 500,
      "tax" : 4,
      "description" : "Product/Service 2"
    }
  ]
}

Параметры строки JSON:

Параметр	Проверка	Comment	Описание: Possible values
cheque_type	Десятичный	Тип/признак расчёта	0 — доход, 1 — расход, 2 — возврат дохода, 3 — возврат расхода
tax_system	Десятичный	Описание: Tax system	0 — общая система налогообложения, 1 — упрощённая система налогообложения доходов, 2 — упрощённая система «доходы минус расходы», 3 — единый налог на вменённый доход, 4 — единый сельскохозяйственный налог, 5 — патентная система налогообложения.
positions	Array	Массив товаров/услуг	Массив товаров/услуг
quantity	Десятичный	Количество товара/услуги
price	Десятичный	Цена за товар/услугу с учётом скидок и наценок
tax	Десятичный	Описание: value-added tax	1 — НДС 22%, 2 — НДС 10%, 3 — НДС 0%, 4 — без НДС, 5 — НДС 22/122, 6 — НДС 10/110
description	String(128)	Описание товара/услуги

Примечание

Обратите внимание: общая стоимость всех товаров/услуг, указанных в массиве positions, должна быть равна значению параметра amount в запросе Sale.

Пример запроса транзакции с фискализацией

Этот пример тела запроса Server-To-Server Sale с фискализацией показывает, как правильно включить параметр чека. Пример ответа приведён в документации соответствующей команды API.

client_orderid=902B4FF5
&order_desc=Test Order Description
&first_name=John
&last_name=Smith
&ssn=1267
&birthday=19820115
&address1=100 Main st
&city=Seattle
&state=WA
&zip_code=98102
&country=US
&phone=%2B12063582043
&cell_phone=%2B19023384543
&amount=700.00
&email=john.smith@gmail.com
&currency=USD
&ipaddress=65.153.12.232
&site_url=www.google.com
&credit_card_number=4538977399606732
&card_printed_name=CARD HOLDER
&expire_month=12
&expire_year=2099
&cvv2=123
&purpose=user_account1
&redirect_url=https://doc.sbctech.ru/doc/dummy.htm
&server_callback_url=https://httpstat.us/200
&merchant_data=VIP customer
&cheque={ "cheque_type" : 1, "tax_system" : 1, "positions" : [ { "quantity" : 2, "price" : 100.00, "tax" : 4, "description" : "Product/Service 1" }, { "quantity" : 1, "price" : 500, "tax" : 4, "description" : "Product/Service 2" } ] }
&control=768eb8162fc361a3e14150ec46e9a6dd8fbfa483