Перейти к содержанию

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

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"
         }
      }
   }
}