.. meta::
   :description: Сервис фискализации в SBC: отправка данных транзакций в налоговые органы и выдача фискальных чеков в соответствии с местным налоговым законодательством.

.. _fiscalization_service:

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


.. role:: ex

.. role:: code

Введение
^^^^^^^^^^^^^^^^^^^^^^^^^^

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

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

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

.. list-table::
   :widths: 30,30, 40
   :header-rows: 1
   :class: longtable

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

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

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

.. code-block:: none

    {
      "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:

.. list-table::
   :widths: 15, 15, 20, 50
   :header-rows: 1
   :class: longtable

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

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

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

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

.. code-block:: none

    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

.. ifconfig:: "doc.payneteasy.com" in site_link

   ----

   .. admonition:: See also
      :class: related-cross-link

      `Payment solutions for retail businesses → <https://payneteasy.com/branches/retail>`_

.. ifconfig:: "doc.payneteasy.ru" in site_link

   ----

   .. admonition:: См. также
      :class: related-cross-link

      `Решения для ритейла с фискализацией → <https://payneteasy.ru/branches/retail>`_