推送失败案例解析
一、推送失败案例概览
| 报错信息（点击跳转对应案例详解） | 相关接口文档 | 原因 | 解决方案 |
|---|---|---|---|
渠道：【...】下地址类型【...】所包含地址不支持【...】 | 创建订单 | 服务渠道配置了仅限部分地址可下单，提交的地址不属于可下单的地址 | 1. 核对提交的仓库代码fbaCode参数和邮编postCode参数是否准确；2. 核对该地址是否是该渠道的实际可下单仓库，通过接口获取渠道可用地址可以查询渠道配置了限定哪些仓库才可下单； 3. 联系本公司的运营核对渠道可用地址的配置是否存在遗漏 |
客户单号：【...】已被使用 | 创建订单 | 本系统中已存在该客户单号userNo的订单，为了保证客户单号在本公司系统的唯一性，不支持同一单号的重复下单 | 1. 核对该订单是否已经成功推送至本公司，如果是，请不要重复推送； 2. 核对该单号是否已经被其它本公司的客户使用过，如果是，请修改单号再重新推送 |
502 Bad Gateway | 系统正在维护升级 | 等待本系统维护升级结束后再推送 | |
packages=箱数/件数必须大于0 | 创建订单 清单发票信息/批量新增 | 清单发票信息参数中的箱数/件数packages必需大于0 | 调整参数parseItemList下的packages参数 |
操作过于频繁，请稍后再试！ | 本系统有api接口请求频率限制，每两次请求之间至少间隔2秒 | 请自行设置接口请求频率限制，保证每次请求接口时，距离上次请求至少有2秒的间隔 | |
地址信息不存在！ | 创建订单 | 推送的亚马逊仓库代码fbaCode或邮编postCode，和我们系统中的亚马逊仓库地址信息不一致 | 核对提供地址信息中的亚马逊仓库代码fbaCode或邮编postCode是否有误，是否和我们系统不一致，通过接口获取地址列表，可以获取本系统已配置的地址信息 |
单独报关或者合并报关，贸易方式必填 | 创建订单 | 如果订单的报关方式参数aloneDeclare不是“不报关”F，就需要你们提供贸易方式参数modeTrade | 核对inputInfoForm下的modeTrade参数是否没有传，参数详情请查看对应的接口文档创建订单 |
国家与服务渠道指定国家不一致 | 创建订单 | 下单选择的国家，和渠道不对应（例如国家是US，但是选择的渠道是欧洲渠道） | 核对下单选择的国家和渠道是否有问题 |
用户【...】不存在 | 请求接口使用的apiKey错误 | 核对是否正确地获取了apiKey，请查看文档对接前必看（获取apiKey），有关于apiKey获取方式的说明 | |
服务渠道需填写vat&eori，请选择‘税号备案信息填写方式’ | 创建订单 | 下单的服务渠道要求必需提供vat&eori税号，没有正确的传递vatNo和eoriNo参数 | 1. 如果有vat号和eori号，直接通过vatNo和eoriNo参数传递过来2. 如果暂时没有办法提供vat号和eori号，税号备案方式 taxSupplementType参数传2，表明税号要后续补充 |
入库信息不存在 | 获取入库转运/路由信息 | 查询轨迹的订单使用的客户单号userNos或入库IdinputIds在本系统中不存在，或者不属于请求的apiKey所属的这个客户账号 | 1. 核对请求获取轨迹的客户单号userNos或入库IdinputIds参数是否正确，是不是把这两个参数搞反了；2. 核对这个订单是不是还没有推送到本系统，或者在本系统中已经被删除掉； 3. 核对该订单在本系统中所属的客户账号，账号上面的apiKey和请求接口使用的apiKey是否一致 |
发票FBA Code【... 】与订单FBA Code【...】不匹配 | 创建订单 | 订单主参数上的亚马逊仓库代码fbaCode和清单发票明细parseItemList里的仓库代码fbaCode不一致 | 核对这二者哪个才是实际要送的仓库，将这两处的仓库代码调整一致 |
未查询到相关转运信息 | 获取入库转运/路由信息 | 该订单在本系统中尚未入库，还不存在可以获取的轨迹 | 等待订单入库后，获取可用的轨迹 |
箱数与序号总数不匹配 | 创建订单 | fba子箱号fbaNo参数格式有误，标准格式应该为fba号（长12位）+大写字母U（长1 位）+箱子序号（长6位）一共19位长度，如FBA15M3DTDV9U000014 | 核对fba子箱号fbaNo参数是否存在如格式错误 |
品名:【...】申报总价【...】与实际计算申报总价（申报单价*数量（或总数量））不一致 | 创建订单 清单发票信息/批量新增 | 传过来的申报总价参数和实际计算得到的申报单价*总数量不一致 | 核对申报总价=申报单价*数量的计算公式是否成立 |
二、失败案例详解
箱数件数必需大于0
地址信息不存在
国家与服务渠道指定国家不一致
用户不存在
入库信息不存在
发票FBA Code与订单FBA Code不一致
箱数与序号总数不匹配
fba子箱号的标准格式
000001到999999）一共19位长度 例：
FBA15M3DTDV9U000014