Post2Go для бизнеса

Подключите наше отслеживание посылок к своему сайту: увеличьте лояльность пользователей, уменьшите количество возвратов и улучшите информированность о прохождении посылок.

Подробнее Тарифы Оставить заявку

Получение результатов отслеживания

Метод getTrackingInfo

Возвращает результаты отслеживания указанного трекинг-номера и службы доставки.

Параметры

  • tracking_number - трекинг-номер;
  • courier_slug - уникальный идентификатор службы доставки.

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

{
    "jsonrpc": "2.0",
    "method": "getTrackingInfo",
    "params": {
        "tracking_number": "1234567890", 
        "courier_slug": "russian-post"
    },
    "id": 1
}

Формат ответа

Объект result содержит следующий набор полей:

  • tracking_number - отслеживаемый трекинг-номер;
  • courier_slug - уникальный идентификатор службы доставки, которая отправила посылку;
  • is_active - флаг указывающий отслеживается ли трекинг-номер в данный момент или процесс отслеживания остановлен;
  • is_delivered - флаг, указывающий была ли посылка доставлена или все еще находится в пути;
  • last_check - дата последний проверки трекинг-номера сервисом Post2Go;
  • checkpoints - массив объектов контрольных точек, в которых находилась посылка на протяжении всего пути;
  • title - название посылки (может быть присвоение при добавлении и изменении трека).

Объект контрольной точки:

  • time - время прохождения посылки через контрольную точку;
  • location - оригинальное местоположение;
  • location_ru - перевод местоположения;
  • zip_code - почтовый индекс места положения контрольной точки;
  • country_code - код страны места положения контрольной точки;
  • courier_slug - уникальный код службы осуществлявшей доставку на момент пребывания посылки в контрольной точке;
  • message - сообщение, описывающее статус посылки;
  • status - статус посылки (Описание статусов). Возможные состояния:
    • expired,
    • failed-attempt,
    • info-received,
    • in-transit,
    • out-for-delivery,
    • pending,
    • accepted,
    • delivered,
    • exception

Пример ответа

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "tracking_number": "1234567890",
        "courier_slug": "usps",
        "is_active": false,
        "is_delivered": true,
        "last_check": "2014-07-06T10:38:46.000Z",
        "title": "Посылочка",
        "checkpoints": [
            {
                "time": "2014-03-17T20:00:00.000Z",
                "location": null,
                "location_ru": null,
                "zip_code": null,
                "country_code": "USA",
                "courier_slug": "usps",
                "message": "Electronic Shipping Info Received",
                "status": "accepted"
            },
            {
                "time": "2014-03-18T12:07:00.000Z",
                "location": "PHILADELPHIA, PA 19176",
                "location_ru": "Филадельфия, 19176",
                "zip_code": null,
                "country_code": "USA",
                "courier_slug": "usps",
                "message": "В пути",
                "status": "in-transit"
            },
            {...},
            {...},
            {...},
            {
                "time": "2014-03-25T11:24:00.000Z",
                "location": "CANADA",
                "location_ru": "Канада",
                "zip_code": null,
                "country_code": "USA",
                "courier_slug": "usps",
                "message": "Посылка доставлена",
                "status": "delivered"
            }
        ]
    }
}

Ошибки

Информация по указанному трекинг-номеру не найдена

{
    "jsonrpc": "2.0",
    "error":{
        "code": 404,
        "message": "Tracking not found"
    },
    "id": null
}

Попытка получить информацию о треке до постановки на отслеживание:

{
    "jsonrpc": "2.0",
    "error":{
        "code": 403,
        "message": "Access denied. You should addTracking to access this operation."
    },
    "id": null
}