4.快递

4.2 国际快递订阅推送

1. 描述

• 推送说明 当调用了【国际快递订阅查询】接口且配置了回调接口后，在首次快递数据获取成功或者后续数据有变化后，我们会采用全量(所有字段)的方式调用回调接口，推送数据给客户
• 注意事项
  1. 请在收到推送请求后第一时间返回HTTP状态码STATUS=200,我方才认为本次推送成功。如果500ms之后没有收到200响应，会认定本次推送异常，并发起重试推送。重试次数3次，每次间隔2分钟
  2. 按单的维度推送，即每次只会推送一单(如一次批量订阅10单，会按10次推送)

2. 推送请求方式

• POST
• Content-Type :application/json

3.通用请求参数

参数名	必选	类型	说明
customerId	是	string	客户id
refreshTime	是	string	数据更新时间
dataType	是	Integer	数据类型 1-船司 2-港口 3-船计划 4-空运 6-快递
data	是	Object	数据

4. 业务请求参数

参数名	类型	说明
carrierCd	string	快递公司代码
carrier	string	快递公司名称
trackingNumber	string	快递单号
isCompleted	string	流程是否结束 Y-是 N-否
shipmentCountry	string	起运国
purposeCountry	string	目的国
refreshTime	string	数据更新时间
extraInfo	string	扩展信息
bookingStatusList	Array	状态信息
statusCd	string	状态代码
statusDescription	string	状态描述
statusTime	string	状态时间
statusPlace	string	状态地点
isEst	string	是否预计时间（Y=是，N=否）
status	Integer	节点状态(1.正常 2.异常)

5. 请求示例

{
    "success": true,
    "code": 200,
    "message": "请求成功",
    "data": [
        {
            "bookingStatusList": [
                {
                    "isEst": "N",
                    "statusTime": "2022-05-20 20:04:00.000",
                    "statusCd": null,                 
                    "statusDescription": "We've received your order details, but have not yet received your parcel",
                    "status": 1,
                    "trackingNumber": "15503717022450",
                    "statusPlace": "Sender"
                },
                {
                    "isEst": "N",
                    "statusTime": "2022-05-27 22:09:00.000",
                    "statusCd": "IMPORT PICK UP",                  
                    "statusDescription": "We have your parcel and it's on its way to our depot",
                    "status": 1,
                    "trackingNumber": "15503717022450",
                    "statusPlace": "DPD"
                },
                {
                    "isEst": "N",
                    "statusTime": "2022-05-28 02:18:00.000",
                    "statusCd": "IMPORT PICK UP",            
                    "statusDescription": "We have your parcel and it's on its way to our depot",
                    "status": 1,
                    "trackingNumber": "15503717022450",
                    "statusPlace": "DPD"
                },
                {
                    "isEst": "N",
                    "statusTime": "2022-05-28 04:46:00.000",
                    "statusCd": null,                
                    "statusDescription": "Your parcel is at our depot",
                    "status": 1,
                    "trackingNumber": "15503717022450",
                    "statusPlace": "DPD"
                },
                {
                    "isEst": "N",
                    "statusTime": "2022-05-28 04:46:00.000",
                    "statusCd": null,                  
                    "statusDescription": "Your parcel is at our depot",
                    "status": 1,
                    "trackingNumber": "15503717022450",
                    "statusPlace": "DPD"
                },
                {
                    "isEst": "N",
                    "statusTime": "2022-05-28 07:31:00.000",
                    "statusCd": null,                  
                    "statusDescription": "Your parcel will be with you today",
                    "status": 1,
                    "trackingNumber": "15503717022450",
                    "statusPlace": "DPD"
                },
                {
                    "isEst": "N",
                    "statusTime": "2022-05-28 12:44:00.000",
                    "statusCd": "SIGN",                   
                    "statusDescription": "Your parcel has been delivered and received by MORAN",
                    "status": 1,
                    "trackingNumber": "15503717022450",
                    "statusPlace": "DPD"
                }
            ],
            "carrier": "DPD (UK)",
            "createTime": "2022-12-08 17:45:09",
            "carrierCd": "DPD",
            "shipmentCountry": "United Kingdom",
            "purposeCountry": "",
            "refreshTime": "2022-12-08 17:45:09",
            "trackingNumber": "15503717022450",
					  "extraInfo": {},
            "isCompleted": "Y"
        }
    ]
}

最近更新时间: { "value": "2023-07-21", "effect": true }

• 1. 描述
• 2. 推送请求方式
• 3.通用请求参数
• 4. 业务请求参数
• 5. 请求示例