评价
(272) (259)

√ 已支持 × 不支持 ○ 开发中或排期中 ∼ 联调中

吉客云仓储接口详解

(所属仓库编码JKY)

序号 接口类别 接口名称 重要功能 联调状态 备注 注意事项
1 商品信息 新增 联调时商品名称里添加<、>、'、“、& 五个字符(注意是英文字符)中的几个做测试,查看WMS能否正常处理,是否和旺店通显示一致
WMS存在商品则更新(必须支持) ERP给WMS推送商品的时候,WMS如果存在商品,则会执行更新操作
多条码 × WMS一物一码 联系研发开配置,我们会以;来拼接,例(123456;236548;259784)
多商品类型 联系研发开配置,itemType字段,销售货品 传 ZC,包装物 传 BC,虚拟货品 传 XN,其他类型传 OTHER,不开启配置,统一传ZC
更新
更新条码 需要测试一种情况:开始A货品对应a条码,B货品对应b条码。然后将A货品改成b条码,B货品改成a条码,再次推送。查看是否可以。
2 采购单 推送 核实WMS返回单号长度ID是否超过40
去重处理 RH179 推送成功手动再次推送即可
取消 取消分两种:出库前取消(WMS没有出库时ERP取消);出库后回传前取消(模拟回传失败或者异步回传的情况)
入库
邮资回传 × WMS不支持 采购单邮资回传指freight字段,erp会将邮资分摊到成本价上面,erp端需要开启配置,测试小伙伴只需要关注wms能否回传freight字段即可
全部入库
部分入库 举例,下发10个商品,wms入库回传5个商品,就是 部分入库
分批入库 wms分批入库不可包含残次品
批次入库 指batch节点,包括批次号,生产日期,有效期等字段
残品入库 wms回传商品标识为残次品
3 采购退货单 推送 核实WMS返回单号长度ID是否超过40
去重处理 推送成功手动再次推送即可
取消 取消分两种:出库前取消(WMS没有出库时ERP取消);出库后回传前取消(模拟回传失败或者异步回传的情况)
出库
全部出库
部分出库 × WMS不支持 举例,下发10个商品,wms出库回传5个商品,就是 部分出库
分批出库 × WMS不支持 <confirmType>0 表示出库单最终状态;1 表示出库单中间状态;举例,下发10个商品,wms先出库回传5个商品,再出库回传5个,就是分批出库,即多次出库
批次出库 × WMS不支持 指batch节点,包括批次号,生产日期,有效期等字段
残品出库 × WMS不支持 wms回传商品标识为残次品
4 销售订单 推送 核实WMS返回单号长度ID是否超过40
去重处理 校验wms是否有去重机制,我们推送成功后,手动修改状态为失败后,重新推送一次,测试小伙伴可以联系研发协助
相同商品多行明细 × WMS不支持 指添加赠品,需要开配置
多平台 指淘宝,京东,测试联调推我们不同店铺即可
货到付款 × WMS不支持
指定物流 需要测试一种情况:wms回传的物流公司及单号与erp推送的物流公司不相同
不指定物流
发票 - WMS开发中
取消 取消分两种:出库前取消(WMS没有出库时ERP取消);出库后回传前取消(模拟回传失败或者异步回传的情况)
出库
单物流单号
多物流单号
批次回传
包材信息 ×
wms回传重量 计算邮资 需确认wms是否回传实际发货重量
预同步物流 × 旗舰版ERP暂不支持 只和旺店通WMS联调用,仓储真实发货前将物流信息同步到平台,订制业务,无特殊要求可以不测试,需要开启预同步物流配置,且wms回传预同步物流扩展字段字段
5 SN码 回传 × 旗舰版ERP暂不支持 指sn.report接口,只支持销售订单
6 销售退货单 推送 核实WMS返回单号长度ID是否超过40
去重处理 推送成功手动再次推送即可
一单多退 订单商品数量为3个,第一个退货单退1个,第二个退货单退1个,第三个退货单退1个,即分多个退货单推送
一单超退 × 旗舰版ERP暂不支持 退货商品数量总数大于订单数量即可
相同商品多行明细 × WMS不支持
取消 取消分两种:出库前取消(WMS没有出库时ERP取消);出库后回传前取消(模拟回传失败或者异步回传的情况)
入库
全部入库
部分入库
分批入库 <confirmType>0 表示入库单最终状态;1 表示入库单中间状态
批次入库
残次入库 × 旗舰版ERP暂不支持
7 JIT出库单(唯品会拣货单) 推送 【定制业务,不测试】需关联出仓单;核实WMS返回单号长度ID是否超过40
去重处理 校验wms是否有去重机制,我们推送成功后,手动修改状态为失败后,重新推送一次,测试小伙伴可以联系研发协助
取消 取消分两种:出库前取消(WMS没有出库时ERP取消);出库后回传前取消(模拟回传失败或者异步回传的情况)
回传 目前的模式唯品会出库只可以一次全部出库
8 JIT入库单(唯品会退换管理) 推送 【定制业务,不测试】核实WMS返回单号长度ID是否超过40
去重处理 校验wms是否有去重机制,我们推送成功后,手动修改状态为失败后,重新推送一次,测试小伙伴可以联系研发协助
取消 取消分两种:出库前取消(WMS没有出库时ERP取消);出库后回传前取消(模拟回传失败或者异步回传的情况)
回传
全部入库
部分入库
分批入库
残次品入库
9 调拨出库单 推送 核实WMS返回单号长度ID是否超过40
去重处理 推送成功手动再次推送即可
相同仓库类型 指仓库类别(普通仓库/奇门仓库),需要再配置一个仓库,测试同一货主两个仓库之间的调拨
不同仓库类型 指仓库类别(普通仓库/奇门仓库)
取消 取消分两种:出库前取消(WMS没有出库时ERP取消);出库后回传前取消(模拟回传失败或者异步回传的情况)
出库
全部出库
部分出库 ×
分批出库 ×
批次出库
10 调拨入库单 推送 核实WMS返回单号长度ID是否超过40
去重处理 推送成功手动再次推送即可
相同仓库类型 指仓库类别(普通仓库/奇门仓库),需要再配置一个仓库,测试同一货主两个仓库之间的调拨
不同仓库类型 指仓库类别(普通仓库/奇门仓库)
取消 取消分两种:出库前取消(WMS没有出库时ERP取消);出库后回传前取消(模拟回传失败或者异步回传的情况)
入库
全部入库
部分入库
分批入库 <confirmType>0 表示入库单最终状态;1 表示入库单中间状态
批次入库 wms分批入库不可包含残次品
残次入库
11 委外其他入库单 推送 核实WMS返回单号长度ID是否超过40
去重处理 推送成功手动再次推送即可
残次推送 残次品和正品混合推送会合并
取消 取消分两种:出库前取消(WMS没有出库时ERP取消);出库后回传前取消(模拟回传失败或者异步回传的情况)
入库
全部入库
部分入库
分批入库 wms分批入库不可包含残次品 <confirmType>0 表示入库单最终状态;1 表示入库单中间状态
批次入库
残次入库
12 委外其他出库单 推送 核实WMS返回单号长度ID是否超过40
去重处理 推送成功手动再次推送即可
残次推送 残次品和正品混合推送会合并
取消 取消分两种:出库前取消(WMS没有出库时ERP取消);出库后回传前取消(模拟回传失败或者异步回传的情况)
出库
全部出库
部分出库 ×
分批出库 × <confirmType>0 表示出库单最终状态;1 表示出库单中间状态
批次出库
残次出库
出库物流单号的回传
13 单据流水状态 状态回传
14 订单流水查询 推送 旗舰版ERP暂不支持 测试小伙伴联系研发开启配置
15 库存异动 异动回传 旺店通只支持“一单一仓一种单据”类型异动。
批次回传 × 旗舰版ERP暂不支持
残次回传
16 库存查询 多商品库存查询 定时任务每天晚上查询
批次信息 × 旗舰版ERP暂不支持
残次信息
一仓多货主 × 旗舰版ERP暂不支持
17 库存盘点 盘点回传 核实WMS返回单号长度ID是否超过40
批次回传 × 旗舰版ERP暂不支持
残次回传
18 采购计划单 推送 【定制业务,特殊逻辑,类似于采购单,不测试】不需要联调测试
去重处理 校验wms是否有去重机制,我们推送成功后,手动修改状态为失败后,重新推送一次,测试小伙伴可以联系研发协助
取消 取消分两种:出库前取消(WMS没有出库时ERP取消);出库后回传前取消(模拟回传失败或者异步回传的情况)
回传
全部入库
部分入库
分批入库
批次入库
残次品入库
19 调拨单 推送 【菜鸟特殊业务,同属CN的仓库之间,同货主】不需要联调测试
去重处理 校验wms是否有去重机制,我们推送成功后,手动修改状态为失败后,重新推送一次,测试小伙伴可以联系研发协助
取消 取消分两种:出库前取消(WMS没有出库时ERP取消);出库后回传前取消(模拟回传失败或者异步回传的情况)
回传
全部出库 出库单只回传一次
部分出库 出库单只回传一次
全部入库 入库单只回传一次
部分入库 入库单只回传一次
残次入库
20 缺货通知接口 缺货通知回传
普通缺货通知 查看日志和推送信息字段是否有报错内容
缺货通知触发单据取消 需要研发配置
21 停止等待 旗舰版ERP暂不支持
采购入库单停止等待
委外入库单停止等待
22 下载WMS物流