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

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

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

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

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

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

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

Тип

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

Описание

payment_method

string

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

Возможные значения:

«full_prepayment» — предоплата 100%. Полная предварительная оплата до момента передачи предмета расчета

«advance» — аванс

«full_payment» — полный расчет. Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи

tax

string

Обязательно

Ставка налога.

Перечисление со значениями:

«none» — без НДС
«vat0» — НДС по ставке 0%
«vat10» — НДС чека по ставке 10%
«vat110» — НДС чека по расчетной ставке 10/110
«vat20» — НДС чека по ставке 20%
«vat120» — НДС чека по расчетной ставке 20/120

payment_object

string

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

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

Признак предмета расчета

«commodity» — товар. О реализуемом товаре, за исключением подакцизного товара (наименование и иные сведения, описывающие товар).

«excise» — подакцизный товар. О реализуемом подакцизном товаре (наименование и иные сведения, описывающие товар).

«job» — работа. О выполняемой работе (наименование и иные сведения, описывающие работу).

«service» — услуга. Об оказываемой услуге (наименование и иные сведения, описывающие услугу).

«gambling_bet» — ставка азартной игры. О приеме ставок при осуществлении деятельности по проведению азартных игр.

«gambling_prize» — выигрыш азартной игры. О выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр.

«lottery» — лотерейный билет. О приеме денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей.

«lottery_prize» — выигрыш лотереи. О выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотерей.

«intellectual_activity» — предоставление результатов интеллектуальной деятельности. О предоставлении прав на использование результатов интеллектуальной деятельности или средств индивидуализации.

«payment» — платеж. Об авансе, задатке, предоплате, кредите, взносе в счет оплаты, пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчета.

«agent_commission» — агентское вознаграждение. О вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом.

«composite» — составной предмет расчета. О предмете расчета, состоящем из предметов, каждому из которых может быть присвоено значение вышеперечисленных признаков.

«another» — иной предмет расчета. О предмете расчета, не относящемуся к вышеперечисленным предметам расчета.

measurement_unit

string

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

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

Единицы измерения позиции чека

Структура объекта 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

Пример на Create

{
  "order": {
    "id": "test",
    "amount": 4400,
    "items": [
      {
        "name": "Доставка",
        "quantity": 1,
        "price": "0",
        "receipt": {
          "tax": "vat20",
          "payment_method": "full_prepayment"
        }
      },
      {
        "name": "Книга",
        "quantity": 1,
        "price": "4400",
        "receipt": {
          "tax": "vat10",
          "payment_method": "full_payment"
        }
      }
    ]
  },
  "fiscalization_settings": {
    "type": "disabled"
  },
  "fail_url": "https://tinkoff.ru",
  "success_url": "https://tinkoff.ru",
  "notification_url": "https://tinkoff.ru"
}