文档中心 > ERP对接方案管理

架海金梁对接指南

更新时间:2019/06/11 访问次数:3829

 

1、 业务场景

天猫快消、美妆、服饰行业强控体系的解决方案 

2、 方案说明

2.1 商家仓+菜鸟仓

2.1.1 业务功能流程

2.1.2 业务场景要求说明

1.商家仓由ERP管理发货

2.菜鸟仓淘系渠道(BMS发货商家)订单只能BMS发货,菜鸟仓非淘订单由ERP发货

3.商家ERP依然从聚石塔获取交易订单,但上会有订单禁止发货状态,订单会经过BMS优先处理进行绑赠和路由后,进行修改

  1. ERP从聚石塔获取订单消息中状态为等待卖家发货时解析新增的物流发货结构体中的子订单维度有菜鸟仓发货标

6.商家仓的库存由ERP通过OIC提供的新接口进行库存更新

7.小二需要在小二工作台设置仓库路由模板进行发货路由规则设定

8.订单的路由规则只有仓库覆盖范围和仓库优先级设定(小二设置)

9.该模式下的商家ERP将无法通过奇门接口对菜鸟仓下发淘系订单销售发货的相关指令(普通发货,换货发货,补发);

10.菜鸟仓的出库单、入库单、盘点单全部经过BMS同步给ERP结果,ERP无法创建相关单据(本期暂不定义为P0级需求)

11.淘系由菜鸟仓发货的订单,正向和逆向所有的管控流程全部在BMS内完成,ERP只是感知到最终的结果。

12.一个营销活动只能由BMS或ERP一方承接,ERP管理的活动只能由商家仓发货,BMS管理的活动可以商家仓和菜鸟仓都发货。

13.销退入库是谁发货谁管理:BMS管理菜鸟仓,ERP管理商家仓和非淘渠道交易订单的销退入库

2.1.3 ERP改造方案说明

  1. 货品信息的同步由手动变更为自动(一码多品暂不支持,同步失败,ERP修改条形码和商家编码为唯一值后重试)
  2. 宝贝库存同步变更为商家仓货品库存同步,接口参见接口说明3.11
  3. ISV根据JST的数据结果将需要商家仓发货的订单进行处理:

   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)信息。

2.1.4 中台内部改造方案说明

JST的订单数据需求(交易订单结构体的定义春节之前在TOP完成修改)

  1. JST订单主表中,订单状态增加禁止发货的标示
  2. 子订单维度新增菜鸟仓发货和商家仓发货标
  3. 新增物流发货结构,数据定义如下:

字段名

类型

说明

交易号

 

TB主交易号

子交易号

 

TB 子交易号

宝贝ID

 

 

SKUID

 

 

ItemID

 

货品菜鸟仓储ID

Itemcode

 

货品商家ERP系统内的ID

菜鸟仓发货标

 

CN=菜鸟发货,SC的商家仓发货

应发数量

 

订单应发数量

发货仓库

 

如是菜鸟仓,则将菜鸟仓的区域仓code进行填充,如是商家仓发货则填充“SC”

类型

 

标示该子交易是交易上就有的,还是BMS增加的,枚举值(00=交易,10=BMS绑定)

  1. BMS绑赠取消接口
  • 接口的触发条件:交易订单菜鸟仓发货的部分除该赠品外全部发货完毕,且该赠品后续也不会再发货;
  • 接口数据说明:

字段名

类型

说明

主交易号

string

 

子交易号

string

 

状态

 

枚举值:00=取消

该接口一次只能回传一个主交易号的BMS增加的货品取消信息

   

触发条件:主交易号下面所有未取消的菜鸟仓发货明细全部出库完成

   
  1. 商家仓货品库存同步接口

新增接口,参见3.11

  1. 销售发货确认接口改造
    ERP感知子交易单的发货状态,发货类型

交易订单菜鸟仓完全发货的解决方案—待确认

非API字段需求

  1. ERP数据交互时ERPID字段采用ISV账套ID+BMSID组合而成
  2. 销售发货的物流单查询接口增加通过主交易号和子交易号进行订单发货信息查询的条件
  3. 销退入库单的查询接口增加通过主交易号和子交易号进行销退入库单信息查询的条件

 

 

3、 接口说明

3.1 普通B2C聚石塔订单获取接口

3.1.1接口说明:

商家获取普通B2C淘宝平台交易订单明细的接口

3.1.2接口名称

taobao.trade.fullinfo.get (获取单笔交易的详细信息)

3.1.3 接口链接:

//open.taobao.com/docs/api.htm?spm=a219a.7629065.0.0.F1kNvJ&apiId=54

3.1.4 接口说明

1.该接口中新增了一个名为logistics_infos的结构体,里面有BMS审单分仓之后的结果

2.该接口的trade_attr字段中增加erpHold标:-1=异常,0=非强管控,1=强管控中,2=分单完成;强管控的商家如果erpHold标=-1时,表明订单出现漏标问题,请ISV不要处理该订单,该订单BMS处理完成后erpHold标将直接变成2。

 

3.2 菜鸟货品创建接口

3.2.1 接口说明

商家通过ERP调用该接口可以创建的菜鸟的货品信息

接口名称:

ERP调用的奇门API名称:taobao.qimen.singleitem.synchronize

奇门调用WMS的API名称:singleitem.synchronize

3.2.2 接口链接:taobao.qimen.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

3.1.3 注意事项

暂无

3.3菜鸟货品查询接口

3.3.1 接口说明

商家通过ERP调用该接口可以查询商家在菜鸟的货品信息

接口名称:

ERP调用的奇门API名称:taobao.qimen.singleitem.query

奇门调用WMS的API名称:singleitem.query

3.3.2 接口链接:taobao.qimen.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

3.3.3 注意事项

暂无

3.4组合货品创建接口

3.4.1 接口说明

商家通过ERP调用该接口创建菜鸟组合货品的关系

接口名称:

ERP调用的奇门API名称:taobao.qimen.combineitem.synchronize

奇门调用WMS的API名称:combineitem.synchronize

3.4.2 接口链接:taobao.qimen.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

3.4.3 注意事项

暂无

3.5组合货品查询接口

3.5.1 接口说明

商家通过ERP调用该接口查询组合货品在菜鸟的信息

接口名称:

ERP调用的奇门API名称:taobao.qimen. combineitem.query

奇门调用WMS的API名称:combineitem.query

3.5.2 接口链接:taobao.qimen. 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

3.5.3 注意事项

暂无

3.6组合货品删除接口

3.6.1 接口说明

商家通过ERP调用该接口删除组合货品在菜鸟的信息

接口名称:

ERP调用的奇门API名称:taobao.qimen.combineitem.delete

奇门调用WMS的API名称:combineitem.delete

3.6.2 接口链接:taobao.qimen.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

3.6.3 注意事项

暂无

3.7发货单确认接口

3.7.1 接口说明

菜鸟仓库出库单发货完成后, 把出库单和包裹信息回传给ERP, ERP自行决定如何处理

接口名称:待定

3.7.2 参考接口链接:deliveryorder.confirm

线上地址:http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.94smkF&apiId=deliveryorder.confirm&type=cainiao_warehouse_qimen

3.7.3 注意事项

1.自动发货的订单由于是交易直接通知菜鸟发货,deliveryOrderCode字段已经不能作为ERP判断的条件,ERP只能根据orderSourceCode字段进行数据的校验

2.接受发货确认之后的交易更新逻辑,按照现有的ISV的逻辑不发生任何变化

3.该接口中会增加一个个性化字段BmsOrderType,促销赠品=01
交易赠品= 02,手工录入赠品=03;交易正品=04;手工录入正品= 05

4.由于物流订单存在合单现象,如果ERP的体系不支持补发单或换发单和交易订单一起发货的场景,需要和客服小二说明,BMS支持补发和换发的物流单和正常的交易物流单合单发货的

5.大小电以及美家的商家的订单发货确认接口也是通过该接口进行回传

 

3.8 BMS发货订单退货单确认接口

3.8.1 接口说明

商家通过该接口接收BMS发货订单收货到仓的数据

接口名称:

3.8.2 接口名称:taobao.qimen.auto.returnorder.confirm

使用场景供应链中台与ERP对接

奇门个性化场景,授权后可获取

3.8.3 注意事项

1.该接口回传的是所有由BMS发货的订单的销退入库信息,由ERP发货的销退入库信息依然使用奇门标准的销退入库单进行数据获取。

3.9入库单确认回传

3.9.1 接口说明

菜鸟通过该接口回传ERP菜鸟仓入库单信息

3.9.2 参考接口链接:

线上地址:http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.8dD3Am&apiId= entryorder.confirm&type=cainiao_warehouse_qimen

3.9.3 注意事项

1.该接口承载普通出库单和一盘货的入库单,一盘货的入库单的单据类型为CJBHRK

2.一盘货的ERP处理业务逻辑需要商家和ERP进行确认,一盘货主要是用来解决商家的天猫旗舰店货主和猫超货主之间如何进行一盘货销售的问题

 

3.10出库单确认回传

3.10.1 接口说明

菜鸟通过该接口回传ERP菜鸟仓出库单信息

3.10.2 参考接口链接:

线上地址:http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.8dD3Am&apiId= stockout.confirm&type=cainiao_warehouse_qimen

3.10.3 注意事项

1.该接口承载普通出库单和一盘货的出库单,一盘货的出库单的单据类型为CJBHCK

2.一盘货的ERP处理业务逻辑需要商家和ERP进行确认,一盘货主要是用来解决商家的天猫旗舰店货主和猫超货主之间如何进行一盘货销售的问题

 

3.11商家仓库存回传

3.11.1 接口说明

ERP通过该接口回传商家货品总库存

接口名称:
cainiao.merchant.inventory.adjust

3.11.2 接口定义:

该接口TOP授权之后,ISV可以在后台查看文档。主要字段描述如下:

字段名

类型

说明

货主

 

TB主交易号

商家仓code

 

TB 子交易号

ItemID

 

货品菜鸟仓储ID

Itemcode

 

货品商家ERP系统内的ID

货品库存

 

订单应发数量

库存类型

 

ZP=正品,CC=残次。

 

3.11.3 注意事项

1.该接口只支持全量的库存更新,不支持增量库存更新

2.该接口调用的时候需要将货主店铺的session来进行接口调用

3.12分销B2C聚石塔订单获取接口

3.12.1接口说明:

商家获取分销B2C淘宝平台交易订单明细的接口

3.12.2接口名称:

taobao.trade.fullinfo.get (查询采购单信息)

3.12.3 接口链接:

//open.taobao.com/docs/api.htm?spm=a219a.7386797.0.0.PcRVBy&source=search&apiId=180

3.12.4 接口说明

该接口中新增了一个名为logistics_infos的结构体,里面有BMS审单分仓之后的结果,该结构体的模式可以参考3.1普通B2C聚石塔订单获取接口的信息

3.13出库单创建回推接口

3.13.1接口说明:

商家出库单创建后回推ERP,ERP进行库存预占

3.13.2接口名称:

奇门个性化接口(使用场景供应链中台与ERP对接):

qimen.taobao.icp.order.stockoutordermessagetoerp

3.13.3 接口链接:

奇门内部链接,授权后可查看

3.13.4 接口说明

1.该接口承载普通出库单和一盘货的出库单,一盘货的出库单的单据类型为CJBHCK

2.一盘货的ERP处理业务逻辑需要商家和ERP进行确认,一盘货主要是用来解决商家的天猫旗舰店货主和猫超货主之间如何进行一盘货销售的问题

3.14出库单创建取消通知接口

3.14.1接口说明:

商家出库单创建后回推ERP,ERP进行库存预占

3.14.2接口名称:

奇门个性化接口(使用场景供应链中台与ERP对接):

taobao.qimen.auto.entryorder.giftitemcancel

3.14.3 接口链接:

奇门内部链接,授权后可查看

3.14.4 接口说明

3.15架海金梁订单取消发货确认接口

3.15.1接口说明:

架海金梁商家订单取消商家仓发货确认接口

3.15.2接口名称:

奇门官方场景接口: qimen.taobao.bms.erptrade.intercept

3.15.3 接口链接:

https://open.taobao.com/api.htm?docId=38418&docType=2

3.15.4 接口说明

1.该接口用于BMS通知ERP取消商家仓发货的订单;

2.接口使用场景:前端交易发起退款申请、菜鸟仓和商家仓互转、赠品绑赠异常处理、库存路由异常

2.type目前只有仓拦截一种情况,商家仓发货的订单明细,在回传交易前端发货之前默认拦截类型都为仓拦截,回传之后,不会对ERP发起拦截指定(因网络延时引起的状态问题,ERP以自己体系内的状态为准,如ERP体系内是商家仓已出库状态,该接口返回失败)

3.当取消通知中只有主交易号时,ERP必须将该主交易号对应的所有商家仓的发货全部取消才能返回成功,否则返回失败(必须是全部成功或全部失败,部分失败部分成功等于全部失败)

  1. 当取消通知中有主交易号和子交易号信息时,ERP必须将该子交易号对应的所有商家仓的发货全部取消才能返回成功,否则返回失败(必须是全部成功或全部失败,部分失败部分成功等于全部失败)

3.16菜鸟仓商家仓互转接口

3.16.1接口说明:

架海金梁商家订单取消商家仓发货确认接口

3.16.2接口名称:

奇门官方场景接口: qimen.taobao.bms.erptrade.transferconsign 

3.16.3 接口链接:

https://open.taobao.com/api.htm?docId=38426&docType=2

3.16.4 接口说明

1.该接口用于架海金梁订单菜鸟仓发货和商家仓发货之间相互转换的问题;

  1. store_code字段中的仓库是订单需要修改的结果仓库

3.当通知ERP修改信息时,ERP必须将通知中所有子交易号对应的所有发货仓库修改成功,否则返回失败(必须是全部成功或全部失败,部分失败部分成功等于全部失败)

3.17菜鸟仓发货交易订单信息回传接口

3.17.1接口说明:

架海金梁商家订单菜鸟仓发货信息回传

3.17.2接口名称:

奇门官方场景接口: qimen.taobao.bms.trade.consign  

3.17.3 接口链接:

https://open.taobao.com/api.htm?docId=38427&docType=2

3.17.4 接口说明

1.该接口用于架海金梁订单菜鸟仓全部发货完成后通知ERP关单使用;

2.该订单是以交易号的维度回传ERP,菜鸟仓发货的订单全部的状态,回传信息,该交易单关闭,可以进行财务等相关处理;

3.该接口和发货确认接口之间可能存在乱序的问题,需要ERP先将该接口的数据进行存储,后续再进行处理。

 

3.18菜鸟仓间调拨信息回传接口

3.18.1接口说明:

由菜鸟系统发起菜鸟仓间的调拨,通过奇门根据调拨单号分3次回传ISV或者商家ERP系统,ERP系统接收指令之后,更新ERP系统的库存。(调拨单创建成功一次,全部出库回传一次,全部入库回传一次,全部入库代表调拨单已经作业完毕)

 

3.18.2接口名称:

奇门官方场景接口: transferorder.report  

3.18.3 接口链接:

http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.M9KUfZ&apiId=transferorder.report&type=cainiao_warehouse_qimen

3.18.4 接口说明

1、菜鸟回传的出库数量和入库数量有可能不一致,需要ERP系统正常接收

2、菜鸟回传的入库单数量有正品、残品,需要ERP系统正常接收,并在ERP系统能够正常区分,分别计算对应的库存

3、调拨生成的差异数量需要ERP系统中有展示,这部分差异数据,由菜鸟小二与商家进行线下核对,ERP系统要有针对这些差异进行导出的功能。

4.菜鸟回传的时候只会有调拨主单号,调拨子单号不会回传;

5.菜鸟回传调拨确认会有3次回传,一次是调拨单创建,一次是出库确认回传,一次是入库确认回传

 出库确认回传在入库确认回传之前。

3.19菜鸟作业信息查询接口(非必选接口)

3.19.1接口说明:

菜鸟发货单状态信息查询

3.19.2接口名称:

奇门官方场景接口: taobao.qimen.orderprocess.query  

3.19.3 接口链接:

http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.bjLNth&apiId=taobao.qimen.orderprocess.query

3.19.4 接口说明

1.ERP接收到菜鸟的相关作业单据后,可以同该接口查询相关的单据作业状态和关键节点的信息

 

4、 供应链场景对接指南

4.1菜鸟仓间主动调拨

     使用3.18的接口进行支持,只要ERP对接了3.18接口,菜鸟就可以对商家进行主动调拨业务

4.2一盘货

     使用3.9和3.10的接口进行支持,只要ERP对接了3.9和3.10接口,ERP可以正确接收一盘货的出入库单据的流水。

     单据流水如何使用需要ERP和商家进行产品流程的确认

4.3中台补货计划

     使用3.9和3.10的接口进行支持,只要ERP对接了3.9和3.10接口,ERP可以正确接收中台供应链体系的出入库单。

     相关单据的流水可以按照正常的出入库单的流水进行处理

 

 

 

FAQ

关于此文档暂时还没有FAQ
返回
顶部