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

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

Пример fiscal_data

{
  "group": "Main",
  "items": [
    {
      "name": "Название товара",
      "price": 10025,
      "quantity": 2,
      "sum": 20050,
      "measurement_unit": "кг",
      "payment_method": "full_payment",
      "payment_object": "commodity",
      "vat_type": "vat20"
    }
  ],
  "client": {
    "email": "client_email@mail.ru",
    "phone": "+71231234567"
  },
  "company": {
    "email": "company_email@mail.ru",
    "sno": "osn",
    "payment_address": "https://kvell.com",
    "inn": "1234567890"
  }
}

Описание параметров

Имя параметра	Обязательно	Тег ФФД	Описание
client	Обязательно должно быть заполнено хотя бы одно из полей: email или phone.		Данные о клиенте
∟email		1008	Электронная почта покупателя. Максимальная длина строки – 64 символа.
∟phone		1008	Телефон покупателя
company	Да		Данные о компании
∟email	Да	1117	Электронная почта отправителя чека. Максимальная длина строки – 64 символа.
∟sno	Да	1055	Система налогообложения. Возможные значения см. ниже.
∟inn	Да	1018	ИНН компании
∟payment_address	Нет	1187	Место расчетов. Максимальная длина строки – 256 символов.
group	Нет		Группа устройств, с помощью которых будет пробит чек. По умолчанию Main.
items	Да		Список позиций заказа.
∟name	Да	1030	Наименование предмета расчета.
∟price	Да	1079	Цена за единицу предмета расчета с учетом скидок и наценок.
∟quantity	Да	1023	Количество/вес.
∟sum	Нет	1043	Сумма в копейках (price * quantity)
∟measurement_unit	Нет	1197	Единица измерения товара, работы, услуги, платежа, выплаты, иного предмета расчета. Максимальная длина строки – 16 символов.
∟payment_method	Да	1214	Признак способа расчета. Возможные значения см. ниже.
∟payment_object	Да, кроме АТОЛ Онлайн	1212	Признак предмета расчета. Возможные значения см. ниже.
∟vat_type	Да	1199	Ставка НДС. Возможные значения см. ниже.
∟agent_info	Нет	1222	Признак агента. См. «Агентская схема».
∟supplier_info	Да, если передан agent_info	1224	Данные поставщика. См. «Агентская схема».

Система налогообложения

Значение	Описание
osn	Общая СН
usn_income	Упрощенная СН (доходы)
usn_income_outcome	Упрощенная СН (доходы минус расходы)
envd	Единый налог на вмененный доход
esn	Единый сельскохозяйственный налог
patent	Патентная СН

Признак способа расчёта

Значение	Описание
full_prepayment	Предоплата 100%. Полная предварительная оплата до момента передачи предмета расчета.
prepayment	Предоплата. Частичная предварительная оплата до момента передачи предмета расчета.
advance	Аванс
full_payment	Полный расчет. Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета.
partial_payment	Частичный расчет и кредит. Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит.
credit	Передача в кредит. Передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит.
credit_payment	Оплата кредита. Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита)

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

Значение	Описание
commodity	Товар. О реализуемом товаре, за исключением подакцизного товара (наименование и иные сведения, описывающие товар).
excise	Подакцизный товар. О реализуемом подакцизном товаре (наименование и иные сведения, описывающие товар).
job	Работа. О выполняемой работе (наименование и иные сведения, описывающие работу).
service	Услуга. Об оказываемой услуге (наименование и иные сведения, описывающие услугу).
gambling_bet	Ставка азартной игры. О приеме ставок при осуществлении деятельности по проведению азартных игр.
gambling_prize	Выигрыш азартной игры. О выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр.
lottery	Лотерейный билет. О приеме денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей.
lottery_prize	Выигрыш лотереи. О выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотерей.
intellectual_activity	Предоставление результатов интеллектуальной деятельности. О предоставлении прав на использование результатов интеллектуальной деятельности или средств индивидуализации.
payment	Платеж. Об авансе, задатке, предоплате, кредите, взносе в счет оплаты, пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчета.
agent_commission	Агентское вознаграждение. О вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом.
award	Выплата. О взносе в счет оплаты пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчета.
another	Иной предмет расчета. О предмете расчета, не относящемуся к выше перечисленным предметам расчета.
property_right	Имущественное право. О передаче имущественных прав.
non_operating_gain	Внереализационный доход. О внереализационном доходе.
insurance_premium	Страховые взносы. О суммах расходов, уменьшающих сумму налога (авансовых платежей) в соответствии с пунктом 3.1 статьи 346.21 Налогового кодекса Российской Федерации.
sales_tax	Торговый сбор. О суммах уплаченного торгового сбора.
deposit	Залог. О залоге.
expense	Расход. О суммах произведенных расходов в соответствии со статьей 346.16 Налогового кодекса Российской Федерации, уменьшающих доход.
pension_insurance_ip	Взносы на ОПС ИП. О страховых взносах на обязательное пенсионное страхование, уплачиваемых ИП, не производящими выплаты и иные вознаграждения физическим лицам.
pension_insurance	Взносы на ОПС. О страховых взносах на обязательное пенсионное страхование, уплачиваемых организациями и ИП, производящими выплаты и иные вознаграждения физическим лицам.
medical_insurance_ip	Взносы на ОМС ИП. О страховых взносах на обязательное медицинское страхование, уплачиваемых ИП, не производящими выплаты и иные вознаграждения физическим лицам.
medical_insurance	Взносы на ОМС. О страховых взносах на обязательное медицинское страхование, уплачиваемых организациями и ИП, производящими выплаты и иные вознаграждения физическим лицам.
social_insurance	Взносы на ОСС. О страховых взносах на обязательное социальное страхование на случай временной нетрудоспособности и в связи с материнством, на обязательное социальное страхование от несчастных случаев на производстве и профессиональных заболеваний.
casino_payment	Платеж казино. О приеме и выплате денежных средств при осуществлении деятельности казино с использованием обменных знаков казино, в зале игровых автоматов.
resort_fee	Туристический налог. О туристическом налоге.

Ставка НДС

Значение	Описание
none	без НДС
vat0	НДС по ставке 0%
vat10	НДС по ставке 10%
vat18	НДС по ставке 18%
vat110	НДС по расчетной ставке 10/110
vat118	НДС по расчетной ставке 18/118
vat20	НДС по ставке 20%
vat22	НДС по ставке 22%
vat120	НДС по расчетной ставке 20/120
vat122	НДС по расчетной ставке 22/122
vat5	НДС по ставке 5%
vat7	НДС по ставке 7%
vat105	НДС по расчетной ставке 5/105
vat107	НДС по расчетной ставке 7/107

Агентская схема

Если Вы работаете по агентской схеме, в составе позиции необходимо передавать признак агента (тег 1222) и данные поставщика. Это позволяет, например, ООО «Ромашка» сформировать чек, указав в качестве поставщика ООО «Тюльпан».

Оба параметра необязательные и задаются для каждой позиции отдельно, внутри элемента items. Если передан agent_info, то supplier_info обязателен.

Ограничение

Агентская схема поддерживается только провайдером АТОЛ Онлайн. Для остальных провайдеров параметры agent_info и supplier_info игнорируются.

Пример fiscal_data

{
  "items": [
    {
      "name": "Название товара",
      "price": 10025,
      "quantity": 2,
      "sum": 20050,
      "payment_method": "full_payment",
      "payment_object": "commodity",
      "vat_type": "vat20",
      "agent_info": {
        "type": "commission_agent"
      },
      "supplier_info": {
        "name": "ООО Тюльпан",
        "inn": "7712345678",
        "phones": ["+79001234567"]
      }
    }
  ],
  "client": {
    "email": "client_email@mail.ru",
    "phone": "+71231234567"
  },
  "company": {
    "email": "company_email@mail.ru",
    "sno": "osn",
    "payment_address": "https://kvell.com",
    "inn": "1234567890"
  }
}

Описание параметров

Имя параметра	Обязательно	Тег ФФД	Описание
agent_info	Нет	1222	Атрибуты агента.
∟type	Да, если передан agent_info	1222	Признак агента. Возможные значения см. ниже.
∟paying_agent	Нет		Атрибуты платёжного агента.
∟∟operation	Нет	1044	Наименование операции. Максимальная длина строки – 24 символа.
∟∟phones	Нет	1073	Телефоны платёжного агента. Массив строк.
∟receive_payments_operator	Нет		Атрибуты оператора по приёму платежей.
∟∟phones	Нет	1074	Телефоны оператора по приёму платежей. Массив строк.
∟money_transfer_operator	Нет		Атрибуты оператора перевода.
∟∟phones	Нет	1075	Телефоны оператора перевода. Массив строк.
∟∟name	Нет	1026	Наименование оператора перевода. Максимальная длина строки – 64 символа.
∟∟address	Нет	1005	Адрес оператора перевода. Максимальная длина строки – 256 символов.
∟∟inn	Нет	1016	ИНН оператора перевода. 10 или 12 цифр.
supplier_info	Да, если передан agent_info	1224	Атрибуты поставщика.
∟inn	Да, если передан supplier_info	1226	ИНН поставщика. 10 или 12 цифр. Передавайте строкой, иначе потеряются ведущие нули.
∟name	Нет. См. примечание про ФФД 1.2	1225	Наименование поставщика. Максимальная длина строки – 256 символов.
∟phones	Нет. См. примечание про ФФД 1.2	1171	Телефоны поставщика. Массив строк.

Номер телефона необходимо передавать вместе с кодом страны, без пробелов и дополнительных символов, кроме символа «+». Максимальная длина – 19 символов.

ФФД 1.2

Если признак агента — bank_paying_agent, bank_paying_subagent, paying_agent или paying_subagent, то в ФФД 1.2 поля supplier_info.name и supplier_info.phones становятся обязательными.

Признак агента

Значение	Описание
bank_paying_agent	Банковский платёжный агент. Оказание услуг покупателю (клиенту) пользователем, являющимся банковским платёжным агентом.
bank_paying_subagent	Банковский платёжный субагент. Оказание услуг покупателю (клиенту) пользователем, являющимся банковским платёжным субагентом.
paying_agent	Платёжный агент. Оказание услуг покупателю (клиенту) пользователем, являющимся платёжным агентом.
paying_subagent	Платёжный субагент. Оказание услуг покупателю (клиенту) пользователем, являющимся платёжным субагентом.
attorney	Поверенный. Осуществление расчёта с покупателем (клиентом) пользователем, являющимся поверенным.
commission_agent	Комиссионер. Осуществление расчёта с покупателем (клиентом) пользователем, являющимся комиссионером.
another	Другой тип агента. Пользователь является агентом, но не банковским платёжным агентом (субагентом), платёжным агентом (субагентом), поверенным или комиссионером.