技能介绍

要解决什么问题

财务对账、记账导入和流水分析往往卡在银行 PDF 对账单上：扫描件没有可靠文本层、各国日期与金额格式不一致、期初余额加交易合计与期末对不上时，手工 OCR 或模板解析很容易悄悄出错。你需要的是可复核的结构化交易数据，并能直接落到 CSV、Excel 或 QuickBooks、Xero、Sage、OFX 等格式。

技能如何工作

本技能通过 StatementEdge 的 /v1/convert API 上传 PDF，拿到 jobId 后轮询任务状态；完成后可拉取 JSON 交易明细，或用原生导出端点直接下载指定格式（csv、xlsx、qbo、qfx、ofx、xero-csv、sage-csv）。

核心能力来自文档强调的几点：

自动勾稽：每条对账单会做余额校验，reconcileStatus 会标明 reconciled、reconciled_with_flags 或 needs_review，减少静默的 off-by-one。
区域与格式感知：币种、小数分隔符、日期顺序、借贷列等按地区习惯处理，而非依赖易过期的单银行模板。
文本层与扫描分流：有文本层的 PDF 走轻量路径；扫描件走 Gemini 视觉提取（文档说明付费 API 输入不用于模型训练）。
加密 PDF：可在上传时传密码，密码仅在转换任务内存中持有，不落库、不写日志。

运行前需配置环境变量 STATEMENTEDGE_API_KEY（Dashboard → API keys 创建的一次性 se_live_… token）；免费档约 7 页/天，便于端到端试集成。

适用边界与注意点

数据主要在 欧盟（Frankfurt） 托管；成功转换后上传 PDF 约 一小时内自动删除；提取结果留在你的 StatementEdge 账户，直至你在控制台删除或关户。
技能只读取 STATEMENTEDGE_API_KEY 与你传入的文件路径，不会读取你机器上的其它环境变量或文件。
导出文件若任务未完成会返回 409，需先确认 status 为完成再请求对应格式。
覆盖范围文档写明为 22 国、100+ 银行，但个别版式仍可能落入 needs_review，导入记账软件前建议看一眼勾稽状态与摘要页。