Temlavo 是一款面向开发者和 n8n 自动化机构的发票提取 API。其核心目标是从发票中提取数据，并识别那些“数字对不上”的问题发票，将异常项标记出来供人工复核。
用途与定位 Temlavo 面向需要把发票导入自有应用、会计系统或自动化工作流的开发者与机构。它不提供人工审核收件箱或审核服务，而是输出结构化数据与校验结果，由使用者自行决定如何审查、存储与后续处理。
主要能力
- 发票数据提取：返回可预测的 invoice.v1 格式会计 JSON，包含行项目（line items）。
- 校验检查：共 13 项检查，覆盖行项目算术、税额算术、总额一致性、行项目合计一致性、币种一致性、日期一致性、文档分类、必填字段、行项目覆盖率以及提取问题等。校验结果会指向涉及的具体数值。
- 重复检测：在账户与客户（实体）范围内标记同一文档或疑似重复发票，无需自行维护重复历史。默认开启，可在有意重新提交时关闭。
- 可配置的复核规则：可为每个请求携带规则，例如某客户必须提供采购订单号、另一客户必须提供可用行项目；规则随每次请求传递，无需维护提示词或模板。
- 明确结果状态：结果以 completed、needs_review 或 failed 等状态返回，便于工作流按状态分支处理。
- 多客户支持：每个发票通过 accounting_entity_id 标记客户，重复检测按客户范围隔离，用量 API 按客户报告处理页数，便于向客户重新计费。
使用方式
- 浏览器演练场：无需注册或 API 密钥，每天最多 2 张发票，文件与结果在查看后删除；浏览器处理不启用重复检测。
- SDK 调用：使用 TypeScript SDK，一行命令即可处理发票，例如 npm exec --yes --package=@temlavo/sdk@1 -- temlavo process ./bad-total-us.pdf > result.json。
- HTTP API：包含创建文档（POST）、直接上传（PUT）、确认上传（POST）、获取结果（GET）等步骤；处理期间可使用 Retry-After 轮询。
- n8n 模板：添加 API 密钥、从工作流传入发票、按状态路由结果。
- process() 方法：创建文档、上传文件、确认并等待结果，再根据状态保存已完成数据、向用户展示复核原因或处理失败。
适用场景 适合需要将发票导入会计软件、数据库、ERP、应用或其他工作流的团队；适合按客户管理发票并需要用量计费的机构；适合在 n8n 等自动化平台中构建发票处理流程的开发者。
限制与注意事项
- 支持的输入为 PDF、JPEG、PNG，单个文件不超过 20 MiB、不超过 20 页，每次上传一张独立发票；可包含采购订单等辅助页面；不支持收据或包含多张发票的上传。
- 主要面向美国英语发票，解析器可接受其他国家与币种。
- 不提供人工审核服务，即使结果为 completed 也不代表准确或可付款的保证。
- 数据保留：源文件与处理中间产物 24 小时内自动过期；结构化结果保留 7 天，需在过期前取回或保存至自有系统；支持按需删除文档内容。
- 计费：已完成与需复核的结果均计入用量；处理失败不收费；付费计划超量继续按页收费；试用达到限制后停止。
- 部分具体功能、高级定价或更细的集成说明在资料中暂未提供。
价格 免费试用：100 页、30 天、一次性、无需信用卡。Starter：每月 49 美元含 500 页，超量每页 0.10 美元。Pro：每月 149 美元含 3,000 页，超量每页 0.05 美元。更高用量需联系报价。各计划提取能力相同。
