Referência de campos da NF-e

Todos os campos que o Conota aceita dentro do objeto nota, para NF-e (modelo 55) e NFC-e (modelo 65).

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 175 campos em 21 grupos, 90 deles com descrição oficial.

Como ler

O corpo da emissão tem esta forma:

{
  "cpf_cnpj": "11222333000181",
  "nota": {
    "identificacao": { "...": "..." },
    "emitente": { "...": "..." },
    "destinatario": { "...": "..." },
    "produtos": [ { "...": "..." } ],
    "total": { "...": "..." },
    "pagamentos": [ { "...": "..." } ]
  }
}

Cada seção abaixo é um desses blocos. A coluna Vira é o nome do campo no layout oficial, útil quando o fisco devolve uma rejeição citando o nome dele.

Um campo pode aceitar mais de um nome

18 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.identificacao`

Campo	Vira	Tipo	Tam.	Valores	O que é
`natureza_operacao` também: `nat_op`	`natOp`	`TString`	60		Descrição da Natureza da Operação
`modelo`	`mod`	`string`		`55` `65`
`serie`	`serie`	`string`
`numero`	`nNF`	`string`
`data_emissao`	`dhEmi`	`string`			Data e Hora de emissão do Documento Fiscal (AAAA-MM-DDThh:mm:ssTZD) ex.: 2012-09-01T13:00:00-03:00
`data_saida`	`dhSaiEnt`	`string`			Data e Hora da saída ou de entrada da mercadoria / produto (AAAA-MM-DDTHH:mm:ssTZD)
`tipo_nota`	`tpNF`	`string`		`0` `1`	Tipo do Documento Fiscal (0 - entrada; 1 - saída)
`destino_operacao`	`idDest`	`string`		`1` `2` `3`	Identificador de Local de destino da operação (1-Interna;2-Interestadual;3-Exterior)
`tipo_ambiente`	`tpAmb`	`string`		`1` `2`	Identificação do Ambiente: 1 - Produção 2 - Homologação
`tipo_impressao`	`tpImp`	`string`		`0` `1` `2` `3` `4` `5`	Formato de impressão do DANFE (0-sem DANFE;1-DANFe Retrato; 2-DANFe Paisagem;3-DANFe Simplificado; 4-DANFe NFC-e;5-DANFe NFC-e em mensagem eletrônica)
`tipo_emissao`	`tpEmis`	`string`		`1` `2` `3` `4` `5` `6` `7` `9`	Forma de emissão da NF-e 1 - Normal; 2 - Contingência FS 3 - Regime Especial NFF (NT 2021.002) 4 - Contingência DPEC 5 - Contingência FSDA 6 - Contingência SVC - AN 7 - Contingência SVC - RS 9 - Contingência off-line NFC-e
`finalidade`	`finNFe`	`string`		`1` `2` `3` `4` `5` `6`	Finalidade da emissão da NF-e: 1 - NFe normal 2 - NFe complementar 3 - NFe de ajuste 4 - Devolução/Retorno 5 - Nota de crédito 6 - Nota de débito
`consumidor_final`	`indFinal`	`string`		`0` `1`	Indica operação com consumidor final (0-Não;1-Consumidor Final)
`presenca`	`indPres`	`string`		`0` `1` `2` `3` `4` `5` `9`	Indicador de presença do comprador no estabelecimento comercial no momento da oepração (0-Não se aplica (ex.: Nota Fiscal complementar ou de ajuste;1-Operação presencial;2-Não presencial, internet;3-Não presencial, teleatendimento;4-NFC-e entrega em domicílio;5-Operação presencial, fora do estabelecimento;9-Não presencial, outros)
`processo_emissao`	`procEmi`	`string`		`0` `1` `2` `3`	Processo de emissão utilizado com a seguinte codificação: 0 - emissão de NF-e com aplicativo do contribuinte; 1 - emissão de NF-e avulsa pelo Fisco; 2 - emissão de NF-e avulsa, pelo contribuinte com seu certificado digital, através do site do Fisco; 3- emissão de NF-e pelo contribuinte com aplicativo fornecido pelo Fisco.
`municipio_fg`	`cMunFG`	`string`

`nota.emitente`

Campo	Vira	Tipo	Tam.	Valores	O que é
`cnpj` também: `cnpj_cpf`, `cpf`	`CNPJCPF`				campo do emissor, sem descrição no layout
`razao_social` também: `nome`	`xNome`	`TString`	60		Razão Social ou Nome do emitente
`nome_fantasia` também: `fantasia`	`xFant`	`TString`	60		Nome fantasia
`inscricao_estadual` também: `ie`	`IE`	`string`	14		IE do emitente da NF de Produtor
`regime_tributario` também: `crt`	`CRT`	`string`		`1` `2` `3` `4`	Código de Regime Tributário. Este campo será obrigatoriamente preenchido com: 1 – Simples Nacional; 2 – Simples Nacional – excesso de sublimite de receita bruta; 3 – Regime Normal. 4 - Simples Nacional - Microempreendedor individual - MEI
`logradouro`	`xLgr`	`TString`	60		Logradouro
`numero`	`nro`	`TString`	60		Número
`complemento`	`xCpl`	`TString`	60		Complemento
`bairro`	`xBairro`	`TString`	60		Bairro
`codigo_municipio`	`cMun`	`string`
`municipio`	`xMun`	`TString`	60
`codigo_uf`	`cUF`	`string`		`11` `12` `13` `14` `15` `16` `17` `21` `22` `23` `24` `25` …	Código da UF do emitente do Documento Fiscal. Utilizar a Tabela do IBGE.
`uf`	`UF`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …
`cep`	`CEP`	`string`			CEP
`codigo_pais`	`cPais`	`string`		`1058`
`pais`	`xPais`	`TString`	60	`Brasil` `BRASIL`	Nome do país
`telefone`	`Fone`				campo do emissor, sem descrição no layout
`cnae`	`CNAE`	`string`			CNAE Fiscal
`im`	`IM`	`TString`	15
`iest`	`IEST`	`string`	14		Inscricao Estadual do Substituto Tributário

`nota.destinatario`

Campo	Vira	Tipo	Tam.	Valores	O que é
`cnpj` também: `cnpj_cpf`, `cpf`	`CNPJCPF`				campo do emissor, sem descrição no layout
`razao_social` também: `nome`	`xNome`	`TString`	60		Razão Social ou nome do destinatário
`indicador_ie` também: `ind_ie_dest`	`indIEDest`	`string`		`1` `2` `9`	Indicador da IE do destinatário: 1 – Contribuinte ICMSpagamento à vista; 2 – Contribuinte isento de inscrição; 9 – Não Contribuinte
`inscricao_estadual` também: `ie`	`IE`	`string`	14
`email`	`Email`				campo do emissor, sem descrição no layout
`logradouro`	`xLgr`	`TString`	60		Logradouro
`numero`	`nro`	`TString`	60		Número
`complemento`	`xCpl`	`TString`	60		Complemento
`bairro`	`xBairro`	`TString`	60		Bairro
`codigo_municipio`	`cMun`	`string`
`municipio`	`xMun`	`TString`	60
`uf`	`UF`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …
`cep`	`CEP`	`string`			CEP
`codigo_pais`	`cPais`	`string`		`1058`
`pais`	`xPais`	`TString`	60	`Brasil` `BRASIL`	Nome do país
`telefone`	`Fone`				campo do emissor, sem descrição no layout
`id_estrangeiro`	`idEstrangeiro`	`string`			Identificador do destinatário, em caso de comprador estrangeiro

`nota.produtos[]`

Campo	Vira	Tipo	Tam.	Valores	O que é
`codigo` também: `codigo_produto`	`cProd`	`TString`	60		Código do produto ou serviço. Preencher com CFOP caso se trate de itens não relacionados com mercadorias/produto e que o contribuinte não possua codificação própria Formato ”CFOP9999”.
`ean`	`cEAN`	`string`			GTIN (Global Trade Item Number) do produto, antigo código EAN ou código de barras
`ean_tributavel`	`cEANTrib`	`string`			GTIN (Global Trade Item Number) da unidade tributável, antigo código EAN ou código de barras
`descricao`	`xProd`	`TString`	120		Descrição do produto ou serviço
`ncm`	`NCM`	`string`			Código NCM (8 posições), será permitida a informação do gênero (posição do capítulo do NCM) quando a operação não for de comércio exterior (importação/exportação) ou o produto não seja tributado pelo IPI. Em caso de item de serviço ou item que não tenham produto (Ex. transferência de crédito, crédito do ativo imobilizado, etc.), informar o código 00 (zeros) (v2.0)
`cest`	`CEST`	`string`			Codigo especificador da Substuicao Tributaria - CEST, que identifica a mercadoria sujeita aos regimes de substituicao tributária e de antecipação do recolhimento do imposto
`cfop`	`CFOP`	`string`
`unidade`	`uCom`	`TString`	6		Unidade comercial
`quantidade`	`qCom`	`string`			Quantidade Comercial do produto, alterado para aceitar de 0 a 4 casas decimais e 11 inteiros.
`valor_unitario`	`vUnCom`	`string`			Valor unitário de comercialização - alterado para aceitar 0 a 10 casas decimais e 11 inteiros
`valor_total`	`vProd`	`string`
`unidade_tributavel`	`uTrib`	`TString`	6
`quantidade_tributavel`	`qTrib`	`string`
`valor_unitario_tributavel`	`vUnTrib`	`string`			Valor unitário de tributação - alterado para aceitar 0 a 10 casas decimais e 11 inteiros
`valor_frete`	`vFrete`	`string`			Valor Total do Frete
`valor_seguro`	`vSeg`	`string`			Valor Total do Seguro
`valor_desconto`	`vDesc`	`string`
`valor_outros`	`vOutro`	`string`
`indicador_total`	`indTot`	`string`		`0` `1`	Este campo deverá ser preenchido com: 0 – o valor do item (vProd) não compõe o valor total da NF-e (vProd) 1 – o valor do item (vProd) compõe o valor total da NF-e (vProd)
`info_adicional`	`infAdProd`	`TString`	500		Informações adicionais do produto (norma referenciada, informações complementares, etc)
`numero_pedido`	`xPed`	`TString`	15
`item_pedido`	`nItemPed`	`string`			Número do Item do Pedido de Compra - Identificação do número do item do pedido de Compra

`nota.total`

Campo	Vira	Tipo	O que é
`valor_bc_icms`	`vBC`	`string`
`valor_icms`	`vICMS`	`string`
`valor_bc_icms_st`	`vBCST`	`string`
`valor_icms_st`	`vST`	`string`	Valor Total do ICMS ST
`valor_produtos`	`vProd`	`string`
`valor_frete`	`vFrete`	`string`	Valor Total do Frete
`valor_seguro`	`vSeg`	`string`	Valor Total do Seguro
`valor_desconto`	`vDesc`	`string`
`valor_ii`	`vII`	`string`
`valor_ipi`	`vIPI`	`string`
`valor_pis`	`vPIS`	`string`
`valor_cofins`	`vCOFINS`	`string`
`valor_outros`	`vOutro`	`string`
`valor_nota`	`vNF`	`string`	Valor Total da NF-e
`valor_tributos`	`vTotTrib`	`string`	Valor estimado total de impostos federais, estaduais e municipais

`nota.transportador`

Campo	Vira	Tipo	Tam.	Valores	O que é
`modalidade_frete` também: `mod_frete`	`modFrete`	`string`		`0` `1` `2` `3` `4` `9`	Modalidade do frete 0- Contratação do Frete por conta do Remetente (CIF); 1- Contratação do Frete por conta do destinatário/remetente (FOB); 2- Contratação do Frete por conta de terceiros; 3- Transporte próprio por conta do remetente; 4- Transporte próprio por conta do destinatário; 9- Sem Ocorrência de transporte.
`cnpj` também: `cnpj_cpf`	`CNPJCPF`				campo do emissor, sem descrição no layout
`razao_social` também: `nome`	`xNome`	`TString`	60		Razão Social ou nome do transportador
`inscricao_estadual` também: `ie`	`IE`	`string`	14
`endereco`	`xEnder`	`TString`	60		Endereço completo
`municipio`	`xMun`	`TString`	60
`uf`	`UF`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …
`placa`	`Placa`				campo do emissor, sem descrição no layout
`uf_placa`	`UFPlaca`				campo do emissor, sem descrição no layout
`rntc`	`RNTC`	`TString`	20		Registro Nacional de Transportador de Carga (ANTT)

`nota.volumes[]`

Campo	Vira	Tipo	Tam.	O que é
`quantidade`	`qVol`	`string`		Quantidade de volumes transportados
`especie`	`esp`	`TString`	60	Espécie dos volumes transportados
`marca`	`Marca`			campo do emissor, sem descrição no layout
`numeracao`	`nVol`	`TString`	60	Numeração dos volumes transportados
`peso_liquido`	`pesoL`	`TString`	9
`peso_bruto`	`pesoB`	`TString`	9

`nota.fatura`

Campo	Vira	Tipo	Tam.	O que é
`numero`	`nFat`	`TString`	60	Número da fatura
`valor_original`	`vOrig`	`string`		Valor original da fatura
`valor_desconto`	`vDesc`	`string`
`valor_liquido`	`vLiq`	`string`		Valor líquido da fatura

`nota.duplicatas[]`

Campo	Vira	Tipo	Tam.	O que é
`numero`	`nDup`	`TString`	60	Número da duplicata
`vencimento`	`dVenc`	`string`		Data de vencimento da duplicata (AAAA-MM-DD)
`valor`	`vDup`	`string`		Valor da duplicata

`nota.pagamentos[]`

Campo	Vira	Tipo	Tam.	Valores	O que é
`tipo` também: `tipo_pagamento`	`tPag`	`string`			Forma de Pagamento:
`valor`	`vPag`	`string`			Valor do Pagamento. Esta tag poderá ser omitida quando a tag tPag=90 (Sem Pagamento), caso contrário deverá ser preenchida.
`indicador`	`indPag`	`string`		`0` `1`	Indicador da Forma de Pagamento:0-Pagamento à Vista;1-Pagamento à Prazo;
`descricao`	`xPag`	`TString`	60		Descrição do Meio de Pagamento
`troco`	`vTroco`	`string`			Valor do Troco.
`tipo_integracao`	`tpIntegra`	`string`		`1` `2`	Tipo de Integração do processo de pagamento com o sistema de automação da empresa: 1 - Pagamento integrado com o sistema de automação da empresa (Ex.: equipamento TEF, Comércio Eletrônico, POS Integrado); 2 - Pagamento não integrado com o sistema de automação da empresa (Ex.: equipamento POS Simples).
`cnpj_credenciadora`	`CNPJ`	`string`	14
`bandeira`	`tBand`	`string`			Bandeira da operadora de cartão
`autorizacao`	`cAut`	`TString`	128		Número de autorização da operação com cartões, PIX, boletos e outros pagamentos eletrônicos

`nota.informacoes_adicionais`

Campo	Vira	Tipo	Tam.	Valores	O que é
`info_fisco` também: `informacoes_fisco`	`infAdFisco`	`TString`	2000		Informações adicionais de interesse do Fisco (v2.0)
`info_complementar` também: `informacoes_complementares`	`infCpl`	`TString`	5000		Informações complementares de interesse do Contribuinte

`nota.responsavel_tecnico`

Campo	Vira	Tipo	Tam.	O que é
`cnpj`	`CNPJ`	`string`	14
`contato`	`xContato`	`TString`	60	Informar o nome da pessoa a ser contatada na empresa desenvolvedora do sistema utilizado na emissão do documento fiscal eletrônico.
`email`	`email`	`TString`	60
`telefone`	`fone`	`string`

`nota.icms`

Campo	Vira	Tipo	Valores	O que é
`origem`	`orig`	`string`	`0` `1` `2` `3` `4` `5` `6` `7` `8`
`cst`	`CST`	`string`	`00`
`csosn`	`CSOSN`	`string`	`101`
`modalidade_bc`	`modBC`	`string`	`0` `1` `2` `3`	Modalidade de determinação da BC do ICMS: 0 - Margem Valor Agregado (%); 1 - Pauta (valor); 2 - Preço Tabelado Máximo (valor); 3 - Valor da Operação.
`valor_bc`	`vBC`	`string`
`aliquota`	`pICMS`	`string`
`valor`	`vICMS`	`string`
`reducao_bc`	`pRedBC`	`string`		Percentual de redução da BC
`modalidade_bc_st`	`modBCST`	`string`	`0` `1` `2` `3` `4` `5` `6`
`mva_st`	`pMVAST`	`string`
`reducao_bc_st`	`pRedBCST`	`string`
`valor_bc_st`	`vBCST`	`string`
`aliquota_st`	`pICMSST`	`string`
`valor_st`	`vICMSST`	`string`
`valor_desonerado`	`vICMSDeson`	`string`
`motivo_desoneracao`	`motDesICMS`	`string`	`3` `9` `12`
`credito_sn_aliquota`	`pCredSN`	`string`		Alíquota aplicável de cálculo do crédito (Simples Nacional). (v2.0)
`credito_sn_valor`	`vCredICMSSN`	`string`		Valor crédito do ICMS que pode ser aproveitado nos termos do art. 23 da LC 123 (Simples Nacional) (v2.0)

`nota.ipi`

Campo	Vira	Tipo	Tam.	Valores	O que é
`cst`	`CST`	`string`		`00`
`enquadramento`	`cEnq`	`TString`	3		Código de Enquadramento Legal do IPI (tabela a ser criada pela RFB)
`valor_bc`	`vBC`	`string`
`aliquota`	`pIPI`	`string`			Alíquota do IPI
`valor`	`vIPI`	`string`

`nota.pis`

Campo	Vira	Tipo	Valores
`cst`	`CST`	`string`	`00`
`valor_bc`	`vBC`	`string`
`aliquota`	`pPIS`	`string`
`valor`	`vPIS`	`string`

`nota.cofins`

Campo	Vira	Tipo	Valores
`cst`	`CST`	`string`	`00`
`valor_bc`	`vBC`	`string`
`aliquota`	`pCOFINS`	`string`
`valor`	`vCOFINS`	`string`

`nota.is_`

Campo	Vira	Tipo	O que é
`cst`	`CSTIS`	`string`	Código Situação Tributária do Imposto Seletivo
`classificacao`	`cClassTribIS`	`string`
`valor_bc`	`vBCIS`	`string`	Valor do BC
`aliquota`	`pIS`	`string`	Alíquota do Imposto Seletivo (percentual)
`valor`	`vIS`	`string`

`nota.ibscbs`

Campo	Vira	Tipo	Tam.	Valores	O que é
`cst`	`CST`	`string`		`00`
`classificacao`	`cClassTrib`	`string`

`nota.ibs_uf`

Campo	Vira	Tipo	O que é
`valor_bc`	`vBC`	`string`
`aliquota`	`pIBSUF`	`string`	Aliquota do IBS de competência das UF (em percentual)
`valor`	`vIBSUF`	`string`

`nota.ibs_mun`

Campo	Vira	Tipo	O que é
`valor_bc`	`vBC`	`string`
`aliquota`	`pIBSMun`	`string`	Aliquota do IBS Municipal (em percentual)
`valor`	`vIBSMun`	`string`

`nota.cbs`

Campo	Vira	Tipo	O que é
`valor_bc`	`vBC`	`string`
`aliquota`	`pCBS`	`string`	Aliquota da CBS (em percentual)
`valor`	`vCBS`	`string`

Grupos que passam direto

Em 7 grupos o campo vai para o layout com o mesmo nome, sem tradução: is_total · ibscbs_total · issqn · ibs · cbs · uf · mun

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.

Como ler​

nota.identificacao​

nota.emitente​

nota.destinatario​

nota.produtos[]​

nota.total​

nota.transportador​

nota.volumes[]​

nota.fatura​

nota.duplicatas[]​

nota.pagamentos[]​

nota.informacoes_adicionais​

nota.responsavel_tecnico​

nota.icms​

nota.ipi​

nota.pis​

nota.cofins​

nota.is_​

nota.ibscbs​

nota.ibs_uf​

nota.ibs_mun​

nota.cbs​

Grupos que passam direto​

O que esta página não cobre​