Auditoría

Ejecuta la auditoría fiscal digital sobre las notas ya almacenadas de la empresa autenticada — sin generar archivo ni depender de validador externo. Alcance: NF-e (mod. 55), solo notas de producción (la homologación se ignora). Ejecuta dos reglas: saltos/omisiones en la numeración (números ausentes entre el menor y el mayor número autorizado, por serie) y duplicidades (la misma clave grabada más de una vez, o el mismo pedido autorizado más de una vez). El período es opcional; sin período, audita todas las notas de la empresa.

Headers obligatorios

Header	Tipo	Descripción
token	string	Token de la empresa
sign	string	Firma MD5
timestamp	string	Unix timestamp en segundos

Body — parámetros (todos opcionales)

Campo	Tipo	Descripción
month	number	Mes (1–12). Tiene prioridad máxima: audita el mes entero. Combine con year.
year	number	Año del month (por defecto: año corriente). Se ignora sin month.
start_date	string	Inicio del período, en el formato dd/MM/aaaa o dd/MM/aaaa HH:mm:ss. Sin la hora, asume 00:00:00. Huso horario de São Paulo. Se usa cuando month no se envía.
end_date	string	Fin del período (mismo formato). El fin es exclusivo — para el mes entero, use el 1.º día del mes siguiente (ej.: 01/07/2026).
start_create_time	number	Inicio del período en Unix timestamp (milisegundos). Se usa cuando month y start_date/end_date no se envían.
end_create_time	number	Fin del período en Unix timestamp (milisegundos, exclusivo).

Todos los campos son opcionales. Precedencia: month (+year) › start_date/end_date › start_create_time/end_create_time › ninguno (audita todas las notas).

Respuesta — campos

Campo	Tipo	Descripción
periodo	object	Período efectivamente auditado (huso horario de São Paulo), con de y ate; null cuando no hay período (auditó todo).
notas_puladas	array	Regla de numeración. Cada ítem = { serie, quantidade, notas }, donde notas son los números ausentes unidos por coma.
notas_duplicadas	array	Regla de duplicidad. Cada ítem trae quantidade + registros[] y se identifica por chave (mismo documento grabado más de una vez) o por pedido (mismo pedido autorizado más de una vez). Cada registro = { serie, numero, chave, status, emitida_em }.