REST · JSON · 102 个接口
TF Fiscal API
用于巴西电子发票（NF-e）发行、查询和取消的完整API。支持自动计算税款（ICMS、IPI、PIS/COFINS），生成XML，税务局授权以及与管理系统的集成。目前支持为整个巴西境内的产品发行发票。
基础URL（生产环境）
https://api.tffiscal.com认证与签名
必需请求头
| 请求头 | 类型 | 说明 |
|---|---|---|
| token | string | 开票公司的令牌 |
| sign | string | MD5 签名: MD5(token + path + body + timestamp) |
| timestamp | string | 秒级 Unix 时间戳（5 分钟有效窗口） |
签名算法
sign = md5(token + path + body + timestamp) # token：公司令牌 # path：请求路径；GET 请求要带上查询字符串 # body：请求体原文，去掉全部回车换行；GET 请求为空字符串 # timestamp：秒级 Unix 时间戳，5 分钟内有效 # 结果：32 位小写十六进制
示例 · cURL
# sign = md5(token + path + body + timestamp) # 按接口路径生成的调用模板，占位符替换为实际值 curl -X POST "https://api.tffiscal.com/api/invoice/create" \ -H "Content-Type: application/json" \ -H "token: $TOKEN" \ -H "timestamp: $TIMESTAMP" \ -H "sign: $SIGN" \ -d @body.json
系统流程
输入数据
- 客户信息
- 产品数据
- 税务信息
- 运输数据
处理
- 数据验证
- 税款计算
- XML生成
- 税务局授权
输出
- 发票XML
- 发票PDF
- DANFE（辅助文档）
- 授权状态