Boas Práticas de Performance no NfeConsultaCadastro - Lotes, Timeout e Retry - Tudo o que Você Precisa Saber em 2026

Introdução Técnica

Este artigo é parte da série Webservices da NF-e 4.00 - Portal Nacional da SEFAZ, com base na documentação oficial disponível em https://www.nfe.fazenda.gov.br/portal/webservices.aspx【5177608166636234772†L2-L15】.

O serviço NfeConsultaCadastro na versão 4.00 é responsável por consulta de cadastro de contribuintes. Neste guia de alto padrão, explicamos em profundidade arquitetura, endpoints por UF, segurança e boas práticas de implementação.

Fonte oficial: Relação de Serviços Web do Portal da NF-e lista todas as UFs que utilizam SVRS, SVAN, SVC-AN e SVC-RS【5177608166636234772†L4-L15】, incluindo exemplos como Sefaz RS: https://cad.svrs.rs.gov.br/ws/cadconsultacadastro/cadconsultacadastro4.asmx【5177608166636234772†L192-L205】 e Sefaz SP: https://nfe.fazenda.sp.gov.br/ws/nfeautorizacao4.asmx【5177608166636234772†L212-L224】.

1. Arquitetura dos Autorizadores

A SEFAZ organizou os autorizadores em 5 grupos principais:

Essa divisão está documentada no cabeçalho da página de webservices【5177608166636234772†L4-L24】.

Para SVAN - Sefaz Virtual Ambiente Nacional, o endpoint de produção típico é:

NfeConsultaCadastro v4.00: https://cad.svrs.rs.gov.br/ws/cadconsultacadastro/cadconsultacadastro4.asmx

E em contingência:

• SVC-AN: https://www.sefazvirtual.fazenda.gov.br/NfeConsultaCadastro4/NfeConsultaCadastro4.asmx【5177608166636234772†L264-L281】
• SVC-RS: https://nfe.svrs.rs.gov.br/ws/nfeconsultacadastro/nfeconsultacadastro4.asmx【5177608166636234772†L282-L296】

2. Funcionamento do NfeConsultaCadastro

#### 2.1 Fluxo

1. StatusServico: Antes de qualquer envio, consulte NfeStatusServico para garantir que a SEFAZ está com cStat=107 - Serviço em Operação.
2. Envio: Para NfeConsultaCadastro, monte o XML assinado com certificado ICP-Brasil A1/A3 e envie via SOAP 1.2 com TLS 1.2.
3. Retorno: Processamento síncrono (até 1 NF-e) retorna cStat=100 - Autorizado ou assíncrono com recibo para NFeRetAutorizacao.
4. Eventos: Após autorização, use RecepcaoEvento para cancelamento, CC-e e manifestação.

#### 2.2 Exemplo de Requisição SOAP

<soap12:Envelope xmlns:soap12="http://www.w3.org/2003/05/soap-envelope"

                 xmlns:nfe="http://www.portalfiscal.inf.br/nfe/wsdl/NfeConsultaCadastro4">

  <soap12:Header/>

  <soap12:Body>

    <nfe:nfeDadosMsg>

      <enviNFe versao="4.00" xmlns="http://www.portalfiscal.inf.br/nfe">

        <idLote>000000000000001</idLote>

        <indSinc>1</indSinc>

        <NFe>

          <!-- XML da NF-e assinado -->

        </NFe>

      </enviNFe>

    </nfe:nfeDadosMsg>

  </soap12:Body>

</soap12:Envelope>

#### 2.3 Segurança e Certificado

• TLS 1.2 obrigatório desde 2018
• Certificado: A1 (arquivo .pfx) ou A3 (token/cartão)
• Cadeia: Instale cadeia completa V5 da ICP-Brasil
• Mutual TLS: SEFAZ exige certificado do cliente

Exemplo C#:

var cert = new X509Certificate2(@"C:\certs\certificado.pfx", "senha");

var binding = new BasicHttpsBinding();

binding.Security.Transport.ClientCredentialType = HttpClientCredentialType.Certificate;

var client = new NFeAutorizacao4Client(binding, new EndpointAddress("https://cad.svrs.rs.gov.br/ws/cadconsultacadastro/cadconsultacadastro4.asmx"));

client.ClientCredentials.ClientCertificate.Certificate = cert;

var result = client.nfeAutorizacaoLoteAsync(dadosMsg).Result;

3. Boas Práticas para MA e SVAN - Sefaz Virtual Ambiente Nacional

#### 3.1 Performance

• Lote máximo: 20 NF-e por lote (recomendado 1 para síncrono)
• Timeout: 60s para Autorizacao, 30s para Consulta
• Retry com backoff: 3 tentativas com 2s, 4s, 8s
• Cache de StatusServico: consulte a cada 5 minutos, não a cada NF-e

#### 3.2 Tratamento de Rejeições 200-299

Principais rejeições do NfeConsultaCadastro:

#### 3.3 Contingência Automática

Quando NfeStatusServico retornar diferente de 107 por mais de 3 minutos, seu sistema deve:

1. Alternar automaticamente para SVC-AN ou SVC-RS conforme matriz de contingência【5177608166636234772†L18-L24】
2. Emitir em EPEC (Evento Prévio de Emissão em Contingência) via RecepcaoEvento
3. Após retorno do autorizador principal, sincronizar e enviar EPEC para autorização definitiva

Fluxo ADVPL (Protheus):

User Function NFe4Conting()

  Local cURL := ""

  If NFeStatusServico("RS") != "107"

    // Vai para SVC-AN

    cURL := "https://www.sefazvirtual.fazenda.gov.br/NFeAutorizacao4/NFeAutorizacao4.asmx"

    // Envia EPEC

    U_NFeEPEC(cChave, dEmissao)

  Else

    cURL := "https://nfe.sefazrs.rs.gov.br/ws/NfeAutorizacao/NFeAutorizacao4.asmx"

  EndIf

Return cURL

4. Comparativo NfeConsultaCadastro vs RecepcaoEvento

Enquanto NfeConsultaCadastro foca em Consulta de cadastro de contribuintes, o RecepcaoEvento trata de Recepção de eventos da NF-e (Cancelamento, CC-e, etc). Ambos usam mesma infraestrutura de certificado, mas com WSDLs distintos.

Use NfeConsultaCadastro quando:

• Precisar autorizar NF-e nova
• Estiver em operação normal ou contingência SVC

Use RecepcaoEvento quando:

• Precisar consultar recibo (se RecepcaoEvento = RetAutorizacao)
• Validar cadastro antes de emitir
• Inutilizar numeração pulada

5. Distribuição DFe - Caso Especial

O serviço NFeDistribuicaoDFe versão 1.00 é o único hospedado no Ambiente Nacional (AN) e não nas SEFAZ estaduais:

https://www1.nfe.fazenda.gov.br/NFeDistribuicaoDFe/NFeDistribuicaoDFe.asmx【5177608166636234772†L298-L305】

Ele permite que destinatários busquem NF-e emitidas contra seu CNPJ usando NSU (Número Sequencial Único). Essencial para empresas que não recebem XML do fornecedor.

Exemplo de consulta:

<distNSU>

  <tpAmb>1</tpAmb>

  <cUFAutor>91</cUFAutor>

  <CNPJ>12345678000199</CNPJ>

  <distNSU>

    <ultNSU>000000000000000</ultNSU>

  </distNSU>

</distNSU>

6. Checklist de Homologação

• [ ] Configurar URLs de homologação (ex: https://homologacao.nfe.sefazrs.rs.gov.br)
• [ ] Testar NfeStatusServico retorna 107
• [ ] Emitir NF-e com CNPJ de homologação e IE 999999990
• [ ] Testar cancelamento via RecepcaoEvento
• [ ] Simular falha e ativar SVC-AN/SVC-RS
• [ ] Validar consulta de cadastro para MA
• [ ] Implementar Distribuição DFe para destinatários

7. Conclusão e Próximos Passos

Dominar os webservices NfeConsultaCadastro v4.00 é pré-requisito para qualquer ERP fiscal em 2026, especialmente com a Reforma Tributária trazendo novos campos de IBS/CBS que também passarão por esses mesmos autorizadores.

Mantenha sua tabela de URLs atualizada consultando mensalmente https://www.nfe.fazenda.gov.br/portal/webservices.aspx, pois a SEFAZ pode migrar UFs entre SVRS e SEFAZ própria sem aviso prévio.

Dica de especialista: Armazene as URLs em banco de dados ou arquivo de configuração, não hardcoded. Isso permite ativar contingência SVC em segundos sem deploy.