Page tree
Skip to end of metadata
Go to start of metadata

Формирует Акт приёма-передачи посылок в Boxberry (и одновременно инициирует загрузку переданных заказов в ИС Boxberry).
Акт приема-передачи формируется как на одну посылку, так и на группу посылок.

Обязательно наличие параметра ImIds <строки, содержащей коды отслеживания заказов>.

Обратите внимание, что в параметре ImIds вы передаёте не ваши коды заказов, а трекинг-коды, которые вернул вам метод ParselCreate.
Если отправляется запрос на формирование Акта, содержащий несколько заказов, загруженных ранее (включённых в другие акты), в ответном сообщении с ошибкой вы получите коды отслеживания этих заказов.

Гарантированное количество заказов для включения в акт приема-передачи:

  • JSON - 2000 заказов
  • SOAP - 500 заказов

GET-запрос:
https://api.boxberry.ru/json.php?token=d6f33e419c16131e5325cbd84d5d6000&method=ParselSend&ImIds=AAP114630642,AAP114630687

Входящие параметры:

Параметр

Обязательный

Тип

Описание

Пример

tokenstringТокен для доступа к api-сервисамd6f33e419c16131e5325cbd84d5d6000
ImIdsstringТрекинг код отслеживания заказаAAP114630642,AAP114630687
shippingDate
stringПлановая дата отгрузки (ГГГГ-ММ-ДД)2021-03-08

Данные ответа:

Параметр

Тип

Описание

Пример

idstringНомер акта (штрих-код)

12942207

labelstringСсылка на печатную форму акта

http://api.boxberry.ru/parcel-files/act?upload_id=12942207&token=d6f33e419c16131e5325cbd84d5d6000

url_tmcstringСсылка на печатную форму акта ТМЦ (если подключена услуга
«Пост_Упаковка для ИМ брендированная (короб))»

http://api.boxberry.ru/parcel-files/act?upload_id=12942207&token=d6f33e419c16131e5325cbd84d5d6000&type_act=tmc

stickerstringСсылка на печатную форму этикеток

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" все посылки уже в акте.
"Ваша учетная запись заблокирована"
  • Доступ API-сервисам Boxberry ограничен.
  • Неверный API-token.
414 Request-URI Too Large.

Есть ограничение на 1024 символа, если метод был вызван через HTTP метод GET

"Параметр shippingDate не в формате 'ГГГГ-ММ-ДД'"
  • Формат даты YYYY-MM-DD
  • Месяц даты (значение в MM) - должно соответствовать принятой нумерации и не превышать "12".
  • День даты (значение в DD) не должен превышать максимально допустимое для указанного в MM месяца. 
"Параметр shippingDate должен быть больше или равен текущей дате"Плановая дата отгрузки должна быть больше или равна текущей дате
  • No labels