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

Метод 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
}