一、业务概况 国内仓配业务：商家与菜鸟进行合作，商家入驻菜鸟国内仓库，菜鸟为商家提供具有行业特色、电商特色的仓配服务。系统方面由商家所使用的ERP系统直接通过接口对接菜鸟系统，通过ERP系统下发指令给菜鸟系统，业务完成，由菜鸟系统反馈给ERP系统，从而支撑双方仓配业务的开展
二、业务对接流程
1、国内仓配业务系统对接流程

2、流程说明：
2.1 服务订购
商家登陆www.cainiao.com，进行订购，业务小二审核通过

2.2 系统对接
目前市场中主流的ISV都已经与菜鸟完成了仓配系统的对接，如果商家使用的ERP系统是（ISV）第三方独立软件服务商提供的ERP软件，这种需要进行开发、联调 如果商家使用ISV软件，这个ISV系统已经通过了菜鸟系统的联调，详见——————可以跳过ERP系统开发及系统联调测试两个阶段。

2.3 系统上线
系统联调通过之后，由商家或ISV发起系统对接申请，实施小二审批，针对日常业务场景逐一进行线上验证。

三、业务场景对应API 汇总
1. 有序列表
业务场景分类 子场景分类 系统接入方式 对接接口列表
基础信息 仓库 通知(商家->菜鸟) taobao.qimen.warehouseinfo.query
基础信息 配送公司 通知(商家->菜鸟) taobao.qimen.expressinfo.query
商品管理 新增商品 通知(商家->菜鸟) taobao.qimen.singleitem.synchronize
商品管理 更新商品 通知(商家->菜鸟) taobao.qimen.singleitem.synchronize
入库管理 入库单通知 通知(商家->菜鸟) taobao.qimen.entryorder.create
入库管理 入库单确认 推送(菜鸟->商家) taobao.qimen.entryorder.confirm
入库管理 入库作业状态 推送(菜鸟->商家) taobao.qimen.orderprocess.report
入库管理 取消操作 通知(商家->菜鸟) taobao.qimen.order.cancel
出库管理 出库单通知 推送(菜鸟->商家) taobao.qimen.stockout.create
出库管理 出库单确认 推送(菜鸟->商家) taobao.qimen.stockout.confirm
出库管理 出库作业状态 通知(商家->菜鸟) taobao.qimen.orderprocess.report
出库管理 取消操作 通知(商家->菜鸟) taobao.qimen.order.cancel
发货单管理 销售发货单通知 通知(商家->菜鸟) taobao.qimen.deliveryorder.create
发货单管理 销售发货单确认 推送(菜鸟->商家) taobao.qimen.deliveryorder.confirm
发货单管理 销售发货单作业状态 推送(菜鸟->商家) taobao.qimen.orderprocess.report
发货单管理 取消操作 通知(商家->菜鸟) taobao.qimen.order.cancel
销售退货单管理 有货无单销退入库单 推送(菜鸟->商家) taobao.qimen.returnorderlack.report
销售退货单管理 销退入库单 通知(商家->菜鸟) taobao.qimen.returnorder.create
销售退货单管理 销退入库单确认 推送(菜鸟->商家) taobao.qimen.returnorder.confirm
销售退货单管理 取消操作 通知(商家->菜鸟) taobao.qimen.order.cancel
销售退货单管理 销售补发，换货出库单创建 通知(商家->菜鸟) taobao.qimen.deliveryorder.create
销售退货单管理 销售补发，换货出库单确认 推送(菜鸟->商家) taobao.qimen.returnorder.create
SN码管理 SN码管理 推送(菜鸟->商家) taobao.qimen.sn.report
盘点管理 库存损益 推送(菜鸟->商家) taobao.qimen.inventory.report
盘点管理 库存损益 推送(菜鸟->商家) taobao.qimen.inventory.report
库存调整 库存调整 推送(菜鸟->商家) taobao.qimen.inventory.report
库存调整 库存调整 推送(菜鸟->商家) taobao.qimen.inventory.report
配送管理 配送单拦截指令下发 通知(商家->菜鸟) taobao.qimen.order.callback
配送管理 配送单拦截结果回告 推送(菜鸟->商家) taobao.qimen.orderprocess.report
异常管理 销售订单发货异常 推送(菜鸟->商家) taobao.qimen.exception.report
四、业务场景描述&业务规则

4.1、基础信息管理

4.1.1业务场景说明
◇基础信息同步包含四个元素（货主、店铺、仓库、配送公司），是系统对接的第一步，是ERP系统与菜鸟系统对接的主数据。通常是菜鸟提供，由商家或者ISV维护到ERP系统中。

◇货主：就是订购菜鸟服务的店铺名称，货主id：就是这个淘宝店铺的用户id，是商家在菜鸟系统的身份标示。

◇店铺 ：做为货主的店铺订购菜鸟服务之后，自动在菜鸟系统生成店铺，这个店铺我们定义为主店铺，如果涉及多个店铺在菜鸟仓发货，那么需要在BMS系统添加店铺，这种店铺我们定义为子店铺。

◇仓库：指的是菜鸟仓，实施同学提供提供菜鸟仓库名称和仓库CODE,商家实施或者ISV实施同学手工维护在ERP系统。部分ERP系统可以根据货主ID，查询到货主对应的仓库信息。

◇配送公司：指的是菜鸟仓所使用的快递公司，实施同学提供提供快递公司名称和快递公司CODE，商家实施或者ISV实施同学手工维护在ERP系统。部分ERP系统可以自己获取。

4.1.2 业务流程
Snip20170321_295.png

4.2、商品信息管理
4.2.1业务场景说明
◇商品信息指的是要入库的实物信息，包含实物的名称、条形码、商家编码、商品保质期、商品的生产日期、商品的sn码等商品属性信息。系统对接需要商家在ERP系统里面把商品的信息同步给菜鸟系统，只有商品信息同步之后，erp系统和菜鸟系统才能进行信息的交互和识别。

◇同步：首次与菜鸟系统对接，需要通过erp系统同步商品信息给菜鸟系统。如果同步成功，erp系统商品信息会在菜鸟系统自动创建，并且同步到菜鸟仓库。如果同步不成功，菜鸟系统不会显示对应的商品信息。是否同步成功可以在erp系统查看，也可以在菜鸟系统（bms系统）查看。

◇更新：在不修改商品条形码、商家编码、货品id的基础上，可以对商品的属性进行更新（区域销售、商品名称）

◇商品修改：如果已经同步给菜鸟的商品信息（条形码、商品编码）需要修改时，必须先在bms系统删除商品信息，然后在erp系统删除对应的商品信息，重新走商品同步流程。不允许在erp系统单独修改，否则会引起单据下发错误、库存数据不一致的情况。

4.2.2业务流程
Snip20170322_296.png

4.2.3业务规则
◇商品名称必须是到色到码的描述
◇不允许一个条形码对应多个商家编码
◇一个商品可以有多个条形码
◇商品在无单据占用、无库存、无匹配关系的前提下，才能在bms系统删除，否则不能删除。
◇如果ERP系统保质期属性不能同步菜鸟系统，可以在菜鸟系统维护保质期信息。
◇如果ERP系统不能同步商品正品、赠品属性，可以在菜鸟系统维护，菜鸟小二审核生效。
◇商品保质期信息维护完成之后，才能下发入库单，否则菜鸟仓不会进行商品保质期管理。
4.3、入库单管理
4.3.1 业务场景说明
◇入库单是当有商品要送入菜鸟仓库时，将入库的商品信息、商品数量、发件人地址、发件人信息、送入菜鸟仓库信息通过商家ERP 系统操作推送给菜鸟系统的单据，叫做入库单。

◇下发入库单：入库单由商家在ERP系统操作，并推送给菜鸟系统，推送成功ERP系统收到菜鸟系统返回的LBX单号，推送失败ERP系统则没有LBX单号，菜鸟仓库不到单子，是否成功也可以在菜鸟BMS系统查看

◇预约入库：入库单推送成功之后，需要根据LBX单号在菜鸟BMS系统中进行预约。

◇入库单取消：入库单推送成功之后，如果入库计划取消，需要在ERP系统取消，如果菜鸟仓库系统已经开始收货，那么该入库单将不能取消，更不能删除

◇入库完成：菜鸟仓库对货品质检、上架全部完成之后，系统会将上架数量回传给商家ERP系统，ERP系统中单据改变，ERP系统库存增加。

4.3.2、业务流程
Snip20170327_347.png

4.3.3、业务规则
◇入库单推送菜鸟系统成功之后，不能在ERP系统做任何修改、删除，否则导致库存不准确。

◇目前菜鸟仓支持的入库类型：CGRK=采购入库, QTRK=其他入库，B2BRK=B2B入库

◇一张入库单不要超过500个SKU，否则可能造成系统通讯延迟

◇入库单发件人、发件人地址必须填写，并能通过ERP系统下发给菜鸟系统，否则入库单下发失败

◇一个入库单里面同一个商品只能显示一条记录，多条记录同步失败。比如入库单A商品入库100件，不要在ERP系统显示两条A 60件 、A 40件

4、销售发货单管理

业务场景说明

销售发货单：就是销售订单，由ERP系统从交易平台获取，并通过ERP系统下发给菜鸟仓库的发货单据。

1、售订单下发：商家ERP系统从销售平台获取订单之后，需要菜鸟仓库发货的订单，ERP系统需要自动或者手工给菜鸟系统推送订单，只有推送成功，菜鸟系统才会告知菜鸟仓库进行发货。

2、销售订单取消：已经成功推送给菜鸟系统的订单，因为各种原因，要取消菜鸟仓发货的。（注意ERP系统操作流程）必须在ERP系统发起订单取消的指定，订单是否取消成功，需要查看ERP系统订单取消的状态，如果ERP系统显示取消成功，该订单菜鸟仓库不会发货。如果ERP系统显示取消失败，说明菜鸟仓这个订单已经发货，系统层面不能取消。

3、销售订单修改：销售订单已经成功下发给菜鸟系统，如果销售订单需要修改，先在ERP系统取消订单，取消成功之后，在ERP系统对单据进行修改，修改审核完成之后，更换ERP系统单号，然后下发菜鸟系统。
4、销售订单完成：菜鸟收到销售订单之后，安排菜鸟系统发货，菜鸟仓库，销售订单包裹打包出库完成，菜鸟系统通知ERP系统订单发货的情况（快递公司、运单号），ERP系统会通知销售平台发货，并上传运单号和快递公司。
5、京东COD销售订单：京东COD订单推送菜鸟系统发货前，需要提前通知业务小二确认后，方能下发销售订单给菜鸟系统
业务流程
业务规则：

1、销售订单所属的店铺，需要提前在菜鸟系统维护（BMS）,否则下发失败，无法在菜鸟系统发起投诉、咨询工单

1、任何单子递交过了，然后又取消了就不能再递交了 ，要重新建个新单子递交
2、商家接入所有订单的快递由菜鸟系统路由，上游ERP系统快递公司选择other，
3、菜鸟系统不接受商家在ERP系统指定快递公司。
4、销售订单推送给菜鸟，要是发货人详细地址，就是菜鸟仓库的地址
5、销售订单推送给菜鸟，必须是菜鸟仓有库存的情况下，才能推送，否则推送报错。
6、销售订单收件人省市区地址必须清楚，联系方式必须清楚
7、销售订单一旦成功推送给菜鸟系统，不得在ERP系统删除，否则会造成库存混乱
5、出库单管理
业务场景说明：

出库单：商品从菜鸟仓库调出的单据。将出库的商品信息、商品数量、商品属性（正品、残品）等通过商家ERP 系统操作推送给菜鸟系统的单据，叫做出库单。

1、下发出库单：出库单由商家在ERP系统操作，并推送给菜鸟系统，推送成功ERP系统收到菜鸟系统返回的LBX单号，推送失败ERP系统则没有LBX单号，菜鸟仓库不到单子，是否成功也可以在菜鸟BMS系统查看
2、出库单取消：出库单推送成功之后，如果出库计划取消，需要在ERP系统取消，如果菜鸟仓库系统已经开始下架，那么该出库单将不能取消，更不能删除
3、出库单修改：出库单推送成功之后，如果出库计划要修改，先把单据取消，然后在ERP系统重新建立出库单，然后推送到菜鸟系统。
4、出库完成：菜鸟仓库对货品下架、打包全部完成之后，系统会将下架数量回传给商家ERP系统，ERP系统中单据改变，ERP系统库存扣减，商家可以安排提货。
业务流程
Snip20170322_299.png

业务规则
1、出库单推送菜鸟系统成功之后，不能在ERP系统做任何修改、删除，否则导致库存不准确。
2、目前菜鸟仓支持的出库类型：PTCK=普通出库单 ，B2BCK=B2B出库
3、一张出库单不要超过500个SKU，否则可能造成系统通讯延迟
4、一个出库单里面同一个商品只能显示一条记录，多条记录同步失败。比如入库单A商品入库100件，不要在ERP系统显示两条A 60件 、A 40件
6、销售退货单管理
业务场景说明
销售退货单：销售订单发货之后，由于顾客拒收、退回或者是商家拦截，销售订单包裹退回到菜鸟仓库，需要菜鸟仓库对退回的包裹里面的商品进行二次入库的单据。由ERP系统主动发起的销退单据，推送菜鸟系统，菜鸟仓库收到包裹之后，拆包质检、收货上架完成之后，菜鸟系统会把收货入库的商品信息、商品数量、商品属性（正品+残品）等信息回传ERP系统，ERP系统单据状态改变，库存增加。
1、销售退货单下发：ERP系统根据原来的销售发货单据，在ERP系统创建销退单并同步到菜鸟系统，下发成功，ERP系统可以看到销退单号，仓库收到包裹可以按照单据操作货品的质检和二次上架。如果下发失败，菜鸟系统不可以见，仓库收到包裹之后，无法操作。是否成功，ERP系统和菜鸟BMS系统可以查看。
2、销售退货单取消：已经成功推送给菜鸟系统的订单，因为各种原因，要取消菜鸟仓销退的。（注意ERP系统操作流程）必须在ERP系统发起订单取消的指定，订单是否取消成功，需要查看ERP系统订单取消的状态，如果ERP系统显示取消成功，该订单菜鸟仓库不会发货。如果ERP系统显示取消失败，说明菜鸟仓这个订单仓库已经操作，系统层面不能取消。是否成功，ERP系统和菜鸟BMS系统可以查看。
3、退货单完成：仓库操作完成之后，销退单在ERP系统状态改变，ERP系统库存增加。
业务流程：
Snip20170327_349.png

业务规则：
1、 那个仓库发货，对应那个仓库做销退。
2、 销退订单创建依赖销售订单的LBX单号、货主。
3、 销退订单的回传信息携带商品的属性（正品、残品），对应的ERP系统需要提前设置对应的仓库。
7、 有货无单销退入库单（销售退货单管理）
业务场景说明

部分包裹退回仓库，但是商家没有收到包裹退回的消息，为了快速处理这种销退订单包裹，由仓库主动在菜鸟系统发起，通知商家在ERP系统创建销退入库单。

业务流程

业务规则

1、 此种业务需要ERP系统对接菜鸟系统有货无单接口。

2、 此种业务对接需要先向业务小二发起申请。

8、库存盘点损益

业务场景说明

商家与菜鸟进行库存盘点，在ERP系统库存与菜鸟系统库存一致的情况下，仓库实物库存出现比系统库存多或比系统库存少的情况下，由菜鸟仓库发起的库存变更。

1、 盘亏单：系统库存大于实物库存的情况，需要减少系统库存的情况下发起的单据。
2、 盘盈单：系统库存小于实物库存的情况，需要增加系统库存的情况下发起的单据

业务流程：

业务规则

1、 盘亏单盘盈单有正品、残品之分。

9、库存调整

业务场景说明：

菜鸟仓库针对商品的属性进行的调整，正品转残品，残品转正品的一种操作。由菜鸟系统发起下发给ERP系统，ERP系统收到之后对商品的属性进行调整。

业务流程

业务规则：

1、 库存调整单有正品、残品之分。

2、 一张库存调整单，对应两个单据，一个商品正品数量的增减，一张是商品残品数量的增减。

3、 库存调整单库存总数不变，只是商品正品的数量和商品残品的数量有调整。

10、SN 序列号管理

业务场景说明

SN码，是商品的流水码。可以说是商品的身份证，用来校验、统计商品。一般3C数码类商品使用比较多。SN码在菜鸟系统归属于商品的一种属性，如果要进行SN码管理，商品信息同步的时候要下发SN码的属性。

1、 SN码的记录：带有SN码的商品，在从菜鸟仓出库的时候，菜鸟系统回返回给ERP系统对应出库的商品的SN码。

2、 当有SN码属性的商品进行销退单入库的时候，在仓库收货完成确认时将SN返回给ERP系统。

业务对接API 接口：

发货单SN通知接口

WMS调用的奇门API名称：taobao.qimen.sn.report

奇门调用ERP的API名称： sn. report

业务流程
业务规则：

1、 目前系统不接收指定SN码出库的功能

2、 SN码单次通知条数是1000条。
11、配送拦截
业务场景说明：

发货订单已经由菜鸟仓库出库，并且已经生成了运单号，回传了ERP系统中。但是由于种种原因，商家要求对发货订单包裹进行拦截的线上单据。

1、 配送拦截成功：配送拦截指令由ERP系统下发，通知快递公司进行拦截，快递公司拦截成功，返回拦截成功的消息给到商家ERP系统
2、 配送拦截失败：配送拦截指令由ERP系统下发，通知快递公司进行拦截，但是快递公司拦截失败，返回拦截失败的消息给到商家ERP系统。
业务流程
业务规则：
1、 该业务场景不是所有订单都可以进行拦截，因为部分快递公司未开通线上拦截的功能

2、 开通该业务需要提前与ERP系统沟通，部分ERP未对接这个功能。

3、部分ERP未对接该功能，但是商家可以登陆BMS系统，发起配送拦截

FAQ

关于此文档暂时还没有FAQ