万序健康供应商库存出库查询接口字段手册权威教程

这个接口解决什么问题

万序健康 sccp.sup.insout.download 是供应链控制平台(SCCP)的供应商库存出库下载接口,用于从万序健康系统拉取药品、耗材的出库明细。在医药供应链集成场景中,它承担「供应商→医院」出库数据的单向汇聚职责,常用于对账、报表、近效期预警、批号追溯与下游金蝶云星空物料主数据映射,是 QUERY 模式下零写入风险的「安全数据源」。

接口能力总览

• 认证方式:私有化部署下基于租户密钥与 IP 白名单双因子校验,需提前在万序健康控制台申请 API 接入。
• 请求结构:POST 形式,Body 内携带分页参数(页码、每页条数)与时间窗(出库日期起止),支持按 stkinsoutid 或 stkinsoutno 增量。
• 响应结构:JSON 数组,每条记录含 hoscode、goodscode、qty、money、lotno 等 26 个核心字段,详见下表。
• 分页/增量模式:标准分页(pageNum/pageSize),配合 insoutdate 时间窗增量;每 10 分钟(*/10 * * * *)轮询一次,元数据 id 配置为 stkinsoutid,number 配置为 stkinsoutno。
• 写入约束:本策略为 QUERY_ONLY,严禁向金蝶云星空发起写入,仅作为后续集成方案的数据源参考。

典型字段映射

在轻易云上如何配置

在轻易云数据集成平台里,该接口通常以「HTTP 适配器 + 字段映射器」组合封装:适配器侧填入万序健康 API 地址、租户密钥与白名单 IP;字段映射器会把 stkinsoutid/stkinsoutno 自动识别为主键与业务编号,落到轻易云的元数据表;增量策略选用「按出库日期 + 主键去重」双保险,平台内置分页循环器自动翻页,无需手动写脚本。目标侧(本策略)设置为「空操作」,确保零写入。

跨方案实战要点

1. 元数据双锚点:始终把 stkinsoutid 配 id、stkinsoutno 配 number,后续任何方案复用同一接口时无需调整。
2. 时间窗 + 主键双增量:单用时间窗会丢补录单,单用主键会漏历史,稳妥做法是「时间窗拉取 + 主键去重」组合。
3. 供应商与物料主数据先行:在拉取出库明细前,务必先在轻易云里把 supcode 与金蝶 FSupplierId、goodscode 与物料编码建立好映射表。
4. 多院区并行走策略:南七、三水等多院区各开一条策略,Sequence 编号(A/B/C)区分,互不干扰。
5. 批号/效期必落字段:医药行业 lotno、mfdate、expire 必须穿透到下游报表,否则合规审计会翻车。
6. 字符串型数值要清洗:qty、sellprice、money 全为字符串,轻易云字段映射器需挂「类型转换器」转 Decimal,避免下游舍入误差。

踩坑复盘

• 踩坑一:把 goodscode(医院编码)误用成 goodscd(内部流水号),导致物料映射错位。稳妥做法是只用 goodscode 与金蝶物料对齐。
• 踩坑二:增量只按 insoutdate 拉取,遇到跨天补录单直接漏数。改用「时间窗 + stkinsoutid 去重」双保险后修复。
• 踩坑三:忘记私有化环境的 IP 白名单更新,迁移服务器后接口 403。每次服务器迁移务必同步更新白名单。
• 踩坑四:expire 字段格式不统一(有的 yyyy-MM-dd,有的带时间戳),在轻易云里挂日期标准化转换器统一为 yyyy-MM-dd。
• 踩坑五:把 QUERY_ONLY 策略误改成「写入金蝶」,触发下游脏数据。务必在策略配置里勾选「禁止写入」硬开关。

何时选用

该接口适用于「供应商库存出库数据单向汇聚、对账与报表」场景;不适用于需要回写单据、修改库存状态的业务流。若下游需触发入库或调拨,请改用万序健康的入库/调拨写入类接口,并另开策略,避免与 QUERY_ONLY 混用导致数据污染。