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

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