Для того чтобы оформить счёт для физического лица, необходимо вызвать функцию веб-сервиса addInvoice.
|
Параметр |
Описание |
|---|---|
|
participantOrderId |
Номер заказа магазина, присвоенный заказу в системе учёта магазина |
|
description |
Описание заказа или назначение платежа |
|
amount |
Стоимость заказа |
|
personName |
Фамилия, имя и отчество плательщика или наименование организации |
|
personPhone |
Номер мобильного телефона плательщика. Используется с целью информирования клиента о сформированном счёте, полученной оплате или оформлении возврата. Номер в международном формате E.164 с префиксом в виде знака “+”. |
|
personEmail |
Адрес электронной почты плательщика. Используется с целью информирования клиента о сформированном счёте, полученной оплате или оформлении возврата |
|
timelimit |
Базовый срок оплаты счёта. По истечению указанного времени, не оплаченный счёт будет удалён. Время в формате ATOM. |
|
items |
Информация о корзине клиента/номенклатуре, массив |
|
agentOperationIdent |
В данном контексте – не используется |
|
agentOperationExtra |
В данном контексте – не используется |
|
sign |
Подпись запроса |
Внимание! С 1 июля 2017 г., для обеспечения работы магазинов и передачи данных в онлайн-кассу в соответствии с ФЗ-54, передача номенклатуры товаров/услуг обязательна!
|
Параметр |
Описание |
Значения |
|
|---|---|---|---|
|
ident |
Уникальный идентификатор позиции в заказе |
Строка |
|
|
name |
Наименование товара или услуги |
Строка |
Обязательно |
|
type |
Предмет расчёта |
Строка: service - услуга, commodity - товар |
Обязательно |
|
quantity |
Количество товара или услуги |
Число |
Обязательно |
|
measure |
Единица измерения |
Строка: шт., комплект, литры, кг, тонны и т.п. |
Обязательно |
|
price |
Стоимость за 1 единицу |
Число |
Обязательно |
|
vatrate |
Значение ставки налога на добавленную стоимость (НДС) (см. параметры платёжной формы) |
Число |
Обязательно |
|
vat |
Сумма налога на добавленную стоимость (НДС) за 1 единицу |
Число |
Обязательно |
|
marked |
Признак наличия маркировки товара |
Число |
Опционально |
|
mark_code |
Код товара в шестнадцатеричном представлении с пробелами |
Строка |
Обязательно для маркированных товаров |
Подпись запроса
При использовании базового варианта безопасности с MD5, магазину необходимо добавить в запросы параметр с именем sign (подпись запроса). Значение параметра — MD5-хэш от строки, собранной из значений параметров этого же запроса вместе с ключом безопасности.
При получении запроса от магазина, система «Инвойсбокс» будет проверять параметр подписи sign. Если значение sign не совпадает с результатом расчёта хэш-функции MD5 от переданных параметров, в обработке запроса будет отказано.
MD5-хэширование применяется к тексту, который формируется как последовательность значений ряда параметров запроса без разделителей. Результат хэширования приводится к нижнему регистру.
Порядок следования параметров:
|
Параметр |
Описание |
|---|---|
|
resultCode |
Код ответа магазина |
|
resultMessage |
Комментарий ответа |
|
url |
Ссылка на платёжную страницу |
|
ucode |
Уникальный номер счёта в системе «Инвойсбокс» |
|
uusid |
Уникальный идентификатор счёта в системе «Инвойсбокс» |
В случае успешного формирования счёта, веб-сервис вернёт значение resultCode=0. В случае возникновения ошибки, веб-сервис вернёт детальное описание такой ошибки в параметре resultMessage, при этом значение параметра resultCode не будет равняться нулю.
Читать далее: обновление информации о счёте →
