奇门:异常包裹单接口与缺货接口配置

注1:本文档有效仅限于老接口：qimen.taobao.wms.returnapply.report

异常包裹单的功能介绍：

主要用于无头件的处理，有货无单场景。。
这里有两种应用：

1，先斩后奏，仓库先入库。需开启WMS参数：WB0148

即仓库先入库上架，入库信息通过接口回传上游OMS系统，然后电商运营人员根据该信息匹配退货申请或联系客户。然后在OMS推退货通知单。最后仓库再手工/自动关联该通知单的过程。完成异常包裹单。退货单回传这个过程。其好处在于降低了跨部门沟通成本，有效的提高了退件的周转率。但是坏处在于存在潜在损失（串货无法追究等），处理链条长。功能使用上需要慎重，必须要辅助相应的管理结合流程、制度、机制，经过电商部门、财务部门、仓储部门等相关方的同意后使用。

2，仅作通知。即不开WMS参数：WB0148。

相当于把异常包裹单信息告诉上游，上游电商运营人员根据信息匹配，生成退货通知单。注意，这里不需要关联单据。而是要正常操作退货入库。

异常包裹单回传情况

WMS异常包裹单填写注意事项：

同步订单填的是原B2C发货通知单的同步订单单号，如果不确定不知道，就不要填，否则会导致无法回传。除此条外，其他内容都可以填写。如图

注2：异常包裹单接口配置，走的是奇门云网关

前提条件概要：

1、奇门里新云网关配置上线。
2、老云网关配置上线 （E3一套环境; 标准接口走新云网关，退货包裹单接口走老的云网关 上线customerid都是用同一个）
3、wms两套一套标准接口一套退货包裹单。

云网关部署部分

1.咨询WMS产品部获取iWMS奇门云网关接口代码版本/脚本；

2.新建IIS应用程序池，命名iWMSQimenCloudAPI_Pool；新建应用程序，部署奇门云网关接口iWMSQimenCloudAPI；

3.配置Web.config文件：

接口自动回收配置地址默认为：
http://接口服务器ip:端口号/应用程序名(如iWMSQimenCloudAPI)/Router.

4.配置ApiConfig.configs文件：

店铺session 可默认为空 不配置；

5.测试测试接口地址是否正常，接口地址默认如下：

http://接口服务器ip:端口号/应用程序名(如iWMSQimenCloudAPI)/Router，浏览器返回

{"flag":"failure","code":"909","message":"Get访问测试!默认format=json返回。"}

则正常；

6.执行定时任务脚本：

insert into 
TSysWmsApiTaskItem(TaskId,TnId,TaskName,DllFile,RunObj,Param1,Param2,FreqType,FreqInterval,FreqValue,FreqSubType,FreqSubInterval,SubStartTime,SubEndTime,StartDay,EndDay,IsInfinite,Explain,Creator,CreateDate,Status)
select 'QC00001','*','异常包裹单回传','WMS.QimenCloudData.dll','WMS.QimenCloudData.UpdateReturnApplyTask','','',
'2','1','','2','30','1900-01-01 00:01:00.000','1900-01-01 23:59:00.000','2015-01-01 00:00:00.000','2099-01-01 00:00:00.000',0,'','admin',GETDATE(),1

重启对应应用程序池，查看接口任务列表
http://接口服务器ip:端口号/应用程序名(如iWMSQimenCloudAPI)/Task/TaskList.aspx

注3：开发平台配置的内容。非常重要。

1.开发平台配置WMS奇门云网关参数：登录开发平台，qimen.taobao.com

选择ERP-WMS官方场景

2.选择异常包裹单接口，进入接口配置界面，配置wms奇门云网关接口地址：

特别说明：标准接口一开始都是itc模式的。异常包裹单接口是后面加上去，之前咨询阿里的人，说这几个接口和自定义接口只支持云网关模式。WMS对接非百胜系的竞品OMS时要特别注意提醒上游此点

3.授权配置

注意:
1.奇门ITC与奇门云网关可共用同一个CustomerId;
2.WMS奇门云网关接口可理解为ITC模式的补充接口，并行独立部署，相互不影响；
3.如果报{“response”:{“flag”:”failure”,”code”:66,”message”:”qimen cloud inernal error”,”sub_message”:”找不到对应的路由信息”,”request_id”:”xsq3okb3pmbs”}}需要找上游检查配置。可联系任坤坤。

当胜境iWMS系统跟非百胜系OMS系统对接时，需要联系呼叫中心，上线百胜奇门的云网关并完成授权。如图

异常信息处理FAQ:

异常问题：回传失败，报错回传。报文如图：

{"response":{"flag":"failure","code":15,"message":"Remote service error","sub_code":"1","sub_message":"WMS包裹单号:AKA02200909000166:TIANTIAN->对应配送方式不存在","request_id":"ofgy0m0cek1j"}}

问题诊断：上下游快递代码不一致。

解决办法：

执行语句：

SELECT * FROM TBillAbnormalKD where BILLID ='AKA02200909000166'
UPDATE TBillAbnormalKD SET ShippingCode ='快递代码' where BILLID ='AKA02200909000166'

缺货信息回传

缺货接口配置，WMS部分接口都是正常的，可以正常回传并且有日志success返回，但是会出现E3看不到回传结果的问题。这里需要在E3里开启如图：WMS_CALLBACK_ORDER

缺货回传成功的标识：

缺货处理流程，一般为，上游筛选缺货订单，然后取消原订单，重新制单发货。