Ambientes

Operações fiscais têm comportamentos diferentes conforme o ambiente do autorizador. Antes de emitir, confirme se a empresa e o documento estão configurados para o ambiente correto.

O ambiente é definido na configuração da empresa (PUT /v1/empresas/{cpf_cnpj}/nfe, /nfse, /nfce) e acompanha cada emissão.

Homologação

Use homologação durante todo o desenvolvimento.

Documentos emitidos em homologação não têm valor fiscal e não devem ser tratados como documentos válidos da operação real da empresa.

Produção

Produção é o ambiente de documentos com efeito fiscal real. Uma nota autorizada aqui produz consequências tributárias.

Antes de migrar:

• valide autenticação;
• valide o cadastro do emitente;
• confira o certificado e a validade;
• teste o fluxo de consulta após a emissão;
• implemente tratamento de rejeições;
• implemente proteção contra emissões duplicadas (ver referência externa);
• confirme numeração e série.

Numeração não se mistura entre ambientes

Cada ambiente tem a própria sequência. O último número autorizado em homologação não diz nada sobre produção. GET /v1/empresas/numeracao devolve as duas separadas justamente por isso.

Atenção à NFS-e

A disponibilidade de homologação depende do município ou provedor. Nem todo ambiente municipal reproduz o comportamento da produção, e alguns simplesmente não oferecem ambiente de teste.

Consulte NFS-e antes de assumir que um município possui ambiente de homologação.