Valide a brasileira Nota Fiscal Eletrônica (NF-e, mod 55), NFC-e (mod 65) e CT-e (mod 57) XML contra os esquemas atuais da SEFAZ — e receba os caminhos exatos dos elementos que falharam, não um código de rejeição críptico. Criado para desenvolvedores de fiscal-tech, ERPs e integrações de checkout de e-commerce que precisam detectar documentos fiscais malformados antes que a SEFAZ.
A maioria das APIs fiscais brasileiras (Focus NFe, Webmania, NFe.io) são pilhas completas de emissão — pesadas, com preços para emissores, e exageradas se você já possui o XML e precisa apenas validá-lo. Este é um validador de dados puros: POSTE o XML, obtenha um pass/fail estruturado com erros tipados. As regras do esquema e as peculiaridades de NFS-e por município não são replicadas por validadores globais genéricos.
/NFe/infNFe/ide/nNF com códigos tipados (MISSING_REQUIRED, INVALID_FORMAT, CROSS_FIELD, UNSUPPORTED_VERSION, INVALID_ROOT).400 para XML malformado, 422 para válido segundo o esquema, mas inválido em conteúdo, 200 para válido./v1/ e monitoramento diário de variação dos esquemas da SEFAZ.{
"valid": true,
"errors": [],
"schema_version": "4.00",
"schema_kind": "nfe",
"municipality_specific_warnings": []
}
Validador de dados puros — nenhuma dependência a montante no momento da requisição; os esquemas da SEFAZ são agrupados e atualizados via monitoramento diário. API versionada: a v1 é suportada indefinidamente; mudanças que quebram a compatibilidade são enviadas com um aviso de descontinuação de 6 meses.
Esta API emparelha com a API de Enriquecimento de Parceiro CNPJ (também do Niche API Cluster): valide uma NF-e → extraia os CNPJs do emissor/recipiente → enriqueça e navegue pela propriedade corporativa. Duas primitivas de dados fiscais brasileiras, um vendedor.
Construído contra esquemas públicos documentados da SEFAZ NF-e / NFC-e / CT-e (Manual de Orientação do Contribuinte; layouts 4.00 / 3.10). Sem dependência de API de terceiros no momento da requisição.
Em português: valida XML de NF-e (mod 55), NFC-e (mod 65) e CT-e (mod 57) contra os schemas atuais da SEFAZ e retorna os caminhos exatos dos elementos com erro (código + path), não apenas uma rejeição genérica. Validador puro — você já tem o XML, só precisa validar, sem stack de emissão.
{"valid":true,"errors":[],"schema_version":"4.00","schema_kind":"nfe","municipality_specific_warnings":[]}
curl --location --request POST 'https://zylalabs.com/api/12681/nf-e+xml+validator+api/24570/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
'
| Cabeçalho | Descrição |
|---|---|
Authorization
|
[Obrigatório] Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito. |
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
A API retorna uma resposta JSON que inclui uma bandeira de validade uma lista de erros por elemento (com caminhos e códigos de erro) a versão do esquema detectada automaticamente o tipo de documento e quaisquer avisos específicos do município
Os campos chave na resposta incluem "válido" (booleano) "erros" (array de objetos de erro) "versão_do_esquema" (string) "tipo_de_esquema" (string) e "advertências_específicas_do_município" (array)
A resposta é estruturada como um objeto JSON com chaves de nível superior para validade, erros, versão do esquema, tipo de esquema e avisos do município, permitindo fácil acesso a cada componente
A API fornece resultados de validação para documentos XML de NF-e, NFC-e e CT-e, incluindo detalhes de erros, versão de esquema e avisos específicos do município, garantindo um feedback de validação abrangente
A precisão dos dados é mantida por meio de monitoramento diário das atualizações do esquema da SEFAZ garantindo que a API utilize as regras de validação e estruturas mais atuais para documentos NF-e NFC-e e CT-e
Casos de uso típicos incluem validar a NF-e do fornecedor antes da importação no livro em sistemas ERP pré-validar CT-e/NF-e durante o checkout de comércio eletrônico e garantir conformidade em pipelines de recebimento de documentos
Os usuários podem utilizar os dados retornados verificando o sinalizador "válido" para determinar se o XML é válido, revisando o array "erros" para problemas específicos e abordando quaisquer avisos específicos do município para conformidade
Os padrões de dados padrão incluem um indicador de "válido" verdadeiro para documentos válidos um array de "erros" vazio e códigos de erro específicos como FALTAM_REQUERIDO ou FORMATO_INVALIDO para documentos não válidos proporcionando um feedback claro sobre os problemas
Nível de serviço:
100%
Tempo de resposta:
769ms
Nível de serviço:
91%
Tempo de resposta:
2.848ms
Nível de serviço:
100%
Tempo de resposta:
93ms
Nível de serviço:
100%
Tempo de resposta:
1.401ms
Nível de serviço:
100%
Tempo de resposta:
368ms
Nível de serviço:
100%
Tempo de resposta:
111ms
Nível de serviço:
100%
Tempo de resposta:
1.041ms
Nível de serviço:
100%
Tempo de resposta:
93ms
Nível de serviço:
100%
Tempo de resposta:
571ms
Nível de serviço:
100%
Tempo de resposta:
383ms