TF Fiscal

平台与集成

审计

1 个接口

POST/api/audit/run

执行税务稽核

对已认证公司已存储的发票执行数字税务稽核 — 无需生成文件,也不依赖外部校验器。范围:NF-e(型号 55),仅限生产环境发票(忽略测试环境)。运行两条规则:编号跳号/遗漏(在每个系列的最小与最大已授权编号之间缺失的编号)以及重复(同一访问密钥被记录多次,或同一订单被授权多次)。期间为可选;不指定期间时,稽核公司的全部发票。

必需请求头

请求头类型说明
tokenstring公司令牌
signstringMD5 签名
timestampstring秒级 Unix 时间戳

Body — 参数(全部可选)

字段类型说明
monthnumber月份(1–12)。具有最高优先级:稽核整月。与 year 配合使用。
yearnumbermonth 对应的年份(默认:当前年份)。无 month 时忽略。
start_datestring期间起始,格式为 dd/MM/aaaa 或 dd/MM/aaaa HH:mm:ss。不含时间时默认为 00:00:00。圣保罗时区。未发送 month 时使用。
end_datestring期间结束(相同格式)。结束为不包含(开区间)— 若要整月,请使用次月第一天(例如:01/07/2026)。
start_create_timenumber期间起始,Unix 时间戳(毫秒)。未发送 month 与 start_date/end_date 时使用。
end_create_timenumber期间结束,Unix 时间戳(毫秒,开区间)。

所有字段均为可选。优先级:month(+year)› start_date/end_date › start_create_time/end_create_time › 无(稽核全部发票)。

响应 — 字段

字段类型说明
periodoobject实际稽核的期间(圣保罗时区),包含 de 与 ate;无期间(稽核全部)时为 null。
notas_puladasarray编号规则。每一项 = { serie, quantidade, notas },其中 notas 为以逗号连接的缺失编号。
notas_duplicadasarray重复规则。每一项包含 quantidade + registros[],并通过 chave(同一文档被记录多次)或 pedido(同一订单被授权多次)标识。每条记录 = { serie, numero, chave, status, emitida_em }。