Разработчикам


Трекинг

Для отслеживания грузов можно использовать метод tracking:

https://api.ship2go.ru/tracking?{параметры}
Входные параметры для метода tracking:
Параметр Режим Описание
code * обязательный Трекинг номер или код груза из транспортной компании.
company_id необязательный, по умолчанию все компании Если параметр не указан, то пытаемся определить транспортную компанию по трекинг номеру. Если указан идентификатор компании, то будет произведена попытка получить данные о грузе у этой компании.
polling необязательный, по умолчанию off Включить режим полинга: on - включить, off - выключить.
data_id только для получения данных в режиме полинга Идентификатор для получения данных в режиме полинга. Для получения данных достаточно этого параметра, дублировать параметры, которые были переданных при первом запросе необязательно - они будут проигнорированны.

{
    "status": {
        "message": "OK",
        "code": 200
    },
    "result": [
        {
            "status": 4,                           // Код статуса груза ship2go сервиса
            "original_status": "Выдан",            // Код статуса груза от транспортной компании
            "original_status_description": "Выдан",// Текстовое описание статуса груза от
            "status_description": "Посылка вручена получателю", // Текстовое описание статуса от ship2go
            "company": {
                "name": "ПЭК",
                "id": 2
            }
        },
        //... возможно несколько результатов, если company_id не указан.
    ]
}
В таблице представленны возвожные статусы от сервиса ship2go.
Код статуса груза (поле status) Описание статуса груза (поле status_description)
-1 Ошибка получения статуса
0 Зарегистрированно в ТК
1 Посылка получена ТК
2 Обработка/сортировка/в пути
3 Посылка прибыла в город назначения.
4 Посылка вручена получателю
100 Возврат
Если режим полинга был включен, мы получим следующий результат:
// Запрос:    https://api.ship2go.ru/tracking?polling=on&company_id=2&code=ННСЦВХО-4/1406

{
    "status": {
        "message": "OK",
        "code": 200
    },
    "data_id": "229ece583543927ed0c60761a13fd32c"
}

//Запрос:    https://api.ship2go.ru/tracking?data_id=229ece583543927ed0c60761a13fd32c

{
    "status": {
        "message": "OK",
        "code": 200
    },
    "polling_status": "finish",
    "result": [
        {
            "status": 4,
            "original_status": "Выдан",
            "original_status_description": "Выдан",
            "status_description": "Посылка вручена получателю",
            "company": {
                "name": "ПЭК",
                "id": 2
            }
        }
    ]
}
Протестировать данный метод можно на вкладке Демонстрация трекинга