获取京东【大件+中小件】退供单据 → 编码映射 → 调用旺店通创建"其他入库单" → 仓库入库时核对应退明细。把京东"应退明细"前置到仓库入库环节,将"收货后反查"变为"收货时核对"。
6 个系统协作:京东出数据 → ROC BFF 处理 → 旺店通 ERP 建单 → 淮安仓 WMS 核对;OPS 维护映射,飞书群负责告警。
5 个阶段:数据拉取 → 明细处理 → 编码映射 → 建单 → 入库核对。每 1h 轮询触发一次。
skuId / partCodeskuId / spareCode / packageNoskuId → spec_nologistics_noouter_no两条数据线建单粒度与字段来源不同,开发需分别处理。
shipCode)一单shipCodeshipCodepartCodeskuIdoutboundOrderNo)一单outboundOrderNopackageNo 去后缀(JDG…-1/-2 → JDG…)spareCodeskuId映射缺失不阻塞流程,留待下次轮询自然重试,形成闭环。
当单据内存在未映射的 skuId 时,整单暂缓建单(不拆单),触发飞书告警:
1 备件条码 = 1 实物,每明细行 = 1 件。单据内按 skuId 聚合:num = 同 skuId 行数,备件条码填 remark(多件逗号隔开)。
1 备件条码 = 1 实物商品;1 skuId = 多个备件条码;1 skuId = 1 个旺店通商家编码(spec_no)。
outer_no 全局唯一(中小件=shipCode、大件=outboundOrderNo)。旺店通 status=100 外部单号重复为天然兜底,重复推送不产生重复单。
渠道由数据来源接口决定(京东接口→京东自营),BFF 自动打标,零配置。再按中小件/大件拼备注。
ROC BFF 调旺店通 ERP建单 → ERP 推淮安仓 WMS → 仓库扫 logistics_no 关联 outer_no 核对 → WMS 回传 ERP 更新状态(旺店通自身机制,本次不开发)。
每 1h 轮询一次。编码缺失不建重试队列,下次轮询自然重试。单据级隔离,单据失败不阻塞批次。
开发建单时直接对照此表(createOtherOrder)。
| 旺店通字段 | 必填 | 中小件来源 | 大件来源 |
|---|---|---|---|
outer_no 外部单号(幂等键) | ✅ | shipCode(运单号) | outboundOrderNo(出库单号) |
logistics_no 运单号(扫码必填) | ✅ | shipCode(运单号) | packageNo 子母单去后缀主号 |
warehouse_no 仓库编码 | ✅ | 202201040001 淮安WMS仓 | 同左 |
remark 单据备注 | 选填 | 京东自营-中小件退货 | 京东自营-大件退货 |
goods_list[].spec_no 商家编码 | ✅ | skuId→OPS映射 | skuId→OPS映射 |
goods_list[].num 数量 | ✅ | 按 skuId 聚合:同 skuId 行数 | 按 skuId 聚合:同 skuId 行数 |
goods_list[].remark 明细备注 | 选填 | 备件条码 partCode(逗号隔开) | 备件条码 spareCode(逗号隔开) |
is_check 单据状态 | 选填 | 1(已审核) | 1(已审核) |
响应:status=0 成功 / data.message=入库单号;status=100 外部单号重复(幂等);status=20 审核失败。