ParcelTrack API

Отслеживание 

Менеджер ваших отслеживаний

URI Метод Описание
POST /trackings/post POST Создать элемент отслеживания
GET /trackings/{carrier_code}/{tracking_number} GET Получить результаты отслеживания для конкретного отправления
PUT /trackings/{carrier_code}/{tracking_number} PUT Обновить отслеживание
DELETE /trackings/{carrier_code}/{tracking_number} DELETE Удалить отслеживание
POST /trackings/batch POST Создать мульти-отслеживание
GET /trackings/get GET Список всех отслеживаний
POST /trackings/realtime POST Получить результаты отслеживания на настоящий момент для единичного отслеживания

Создать мульти-отслеживание

https://api.parceltrack.ru/v1/trackings/batch

Заголовок

  • Content-Type: application/json
    Api-Key: YOUR_API_KEY

  • Tips

    API отслеживания/почтовой службы/партии поддерживает до 40 номеров накладных за операцию.

Parameters

ParamDescription
tracking_numberTracking number
carrier_code Carrier code. Check Код службы доставки
destination_code (optional)Destination Carrier code.
title (optional)Title of the tracking
logistics_channel (optional)Logistics channel of the tracking
customer_name (optional)Customer name of the tracking.
customer_email (optional)Эл.почта покупателя для отправки уведомлений..
customer_phone (optional)Номер телефона для отправки СМС-оповещений..
order_id (optional)Поле для ввода идентификатора заказа..
order_create_time (optional)Order Create Time(eg:2017/8/27 16:51).
tracking_ship_date(optional)Shipping date in YYYYMMDD format. Required by some couriers, such as deutsch-post
tracking_postal_code(optional)The postal code of receiver's address. Required by some couriers, such as postnl-3s
tracking_account_number(optional)Account Number
specialNumberDestination(optional)Страна назначения груза для конкретного курьера. Требуется некоторыми курьерами, такими как postnl-3s
lang (optional)Возврат к типу языка (только при поддержке официального сайта курьера)..
auto_correct (optional)Auto correct params,you can set 1.
comment (optional)Поле для комментария.

Request Body

  • [
  {
      "tracking_number": "RP893531375SG",
      "carrier_code": "singapore-post",
      "logistics_channel": "4PX挂号小包",
      "customer_phone": "+110110",
      "destination_code": "cn",
      "title": "title 1",
      "customer_email": "[email protected]",
      "order_id": "213456",
      "comment": "备注",
      "order_create_time": "2017/8/27 16:51",
      "lang": "en"
  },
  {
      "tracking_number": "LK894734223CN",
      "carrier_code": "china-ems",
      "logistics_channel": "4PX挂号小包",
      "customer_phone": "+22222222",
      "destination_code": "cn",
      "title": "title 1",
      "customer_email": "[email protected]",
      "order_id": "213456",
      "comment": "备注",
      "order_create_time": "2017/8/27 16:51",
      "lang": "en"
  }
]

  • Response Body 201

    {
    "meta": {
        "code": 201,
        "type": "Created",
        "message": "The request was successful and a resource was created."
    },
    "data": {
        "submitted": 2,
        "added": 0,
        "trackings": [],
        "errors": [{
            "tracking_number": "RP893531375SG",
            "carrier_code": "singapore-post",
            "code": 4016,
            "message": "Tracking already exists."
        }, {
            "tracking_number": "LK894734223CN",
            "carrier_code": "china-ems",
            "code": 4016,
            "message": "Tracking already exists."
        }]
    }
}

  • Response Body 200

    {
    "meta": {
        "code": 200,
        "type": "Success",
        "message": "Success"
    },
    "data": {
        "submitted": 2,
        "added": 2,
        "trackings": [{
            "id": "ec6150c0b7557eb3131578640e04f798",
            "tracking_number": "RP893531375SG",
            "carrier_code": "singapore-post",
            "order_create_time": "2017\/8\/27 16:51",
            "status": "pending",
            "created_at": "2018-04-18T07:26:14+00:00",
            "customer_email": "[email protected]",
            "customer_name": null,
            "customer_phone": "+110110",
            "order_id": "213456",
            "comment": "备注",
            "title": "title 1"
            "logistics_channel": "4PX挂号小包"
        }, {
            "id": "bca8dab58bac35e0658f93c09e8092ac",
            "tracking_number": "LK894734223CN",
            "carrier_code": "china-ems",
            "order_create_time": "2017\/8\/27 16:51",
            "status": "pending",
            "created_at": "2018-04-18T07:26:14+00:00",
            "customer_email": "[email protected]",
            "customer_name": null,
            "customer_phone": "+22222222",
            "order_id": "213456",
            "comment": "备注",
            "title": "title 1"
            "logistics_channel": "4PX挂号小包"
        }]
    }
}