Post2Go для бизнеса

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

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

Получение последнего местоположения

Метод getLastCheckpoint

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

Параметры

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

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

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

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

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

  • tracking_number - отслеживаемый трекинг-номер;
  • courier_slug - уникальный идентификатор службы доставки, которая отправила посылку;
  • is_active - флаг указывающий отслеживается ли трекинг-номер в данный момент или процесс отслеживания остановлен;
  • is_delivered - флаг, указывающий была ли посылка доставлена или все еще находится в пути;
  • last_check - дата последний проверки трекинг-номера сервисом Post2Go;
  • checkpoint - объект контрольной точки;
  • 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": "Посылочка",
        "checkpoint": {
            "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": "in-transit"
        }
    }
}

Ошибки

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

{
    "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
}