外仓对接常见问题
如遇以下类型的问题需要反馈wms处理：
（推送失败有明确错误信息的需要先联系wms确认）
错误原因： 1、操作失败，未返回失败原因 2、推送到委外仓库失败:操作失败，未返回失败原因 3、系统错误：奇门单据取消-->订单[CK20201008274]取消失败：取消订单:订单关闭检查:订单已经取消!（wms幂等问题） 4、推送WMS失败:send to fangzhou process fail: 系统内部异常（接口超时问题） 5、推送到委外仓库失败：未将对象引用设置到对象的实例。 6、推送WMS失败:java.net.SocketTimeoutException: Read timed out（wms超时问题） 7、xml解析错误了回传报错：“invalid xml” 8、单据出库单状态错误回传报错：“单据出库单状态错误” 9、推送到委外仓库失败:XML_PARSE_ERROR 10、Partner不存在 11、从委外仓库撤回失败:消息接收成功，但未做什么操作. 12、回传失败提示：timestamp expected 13、回传失败提示：too many connections
1、订单推向wms报错，日志中提示的信息为：订单或者是出库单发票商品名称为空
【分析】此提示信息需要查看系统配置中发票货品名称所设置的字段（位置：设置-系统设置-账款设置）
1）首先在系统设置中查看发票匹配的是哪个字段
2）到相应界面查看这个货品与该配置设置是否一致/是否填写
3）一般情况是系统配置是平台货品名称，但信息未在平台上没有维护
2、自流转订单延时发货时间逻辑是怎么样的？
库存不足会进行延时发货，1.2.4.9版本前会每分钟处理一次延时发货的单子，只要货品入库分配好库存就会自动执行出库。
1.2.4.9版本及以上版本优化为延时发货的订单会每次延时1天，会执行3次；若3此内都没有发货会每次延时1个月，再执行三次；若还是没有发货会每次延时1年。
如果有订单需要发货，可以手动点击发货分配库存。
3、为什么某货品的外部库存一直为0或者不更新？
【排查】
1）检查仓库是否是委外仓
2）wms是否支持外部库存查询
3）夜间定时任务是否执行
4）货品已维护上传至wms
5）回传时是否有该货品
6）接口回传速度是否正常
7）查看响应报文信息，对应商家编码对应数量（quantity）是否为0
【解决】联系wms确定该货品是否在其系统中已维护，如果没有维护则通过推送货品信息将未维护的货品推送到wms系统中。
如果已维护则确定回传库存信息时是否回传了该货品的库存信息，如果没有回传则联系wms技术解决，如果回传了则联系erp排查原因。
4、系统里退换单状态是已取消，但是并没有从wms里撤销成功，就已取消了
【原因】现在退换单取消退款的并且推送到了wms的，这种的只能手动撤销暂不支持自动撤销。
【解决】双十一之后的第一个包（1.2.6.0）会支持自动撤销
5、退货单撤回时提示类型不正确
一般是因为推送时单据类型与wms不对应
示例：（退换单创建接口）推送退换单时单据类型是：THRK （单据取消接口）从WMS撤回退换单时候单据类型是：XTRK（可以让WMS调整下回传类型，如果wms只支持THRK类型的取消，需研发做特殊处理）
6、为什么订单无法取消？
有两种情况会导致订单无法取消：在wms中该订单已发货或者已作废。
对于已发货是正常逻辑，不能取消已发货的订单.
而对于已作废，往往是客户先通知wms要取消订单，然后wms作废了该订单，这样旺店通系统这边就取消不了已作废的订单了。
取消订单这个接口的意义就是通过接口的方式来实现订单在旺店通系统中驳回，同时在wms中作废，所以如果要取消某订单，直接在旺店通系统内进行取消操作就好。
7、采购单推送报错：审核成功，单推送到委外仓库失败：指定的货主、供应商不一致。
1）检查指定的货主、供应商是否一致
2）多个仓库货主须多次申请奇门网关
8、从WMS驳回采购单报错提示:输入数据太长，超出字段长
【原因】驳回采购时会取消原来推送到wms的单据，要满足幂等，客户又可能存在再次推送的意图所以会自动在采购单号上添加一个后缀。原本单号长度就已经是20了，加后缀之后会超长了。
【解决】采购单号太长了，最大字符是20个字符，超过之后会出现这种问题，跟客户沟通好采购单号控制在15个字符之内。
9、卡单 单子一直在排队中没法推送到wms
【排查】①店铺授权失效
②物流映射
③大批量审单
【解决】如遇排队中单量一直不减少的问题请联系erp技术排查
10、推送WMS失败:货品未上传到委外仓库,请在“库存管理”界面右键将货品推送到WMS–> 商家编码:
【排查】确认货品是否推送。
【解决】在“库存管理”界面右键将货品推送到WMS
11、订单审核之后修改地址拦截出库自动驳回，从WMS拦截订单驳回审核，地址还是修改之前的地址
修改地址，自动变更地址的得勾选订单变更的自动驳回 ，此时驳回才会调用取消的接口
12、委外订单回传后没有重新计算邮资
增加后台配置（联系研发开通），若不开启，按照外仓回传的称重预估邮资（无论是否回传都不做处理），如果开启称重预估邮资会根据erp物流资费进行重新计算。
13、wms调拨回传提示“回传失败提示不允许入库未调拨货品–> 商家编码:XXX”
1）因为调拨单上是正品，回传的是残次品这样是不支持的
2）设计如此当前外仓不可超量调拨
14、sn码回传报错
1）是否开通sn码增值服务 2）sn码增值服务是否正确（区分接口和字段增值wms支持哪个） 3）仓库子类型是否支持sn接口 4）货品是否开启序列号管理（erp系统的对应单据的货品的sn类别必须是弱sn否则将不会创建sn） 5）接口回传地址是否正确
15、上传货品时提示SN管理时规则必须为空!
产生原因：菜鸟还是强管控，入库要采集SN不然出库就没库存，sn规则是在菜鸟这边ASCP设置的 链路：旺店通-菜鸟ASCP-菜鸟WMS 如果货品第一次推送test02强序列号成功，第二次修改test02成弱序列号再推送还是成功的。推送的时候还停留在ASCP，在仓这边看到是非SN商品 解决方案：在菜鸟这边手动维护SN
16、包装回传报错
1）包装物货品得先上传到wms系统（回传没有找到包装货品，会跳过该货品，回传不会报错，也不会有包装） 2）包材得有库存 （强制校验erp包装库存是否充足） 3）回传得是在包材字段里，排查位置packages里package下面packageMaterialList 4）回传包材得有包材数量
17、商品主数据信息 没有传 属性单位
原因： 1）更新后单位后未推送货品 2）只维护了sku的基本单位和辅助单位，未维护spu的 解决：让客户维护好货品和单品的基本单位和辅助单位
18、销售订单推送失败“推送WMS失败:调用CDC后置服务决策失败,wrs_route_fail#wrs仓路由失败#通过wrs接口查仓路由方案失败，错误信息：仓库均库存不足.货品id：638601486341;仓库code:[”“YIW431”“]；解决方案：若对wrs的结果有疑问请联系wrs的同学。#发货操作号：4480d0e78e5543c2ac55739d93360ed8”
产生原因：wms没有库存 解决方案：确定wms库存充足。如果没有库存需要wms入库补充上
19、货品上传失败提示查询不到应用授权信息:please authorize to resources,can't find app through fromCode =690086998-2021 traceId:XXXX。
产生原因：菜鸟要求客户ID和货主ID要求一样才行 解决方案：重新申请了奇门网关
20、其他出库业务WMS出库后生成的其他出库单没有备注。 业务单是我们推送给wms的 所以业务单是有的。出库单是wms推送给我们的， 这个时候wms那边如果备注了就会记录在出库单上，如果回传的报文上remark字段上没有备注就不会有。业务单的备注和出库单的备注是分开记录的。
21、推送WMS失败:WMS没有找到物流编码[CK004_0145]对应的承运商记录
1）确认物流编号是否正确 2）删除重建可能存在缓存
22、推送到委外仓库失败：指定的货主、供应商不一致
1）采购单推送前提：供应商代码 和名称 要维护到双方系统中之后才能推送成功否则会报错（一般wms不校验供应商时是可以任意哪个供应商都行） 2）检查回传地址是否正确。
23、回传报错不属于当前仓库
产生原因：仓库customer_id 是不是存在不同货主相同外仓编号的仓库
解决方案：要不就是回传的时候DeliveryOrder字段再加个货主，要不就是改下外仓编号
衍生问题：同样也是这两个仓仓库只是调拨方向相反就可以成功
原因：就是同一个外仓编码的，并且回传的时候没有加货主编号来区分，选择的是先创建的仓库的。假设先创建A仓库，后创建B仓库。回传的时候会选A仓库作为回传的来判断，如果发现回传的仓库不是A就提示不属于当前仓库。
24、驳回推送状态为推送失败的外仓订单，需要强制驳回
系统驳回订单就是将之前的出库单取消，审核之后会重新生成新的出库单。可能存在推送到wms成功但是由于WMS返回超时，我们系统状态就会是没推送成功，再驳回就会重新推送一个导致重复，驳回推送状态为推送失败的外仓订单，需要强制驳回
25、单据: XXX不存在（单据不存在）
这个回传信息都很清楚了，一般是类型错误，或者单号错误。单号在deliveryOrderCode字段里，该字段是我们系统的单号否则无法对应。调拨比较特殊，调拨单号我们推送出库单时候会在调拨单号加前缀DBCK和DBRK
26、异动类型不支持
排查：wms试图使用一个库存异动的单子完成两个仓库间调拨的行为。但是目前是不支持<orderType>类型为DBCK/DBRK（调拨出库/调拨入库）的。奇门的库存异动是单仓异动的（意思就是：这个库存异动是针对一个仓库进行数据调整，不是两个仓库的调拨），要两个仓库出入库，只能一个出一个入。 解决：orderType建议使用其他出库（QTCK）其他入库（QTRK）
27、上传货品报错：商品编号不存在，不能进行编辑！
产生原因：返回时没有外仓商家编码，我们默认就是当前商家编码，然后就会修改为对应得商家编码。 排查方法： 1）检查是否在erp修改了商家编码 2）检查是否在wms修改过编码 3）仓库子类型是否正确 4）提供回执报文查看<itemId>是否正确(下面是回执示例) WMS 回执示例： <response> <flag>success</flag> <code>0</code> <message>商品数据解析成功</message> <itemId>WMS-489708383</itemId>WMS 系统商品编码 </response> 解决方案：wms修改代码回传时要包含WMS 系统商品编码
28、推送WMS失败:订单行商品编号重复,不能进行保存!
产生原因：wms有限制不支持相同货品多行明细，就是不支持赠品推送。 解决方案：走资源管理开增值服务相同货品多行明细合并
29、回传报错：物流单号：XXXX,物流单号已被其他出库单使用。
产生原因：这个报错是由于wms进行拆单了物流回传回来，相同物流单号，并且公司也是一个，创建物流同步记录就失败了。 解决方案：需要wms修改物流信息再回传。 拓展：如果有erp维护波动影响单据造成回传报错Unknown Error。重新尝试回传即可。
30、调拨单推送外仓时，提示货品库存不足
产生原因：系统内可以开单是因为通过外仓盘点了erp的库存（注外仓盘点仅调整erp库存，不调整实际外部库存）；无法推送是因为wms库存不足，外仓正品库存为0 。 排查方法：库存管理界面右键查询对应商品，wms查询货品库存，正品数量为0 解决方案：查询库存类型为ZT不是ZP就没有对应到正品上去。建议wms做下处理
31、WMS已发货，回传OMS，OMS响应TOP15异常。 鉴于该问题发生频次过高，容易造成发货超时。每天都会出现，如果没有及时发现，就是造成超时，平台罚款
产生原因：该问题属于奇门仓储业务接口报错，非erp报错 解决方案：wms可以增加自动重新回传的动作。重新回传就成功了。 排查方法：参考奇门异常排查手册 开放平台-文档中心 (taobao.com)
奇门接口报错无外乎奇门平台的报错和对方接口的校验报错，针对不同的报错找对应的人。奇门平台的报错信息请参看本页中的错误码及解决方案。
1. 如果<response>报错信息中code=TOP15或者code=TOP60，则该报错是奇门平台给出的报错信息，根据报错message信息在本页下面的表格中查找对应的解决方案。奇门上线以来，所有ISV反馈的奇门平台报错信息，在这里都能找到答案。(注：如果是奇门的报错，message信息一定是英文的) 2. 如果<response>报错信息中code是其他的信息，则该条报错信息一定是对方的报错，请联系对方协助排查原因。
32、委外仓批次明细货品保质期时间与有效期时间对不上。
排查方法：委外批次明细界面字段解释及数据来源 该界面数据都是一次性的 是每天统计一次的 有效期是wms回传的过期日期的字段值 生产日期是wms回传的生产日期的字段值 保质期是取得系统内货品档案维护的有效期，并不是回传的，也不是计算的。
33、委外仓批次明细界面没有数据。客户开通了委外仓批次明细的增值服务，某个仓库查不到效期，这个仓在效期查询界面是空的 ，在出库明细界面是可以查到有效期的。
产生原因：quantity这个值按照奇门标准应该回传int类型，wms回传的值有小数所以库存查询之后我们无法接收。 它实际的夜间任务执行了接口是都有查询的记录的，我们系统库存查询方法由于接收的值类型不是int所以系统报了空指针异常所以没有展示，调用接口查外仓是没有报错的。等改了之后。客户可以右键查询下wms货品库存。看看外部库存有没有变。外部库存变了就证明查询正常了。 解决方案：wms调整回传的数值类型 排查方法： 1）是否开启增值服务 2）该仓库是否为外部仓库 3）对应wms能否回传批次有效期 4）外仓是否有回传批次有效期 5）其他仓库是否正常统计（排查是不是定时任务没执行，如果就一个仓库有问题就不是统计的夜间任务的问题） 6）该仓库库存管理界面能否正常同步外部库存(如果没有正常同步需要找技术支持查看，报错是什么查对应奇门接口报文有没有返回什么错误)
34、订单审核后卡在排队中没有推送WMS ，买家退款也没有自动驳回
审核了立马就退款了，推送任务还没有完成呢，驳回后台是报错了的单据驳回失败原因:存在正在推送的出库单。。 驳回的时候单据还是排队中，没有推送成功所以就只是拦截了
35、委外订单支持发货后修改重量并重算邮资
注：①仓库为委外仓，且出库单状态为发货后的状态才能更新包裹重量②无法计算的包括（无物流单、无需物流、仓库和物流无对应资费策略）
36、入库单对应的调拨单状态错误
原因：出库单和入库单是在调拨单审核时一起推送的，所以此时外仓同时能够接受到两个单据，先操作了入库单回传就会提示“入库单对应的调拨单状态错误”（必须先操作出库回传之后再操作入库再进行回传。） 排查： 1）对应调拨单状态是否为调拨中 2）调拨单出库时间是否早于入库单回传时间 处理：1）未出库状态需要先做出库再回传入库单2）已出库的现在需要直接再操作下入库回传
37、未知物流公司
1）回传仓库是否正确，一仓多货主情况下。未回传ownerCode无法区分回传对应仓库，会导致匹配到其他并没有建立物流映射的仓库。 2）物流编号是否维护正确查看报文回传的物流编码是否一致。 3）在维护物流之前操作的，需要再重新操作下回传 4）可能存在缓存需要手动删除下改物流映射重新映射下。