平台与集成
审计
1 个接口
POST
/api/audit/run执行税务稽核
对已认证公司已存储的发票执行数字税务稽核 — 无需生成文件,也不依赖外部校验器。范围:NF-e(型号 55),仅限生产环境发票(忽略测试环境)。运行两条规则:编号跳号/遗漏(在每个系列的最小与最大已授权编号之间缺失的编号)以及重复(同一访问密钥被记录多次,或同一订单被授权多次)。期间为可选;不指定期间时,稽核公司的全部发票。
必需请求头
| 请求头 | 类型 | 说明 |
|---|---|---|
| token | string | 公司令牌 |
| sign | string | MD5 签名 |
| timestamp | string | 秒级 Unix 时间戳 |
Body — 参数(全部可选)
| 字段 | 类型 | 说明 |
|---|---|---|
| month | number | 月份(1–12)。具有最高优先级:稽核整月。与 year 配合使用。 |
| year | number | month 对应的年份(默认:当前年份)。无 month 时忽略。 |
| start_date | string | 期间起始,格式为 dd/MM/aaaa 或 dd/MM/aaaa HH:mm:ss。不含时间时默认为 00:00:00。圣保罗时区。未发送 month 时使用。 |
| end_date | string | 期间结束(相同格式)。结束为不包含(开区间)— 若要整月,请使用次月第一天(例如:01/07/2026)。 |
| start_create_time | number | 期间起始,Unix 时间戳(毫秒)。未发送 month 与 start_date/end_date 时使用。 |
| end_create_time | number | 期间结束,Unix 时间戳(毫秒,开区间)。 |
所有字段均为可选。优先级:month(+year)› start_date/end_date › start_create_time/end_create_time › 无(稽核全部发票)。
响应 — 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| periodo | object | 实际稽核的期间(圣保罗时区),包含 de 与 ate;无期间(稽核全部)时为 null。 |
| notas_puladas | array | 编号规则。每一项 = { serie, quantidade, notas },其中 notas 为以逗号连接的缺失编号。 |
| notas_duplicadas | array | 重复规则。每一项包含 quantidade + registros[],并通过 chave(同一文档被记录多次)或 pedido(同一订单被授权多次)标识。每条记录 = { serie, numero, chave, status, emitida_em }。 |