“京东仓海系统”：可以理解为京东的WMS系统，京东工作人员称之为“京云仓”，通过京东的ECLP仓储的接口（类似“奇门”）进行对接。对接后可通过ERP推单给“仓海系统”进行订单商品的出入库。 目前京东仓库订单主要有“京仓”和“京云仓”两种方式，如果和阿里类比，“京仓”的单据类同于阿里强制流转的单据（即“菜鸟BMS”系统处理部分），“京云仓”单据就是通过“奇门”推单的方式。 对接需要召集商家、京东工作人员和万里牛三方一起，在对接过程中需要用户和京东的工作人员提供事业部编码、库房编码、店铺编码和店铺名称等信息需要ERP进行系统配置并测试业务流程，对接后对于出现的异常也需要和京东人员双方配合解决处理。

1. **对接流程概览**

京东仓海对接操作手册 - 图1

一、仓海对接

1.**无京东（自营）店铺对接**

没有京东（自营）店铺的商家也可以入驻京东仓海，已在ERP绑定过京东（自营）店铺跳过该步骤。 1）发送商家的京东ID(卖家ID，最好是老板的)给负责对接的京东商务，由京东商务发邮件到京东总部备份并且开通授权，同时需要授权京东沧海系统。 2） 当商家账户开通授权后，用该账户在京东服务市场，订购万里牛ERP，再在erp中绑定店铺。绑定京东店铺，绑定京东自营（VC）【搜索“京东店铺订购授权及服务确认流程！”查看详情】。该笔订单确认后可申请保证金退款【搜索“保证金退款”查看详情】，注意：授权京东要收取15%的技术服务费。

2.**完善基础信息**

1）新建对接仓 在ERP—基础信息—仓库页面，新增仓库，仓库编码与京东小二提供的保持一致（多个仓库编码新建多个仓库），除编码外的仓库信息自定义维护。

京东仓海对接操作手册 - 图2

2）新建快递公司 在ERP—基础信息—快递公司，新增快递或者修改快递公司编码，快递编码需要找京东小二获取。

京东仓海对接操作手册 - 图3

3）新建供应商 在ERP—基础信息—供应商页面，新增供应商，供应商编码与京东小二提供的保持一致（多个供应商编码新建多个供应商），除编码外的供应商信息自定义维护。

京东仓海对接操作手册 - 图4

2. 推单测试 仓库新建好后，联系万里牛技术进行配置，因仓海的订单推送需要包括商品的三级编码，故配置好后需做好京东分类对应关系方可推单测试。 1）京东分类对应关系 打开商品—京东分类对应关系页面，将系统商品分类与京东分类编码做好对应，若没有正确对应，后期可能导致报错。

京东仓海对接操作手册 - 图5

京东仓海对接操作手册 - 图6

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

二、功能介绍

1.采购 1）万里牛可与仓海对接实现采购业务，目前ERP商品信息同步到仓海系统也是通过新建采购订单的形式实现。在“采购订单”页面下新增采购订单，仓库选择对接仓。

京东仓海对接操作手册 - 图7

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

京东仓海对接操作手册 - 图8

2.销售 1）订单审核 万里牛与京东仓海对接后，系统内的订单都可推送至仓海系统进行打单发货，发货回传后万里牛自动发货出库，线上订单会同时通知线上发货。 向仓海推送订单时，只需在审核环节将订单仓库改成对接仓，确认审核即可。

京东仓海对接操作手册 - 图9

审核之后，订单会异步推送至仓海系统。 2）WMS配货 对接仓的订单审核之后，会流转到“WMS配货”环节，不会再到“打单配货”环节。所以该部分订单不适用常规流程发货，等待仓海发货回传即可。

京东仓海对接操作手册 - 图10

该环节仓海订单有“推送中”、“WMS配货”、“失败”的状态，针对不同状态可以对订单执行打回审核、审核环节复审的操作。

状态：

推送中：订单异步推送仓海系统，还未推送到仓海之前，订单显示“推送中”。该状态订单不允许任何操作。 WMS配货：正常审核后发货前，推送到仓海的订单，订单显示“WMS配货”。配货中的订单可取消（打回审核） 失败：订单推送到仓海报错异常，未返回对应单号，此类订单状态显示“失败”。失败状态的订单，可在操作记录中查看推送失败的原因。根据提示做相应调整后，打回审核环节再重新推送即可。推送订单时，可能会有部分推送不成功，所以对接仓的订单审核之后，需要关注WMS配货中是否有“失败”状态的订单。

操作：

打回审核：将该页面下的订单打回审核环节，同时接口会通知仓海系统撤销订单。如要取消推送到WMS的订单，可执行该操作。 3）售后 在“新建售后单”页面下，新建一笔售后单据，售后类型选择退货或换货，退入仓库选择对接仓。新建完成后，系统会将销售退货单推送给仓海系统，等仓海操作入库后回传，万里牛就会自动新增销售退货单。

京东仓海对接操作手册 - 图11

换货类型的售后单，除了退货入库，换出的商品需要再人工下单，再作为线下订单走销售流程，可推送至仓海再进行发货操作。

tips**：**

1.对接的商品需提前维护好条码字段，且保持两边系统条码唯一且一致。 2.受接口限制：不支持挂起，若有单据仅做测试不发货的需要手动取消，以免造成库存损失。 3.受接口限制：不支持挂起，若有买家线上发起退款的，需要商家手动取消发货，避免给买家同时发货与退款。


三、万里牛对接仓海系统接口列表ERP推送类接口

接口 接口名称
jingdong.eclp.goods.transportGoodsInfo 添加主商品信息
jingdong.eclp.po.cancalPoOrder 采购单取消
jingdong.eclp.po.queryPoOrder 采购入库单详情查询
jingdong.eclp.stock.queryStock 仓库实物库存查询
jingdong.eclp.order.addOrder 销售出库单下发
jingdong.eclp.order.cancelOrder 出库单取消接口
jingdong.eclp.order.queryOrder 销售出库单明细查询
jingdong.eclp.rtw.transportRtw 退货入库单下发
jingdong.eclp.rtw.queryRtw 退货入库单详情查询
jingdong.eclp.goods.queryGoodsSerial 查询出入库序列号
jingdong.eclp.serial.queryPageSerialByBillNo 根据订单号查询
序列号
jingdong.eclp.serial.queryInStockSIDBySku 在库序列号查询
jingdong.eclp.po.addPoSidDetail 采购入库单传序列
号清单
jingdong.eclp.po.addPoOrder 采购入库单下发
==========FAQ========== 1.我有2个仓海系统怎么对接？ 目前1个ERP公司仅支持对接1个仓海事业部，您可以选择其中一个事业部来进行对接。 2.库存两边不一致了怎么办？ 系统每天中午、晚上（12：30、00：30）会获取仓海系统库存进行全量盘点，差异部分库存会生成盘点单作为记录凭证以供查询。 3.支持普通仓库与京云仓的调拨业务吗？ 目前京东仓海接口只支持云仓之间的调拨。