eTowerOne Developers
页面树结构
转至元数据结尾
转至元数据起始

接口描述

提供给CW的导入模板解析接口

HTTP VerbURL
POST/api/supplier-service/v2/b2b/order/uploadListV4

Example:

POST /api/supplier-service/v2/b2b/order/uploadListV4 HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: http://cfs-qa.etowertech.com/
X-WallTech-Date: Thu, 06 Aug 2020 06:44:25 GMT
Authorization: WallTech testLvs2jdug2qIoRsJyuxs:F714XG5EBjslUUdx5xJrTCVb9Xs=

请求样例

请求文件模版

下单模版 (5).xlsx

请求字段描述


字段名

是否必填项

类型

描述

file
是
MultipartFile
需要解析的文件
shipper
是Integer
发件人
channel
按描述来传
Integer
渠道id，首先先获取这里的，如果这里不传会去看解析的文件，看里面有没有，没有则报错
openCommodityWarehouse
否
Boolean
是否开启商品库，如果不传，系统会默认设置为false

文件中字段的描述

字段名

是否必填项

描述

---------订单信息---------

客户订单号是
客户订单号，并不是系统订单号
如果为空，会记录解析错误(第3行客户订单号字段不能为空)，最后一起返回
产品渠道是

这边查询的渠道跟接口文档“35.提供给CW的查询服务接口”传递的值一样（注：对应接口文档35中的type本接口中写死了是1）

是否退税是

可选值：是、否

如果为空，会记录解析错误(第5行是否退税字段不能为空)，最后一起返回

如果填的不是是或否，会记录解析错误(第5行，字段：是否退税，只能填写'是'或者'否')，最后一起返回

是否带电是

可选值：是、否

如果为空，会记录解析错误(第6行是否带电字段不能为空)，最后一起返回

如果填的不是是或否，会记录解析错误(第6行，字段：是否带电，只能填写'Y'或者'N')，最后一起返回

是否带磁是

可选值：是、否

如果为空，会记录解析错误(第7行是否带磁字段不能为空)，最后一起返回

如果填的不是是或否，会记录解析错误(第7行，字段：是否带磁，只能填写'Y'或者'N')，最后一起返回

报关类型是

可选值：'买单报关','单独报关'或者'合并报关'

如果为空，会记录解析错误(第8行报关类型字段不能为空)，最后一起返回

如果填的不是上诉可选值，会记录解析错误(第8行，字段：报关类型，只能填写'买单报关','单独报关'或者'合并报关')，最后一起返回

是否商检是

可选值：是、否

如果为空，会记录解析错误(第9行是否商检字段不能为空)，最后一起返回

如果填的不是是或否，会记录解析错误(第9行，字段：是否商检，只能填写'Y'或者'N')，最后一起返回

是否投保是

可选值：是、否

如果为空，会记录解析错误(第10行是否投保字段不能为空)，最后一起返回

如果填的不是是或否，会记录解析错误(第10行，字段：是否投保，只能填写'Y'或者'N')，最后一起返回

投保类型是

可选值：无、保签收、保上架、保到港

如果为空，会记录解析错误(第11行投保类型字段不能为空)，最后一起返回

如果填的不是上诉可选值，会记录解析错误(第11行，字段：报关类型，填写的值不支持)，最后一起返回

投保金额否

只能填数字

如果有非数字，则会记录解析错误(第12行，字段：投保金额，只能填写数字)，最后一起返回

--------收件人信息--------

FBA仓库代码是如果为空，会记录解析错误(第3行FBA仓库代码字段不能为空)，最后一起返回
目的国是如果为空，会记录解析错误(第4行目的国字段不能为空)，最后一起返回
收货人公司否
收货人名称否
收货人电话否
EMAIL否
邮编是

如果长度超过32，会记录解析错误（字段（邮编）长度不能超过32），最后一起返回

如果为空，会记录解析错误(第9行邮编*字段不能为空)，最后一起返回

地址1否
地址2否
城市否
省/州否
--------发货人信息--------

发货人名称否

传了也没用，没做处理

但是这里会自动设置揽件类型为自送到仓，

然后countryCode会设置成CN，city会设置成无；

Phone、Email、Province、Address1、Address2、Address3、Name、ZipCode、District这些字段会设置成"  "
联系人否这里传了就会覆盖掉之前Name设置的默认值“  ”
联系方式否这里传了就会覆盖掉之前Phone设置的默认值“  ”
地址否这里传了就会覆盖掉之前Address1设置的默认值“  ”

文件中下面的

"箱序号*", "FBA SHIPMENT ID*", "Reference NO*", "商品中文名 *", "商品英文名*", "申报单价\n（USD）*", "总毛重*", "箱数*\n(CTNS)", "单箱数量*（pcs/set）",
"单箱实重*\n(kg)", "长*\n(cm)", "宽*\n(cm)", "高*\n(cm)", "材质(英文)*\n(Material)", "用途(英文)*\n(Usage)", "品牌*", "型号*", "海关编码*\n（HS CODE）",
"产品图片*", "销售链接\n(非必填)"

这些字段如果都没填，就会直接跳过

如果填了，则会校验必填项是否填了，如果没填会记录解析错误（第{0}行，字段：{1}，不能为空）最后一起返回


返回内容如下

{
    "code": "0005",
    "data": "",
    "errors": [
        {
            "code": "710103",
            "message": "找不到的产品服务:"
        },
        {
            "code": "710001",
            "message": "第16行:字段（Reference NO*），不能为空"
        }
    ],
    "message": "参数异常",
    "messageId": "",
    "success": false,
    "warnList": ""
}











  • 无标签