制造厂商要按经销商的月出入库明细和实时库存排生产计划，Excel 月报从收集到汇总常常跨月，数据还停在上一周期；代理商又不愿意把客户名单交出去。这家区域代理商的解法是让速达按厂商数据平台指定的接口格式定期上报 JSON，项目投入不到 1 人月。本文回答三个问题：厂商为什么非要接口数据？代理商怎么在不上交客户资料的前提下完成上报？这套对接的工作量花在哪？
厂商为什么非要接口数据，不要 Excel 月报？
因为生产排期要的是“当前库存加近期消耗”，Excel 月报给的是上个月的存量，时间差本身就是成本。精益生产按周乃至按天排产，报表口径一旦滞后，排产就是在猜。
Excel 月报还有三个结构性问题：
口径不统一：各经销商对“库存”的定义不同，有的含在途，有的不含，汇总前要人工调平；
时效不可控：月报靠催，月初催上月的数，实际到手往往已到中旬；
无法追溯：改过的数字没有版本记录，厂商看到的是最后一版，不知道改了什么。
接口上报把这三点一次性解决：字段由厂商统一定义，上报由程序定时执行，每次上报带时间戳，能查到哪一天报了、报了什么。
代理商怎么在不交底客户资料的前提下完成上报？
只报厂商排产需要的字段，其余一概不出企业。厂商要的是月出入库明细和实时库存，不包含客户名称、联系方式、成交价格，代理商的数据边界在接口设计阶段就要写死。
1. 令牌认证：先确认数据来自谁
代理商端先向厂商数据平台换取访问令牌，令牌与代理商账号绑定，到期自动续期。厂商侧据此判断数据来源是否合法，代理商侧也不需要把账号密码硬编码在程序里。
2. 加密传输：SHA256 加 Base64
上报报文按约定规则做 SHA256 摘要再 Base64 编码，避免在公网链路上被篡改或明文窥探。专网 VPN 作为传输通道的补充，加密与专网两层都做，才算真正满足数据保密要求。
3. 字段白名单：只报约定的五项
代理商侧的上报内容严格限定在厂商数据平台定义的字段集合内：月出入库明细、实时库存、物料编码、数量、时间。客户名称、单价、毛利这类经营数据不在接口字段里，程序层面也没有读取这些字段的逻辑。
不到 1 人月是怎么做到的？
因为取数复用了速达已有的《账面库存明细表》，开发只花在取数、组装、上报这一段。不重造数据模型，是工期被压下来的主要原因。
1. 取数：复用既有报表模块
速达 ERP 的报表模块里，《账面库存明细表》本来就能按物料、仓库、期间出数。接口程序直接按厂商要求的维度读这张表，不需要另建中间库，也不用改动业务单据。
2. 组装与上报：代理商端的管理程序
上报逻辑做成代理商端的独立管理程序：配置平台地址与令牌、设定上报频率、查看上次上报结果。程序以 J2EE 服务形式常驻，配合客户端动态域名绑定，代理商换了出口 IP 也不影响上报。
3. 交付：五项范围一次做齐
项目范围包含厂商数据平台登录令牌认证、实时库存接口、月出入库明细接口、代理商端速达接口取数、代理商端接口管理程序。五项做完，代理商侧不需要额外操作，装好程序即自动运行。
经销商不愿意配合上报怎么办？
把“配合”变成“不用配合”：程序自动跑，代理商不需要每月安排人做报表。抵触往往来自工作量，而不是数据本身。
三个降低阻力的做法：一是上报范围写进接口文档，代理商清楚哪些字段出去了、哪些没出去；二是上报失败自动重试并留日志，不需要代理商 IT 介入；三是一次对接、多个代理商复用，后续新代理商的接入成本接近零。
| 对比项 | Excel 月报 | 接口定期上报 |
|---|---|---|
| 数据时效 | 上个月的存量，月初才到手 | 实时库存加月明细，定时自动上报 |
| 口径一致性 | 各家定义不同，需人工调平 | 字段由厂商统一定义 |
| 代理商工作量 | 每月人工做表 | 程序常驻，零人工 |
| 客户资料 | 表格里可能夹带客户明细 | 字段白名单，不采集 |
| 传输安全 | 邮件或网盘，明文 | 令牌认证加 SHA256 与 VPN |
| 实施投入 | 每月重复劳动 | 一次性开发，不到 1 人月 |
数据上报还有哪些常被问到的问题？
Q1：接口上报会不会把我们的客户名单交给厂商？
不会，前提是接口字段按白名单设计。上报内容只包含厂商排产需要的物料编码、数量、时间，客户名称与成交价格不在字段集合内，程序也没有读取这些字段的逻辑。
Q2：厂商换了数据平台，之前的对接要重做吗？
接口地址、令牌和字段映射都是配置项，平台更换时主要改这三处，取数与组装逻辑可以复用。如果新平台要求 SOAP 而不是 RESTful，适配层要重写一次，但业务逻辑不改。
Q3：代理商没有 IT 人员，程序谁维护？
上报程序做成常驻服务，开机自启、失败重试、日志可查，日常不需要人操作。维护只有两类动作：令牌续期可以自动完成，平台地址变更改一次配置即可，服务商远程处理，不必到现场。
Q4：上报频率可以调整吗？
可以。月出入库明细按自然月执行，实时库存的上报间隔在程序里配置，从每小时到每天都能设。频率越高对厂商平台的并发压力越大，实际取值通常与排产周期对齐。
Q5：上报失败怎么排查？
程序记录每次调用的时间、返回码和报文摘要。常见失败是令牌过期和网络中断，前者自动续期后重试，后者恢复网络即补传。连续失败会告警，不需要等厂商发现数据缺失。
想进一步了解经销商数据上报？
经销商接口对接咨询：400-6855-828｜0592-5086750（速达软件，全国远程实施）
