京东沧海使用手册

背景：

对于使用京东沧海的客户，为了使其能更好的了解和使用已对接的功能，提高管理效率，特此编写本手册，手册包括以下内容：
基本使用流程及注意事项、常见问题汇总。
使用京东沧海，客户必须要有有效的京东店铺，每一个接口的使用都与店铺授权信息密切相关。
如果商家没有京东店铺，可以让客户联系京东销售，申请京麦服务市场白名单，然后使用该账号密码进行正常的拍服务，授权店铺。

功能：与以往的奇门对接的仓库不同，京东沧海的仓库是可以通过下载然后自动在erp中生成仓库的，下载好的仓库的类型为京东沧海 操作位置：设置→基本设置→仓库→左上角仓库下载

注：1.事业部编码由京东方提供，通常为EBU开头 2.下载店铺必须为已授权的京东店铺，如果店铺授权失效，则会影响后续的所有对接业务！ 3.如果客户有自流转仓库，请注意检查系统仓库编码是否与自流转的京东仓库编码重复，为不影响业务，请修改沧海类型系统仓库编码（可追加前缀“WH”或其他编码进行唯一性区分）

京东沧海的物流是可以通过下载把京沧海支持的物流下载到erp中 操作位置：设置→基本设置→仓库→wms物流→下载

①因沧海业务发展需要，新增了冷链增值服务，需要客户指定订单推送需要使用沧海出库的配送产品类型。 操作位置：设置—>基本设置—>物流，选择wms销售类型，点击添加 现京东支持京邦达和京东纯配，选择京东纯配的物流时分【非冷链B2B】和【非冷链B2C】以及【冷链类型】其中冷链类型包括冷链整车、冷链城配、冷链仓储、冷链卡班、冷链生鲜特快、冷链生鲜特惠业务。

注： 1.选择【非冷链B2B】时传给京东沧海的销售出库单jingdong.eclp.order.addOrder ( 销售出库单下发 )之soType==2，且productCode传空值； 2.当选择「非冷链B2C」产品类型的物流公司时，传给京东沧海的销售出库单jingdong.eclp.order.addOrder ( 销售出库单下发 )之soType==1，且productCode传空值； 3.选择冷链中的其中一个soType不传，productCode传正常的值，例如：冷链专车:LL-ZC-M 4.京邦达物流类型不支持冷链等业务

功能：将京东系统中的供应商编号信息维护到旺店通供应商中。 功能位置：设置—>基本设置—>供应商—>添加

注：其中供应商编号是需要京东提供

功能：将京东系统中的店铺编号信息维护到旺店通店铺中。 功能位置：设置—>基本设置—>店铺—>添加（或者是双击店铺）在外部店铺编码中维护京东店铺编码

注：编码通常为ESP开头；淘系平台订单不允许推送至沧海

功能：配置店铺可用的仓库。 功能位置：设置—>策略设置—>选仓策略—>店铺使用仓库

功能：设置哪些员工可以使用京东沧海以及查看货品外仓关系映射。 功能位置：设置—>安全设置—>员工权限—>单击要设置的员工—>仓库

功能位置：设置—>安全设置—>员工权限—>单击要设置的员工—>客户端权限→货品→外仓货品映射

现在旗舰版支持手动维护货品映射（1407版本以上支持）和货品自动映射，在后续推送订单等单据时会根据货品映射关系进行推送（不想收送推送可申请慧策资源：外仓自动推送及更新货品）

功能：将旺店通系统内维护好的货品信息（不包含组合装）推送到京东沧海，使双方系统中货品信息保持一致并正确匹配，我们将货品推送给wms的同时，wms返回的响应中返回wms的这个货品的编码，然后erp会根据他们返回的单号插入我们的映射表中，在推单或者回传的时候会用到映射的关系，如果wms没有返回的话我们会默认将我们的商家编码当成wms编码插入到映射表中

功能位置：库存—>库存管理—>向wms推送

注： （1)如果选中某一条货品则只上传选中的货品，否则上传全部的货品（请谨慎使用上传全部货品，如果一次上传货品过多，会导致客户端卡住）。 （2）推送商品的条码，如果对方系统已存在，则会上传失败，需要使用强制创建将京东货品编码同步到旺店通旗舰版系统中。 映射关系可在货品→外仓货品映射中查看

背景：随着电商不断发展，越来越多的品牌进行线上线下一盘货的库存管理模式（如九阳、得力等）。品牌方对库存进行统一管理，代理商的销售订单统一由品牌方仓库进行发货。 此模式下，代理商的OMS与与品牌方的WMS进行对接时，品牌方WMS不接受代理商的商品编码，因此传统奇门的商品同步机制就会失效，取而代之，需要代理商OMS内部独立完成双方编码的映射，并且所有奇门单据均用WMS的商品编码传送。

①首先慧策资源管理申请‘自定义控制外仓商品同步和映射关系导入’增值服务，开通后查看仓库设置，可看见有两个配置

②其中如果勾选了库存管理中向仓库添加货品之后不允许同步到外仓配置时，库存管理中右键向wms推送后会提示该仓库下的货品不允许同步到外仓，已经同步到外仓的货品可在外仓货品映射页面查看（以界面信息为主）

③勾选了货品-外仓货品映射导入的配置，那么在外仓货品映射页面中可以进行导入操作，可通过导入覆盖之前在库存管理中自动插入的映射，操作导入的员工同时也要有该页面的导入和导出权限（上述员工权限中有图）

注：手动映射的背景是基于wms已经存在了这个货品，不需要我们进行商品同步时可使用

功能：将旺店通系统内维护好的货品信息修改后，推送到京东沧海，使双方系统中货品信息保持一致并正确匹配 功能位置：库存—>库存管理—>向wms推送

注：1）京东只允许更新品牌、条码信息。 2）商品名称如需更新，客户需要发送邮件至京东审批后，方可更新。 3）开启了库存管理中向仓库添加货品配置则不可以在库存管理中做更新操作 4）开启了货品-外仓货品映射导入的配置，可在外仓货品映射导入界面进行修改，可能会有库存管理里的日志记录信息与货品-外仓货品映射的界面信息不一致的情况，以外仓货品映射界面信息为主

一、推送采购单 功能：将旺店通系统中的采购单推送到京东沧海，使其正确处理入库操作。 功能位置：采购—>采购单管理—>右击审核过的采购单—>推送采购单

注：采购单的供应商一定要选取正确，指的是京东沧海的供应商编号，一定要和对方保持一致，否则无法正常下发采购单。

二、取消采购单 功能：通知京东沧海将已经推送到京东沧海且未入库的采购单作废，同时该采购单在旺店通中驳回审核。 功能位置：采购—>采购单管理—>从wms撤回

三、查询采购单（自动） 功能：查询采购单在京东沧海中的流转状态，如果为已完成，则在旺店通中根据实际入库情况进行入库操作。 功能位置：服务器定时自动查询，推送候10分钟查询一次，会根据京东返回的状态情况进行顺延，如果第一次查询的时候京东返回的状态不对，我们会20分钟后在查询一次，即n*10（n为第几次查询），直至返回成功为止

四、查询采购单（手动） 功能：查询采购单在京东沧海中的流转状态，如果为已完成，则在旺店通中根据实际入库情况进行入库操作。 功能位置：采购→采购单管理→右键已经推送的采购单→wms单据查询

五、推送采购退货单 功能：将旺店通系统中的采购退货单推送到京东沧海，使其正确处理出库操作。 功能位置：采购—>采购退货单管理—>右击审核过的采购退货单—>委外操作—>推送采购退货单

六、取消采购退货单（手动） 功能：通知京东仓海将已经推送到京东仓海且未出库的采购退货单作废，同时该采购退货单在旺店通中驳回审核。 功能位置：采购—>采购退货单管理—>右击委外待出库的采购退货单—>从wms撤回

七、查询采购退货单（自动） 功能：查询采购退货单在京东沧海中的流转状态，如果为已出库，则在旺店通中根据实际出库情况进行出库操作。 功能位置：与采购单逻辑一致 八、查询采购退货单（手动） 功能：查询采购单在京东沧海中的流转状态，如果为已完成，则在旺店通中根据实际入库情况进行入库操作。 功能位置：采购→采购单退货管理→右键已经推送的采购退货单→wms单据查询

一、推送销售订单

功能：将旺店通系统中已审核过的订单推送到京东沧海，使其正确处理出库操作。 功能位置：销售出库单中单据在排队中自动推送，右键可以手动推送 注：推送成功后状态会变为WMS已接单，推送失败状态为待处理，具体失败原因可在TAB页中的日志以及异常信息中查看，淘系订单不允许推送至京东沧海（手工建单不计）。 二、取消销售订单（手动）

功能：通知京东沧海将已经推送到京东沧海且未复核的销售订单作废，同时该订单在旺店通中驳回审核。 功能位置：库存—>销售出库单—>右击wms已接单的出库单—>驳回审核

注： 1)订单在京东沧海状态走到已复核时，该订单就无法取消了。 2)该接口涉及的常用业务逻辑为退款操作。退款操作进行的前提为该订单能够取消，由于延迟原因，京东沧海的订单发货状态不能及时同步到旺店通系统中，所以判断该订单能否取消的主要依据就是进行撤销委外出库单操作，如果取消成功，则可以进行退款，如果提示订单无法取消，则不应进行退款，应走退货流程，否则会导致平台已退款，同时订单也发货的情况。 三、取消退款销售订单（自动）

功能：推送到外仓的单子如果触发了订单变更中的配置会自动拦截订单，此时会自动触发取消接口，及时通知京东沧海将已经推送到沧海的销售订单作废，同时该订单在旺店通中驳回审核。 功能位置：订单变更流程图。

四、查询销售订单（自动）

功能：查询订单在京东沧海中的流转状态，如果为已复核，则在旺店通中根据实际发货情况进行出库操作。 功能位置：与采购单查询机制相同上述已说明 注：ERP查询流水，沧海只会响应返回第一个包裹（物流单号）信息，其他的不会返回。因此沧海不支持子母单和多物流模式。

五、推送销售退货单

功能：将旺店通系统中的销售退货单与京东仓海中对应的退货单关联。 功能位置：订单—>退换管理—>右击待推送的销售退货单—>向wms推送

注：京东仓海系统自己创建销售退货单，旺店通中的推送销售退货单仅仅是将系统中的销售退货单与仓海货单创建关联关系。

六、取消销售退货单

功能：在旺店通中将已关联的销售退货单解除关联关系并驳回审核。 功能位置：订单—>退换管理—>右击已推送的销售退货单—>从wms撤回

七、查询销售退货单（自动）

功能：查询销售退货单在京东仓海中的流转状态，如果为已入库，则在旺店通中根据实际入库情况进行入库操作。 功能位置：与采购单查询机制相同上述已说明

在创建非销售出库单的时候，可以先在系统设置中设置下要自动锁定库存类型的单子，避免后续回传的时候提示可用库存不足，目前京东沧海只支持调拨单（京沧海与京沧海仓库之间的调拨）

一、推送调拨单

功能位置：仓储—>货品调拨—>调拨单管理—>右击待推送的调拨单—>向WMS推送

调拨单是可以单独进行推送出库单跟入库单的，现在目前默认自动推送出入库单，并且是默认勾选的，如果在源仓库跟目标仓库都是外仓的情况下可以手动选择推送入库单还是出库单进行判断

注：调拨单是要先出库才能入库，注意调拨单的状态

二、取消调拨单

对于已经推送给wms的调拨单进行取消的话，键点击【向WMS撤回】按钮进行取消。如果成功弹窗提示，会有相应的日志记录；如果失败，提示失败原因，处理方法同上。

撤回同上

注：状态是调拨中的单子不能够进行撤回

三、查询调拨单（自动）

功能：查询调拨单在京东仓海中的流转状态，如果为已出库，则在旺店通中根据实际出库情况进行出库操作，入库同理 功能位置：与采购单查询机制相同上述已说明 注：调拨单没有手动查询的功能