---
title: "Ambiente na emissão de NFS-e: o campo environment da nota é ignorado - NFE.io | Docs"
description: "Na NFS-e, o ambiente (teste ou produção) é definido pela Inscrição Municipal, não pelo corpo da nota. Entenda por que enviar environment na nota não tem efeito e como testar com segurança."
source_url: https://nfe.io/docs/documentacao/nota-fiscal-servico-eletronica/duvidas/ambiente-na-emissao-nfse
last_updated: 2026-09-23
---

# 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.

:::danger 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`:

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

Veja [Gerenciamento de Inscrição Municipal](/docs/documentacao/gerenciamento-empresas/api-inscricoes-municipais/) e [Ambiente: Testes ou Produção](/docs/documentacao/nota-fiscal-servico-eletronica/primeiros-passos#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.