Вход в личный кабинет
Вход в личный кабинет
Выберите тип пользователя
Магазин
«Инвойсбокс.Бизнес»

Функция обновления счёта

Для того чтобы обновить счёт для физического лица, необходимо вызвать функцию веб-сервиса updateInvoice.

Входящие параметры функции:

Параметр

Описание

ucode

Уникальный номер счёта в системе «Инвойсбокс»

description

Описание заказа или назначение платежа

amount

Стоимость заказа

personName

Фамилия, имя и отчество плательщика или наименование организации

personPhone

Номер мобильного телефона плательщика. Используется с целью информирования клиента о сформированном счёте, полученной оплате или оформлении возврата. Номер в международном формате E.164 с префиксом в виде знака “+”.

personEmail

Адрес электронной почты плательщика. Используется с целью информирования клиента о сформированном счёте, полученной оплате или оформлении возврата

timelimit

Базовый срок оплаты счёта. По истечению указанного времени, не оплаченный счёт будет удалён. Время в формате ATOM.

items

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

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-хэширование применяется к тексту, который формируется как последовательность значений ряда параметров запроса без разделителей. Результат хэширования приводится к нижнему регистру.

Порядок следования параметров:

ucode+description+amount+personName+personPhone+personEmail+ключ безопасности

Возвращаемые параметры функции

Параметр

Описание

resultCode

Код ответа магазина

resultMessage

Комментарий ответа

ucode

Уникальный номер счёта в системе «Инвойсбокс»

uusid

Уникальный идентификатор счёта в системе «Инвойсбокс»

В случае успешного обновления счёта, веб-сервис вернёт значение resultCode=0. В случае возникновения ошибки, веб-сервис вернёт детальное описание такой ошибки в параметре resultMessage, при этом значение параметра resultCode не будет равняться нулю.

Читать далее: получение информации о счёте →

Спасибо за обращение!
Мы свяжемся с вами в ближайшее время.