接口说明

此接口支持上传快递面单、装箱清单、以及其他包裹标签/文件

使用场景

快递面单：仅3PL三方面单出库时上传。为确保订单能够及时出库，请在下单后5分钟内补充推送面单文件

装箱清单：若您配置自定义装箱清单服务，需上传

其他包裹标签/文件：若你要求万邑通打印后，贴在包裹上或者放置在包裹内，并随货交给尾程服务商

以上文件请下单后立即上传，否则订单将无法及时出库

接口名称

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：上传装箱清单 otherPackageVas：其它包裹类增值 merchandiseLabelVas：贴商品标签 packageLabelVas：贴包裹标签
fileName	String	O	增值文件名称当增值服务编码为 OSF8V1294-贴商品标签时，需填写商品对应的商品标签文件名称
trackingNo	String	O	上传面单时，必填跟踪号
shippingNo	String	O	运单号上传装箱清单且订单存在多个运单时，需填写多条label数据
groupSeq	String	N	文件分组标识当fileType 是 otherPackageVas 时，这个值必填，且要跟下单增值属性的 groupSeq 一一对应

请求示例

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": "packlist"
      }]
  },
  "format": "json",
  "language": "ZH_CN",
  "platform": "sw",
  "sign": "00000000000000000000000000000000",
  "sign_method": "md5",
  "timestamp": "2020-11-04 14:24:56",
  "version": "1.0"
}

3.贴商品标签

{
        "action": "pis.orderLabel.uploadLabel",
        "app_key": "rebecca",
        "data": {
                "masterOrderNo": "WO0000000226",
                "thirdOrderNo": "",
                "labels": [
                        {
                                "orderNo": "WO0000000226",
                                "shippingNo": "WO0000000226A",
                                "trackingNo": "T100",
                                "format": "pdf",
                                "fileName":"merchdiseLabel_001",
                                "fileUrl": "此处填写商品标签对应的的文件地址",
                                "fileType": "merchandiseLabelVas"
                        }
                ]
        },
        "format": "json",
        "language": "ZH_CN",
        "platform": "sw",
        "sign": "00000000000000000000000000000000",
        "sign_method": "md5",
        "timestamp": "2020-11-04 14:24:56",
        "version": "1.0"
}

4.贴包裹标签

{
        "action": "pis.orderLabel.uploadLabel",
        "app_key": "rebecca",
        "data": {
                "masterOrderNo": "WO0000000226",
                "thirdOrderNo": "",
                "labels": [
                        {
                                "orderNo": "WO0000000226",
                                "shippingNo": "WO0000000226A",
                                "trackingNo": "T100",
                                "format": "pdf",
                                "fileUrl": "此处填写文件地址",
                                "fileType": "packageLabelVas"
                        }
                ]
        },
        "format": "json",
        "language": "ZH_CN",
        "platform": "sw",
        "sign": "00000000000000000000000000000000",
        "sign_method": "md5",
        "timestamp": "2020-11-04 14:24:56",
        "version": "1.0"
}

5.上传其他包裹标签

{
        "action": "pis.orderLabel.uploadLabel",
        "app_key": "rebecca",
        "data": {
                "masterOrderNo": "WO0000000226",
                "thirdOrderNo": "",
                "labels": [
                        {
                                "orderNo": "WO0000000226",
                                "shippingNo": "WO0000000226A",
                                "trackingNo": "T100",
                                "format": "pdf",
                                "labelFileContent": "此处填写PDF的Base64编码",
                                "fileType": "otherPackageVas",
                                "groupSeq": "OSF8V1549_1"
                        },
                        {
                                "orderNo": "WO0000000226",
                                "shippingNo": "WO0000000226A",
                                "trackingNo": "T100",
                                "format": "pdf",
                                "labelFileContent": "此处填写PDF的Base64编码",
                                "fileType": "otherPackageVas",
                                "groupSeq": "OSF8V1549_2"
                        }
                ]
        },
        "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": ""
}

关键词