Фискализация

Формирование чека

Параметры позиций заказа для чека могут передаваться при:

  • создании (метод create)
  • подтверждении (метод commit)
  • возврате заказа (метод refund)
  • подтверждении успешной доставки (метод complete_delivery)

Они содержатся в структуре объекта receipt под каждым элементом для списка items.

Включение/выключение формирования чеков осуществляется с помощью отдельного параметра fiscalization_settings.

Структура объекта order.items.receipt

Элемент структуры

Тип

Обязательность

Описание

payment_method

string

Обязательно для ФФД 1.2

Тег ФФД: 1214
Возможные значения:
«full_prepayment» — предоплата 100%. Полная предварительная оплата до момента передачи предмета расчета
«advance» — аванс
«full_payment» — полный расчет. Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи

tax

string

Обязательно

Тег ФФД: 1199
Ставка налога.
Перечисление со значениями:
«none» — без НДС
«vat0» — НДС по ставке 0%
«vat5» — НДС по ставке 5%
«vat105» — НДС по ставке 5/105
«vat7» — НДС по ставке 7%
«vat107» — НДС по ставке 7/107
«vat10» — НДС чека по ставке 10%
«vat110» — НДС чека по расчетной ставке 10/110
«vat20» — НДС чека по ставке 20%
«vat120» — НДС чека по расчетной ставке 20/120
«vat22» — НДС чека по ставке 22%

payment_object

string

Обязательно для ФФД 1.2

Тег ФФД: 1212
Признак предмета расчета
«commodity» — товар. О реализуемом товаре, за исключением подакцизного товара (наименование и иные сведения, описывающие товар).
«excise» — подакцизный товар. О реализуемом подакцизном товаре (наименование и иные сведения, описывающие товар).
«job» — работа. О выполняемой работе (наименование и иные сведения, описывающие работу).
«service» — услуга. Об оказываемой услуге (наименование и иные сведения, описывающие услугу).
«gambling_bet» — ставка азартной игры. О приеме ставок при осуществлении деятельности по проведению азартных игр.
«gambling_prize» — выигрыш азартной игры. О выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр.
«lottery» — лотерейный билет. О приеме денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей.
«lottery_prize» — выигрыш лотереи. О выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотерей.
«intellectual_activity» — предоставление результатов интеллектуальной деятельности. О предоставлении прав на использование результатов интеллектуальной деятельности или средств индивидуализации.
«payment» — платеж. Об авансе, задатке, предоплате, кредите, взносе в счет оплаты, пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчета.
«agent_commission» — агентское вознаграждение. О вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом.
«composite» — составной предмет расчета. О предмете расчета, состоящем из предметов, каждому из которых может быть присвоено значение вышеперечисленных признаков.
«another» — иной предмет расчета. О предмете расчета, не относящемуся к вышеперечисленным предметам расчета.
«excisable_goods_without_marking_code» — о реализуемом подакцизном товаре, подлежащем маркировке средством идентификации, не имеющем кода маркировки.
«excisable_goods_with_marking_code» — о реализуемом подакцизном товаре, подлежащем маркировке средством идентификации, имеющем код маркировки.
«goods_without_marking_code» — о реализуемом товаре, подлежащем маркировке средством идентификации, не имеющем кода маркировки, за исключением подакцизного товара.
«goods_with_marking_code» — о реализуемом товаре, подлежащем маркировке средством идентификации, имеющем код маркировки, за исключением подакцизного товара

measurement_unit

string

Обязательно для ФФД 1.2

Тег ФФД: 2108
шт — применяется для предметов расчета, которые могут быть реализованы поштучно или единицами;
г — грамм;
кг — килограмм;
т — тонна;
см — сантиметр;
дм — дециметр;
м — метр;
см2 — квадратный сантиметр;
дм2 — квадратный дециметр;
м2 — квадратный метр;
мл — миллиметр;
л — китр;
м3 — кубический метр;
кВт*ч — киловатт/час;
Гкал — гигакалория;
сут или дн — сутки или день;
ч — час;
мин — минута;
с — секунда;
Кбайт — килобайт;
Мбайт — мегабайт;
Гбайт — гигабайт;
Тбайт — терабайт;
— — применяется при использовании иных единиц измерения

item_code

string

Необязательно

Код маркировки, как он был прочитан сканером

mark_code

object

Необязательно

Тег ФФД: 1163
Объект с параметрами кода маркировки товара. Включается в чек в случае, если предметом расчета является товар,
подлежащий обязательной маркировке средством идентификации (соответствующий код в поле payment_object)

mark_code.mark_code_type

string

Обязательно

Тип кода товара
unknown — код товара, формат которого не идентифицирован, как один из реквизитов;
ean8 — код товара в формате EAN-8;
ean13 — код товара в формате EAN-13;
itf14 — код товара в формате ITF-14;
gs10 — код товара в формате GS1, который нанесен на товар, не подлежащий маркировке;
gs1m — код товара в формате GS1, который нанесен на товар, подлежащий маркировке;
short — код товара в формате короткого кода маркировки, который нанесен на товар;
fur — контрольно-идентификационный знак мехового изделия;
egais20 — код товара в формате ЕГАИС-2.0;
egais30 — код товара в формате ЕГАИС-3.0;
rawcode — код маркировки, как он был прочитан сканером

mark_code.value

string

Обязательно

Значение кода товара

mark_processing_mode

string

Необязательно

Тег ФФД: 2102
Режим обработки кода маркировки. Должен принимать значение, равное 0.
Включается в чек, если предметом расчета является товар, который подлежит обязательной маркировке сканером (соответствующий код в поле payment_object)

mark_quantity

object

Необязательно

Объект с дробным количеством маркированного товара

mark_quantity.numerator

integer

Обязательно

Тег ФФД: 1293
Числитель дробной части предмета расчета. Значение должно быть строго меньше значения реквизита «знаменатель»

mark_quantity.denominator

integer

Обязательно

Тег ФФД: 1294
Знаменатель дробной части предмета расчета. Значение равно количеству товара в партии (упаковке), которая имеет общий код маркировки товара

sectoral_item_props

array

Необязательно

Отраслевой реквизит предмета расчета. Указывается только для товаров, которые подлежат обязательной маркировке сканером. Включение этого реквизита предусмотрено НПА отраслевого регулирования для соответствующей товарной группы

sectoral_item_props.federal_id

string

Обязательно

Тег ФФД: 1262
Идентификатор ФОИВ — федеральный орган исполнительной власти. Может принимать значения от 001 до 072

sectoral_item_props.date

string

Обязательно

Тег ФФД: 1263
Дата нормативного акта ФОИВ dd.MM.yyyy

sectoral_item_props.number

string

Обязательно

Тег ФФД: 1264
Номер нормативного акта ФОИВ

sectoral_item_props.value

string

Обязательно

Тег ФФД: 1265
Состав значений, которые определены нормативным актом ФОИВ

timezone

integer

Необязательно

Тег ФФД: 1011
Часовая зона места доставки товара.
Передаётся при наличии в чеке товаров с маркировкой
(заполнен item_code/mark_code)
Если не передано, будет использовано значение из настроек кассы (по умолчанию 2)
Целочисленное значение. Соответствие кода и названия часовой зоны РФ:
1 — Калининград
2 — Москва
3 — Самара
4 — Екатеринбург
5 — Омск
6 — Красноярск
7 — Иркутск
8 — Якутск
9 — Владивосток
10 — Магадан
11 — Камчатка

Структура объекта fiscalization_settings

Элемент структуры

Тип

Обязательность

Описание

type

string

Необязательно

Принимает значения «enabled"/»disabled» (вкл/выкл генерация чеков при commit по заявке)

params

object

Необязательно

Используется только при формировании каких-либо чеков при вызове метода commit

params.create_receipt_for_committed_items

boolean

Обязательно

True/False генерация чеков на все позиции в items в методе commit

params.create_receipt_for_added_items

boolean

Обязательно

True/False генерация чеков на новые позиции в items, добавившиеся при использовании метода commit

params.create_receipt_for_returned_items

boolean

Обязательно

True/False генерация чеков на удаленные позиции в items в commit, при сравнении с items из метода create

Структура объектов order.items.agent_data и order.items.supplier_info при использовании фискализации по агентской схеме

Элемент структуры

Тип

Обязательность

Описание

agent_data

object

Необязательно

Данные агента. Параметр обязательный, если используется агентская схема

agent_data.agent_sign

string

Необязательно

Тег ФФД: 1222
Признак агента:
bank_paying_agent — банковский платежный агент;
bank_paying_subagent — банковский платежный субагент;
paying_agent — платежный агент;
paying_subagent — платежный субагент;
attorney — поверенный;
commission_agent — комиссионер;
another — другой тип агента

agent_data.operation_name

string

Необязательно

Тег ФФД: 1044
Наименование операции.
Параметр обязательный, если agent_sign передан в значениях bank_paying_agent или bank_paying_subagent

agent_data.phones

array

Необязательно

Тег ФФД: 1073
Телефоны платежного агента. Параметр обязательный, если agent_sign передан в значениях:
bank_paying_agent;
bank_paying_subagent;
paying_agent;
paying_subagent

agent_data.receiver_phones

array

Необязательно

Тег ФФД: 1074
Телефоны оператора по приему платежей. Параметр обязательный, если agent_sign передан в значениях paying_agent или paying_subagent

agent_data.transfer_phones

array

Необязательно

Тег ФФД: 1075
Телефоны оператора перевода в формате. Параметр обязательный, если agent_sign передан в значениях bank_paying_agent или bank_paying_subagent

agent_data.operator_name

string

Необязательно

Тег ФФД: 1026
Наименование оператора перевода.
Параметр обязательный, если agent_sign передан в значениях bank_paying_agent или bank_paying_subagent

agent_data.operator_address

string

Необязательно

Тег ФФД: 1005
Адрес оператора перевода.
Параметр обязательный, если agent_sign передан в значениях bank_paying_agent или bank_paying_subagent

agent_data.operator_inn

string

Необязательно

Тег ФФД: 1016
ИНН оператора перевода. Параметр обязательный, если agent_sign передан в значениях bank_paying_agent или bank_paying_subagent

supplier_info

object

Необязательно

Данные поставщика платежного агента. Параметр обязательный, если передается значение agent_sign в объекте agent_data

supplier_info.phones

array

Необязательно

Тег ФФД: 1171
Телефон поставщика. Параметр обязательный, если передается значение agent_sign в объекте agent_data

supplier_info.name

string

Обязательно

Тег ФФД: 1225
Наименование поставщика. Параметр обязательный, если передается значение agent_sign в объекте agent_data. Состоит из 239 символов, в которые включаются телефоны поставщика — + 4 символа на каждый телефон.
Например, если передано два телефона поставщика длиной 12 и 14 символов, максимальная длина наименования поставщика будет 239 — (12 + 4) — (14 + 4) = 205 символов

supplier_info.inn

string

Обязательно

Тег ФФД: 1226
ИНН поставщика в формате. Параметр обязательный, если передается значение agent_sign в объекте agent_data

Пример на Create

{
  "order": {
    "id": "string",
    "amount": 1000,
    "prepaid_amount": 0,
    "items": [
      {
        "name": "string",
        "quantity": 1,
        "price": 1000,
        "receipt": {
          "tax": "string",
          "payment_method": "string",
          "payment_object": "string",
          "measurement_unit": "string",
          "item_code": "string",
          "mark_code": {
            "mark_code_type": "string",
            "value": "string"
          },
          "mark_processing_mode": "string",
          "mark_quantity": {
            "numerator": 0,
            "denominator": 0
          },
          "sectoral_item_props": [
            {
              "federal_id": "001",
              "date": "01.01.2025",
              "number": "string",
              "value": "string"
            }
          ]
        },
        "agent_data": {
          "agent_sign": "bank_paying_agent",
          "operation_name": "string",
          "phones": [
            "string"
          ],
          "receiver_phones": [
            "string"
          ],
          "transfer_phones": [
            "string"
          ],
          "operator_name": "string",
          "operator_address": "string",
          "operator_inn": "string"
        },
        "supplier_info": {
          "phones": [
            "string"
          ],
          "name": "string",
          "inn": "string"
        }
      }
    ]
  },
  "fiscalization_settings": {
    "type": "enabled"
  }
}