Referência de campos da NFS-e GovDigital

Campos do objeto nota quando o provedor é o GovDigital. O payload é o mesmo infDPS do Padrão Nacional — o que muda é o XML que geramos a partir dele, não o que você envia.

Esta página é gerada, não escrita

Ela sai de duas fontes, direto do que roda em produção:

• o conversor — quais nomes você pode enviar e em que campo do layout cada um vira;
• os XSD oficiais — tipo, tamanho, valores permitidos e a descrição de cada campo.

Por isso ela não diverge do sistema: se um campo muda no código, muda aqui. E por isso os textos da coluna "O que é" são os oficiais, não uma reescrita nossa.

São 35 campos em 12 grupos, 30 deles com descrição oficial.

Como ler

O corpo da emissão tem esta forma:

{
  "cpf_cnpj": "11222333000181",
  "provedor": "govdigital",
  "nota": {
    "infDPS": {
      "prest": { "CNPJ": "...", "IM": "..." },
      "toma":  { "...": "..." },
      "serv":  { "cServ": { "...": "..." } }
    }
  }
}

Cada seção abaixo é um desses blocos. A coluna Campo é o próprio nome que você envia: neste provedor não há tradução de nome, só a montagem do XML.

Um campo pode aceitar mais de um nome

8 campos aceitam nomes alternativos. Quando existem, aparecem como "também:" na primeira coluna — qualquer um funciona.

Campo com nome errado não dá erro

O conversor repassa chave desconhecida como veio, e o emissor a ignora: um vlrProd no lugar de vProd gera uma nota válida com o produto valendo R$ 0,00.

Antes da primeira emissão, passe o seu payload em POST /v1/nfe/verificar-campos — ele aponta o campo desconhecido e sugere o certo, sem emitir e sem consumir cota.

nota.prest

Neste grupo o nome que você envia é o nome do layout — não há tradução.

Campo	Campo	Tipo	Tam.	Valores	O que é
CNPJ	CNPJ	string	14		Número do CNPJ do emitente da NFS-e.
IM também: InscricaoMunicipal	IM	string	15		Número da inscrição municipal
xNome também: RazaoSocial	xNome	string	300		Nome / Razão Social do emitente.
opSimpNac	opSimpNac	string		1 2 3	Situação perante o Simples Nacional: 1 - Não Optante; 2 - Optante - Microempreendedor Individual (MEI); 3 - Optante - Microempresa ou Empresa de Pequeno Porte (ME/EPP);

nota.cServ

Neste grupo o nome que você envia é o nome do layout — não há tradução.

Campo	Campo	Tipo	Tam.	Valores	O que é
cNBS	cNBS	string			Código NBS correspondente ao serviço prestado, seguindo a versão 2.0, conforme Anexo B
xDescServ	xDescServ	TSStringComQuebraDeLinha	2000		Descrição completa do serviço prestado

nota.locPrest

Neste grupo o nome que você envia é o nome do layout — não há tradução.

Campo	Campo	Tipo	Tam.	Valores	O que é
cLocPrestacao	cLocPrestacao	string			Código do município onde o serviço foi prestado (tabela do IBGE)

nota.tribMun

Neste grupo o nome que você envia é o nome do layout — não há tradução.

Campo	Campo	Tipo	Tam.	Valores	O que é
cLocIncid também: cLocPrestacao	cLocIncid	string			O código de município utilizado pelo Sistema Nacional NFS-e é o código definido para cada município pertencente ao ""Anexo V – Tabela de Código de Municípios do IBGE"", que consta ao final do Manual de Orientação ao Contribuinte do ISSQN para a Sefin Nacional NFS-e. O município de incidência do ISSQN é determinado automaticamente pelo sistema, conforme regras do aspecto espacial da lei complementar federal (LC 116/03) que são válidas para todos os municípios. http://www.planalto.gov.br/ccivil_03/Leis/LCP/Lcp116.htm
vISSQN	vISSQN	string			Valor do ISSQN (R$) = Valor da Base de Cálculo x Alíquota ISSQN = vBC x pAliqAplic
pAliq	pAliq	string			Valor da alíquota (%) do serviço prestado relativo ao município sujeito ativo (município de incidência) do ISSQN. Se o município de incidência pertence ao Sistema Nacional NFS-e a alíquota estará parametrizada e, portanto, será fornecida pelo sistema. Se o município de incidência não pertence ao Sistema Nacional NFS-e a alíquota não estará parametrizada e, por isso, deverá ser fornecida pelo emitente.
vBC também: vServ	vBC	string
tpRetISSQN	tpRetISSQN	string		1 2 3	Tipo de retencao do ISSQN: 1 - Não Retido; 2 - Retido pelo Tomador; 3 - Retido pelo Intermediario;

nota.vServPrest

Neste grupo o nome que você envia é o nome do layout — não há tradução.

Campo	Campo	Tipo	Tam.	Valores	O que é
vServ	vServ	string			Valor dos serviços em R$

nota.IBSCBS

Neste grupo o nome que você envia é o nome do layout — não há tradução.

Campo	Campo	Tipo	Tam.	Valores	O que é
cIndOp	cIndOp	string			Código indicador da operação de fornecimento, conforme tabela "código indicador de operação"

nota.gIBSCBS

Neste grupo o nome que você envia é o nome do layout — não há tradução.

Campo	Campo	Tipo	Tam.	Valores	O que é
cClassTrib também: CClassTribReg, cClassTribReg	cClassTrib	string			Código de Classificação Tributária do IBS e da CBS
CST também: cst	CST	string		00 01 02 03 04 05 06 07 08 09 49 50 …
TpRetPisCofins também: tpRetPisCofins	TpRetPisCofins				campo do emissor, sem descrição no layout

nota (raiz)

Neste grupo o nome que você envia é o nome do layout — não há tradução.

Campo	Campo	Tipo	Tam.	Valores	O que é
usar_nt004	usar_nt004				campo do emissor, sem descrição no layout

nota.toma

Neste grupo o nome que você envia é o nome do layout — não há tradução.

Campo	Campo	Tipo	Tam.	Valores	O que é
CPF	CPF	string	11		Número da inscrição no Cadastro de Pessoa Física (CPF) do Destinatário do serviço
CNPJ	CNPJ	string	14		Número da inscrição no Cadastro Nacional de Pessoa Jurídica (CNPJ) do Destinatário do serviço
IM	IM	string	15		Número da inscrição municipal
xNome	xNome	string	300		Nome / Nome Empresarial do do Destinatário do serviço

nota.atvEvento

Neste grupo o nome que você envia é o nome do layout — não há tradução.

Campo	Campo	Tipo	Tam.	Valores	O que é
desc também: nome, xNome	desc				campo do emissor, sem descrição no layout
dtIni	dtIni	string			Data de início da atividade de evento. Ano, Mês e Dia (AAAA-MM-DD)
dtFim	dtFim	string			Data de fim da atividade de evento. Ano, Mês e Dia (AAAA-MM-DD)
idAtvEvt	idAtvEvt	string	30		Identificação da Atividade de Evento (código identificador de evento determinado pela Administração Tributária Municipal)

nota.end

Neste grupo o nome que você envia é o nome do layout — não há tradução.

Campo	Campo	Tipo	Tam.	Valores	O que é
xLgr	xLgr	TSString	255		Tipo e nome do logradouro da localização do imóvel
nro	nro	TSString	60		Número do imóvel
xCpl	xCpl	TSString	156		Complemento do endereço
xBairro	xBairro	TSString	60		Bairro
UF	UF	string		AC AL AM AP BA CE DF ES GO MA MG MS …	Sigla da unidade da federação do município do endereço do emitente.
CEP	CEP	string			Número do CEP
cMun	cMun	string			Código do município, conforme Tabela do IBGE

nota.endNac

Neste grupo o nome que você envia é o nome do layout — não há tradução.

Campo	Campo	Tipo	Tam.	Valores	O que é
cMun	cMun	string			Código do município, conforme Tabela do IBGE
CEP	CEP	string			Número do CEP

Grupos que passam direto

Em 12 grupos o campo vai para o layout com o mesmo nome, sem tradução: prest · cServ · locPrest · tribMun · vServPrest · IBSCBS · gIBSCBS · raiz · toma · atvEvento · end · endNac

São os grupos da Reforma Tributária e do ISSQN. Use os nomes do layout oficial.

O que esta página não cobre

Ela lista quais campos existem e o que cada um aceita. Ela não diz quando cada grupo é exigido — isso depende de UF, município, regime tributário e da operação, e está nos guias de emissão. Um payload que passa por esta referência ainda pode ser rejeitado por regra fiscal.