Описание параметров платёжной формы

Внимание! Важная информация касательно ФЗ-54 внизу страницы.

Для корректного формирования счёта в системе «Инвойсбокс» существует обязательный набор параметров. Контактные данные плательщика являются обязательными параметрами, но могут быть переданы на усмотрение магазина. Чтобы не заставлять плательщика дважды указывать номер телефона и адрес электронной почты, рекомендуем передавать их в систему «Инвойсбокс» вместе с информацией о заказе (в параметрах itransfer_person_email и itransfer_person_phone).

Параметр	Описание	Значения
itransfer_language_ident	Начальный язык, на котором будут отображаться платёжные страницы. Пользователь будет иметь возможность смены данного языка на доступные.	Код языка в соответствии со стандартом ISO 639-3. RUS - русский, ENG - английский и т.д.	Опционально
itransfer_participant_id	Идентификатор магазина	Число	Обязательно
itransfer_participant_ident	Региональный код магазина	Число	Обязательно
itransfer_participant_sign	Подпись безопасности¹	Строка	Обязательно
itransfer_order_id	Номер заказа магазина, присвоенный заказу в системе учёта магазина	Строка	Опционально
itransfer_order_amount	Стоимость заказа	Дробное число	Обязательно
itransfer_order_amount_vat	Сумма налога на добавленную стоимость (НДС)	Дробное число	Опционально
itransfer_order_currency_ident	Код валюты. Магазин должен иметь возможность работы с указанным кодом валюты по договору.	Код валюты в соответствии со стандартом ISO 4217 - RUB – российский рубль, EUR – евро, USD – доллар США и т.д.	Обязательно
itransfer_order_description	Описание заказа или назначение платежа	Строка	Обязательно
itransfer_body_type	Тип плательщика	PRIVATE – частное/физическое лицо LEGAL – организация	Опционально
itransfer_timelimit	Базовый срок оплаты счёта. По истечению указанного времени, не оплаченный счёт будет удалён	Время в формате ATOM	Опционально
itransfer_person_name	Фамилия, имя и отчество плательщика или наименование организации	Строка	Опционально
itransfer_person_email	Адрес электронной почты плательщика. Используется с целью информирования клиента о сформированном счёте, полученной оплате или оформлении возврата	Адрес электронной почты	Опционально
itransfer_person_phone	Номер мобильного телефона плательщика. Используется с целью информирования клиента о сформированном счёте, полученной оплате или оформлении возврата	Номер в международном формате E.164 с префиксом в виде знака “+”	Опционально
itransfer_url_returnsuccess	Ссылка страницы на которую будет перенаправлен плательщик по завершению процесса оплаты счёта	Корректная ссылка (URL)	Опционально
itransfer_url_return	Ссылка страницы, которая будет отображена на платёжной странице или по завершению процесса оплаты счёта	Корректная ссылка (URL)	Опционально
itransfer_testmode	Отметка о тестовом режиме. Платежи в тестовом режиме фактически не проходят через финансовую систему. Активировать возможность использования данного флажка вы можете в личном кабинете	Число - 1 или 0	Опционально

Информация о корзине клиента/номенклатуре

Для лучшего пользовательского опыта, магазин может также передать в систему «Инвойсбокс» информацию о составе заказа. Информация о составе заказа также важна при формировании счетов клиентам - организациям.

Внимание! С 1 июля 2017 г., для обеспечения работы магазинов и передачи данных в онлайн-кассу в соответствии с ФЗ-54, передача номенклатуры товаров/услуг обязательна!

Параметр	Описание	Значения
itransfer_itemN_id	Уникальный идентификатор позиции в заказе	Строка
itransfer_itemN_name	Наименование товара или услуги	Строка	Обязательно
itransfer_itemN_quantity	Количество товара или услуги	Число	Обязательно
itransfer_itemN_measure	Единица измерения	Строка: шт., комплект, литры, кг, тонны и т.п.	Обязательно
itransfer_itemN_measurecode	Код единицы измерения	Число: коды ОКЕИ
itransfer_itemN_type	Тип позиции	Строка: commodity (товар), service (услуга)	Обязательно
itransfer_itemN_price	Стоимость за 1 единицу	Число	Обязательно
itransfer_itemN_vatrate	Значение ставки налога на добавленную стоимость (НДС)²	Число	Обязательно
itransfer_itemN_vat	Сумма налога на добавленную стоимость (НДС) за 1 единицу	Число	Обязательно
itransfer_itemN_marked	Признак наличия маркировки товара	Число	Опционально
itransfer_itemN_markcode	Код товара в шестнадцатеричном представлении с пробелами	Строка	Обязательно для маркированных товаров

Где, N — число, начинающееся с 1

Пример передачи информации о составе корзины

¹Подпись безопасности формируется на основе конкатенации (сложения) значений следующих параметров: itransfer_participant_id, itransfer_order_id, itransfer_order_amount, itransfer_order_currency_ident, ключ безопасности. Т.е. itransfer_participant_sign = md5( itransfer_participant_id + itransfer_order_id + itransfer_order_amount + itransfer_order_currency_ident + ключ безопасности )

²Размер ставки НДС может быть передан одним из двух способов:
- в соответствии с таблицей №24 "Формат ЭФ" из приказа ФНС "Об утверждении дополнительных реквизитов фискальных документов и форматов фискальных документов, обязательных к использованию" (см. ниже);
- свободными значениями: 0, 10, 20, "-" НДС не облагается, "*" НДС не выделяется.

Таблица №24
из приказа ФНС "Об утверждении дополнительных реквизитов фискальных документов и форматов фискальных документов, обязательных к использованию"

Наименование ставки НДС	Формат ЭФ
ставка НДС 20%	1
ставка НДС 10%	2
ставка НДС расч. 20/120	3
ставка НДС расч. 10/110	4
НДС 0%	5
НДС не облагается	6

Читать далее: демонстрационная витрина →