Позволяет получить расширенную информацию о статусах посылки, включая выданные и возвращенные товарные позиции при частичной выдаче, вес заказа, сумма принятых денежных средств с получателя и тип оплаты.
Внимание! Сервис доступен для заказов, находящихся в акте приема-передачи.
XXXXXX - код отслеживания заказа или номер заказа ИМ.
Рекомендуемая частота обновления данных: 1 раз в час.
GET-запрос: https://api.boxberry.ru/json.php?method=ListStatusesFull&token=d6f33e419c16131e5325cbd84d5d6000&ImId=XXXXXX
Входящие параметры:
Параметр | Обяз. | Тип | Описание | Пример |
|---|---|---|---|---|
| token | ● | string | Токен для доступа к api-сервисам | d6f33e419c16131e5325cbd84d5d6000 |
| ImId | ● | string | Трек-номер посылки | BBR13790618 |
Данные ответа:
Параметр | Тип | Описание | Пример | |
|---|---|---|---|---|
| statuses | Массив статусов | |||
| Date | string | Дата присвоения статуса в формате ДД-ММ-ГГГГ ЧЧ:ММ | 04.06.2019 10:35 | |
| Name | string | Наименование статуса | Выдано | |
| Comment | string | Комментарий | - | |
| PD | boolean | Признак частичной выдачи заказа (true / false) | true | |
| sum | string | До выдачи посылки - сумма к оплате с получателя; После выдачи посылки - сумма фактически принятых денежных средств. | 1900 | |
| PaymentMethod | string | Тип оплаты. Возможные значения: "Касса", "Банк", "Эквайринг" | Эквайринг | |
| Weight | float | Фактический вес заказа, кг | 4.7 | |
| products | массив товаров (присутствует при PD=true) | |||
| Name | string | Наименование товарной позиции | товар1 | |
| Give | integer | выданное количество единиц товарной позиции | 0 | |
| Return | integer | количество единиц товарной позиции на возврат | 2 | |
| Item_ID | string | артикул товарной позиции | 42412 | |
Список возможных статусов
Наименование статуса | Описание | Тип доставки |
|---|---|---|
| Статусы прямого потока | ||
| Загружен реестр ИМ | Заказ загружен в ИС Боксберри (по заказу выполнена процедура формирования акта – метод ParselSend)/ | ПВЗ, КД |
Принято к доставке | Груз промаркирован и принят на складе Boxberry. | ПВЗ, КД |
Передано на сортировку | Заказ готовится к отправке в город назначения. | ПВЗ, КД |
Отправлен на сортировочный терминал | В пути на терминал. | ПВЗ, КД |
Отправлено в город назначения | Груз фактически отправлен в город назначения. | ПВЗ, КД |
Передан на доставку до пункта выдачи | Отправлен в пункт выдачи. | ПВЗ |
Передано на курьерскую доставку | Заказ прибыл в город назначения, с получателем согласовано время доставки. Заказ передан курьеру. | КД |
Поступило в пункт выдачи | Заказ поступил в пункт выдачи. Готов к получению. | ПВЗ |
Выдано | Заказ выдан получателю. | ПВЗ, КД |
Статусы возвратного потока | ||
Возвращено с курьерской доставки | Заказ возвращен с курьерской доставки. | КД |
Готовится к возврату | Заказ готовится на возврат, но по факту находятся в пункте выдачи. | ПВЗ, КД |
Отправлено в пункт приема | Заказ отправлен на возврат. | ПВЗ, КД |
Возвращено в пункт приема | Заказ поступил на склад возвратов Боксберри. | ПВЗ, КД |
Возвращено в ИМ | Заказ отправлен в интернет-магазин. | ПВЗ, КД |