快速开始
TF Fiscal 开放 API 总览：平台能力、三步集成流程与阅读导引。
TF Fiscal 是面向巴西的电子税务凭证平台。通过一套带签名的 HTTP API，你的应用可以代注册主体开具 NF-e、CT-e 与 DC-e，向 SEFAZ 核验第三方 NF-e，查询 CNPJ 与 CPF 登记信息，并通过 Webhook 接收全部异步结果。
能力总览
| 能力 | 说明 | 文档 |
|---|---|---|
| NF-e | 代注册主体开具、查询、作废 NF-e（模型 55）；登记与列出更正函（CC-e） | NF-e |
| CT-e | 开具、查询、取消 CT-e（模型 57，公路运输）并登记授权后事件 | CT-e |
| DC-e | 为 Marketplace 与自开票企业开具、查询、取消 DC-e（模型 99） | DC-e |
| NF-e 验证 | 对第三方 NF-e XML 做两级核验，并支持按访问密钥（chave）查询 | NF-e 验证 |
| 身份核验 | 按 CNPJ，或按 CPF 加出生日期，查询官方登记信息 | 身份核验 |
| Webhooks | 带签名的回调，推送开票结果、授权后事件与验证结论 | Webhooks |
开票主体、证书与 Webhook 配置由全部开票类型共用：主体只需注册一次，即可开具 NF-e、CT-e 与 DC-e。见开票主体。
集成如何进行
- 申请凭证并订阅。 申请应用并领取
app_secret。它仅回显一次，请保存在服务端。随后平台为应用开通所需端点的订阅；调用未订阅的端点返回 HTTP 403 与错误码10009005。 - 验证签名。 每个请求都用
MD5(token + path + body + timestamp)签名，并携带token、timestamp、sign三个请求头。把联调回显作为第一个调用：它验证完整的签名链路并返回你的应用身份。 - 按领域集成。 开票类集成先注册主体、关联证书、注册 Webhook，然后开票。验证与身份核验类集成只需要带签名的调用，再加一个接收验证结论的 Webhook。
从哪里开始
- 快速上手：开票集成的五个调用，附可直接运行的 curl 示例。
- 认证与签名：凭证模型、签名规则、已知签名向量与五种语言的参考实现。
- 通用约定：响应形状、错误分类、幂等、限流、本地化与数据类型。
- 环境：网关基址，以及主体如何从测试环境切换到生产。
注意： 全部端点都位于
https://api.v2.tffiscal.com/openapi/之下。