对接swiftx发运

接口

http://dmsqa.xiyou56.com/v1/open-api/sendDispatchNotificationToSwiftX

method

POST

Header

参数	是否必填	说明
Content-Type	必填	application/json;charset=UTF-8
x-lt-openKeyId	必填	访问用户隐私数据时的唯一权限标识 openKeyId
x-lt-timestamp	必填	请求时间戳，格式为时间转换为毫秒的值，也就是从1970年1月1日起至今的时间转换为毫秒，如：1583398764000
x-lt-signature	必填	接口签名签名规则

请求示例

BODY

{
    "carrierCode": "SWIFTX",
    "warehouseCode": "WPLA13",
    "shippingMethod": "WP_GROUND_SW",
    "handoverDtos": [
        {
            "dockId": "GATE-01",
            "trackingNumber": "SWX887520000011279867",
            "platformOrderId": "NUM123456789120",
            "trailerNumber": "TRL-8899",
            "scanSource": 1,
            "handoverTime": "2025-11-04 10:30:00",
            "timeZone": "UTC+8",
            "handoverNum":"1111" ,
            "handoverAddress": {    
              "prefixCode": "LA16",  
              "regionCode": "US",  
              "stateProvince": "CA",  
              "city": "Rialto",  
              "district": "South Bay",  
              "streetAddress": "1979 Renaissance Pkwy",  
              "building": "Suite 205",  
              "postalCode": "92376"  
            }
        }
    ]
}

请求参数：

顶层参数:

参数	类型	是否必填	说明	示例值
carrierCode	string	是	承运商代码，固定值”SWIFTX”	SWIFTX
warehouseCode	string	是	仓库代码	WPLA13
shippingMethod	string	是	运输方式	WP_GROUND_SW
handoverDtos	array[object]	是	交接单信息数组	见handoverDtos参数说明

handoverDtos对象参数

参数	类型	是否必填	说明	示例值
dockId	string	是	交接码头/门号	GATE-01
trackingNumber	string	是	运单号/跟踪号	SWX887520000011279867
platformOrderId	string	是	平台订单号	NUM123456789120
trailerNumber	string	是	拖车/货车号	TRL-8899
scanSource	integer	是	扫描来源标识	1
handoverTime	string	是	交接时间，格式”YYYY-MM-DD HH:MM:SS”	2025-11-04 10:30:00
timeZone	string	是	时区	UTC+8
handoverNum	string	是	交接单号	1111
handoverAddress	object	是	交接地址信息	见handoverAddress参数说明

handoverAddress对象参数

参数	类型	是否必填	说明	示例值
prefixCode	string	是	地址前缀码	LA16
regionCode	string	是	地区代码	US
stateProvince	string	是	州/省	CA
city	string	是	城市	Rialto
district	string	是	区/县	South Bay
streetAddress	string	是	街道地址	1979 Renaissance Pkwy
building	string	是	楼栋/单元号	Suite 205
postalCode	string	是	邮政编码	92376

响应示例

参数	类型	说明
code	Integer	响应码
success	Boolean	是否成功
msg	String	响应说明
data	Array	返回数据

data说明

参数	类型	说明
packageNo	String	包裹编号
trackingNumber	String	跟踪号
labelUrl	String	面单下载地址
labelFormat	String	面单格式（如 pdf）

成功示例

{
  "code": 200,
  "success": true,
  "msg": "出库通知发送成功",
  "data": "",
  "error": ""
}

失败示例

{
  "code": 500,
  "success": false,
  "msg": "出库通知发送失败",
  "data": {
    "failedTrackingNumbers": [
      "SWX8875200000112798617"
    ],
    "message": "Processing failed, all records failed"
  },
  "error": "出库通知发送失败"
}

鉴权示例

{
    "code": 401,
    "success": false,
    "msg": "认证失败",
    "data": "",
    "error": "认证失败"
}

作者：陆飞创建时间：2025-12-19 14:37
最后编辑：陆飞更新时间：2026-03-03 10:08