{"valid":true,"errors":[],"schema_version":"4.00","schema_kind":"nfe","municipality_specific_warnings":[]}
curl --location --request POST 'https://zylalabs.com/api/12834/reliable+nf-e+xml+validator+api/25528/validate+nf-e+xml' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '
35
00000001
VENDA
55
1
1
2026-05-19T10:00:00-03:00
1
1
3550308
1
1
0
2
1
0
1
0
1.0
11222333000181
EMPRESA TESTE LTDA
RUA TESTE
100
CENTRO
3550308
SAO PAULO
SP
01000000
123456789012
3
22333444000172
CLIENTE TESTE LTDA
'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Validador de XML NF-e confiable API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
(Ahorra 2 meses pagando anualmente 🎉)
Valida la Nota Fiscal Electrónica (NF-e, mod 55), NFC-e (mod 65) y CT-e (mod 57) brasileña contra los esquemas actuales de SEFAZ y obtén los rutas de elementos exactas que fallaron, no un código de rechazo críptico. Diseñada para desarrolladores de fiscal-tech, ERPs e integraciones de checkout de comercio electrónico que necesitan detectar documentos fiscales mal formados antes de que lo haga SEFAZ.
La mayoría de las APIs fiscales brasileñas (Focus NFe, Webmania, NFe.io) son pilas de emisión completas, pesadas, con precios para emisores y excesivas si ya posees el XML y solo necesitas validarlo. Este es un validador de datos puros: envía el XML, obtén una respuesta estructurada de aprobación/rechazo con errores tipificados. Las reglas de esquema y los caprichos de NFS-e por municipio no son replicados por validadores globales genéricos.
/NFe/infNFe/ide/nNF con códigos tipificados (MISSING_REQUIRED, INVALID_FORMAT, CROSS_FIELD, UNSUPPORTED_VERSION, INVALID_ROOT).400 para XML mal formados, 422 para validación de esquema pero contenido inválido, 200 para válido./v1/ y monitoreo diario de desvío del esquema de SEFAZ.{
"valid": true,
"errors": [],
"schema_version": "4.00",
"schema_kind": "nfe",
"municipality_specific_warnings": []
}
La API devuelve una respuesta JSON que incluye un indicador de validez una lista de errores por elemento (con rutas y códigos de error) la versión de esquema detectada automáticamente el tipo de documento y cualquier advertencia específica del municipio
Los campos clave en la respuesta incluyen "válido" (booleano), "errores" (array de objetos de error), "versión_del_esquema" (cadena), "tipo_de_esquema" (cadena) y "advertencias_específicas_del_municipio" (array)
La respuesta está estructurada como un objeto JSON con claves de nivel superior para validez, errores, versión del esquema, tipo de esquema y advertencias del municipio, lo que permite un acceso fácil a cada componente
La API proporciona resultados de validación para documentos XML de NF-e, NFC-e y CT-e, incluyendo detalles de errores, versión de esquema y advertencias específicas del municipio, asegurando retroalimentación de validación completa
La precisión de los datos se mantiene a través del monitoreo diario de las actualizaciones del esquema de SEFAZ asegurando que la API utilice las reglas de validación y estructuras más actuales para los documentos NF-e NFC-e y CT-e
Los casos de uso típicos incluyen validar el NF-e del proveedor antes de la importación del libro en sistemas ERP prevalidar el CT-e/NF-e durante la compra en línea y garantizar el cumplimiento en los pipelines de entrada de documentos
Los usuarios pueden utilizar los datos devueltos verificando la bandera "válido" para determinar si el XML es válido revisando el array "errores" para problemas específicos y abordando cualquier advertencia específica del municipio para el cumplimiento
Los patrones de datos estándar incluyen una bandera de "válido" en true para documentos válidos un array de "errores" vacío y códigos de error específicos como MISSING_REQUIRED o INVALID_FORMAT para documentos no válidos proporcionando una retroalimentación clara sobre problemas