Valide a Nota Fiscal Eletrônica (NF-e, mod 55), NFC-e (mod 65) e CT-e (mod 57) em XML contra os schemas atuais da SEFAZ — e receba de volta os caminhos exatos dos elementos que falharam, não um código de rejeição críptico. Construído para desenvolvedores de fiscal-tech, ERPs e integrações de checkout de e-commerce que precisam capturar documentos fiscais malformados antes que a SEFAZ o faça.
A maioria das APIs fiscais brasileiras (Focus NFe, Webmania, NFe.io) são pilhas de emissão completas — pesadas, precificadas para emissoras, e desnecessárias se você já possui o XML e só precisa validá-lo. Este é um validador de dados puros: POST o XML, obtenha um retorno estruturado de sucesso/falha com erros tipados. As regras do schema e as peculiaridades do 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 quanto ao schema, mas inválido quanto ao conteúdo, 200 para válido./v1/, e monitoramento diário da variação dos schemas da SEFAZ.{
"valid": true,
"errors": [],
"schema_version": "4.00",
"schema_kind": "nfe",
"municipality_specific_warnings": []
}
Validador de dados puros — sem dependência externa no momento da solicitação; os schemas da SEFAZ são agrupados e atualizados através de monitoramento diário. API versionada: a v1 é suportada indefinidamente; mudanças disruptivas 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. Dois primitivos de dados fiscais brasileiros, um vendedor.
Desenvolvida com base nos schemas NF-e / NFC-e / CT-e documentados publicamente pela SEFAZ (Manual de Orientação do Contribuinte; layouts 4.00 / 3.10). Sem dependência de API de terceiros no momento da solicitaçã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/12738/erp+fiscal+integration+validator+api/24637/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 alto nível para validade, erros, versão do esquema, tipo de esquema e avisos municipais, 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 do monitoramento diário das atualizações do esquema da SEFAZ garantindo que a API utilize as regras e estruturas de validação mais atuais para documentos NF-e NFC-e e CT-e
Casos de uso típicos incluem validar NF-e de fornecedores antes da importação para o livro razão em sistemas ERP pré-validar CT-e/NF-e durante o checkout em e-commerce e garantir conformidade em pipelines de recebimento de documentos
Os usuários podem utilizar os dados retornados verificando a flag "válido" para determinar se o XML é válido revisando o array "erros" para questões específicas e abordando quaisquer avisos específicos do município para conformidade
Padrões de dados padrão incluem uma flag "válido" como verdadeira para documentos válidos um array "erros" vazio e códigos de erro específicos como MISSING_REQUIRED ou INVALID_FORMAT para documentos inválidos proporcionando um feedback claro sobre problemas
Nível de serviço:
100%
Tempo de resposta:
153ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
153ms
Nível de serviço:
100%
Tempo de resposta:
153ms
Nível de serviço:
100%
Tempo de resposta:
153ms
Nível de serviço:
100%
Tempo de resposta:
153ms
Nível de serviço:
100%
Tempo de resposta:
153ms
Nível de serviço:
100%
Tempo de resposta:
153ms
Nível de serviço:
100%
Tempo de resposta:
9.458ms
Nível de serviço:
100%
Tempo de resposta:
0ms