外部承运商使用西邮号段和轨迹对接

取单号和上传轨迹接口文档

接口概述一
    本接口用于生成西邮物流订单号，支持国际大件货物运输场景，需通过签名验证身份。
请求信息
URL: http://dmsqa.xiyou56.com/v1/open-api/createExternalWaybill
Method: POST
Content-Type: application/json
请求头参数
参数名    是否必填    说明    示例
x-lt-openKeyId    是    开发者秘钥    ae278ab28e10e781d718aa119d6e4b16
x-lt-signature    是    开发者签名    30f6fYzk3YTBiOGM1Mjg2ZjMyOWJkM2Rj...
x-lt-timestamp    是    时间戳    

openKeyId:ae278ab28e10e781d718aa119d6e4b16
秘钥：808f09633f3c5af8caa4ba30733c8053
签名算法

请求体参数

{

    "referenceNo": "YB-WF-25082100027_8361195",
    "carrierCode":"SWIFTX"
}
响应参数
{
    "code": 200,
    "success": true,
    "msg": "成功",
    "data": {
        "referenceNo": "YB-WF-25082100027_8361195",
        "trackingNumber": "WP1000000005807",
    },
    "error": ""
}

接口概述二

本接口用提取友商承运订单的标准轨迹信息
请求信息
单据编号：
希望的响应参数
{
    "code": 200,
    "success": true,
    "msg": "轨迹查询成功",
    "data": {
        "trackingNumber": "WP2509120230029",
        "estimatedDeliveryDate": "2025-09-14 01:15:11",
        "createTime": "2025-09-12 16:15:11",
        "localCreateTime": "2025-09-12 01:15:11",
        "trackingRecordList": [
            {
                "recordId": 3266692,
                "ordersId": 256207,
                "trackType": 2,
                "trackingNumber": "WP2509120230029",
                "nodeCode": "DD",
                "trackTime": "2025-09-14 09:46:01",
                "trackZone": "America/Los_Angeles",
                "trackAddress": "Oakland",
                "estimatedDeliveryDate": "",
                "remarks": "Delivered",
                "nodeName": "DELIVERED",
                "descriptionCn": "已送达",
                "descriptionEn": "Delivered",
                "eventStatus": "D1",
                "eventReason": "NS",
                "oraState": "CA",
                "oraCity": "Hayward",
                "oraPostcode": "94545",
                "oraStreetAddress1": "27751 TREAT LN",
                "oraStreetAddress2": ""
            },
            {
                "recordId": 3261818,
                "ordersId": 256207,
                "trackType": 2,
                "trackingNumber": "WP2509120230029",
                "nodeCode": "OD",
                "trackTime": "2025-09-14 07:15:09",
                "trackZone": "America/Los_Angeles",
                "trackAddress": "Oakland",
                "estimatedDeliveryDate": "",
                "remarks": "Out for delivery",
                "nodeName": "OUT FOR DELIVERY",
                "descriptionCn": "派送中",
                "descriptionEn": "Out for Delivery",
                "eventStatus": "OD",
                "eventReason": "NS",
                "oraState": "CA",
                "oraCity": "Hayward",
                "oraPostcode": "94545",
                "oraStreetAddress1": "27751 TREAT LN",
                "oraStreetAddress2": ""
            },
            {
                "recordId": 3261817,
                "ordersId": 256207,
                "trackType": 2,
                "trackingNumber": "WP2509120230029",
                "nodeCode": "AP",
                "trackTime": "2025-09-14 03:15:09",
                "trackZone": "America/Los_Angeles",
                "trackAddress": "Oakland",
                "estimatedDeliveryDate": "",
                "remarks": "Arrived at Final Destination and Is Being Processed",
                "nodeName": "ARRIVED AT WP LOCATION",
                "descriptionCn": "到达配送点",
                "descriptionEn": "Arrived at WP Location",
                "eventStatus": "O1",
                "eventReason": "NS",
                "oraState": "CA",
                "oraCity": "Hayward",
                "oraPostcode": "94545",
                "oraStreetAddress1": "27751 TREAT LN",
                "oraStreetAddress2": ""
            },
            {
                "recordId": 3210343,
                "ordersId": 256207,
                "trackType": 2,
                "trackingNumber": "WP2509120230029",
                "nodeCode": "IT",
                "trackTime": "2025-09-12 19:36:56",
                "trackZone": "America/Los_Angeles",
                "trackAddress": "Oakland",
                "estimatedDeliveryDate": "",
                "remarks": "In Transit",
                "nodeName": "IN TRANSIT",
                "descriptionCn": "运输中",
                "descriptionEn": "In Transit",
                "eventStatus": "L1",
                "eventReason": "NS",
                "oraState": "CA",
                "oraCity": "Hayward",
                "oraPostcode": "94545",
                "oraStreetAddress1": "27751 TREAT LN",
                "oraStreetAddress2": ""
            },
            {
                "recordId": 3204322,
                "ordersId": 256207,
                "trackType": 2,
                "trackingNumber": "WP2509120230029",
                "nodeCode": "PU",
                "trackTime": "2025-09-12 16:13:54",
                "trackZone": "America/Los_Angeles",
                "trackAddress": "Bell Gardens",
                "estimatedDeliveryDate": "",
                "remarks": "\tShipment Picked Up by Carrier",
                "nodeName": "PICKED UP",
                "descriptionCn": "已取件",
                "descriptionEn": "Picked up",
                "eventStatus": "AF",
                "eventReason": "NS",
                "oraState": "CA",
                "oraCity": "Hayward",
                "oraPostcode": "94545",
                "oraStreetAddress1": "27751 TREAT LN",
                "oraStreetAddress2": ""
            },
            {
                "recordId": 3179430,
                "ordersId": 256207,
                "trackType": 2,
                "trackingNumber": "WP2509120230029",
                "nodeCode": "SI",
                "trackTime": "2025-09-12 01:15:12",
                "trackZone": "America/Los_Angeles",
                "trackAddress": "Bell Gardens",
                "estimatedDeliveryDate": "",
                "remarks": "Shipment Information sent to the Carrier",
                "nodeName": "SHIPMENT INFORMATION SENT TO PILOT",
                "descriptionCn": "快递信息发送",
                "descriptionEn": "Shipment Information Sent to Western Post",
                "eventStatus": "XB",
                "eventReason": "NS",
                "oraState": "CA",
                "oraCity": "Hayward",
                "oraPostcode": "94545",
                "oraStreetAddress1": "27751 TREAT LN",
                "oraStreetAddress2": ""
            }
        ]
    },
    "error": ""
}

接口概述三

节点信息