如何将QuickBooks与Foundry对接并实现数据导入

一、QuickBooks 端前置配置步骤 #

• 登录QuickBooks Online管理员账号，进入开发者设置页面，创建新的OAuth 2.0客户端应用，应用类型选择会计类，权限范围按需勾选（比如拉取发票、账单数据就勾选accounting.read相关权限）。
• 配置应用的重定向URI，直接填Foundry Rest Source的OAuth回调地址，格式为https://<你的Foundry实例域名>/rest-source/oauth2/callback。
• 保存应用后，复制生成的Client ID、Client Secret，同时记录QuickBooks对应的区域API端点（美国区为https://quickbooks.api.intuit.com，其他区域对应调整），还有你公司的Realm ID（可在QuickBooks账号设置页查询到）。
• 提交应用完成公司账号授权，确保授权账号拥有对应业务数据的访问权限，授权有效期选择最长可用周期，避免频繁重连。

二、Foundry 端 Rest Source 数据拉取配置 #

• 进入Foundry数据集成模块，创建新的REST Source连接，认证方式选择OAuth 2.0。
• 填入之前从QuickBooks复制的Client ID、Client Secret，授权URL填https://appcenter.intuit.com/connect/oauth2，令牌URL填https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer，权限范围和QuickBooks端勾选的保持一致。
• 完成OAuth授权校验后，配置数据拉取的请求路径，比如拉取客户数据路径为/v3/company/<你的Realm ID>/query，请求方法选GET，请求参数里添加query=SELECT * FROM Customer（QuickBooks使用类SQL查询语法，可按需替换表名、添加过滤条件）。
• 配置请求头：添加Accept: application/json，同时开启自动分页功能，QuickBooks接口单页最多返回1000条数据，分页参数按QuickBooks接口规则配置即可。
• 测试连接成功后，设置数据同步频率、增量拉取规则（可使用LastUpdatedTime字段作为增量标记，避免全量拉取浪费资源），即可将数据同步到Foundry数据集内。

三、常见问题排查 #

• 授权失败优先检查QuickBooks端的重定向URI是否和Foundry端配置完全一致，无多余斜杠或字符错误。
• 拉取数据返回403权限错误时，检查OAuth应用勾选的权限范围是否包含当前拉取业务数据的对应权限，同时确认授权账号权限足够。
• 同步频率不要设置为15分钟/次以内，避免触发QuickBooks的API调用频率限制。

内容的提问来源于stack exchange，提问作者youssefrizk