一、奇门介绍

奇门是支持ERP、WMS之间的系统标准化对接，通过构建ERP、WMS系统之间标准通信协议来实现不同系统之间的打通。万里牛ERP已实现奇门标准接口，可快速对接支持奇门接口的WMS。对接后，ERP可结合WMS，实现采购、销售、售后等业务。

二、奇门对接

对接流程概览：

1.开通：联系万里牛开通奇门，并提供对接的WMS信息（提供WMS的appKey）。

2.新建对接仓：在“仓库”界面下新建奇门对接仓，仓库编码需和WMS仓库编码保持一致。

3.新建快递

跟WMS确认可能会发哪些快递，在“快递公司”页面下建立对应的快递（对应淘宝快递需选择正确）

4.推单测试

仓库和快递新建好后，提供仓库编码联系万里牛技术进行配置。配置好后，您会发现系统设置、商品、销售模块下分别多了奇门配置、仓储系统商品同步、WMS配货3个页面。

1） 奇门配置

该页面用于商家自助配置仓库，如在对接完成后，有新分配的对接仓可自助快捷配置，也可联系万里牛进行配置。

1.选择相应的wms类型，填入客户ID（WMS提供的customer ID／货主编码）；

注：客户ID唯一

2.选择之前在仓库中维护好的奇门仓库，点击确认；

3.选择店铺，填写平台编码、店铺编码，点击保存；

注意：

a.如果不新增店铺，仓库配置填写好后可直接保存；

b.如果新增店铺，平台编码、店铺编码必填，且店铺编码唯一。

4. 提示仓库配置成功即可，若有其他报错联系万里牛技术；

2） 仓储系统商品同步

奇门配置完成后，打开商品—仓储系统商品同步页面，选择需要同步到WMS的商品，是否已同步有√的即同步成功

3） WMS配货（见功能介绍）

4）在正式切换之前，先做少量订单的测试，确保整体业务没有问题后，再做正式切换。推单测试流程参见功能介绍

三、功能介绍

1.采购

万里牛可与WMS对接完成采购业务。在“采购订单”页面下新增采购订单，仓库选择对接仓

新建完采购订单后，系统会自动将单据信息推送到WMS。仓库到货入库后，WMS将入库信息回传，ERP自动创建采购入库单增加库存。采购订单增加备注记录。

2.销售

1）审核订单

万里牛与WMS对接后，系统内的订单都可推送至WMS进行打单发货，发货回传后万里牛自动发货出库，线上订单会同时通知线上发货。

向WMS推送订单时，只需在审核环节将订单仓库改成对接仓，确认审核即可。审核之后，订单会异步推送至WMS。

2） 奇门配货

对接仓的订单审核之后，会流转到“奇门配货”环节，不会再到“打单配货”环节。所以该部分订单不适用常规流程发货，等待WMS发货回传即可。

在该页面上订单有“推送中”、“WMS配货”、“挂起”、“已修改”、“失败”的状态，针对不同状态可以对订单执行打回审核、挂起、恢复、重新下单的操作。

状态：

• 推送中：订单异步推送WMS，还未推送到WMS之前，订单显示“推送中”。该状态订单不允许任何操作。

• WMS配货：正常审核后发货前，推送到WMS的订单，订单显示“WMS配货”。配货中的订单可打回审核，挂起或者重新下单。

• 挂起：通知WMS挂起后，订单状态显示“挂起”。挂起的订单可恢复，也可以进行修改，订单修改仅支持快递、地址、备注的修改。修改后状态变为“已修改“。

• 已修改：挂起的订单修改后，状态显示“已修改”。修改过的订单不能再恢复，只能重新下单或者打回审核。

• 失败：订单推送到WMS报错异常，未返回对应单号，此类订单状态显示“失败”。失败状态的订单，可在操作记录中查看推送失败的原因。根据提示做相应调整后，打回审核重新再重新推送即可。推送订单时，可能会有部分推送不成功，所以对接仓的订单审核之后，需要关注奇门配货中是否有“失败”状态的订单。

• 等待推送：缺货订单一键重推后，订单默认为此状态，等候系统自动推送。

操作：

• 打回审核：将该页面下的订单打回审核环节，同时接口会通知WMS撤销订单。如要取消推送到WMS的订单，可执行该操作；

• 挂起：仅对“WMS配货“的订单生效，通知WMS执行挂起，WMS返回挂起成功后，订单状态变为“挂起”。挂起后，可对订单进行修改。（挂起功能需WMS支持奇门挂起接口）；

• 恢复：仅对“挂起“的订单生效。通知WMS端执行恢复，恢复成功后，状态变为“WMS配货”，订单继续正常流转。（恢复功能需WMS支持奇门恢复接口）；

• 重新下单：可对“WMS配货”、“挂起”、“已修改”状态的订单执行。重新下单后，将会撤销WMS原来的订单，并重新推送一笔给WMS；

• 提交缺货订单：可一键重新推送之前因缺货而回传状态的订单到wms。

流转标识：

• 流转标识=接单，WMS初始

• 流转标识 = 打印，WMS打单

• 流转标识=拣货，WMS拣货

• 流转标识 = 复核，WMS验货

• 流转标识= 称重， WMS称重

• 流转标识=待提货，WMS待出库

• 流转标识=已发货，WMS已出库，结束状态

• 其他流转标识，详情看订单操作记录

3.售后

在“新建售后单”页面下，新建一笔售后单据，售后类型选择退货或换货，退入仓库选择对接仓。新建完成后，系统会将销售退货单推送给WMS，等WMS操作入库后回传，万里牛就会自动新增销售退货单。

换货类型的售后单，除了退货入库，换出的商品需要再人工下单，然后作为线下订单走销售流程，可推送至WMS再进行发货操作。

4.其他出入库

其他出库作为出库方式的补充，可以灵活调整仓库的库存。结合其他入库，也可以实现不同仓库间的库存调拨。

对接WMS做出入库业务时，分别在“其他出库预约”“其他入库业务”中新建出库预约单，仓库选择对接仓。保存后会将出库预约单推送至WMS，WMS做完出库回传后，系统会自动新建一笔其他出库单扣减库存。同理，WMS接收入库预约单，入库回传后，系统新建其他入库单增加实际库存（在途库存减少）。

5.调拨

库存调拨为其他出入库的结合，库存调拨分为“库存调拨单”、“调拨入库单”、“调拨出库单”三部分。

若做对接仓之间的调拨，将调拨类型选择为实际调拨，发货仓和收货仓设置为对接仓。保存后系统会向发货对接仓的WMS推送出库预约单，WMS出库回传后，系统新增对应调拨出库单减少库存，同时会向收货对接仓的WMS推送入库预约单，等收货回传系统自动新增对应调拨入库单增加库存。至此，完成整个调拨业务。

四、万里牛奇门接口列表

以下是万里牛ERP实现的奇门接口，标注“重要”的，WMS必须支持对应的奇门接口，否则会影响正常的业务流程。标注“扩展”的，为可扩展接口，WMS可以不支持。

ERP推送类接口：

ERP接收类接口

五、注意事项

在对接之前，需要先明确下几点注意事项，在确认没问题之后方可安排对接工作：

1. 对接的商品需提前维护好条码字段，否则无法推送商品。

2. 首次对接的商品系统会进行同步，为了完整维护对应关系，需确保WMS未录入过这些对接商品。

3. 商品首次同步，建立好对应关系后，不允许再修改商品编码，否则商品可能无法正确对应。

4. 系统组合商品推送时，将拆分成子商品推送，需将系统中的组合商品维护好。

5. WMS需支持奇门挂起接口和挂起流程，否则线上订单退款系统无法自动挂起。

6. 确认WMS发货和回传的流程。ERP同步淘宝可能会有失败的场景，若WMS先发货再回传或者未对报错做处理，可能会导致快递发出，但线上仍未发货。

7. 对接WMS后，订单所有快递单号都由WMS获取。在奇门配货界面，批量生成快递单号后，只在当前界面显示。不会传输到WMS中。

8. 发货单明细计算商品单价，单价保留两位小数，除不尽时四舍五入。通过数量和明细单价计算的总价和订单总金额，可能会存在偏差。不建议在WMS中维护金额。

9. 前期需要有少量订单先测试整体流程。

10. ERP订单号不会改变，若WMS在撤销后不支持相同单号，ERP订单打回后就无法再审核推送（目前已知菜鸟WMS和巨沃WMS不支持）。

11.菜鸟对接注意事项

• 仓库维护，需要维护仓库信息，否则菜鸟接单失败，如下图，除了固定电话，其它都必须有；

• 供应商维护，需要维护供应商，否则菜鸟接受采购订单失败，如下图：

除了当前应付款和固话，都需要维护。

==========FAQ==========

1.推送到wms的订单发生退款了怎么处理？

退款/部分退款的订单会自动挂起。挂起后，奇门配货页面显示：挂起。WMS里提交到下一个环节，提示已挂起不能操作。

• 若此时买家又取消了退款，需要在WMS配货页面，点击恢复，才可以解除挂起；

• 若商家同意退款，订单就变成了关闭状态。WMS里，订单拦截关闭。奇门配货页面，也变成关闭看不到该订单了。

2.奇门对接是否支持批次号的推送？

奇门接口支持wms采购入库、退货，销售出库、退货，其他出入库单据批次号回传及批次号调拨业务。

3.ERP已与WMS对接，在ERP录错库存，如何改正？

在ERP【库存盘点】生成盘点单进行总库存的调整。

4.对接的WMS要发的快递在【对应淘宝快递】找不到，怎么办？

对应淘宝快递即淘宝后台支持发货的快递。若其中无三方仓配送的快递，可向三方仓索取快递编码，新增快递，使其编码一致，对应淘宝快递可选其他，联系万里牛技术更改配置为推送快递编码字段至三方仓即可。

5.wms配货页面打的订单标记是否推到WMS？

该订单标记仅在ERP销售环节展示，不会推送到WMS

6.入仓（菜鸟仓）也支持天猫直送业务吗？

支持。流程如下：

1）联系万里牛技术配置：需提供参与天猫直送业务的店铺名；

2）同步打标商品

配置后，商品模块会出现【仓储系统商品同步】页面，勾选店铺后点击增加想要打标的商品进行同步即可。

3）可新建测试单进行验证是否能正确显示天猫直送业务标识