Управление счетами

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

В текущем разделе документации рассматривается вариант автоматизированного управления счетами. Описанные далее функции позволяют системе учёта магазина направлять запросы в систему «Инвойсбокс» для создания, изменения и удаления счетов.

Протокол управления счетами подразумевает обращение к веб-сервису системы «Инвойсбокс» в форматах SOAP или REST+JSON по следующим адресам:

Для работы с веб-сервисом магазину необходимо соблюсти следующие условия:

1. В личном кабинете магазина должен быть сформирован ключ безопасности. Ключ безопасности используется для формирования подписи всех запросов к веб-сервису;
2. В личном кабинете магазина должен быть настроен IP фильтр для группы пользователей “API”. Доступ к веб-сервису организуется только для определенных в личном кабинете магазина IP адресов;
3. В личном кабинете магазина должен быть создан пользователь, от лица которого будет происходить взаимодействие по протоколу. По умолчанию система добавляет пользователя с именем *****-API (см. письмо об активации в системе «Инвойсбокс»). Имя такого пользователя и пароль должны быть использованы для HTTP авторизации при доступе к веб-сервису - ваш сервис должен направить HTTP заголовок Authorization с именем пользователя и паролем.

Пример запроса:

curl --basic --data "{\"participantOrderId\":\"123456\",\"sign\":\"56f78a86365b25e903e8bc9165da8f4b\",\"function\":\"getOrderDetails\"}" --url https://wss.invoicebox.ru/ws/participant/wsparticipantlite-pponly.u?function=getOrderDetails --header "Authorization: Basic NzgwNDMtQVBJOnJ6cXZCTDltNFE="

Где "NzgwNDMtQVBJOnJ6cXZCTDltNFE=" - имя пользователя API и пароль полученные в личном кабинете в кодировке base64, разделённые двоеточием, т.е. base64_encode('12345-API:пароль');

При использовании форматов REST+JSON, наименования вызываемой функции передаётся в параметре function, далее передаётся набор параметров.

Функции веб-сервиса

• Оформление счёта;
• Получение информации о счёте;
• Удаление счёта или оформление возврата средств плательщику.

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