CAMPO DO XML · NFS-e Obrigatório

ambGer

Ambiente gerador do evento: 1 - Sistema próprio do município; 2 - Sefin Nacional NFS-e; 3 - ADN NFS-e;

✓ Oficial · 27 de julho de 2026

Onde fica no arquivo

evento/infEvento/ambGer

Dentro do grupo infEvento — Grupo de informações do pedido de registro do evento

O que o arquivo aceita neste campo

Ocorrência: 1-1
Tamanho: —
Tipo declarado: TSAmbGeradorEvt
Formato exigido: —

Valores aceitos — 3

Valor	O que significa
1	—
2	—
3	—

Lista fechada do schema oficial: qualquer outro valor é recusado na validação do arquivo.

Em qual documento este campo é declarado

Anexo II — eventos

Regras de validação que citam ambGer — 2

⚠ 1 destas 2 chegam por CITAÇÃO no texto, não pelo campo declarado: a regra trata de outro campo e menciona ambGer na redação. Como ambGer aparece em 2 pontos do leiaute, a citação em prosa não diz de qual deles se trata — confira no texto. As regras marcadas "deste ponto do leiaute" são as que a Nota Técnica endereça a evento/infEvento/ambGer. As outras ocorrências estão logo abaixo.

E0246 Anexo VI — leiaute do IBS/CBS citada no texto

O código de país informado para o endereço no exterior do tomador do serviço deve existir e ser diferente de Brasil (BR), conforme a tabela ISO2. Obs 1: Se o código de país informado para o endereço no exterior do tomador do serviço não possui a informação no sistema próprio, então campo cPais deve ser preenchido com "ZZ". Obs 2: O código de país informado para o endereço no exterior do tomador do serviço não possui a informação no sistema próprio (cPais = ZZ), não é permitido na DPS enviada para a Sefin Nacional NFS-e (ambGer = 2).

E1274 Anexo II — eventos regra deste ponto do leiaute

Verificar se o ambiente gerador da NFS-e está de acordo com a definição: 1- Sistema Próprio do Município, para as NFS-e compartilhadas pelo município para o ADN, ou 2 - Sefin Nacional NFS-e, para as NFS-e emitidas pela Sefin ou recepcionadas via API "Bypass".

A mesma tag em outros pontos do XML — 1

ambGer não é um campo só: o leiaute declara este nome em 2 caminhos diferentes, cada um com o seu grupo e o seu significado. É por isso que a regra listada pelo nome pode não ser a desta ocorrência.

NFSe/infNFSe/ambGer

Ambiente gerador da NFS-e: 1- Sistema Próprio do Município; 2- Sefin Nacional NFS-e;

Campos do mesmo grupo — 6

dhProc Data/Hora do registro do evento. Data e hora no formato UTC (Universal Coordinated Time)… id O identificador do evento é composto pela concatenação de campos que constam no leiaute… nDFSe Número sequencial do documento gerado por ambiente gerador de DFSe do município. nSeqEvento Número sequencial do evento para o mesmo tipo de evento. Para os eventos que ocorrem… pedRegEvento Leiaute do pedido de registro do evento gerado pelo autor do evento verAplic Versão do aplicativo que gerou o evento.

Perguntas frequentes

O que é o campo ambGer da NFS-e?

Ambiente gerador do evento: 1 - Sistema próprio do município; 2 - Sefin Nacional NFS-e; 3 - ADN NFS-e; No XML ele fica em evento/infEvento/ambGer. É obrigatório (ocorrência 1-1).

Onde ambGer entra no XML?

No caminho evento/infEvento/ambGer, dentro do grupo infEvento (Grupo de informações do pedido de registro do evento). O mesmo grupo tem outros 6 campos.

Quais erros ambGer pode causar?

As regras de validação que citam este campo disparam 2 códigos: E0246, E1274. Cada um tem a regra oficial na ficha do código.

Quais valores ambGer aceita?

O schema oficial restringe a 3 valores: 1, 2, 3. Qualquer outro valor é recusado já na validação do arquivo.