金蝶 API 对接前要准备什么?授权、账套与职责检查清单
接口字段、权限与调用限制可能随产品版本调整。本文用于说明对接与排查思路,实际接入请核对当前官方文档,并在测试环境验证。
准备对接 ERP 时,先确认“谁的数据、由哪个应用访问、要完成什么业务”。先写代码、再补授权和业务范围,容易出现接口能调用,却找不到账套、写错目标或无法验收的问题。
本文适用于准备接入金蝶云星辰、精斗云云会计或云进销存的企业与技术伙伴。不同产品、应用类型的授权流程和接口能力应分别核对。
先把需求写成一条业务链路
不要只写“对接订单和库存”。建议说明来源系统、目标系统、单据类型、同步方向、触发时机与操作责任人。例如:“商城订单确认后,由集成服务写入 ERP;退货独立处理;ERP 业务单据完成后,再按约定查询库存供商城展示。”这是一种需求描述示例,不代表所有产品都支持相同流程。
至少列清以下内容:
- 当前产品、版本与正式账套,是否存在多个公司或多个账套。
- 商品、客户、供应商、仓库、单位由哪一方维护,如何建立对应关系。
- 需要新增、修改、审核、反审核还是查询;分别核对目标接口是否支持。
- 失败由谁处理,允许延迟多久,如何确认历史数据已经补齐。
再核对应用与账套授权
金蝶当前自建应用授权文档区分账套管理员直接授权与通过授权链接由管理员完成操作的场景,并要求核对服务及账套。自建应用的使用范围与服务商代开应用不同,应按实际用途选择类型。官方自建应用企业授权说明
建议逐项核查:
- 开发者后台所选企业、应用与客户要使用的产品是否一致。
- 授权服务是否已经开通,服务对应的目标账套是否正确。
- 完成授权的人是否具备目标账套所需权限。
- 应用标识、授权记录与实际程序配置是否对应,避免把不同客户或环境的凭证混用。
- 在客户确认的账套中做一次只读查询,核对可识别的业务资料,再进入写入验证。
不要把“购买了 API 服务”“拿到应用凭证”“账套授权完成”当成同一个动作。价格、许可范围和续费要求以当前官方后台及订单为准。
约定各方交付责任
建议由企业业务负责人确认字段与流程,由账套管理员处理授权,由开发团队负责接口实现、日志和异常恢复。金蝶伙伴可以协助业务沟通与产品配置;有开发任务时,还要约定接口代码、部署、日常维护和后续升级分别由谁承担。
官方历史对接流程也说明,开放平台提供标准接口,集成开发需由客户团队或第三方厂商完成。该文章含历史费用信息,不宜直接用作当前报价依据。对接流程与注意事项
用一张验收清单结束准备阶段
准备阶段的产出应能回答:目标账套已确认吗?应用类型正确吗?字段映射有人确认吗?首批测试单据由谁提供?异常单据怎样重试?上线后谁看告警?
建议先选一条最小业务链路,完成“读基础资料—写测试单据—查回结果—人工核对”,记录结果后再扩大范围。沙箱转正式检查步骤可用于安排下一步联调。
如需协助评估,可提供产品版本、系统名称、脱敏业务流程和拟对接单据清单。首次沟通不需要发送账号密码、密钥或完整客户数据。
下一步:确认对接范围
需要将接口能力落地到业务系统?可先了解对应产品的实施范围与交付方式。