Homologação e produção

A homologação é a SEFAZ de verdade, no ambiente de testes (tpAmb 2): valida o certificado, o cadastro do emitente na UF e as regras do autorizador, sem valor fiscal.

Antes de começar

Emitente cadastrado com inscrição estadual e regime tributário corretos.
Certificado A1 enviado (guia) e Testar conexão verde.
Para NFC-e: CSC de homologação cadastrado.
Uma chave mn_hom_ criada em Integração › Chaves de API.

O que muda no XML

A MadNotas cuida disso sozinha em homologação: tpAmb 2, o nome do destinatário trocado pelo texto exigido pela SEFAZ (“NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL”) e a marca no DANFE. Você manda o mesmo payload da produção.

A numeração é separada por ambiente: a série 1 da homologação não consome números da série 1 da produção.

Na produção, número que sobra sem nota precisa ser inutilizado até o dia 10 do mês seguinte. A MadNotas avisa pelo webhook emitente.numeracao_buraco e só inutiliza sozinha se você ligar a opção no emitente. Veja números sem nota na produção.

Roteiro sugerido

Emita uma NF-e simples e confira o status autorizada com protocolo.
Cancele essa nota (POST /nfe/{id}/cancelamento, justificativa com 15 caracteres ou mais).
Registre uma carta de correção em outra nota (POST /nfe/{id}/carta-correcao).
Provoque uma rejeição real (por exemplo, um NCM inexistente) e corrija reenviando com a mesma ref.
Se usa NFC-e: emita, imprima o DANFCE e leia o QR Code com o celular.
Confira o webhook de cada etapa no seu sistema e em Integração › Webhooks › Entregas.

Autorizadores testados em homologação real

Testes feitos em 29/10/2026 na SEFAZ de homologação, com certificado A1 real.

Autorizador	O que foi testado
SVRS (RS)	Status do serviço, transmissão de NF-e e de NFC-e (QR Code v3), assinatura, consulta da nota, cancelamento, carta de correção e inutilização.
SVC-AN (contingência da NF-e)	Status do serviço.
Demais UFs	Testadas em simulação; homologação real com o primeiro cliente da UF.

O emitente usado nesses testes não tem inscrição estadual: a SEFAZ aceitou a assinatura e o formato de todas as mensagens e respondeu pelo cadastro do emitente. A primeira nota autorizada em homologação real sai com o primeiro cliente contribuinte do ICMS.

Ligando a produção

GET /emitentes/{id}/prontidao mostra o que falta para cada ambiente. Com tudo verde:

Ajuste o próximo número da série de produção se o emitente já emitia por outro sistema (PUT /emitentes/{id}/numeracao — o número só sobe).
Crie a chave mn_prod_ e troque no seu sistema.
Acompanhe as primeiras notas no painel, em Notas fiscais, e o status da SEFAZ.

Produção é para valer. Nota autorizada em produção tem valor fiscal e só sai por cancelamento, dentro do prazo da UF.