API
出库上传附件
更新时间: 2024-03-21 20:05:51 访问次数:2228

接口说明

此接口支持上传快递面单及装箱清单

使用场景

快递面单:仅自提出库时上传;请下单后立即上传,否则订单将无法及时出库
装箱清单:若您配置自定义装箱清单服务,需上传

接口名称

pis.orderLabel.uploadLabel

请求说明

URL https://openapi.winit.com.cn/openapi/service
接口测试 https://sandboxopenapi.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。

请求入参

名称 类型 必填 说明 示例
masterOrderNo String Y 海外仓出库单号
thirdOrderNo String N 卖家订单号(客户自定义)
labels Array Y 上传附件列表
orderNo String Y 出库单号
format String Y 只允许填写为pdf
labelFileContent String O PDF文件转成64Base流
注:labelFileContent和fileUrl二选一填写即可
fileUrl String O PDF文件url
注:labelFileContent和fileUrl二选一填写即可,同时填写时以url为准
fileType String Y 枚举值包括:
shiplabel:上传面单
packlist:上传装箱清单
trackingNo String O 上传面单时,必填跟踪号
shippingNo String O 运单号
上传装箱清单且订单存在多个运单时,需填写多条label数据

请求示例

1.上传面单

  1. {
  2. "action": "pis.orderLabel.uploadLabel",
  3. "app_key": "rebecca",
  4. "data": {
  5. "masterOrderNo": "WO0000000226",
  6. "thirdOrderNo": "",
  7. "labels": [
  8. {
  9. "orderNo": "WO0000000226",
  10. "trackingNo": "T100",
  11. "format": "pdf",
  12. "labelFileContent":"此处填写PDF的Base64编码",
  13. "fileType": "shiplabel"
  14. }]
  15. },
  16. "format": "json",
  17. "language": "ZH_CN",
  18. "platform": "sw",
  19. "sign": "00000000000000000000000000000000",
  20. "sign_method": "md5",
  21. "timestamp": "2020-11-04 14:24:56",
  22. "version": "1.0"
  23. }

2.上传装箱清单

  1. {
  2. "action": "pis.orderLabel.uploadLabel",
  3. "app_key": "rebecca",
  4. "data": {
  5. "masterOrderNo": "WO0000000226",
  6. "thirdOrderNo": "",
  7. "labels": [
  8. {
  9. "orderNo": "WO0000000226",
  10. "trackingNo": "T100",
  11. "format": "pdf",
  12. "labelFileContent":"此处填写PDF的Base64编码",
  13. "fileUrl":"此处填写文件URL"
  14. "fileType": "shiplabel"
  15. }]
  16. },
  17. "format": "json",
  18. "language": "ZH_CN",
  19. "platform": "sw",
  20. "sign": "00000000000000000000000000000000",
  21. "sign_method": "md5",
  22. "timestamp": "2020-11-04 14:24:56",
  23. "version": "1.0"
  24. }

返回出参

返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。

返回示例

  1. {
  2. "code": "02010260001",
  3. "msg": "订单[WO0000000226]不存在,请检查后再上传",
  4. "data": ""
  5. }
关键词