一、奇门介绍
奇门是支持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推送类接口:
级别 | 推送接口 | 接口名称 |
重要 | taobao.qimen.singleitem.synchronize | 商品同步 |
重要 | taobao.qimen.entryorder.create | 入库单创建 |
重要 | taobao.qimen.deliveryorder.create | 发货单创建 |
重要 | taobao.qimen.order.cancel | 单据取消 |
重要 | taobao.qimen.order.pending | 单据挂起/恢复 |
重要 | taobao.qimen.returnorder.create | 退货入库单创建 |
重要 | taobao.qimen.stockout.create | 出库单创建 |
扩展 | taobao.qimen.inventory.query | 库存查询(多商品) |
ERP接收类接口
级别 | 接收接口 | 接口名称 |
重要 | entryorder.confirm | 入库单确认 |
重要 | deliveryorder.confirm | 发货单确认 |
重要 | returnorder.confirm | 退货入库单 |
重要 | stockout.confirm | 出库单确认 |
扩展 | inventory.report | 库存盘点 |
五、注意事项
在对接之前,需要先明确下几点注意事项,在确认没问题之后方可安排对接工作:
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)可新建测试单进行验证是否能正确显示天猫直送业务标识