接口说明

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

使用场景

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

接口名称

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.上传面单

{
  "action": "pis.orderLabel.uploadLabel",
  "app_key": "rebecca",
  "data": {
    "masterOrderNo": "WO0000000226",
    "thirdOrderNo": "",
    "labels": [
      {
        "orderNo": "WO0000000226",
        "trackingNo": "T100",
        "format": "pdf",
        "labelFileContent":"此处填写PDF的Base64编码",
        "fileType": "shiplabel"
      }]
  },
  "format": "json",
  "language": "ZH_CN",
  "platform": "sw",
  "sign": "00000000000000000000000000000000",
  "sign_method": "md5",
  "timestamp": "2020-11-04 14:24:56",
  "version": "1.0"
}

2.上传装箱清单

{
  "action": "pis.orderLabel.uploadLabel",
  "app_key": "rebecca",
  "data": {
    "masterOrderNo": "WO0000000226",
    "thirdOrderNo": "",
    "labels": [
      {
        "orderNo": "WO0000000226",
        "trackingNo": "T100",
        "format": "pdf",
        "labelFileContent":"此处填写PDF的Base64编码",
         "fileUrl":"此处填写文件URL"，
        "fileType": "shiplabel"
      }]
  },
  "format": "json",
  "language": "ZH_CN",
  "platform": "sw",
  "sign": "00000000000000000000000000000000",
  "sign_method": "md5",
  "timestamp": "2020-11-04 14:24:56",
  "version": "1.0"
}

返回出参

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

返回示例

{
    "code": "02010260001",
    "msg": "订单[WO0000000226]不存在，请检查后再上传",
    "data": ""
}

关键词