Фискализация
API bePaid позволяет передать фискальные данные в банк. Эти данные могут использоваться, например, чтобы направить электронный чек покупателю услуги, который требуется в рамках федерального закона РФ 54-Ф3.
Info
Предварительно уточните у вашего менеджера, возможна ли отправка чеков в вашем банке и условия подключения опции на стороне банка.
Дополнительные параметры запроса для фискализации
Чтобы отправить чек, вам необходимо передать дополнительные параметры в поле additional_data
в запросе на оплату, авторизацию или на списание в случае частичного списания (используется при отмене или изменении позиций, которые были при авторизации).
В случае полного списания секция параметров фискализации не передается. Система автоматически направит в банк параметры фискализации, которые пришли в запросе на авторизацию.
Параметр | Тип | Описание |
---|---|---|
fiscalization | object | Секция параметров фискализации. |
inn * обязательный |
string(12) | ИНН организации, для которой пробивается чек. |
group * обязательный |
string(32) | Группа устройств, с помощью которых будет пробит чек. Строка от 1 до 32 символов или null .Значение параметра запрашивается у вашего менеджера. |
key * обязательный |
sring(32) | Название ключа, который должен быть использован для проверки подписи. Строка от 1 до 32 символов либо null .Значение параметра запрашивается у вашего менеджера. |
type * обязательный |
string | Код признака расчета. Возможные значения: 1 - Приход, 2 - Возврат прихода, 3 - Расход, 4 - Возврат расхода. |
positions * обязательный |
array | Список предметов расчета, каждый элемент которого состоит из: |
quantity * обязательный |
float | Количество предмета расчета. Десятичное число с точностью до 6 символов после точки. |
price * обязательный |
float | Цена за единицу предмета расчета с учетом скидок и наценок. Десятичное число с точностью до 2 символов после точки. |
tax * обязательный |
integer | Ставка НДС. Число от 1 до 6. Возможные значения: 1 - ставка НДС 20%, 2 - ставка НДС 10%, 3 - ставка НДС расч. 18/118, 4 - ставка НДС расч. 10/110, 5 - ставка НДС 0%, 6 - НДС не облагается. |
text * обязательный |
string (128) | Наименование предмета расчета. |
payment_method_type | integer | Признак способа расчета. Число от 1 до 7 или null .Возможны следующие значения: 1 - Предоплата 100%, 2 - Частичная предоплата, 3 - Аванс, 4 - Полный расчет, 5 - Частичный расчет и кредит, 6 - Передача в кредит, 7 - Оплата кредита.Если передано null , то по умолчанию используется значение 4 - Полный расчет. |
payment_subject_type | integer | Признак предмета расчета. Число от 1 до 13 или null .Возможные значения: 1 - Товар, 2 - Подакцизный товар, 3 - Работа, 4 - Услуга, 5 - Ставка азартной игры, 6 - Выигрыш азартной игры, 7 - Лотерейный билет, 8 - Выигрыш лотереи, 9 - Предоставление РИД, 10 - Платеж, 11 - Агентское вознаграждение, 12 - Составной предмет расчета,13 - Иной предмет расчета. Если передано null , то по умолчанию используется значение 1 - Товар. |
nomenclature_code | string | Код товарной номенклатуры. Строка, содержащая base64 кодированный массив от 1 до 32 байт либо null . Расшифровывать значение не требуется. |
measurement_unit | string | Единица измерения. |
excise | object | Информация об акцизах. Заполняется если предмет расчета признается объектом налогообложения акцизами. |
excise | float | Сумма акцизa. Число с точностью 2 знака после точки. Тип - decimal . |
country_origin_code | string | Цифровой код страны происхождения товара в соответствии с Общероссийским классификатором стран мира. 3 символа. ISO 3166-1 numeric. |
customs_declaration_number | string(32) | Регистрационный номер таможенной декларации. |
check_close | object | Параметры закрытия чека. |
payments * обязательный |
array | Массив операций оплаты. Каждый элемент содержит тип оплаты и сумму. |
type * обязательный |
integer | Тип оплаты. В параметре передается цифровой код, который соответствует типу оплаты: 1 - Сумма по чеку наличными, 2 - Сумма по чеку электронными, 14 - Сумма по чеку предоплатой (зачетом аванса и (или) предыдущих платежей), 15 - Сумма по чеку постоплатой (в кредит), 16 - Сумма по чеку (БСО) встречным предоставлением. |
amount * обязательный |
integer | Сумма оплаты. Десятичное число с точностью до 2 символов после точки. |
taxation_system * обязательный |
integer | Система налогообложения. В параметре необходимо указать цифровой код, который соответствует системе налогообложения: 0 - Общая, ОСН, 1 - Упрощенная доход, УСН доход, 2 - Упрощенная доход минус расход, УСН доход - расход, 3 - Единый налог на вмененный доход, ЕНВД, 4 - Единый сельскохозяйственный налог, ЕСН, 5 - Патентная система налогообложения, Патент. |
customer_contact * обязательный |
string | Телефон покупателя в формате +ХХХХХХХХХХХХ или адрес электронной почты покупателя. На указанный номер телефона или адрeс электронной почты будет направлен электронный чек. |
agent_type | integer | Признак агента. Возможны следующие значения: 0 - Банковский платежный агент, 1 - Банковский платежный субагент, 2 - Платежный агент, 3 - Платежный субагент, 4 - Поверенный, 5 - Комиссионер, 6 - Иной агент. |
additional_user_attribute | object | Список дополнительных реквизитов пользователя, каждый элемент которого состоит из: |
name | string(64) | Наименование дополнительного реквизита пользователя. |
value | string(175) | Значение дополнительного реквизита пользователя. |
settlement_address | string | Адрес осуществления расчетов между пользователем и покупателем. |
calculation_place | string | Место осуществления расчетов между пользователем и покупателем, позволяющее покупателю идентифицировать место расчета. |
customer_info | string | Покупатель - наименование организации или фамилия, имя, отчество. |
customer_inn | string | ИНН покупателя. |
Пример запроса на платеж с фискализацией
{
"request":{
"amount":15020,
"currency":"RUB",
"description":"Test transaction",
"tracking_id":"your_uniq_number",
"language":"en",
"test":true,
"billing_address":{
"first_name":"John",
"last_name":"Doe",
"country":"US",
"city":"Denver",
"state":"CO",
"zip":"96002",
"address":"1st Street"
},
"credit_card":{
"number":"4200000000000000",
"verification_value":"123",
"holder":"John Doe",
"exp_month":"05",
"exp_year":"2020"
},
"additional_data":{
"fiscalization":{
"inn":"7707439885",
"group":"3010057",
"key":"3010057",
"type":"1",
"positions":[
{
"quantity":1,
"price":30,
"tax":1,
"text":"Item 1"
},
{
"quantity":12.02,
"price":10,
"tax":1,
"text":"Item 2"
}
],
"check_close":{
"payments":[
{
"type":2,
"amount":150.2
}
],
"taxation_system":0
},
"customer_contact":"+711111111111"
},
"customer":{
"ip":"127.0.0.1",
"email":"john@example.com"
}
}
}
}