ItemNotaFiscalXML
Descrição
Item da nota fiscal
Atributos
numero_item (obrigatório) Integer[1-3] Tag XML nItem
Número (índice) do item na nota fiscal, começando por 1
.
codigo_produto (obrigatório) String[1-60] Tag XML cProd
Código interno do produto. Se não existir deve ser usado o CFOP no formato CFOP9999.
codigo_barras_comercial Integer[0,8,12,13,14] Tag XML cEAN
Código GTIN/EAN do produto.
descricao (obrigatório) String[1-120] Tag XML xProd
Descrição do produto.
codigo_ncm (obrigatório) Integer[2,8] Tag XML NCM
Código NCM do produto. É permitida a informação do gênero (posição
do capítulo da NCM) se a operação não for de comércio exterior
(importação/exportação) ou o produto não for tributado pelo IPI. Em
caso de item de serviço ou item que não tenha produto (ex. transferência
de crédito, crédito do ativo imobilizado etc.) informar o código
00
.
nves Coleção[0-8] [coleção: NveXML]
Codificação NVE - Nomenclatura de Valor Aduaneiro e Estatística (codificação opcional que detalha alguns NCM) Se a mercadoria se enquadrar em mais de uma codificação, informar até 8 codificações principais
codigo_cest Integer[7] Tag XML CEST
Código Especificador da Substituição Tributária – CEST, que identifica a mercadoria sujeita aos regimes de substituicao tributária e de antecipação do recolhimento do imposto. Obrigatório para produto em que incide Substituição Tributária (ICMS-ST)
codigo_ex_tipi Integer[2-3] Tag XML EXTIPI
Código EX TIPI do produto.
cfop (obrigatório) Integer[4] Tag XML CFOP
CFOP do produto.
unidade_comercial (obrigatório) String[1-6] Tag XML uCom
Unidade comercial
quantidade_comercial (obrigatório) Decimal[11.0-4] Tag XML qCom
Quantidade comercial
valor_unitario_comercial (obrigatório) Decimal[11.0-10] Tag XML vUnCom
Valor unitário comercial.
valor_bruto (obrigatório) Decimal[13.2] Tag XML vProd
Valor bruto. Deve ser igual ao produto de Valor unitário comercial com quantidade comercial.
codigo_barras_tributavel Integer[0,8,12,13,14] Tag XML cEANTrib
Código GTIN/EAN tributável.
unidade_tributavel (obrigatório) String[1-6] Tag XML uTrib
Unidade tributável.
quantidade_tributavel (obrigatório) Decimal[11.0-4] Tag XML qTrib
Quantidade tributável.
valor_unitario_tributavel (obrigatório) Decimal[11.0-10] Tag XML vUnTrib
Valor unitário tributável.
valor_frete Decimal[13.2] Tag XML vFrete
Valor do frete.
valor_seguro Decimal[13.2] Tag XML vSeg
Valor do seguro.
valor_desconto Decimal[13.2] Tag XML vDesc
Valor do desconto.
valor_outras_despesas Decimal[13.2] Tag XML vOutro
Valor de outras despesas acessórias.
inclui_no_total (obrigatório) Tag XML indTot
Valor do item (valor_bruto
) compõe valor total da NFe
(valor_produtos
)?
documentos_importacao Coleção[0-100] [coleção: DocumentoImportacaoXML]
Documentos de importação.
detalhes_exportacao Coleção[0-500] [coleção: DetalheExportacaoXML]
Detalhes de exportação
pedido_compra String[1-15] Tag XML xPed
Pedido de Compra.
numero_item_pedido_compra Integer[0-6] Tag XML nItemPed
Número do Item de Pedido de Compra.
numero_fci String[36] Tag XML nFCI
Número da FCI (Ficha de Conteúdo de Importação) veja NT 2013/006
veiculo_tipo_operacao Tag XML tpOp
Tipo da operação.
veiculo_chassi String[17] Tag XML chassi
Chassi do veículo - VIN.
veiculo_codigo_cor String[1-4] Tag XML cCor
Cor do veículo (código de cada montadora).
veiculo_descricao_cor String[1-40] Tag XML xCor
Descrição da cor.
veiculo_potencia_motor String[1-4] Tag XML pot
Potência máxima do motor em cavalo-vapor (CV).
veiculo_cm3 String[1-4] Tag XML cilin
Capacidade voluntária do motor em centímetros cúbicos (cilindradas/CC).
veiculo_peso_liquido String[1-9] Tag XML pesoL
Peso líquido.
veiculo_peso_bruto String[1-9] Tag XML pesoB
Peso bruto.
veiculo_serie String[1-9] Tag XML nSerie
Número de série.
veiculo_tipo_combustivel Tag XML tpComb
Tipo de combustível (utilizar tabela do RENAVAM):
-
01
: álcool -
02
: gasolina -
03
: diesel -
(…)
-
16
: álcool/gasolina -
17
: gasolina/álcool/GNV -
18
: gasolina/elétrico
veiculo_numero_motor String[1-21] Tag XML nMotor
Número do motor.
veiculo_cmt String[1-9] Tag XML CMT
Capacidade máxima de tração em toneladas (4 casas decimais).
veiculo_distancia_eixos String[1-4] Tag XML dist
Distância entre eixos.
veiculo_ano_modelo Integer[4] Tag XML anoMod
Ano do modelo.
veiculo_ano_fabricacao Integer[4] Tag XML anoFab
Ano de fabricação.
veiculo_tipo_pintura String[1] Tag XML tpPint
Tipo de pintura.
veiculo_tipo Integer[1-2] Tag XML tpVeic
Tipo de veículo (utilizar tabela RENAVAM).
veiculo_especie Integer[1] Tag XML espVeic
Espécie de veículo (utilizar tabela RENAVAM).
veiculo_codigo_vin Tag XML VIN
Veículo tem VIN remarcado?
-
R
: remarcado -
N
: normal
veiculo_condicao Tag XML condVeic
Condição do veículo.
veiculo_codigo_marca_modelo Integer[1-6] Tag XML cMod
Código Marca Modelo (utilizar tabela RENAVAM).
veiculo_codigo_cor_denatran Tag XML cCorDENATRAN
Código da cor segundo as regras de pré-cadastro do DENATRAN.
-
01
: amarelo -
02
: azul -
03
: bege -
04
: branca -
05
: cinza -
06
: dourada -
07
: grena -
08
: laranja -
09
: marrom -
10
: prata -
11
: preta -
12
: rosa -
13
: roxa -
14
: verde -
15
: vermelha -
16
: fantasia
veiculo_lotacao Integer[1-3] Tag XML lota
Quantidade máxima permitida de passageiros sentados, inclusive motorista.
veiculo_restricao Tag XML tpRest
Restrição.
-
0
: não há -
1
: alienação fiduciária -
2
: arrendamento mercantil -
3
: reserva de domínio -
4
: penhor de veículos -
9
: outras
medicamento_numero_lote String[1-20] Tag XML nLote
Número do lote.
medicamento_quantidade_lote Decimal[8.3] Tag XML qLote
Quantidade de produtos no Lote.
medicamento_data_fabricacao Tag XML dFab
Data de Fabricaçao do medicamento
medicamento_data_validade Tag XML dVal
Data de Validade do medicamento
medicamento_preco_maximo_consumidor Decimal[13.2] Tag XML vPMC
Preço Máximo ao consumidor
combustivel_codigo_anp Integer[9] Tag XML cProdANP
Código de produto da ANP (www.anp.gov.br/simp/)
combustivel_percentual_gas_natural Decimal[3.4] Tag XML pMixGN
Percentual de Gás Natural para o produto GLP - informar apenas quando combustivel_codigo_anp=210203001)
combustivel_registro_codif Integer[21] Tag XML CODIF
Código de autorização / registro do CODIF - Informar apenas quando a UF utilizar o CODIF
combustivel_quantidade_temperatura_ambiente Decimal[12.4] Tag XML qTemp
Quantidade de combustível faturada à temperatura ambiente - Informar quando a quantidade faturada informada no campo quantidade do produto tiver sido ajustada para uma temperatura diferente da ambiente.
combustivel_sigla_uf String[2] Tag XML UFCons
Sigla da UF de consumo - Informar “EX” para exterior
combustivel_cide_base_calculo Decimal[12.4] Tag XML qBCProd
BC da CIDE em quantidade
combustivel_cide_aliquota Decimal[11.4] Tag XML vAliqProd
Valor da alíquota da CIDE em reais
combustivel_cide_valor Decimal[13.2] Tag XML vCIDE
Valor da CIDE
valor_total_tributos Decimal[13.2] Tag XML vTotTrib
Valor total aproximado dos tributos - calculado automaticamente pela API
issqn_base_calculo Decimal[13.2] Tag XML 'vBC'
Valor da Base de Cálculo do ISSQN
issqn_aliquota Decimal[3.2-4] Tag XML 'vAliq'
Alíquota do ISSQN
issqn_valor Decimal[13.2] Tag XML 'vISSQN'
Valor do ISSQN
issqn_codigo_municipio Integer[7] Tag XML cMunFG
Código do município de ocorrência do fato gerador do ISSQN
issqn_item_lista_servico String[5] Tag XML cListServ
Item da Lista de Serviços do ISSQN. Formato: NN.NN
issqn_valor_deducao Decimal[13.2] Tag XML vDeducao
Valor dedução para redução da Base de Cálculo do ISSQN
issqn_valor_outras_retencoes Decimal[13.2] Tag XML vOutro
Valor outras retenções do ISSQN
issqn_valor_desconto_incondicionado Decimal[13.2] Tag XML vDescIncond
Valor desconto incondicionado do ISSQN
issqn_valor_desconto_condicionado Decimal[13.2] Tag XML vDescCond
Valor desconto condicionado do ISSQN
issqn_valor_retencao Decimal[13.2] Tag XML vISSRet
Valor retenção ISS
issqn_indicador_exigibilidade Tag XML indISS
Indicador da exigibilidade do ISS: (valor default: 1)
issqn_codigo_servico String[1-20] Tag XML cServico
Código do serviço prestado dentro do município
issqn_codigo_municipio_incidencia Integer[7] Tag XML cMun
Código do Município de incidência do imposto ISSQN - Tabela do IBGE. Informar “9999999” para serviço fora do País.
issqn_codigo_pais Integer[4] Tag XML cPais
Código do País onde o serviço foi prestado - Tabela do BACEN. Infomar somente se o município da prestação do serviço for “9999999”.
issqn_numero_processo String[1-30] Tag XML nProcesso
Número do processo judicial ou administrativo de suspensão da exigibilidade - Informar somente quando declarada a suspensão da exigibilidade do ISSQN
issqn_indicador_incentivo Integer[1] Tag XML indIncentivo
Indicador de incentivo Fiscal ISSQN
icms_origem (obrigatório) Tag XML orig
Origem da mercadoria.
icms_situacao_tributaria (obrigatório) Tag XML ICMSST ou CSOSN
Situação tributária do ICMS.
icms_modalidade_base_calculo Tag XML modBC
Modalidade de determinação da base de cálculo do ICMS.
icms_base_calculo Decimal[13.2] Tag XML vBC
Valor da base de cálculo do ICMS.
icms_base_calculo_retido_st Decimal[13.2] Tag XML vBCSTRet
Valor da base de cálculo do ICMS retido anteriormente.
icms_reducao_base_calculo Decimal[3.2-4] Tag XML pRedBC
Percentual de redução da base de cálculo.
icms_aliquota Decimal[3.2-4] Tag XML pICMS
Alíquota do ICMS.
icms_valor Decimal[13.2] Tag XML vICMS
Valor do ICMS.
icms_valor_retido_st Decimal[13.2] Tag XML vICMSSTRet
Valor do ICMS retido anteriormente.
icms_valor_desonerado Decimal[13.2] Tag XML vICMSDeson
Valor do ICMS desonerado.
icms_valor_operacao Decimal[13.2] Tag XML vICMSOp
(CST=51) Valor como se não tivesse o diferimento
icms_percentual_diferimento Decimal[3.2-4] Tag XML pDif
(CST=51) Percentual de diferimento
icms_valor_diferido Decimal[13.2] Tag XML vICMSDif
(CST=51) Valor do ICMS diferido (informar o valor realmente devido no campo icms_valor)
icms_motivo_desoneracao Tag XML motDesICMS
Motivo da desoneração do ICMS.
icms_modalidade_base_calculo_st Tag XML modBCST
Modalidade de determinação da base de cálculo do ICMS ST.
icms_margem_valor_adicionado_st Decimal[3.2-4] Tag XML pMVAST
Percentual da margem de valor adicionado do ICMS ST.
icms_reducao_base_calculo_st Decimal[3.2-4] Tag XML pRedBCST
Percentual de redução da base de cálculo do ICMS ST.
icms_base_calculo_st Decimal[13.2] Tag XML vBCST
Valor da base de cálculo do ICMS ST.
icms_aliquota_st Decimal[3.2-4] Tag XML pICMSST
Alíquota do ICMS ST.
icms_valor_st Decimal[13.2] Tag XML vICMSST
Valor do ICMS ST.
icms_aliquota_credito_simples Decimal[13.2] Tag XML pCredSN
Alíquota aplicável de cálculo do crédito (Apenas Simples Nacional).
icms_valor_credito_simples Decimal[13.2] Tag XML vCredICMSSN
Valor crédito do ICMS que pode ser aproveitado nos termos do art. 23 da LC 123 (Apenas Simples Nacional)
ipi_situacao_tributaria Tag XML CST
Situação tributária do IPI.
ipi_base_calculo Decimal[13.2] Tag XML vBC
Valor da base de cálculo do IPI.
ipi_aliquota Decimal[3.2-4] Tag XML pIPI
Alíquota do IPI.
ipi_quantidade_total Decimal[12.0-4] Tag XML qUnid
Quantidade total na unidade padrão para tributação.
ipi_valor_por_unidade_tributavel Decimal[11.0-4] Tag XML vUnid
Valor por unidade tributável. Informar o valor do imposto pauta por unidade de medida.
ipi_valor Decimal[13.2] Tag XML vIPI
Valor do IPI.
ipi_classe_enquadramento String[1-5] Tag XML clEnq
Classe de enquadramento do IPI (para cigarros e bebidas).
ipi_cnpj_produtor String[14] Tag XML CNPJProd
CNPJ do produtor. Informar apenas quando for diferente do emitente, em casos
ipi_codigo_selo_controle String[1-60] Tag XML cSelo
Código do selo de controle do IPI.
ipi_quantidade_selo_controle Integer[1-12] Tag XML qSelo
Quantidade de selo de controle.
ipi_codigo_enquadramento_legal Integer[3] Tag XML cEnq
Código de Enquadramento Legal do IPI. Obrigatório quando informado IPI. Utilize o valor 999 se não aplicável
ii_base_calculo Decimal[13.2] Tag XML vBC
Base de cálculo do imposto de importação.
ii_despesas_aduaneiras Decimal[13.2] Tag XML vDespAdu
Valor das despesas aduaneiras.
ii_valor Decimal[13.2] Tag XML vII
Valor do imposto de importação.
ii_valor_iof Decimal[13.2] Tag XML vIOF
Valor do IOF.
pis_situacao_tributaria (obrigatório) Tag XML CST
Situação tributária do PIS.
pis_base_calculo Decimal[13.2] Tag XML vBC
Valor da base de cálculo do PIS.
pis_aliquota_porcentual Decimal[3.2-4] Tag XML pPIS
Alíquota do PIS em porcentual.
pis_quantidade_vendida Decimal[12.0-4] Tag XML qBCProd
Quantidade vendida.
pis_aliquota_valor Decimal[3.2-4] Tag XML vAliqProd
Alíquota do PIS em unidades monetarias.
pis_valor Decimal[13.2] Tag XML vPIS
Valor do PIS.
pis_base_calculo_st Decimal[13.2] Tag XML vBC
Valor da base de cálculo do PIS ST.
pis_aliquota_porcentual_st Decimal[3.2-4] Tag XML pPIS
Alíquota do PIS ST (em percentual).
pis_quantidade_vendida_st Decimal[12.0-4] Tag XML qBCProd
Quantidade vendida.
pis_aliquota_valor_st Decimal[3.2-4] Tag XML vAliqProd
Alíquota do PIS ST (em unidades monetarias).
pis_valor_st Decimal[13.2] Tag XML vPIS
Valor do PIS ST.
cofins_situacao_tributaria (obrigatório) Tag XML CST
Situação tributária do PIS.
cofins_base_calculo Decimal[13.2] Tag XML vBC
Valor da base de cálculo do COFINS.
cofins_aliquota_porcentual Decimal[3.2-4] Tag XML pCOFINS
Alíquota do COFINS em porcentual.
cofins_quantidade_vendida Decimal[12.0-4] Tag XML qBCProd
Quantidade vendida.
cofins_aliquota_valor Decimal[3.2-4] Tag XML vAliqProd
Alíquota do COFINS em unidades monetarias.
cofins_valor Decimal[13.2] Tag XML vCOFINS
Valor do COFINS.
cofins_base_calculo_st Decimal[13.2] Tag XML vBC
Valor da base de cálculo do COFINS ST.
cofins_aliquota_porcentual_st Decimal[3.2-4] Tag XML pCOFINS
Alíquota do COFINS ST (em percentual).
cofins_quantidade_vendida_st Decimal[12.0-4] Tag XML qBCProd
Quantidade vendida.
cofins_aliquota_valor_st Decimal[11.0-4] Tag XML vAliqProd
Alíquota do COFINS ST (em unidades monetarias).
cofins_valor_st Decimal[13.2] Tag XML vCOFINS
Valor do COFINS ST.
icms_base_calculo_uf_destino Tag XML 'vBCUFDest'
(apenas para venda interestadual para consumidor final) Valor da BC do ICMS na UF de destino
icms_percentual_fcp Tag XML 'pFCPUFDest'
(apenas para venda interestadual para consumidor final) Percentual do ICMS relativo ao Fundo de Combate à Pobreza (FCP) na UF de destino
icms_aliquota_interna_uf_destino Tag XML 'pICMSUFDest'
(apenas para venda interestadual para consumidor final) Alíquota interna da UF de destino
icms_aliquota_interestadual Tag XML 'pICMSInter'
(apenas para venda interestadual para consumidor final) Alíquota interestadual das UF envolvidas
icms_percentual_partilha Tag XML 'pICMSInterPart'
(apenas para venda interestadual para consumidor final) Percentual provisório de partilha do ICMS Interestadual
icms_valor_fcp Tag XML 'vFCPUFDest'
(apenas para venda interestadual para consumidor final) Valor do ICMS relativo ao Fundo de Combate à Pobreza (FCP) da UF de destino
icms_valor_uf_destino Tag XML 'vICMSUFDest'
(apenas para venda interestadual para consumidor final) Valor do ICMS Interestadual para a UF de destino
icms_valor_uf_remetente Tag XML 'vICMSUFRemet'
(apenas para venda interestadual para consumidor final) Valor do ICMS Interestadual para a UF do remetente
percentual_devolvido Decimal[3.2] Tag XML pDevol
Percentual da mercadoria devolvida
valor_ipi_devolvido Decimal[13.2] Tag XML vIPIDevol
Valor do IPI devolvido
informacoes_adicionais_item String[1-500] Tag XML infAdProd
Informações adicionais do item