Присоединяйтесь к нам в социальных сетях

API отслеживания

В запросах обязательно указывается заголовок:

Accept: application/json

API для отслеживания посылок в реальном времени предоставляет пользователям доступ к актуальной информации о перемещении их отправлений. С помощью данного API вы можете получать данные о статусе посылки на всех этапах её доставки, от момента отправки до вручения.

GET https://cabinet-api.exline.kz/api/waybills/track?waybill_name=xxxxxxxxxx

Ответ сервера:

        
{
  "data": {
    "id": 11543,
    "name": "6389038113",
    "status": {
      "name": "В пути",
      "datetime": null,
      "recipient": null
    },
    "tracking": [
      {
        "id": 101747,
        "created_at": "2024-09-17T12:12:27.000000Z",
        "event": "registration_system",
        "event_ru": "Регистрация в системе",
        "description": null
      },
      {
        "id": 102801,
        "created_at": "2024-09-17T16:10:50.000000Z",
        "event": "sent_to",
        "event_ru": "Убыло из города Отправителя",
        "description": "Отправлено через Авиапересылка"
      },
      {
        "id": 123168,
        "created_at": "2024-09-23T03:40:21.000000Z",
        "event": "arrived_at",
        "event_ru": "Прибыл в город Получателя",
        "description": null
      },
      {
        "id": 130413,
        "created_at": "2024-09-24T04:25:41.000000Z",
        "event": "distributed_route",
        "event_ru": "Распределено на маршрут",
        "description": "1"
      }
    ],
    "sender": {
      "id": 325709,
      "name": "Ирина Юганова"
    },
    "origin_region": {
      "id": 4,
      "name": "Алматы"
    },
    "origin_address": {
      "id": 1807,
      "street": "Аксай 4",
      "home": "55/1",
      "floor": "Цокольный",
      "apartment": "Офис 130/1",
      "latitude": null,
      "longitude": null
    },
    "recipient": "Скасовский А",
    "destination_region": {
      "id": 20,
      "name": "Кокшетау"
    },
    "destination_address": {
      "id": 11194,
      "street": "мкр Бирлик Белес",
      "home": "17",
      "floor": null,
      "apartment": null,
      "latitude": null,
      "longitude": null
    },
    "deliveries": [],
    "order_id": 5305,
    "weight": 0.3,
    "parcels_count": 1,
    "total_price": "2570.00",
    "paid_amount": "3820.00",
    "payment_method": {
      "id": 3,
      "name": "Электронный платеж"
    },
    "note": null
  }
}
        
      

id(int) – Уникальный идентификатор накладной.

name (string) – Номер накладной.

status (object) – Текущий статус накладной:

  • name (string) – Название статуса (например, "В пути").
  • datetime (string|null) – Время обновления статуса (может быть null, если время неизвестно).
  • recipient (string|null) – Имя получателя на этапе получения (если применимо, может быть null).

tracking (array) – Массив событий отслеживания накладной:

  • id (int) – Уникальный идентификатор события.
  • created_at (string) – Дата и время события в формате ISO 8601.
  • event (string) – Код события на английском (например, "registration_system", "sent_to").
  • event_ru (string) – Описание события на русском (например, "Регистрация в системе", "Убыло из города Отправителя").
  • description (string|null) – Дополнительное описание события (может отсутствовать).

sender (object) – Информация об отправителе:

  • id (int) – Уникальный идентификатор отправителя.
  • name (string) – Имя отправителя.

origin_region (object) – Регион отправки накладной:

  • id (int) – Уникальный идентификатор региона.
  • name (string) – Название региона (например, "Алматы").

origin_address (object) - Адрес отправления:

  • id (int) – Уникальный идентификатор адреса.
  • street (string) – Название улицы.
  • home (string) – Номер дома.
  • floor (string|null) – Этаж (если указан).
  • apartment (string|null) – Квартира или офис (если указан).
  • latitude (string|null) – Широта (может быть null).
  • longitude (string|null) – Долгота (может быть null).

recipient (string) – Имя получателя.

destination_region (object) – Регион получения:

  • id (int) – Уникальный идентификатор региона.
  • name (string) – Название региона (например, "Кокшетау").

destination_address (object) – Адрес получения:

  • id (int) – Уникальный идентификатор адреса.
  • street (string) – Название улицы.
  • home (string) – Номер дома.
  • floor (string|null) – Этаж (если указан).
  • apartment (string|null) – Квартира или офис (если указан).
  • latitude (string|null) – Широта (может быть null).
  • longitude (string|null) – Долгота (может быть null).

deliveries (array) – Информация о доставках ( массив может быть пустым).

order_id (int) – Уникальный идентификатор заказа, с которым связана посылка.

weight (float) – Вес посылки в килограммах.

parcels_count (int) – Количество мест в посылке.

total_price (string) – Общая стоимость доставки в KZT (например, "2570.00").

paid_amount (string) – Оплаченная сумма в KZT (например, "3820.00").

payment_method (object) – Метод оплаты:

  • id (int) – Уникальный идентификатор метода оплаты.
  • name (string) – Название метода оплаты (например, "Электронный платеж").

note (string|null) – Примечание к посылке (может отсутствовать).

Описание событий отслеживания посылки для документации:

  1. registration_system – "Регистрация в системе":
    • Посылка была зарегистрирована в системе, что означает, что она принята на обработку и готова к дальнейшему перемещению.
  2. successful_delivery – "Доставлено Получателю":
    • Посылка была успешно доставлена получателю. Этот статус указывает на завершение процесса доставки.
  3. sent_to – "Убыло из города Отправителя":
    • Посылка покинула город отправителя и отправлена в следующий пункт назначения, согласно маршруту.
  4. distributed_route – "Распределено на маршрут":
    • Посылка была распределена по маршруту для дальнейшей доставки. Этот этап обычно наступает после прибытия в транзитный или конечный пункт.
  5. unsuccessful_delivery – "Неудачная попытка доставки":
    • Попытка доставки посылки не удалась. Это может происходить по разным причинам, таким как отсутствие получателя на месте или неправильный адрес.