Pular para o conteúdo principal
Ver como MarkdownDocs para agentes

Ambiente na emissão de NFS-e: o campo environment da nota é ignorado

O ambiente de emissão de uma NFS-e — teste ou produção — é definido exclusivamente pelo cadastro da Inscrição Municipal (IM), no campo Environment. O corpo da nota (POST /v1/companies/{companyId}/serviceinvoices) não possui campo de ambiente.

Risco de emissão real em produção

Se a sua IM está em Production, toda nota emitida é real e tem validade fiscal — mesmo que você envie algo como "environment": "Homologation" no corpo da nota. Esse campo é ignorado, sem erro nem aviso. Para testar, a IM precisa estar em Development.

Enviei "environment" no corpo da nota e não surtiu efeito. Por quê?​

Porque esse campo não existe no modelo de emissão de NFS-e. A API o ignora silenciosamente (não retorna 422 nem aviso) e segue o ambiente configurado na Inscrição Municipal. Enviar environment na nota não controla o ambiente por requisição.

Homologation não é um valor válido?​

Não na emissão de NFS-e. O ambiente é um valor do cadastro da Inscrição Municipal (Development para testes, Production para emissão real) — não da nota. Homologation é um conceito do mundo NF-e/SEFAZ e costuma aparecer em integrações geradas por IA, que inferem um campo de ambiente que não existe na NFS-e. Se você viu Homologation no seu payload, remova-o e configure o ambiente na IM.

Não enviei nenhum campo de ambiente. A nota sai como teste?​

Não. Vale o que está na IM. A ausência de um campo de ambiente na nota não significa "teste": se a IM está em Production, a emissão é real.

Como sei em qual ambiente minha IM (e, portanto, minhas notas) está?​

Consulte a Inscrição Municipal e verifique o campo Environment:

GET https://api.nfse.io/v2/companies/{company_id}/municipaltaxes/{municipal_tax_id}

Veja Gerenciamento de Inscrição Municipal e Ambiente: Testes ou Produção.

Como testo a emissão com segurança?​

  1. Crie (ou use) uma IM com Environment: "Development".
  2. Em testes de NFS-e o certificado digital é opcional — a nota não trafega para a prefeitura real.
  3. Confirme que a IM está em Development antes de emitir.
  4. Só promova a IM para Production (via alteração da IM) quando a integração estiver validada.

Estou integrando com ajuda de IA. O que observar?​

  • Não existe campo de ambiente no corpo da NFS-e — ignore qualquer sugestão de enviar environment, tpAmb ou Homologation na nota.
  • O ambiente é uma propriedade da Inscrição Municipal.
  • Sempre valide o ambiente efetivo consultando a IM antes de emitir em volume.

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.