天猫快消、美妆、服饰行业强控体系的解决方案
1.商家仓由ERP管理发货
2.菜鸟仓淘系渠道(BMS发货商家)订单只能BMS发货,菜鸟仓非淘订单由ERP发货
3.商家ERP依然从聚石塔获取交易订单,但上会有订单禁止发货状态,订单会经过BMS优先处理进行绑赠和路由后,进行修改
6.商家仓的库存由ERP通过OIC提供的新接口进行库存更新
7.小二需要在小二工作台设置仓库路由模板进行发货路由规则设定
8.订单的路由规则只有仓库覆盖范围和仓库优先级设定(小二设置)
9.该模式下的商家ERP将无法通过奇门接口对菜鸟仓下发淘系订单销售发货的相关指令(普通发货,换货发货,补发);
10.菜鸟仓的出库单、入库单、盘点单全部经过BMS同步给ERP结果,ERP无法创建相关单据(本期暂不定义为P0级需求)
11.淘系由菜鸟仓发货的订单,正向和逆向所有的管控流程全部在BMS内完成,ERP只是感知到最终的结果。
12.一个营销活动只能由BMS或ERP一方承接,ERP管理的活动只能由商家仓发货,BMS管理的活动可以商家仓和菜鸟仓都发货。
13.销退入库是谁发货谁管理:BMS管理菜鸟仓,ERP管理商家仓和非淘渠道交易订单的销退入库
1)菜鸟仓商家仓发货标示;
2)物流发货信息的解析:BMS绑赠识别,交易宝贝发货货品解析
4.前端宝贝与后端货品的对应关系需要在BMS完成,ERP通过现有的店铺TOP接口获取数据(宝贝的商家编码填入货品菜鸟接口中的itemcode,ISV通过该字段用来获取菜鸟的货品ID与宝贝ID之间的绑定关系);
5.交易订单的子订单发货商品需要更改时,客服需要先进入BMS确认子订单行的确认是菜鸟仓发货还是商家仓发货,菜鸟仓发货子订单由BMS负责修改,商家仓发货的子订单进入ERP修改,BMS修改后的最终结果通过发货的接口推送ERP感知最终的发货结果
6.交易订单的取消,商家仓的由ERP负责,菜鸟仓的由BMS负责(该点对于客服的操作挑战比较大,需要业务方和商家沟通确认)-业务同意
7.BMS发货的销售订单发货确认(普通发货,换发,补发)ERP接收修改说明:
1)发货确认中ERP根据子交易单号进行交易单发货状态的变更;
2)部分发货和缺货发货场景不作为本次的需求之列;
3)交易订单和物流发货单的实际扣减库存的货品和数量以菜鸟仓回传的为准;
4) ERP只能依赖货主+交易单号进行数据是否合法的校验,不能再通过ERPID进行数据的可信赖判断;
5)补发的场景下,ERP如发现发货的交易单号无法识别时,只能通过货主ID进行判断, 一旦货主ID校验通过,ERP会创建无法匹配关系的补发单进行处理。
8.BMS发货订单的销退入库单,ERP信赖中台通过销退入库单回传的接口进行数据补全,中台回传的信息中必须要有交易单号和子单号,以及货品(itemID,itemcode)信息。
JST的订单数据需求(交易订单结构体的定义春节之前在TOP完成修改)
字段名 |
类型 |
说明 |
交易号 |
TB主交易号 |
|
子交易号 |
TB 子交易号 |
|
宝贝ID |
|
|
SKUID |
|
|
ItemID |
货品菜鸟仓储ID |
|
Itemcode |
货品商家ERP系统内的ID |
|
菜鸟仓发货标 |
|
CN=菜鸟发货,SC的商家仓发货 |
应发数量 |
订单应发数量 |
|
发货仓库 |
如是菜鸟仓,则将菜鸟仓的区域仓code进行填充,如是商家仓发货则填充“SC” |
|
类型 |
标示该子交易是交易上就有的,还是BMS增加的,枚举值(00=交易,10=BMS绑定) |
字段名 |
类型 |
说明 |
主交易号 |
string |
|
子交易号 |
string |
|
状态 |
枚举值:00=取消 |
|
该接口一次只能回传一个主交易号的BMS增加的货品取消信息 |
||
触发条件:主交易号下面所有未取消的菜鸟仓发货明细全部出库完成 |
新增接口,参见3.11
交易订单菜鸟仓完全发货的解决方案—待确认
非API字段需求
商家获取普通B2C淘宝平台交易订单明细的接口
taobao.trade.fullinfo.get (获取单笔交易的详细信息)
//open.taobao.com/docs/api.htm?spm=a219a.7629065.0.0.F1kNvJ&apiId=54
1.该接口中新增了一个名为logistics_infos的结构体,里面有BMS审单分仓之后的结果
2.该接口的trade_attr字段中增加erpHold标:-1=异常,0=非强管控,1=强管控中,2=分单完成;强管控的商家如果erpHold标=-1时,表明订单出现漏标问题,请ISV不要处理该订单,该订单BMS处理完成后erpHold标将直接变成2。
商家通过ERP调用该接口可以创建的菜鸟的货品信息
接口名称:
ERP调用的奇门API名称:taobao.qimen.singleitem.synchronize
奇门调用WMS的API名称:singleitem.synchronize
线上地址:http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.94smkF&apiId=taobao.qimen.singleitem.synchronize&type=cainiao_warehouse_qimen
暂无
商家通过ERP调用该接口可以查询商家在菜鸟的货品信息
接口名称:
ERP调用的奇门API名称:taobao.qimen.singleitem.query
奇门调用WMS的API名称:singleitem.query
线上地址:http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.94smkF&apiId=taobao.qimen.singleitem.query&type=cainiao_warehouse_qimen
暂无
商家通过ERP调用该接口创建菜鸟组合货品的关系
接口名称:
ERP调用的奇门API名称:taobao.qimen.combineitem.synchronize
奇门调用WMS的API名称:combineitem.synchronize
线上地址:http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.94smkF&apiId=taobao.qimen.combineitem.synchronize&type=cainiao_warehouse_qimen
暂无
商家通过ERP调用该接口查询组合货品在菜鸟的信息
接口名称:
ERP调用的奇门API名称:taobao.qimen. combineitem.query
奇门调用WMS的API名称:combineitem.query
线上地址:http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.94smkF&apiId=taobao.qimen.combineitem.query&type=cainiao_warehouse_qimen
暂无
商家通过ERP调用该接口删除组合货品在菜鸟的信息
接口名称:
ERP调用的奇门API名称:taobao.qimen.combineitem.delete
奇门调用WMS的API名称:combineitem.delete
线上地址:http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.94smkF&apiId=taobao.qimen.combineitem.delete&type=cainiao_warehouse_qimen
暂无
菜鸟仓库出库单发货完成后, 把出库单和包裹信息回传给ERP, ERP自行决定如何处理
接口名称:待定
线上地址:http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.94smkF&apiId=deliveryorder.confirm&type=cainiao_warehouse_qimen
1.自动发货的订单由于是交易直接通知菜鸟发货,deliveryOrderCode字段已经不能作为ERP判断的条件,ERP只能根据orderSourceCode字段进行数据的校验
2.接受发货确认之后的交易更新逻辑,按照现有的ISV的逻辑不发生任何变化
3.该接口中会增加一个个性化字段BmsOrderType,促销赠品=01
交易赠品= 02,手工录入赠品=03;交易正品=04;手工录入正品= 05
4.由于物流订单存在合单现象,如果ERP的体系不支持补发单或换发单和交易订单一起发货的场景,需要和客服小二说明,BMS支持补发和换发的物流单和正常的交易物流单合单发货的
5.大小电以及美家的商家的订单发货确认接口也是通过该接口进行回传
商家通过该接口接收BMS发货订单收货到仓的数据
接口名称:
使用场景供应链中台与ERP对接
奇门个性化场景,授权后可获取
1.该接口回传的是所有由BMS发货的订单的销退入库信息,由ERP发货的销退入库信息依然使用奇门标准的销退入库单进行数据获取。
菜鸟通过该接口回传ERP菜鸟仓入库单信息
线上地址:http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.8dD3Am&apiId= entryorder.confirm&type=cainiao_warehouse_qimen
1.该接口承载普通出库单和一盘货的入库单,一盘货的入库单的单据类型为CJBHRK
2.一盘货的ERP处理业务逻辑需要商家和ERP进行确认,一盘货主要是用来解决商家的天猫旗舰店货主和猫超货主之间如何进行一盘货销售的问题
菜鸟通过该接口回传ERP菜鸟仓出库单信息
线上地址:http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.8dD3Am&apiId= stockout.confirm&type=cainiao_warehouse_qimen
1.该接口承载普通出库单和一盘货的出库单,一盘货的出库单的单据类型为CJBHCK
2.一盘货的ERP处理业务逻辑需要商家和ERP进行确认,一盘货主要是用来解决商家的天猫旗舰店货主和猫超货主之间如何进行一盘货销售的问题
ERP通过该接口回传商家货品总库存
接口名称:
cainiao.merchant.inventory.adjust
该接口TOP授权之后,ISV可以在后台查看文档。主要字段描述如下:
字段名 |
类型 |
说明 |
货主 |
TB主交易号 |
|
商家仓code |
TB 子交易号 |
|
ItemID |
货品菜鸟仓储ID |
|
Itemcode |
货品商家ERP系统内的ID |
|
货品库存 |
订单应发数量 |
|
库存类型 |
ZP=正品,CC=残次。 |
1.该接口只支持全量的库存更新,不支持增量库存更新
2.该接口调用的时候需要将货主店铺的session来进行接口调用
商家获取分销B2C淘宝平台交易订单明细的接口
taobao.trade.fullinfo.get (查询采购单信息)
//open.taobao.com/docs/api.htm?spm=a219a.7386797.0.0.PcRVBy&source=search&apiId=180
该接口中新增了一个名为logistics_infos的结构体,里面有BMS审单分仓之后的结果,该结构体的模式可以参考3.1普通B2C聚石塔订单获取接口的信息
商家出库单创建后回推ERP,ERP进行库存预占
奇门个性化接口(使用场景供应链中台与ERP对接):
qimen.taobao.icp.order.stockoutordermessagetoerp
奇门内部链接,授权后可查看
1.该接口承载普通出库单和一盘货的出库单,一盘货的出库单的单据类型为CJBHCK
2.一盘货的ERP处理业务逻辑需要商家和ERP进行确认,一盘货主要是用来解决商家的天猫旗舰店货主和猫超货主之间如何进行一盘货销售的问题
商家出库单创建后回推ERP,ERP进行库存预占
奇门个性化接口(使用场景供应链中台与ERP对接):
taobao.qimen.auto.entryorder.giftitemcancel
奇门内部链接,授权后可查看
架海金梁商家订单取消商家仓发货确认接口
奇门官方场景接口: qimen.taobao.bms.erptrade.intercept
https://open.taobao.com/api.htm?docId=38418&docType=2
1.该接口用于BMS通知ERP取消商家仓发货的订单;
2.接口使用场景:前端交易发起退款申请、菜鸟仓和商家仓互转、赠品绑赠异常处理、库存路由异常
2.type目前只有仓拦截一种情况,商家仓发货的订单明细,在回传交易前端发货之前默认拦截类型都为仓拦截,回传之后,不会对ERP发起拦截指定(因网络延时引起的状态问题,ERP以自己体系内的状态为准,如ERP体系内是商家仓已出库状态,该接口返回失败)
3.当取消通知中只有主交易号时,ERP必须将该主交易号对应的所有商家仓的发货全部取消才能返回成功,否则返回失败(必须是全部成功或全部失败,部分失败部分成功等于全部失败)
架海金梁商家订单取消商家仓发货确认接口
奇门官方场景接口: qimen.taobao.bms.erptrade.transferconsign
https://open.taobao.com/api.htm?docId=38426&docType=2
1.该接口用于架海金梁订单菜鸟仓发货和商家仓发货之间相互转换的问题;
3.当通知ERP修改信息时,ERP必须将通知中所有子交易号对应的所有发货仓库修改成功,否则返回失败(必须是全部成功或全部失败,部分失败部分成功等于全部失败)
架海金梁商家订单菜鸟仓发货信息回传
奇门官方场景接口: qimen.taobao.bms.trade.consign
https://open.taobao.com/api.htm?docId=38427&docType=2
1.该接口用于架海金梁订单菜鸟仓全部发货完成后通知ERP关单使用;
2.该订单是以交易号的维度回传ERP,菜鸟仓发货的订单全部的状态,回传信息,该交易单关闭,可以进行财务等相关处理;
3.该接口和发货确认接口之间可能存在乱序的问题,需要ERP先将该接口的数据进行存储,后续再进行处理。
由菜鸟系统发起菜鸟仓间的调拨,通过奇门根据调拨单号分3次回传ISV或者商家ERP系统,ERP系统接收指令之后,更新ERP系统的库存。(调拨单创建成功一次,全部出库回传一次,全部入库回传一次,全部入库代表调拨单已经作业完毕)
奇门官方场景接口: transferorder.report
http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.M9KUfZ&apiId=transferorder.report&type=cainiao_warehouse_qimen
1、菜鸟回传的出库数量和入库数量有可能不一致,需要ERP系统正常接收
2、菜鸟回传的入库单数量有正品、残品,需要ERP系统正常接收,并在ERP系统能够正常区分,分别计算对应的库存
3、调拨生成的差异数量需要ERP系统中有展示,这部分差异数据,由菜鸟小二与商家进行线下核对,ERP系统要有针对这些差异进行导出的功能。
4.菜鸟回传的时候只会有调拨主单号,调拨子单号不会回传;
5.菜鸟回传调拨确认会有3次回传,一次是调拨单创建,一次是出库确认回传,一次是入库确认回传
出库确认回传在入库确认回传之前。
菜鸟发货单状态信息查询
奇门官方场景接口: taobao.qimen.orderprocess.query
http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.bjLNth&apiId=taobao.qimen.orderprocess.query
1.ERP接收到菜鸟的相关作业单据后,可以同该接口查询相关的单据作业状态和关键节点的信息
使用3.18的接口进行支持,只要ERP对接了3.18接口,菜鸟就可以对商家进行主动调拨业务
使用3.9和3.10的接口进行支持,只要ERP对接了3.9和3.10接口,ERP可以正确接收一盘货的出入库单据的流水。
单据流水如何使用需要ERP和商家进行产品流程的确认
使用3.9和3.10的接口进行支持,只要ERP对接了3.9和3.10接口,ERP可以正确接收中台供应链体系的出入库单。
相关单据的流水可以按照正常的出入库单的流水进行处理