Atendimento

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

  1. Use as credenciais do Sandbox e cadastre o emitente com "ambiente": "HOMOLOGACAO".
  2. Envie o certificado A1 do emitente. Homologação exige um certificado válido, como a produção.
  3. Configure uma série de homologação para cada tipo de nota (PUT /emitentes/{id}/series).
  4. Para NFC-e, defina o CSC de homologação (PUT /emitentes/{id}/csc), gerado no portal da SEFAZ da UF.
  5. Emita, consulte, baixe XML e PDF, cancele e (na NF-e) emita uma carta de correção.
  6. Repita uma emissão com a mesma Idempotency-Key e confira o 200 com Idempotent-Replayed: true.
  7. Configure o webhook e use POST /conta/webhook/teste para 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 GET da nota, em erros, com o cStat da SEFAZ.
  • Rejeições e tempos de resposta da homologação podem ser diferentes dos da produção.

Nesta página