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 recibe de vuelta las rutas exactas de los elementos que fallaron, no un código de rechazo críptico. Construido para desarrolladores de tecnología fiscal, ERP y integraciones de pago en comercio electrónico que necesitan captar documentos fiscales malformados antes de que lo haga la 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 tienes el XML y solo necesitas validarlo. Este es un validador de datos puros: envía el XML, obtén un resultado estructurado de aprobación/rechazo con errores tipados. Las reglas del esquema y las peculiaridades de NFS-e por municipio no son replicadas por validadores globales genéricos.
/NFe/infNFe/ide/nNF con códigos tipados (MISSING_REQUIRED, INVALID_FORMAT, CROSS_FIELD, UNSUPPORTED_VERSION, INVALID_ROOT).400 para XML malformado, 422 para válido en esquema pero contenido inválido, 200 para válido./v1/ y monitoreo diario de desvío de esquema de SEFAZ.{
"valid": true,
"errors": [],
"schema_version": "4.00",
"schema_kind": "nfe",
"municipality_specific_warnings": []
}
{"valid":true,"errors":[],"schema_version":"4.00","schema_kind":"nfe","municipality_specific_warnings":[]}
curl --location --request POST 'https://zylalabs.com/api/12732/nf-e+xml+validation+service+api/24631/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
'
| 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.
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 del 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_esquema" (cadena), "tipo_esquema" (cadena) y "advertencias_específicas_del_municipio" (array)
La respuesta está estructurada como un objeto JSON con claves de primer nivel 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, incluidos detalles de errores, versión del esquema y advertencias específicas del municipio, asegurando una retroalimentación de validación integral
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 la NF-e del proveedor antes de la importación al libro mayor en sistemas ERP prevalidar CT-e/NF-e durante el proceso de pago de comercio electrónico y garantizar el cumplimiento en las tuberías de recepción 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 de "errores" para problemas específicos y abordando cualquier advertencia específica del municipio para el cumplimiento
Los patrones de datos estándar incluyen un indicador "valido" de verdadero para documentos válidos un arreglo "errores" vacío y códigos de error específicos como FALTA_REQUERIDO o FORMATO_INVALIDO para documentos no válidos proporcionando una retroalimentación clara sobre los problemas
Nivel de Servicio:
100%
Tiempo de Respuesta:
0ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
153ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
153ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
153ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
153ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
153ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
153ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
153ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.041ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
571ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
181ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
318ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
229ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
325ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
565ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
444ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.588ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
421ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
877ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
195ms