业务痛点
流通与分销企业普遍存在"前端一套、后端一套"的系统格局：业务侧用易订货管理经销商下单、订货与分销流程，财务侧用用友好业财做账、库存与成本核算。两套系统单据割裂，付款单、销货单等关键凭证依赖人工导出表格再逐条录入，导致财务数据滞后于业务发生、跨系统对账靠人肉核对、月结周期被拉长，录入差错还会直接污染库存与往来账。
解决方案
通过易订货开放接口定时拉取付款单、销货单等业务单据，按预设的字段映射与单据转换规则，自动写入用友好业财生成对应的财务单据，实现业务单据到财务记录的自动流转；同步过程记录执行状态，支持增量拉取、失败重试与重复拦截，保证两侧数据口径一致、不重不漏。
落地价值
消除重复录入，业务人员无需在两套系统之间手工搬运数据
单据当日生成当日入账，账实同步，往来余额随时可查
月结从"逐单核对"变为"抽查校验"，财务人力投向分析与管控
跨系统留痕，任一财务单据可回溯到源业务单据，满足内审与对账要求
单据数据采集
通过易订货开放接口获取付款单、销货单数据，支持按时间区间与单据状态筛选拉取，自动分页处理，覆盖新增与变更单据。
定时增量同步
按预设周期自动执行，仅拉取上次同步后的增量单据，避免全量重复搬运；支持手动触发单次同步，便于补数与调试。
字段映射与单据转换
将易订货的单据结构按预设映射规则转换为用友好业财可识别的单据格式，统一字段口径、金额精度与单据类型，业务侧无需理解财务系统的表结构。
基础资料对应
维护两套系统之间的客商、商品、仓库、结算方式等基础资料对照关系，同步时自动完成编码翻译，避免单据写入后因主数据不一致被拒。
幂等与去重
以源单据号为唯一键做写入拦截，重复执行、重复拉取均不会产生重复财务单据，支持任务安全重跑。
异常处理与重试
同步失败自动重试并保留失败原因；对格式校验不通过、主数据缺失等硬错误单独归集，人工修正后可定点重推，不影响正常单据流转。
同步日志与状态追踪
记录每笔单据的采集、转换、写入全过程与结果状态，财务单据可回溯至源业务单据，业务侧亦可查看回写状态，异常快速定位。
对账校验
按周期比对两侧单据数量与金额汇总，输出差异清单，保证业务账与财务账口径一致、不重不漏。
整体架构
以同步服务为核心，串联"采集 → 映射 → 落库 → 推送 → 回执"五段链路。易订货侧通过开放接口获取付款单、销货单数据，用友好业财侧通过其接口完成单据写入；两侧接口差异全部收敛在各自的 Adapter 层，中间以统一的内部单据模型衔接，业务逻辑不直接依赖任何一方的字段结构，接口变更时只需调整对应适配层。
数据采集
按时间窗口分页拉取单据列表，再逐单获取明细，避免单次拉取数据量过大。拉取游标以"最后同步时间 + 单据号"持久化记录，每次任务只处理增量，任务失败时游标不前移，保证补跑不漏单。针对接口调用频率限制做请求节流与重试退避。
字段映射与单据转换
建立字段映射配置，将源单据的金额、税额、数量、往来单位、商品编码、结算方式等字段转换为目标单据结构；金额统一做精度对齐与借贷平衡校验，单据类型按预设规则归类。映射规则以配置而非硬编码维护，新增单据类型或字段时通过配置扩展，无需改动主流程。
主数据对照
独立维护客商、商品、仓库等编码对照表，同步时完成两套系统之间的编码翻译。对照缺失的单据进入待处理队列并标记原因，不阻断正常单据流转，补齐映射后可定点重推。
幂等与并发控制
以源单据号建立唯一索引，写入前先做存在性校验，重复拉取与任务重跑均不会产生重复财务单据。同步任务加分布式锁防止同一时刻多次执行，推送与状态更新放在同一事务内，保证"写入成功"与"状态已记"不会出现半程不一致。
异常处理与重试
区分可重试异常（网络超时、接口限流）与硬异常（校验不通过、主数据缺失）：前者按退避策略自动重试至上限后转为人工待办；后者直接归集，附带失败原因供人工修正。单据状态机（待同步 / 同步中 / 成功 / 失败 / 已跳过）全程可查，支持按条件筛选后批量重推。
数据层设计
四张核心表：同步任务记录、单据映射明细（源单据 ↔ 目标单据一一对应）、主数据对照表、同步日志（记录请求报文、返
评论