一票一件

接口

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": "",
    "ordersLength": 39,
    "ordersWidth": 39,
    "ordersHeight": 39,
    "ordersWeight": 22.04,
    "sizeUnit": "IN",
    "weightUnit": "LB",
    "declaredValue": "11111.000001",
    "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"
    }
}

请求参数：

  • 顶层参数:
参数 类型 是否必填 说明
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 否 站点编码
ordersLength BigDecimal 是 长
ordersWidth BigDecimal 是 宽
ordersHeight BigDecimal 是 高
ordersWeight BigDecimal 是 重量
sizeUnit String 是 尺寸单位（如 IN）
weightUnit String 是 重量单位（如 LB）
declaredValue BigDecimal 否 申报价值
  • 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 否 邮编分区

响应示例

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

成功示例

{
    "code": 200,
    "success": true,
    "msg": "创建订单成功",
    "data": {
        "labelFile": "http://dmsqa.xiyou56.com/api/wpglb-dms-orders/label/getLabel?encrypt=k7Gk1ROz2%2BKchy2oyy2vMAgRcFh%2FaRn1JIVOvIJuQZCrf3iRFr%2BFxh4%2BIKJWVRjv",
        "labelFormat": "pdf",
        "trackingNumber": "ZX10242450"
    },
    "error": ""
}

失败示例

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

鉴权示例

{
    "code": 401,
    "success": false,
    "msg": "认证失败",
    "data": "",
    "error": "认证失败"
}
作者：高美燕  创建时间：2026-02-25 13:33
最后编辑：高美燕  更新时间：2026-03-03 10:08