一票多件

接口

v1/open-api/createOrder

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
{
   "ref2": "audi0001-sku*[1]",
    "ref3": "aliexpress001",
    "referenceNo": "lf-test-251205-003",
    "remark": "",
    "scCode": "WP_GROUND",
    "insuranceFlag": 0,
    "ptCode": "Oversized",
    "realCustomers": "YL01",
    "signatureFlag": 0,
    "siteCode": "",
    "sizeUnit": "IN",
    "weightUnit": "LB",
    "asynLableFlag":"1 1-同步，2-异步。 默认同步， 下单效率低下",
    "packageTotal":2,
    "recipientAddress": {
        "oraCity": "Hollywood",
        "oraCompany": "flynnCompany",
        "oraCountryCode": "US",
        "oraDoorplate": "",
        "oraFirstname": "flynn",
        "oraLastname": "",
        "oraPhone": "13122223333",
        "oraPostcode": "90048",
        "oraState": "FL",
        "oraStreetAddress1": "1215 Polk St, Hollywood, FL 33019",
        "oraZipcodeZone":"90048"
    },
    "senderAddress": {
        "osaCity": "FONTANA",
        "osaCompany": "tim",
        "osaCountryCode": "US",
        "osaDoorplate": "",
        "osaFirstname": "test",
        "osaLastname": "",
        "osaPhone": "13255555555",
        "osaPostcode": "66661",
        "osaState": "LA",
        "osaStreetAddress1": "1215 Polk St, Hollywood, FL 33019",
        "osaZipcodeZone":"66661"
    },
    "packageDtls":[
        {
        "packageNumber":1, // 第一个包裹  多个包裹依次类推    
        "packageNo":"最长64位的编号 列入：00001",
        "ordersHeight": 39,
        "ordersLength": 39,
        "ordersWeight": 22.04,
        "ordersWidth": 39,
        "packageAmount": "11111.000001",
        "packageDescribe":"长度200 非必填"
        },
        {
        "packageNumber":2,// 第二个包裹 多个包裹依次类推        
        "packageNo":"00002",
        "ordersHeight": 39,
        "ordersLength": 39,
        "ordersWeight": 22.04,
        "ordersWidth": 39,
        "packageAmount": "999999.999999",
        "packageDescribe":"My package is worth 999999.999999"
        }
    ],
    "totalDeclaredValue":"1011111"
}

请求参数：

  • 顶层参数:
参数 类型 是否必填 说明
ref2 String 否 参考号 2
ref3 String 否 参考号 3
referenceNo String 是 客户唯一参考号，不可重复
remark String 否 备注
scCode String 是 服务渠道编码
insuranceFlag Integer 否 是否购买保险（0-否，1-是）
ptCode String 否 产品类型
realCustomers String 否 实际客户编码
signatureFlag Integer 否 是否需要签名（0-否，1-是）
siteCode String 否 站点编码
sizeUnit String 是 尺寸单位（如 IN）
weightUnit String 是 重量单位（如 LB）
asynLableFlag String 否 标签生成方式：1-同步，2-异步
packageTotal Integer 是 包裹总件数（packageDtls的汇总数量）
totalDeclaredValue BigDecimal 否 总申报价值（packageDtls明细packageAmount合计，总申报价值需与合计一致）
  • recipientAddress（收件人地址）
参数 类型 是否必填 说明
oraCountryCode String 是 国家编码
oraState String 是 州/省
oraCity String 是 城市
oraPostcode String 是 邮编
oraStreetAddress1 String 是 地址
oraDoorplate String 否 门牌号
oraCompany String 否 公司名称
oraFirstname String 是 名
oraLastname String 否 姓
oraPhone String 是 联系电话
oraZipcodeZone String 否 邮编分区
  • senderAddress（寄件人地址）
参数 类型 是否必填 说明
osaCountryCode String 是 国家编码
osaState String 是 州/省
osaCity String 是 城市
osaPostcode String 是 邮编
osaStreetAddress1 String 是 地址
osaDoorplate String 否 门牌号
osaCompany String 否 公司名称
osaFirstname String 是 名
osaLastname String 否 姓
osaPhone String 是 联系电话
osaZipcodeZone String 否 邮编分区
  • packageDtls（包裹明细）
参数 类型 是否必填 说明
packageNo String 是 包裹编号（最长 64 位）
ordersLength Number 是 长
ordersWidth Number 是 宽
ordersHeight Number 是 高
ordersWeight Number 是 重量
packageAmount BigDecimal 否 包裹申报价值
packageDescribe String 否 包裹描述
packageNumber Number 是 包裹序号（标识当前包裹是第几件）

响应示例

参数 类型 说明
code Integer 响应码
success Boolean 是否成功
msg String 响应说明
data Array 返回数据
  • data说明
参数 类型 说明
packageNo String 包裹编号
trackingNumber String 跟踪号
labelFile String 面单下载地址
labelFormat String 面单格式（如 pdf）

成功示例

{
    "msg": "创建一票多件订单成功",
    "code": 200,
    "data": {
        "parentTrackingNumber": "WP2601210000133",
        "packageTotal": 4,
        "packages": [
            {
                "labelFile": "http://dmsqa.xiyou56.com/api/wpglb-dms-orders/label/getLabel?encrypt=%2BSfwWSnm5FsY23Icljjn53WsH8Jqtq7uHTAIvNVGd3X7X6BQhhm36%2B0nOGDaQXuK",
                "labelFormat": "pdf",
                "trackingNumber": "WP2601210000133",
                "packageNo": "1_1",
                "packageNumber": 1
            },
            {
                "labelFile": "http://dmsqa.xiyou56.com/api/wpglb-dms-orders/label/getLabel?encrypt=%2BSfwWSnm5FsY23Icljjn5z%2Fv4xVsFtDTRfvxZqwrBxIwTao%2FTD38RH6BMENrjmuW",
                "labelFormat": "pdf",
                "trackingNumber": "WP2601210000144",
                "packageNo": "2_2",
                "packageNumber": 2
            },
            {
                "labelFile": "http://dmsqa.xiyou56.com/api/wpglb-dms-orders/label/getLabel?encrypt=%2BSfwWSnm5FsY23Icljjn5xVT9e%2FqDJmK2GC2zoSHh1WPueB8efNccRSBauFKhCxh",
                "labelFormat": "pdf",
                "trackingNumber": "WP2601210000157",
                "packageNo": "2_3",
                "packageNumber": 3
            },
            {
                "labelFile": "http://dmsqa.xiyou56.com/api/wpglb-dms-orders/label/getLabel?encrypt=%2BSfwWSnm5FsY23Icljjn55%2B%2BBkhx3ObMQsswb%2BDhZAsrQlZX5UAku3GM9Ut3Q0TF",
                "labelFormat": "pdf",
                "trackingNumber": "WP2601210000163",
                "packageNo": "2_4",
                "packageNumber": 4
            }
        ]
    },
    "success": true,
    "error": ""
}

失败示例

{
    "code": 500,
    "success": false,
    "msg": "参考号[lf-test-251205-004]已存在",
    "data": {},
    "error": ""
}

鉴权示例

{
    "code": 401,
    "success": false,
    "msg": "认证失败",
    "data": "",
    "error": "认证失败"
}
作者：陆飞  创建时间：2025-12-18 14:16
最后编辑：高美燕  更新时间：2026-03-03 10:08