销售出库单接口字段手册权威教程：从旺店通到畅捷通T+的聚合实战

这个接口解决什么问题

在零售与电商业务中，ERP系统的销售出库单是连接订单、库存与财务的核心凭证。我们对接的客户普遍面临一个痛点：旺店通里产生的出库单需要实时同步到畅捷通T+生成销货单，驱动后续开票与对账。QueryStrategyData接口正是为了按策略、按时间窗口增量拉取出库数据而设计，配合定时任务可实现近实时的数据汇聚。

接口能力总览

• 认证方式：轻易云集成平台内部策略令牌，无需暴露源系统凭证。
• 请求方式：RESTful POST，方法名 QueryStrategyData。
• 核心请求参数：strategy_id（方案ID，区分不同帐套）、status（数据状态过滤，如 0,6 表示等待中与队列中）、created_at_begin/end（增量时间窗口）、page、pageSize、projection（按需投影字段）。
• 响应结构：JSON数组，每条记录为一条出库单聚合数据，含主键、明细列表、状态码。
• 分页与增量：支持page+pageSize分页，建议结合 created_at 时间戳做增量游标；定时任务 */10 * * * * 每10分钟拉取一次。
• 多帐套隔离：通过不同 strategy_id 区分002帐套、001帐套等独立数据源。

典型字段映射

在轻易云上如何配置

在轻易云数据集成平台里，这个接口的调用通常采用「策略数据源 + 写入目标」的双向配置模式。平台将旺店通的原始数据按帐套聚合为策略表，配置步骤如下：

1. 在数据源管理中创建「旺店通销售出库」策略，绑定对应帐套的 strategy_id。
2. 在轻易云的字段映射器中，左侧选择源字段，右侧拖拽到畅捷通T+销货单的 VoucherDate、ExternalCode、Customer、Memo 等目标字段。
3. 对于 details_list 明细行，轻易云会自动展开为子表，映射到 SaleDeliveryDetails。
4. 配置定时调度 */10 * * * *，平台自动管理增量游标与重试。

跨方案实战要点

在多个客户项目里，我们提炼出以下共性经验：

1. 多帐套必走独立策略：002帐套与001帐套必须配置不同的 strategy_id，避免数据串扰导致下游对账错乱。
2. status过滤优于全量拉取：使用 status=0,6 只拉取等待中与队列中数据，能减少70%以上的无效流量。
3. 金额字段一律按字符串处理：源系统返回string类型，务必在中间层做BigDecimal转换后再写入目标系统。
4. 明细展开是关键瓶颈：details_list 字段是JSON串，平台侧需配置JSON解析器逐行展开，否则会出现明细丢失或重复。
5. 发货时间是单据日期的黄金字段：consign_time 经格式转换后作为畅捷通 VoucherDate，转换格式需提前与财务确认。
6. 幂等控制依赖双键：用 stockout_id + stockout_no 组合作为幂等键，防止网络重试导致的重复写入。

踩坑复盘

1. 帐套串数据：曾有客户把002帐套的 strategy_id 误配成001的，导致001帐套出现脏数据。稳妥的做法是每个帐套单独建策略文件，并在命名上严格区分。

2. 金额精度丢失：源端返回 1234.5600 字符串，目标端直接写入浮点字段后变成 1234.56，对账时差一分钱。这里容易翻车，必须在映射器中显式声明 decimal 类型。

3. 明细行解析超时：当单据明细超过500行时，平台默认解析器会超时。稳妥的做法是预先拆分大单，或者在映射器中启用流式解析。

4. 区划编码缺失：部分老旧数据缺少 receiver_province_code，导致下游地址校验失败。建议在写入前补默认值并打标。

5. 增量游标回退：服务器时钟回拨会让 created_at 增量出现漏数。这里容易翻车，建议结合 modified 字段做双游标兜底。

何时选用

该接口适用于旺店通ERP与畅捷通T+之间的销售出库单近实时同步场景，特别是多店铺、多仓库、多帐套的零售企业。不适用于无明细展开需求的全量报表拉取，也不建议用于跨年的历史数据批量迁移——后者更适合走离线ETL通道。