三方仓奇门对接操作手册

ERP2号产品经理发表于:2018年06月20日 18:15:36更新于:2018年09月06日 17:46:46

一、奇门介绍

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

二、奇门对接

对接流程概览:

1.开通:联系万里牛开通奇门,并提供对接的WMS信息(提供WMS的appKey)。

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

image.png

3.新建快递

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

image.png

4.推单测试

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

image.png

1)  奇门配置

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

  •  选择相应的wms类型,填入客户ID(WMS提供的customer ID/货主编码);

    image.png

  • 选择之前在仓库中维护好的奇门仓库,点击确认;

image.png

  •  提示仓库配置成功即可,若有其他报错联系万里牛技术;

奇门配置成功.png

2)  仓储系统商品同步

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

image.png

3)  WMS配货(见功能介绍)

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

三、功能介绍

1.采购

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

image.png

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

image.png

2.销售

1)审核订单

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

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

image.png

2) 奇门配货

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

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

image.png

状态:

  • 推送中:订单异步推送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再进行发货操作。

image.png

4.其他出入库

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

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

image.png

5.调拨

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

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

image.png

 

四、万里牛奇门接口列表

以下是万里牛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.菜鸟对接注意事项

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

image.png

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

image.png

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

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

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

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

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

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

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

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

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

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

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

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

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

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

6.入仓(菜鸟仓)也支持天猫直送业务吗?

支持。流程如下:

image.png

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

2)同步打标商品

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

image.png

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

%E5%A4%A9%E7%8C%AB%E7%9B%B4%E9%80%81%E6%9C%8D%E5%8A%A1.png?version=1&modificationDate=1522217577000&api=v2



    您需要登录后才可以回复