版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

...

字段名

是否必填项

类型

描述

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

文件中字段的描述

字段名

是否必填项

描述

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

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

这边查询的渠道跟接口文档“35.提供给CW的查询服务接口

”传递的值一样(注:对应接口文档35中的type写死了是1)如果填的不是是或否,则报错(5行,字段:是否退税,只能填写

”传递的值一样(注:对应接口文档35中的type本接口中写死了是1)

是否退税

如果为空,会报错(5行是否退税字段不能为空)

如果填的不是是或否,则报错(第9行,字段:是否商检*,只能填写

可选值:是、否

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

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

是否带电

可选值:是、否

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

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

是否带磁

可选值:是、否

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

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

报关类型

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

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

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

是否商检

如果为空,会报错(9行是否商检*字段不能为空)

可选值:是、否

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

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

是否投保

可选值:是、否

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

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

投保类型

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

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

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

投保金额

只能填数字

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

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

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

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

如果为空,会报错

如果为空,会记录解析错误(

9行邮编

第9行邮编*字段不能为空),最后一起返回

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

发货人名称

传了也没用,没做处理

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

然后countryCode会设置成CN,city会设置成无;

然后countryCode会设置成CN,city会设置成无;

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

...

这里传了就会覆盖掉之前Phone设置的默认值“  ”
地址这里传了就会覆盖掉之前Address1设置的默认值“  ”

文件中下面的

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

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

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


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