Testes em homologação
Como validar a integração sem emitir nota com valor fiscal.
Toda a integração pode ser validada com o emitente em HOMOLOGACAO: a nota segue o mesmo caminho da produção
(numeração, assinatura, transmissão, autorização, eventos), mas a SEFAZ e a Sefin Nacional a tratam como teste.
Roteiro sugerido
- Use as credenciais do Sandbox e cadastre o emitente com
"ambiente": "HOMOLOGACAO". - Envie o certificado A1 do emitente. Homologação exige um certificado válido, como a produção.
- Configure uma série de homologação para cada tipo de nota (
PUT /emitentes/{id}/series). - Para NFC-e, defina o CSC de homologação (
PUT /emitentes/{id}/csc), gerado no portal da SEFAZ da UF. - Emita, consulte, baixe XML e PDF, cancele e (na NF-e) emita uma carta de correção.
- Repita uma emissão com a mesma
Idempotency-Keye confira o200comIdempotent-Replayed: true. - Configure o webhook e use
POST /conta/webhook/testepara validar a assinatura.
Prévia sem emitir
POST /nfe/calculo e POST /nfce/calculo recebem o mesmo corpo da emissão e devolvem os tributos e totais
calculados, sem gravar nem numerar. Use-os para conferir a regra fiscal do seu cadastro antes de emitir.
Diferenças da homologação
- Sem valor fiscal: o DANFE sai com "SEM VALOR FISCAL", e o DANFSe com "NFS-e SEM VALIDADE JURÍDICA".
- Algumas SEFAZ exigem textos específicos de homologação (por exemplo, no nome do destinatário). A rejeição aparece
no
GETda nota, emerros, com ocStatda SEFAZ. - Rejeições e tempos de resposta da homologação podem ser diferentes dos da produção.