Consulta Resumida

Endpoint:

GET /NFe/ConsultarNFe/{chave}

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
chave	string	✅ Sim	Chave de acesso da NF-e (44 caracteres)

Exemplo de requisição:

curl -X GET "https://api.validanfe.com/NFe/ConsultarNFe/35170608530528000184550000000154301000771561" \
-H "Accept: application/json" \
-H "X-API-KEY: SEU_TOKEN_AQUI"

Respostas possíveis:

Código	Descrição
200 OK	NF-e encontrada e retornada com sucesso
400 Bad Request	Chave inválida ou mal formatada
401 Unauthorized	Token de autenticação ausente ou inválido
404 Not Found	NF-e não encontrada
500 Internal Server Error	Erro interno da API

Exemplo de Resposta - Sucesso (200)

{
    "Versao": "4.00",
    "TpAmb": "1",
    "VerAplic": "SERPRO-API",
    "CStat": "100",
    "XMotivo": "Autorizado o uso da NF-e",
    "CUF": "35",
    "DhRecbto": "2024-03-10T12:34:56Z",
    "ChNFe": "35170608530528000184550000000154301000771561",
    "ProtNFe": {
        "Versao": "4.00",
        "InfProt": {
            "TpAmb": "1",
            "VerAplic": "SERPRO-API",
            "ChNFe": "35170608530528000184550000000154301000771561",
            "DhRecbto": "2024-03-10T12:34:56Z",
            "NProt": "123456789012345",
            "DigVal": "ABCDEFGHIJKLMNO",
            "CStat": "100",
            "XMotivo": "Autorizado o uso da NF-e"
        }
    },
    "Xml": "<xml_data_here>"
}

Exemplo de Resposta - Bad Request (400)

{
    "error": "A chave da NF-e é obrigatória."
}

Exemplo de Resposta - NF-e Não Encontrada (404)

{
    "error": "NF-e não encontrada."
}

Exemplo de Resposta - Erro Interno (500)

{
    "error": "Erro interno do servidor."
}