# Описание API (коннектор АТОЛ Онлайн)

Сервис предназначен для удаленной регистрации (фискализации) чеков на арендованных клиентом у Эвотор кассах (ККТ) посредством разработанного клиентского API.

Версия сервиса v5 поддерживает регистрацию чеков формата фискальных данных версии 1.2 (ФФД 1.2) согласно вступившему в силу приказу ФНС России от 14.09.2020 № ЕД-7-20/662\@.

Для начала регистрации чеков через API необходимо предварительно пройти процедуру регистрации компании (магазина) и получить учетные данные (логин, пароль, код группы) посредством Личного кабинета Эвотор

## Общий алгоритм взаимодействия с сервисом через API

После получения учетных данных необходимо получить токен авторизации используя запрос, описанный в [соответствующем разделе](#avtorizaciya-polzovatelya).

Для отправки чека на регистрацию в ККТ необходимо воспользоваться [POST-запросом](#registraciya-dokumenta). В случае корректного запроса сервис пришлет ответ, содержащий уникальный идентификатор, присвоенный данному документу и статус.

Результат регистрации чека на ККТ может быть получен двумя способами:

* В случае, если в запросе на регистрацию был указан `callback_url`, сервис по результатам обработки чека вернет POST запрос на этот URL.
* В случае, если `callback_url` не был указан или запрос не пришел, клиент самостоятельно может запросить результат обработки чека GET-запросом к сервису, описанному в разделе

<img src="https://464872309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVtavGB6gohPx0xvftlzB%2Fuploads%2FwZyfp7lmJgaGujJMMFSX%2Fimage.png?alt=media&#x26;token=c91e1525-03eb-46b9-b314-8626f618a86d" alt="" data-size="original">

## Описание методов

### Авторизация пользователя

**Описание**

Для отправки чеков через API необходимо получить авторизационный токен одним из описанных ниже методов.

Авторизационный токен, дает право доступа к системе посредством интеграционного API в течение 24 часов с момента его формирования. Токен должен передаваться в качестве параметра во все методы API сервиса. Максимальная длина токена – 1000 символов.

Если в течение 24 часов с момента запроса токена повторно запросить токен, то вы получите новый токен и время его жизни будет так же 24 часа, либо ранее полученный токен и время его жизни будет 24 часа от момента первого получения клиентом этого токена. Количество одновременно действующих токенов, которые может получить клиент равно количеству реплик сервиса Эвотор, работающих в текущий момент. Рекомендуется запрашивать новый токен только при получении от сервиса ошибки об истечении времени жизни предыдущего токена.

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

**Запрос**

<mark style="background-color:green;">Метод POST</mark>

`https://fiscalization.evotor.ru/possystem/v5/getToken`

Заголовок запроса должен содержать параметр:

`Content-type: application/json; charset=utf-8`

Тело запроса должно содержать документ в формате JSON, соответствующий схеме.

{% code title="Пример запроса" %}

```json
{
  "login": "neletest",
  "pass": "v2AfscRjr"
}

```

{% endcode %}

**Параметры запроса:**

* `login`: логин из файла настроек интеграции в личном кабинете клиента.
* `pass`: пароль из файла настроек интеграции в личном кабинете клиента.

<mark style="background-color:green;">Метод GET</mark>

`https://fiscalization.evotor.ru/possystem/v5/getToken?login=<login>&pass=<pass>`

**Параметры строки запроса:**

* `login`: логин из файла настроек интеграции в личном кабинете клиента.
* `pass`: пароль из файла настроек интеграции в личном кабинете клиента.

**Ответ на запрос**

{% code title="Пример ответа" %}

```json
{
    "error": null,
    "token": "fj45u923j59ju42395iu9423i59243u0",
    "timestamp": "30.11.22 17:58:53"
}
```

{% endcode %}

{% code title="Пример ответа с ошибкой" %}

```json
{
    "error": {
        "error_id": "20003",
        "code": 12,
        "text": "Неверный логин или пароль",
        "type": "system"
    },
    "timestamp": null
}
```

{% endcode %}

**Параметры ответа на запрос:**

* `error`: ошибка.
  * `error_id`: уникальный идентификатор ошибки;
  * `code`: код ошибки;
  * `text`: текст ошибки;
  * `type`: тип ошибки.
* `token`: авторизационный токен. Максимальная длина строки – 1000 символов. Возвращается только при отсутствии ошибки.
* `timestamp`: дата и время ответа.

### Регистрация документа

**Описание**

Метод позволяет отправить запрос на формирование чека и отправку его на регистрацию в ККТ.

**Запрос**

<mark style="background-color:green;">Метод: POST</mark>

Авторизационный токен должен быть передан в заголовке запроса:

`https://fiscalization.evotor.ru/possystem/v5/<group_code>/<operation>`

Заголовок запроса должен содержать параметры:

* `Content-type: application/json; charset=utf-8`
* `Token: <token>`

При технической невозможности передать token в заголовке запроса можно передать параметр в строке запроса:

`https://fiscalization.evotor.ru/possystem/v5/<group_code>/<operation>?token=<token>`

**Параметры заголовка и строки запроса:**

* `group_code`: идентификатор группы ККТ;
* `operation`: тип операции на регистрацию чека, которая должна быть выполнена. Возможные типы операции:
  * `sell`: чек «Приход»;
  * `buy`: чек «Расход»;
  * `sell_refund`: чек «Возврат прихода»;
  * `buy_refund`: чек «Возврат расхода»;
  * `sell_correction`: чек «Коррекция прихода»;
  * `buy_correction`: чек «Коррекция расхода»;
  * `sell_refund_correction`: чек «Коррекция возврата прихода»;
  * `buy_refund_correction`: чек «Коррекция возврата расхода»;
* `token`: авторизационный токен.

**Пример регистрации чека с операцией «Приход»:**

`https://fiscalization.evotor.ru/possystem/v5/group1/sell?token=<token>`

Тело запроса должно содержать документ в формате JSON, соответствующий схеме.

**Тело запроса для чеков прихода и возврат прихода**

<pre class="language-json" data-line-numbers><code class="lang-json">{
   "timestamp":" 03.06.2020 12:05:31",
   "external_id": "892924433234522512289444",
   "service": {
      "callback_url": "https://shop.ru"
   },
   "receipt": {
      "client": {
         "email": "client@client.ru",
         "phone": "+70002410085",
         "name": "Иванов Иван Иванович",
         "inn": "112233445573"
      },
      "company": {
         "email": "email@evotor.ru",
         "sno": "osn",
         "inn": "0923341225",
         "payment_address": "shop-url.ru"
      },
      "cashier_inn": "112233445573",
      "cashier": "Антон Чеков",
      "items": [
         {
            "name": "Ваш любимый товар1",
            "price": 120,
            "quantity": 1.0,
            "measure": 0,
            "sum": 120,
            "payment_method": "full_payment",
            "payment_object": 1,
            "vat": {
               "type": "vat20",
               "sum": 20.0
            },
            "user_data": "Дополнительный реквизит предмета расчета",
            "excise": 10.0,
            "mark_quantity": {
               "numerator": 1,
               "denominator": 3
            },
            "mark_processing_mode": "0",
            "mark_code": {
               "gs1m": "010463003407001221CMK45BrhN0WLf"
            },
            "agent_info":  {
               "type": "another",
               "paying_agent": {
                  "operation": "Операция 1",
                  "phones": ["+79999999999"]
               },
               "receive_payments_operator": {
                  "phones": ["+79999999999"]
               },
               "money_transfer_operator": {
                  "phones": ["+79999999999"],
                  "name": "Оператор перевода",
                  "address": "г. Москва, ул. Сказочная д.3",
                  "inn": "112233445573"
               }
            },
            "supplier_info": {
               "phones": [
                  "+79999999999"
               ],
               "name": "Название поставщика",
               "inn": "112233445573"
            },
            "sectoral_item_props":[
               {
                  "date": "18.01.2023",
                  "value": "tm=mdlp&#x26;sid=00000000405195&#x26;",
                  "number": "123/43",
                  "federal_id": "001"
               }
            ]
         }
      ],
      "payments":[
         {
            "type": 1,
            "sum": 120.0
         }
      ],
      "vats":[
         {
            "type": "vat20",
            "sum": 20.0
         }
      ],
      "sectoral_check_props":[
         {
            "date": "18.02.2023",
            "value": "tm=mdlp&#x26;sid=00752852194630&#x26;",
            "number": "123/89",
            "federal_id": "002"
         }
      ],
      "<a data-footnote-ref href="#user-content-fn-1">additional_check_props</a>": "445334544",
      "total": 120.0,
      "<a data-footnote-ref href="#user-content-fn-2">additional_user_props</a>": {
         "name": "название доп реквизита",
         "value": "значение доп реквизита"
      }
   }
}
</code></pre>

Описание полей запроса регистрации документа с типом операции «Приход», «Возврат прихода», «Расход», «Возврат расхода» представлено ниже.

**Описание полей для тела запроса на регистрацию чека прихода и возврата прихода**

<table data-full-width="true"><thead><tr><th>Поле</th><th width="126">Тип</th><th width="159">Обязательное</th><th width="375">Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>timestamp</td><td>string</td><td>да</td><td><p>Дата и время документа внешней системы в формате: <code>dd.mm.yy HH:MM:SS</code></p><ul><li><code>dd</code> – День месяца. Формат DD. Возможные значения от «01» до «31»;</li><li><code>mm</code> – Месяц. Формат MM. Возможные значения от «01» до «12»;</li><li><code>yyyy</code> – Год. Формат YYYY. Допустимое количество символов – 4.</li><li><code>HH</code> – Часы. Формат HH. Возможные значения от «00» до «24»;</li><li><code>MM</code> – Минуты. Формат MM. Возможные значения от «00» до «59»;</li><li><code>SS</code> – Секунды. Формат SS. Возможные значения от «00» до «59».</li></ul></td><td>-</td></tr><tr><td>external_id</td><td>string</td><td>да</td><td>Идентификатор документа внешней системы, уникальный среди всех документов, отправленных одним пользователем. Максимум 128 символов.</td><td>-</td></tr><tr><td>service</td><td>object</td><td>нет</td><td>Служебный раздел. См. Описание объекта service</td><td>-</td></tr><tr><td>receipt</td><td>object</td><td>да</td><td>Чек. См. описание объекта Чек.</td><td>-</td></tr></tbody></table>

#### **Описание объекта service**

<table data-full-width="true"><thead><tr><th width="112">Поле</th><th>Тип</th><th>Обязательное</th><th width="355">Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>callback_url</td><td>string</td><td>нет</td><td>URL, на который необходимо ответить после обработки документа. Максимальная длина строки – 256 символов. Корректность заполненного поля определяется по регулярному выражению: <code>^http(s?)://0-9a-zA-Zа-яА-Я</code><em><code>(:(0-9)</code></em><code>)</code><em><code>(/?)([a- zA-Z0-9а-яА-Я-.?,'/\+&#x26;=%$#_]</code></em><code>)?$</code></td><td>-</td></tr></tbody></table>

#### **Описание объекта receipt**

<table data-full-width="true"><thead><tr><th width="130">Поле</th><th>Тип</th><th>Обязательное</th><th width="323">Описание</th><th width="138">Тег ФФД</th></tr></thead><tbody><tr><td>client</td><td>object</td><td>да</td><td>сведения о покупателе (клиенте). См. Описание объекта <code>client</code></td><td>-</td></tr><tr><td>company</td><td>object</td><td>да</td><td>См. Описание объекта <code>company</code></td><td>-</td></tr><tr><td>items</td><td>array of objects</td><td>да</td><td>Заполняется для каждого добавленного товара. См. Описание объекта <code>items</code></td><td>-</td></tr><tr><td>payments</td><td>array of objects</td><td>да</td><td>Оплаты. Ограничение по количеству от 1 до 10. См. Описание объекта <code>payments</code></td><td>-</td></tr><tr><td>vats</td><td>array of objects</td><td>нет</td><td>Атрибуты налогов на чек. Ограничение по количеству от 1 до 6. Необходимо передать либо сумму налога на позицию, либо сумму налога на чек. Если будет переданы и сумма налога на позицию и сумма налога на чек, сервис учтет только сумму налога на чек. См. Описание объекта <code>vats</code></td><td>-</td></tr><tr><td>cashier</td><td>string</td><td>нет</td><td>ФИО кассира. Максимальная длина строки – 64 символа.</td><td>1021 Кассир</td></tr><tr><td>cashier_inn</td><td>string</td><td>нет</td><td>ИНН кассира. Ровно 12 цифр</td><td>1203 ИНН кассира</td></tr><tr><td><a data-footnote-ref href="#user-content-fn-3">additional_check_props</a></td><td>string</td><td>нет</td><td>Дополнительный реквизит чека.  Максимальная длина строки – 16 символов.</td><td>1192 Дополнитель ный реквизит чека (БСО)</td></tr><tr><td>total</td><td>number</td><td>да</td><td><p>Итоговая сумма чека в рублях с заданным округлением:</p><ul><li>целая часть не более 8 знаков;</li><li>дробная часть не более 2 знаков.</li></ul><p>Значение вычисляется, как сумма всех значений реквизита «стоимость предмета расчета с учетом скидок и наценок» (тег 1043).</p></td><td>1020 Сумма расчета, указанного в чеке (БСО)</td></tr><tr><td><a data-footnote-ref href="#user-content-fn-4">additional_user_props</a></td><td>object</td><td>нет</td><td>Дополнительный реквизит пользователя. См. Описание объекта <code>additional_user_props</code></td><td>1084 Дополнитель ный реквизит пользователя.</td></tr><tr><td>sectoral_check_props</td><td>array of objects</td><td>нет</td><td>Включается в состав кассового чека (БСО) в случае, если включение этого отраслевого реквизита кассового чека предусмотрено законодательством Российской Федерации. См. <a href="#opisanie-elementa-massiva-obektov-sectoral_check_props-i-sectoral_item_props">Описание элемента массива объектов sectoral_check_props и sectoral_item_props</a></td><td>1261 отраслевой реквизит чека</td></tr></tbody></table>

#### **Описание объекта client**

<table data-full-width="true"><thead><tr><th width="130">Поле</th><th>Тип</th><th>Обязательное</th><th width="323">Описание</th><th width="138">Тег ФФД</th></tr></thead><tbody><tr><td>email</td><td>string</td><td>обязательно для заполнения хотя бы одно поле из двух: <code>email</code> или <code>phone</code></td><td>Электронный адрес покупателя. До 64 символов. Маска: <code>{С}@{С}</code> или значение <code>"none"</code></td><td>1008 Телефон или электронный адрес покупателя</td></tr><tr><td>phone</td><td>string</td><td>см. выше</td><td>Телефон покупателя. Номер  необходимо передать вместе с кодом страны без пробелов и дополнительных символов, кроме символа <code>+</code> (номер <code>+371 2 1234567</code> необходимо передать как <code>+37121234567</code>). До 19 символов Маски: <code>+{Ц}</code> или значение <code>"none"</code></td><td>1008 Телефон или электронный адрес покупателя</td></tr><tr><td>name</td><td>string</td><td>нет</td><td>Наименование покупателя (клиента). Максимальная длина строки – 256 символов.</td><td>1227 Наименование организации или фамилия, имя, отчество (при наличии), серия и номер паспорта покупателя (клиента)</td></tr><tr><td>inn</td><td>string</td><td>нет</td><td>ИНН покупателя (клиента). Допустимое количество символов 10 или 12, только цифры.</td><td>1228 ИНН организации или покупателя (клиента)</td></tr></tbody></table>

#### **Описание объекта company**

<table data-full-width="true"><thead><tr><th>Поле</th><th width="131">Тип</th><th width="108">Обязательное</th><th width="343">Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>email</td><td>string</td><td>да</td><td>Электронная почта отправителя чека. При передаче ОФД кассового чека (БСО), кассового чека коррекции (БСО коррекции) покупателю (клиенту) в электронной форме указывается адрес электронной почты ОФД. Максимальная длина строки – 64 символа. Маска: <code>{С}@{С}</code></td><td>1117 Адрес электронной почты отправителя чека</td></tr><tr><td>sno</td><td>enum (string)</td><td>да</td><td><p>Система налогообложения. Должно принимать одно из значений:</p><ul><li><code>osn</code> – общая СН;</li><li><code>usn_income</code> – упрощенная СН (доходы);</li><li><code>usn_income_outcome</code> – упрощенная СН (доходы минус расходы);</li><li><code>esn</code> – единый сельскохозяйственный налог;</li><li><code>patent</code> – патентная СН.</li></ul></td><td>1055 Применяемая система налогообложения</td></tr><tr><td>inn</td><td>string</td><td>да</td><td>ИНН организации. Используется для предотвращения ошибочных регистраций чеков на ККТ зарегистрированных с другим ИНН (сравнивается со значением в ФН). Допустимое количество символов 10 или 12.</td><td>1018 ИНН пользователя</td></tr><tr><td>payment_address</td><td>string</td><td>да</td><td>Место расчетов. Максимальная длина строки – 256 символов.</td><td>1187 Место расчетов</td></tr></tbody></table>

#### **Описание объекта items**

<table data-full-width="true"><thead><tr><th>Поле</th><th width="131">Тип</th><th width="108">Обязательное</th><th width="393">Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>name</td><td>string</td><td>да</td><td>Наименование товара, работы, услуги, платежа, выплаты, иного предмета расчета. <mark style="color:red;">Максимальная длина строки – 128 символов.</mark></td><td>1030 Наименование предмета расчета</td></tr><tr><td>price</td><td>number</td><td>да</td><td><p>Цена за единицу товара, работы, услуги, платежа, выплаты, иного предмета расчета с учетом скидок и наценок. Цена в рублях:</p><ul><li>целая часть не более 8 знаков;</li><li>дробная часть не более 2 знаков.</li></ul><p>Максимальное значение цены – <code>42 949 672.95</code>. При этом произведение цены и количества / веса (<code>price*quantity</code>) позиции должно быть не больше максимального значения цены позиции.<br></p></td><td>1079 цена за единицу предмета расчета с учетом скидок и наценок</td></tr><tr><td>quantity</td><td>number</td><td>да</td><td><p>Количество / вес:</p><ul><li>целая часть не более 5 знаков;</li><li>дробная часть не более 3 знаков. </li></ul><p>Максимальное значение – <code>99 999.999</code></p></td><td>1023 Количество предмета расчета</td></tr><tr><td>measure</td><td>enum (number)</td><td>да</td><td><p>Единицы измерения количества предмета расчета. Может принимать одно из значений:</p><ul><li>0 - Применяется для предметов расчета, которые могут быть реализованы поштучно или единицами</li><li>10 - Грамм</li><li>11 - Килограмм</li><li>12 - Тонна</li><li>20 - Сантиметр</li><li>21 - Дециметр</li><li>22 - Метр</li><li>30 - Квадратный сантиметр</li><li>31 - Квадратный дециметр</li><li>32 - Квадратный метр</li><li>40 - Миллилитр</li><li>41 - Литр</li><li>42 - Кубический метр</li><li>50 - Киловатт час</li><li>51 - Гигакалория</li><li>70 - Сутки (день)</li><li>71 - Час</li><li>72 - Минута</li><li>73 - Секунда</li><li>80 - Килобайт</li><li>81 - Мегабайт</li><li>82 - Гигабайт</li><li>83 - Терабайт</li><li>255 - Применяется при использовании иных единиц измерения</li></ul></td><td>2108 мера количества предмета расчета</td></tr><tr><td>sum</td><td>number</td><td>да</td><td><p>Сумма в рублях:</p><ul><li>целая часть не более 8 знаков;</li><li>дробная часть не более 2 знаков.</li></ul><p>Максимальное значение – <code>42 949 672.95</code>. Значение реквизита «стоимость предмета расчета с учетом скидок и наценок» (тег 1043) должно быть равно произведению значения реквизита «цена за единицу предмета расчета с учетом скидок и наценок» (тег 1079), умноженному на значение реквизита «количество предмета расчета» (тег 1023).</p></td><td>1043 Стоимость предмета расчета с учетом скидок и наценок</td></tr><tr><td>payment_method</td><td>enum (string)</td><td>да</td><td><p>Признак способа расчёта. Возможные значения:</p><ul><li><code>full_prepayment</code> – предоплата 100%. Полная предварительная оплата до момента передачи предмета расчета.</li><li><code>prepayment</code> – предоплата. Частичная предварительная оплата до момента передачи предмета расчета.</li><li><code>advance</code> – аванс.</li><li><code>partial_payment</code> – частичный расчет и кредит. Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит</li><li><code>credit</code> – передача в кредит. Передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит</li><li><code>credit_payment</code> – оплата кредита. Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита)</li><li><code>full_payment</code> – полный расчет. Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета</li></ul></td><td>1214 Признак способа расчета</td></tr><tr><td>payment_object</td><td>enum (number)</td><td>да</td><td><p>Признак предмета расчёта. Должен принимать одно из значений:</p><ul><li>1 - о реализуемом товаре, за исключением подакцизного товара и товара, подлежащего маркировке средствами идентификации (наименование и иные сведения, описывающие товар)</li><li>2 - о реализуемом подакцизном товаре, за исключением товара, подлежащего маркировке средствами идентификации (наименование и иные сведения, описывающие товар)</li><li>3 - о выполняемой работе (наименование и иные сведения, описывающие работу)</li><li>4 - об оказываемой услуге (наименование и иные сведения, описывающие услугу)</li><li>5 - о приеме ставок при осуществлении деятельности по проведению азартных игр</li><li>6 - о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр</li><li>7 - о приеме денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей</li><li>8 - о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотерей</li><li>9 - о предоставлении прав на использование результатов интеллектуальной деятельности или средств индивидуализации</li><li>10 - об авансе, задатке, предоплате, кредите</li><li>11 - о вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом</li><li>12 - о взносе в счет оплаты, пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчета</li><li>13 - о предмете расчета, не относящемуся к предметам расчета, которым может быть присвоено значение от «1» до «11» и от «14» до «26» "ИНОЙ ПРЕДМЕТ РАСЧЕТА"</li><li>14 - о передаче имущественных прав</li><li>15 - о внереализационном доходе</li><li>16 - о суммах расходов, платежей и взносов, указанных в подпунктах 2 и 3 пункта Налогового кодекса Российской Федерации, уменьшающих сумму налога</li><li>17 - о суммах уплаченного торгового сбора</li><li>18 - о курортном сборе</li><li>19 - о залоге</li><li>20 - о суммах произведенных расходов в соответствии со статьей 346.16 Налогового кодекса Российской Федерации, уменьшающих доход</li><li>21 - о страховых взносах на обязательное пенсионное страхование, уплачиваемых ИП, не производящими выплаты и иные вознаграждения физическим лицам</li><li>22 - о страховых взносах на обязательное пенсионное страхование, уплачиваемых организациями и ИП, производящими выплаты и иные вознаграждения физическим лицам</li><li>23 - о страховых взносах на обязательное медицинское страхование, уплачиваемых ИП, не производящими выплаты и иные вознаграждения физическим лицам</li><li>24 - о страховых взносах на обязательное медицинское страхование, уплачиваемые организациями и ИП, производящими выплаты и иные вознаграждения физическим лицам</li><li>25 - о страховых взносах на обязательное социальное страхование на случай временной нетрудоспособности и в связи с материнством, на обязательное социальное страхование от несчастных случаев на производстве и профессиональных заболеваний</li><li>26 - о приеме и выплате денежных средств при осуществлении казино и залами игровых автоматов расчетов с использованием обменных знаков игорного заведения</li><li>27 - о выдаче денежных средств банковским платежным агентом</li><li>30 - о реализуемом подакцизном товаре, подлежащем маркировке средством идентификации, не имеющем кода маркировки</li><li>31 - о реализуемом подакцизном товаре, подлежащем маркировке средством идентификации, имеющем код маркировки</li><li>32 - о реализуемом товаре, подлежащем маркировке средством идентификации, не имеющем кода маркировки, за исключением подакцизного товара</li><li>33 - о реализуемом товаре, подлежащем маркировке средством идентификации, имеющем код маркировки, за исключением подакцизного товара <br>* если в товаре передается mark_code и payment_object = "1", то он будет автоматически изменен на "33"</li></ul></td><td>1212 Признак предмета расчета</td></tr><tr><td>vat</td><td>object</td><td>да</td><td>Атрибуты налога на позицию. См. Описание объекта <code>vat</code></td><td>-</td></tr><tr><td>user_data</td><td>string</td><td>нет</td><td>Дополнительный реквизит предмета расчета. Максимальная длина строки – 64 символа.</td><td>1191 Дополнительный реквизит предмета расчета</td></tr><tr><td>excise</td><td>number</td><td>нет</td><td>Сумма акциза в рублях<br>целая часть не более 8 знаков; дробная часть не более 2 знаков; значение не может быть отрицательным;</td><td>1229 Сумма акциза с учетом копеек, включенная в стоимость предмета расчета</td></tr><tr><td>mark_quantity</td><td>object</td><td>Нет</td><td>Реквизит «дробное количество маркированного товара» (тег 1291) включается в состав реквизита «предмет расчета» (тег 1059) только в случае если расчет осуществляется за маркированный товар и значение реквизита «мера количества предмета расчета» (тег 2108) принимает значение равное «0». См. Описание объекта mark_quantity</td><td>1291 Дробное количество маркированного товара</td></tr><tr><td>mark_processing_mode</td><td>string</td><td>нет</td><td>Включается в чек в случае, если предметом расчета является товар, подлежащий обязательной маркировке средством идентификации. Должен принимать значение равное <code>0</code></td><td>2102 Режим обработки кода маркировки</td></tr><tr><td>sectoral_item_props</td><td>array of objects</td><td>нет</td><td>Необходимо указывать, если в составе реквизита «предмет расчета» (тег 1059) содержатся сведения о товаре, подлежащем обязательной маркировке средством идентификации и включение указанного реквизита предусмотрено НПА отраслевого регулирования для соответствующей товарной группы. См. <a href="#opisanie-elementa-massiva-obektov-sectoral_check_props-i-sectoral_item_props">Описание объекта sectoral_check_props и sectoral_item_props</a></td><td>1260 Отраслевой реквизит предмета расчета</td></tr><tr><td>mark_code</td><td>object</td><td>нет</td><td>Включается в чек в случае, если предметом расчета является товар, подлежащий обязательной маркировке средством идентификации. См. Описание объекта <code>mark_code</code></td><td>1163 Код товара</td></tr><tr><td>agent_info</td><td>object</td><td>нет</td><td>Атрибуты агента. См. Описание объекта <code>agent_info</code></td><td>-</td></tr><tr><td>supplier_info</td><td>object</td><td>если передан <code>agent_info</code></td><td>Атрибуты поставщика. См. описание объекта <code>supplier_info</code></td><td>-</td></tr></tbody></table>

#### **Описание объекта vat**

<table data-full-width="true"><thead><tr><th>Поле</th><th width="137">Тип</th><th width="125">Обязательное</th><th width="264">Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>type</td><td>enum (string)</td><td>да</td><td><p>Устанавливает номер налога в ККТ. Перечисление со значениями:</p><ul><li><code>none</code> – без НДС;</li><li><code>vat0</code> – НДС по ставке 0%;</li><li><code>vat5</code> – НДС по ставке 5%;</li><li><code>vat7</code> – НДС по ставке 7%;</li><li><code>vat10</code> – НДС по ставке 10%;</li><li><code>vat20</code> – НДС по ставке 20%;</li><li><code>vat105</code> – НДС по расчетной ставке 5/105;</li><li><code>vat107</code> – НДС по расчетной ставке 7/107;</li><li><code>vat110</code> – НДС по расчетной ставке 10/110;</li><li><code>vat120</code> – НДС по расчетной ставке 20/120.</li></ul></td><td>1199 Ставка НДС</td></tr><tr><td>sum</td><td>number</td><td>нет</td><td><p>Сумма налога позиции в рублях:</p><ul><li>целая часть не более 8 знаков;</li><li>дробная часть не более 2 знаков.</li></ul></td><td>1200 Сумма НДС за предмет расчета</td></tr></tbody></table>

#### Описание объекта mark\_quantity

<table data-full-width="true"><thead><tr><th>Поле</th><th>Тип</th><th>Обязательное</th><th>Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>numerator</td><td>integer</td><td>Да</td><td>Числитель дробной части предмета расчета Значение реквизита «числитель» (тег 1293) должно быть строго меньше значения реквизита «знаменатель» (тег 1294) не может равняться «0»</td><td>1293 числитель</td></tr><tr><td>denominator</td><td>integer</td><td>Да</td><td>Знаменатель дробной части предмета расчета Заполняется значением, равным количеству товара в партии (упаковке), имеющей общий код маркировки товара. не может равняться «0»</td><td>1294 знаменатель</td></tr></tbody></table>

#### **Описание объекта mark\_code**

<table data-full-width="true"><thead><tr><th>Поле</th><th width="137">Тип</th><th width="125">Обязательное</th><th width="343">Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>gs1m</td><td>string</td><td>должен быть передан один из реквизитов</td><td>Код товара в формате GS1, нанесенный на товар, подлежащий маркировке средствами идентификации. Максимум 200 символов. Значение реквизита должно формироваться в соответствии с правилами, указанными в Приложении № 2 к приказу ФНС России от 14.09.2020г. № ЕД-7- 20/662@ (Таблица 118)</td><td>1305 КТ GS1.М</td></tr><tr><td>short</td><td>string</td><td>должен быть передан один из реквизитов</td><td>Код товара в формате короткого кода маркировки, нанесенный на товар, подлежащий маркировке средствами идентификации. Максимум 38 символов. Значение реквизита должно формироваться в соответствии с правилами, указанными в Приложении № 2 к приказу ФНС России от 14.09.2020г. № ЕД-7- 20/662@ (Таблица 118)</td><td>1306 КТ КМК</td></tr><tr><td>fur</td><td>string</td><td>должен быть передан один из реквизитов</td><td>Контрольно-идентификационный знак мехового изделия. Ровно 20 символов, должно соответствовать маске СС-ЦЦЦЦЦЦСССССССССС <br>Значение реквизита должно формироваться в соответствии с правилами, указанными в Приложении № 2 к приказу ФНС России от 14.09.2020г. № ЕД-7- 20/662@ (Таблица 118)</td><td>1307 КТ МИ</td></tr></tbody></table>

#### **Описание объекта agent\_info**

<table data-full-width="true"><thead><tr><th>Поле</th><th width="137">Тип</th><th width="125">Обязательное</th><th width="342">Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>type</td><td>enum (string)</td><td>да</td><td><p>Признак агента по предмету расчёта (ограничен агентами, введенными в ККТ при фискализации). Возможные значения:</p><ul><li><code>bank_paying_agent</code> – банковский платежный агент. Оказание услуг покупателю (клиенту) пользователем, являющимся банковским платежным агентом.</li><li><code>bank_paying_subagent</code> – банковский платежный субагент. Оказание услуг покупателю (клиенту) пользователем, являющимся банковским платежным субагентом.</li><li><code>paying_agent</code> – платежный агент. Оказание услуг покупателю (клиенту) пользователем, являющимся платежным агентом.</li><li><code>paying_subagent</code> – платежный субагент. Оказание услуг покупателю (клиенту) пользователем, являющимся платежным субагентом.</li><li><code>attorney</code> – поверенный. Осуществление расчета с покупателем (клиентом) пользователем, являющимся поверенным.</li><li><code>commission_agent</code> – комиссионер. Осуществление расчета с покупателем (клиентом) пользователем, являющимся комиссионером.</li><li><code>another</code> – другой тип агента. Осуществление расчета с покупателем (клиентом) пользователем, являющимся агентом и не являющимся банковским платежным агентом (субагентом), платежным агентом (субагентом), поверенным, комиссионером.</li></ul></td><td>1222 Признак агента по предмету расчета</td></tr><tr><td>paying_agent</td><td>object</td><td>Нет</td><td>Атрибуты платежного агента. См. Описание объекта <code>paying_agent</code></td><td>-</td></tr><tr><td>receive_payments_operator</td><td>object</td><td>Нет</td><td>Атрибуты оператора по приему платежей. См. Описание объекта <code>receive_payments_operator</code></td><td>-</td></tr><tr><td>money_transfer_operator</td><td>object</td><td>Нет</td><td>Атрибуты оператора перевода. См. Описание объекта <code>money_transfer_operator</code></td><td>-</td></tr></tbody></table>

#### Описание объекта paying\_agent

<table data-full-width="true"><thead><tr><th>Поле</th><th>Тип</th><th>Обязательное</th><th>Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>operation</td><td>string</td><td>Нет</td><td>Наименование операции банковского платежного агента, банковского платежного субагента. Максимальная длина строки – 24 символа.</td><td>1044 Операция банковского платежного агента</td></tr><tr><td>phones</td><td>array of strings</td><td>Нет</td><td>Номера телефонов платежного агента, платежного субагента, банковского платежного агента, банковского платежного субагента Номер телефона необходимо передать вместе с кодом страны без пробелов и дополнительных символов, кроме символа «+». Если номер телефон начинается с символа «+», то максимальная длина одного элемента массива – 19 символов. Если номер телефона относится к России (префикс «+7»), то значение можно передать без префикса (номер «+7 925 1234567» можно передать как «9251234567»). Максимальная длина одного элемента массива в таком случае – 17 символов.</td><td>1073 Телефон платежного агента</td></tr></tbody></table>

#### Описание объекта receive\_payments\_operator

<table data-full-width="true"><thead><tr><th>Поле</th><th>Тип</th><th>Обязательное</th><th>Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>phones</td><td>array of strings</td><td>Нет</td><td>Номера контактных телефонов оператора по приему платежей Номер телефона необходимо передать вместе с кодом страны без пробелов и дополнительных символов, кроме символа «+». Если номер телефон начинается с символа «+», то максимальная длина одного элемента массива – 19 символов. Если номер телефона относится к России (префикс «+7»), то значение можно передать без префикса (номер «+7 925 1234567» можно передать как «9251234567»). Максимальная длина одного элемента массива в таком случае – 17 символов.</td><td>1074 Телефон оператора по приему платежей</td></tr></tbody></table>

#### Описание объекта money\_transfer\_operator

<table data-full-width="true"><thead><tr><th>Поле</th><th>Тип</th><th>Обязательное</th><th>Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>phones</td><td>array of strings</td><td>Нет</td><td>Номера телефонов оператора по переводу денежных средств Номер телефона необходимо передать вместе с кодом страны без пробелов и дополнительных символов, кроме символа «+». Если номер телефон начинается с символа «+», то максимальная длина одного элемента массива – 19 символов. Если номер телефона относится к России (префикс «+7»), то значение можно передать без префикса (номер «+7 925 1234567» можно передать как «9251234567»). Максимальная длина одного элемента массива в таком случае – 17 символов.</td><td>1075 Телефон оператора перевода</td></tr><tr><td>name</td><td>string</td><td>Нет</td><td>Наименование оператора перевода. Максимум 64 символа</td><td>1026 Наименовани е оператора перевода</td></tr><tr><td>address</td><td>string</td><td>Нет</td><td>Место нахождения оператора по переводу денежных средств Максимум 256 символов</td><td>1005 Адрес оператора перевода</td></tr><tr><td>inn</td><td>string</td><td>Нет</td><td>ИНН оператора перевода. 10 или 12 цифр</td><td>1016 ИНН оператора перевода</td></tr></tbody></table>

#### **Описание объекта supplier\_info**

<table data-full-width="true"><thead><tr><th>Поле</th><th width="137">Тип</th><th width="125">Обязательное</th><th width="343">Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>phones</td><td>array of strings</td><td>нет</td><td>Телефоны поставщика. Номер телефона необходимо передать вместе с кодом страны без пробелов и дополнительных символов, кроме символа <code>+</code>. Если номер телефон начинается с символа <code>+</code>, то максимальная длина одного элемента массива – 19 символов. Если номер телефона относится к России (префикс <code>+7</code>), то значение можно передать без префикса (номер <code>+7 925 1234567</code> можно передать как «<code>9251234567</code>»). Максимальная длина одного элемента массива в таком случае – 17 символов.</td><td>1171 Телефон поставщика</td></tr><tr><td>name</td><td>string</td><td>да</td><td>Наименование поставщика. Максимум 256 символов</td><td>1225 Наименование поставщика</td></tr><tr><td>inn</td><td>string</td><td>да</td><td>ИНН поставщика. 10 или 12 цифр</td><td>1226 ИНН поставщика</td></tr></tbody></table>

#### **Описание объекта payments**

<table data-full-width="true"><thead><tr><th>Поле</th><th width="137">Тип</th><th width="125">Обязательное</th><th width="343">Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>type</td><td>enum (number)</td><td>да</td><td><p>Вид оплаты. Возможные значения:</p><ul><li>0 – наличные;</li><li>1 – безналичный;</li><li>2 – предварительная оплата (зачет аванса и (или) предыдущих платежей);</li><li>3 – постоплата (кредит);</li><li>4 – иная форма оплаты (встречное предоставление);</li></ul></td><td>1031, 1081, 1215, 1216, 1217<br>сумма по чеку (БСО)</td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td>sum</td><td>number</td><td>да</td><td><p>Сумма к оплате в рублях:</p><ul><li>целая часть не более 8 знаков;</li><li>дробная часть не более 2 знаков.</li></ul></td><td></td></tr></tbody></table>

#### **Описание объекта vats**

<table data-full-width="true"><thead><tr><th>Поле</th><th width="137">Тип</th><th width="125">Обязательное</th><th width="343">Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>type</td><td>enum (string)</td><td>да</td><td><p>Устанавливает номер налога в ККТ. Перечисление со значениями:</p><ul><li><code>none</code> – без НДС;</li><li><code>vat0</code> – НДС по ставке 0%;</li><li><code>vat5</code> – НДС по ставке 5%;</li><li><code>vat7</code> – НДС по ставке 7%;</li><li><code>vat10</code> – НДС по ставке 10%;</li><li><code>vat20</code> – НДС по ставке 20%;</li><li><code>vat105</code> – НДС по расчетной ставке 5/105;</li><li><code>vat107</code> – НДС по расчетной ставке 7/107;</li><li><code>vat110</code> – НДС по расчетной ставке 10/110;</li><li><code>vat120</code> – НДС по расчетной ставке 20/120.</li></ul></td><td>1102, 1103, 1104, 1105, 1106, 1107<br>Сумма НДС</td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td>sum</td><td>number</td><td>нет</td><td><p>Сумма к оплате в рублях:</p><ul><li>целая часть не более 8 знаков;</li><li>дробная часть не более 2 знаков.</li></ul></td><td>1200</td></tr></tbody></table>

#### **Описание объекта additional\_user\_props**

<table data-full-width="true"><thead><tr><th>Поле</th><th width="137">Тип</th><th width="125">Обязательное</th><th width="343">Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>name</td><td>string</td><td>да</td><td>Наименование дополнительного реквизита пользователя. Максимальная длина строки – 64 символа.</td><td>1085 Наименование дополнительного реквизита пользователя</td></tr><tr><td>value</td><td>string</td><td>да</td><td>Значение дополнительного реквизита пользователя. Максимальная длина строки – 256 символов.</td><td>1086 Значение дополнительного реквизита пользователя</td></tr></tbody></table>

#### **Описание** элемента массива объектов sectoral\_check\_props и sectoral\_item\_props

<table data-full-width="true"><thead><tr><th>Поле</th><th width="137">Тип</th><th width="125">Обязательное</th><th width="343">Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>federal_id</td><td>enum (string)</td><td>да</td><td>Идентификатор ФОИВ. Должно принимать одно из значений справочника.</td><td>1262 идентификатор ФОИВ</td></tr><tr><td>date</td><td>string</td><td>да</td><td>Дата нормативного акта федерального органа исполнительной власти, регламентирующего порядок заполнения реквизита «значение отраслевого реквизита» (тег 1265). Значение в формате в формате ДД.ММ.ГГГГ</td><td>1263 дата документа основания</td></tr><tr><td>number</td><td>string</td><td>да</td><td>Номер нормативного акта федерального органа исполнительной власти, регламентирующего порядок заполнения реквизита «значение отраслевого реквизита» (тег 1265). Максимум 32 символа.</td><td>1264 номер документа основания</td></tr><tr><td>value</td><td>string</td><td>да</td><td>Состав значений, определенных нормативным актом федерального органа исполнительной власти. Максимум 256 символов.</td><td>1265 значение отраслевого реквизита</td></tr></tbody></table>

**Тело запроса для чеков коррекции прихода и коррекции возврата прихода**

<pre class="language-json" data-line-numbers><code class="lang-json">{
   "timestamp":" 03.06.2020 12:05:31",
   "external_id": "892924433234522512289444",
   "service": {
      "callback_url": "https://shop.ru"
   },
   "correction": {
      "client": {
         "email": "client@client.ru",
         "phone": "+70002410085",
         "name": "Иванов Иван Иванович",
         "inn": "516974792202"
      },
      "company": {
         "email": "email@evotor.ru",
         "sno": "osn",
         "inn": "5010051677",
         "payment_address": "shop-url.ru"
      },
      "cashier_inn": "887405485310",
      "cashier": "Антон Чеков",
      "correction_info": {
         "type": "self",
         "base_date": "02.02.2022",
         "base_number": "735/01505"
      },
      "items": [
         {
            "name": "Ваш любимый товар1",
            "price": 120,
            "quantity": 1.0,
            "measure": 0,
            "sum": 120,
            "payment_method": "full_payment",
            "payment_object": 1,
            "vat": {
               "type": "vat20",
               "sum": 20.0
            },
            "excise": 10.0,
            "mark_processing_mode": "0",
            "mark_code": {
               "gs1m": "010463003407001221CMK45BrhN0WLf"
            },
            "agent_info": {
               "type": "another"
            },
            "supplier_info": {
               "phones": [
                  "+79998887766"
               ],
               "name": "Название поставщика",
               "inn": "287381373424"
            },
            "sectoral_item_props":[
               {
                  "date": "18.01.2023",
                  "value": "tm=mdlp&#x26;sid=00000000405195&#x26;",
                  "number": "123/43",
                  "federal_id": "001"
               }
            ]
         }
      ],
      "payments":[
         {
            "type": 1,
            "sum": 120.0
         }
      ],
      "vats":[
         {
            "type": "vat20",
            "sum": 20.0
         }
      ],
      "sectoral_check_props":[
         {
            "date": "18.02.2023",
            "value": "tm=mdlp&#x26;sid=00752852194630&#x26;",
            "number": "123/89",
            "federal_id": "002"
         }
      ],
      "<a data-footnote-ref href="#user-content-fn-5">additional_check_props</a>": "445334544",
      "total": 120.0,
      "<a data-footnote-ref href="#user-content-fn-6">additional_user_props</a>": {
         "name": "название доп реквизита",
         "value": "значение доп реквизита"
      }
   }
}
</code></pre>

{% hint style="info" %}
Описание полей для чеков коррекции совпадает с описанием полей для типов операций «Приход», «Возврат прихода»,  представленными выше. Отличие — объект `reciept` заменяется на `correction`. Так же добавляется объект correction\_info (описание ниже) и поле `cashier` — обязательное.
{% endhint %}

#### **Описание объекта correction\_info**

<table data-full-width="true"><thead><tr><th>Поле</th><th width="137">Тип</th><th width="125">Обязательное</th><th width="343">Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>type</td><td>enum</td><td>да</td><td><p>Тип коррекции. Возможные значения:</p><ul><li><code>self</code> – самостоятельная операция;</li><li><code>instruction</code> - операция по предписанию налогового органа об устранении выявленного нарушения законодательства Российской Федерации о применении ККТ.</li></ul></td><td>1173 Тип коррекции</td></tr><tr><td>base_date</td><td>string</td><td>да</td><td>Дата совершения корректируемого расчета в формате: <code>dd.mm.yyyy</code></td><td>1178 Дата совершения корректируемого расчета</td></tr><tr><td>base_number</td><td>string</td><td>нет</td><td>Номер документа основания для коррекции. Заполняется в случае, если коррекция расчета осуществляется по предписанию налогового органа об устранении выявленного нарушения законодательства Российской Федерации о применении ККТ. Максимум 32 символа</td><td>1179 Номер документа основания для коррекции</td></tr></tbody></table>

### Ответ на запрос

При отсутствии ошибок сервис вернет пакет, содержащий уникальный идентификатор чека, присвоенный сервисом и статус обработки чека.

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

{% code title="Пример ответа" %}

```json
{
    "uuid": "2ea26f17–0884–4f08–b120–306fc096a58f",
    "timestamp": "12.04.22 06:15:06",
    "error": null,
    "status": "wait",
}
```

{% endcode %}

{% code title="Пример ответа с ошибкой" %}

```json
{
    "timestamp": null,
    "status": "fail",
    "error": {
        "error_id": "20010",
        "code": 30,
        "text": " Передан некорректный UUID : \"{0}\". Необходимо повторить запрос с корректными
        данными ",
        "type": "system"
    }
}
```

{% endcode %}

#### Тело ответа на запрос регистрации чека

<table data-full-width="true"><thead><tr><th width="153">Поле</th><th width="139">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>uuid</td><td>string</td><td>Уникальный идентификатор. Максимальная длина строки – 128 символов. Если документ не удалось зарегистрировать, документу не будет присвоен UUID.</td></tr><tr><td>timestamp</td><td>string</td><td><p>Дата и время получения запроса в формате: <code>dd.mm.yy HH:MM:SS</code></p><ul><li><code>dd</code> – День месяца. Формат <code>DD</code>. Возможные значения от «01» до «31».</li><li><code>mm</code> – Месяц. Формат <code>MM</code>. Возможные значения от «01» до «12».</li><li><code>yy</code> – Год. Формат <code>YY</code>. Допустимое количество символов – два.</li><li><code>HH</code> – Часы. Формат <code>HH</code>. Возможные значения от «00» до «24».</li><li><code>MM</code> – Минуты. Формат <code>MM</code>. Возможные значения от «00» до «59».</li><li><code>SS</code> – Секунды. Формат <code>SS</code>. Возможные значения от «00» до «59».</li></ul></td></tr><tr><td>status</td><td>enum (string)</td><td><p>Статус. Возможные значения:</p><ul><li><code>fail</code> – ошибка;</li><li><code>wait</code> – в обработке.</li></ul></td></tr><tr><td>error</td><td>object</td><td>См. описание объекта <code>error</code></td></tr></tbody></table>

#### Описание объекта error

<table data-full-width="true"><thead><tr><th width="153">Поле</th><th width="139">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>code</td><td>integer</td><td>Код ошибки. Отображается только при ошибке.</td></tr><tr><td>error_id</td><td>string</td><td>Уникальный идентификатор ошибки.</td></tr><tr><td>text</td><td>string</td><td>Текст ошибки (кодировка utf–8).</td></tr><tr><td>type</td><td>enum (string)</td><td><p>Тип источника ошибки. Возможные значения:</p><ul><li><code>system</code> – системная ошибка;</li><li><code>unknown</code> – неизвестная ошибка.</li></ul></td></tr></tbody></table>

### Получение результата обработки документа

**Описание**

Результат регистрации чека на ККТ может быть получен двумя способами:

* В случае, если в запросе на регистрацию был указан `callback_url`, сервис по

  результатам обработки чека вернет POST запрос на этот URL.
* В случае, если `callback_url` не был указан или запрос не пришел в течение 300 секунд с момента отправки чека, клиент самостоятельно может запросить

  результат обработки чека GET-запросом к сервису.

Пакет с результатом обработки документа одинаков для обоих способов получения.

#### **Запрос**

<mark style="background-color:green;">Метод GET</mark>

`https://fiscalization.evotor.ru/possystem/v5/<group_code>/report/<uuid>`

Заголовок запроса должен содержать параметр:

`Token: <token>`

При технической невозможности передать `token` в заголовке запроса можно передать параметр в строке запроса.

`https://fiscalization.evotor.ru/possystem/v5/<group_code>/report/<uuid>?token=<token>`

Параметры заголовка и строки запроса:

* `group_code`: идентификатор группы ККТ;
* `uuid`: уникальный идентификатор, присвоенный документу после выполнения запроса на регистрацию;
* `token`: авторизационный токен.

{% code title="Пример запроса результата обработки документа" %}

```url
https://fiscalization.evotor.ru/possystem/v5/01-000000002602720/report/0459d6f9-afb6-41ab-860b-11c0544175ea
```

{% endcode %}

#### Ответ на запрос

В ответ возвращается пакет со статусом и реквизитами фискализации или ошибкой.

{% code title="Пример ответа при успешной фискализации" %}

```json
{
    "uuid": "0459d6f9-afb6-41ab-860b-11c0544175ea",
    "timestamp": "10.08.22 10:00:00",
    "status": "done",
    "error": null,
    "payload": {
        "total": 47500,
        "fiscal_receipt_number": 1,
        "shift_number": 139,
        "receipt_datetime": "08.12.2022 12:20:00",
        "fn_number": "9999078902013061",
        "ecr_registration_number": "0000000000026332",
        "fiscal_document_number": 3763,
        "fiscal_document_attribute": 995410884,
        "fns_site": "www.nalog.ru",
        "ofd_receipt_url": "https://lk.platformaofd.ru/web/noauth/cheque/search?fn=9999078902013061&fp=995410884&i=3763"
    },
    "group_code": "01-000000002602720",
    "daemon_code": "prod–agent–1",
    "device_code": "356645110070952",
    "external_id": "fe743fbc-2ddf-4fba-8681-1eb730af5b59",
    "callback_url": ""
}
```

{% endcode %}

{% code title="Пример ответа с ошибкой" %}

```json
{
    "uuid": "0459d6f9-afb6-41ab-860b-011c0544175e",
    "timestamp": null,
    "status": "fail",
    "error": {
        "text": "Передан некорректный UUID : '0459d6f9-afb6-41ab-860b-011c0544175e'. Необходимо повторить запрос с корректными данными",
        "type": "system",
        "code": 30,
        "error_id": "20010"
    },
    "payload": null,
    "group_code": null,
    "daemon_code": null,
    "device_code": null,
    "external_id": null,
    "callback_url": null
}
```

{% endcode %}

#### Тело ответа с результатами обработки чека

<table data-full-width="true"><thead><tr><th width="175">Поле</th><th width="137">Тип</th><th width="438">Описание</th></tr></thead><tbody><tr><td>uuid</td><td>string</td><td>Уникальный идентификатор. Максимальная длина строки – 128 символов. Если документ не удалось зарегистрировать, документу не будет присвоен UUID.</td></tr><tr><td>timestamp</td><td>string</td><td><p>Дата и время документа внешней системы в формате <code>dd.mm.yy HH:MM:SS</code></p><ul><li><code>dd</code> – День месяца. Формат DD. Возможные значения от «01» до «31».</li><li><code>mm</code> – Месяц. Формат MM. Возможные значения от «01» до «12».</li><li><code>yy</code> – Год. Формат YY. Допустимое количество символов – два.</li><li><code>HH</code> – Часы. Формат HH. Возможные значения от «00» до «24».</li><li><code>MM</code> – Минуты. Формат MM. Возможные значения от «00» до «59».</li><li><code>SS</code> – Секунды. Формат SS. Возможные значения от «00» до «59».</li></ul></td></tr><tr><td>callback_url</td><td>string</td><td>URL, на который необходимо ответить после обработки документа.</td></tr><tr><td>status</td><td>enum (string)</td><td><p>Статус. Возможные значения:</p><ul><li><code>done</code> – зарегистрирован;</li><li><code>fail</code> – ошибка;</li><li><code>wait</code> – ожидание.</li></ul></td></tr><tr><td>group_code</td><td>string</td><td>Идентификатор группы ККТ.</td></tr><tr><td>daemon_code</td><td>string</td><td>Наименование сервера.</td></tr><tr><td>device_code</td><td>string</td><td>Код ККТ.</td></tr><tr><td>external_id</td><td>string</td><td>Идентификатор документа внешней системы, уникальный среди всех документов, отправленных в данную группу ККТ.</td></tr><tr><td>error</td><td>object</td><td>Описание ошибки. См. Описание объекта <code>error</code></td></tr><tr><td>payload</td><td>object</td><td>Реквизиты фискализации документа.</td></tr></tbody></table>

#### Описание объекта error

<table data-full-width="true"><thead><tr><th width="175">Поле</th><th width="137">Тип</th><th width="438">Описание</th></tr></thead><tbody><tr><td>error_id</td><td>string</td><td>Уникальный идентификатор ошибки.</td></tr><tr><td>code</td><td>integer</td><td>Код ошибки. Отображается только при ошибке.</td></tr><tr><td>text</td><td>string</td><td>Текст ошибки (кодировка utf–8)</td></tr><tr><td>type</td><td>enum (string)</td><td>Тип источника ошибки. Возможные значения — только <code>system</code>.</td></tr></tbody></table>

#### Описание объекта payload

<table data-full-width="true"><thead><tr><th width="175">Поле</th><th width="137">Тип</th><th width="438">Описание</th><th>Тег ФФД</th></tr></thead><tbody><tr><td>shift_number</td><td>integer</td><td>Номер смены.</td><td>1038</td></tr><tr><td>receipt_datetime</td><td>string</td><td>Дата и время документа из ФН.</td><td>1012</td></tr><tr><td>total</td><td>number</td><td><p>Итоговая сумма документа в рублях;</p><ul><li>целая часть не более 8 знаков;</li><li>дробная часть не более 2 знаков.</li></ul><p>При регистрации в ККТ происходит расчёт фактической суммы: суммирование значений <code>sum</code> позиций.</p></td><td>1020</td></tr><tr><td>fn_number</td><td>string</td><td>Номер ФН.</td><td>1041</td></tr><tr><td>ecr_registration_number</td><td>string</td><td>Регистрационный номер ККТ.</td><td>1037</td></tr><tr><td>fiscal_document_number</td><td>integer</td><td>Фискальный номер документа.</td><td>1040</td></tr><tr><td>fiscal_receipt_number</td><td>integer</td><td>Номер чека в смене</td><td></td></tr><tr><td>fiscal_document_attribute</td><td>integer</td><td>Фискальный признак документа.</td><td>1077</td></tr><tr><td>fns_site</td><td>string</td><td>Адрес сайта ФНС.</td><td>1060</td></tr><tr><td>ofd_receipt_url</td><td>string</td><td>URL для просмотра чека на сайте ОФД. Отображается только для чеков, зарегистрированных с помощью  <code>Платформы ОФД</code></td><td>-</td></tr></tbody></table>

[^1]: ФНС ограничивает использование тега 1192. Эти ограничения также реализованы на уровне ККТ.

[^2]: См. описание в таблице.

[^3]: ФНС ограничивает использование тега 1192.

[^4]: ФНС ограничивает использование тега 1084.

[^5]: См. описание в таблицах.

[^6]: См. описание в таблицах