用途:该技能为通过 CData Connect AI 查询 QuickBooks Online 数据提供专门指引,构建在 connect-ai-base 技能之上,后者负责发现流程、错误恢复、SQL 方言与查询命名约定。使用前必须先定位并阅读 connect-ai-base 技能;若当前环境未加载、未启用或未安装,应立即停止任务,告知用户需先安装并启用该技能。本技能替代 QuickBooksOnline 驱动的 getInstructions,不要再调用它,识别连接后直接进行模式发现(getTables / getColumns)。
主要能力:QuickBooks Online 为单模式驱动,模式名为 QuickBooksOnline。数据围绕主记录(Accounts、Customers、Vendors、Items)展开,主记录锚定交易(Invoices、Bills、JournalEntries、Purchases)及其行项目。查询流程通常为:先定位主记录,再遍历到交易或行项目,最后计算或核对余额。主表为非交易表,无专用查找表时可用 SELECT DISTINCT。行项目表通过 *Ref 外键关联主记录,查询时务必加 TxnDate 过滤,否则大型实例会超时。字段遵循 Line_<DetailType>_<Field> 命名模式,易拼错,必要时先运行 getColumns 校验。
使用方式:示例查询如 SELECT * FROM [YourConnection].[QuickBooksOnline].[Accounts] LIMIT 10。存储过程包括 VoidInvoice / VoidPayment / VoidSalesReceipt(需 Id 与当前 SyncToken)、SendInvoice、GetReport、DownloadPDF、DownloadAttachment / DownloadNote。云端环境调用 DownloadPDF 等时省略 DownloadFolder 与 FileStream,返回 base64 编码数据。查找附件用 AttachableRefs 表。
适用场景:总账、应收应付、商品与银行数据查询,余额核对,报表汇总等。
限制:GetReport 可能并非在所有环境可用,优先使用预建报表对象(BalanceSheetSummaryReport、CustomerBalanceDetail)。UploadAttachment 当前在云端不支持,无 base64 替代方案。部分事实资料未提供。