获取面单/小包箱唛
更新时间: 2025-06-05 17:45:52 访问次数:12418
接口说明
获取单个面单
接口名称
lma.shipment.print
请求说明
请求内容 | 说明 |
---|---|
URL | https://openapi.winit.com.cn/openapi/service |
接口测试 | https://sandboxopenapi.winit.com.cn/openapi/service |
验证方法 | Token,md5 |
格式 | json |
字符编码 | UTF-8 |
http请求方式 | http |
请求数限制 | 默认每分钟1000,1000有需要可申请加大。 |
请求入参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
winitOrderNo | String(60) | Y | winit 订单号 |
请求示例
{
"action": "lma.shipment.print",
"app_key": "rebecca",
"client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
"data": {
"winitOrderNo": "LMA010000000760CN"
},
"format": "json",
"language": "zh_CN",
"platform": "OWNERERP",
"sign": "DA9FD4EE1E1B9574D763AA485DD7AFDB",
"client_sign": "5B3D2848F972D4537D9F3CEEA1918EB0",
"sign_method": "md5",
"timestamp": "2016-07-10 23:04:52",
"version": "3.0"
}
返回出参
返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。
名称 | 类型 | 必传 | 说明 | 示例 |
---|---|---|---|---|
orderTrackingNo | String() | N | 订单级面单号 (1)当订单内只有一个包裹时,与包裹级运单号一致。 (2)当订单内有多个包裹时(一单多面单),如果供应商有返回主面单号,则为主运单号,否则为空。 注:专线换标场景请勿适用 |
|
orderLabel | String() | N | 订单级面单文件,Base64编码的PDF文件 (1)当订单内只有一个包裹时,与包裹级面单文件一致的。 (2)当订单内有多个包裹时(一单多面单),为所有包裹级面单合并后的文件。 注:专线换标场景请勿适用 |
|
labelList | Array | Y | 面单列表 | |
– packageNum | String() | Y | 包裹编号 | |
– trackingNo | String() | Y | 包裹运单号 | |
– label | String() | Y | 包裹级面单文件,Base64编码的PDF文件 | |
– barcode | String(32) | Y | 如果下单未入参则返回Winit生成的barcode条码 如果入参返回客户下单入参的barcode条码 |
|
– barcodeLabel | String() | Y | Base64编码的PDF文件 专线换标场景,请获取该文件贴到小包上。 实物小包上需贴此barcode,支持海外仓扫描收货 |
返回示例
{
"code": "0",
"msg": "操作成功",
"data": {
"orderTrackingNo": "1Z68223Y0315275652",
"orderLabel": "Base64编码的PDF",
"labelList": [
{
"trackingNo": "1Z68223Y0315275652",
"label": "Base64编码的PDF",
"formatType": "pdf",
"packageNum": "L190506001527-4"
}]}
}
关键词