Формирует Акт приёма-передачи посылок в Boxberry (и одновременно инициирует загрузку переданных заказов в ИС Boxberry).
Акт приема-передачи формируется как на одну посылку, так и на группу посылок.
Обязательно наличие параметра ImIds <строки, содержащей коды отслеживания заказов>.
Обратите внимание, что в параметре ImIds вы передаёте не ваши коды заказов, а трекинг-коды, которые вернул вам метод ParselCreate.
Если отправляется запрос на формирование Акта, содержащий несколько заказов, загруженных ранее (включённых в другие акты), в ответном сообщении с ошибкой вы получите коды отслеживания этих заказов.
Внимание! Сервис работает с любыми посылками.
Гарантированное количество заказов для включения в акт приема-передачи:
- JSON - 2000 заказов
- SOAP - 500 заказов
Входящие параметры:
Параметр | Тип | Описание | Пример |
|---|---|---|---|
| token | string | Токен для доступа к api-сервисам | d6f33e419c16131e5325cbd84d5d6000 |
| ImIds | string | Трекинг код отслеживания заказа | AAP114630642,AAP114630687 |
Данные ответа:
Параметр | Тип | Описание | Пример |
|---|---|---|---|
| id | string | Номер акта (штрих-код) | 12942207 |
| label | string | Ссылка на печатную форму акта | http://api.boxberry.ru/parcel-files/act?upload_id=12942207&token=d6f33e419c16131e5325cbd84d5d6000 |
| url_tmc | string | Ссылка на печатную форму акта ТМЦ (если подключена услуга «Пост_Упаковка для ИМ брендированая (короб))» | http://api.boxberry.ru/parcel-files/act?upload_id=12942207&token=d6f33e419c16131e5325cbd84d5d6000&type_act=tmc |
| sticker | string | Ссылка на печатную форму этикеток | http://api.boxberry.ru/parcel-files/barcodes?upload_id=12942207&token=d6f33e419c16131e5325cbd84d5d6000 |
Справочник ошибок:
Текст ошибки | Описание |
|---|---|
| "id": "XXXXXX", "label": "https://" "url_tmc": "https://" "sticker": "https://" | Успешный результат выполнения запроса. При повторной попытке зарегистрировать акт в течение 72 часов, возвращается ссылка на ранее созданный акт |
| Не все из перечисленных посылок можно поместить в акт: (трекингкод(список) заказа) " | 1. Если в списке посылок передаваемых в "mIds” есть посылки, которые уже "в акте", либо отсутствуют в ЛК, то возвращать ошибку Сценарий для ошибки:
2. При повторной регистрации акта по истечению 72 часов |
| "Только посылки с одинаковым пунктом приема могут быть сформированы в акт." | Если в списке посылок, передаваемых в "ImIds" есть посылки с разным пунктом приема (параметр"name1", метод ParselCreate). |
| "Нет данных о посылках" |
|
| "Нет возможности сформировать акт. Отсутствуют посылки не в акте" | Если в списке посылок передаваемых в "ImIds" все посылки уже в акте. |
| "Ваша учетная запись заблокирована" |
|
| 414 Request-URI Too Large. | Есть ограничение на 1024 символа, если метод был вызван через HTTP метод GET |