SuperAPI AI 工具集

ramp-core-workflow-b

办公与效率

查看项目

更新于 10-15 23:28

技能介绍

用途:在 Ramp 与 ERP 之间实现可对账的双向会计集成,覆盖科目表数据与可同步的支出对象,适用于导出交易、账单、报销等场景。

主要能力:把 ERP 编码结构镜像进 Ramp;只拉取符合条件的对象并一次性过账到 ERP;向 Ramp 回传显式成功或失败回执;保留实体边界与幂等审计台账;对账数量、金额、币种、行拆分、实体与状态,并隔离不一致项。

必要用法与要点:API 会计连接与 Ramp 直连 ERP 集成不同,直连默认被禁止做 API 同步标记;就绪过滤条件因对象而异,交易等对象用 sync_status=SYNC_READY,账单用 sync_ready=true;POST /developer/v1/accounting/syncs 接受幂等键、同步类型和明确成功或失败的对象回执;多实体读取必须用 entity_id 限定范围;Ramp 会计选择所用的 ID 与 ERP 远端 ID 不同;科目表批量推送需有界并校验,保留 Ramp ID 与 ERP 远端 ID 的映射表;每个对象类型需按其就绪过滤条件分页完整拉取,且一次只处理一个实体;过账时使用稳定的源对象键,记录 ERP 引用后再提交 Ramp 成功回执,被拒对象提交结构化失败回执。

限制与前提:需先确认 Ramp 应用、环境、业务实体、数据与工作流、负责人和回滚边界;操作前查阅官方文档并复核端点结构、权限范围与限制;在获得生产授权前应使用合成数据或 Ramp 沙箱;需准备已批准的密钥存储与脱敏证据位置;没有持久 ERP 回执不得标记为已同步;对象已在 ERP 过账时应按稳定 Ramp 源 ID 解析并复用现有引用,不再新建分录;科目表批次部分成功按全有或全无处理,需先读取当前状态并在对账后再发送;直连拒绝同步标记时应停止并解决会计连接架构;未解决的供应商行为、授权或财务状态应视为停止条件。