---
title: "ItemNfeInputModel"
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/schemas/ItemNfeInputModel"
---
> Full API specification: https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050.md
# ItemNfeInputModel
Dados do item da NFe.
## OpenAPI definition
```yaml
openapi: 3.0.4
info:
title: Stone Tax API
version: 1.0.0
servers:
- url: https://stone-tax-sdx.stone.com.br
description: Ambiente de Desenvolvimento
- url: https://stone-tax.stone.com.br
description: Ambiente de Produção
components:
schemas:
TipoItemNotaModelEnum:
enum:
- Produto
- Servico
type: string
description: Tipo do item da nota.
OrigemMercadoriaNotaFiscalModelEnum:
enum:
- Nacional
- EstrangeiraImportacaoDireta
- EstrangeiraAdquiridaMercadoInterno
- NacionalConteudoImportacaoEntre40e70
- NacionalProducaoEmConformidade
- NacionalConteudoImportacaoMenorQue40
- EstrangeiraImportacaoDiretaSemSimilarNacional
- EstrangeiraAdquiridaMercadoInternoSemSimilarNacional
- NacionalConteudoImportacaoSuperior70
type: string
description: Origem da mercadoria.
ItemNfeImpostoInputModel:
required:
- cofins
- pis
type: object
properties:
icms:
$ref: "#/components/schemas/ItemNfeTributacaoIcmsInputModel"
icmssn:
$ref: "#/components/schemas/ItemNfeTributacaoIcmssnInputModel"
icmsUfDest:
$ref: "#/components/schemas/ItemNfeTributacaoIcmsUfDestInputModel"
issqn:
$ref: "#/components/schemas/ItemNfeTributacaoIssqnInputModel"
ipi:
$ref: "#/components/schemas/ItemNfeTributacaoIpiInputModel"
pis:
$ref: "#/components/schemas/ItemNfeTributacaoPisInputModel"
cofins:
$ref: "#/components/schemas/ItemNfeTributacaoCofinsInputModel"
impostoImportacao:
$ref: "#/components/schemas/ItemNfeImpostoImportacaoInputModel"
ibsCbs:
$ref: "#/components/schemas/ItemNfeTributacaoIbsCbsInputModel"
additionalProperties: false
description: Dados do imposto do item da nota fiscal.
ItemNfeImpostoDevolvidoInputModel:
required:
- percentualMercadoriaDevolvida
- valorIpiDevolvido
type: object
properties:
percentualMercadoriaDevolvida:
maximum: 100
minimum: 0
type: number
description: Percentual de mercadoria devolvida.
format: double
valorIpiDevolvido:
minimum: 0
type: number
description: Valor do IPI devolvido.
format: double
additionalProperties: false
description: Dados do imposto devolvido do item da nota fiscal.
ItemNfeDeclaracaoImportacaoInputModel:
required:
- adicoes
- codigoExportador
- dataDesembaraco
- dataRegistro
- localDesembaraco
- numeroDi
- tipoIntermedio
- tipoViaTransporte
- ufDesembaraco
- valorAfrmm
type: object
properties:
numeroDi:
maxLength: 12
minLength: 1
type: string
description: Número do Documento de Importação (DI, DSI, DIRE, ...).
dataRegistro:
type: string
description: Data de Registro do documento.
format: date
example: 2025-03-31
localDesembaraco:
maxLength: 60
minLength: 1
type: string
description: Local de desembaraço.
ufDesembaraco:
$ref: "#/components/schemas/UfNotaFiscalModelEnum"
dataDesembaraco:
type: string
description: Data do Desembaraço Aduaneiro.
format: date
example: 2025-03-31
tipoViaTransporte:
$ref: "#/components/schemas/TipoViaTransporteNotaFiscalModelEnum"
valorAfrmm:
type: number
description: Valor da AFRMM - Adicional ao Frete para Renovação da Marinha
Mercante.
format: double
tipoIntermedio:
$ref: "#/components/schemas/TipoIntermedioImportacaoNotaFiscalModelEnum"
cnpjEncomendante:
type: string
description: CNPJ do adquirente ou do encomendante.
nullable: true
ufEncomendante:
$ref: "#/components/schemas/UfExtNotaFiscalModelEnum"
codigoExportador:
maxLength: 60
minLength: 1
type: string
description: Código do Exportador.
adicoes:
minItems: 1
type: array
items:
$ref: "#/components/schemas/ItemNfeDeclaracaoImportacaoAdicaoInputModel"
description: Adições da declaração de importação do item da nota fiscal.
additionalProperties: false
description: Informações da declaração de importação do item da nota fiscal.
ItemNfeExportacaoInputModel:
required:
- chaveNotaExportacaoIndireta
- numeroDrawback
- numeroRegistroExportacaoIndireta
- quantidadeExportacaoIndireta
type: object
properties:
numeroDrawback:
maxLength: 11
minLength: 1
type: string
description: Número do ato concessório de Drawback.
numeroRegistroExportacaoIndireta:
maxLength: 12
minLength: 1
type: string
description: Número do Registro de Exportação.
chaveNotaExportacaoIndireta:
minLength: 1
pattern: ^\d{44}$
type: string
description: Chave de Acesso da NF-e recebida para exportação.
quantidadeExportacaoIndireta:
minimum: 0
exclusiveMinimum: true
type: number
description: Quantidade do item realmente exportado.
format: double
additionalProperties: false
description: Dados de exportação do item da nota fiscal.
ItemNfeProdutoEspecificoInputModel:
required:
- tipoProdutoEspecifico
type: object
properties:
tipoProdutoEspecifico:
$ref: "#/components/schemas/TipoProdutoEspecificoNotaFiscalModelEnum"
additionalProperties: false
description: |-
Modelo abstrato para os Dados de Produto Específico do item da nota fiscal.
O preenchimento dos campos abaixo é condicional ao TipoProdutoEspecifico informado.
*************************************************************************
Medicamento:
• TipoProdutoEspecifico: Medicamento.
• CodigoAnvisa (string): Código de Produto da ANVISA (13 dígitos).
• MotivoIsensao (string): Texto explicativo do motivo da isenção da ANVISA.
• ValorPmc (decimal): Preço Máximo ao Consumidor.
*************************************************************************
Dicionário de Enumeradores:
• TipoProdutoEspecificoNotaFiscalModelEnum:
Medicamento = Produtos farmacêuticos e medicamentos.
ItemNfeTributacaoIcmsInputModel:
required:
- cst
type: object
properties:
cst:
$ref: "#/components/schemas/CstIcmsNfeModelEnum"
additionalProperties: false
description: |-
Modelo abstrato para a Tributação de ICMS da nota fiscal.
O preenchimento dos campos abaixo é condicional ao CST informado.
*************************************************************************
CST 00 - Tributado integralmente:
• Cst: 00.
• ModalidadeBaseIcms (Enum): Modalidade de determinação da base ICMS.
• BaseIcms (decimal): Valor da base de cálculo do ICMS.
• AliquotaIcms (decimal): Alíquota do imposto ICMS.
• ValorIcms (decimal): Valor do ICMS resultante.
• BaseFcp (decimal): Valor da base de cálculo do FCP.
• AliquotaFcp (decimal): Alíquota do FCP.
• ValorFcp (decimal): Valor do FCP resultante.
*************************************************************************
CST 02 - Monofásica sobre Combustíveis:
• Cst: 02.
• AliquotaQuantidade (decimal): Alíquota ad rem do imposto (valor por quantidade).
• ValorIcms (decimal): Valor do ICMS monofásico.
*************************************************************************
CST 10 - Tributada com cobrança de ICMS ST:
• Cst: 10.
• ModalidadeBaseIcms (Enum): Modalidade de determinação da base ICMS.
• BaseIcms (decimal): Base de cálculo do ICMS próprio.
• AliquotaIcms (decimal): Alíquota do ICMS próprio.
• ValorIcms (decimal): Valor do ICMS próprio.
• ModalidadeBaseSt (Enum): Modalidade de determinação da base de ICMS ST.
• Mva (decimal): Percentual da margem de valor adicionado (MVA).
• ReducaoBaseSt (decimal): Percentual de redução de base ICMS ST.
• BaseSt (decimal): Valor da base de cálculo do ICMS ST.
• AliquotaSt (decimal): Alíquota do imposto ICMS ST.
• ValorSt (decimal): Valor do ICMS ST resultante.
• BaseFcp (decimal): Base de cálculo do FCP próprio.
• AliquotaFcp (decimal): Alíquota do FCP próprio.
• ValorFcp (decimal): Valor do FCP próprio.
• BaseFcpSt (decimal): Base de cálculo do FCP retido por ST.
• AliquotaFcpSt (decimal): Alíquota do FCP ST.
• ValorFcpSt (decimal): Valor do FCP ST resultante.
*************************************************************************
CST 15 - Monofásica com retenção sobre Combustíveis:
• Cst: 15.
• AliquotaQuantidade (decimal): Alíquota ad rem do imposto (própria).
• ValorIcms (decimal): Valor do ICMS próprio.
• AliquotaRetencaoQuantidade (decimal): Alíquota ad rem do imposto retido.
• ValorIcmsRetido (decimal): Valor do ICMS monofásico retido.
*************************************************************************
CST 20 - Tributado com redução de base de cálculo:
• Cst: 20.
• ModalidadeBaseIcms (Enum): Modalidade de determinação da base ICMS.
• BaseIcms (decimal): Valor da base de cálculo do ICMS.
• ReducaoBaseIcms (decimal): Percentual de redução de base ICMS.
• AliquotaIcms (decimal): Alíquota do imposto ICMS.
• ValorIcms (decimal): Valor do ICMS resultante.
• MotivoDesoneracao (Enum): Motivo da desoneração do ICMS.
• ValorIcmsDesonerado (decimal): Valor do ICMS desonerado.
• DesoneracaoDeduzValorItem (boleano): Indica se a desoneração está deduzindo no valor do item.
• CodigoBeneficio (string): Código de benefício fiscal.
• BaseFcp (decimal): Base de cálculo do FCP.
• AliquotaFcp (decimal): Alíquota do FCP.
• ValorFcp (decimal): Valor do FCP resultante.
*************************************************************************
CST 30 - Isenta/Não Tributada com cobrança de ICMS ST:
• Cst: 30.
• ModalidadeBaseSt (Enum): Modalidade de determinação da base ICMS ST.
• Mva (decimal): Percentual de MVA ST.
• ReducaoBaseSt (decimal): Percentual de redução de base ST.
• BaseSt (decimal): Valor da base de cálculo do ICMS ST.
• AliquotaSt (decimal): Alíquota do imposto ICMS ST.
• ValorSt (decimal): Valor do ICMS ST resultante.
• MotivoDesoneracao (Enum): Motivo da desoneração do ICMS.
• ValorIcmsDesonerado (decimal): Valor do ICMS desonerado.
• DesoneracaoDeduzValorItem (boleano): Indica se a desoneração está deduzindo no valor do item.
• CodigoBeneficio (string): Código de benefício fiscal.
• BaseFcpSt (decimal): Base de cálculo do FCP ST.
• AliquotaFcpSt (decimal): Alíquota do FCP ST.
• ValorFcpSt (decimal): Valor do FCP ST resultante.
*************************************************************************
CST 40, 41 e 50 - Isenta, Não Tributada ou Suspensão:
• Cst: (40, 41 ou 50).
• MotivoDesoneracao (Enum): Motivo da desoneração do ICMS.
• ValorIcmsDesonerado (decimal): Valor do ICMS desonerado.
• DesoneracaoDeduzValorItem (boleano): Indica se a desoneração está deduzindo no valor do item.
• CodigoBeneficio (string): Código de benefício fiscal.
*************************************************************************
CST 51 - Tributação com Diferimento:
• Cst: 51.
• ModalidadeBaseIcms (Enum): Modalidade de determinação da base ICMS.
• BaseIcms (decimal): Valor da base de cálculo do ICMS.
• AliquotaIcms (decimal): Alíquota do imposto ICMS.
• ValorIcmsOperacao (decimal): Valor do ICMS da operação (sem diferimento).
• PercentualDiferimento (decimal): Percentual do diferimento aplicado.
• ValorIcmsDiferido (decimal): Valor do ICMS diferido.
• ValorIcms (decimal): Valor do ICMS efetivamente devido.
• BaseFcp (decimal): Base de cálculo do FCP.
• AliquotaFcp (decimal): Alíquota do FCP.
• ValorFcp (decimal): Valor do FCP resultante.
*************************************************************************
CST 53 - Monofásica sobre Combustíveis com Diferimento:
• Cst: 53.
• AliquotaQuantidadeDiferida (decimal): Alíquota ad rem diferida.
• ValorIcmsDiferido (decimal): Valor do ICMS diferido.
*************************************************************************
CST 60 - Cobrado anteriormente por substituição tributária:
• Cst: 60.
• BaseIcmsRetidoAnteriormente (decimal): Base de ICMS retido anteriormente.
• AliquotaRetidoAnteriormente (decimal): Alíquota de ICMS retido anteriormente.
• ValorIcmsProprioSubstituto (decimal): Valor do ICMS próprio do Substituto.
• ValorIcmsRetidoAnteriormente (decimal): Valor do ICMS retido anteriormente.
• BaseFcpRetidoAnteriormente (decimal): Base de FCP retido anteriormente.
• AliquotaFcpRetidoAnteriormente (decimal): Alíquota de FCP retido anteriormente.
• ValorFcpRetidoAnteriormente (decimal): Valor de FCP retido anteriormente.
• BaseEfetivaIcmsRetido (decimal): Base de ICMS efetivo se ouvesse a cobrança normal de ICMS.
• PercentualReducaoBaseEfetivaIcmsRetido (decimal): Percentual de redução da base de ICMS efetiva se ouvesse a cobrança normal do ICMS.
• AliquotaEfetivaIcmsRetido (decimal): Alíquota de ICMS efetivo se ouvesse a cobrança normal do ICMS.
• ValorEfetivoIcmsRetido (decimal): Valor do ICMS efetivo se ouvesse a cobrança normal de ICMS.
*************************************************************************
CST 61 - Monofásica sobre Combustíveis cobrada anteriormente:
• Cst: 61.
• AliquotaQuantidadeRetida (decimal): Alíquota ad rem retida anteriormente.
• ValorIcmsRetido (decimal): Valor do ICMS retido anteriormente.
*************************************************************************
CST 70 - Redução de base e cobrança de ICMS ST:
• Cst: 70.
• ModalidadeBaseIcms (Enum): Modalidade de determinação da base ICMS.
• BaseIcms (decimal): Base de cálculo do ICMS próprio.
• ReducaoBaseIcms (decimal): Percentual de redução de base própria.
• AliquotaIcms (decimal): Alíquota do ICMS próprio.
• ValorIcms (decimal): Valor do ICMS próprio.
• MotivoDesoneracao (Enum): Motivo da desoneração do ICMS.
• ValorIcmsDesonerado (decimal): Valor do ICMS desonerado.
• DesoneracaoDeduzValorItem (boleano): Indica se a desoneração está deduzindo no valor do item.
• CodigoBeneficio (string): Código de benefício fiscal.
• ModalidadeBaseSt (Enum): Modalidade de determinação da base ICMS ST.
• Mva (decimal): Percentual de MVA ST.
• ReducaoBaseSt (decimal): Percentual de redução de base ST.
• BaseSt (decimal): Valor da base de cálculo do ICMS ST.
• AliquotaSt (decimal): Alíquota do imposto ICMS ST.
• ValorSt (decimal): Valor do ICMS ST resultante.
• BaseFcp (decimal): Base de cálculo do FCP próprio.
• AliquotaFcp (decimal): Alíquota do FCP próprio.
• ValorFcp (decimal): Valor do FCP próprio.
• BaseFcpSt (decimal): Base de cálculo do FCP ST.
• AliquotaFcpSt (decimal): Alíquota do FCP ST.
• ValorFcpSt (decimal): Valor do FCP ST resultante.
*************************************************************************
CST 90 - Outros:
• Cst: 90.
• ModalidadeBaseIcms (Enum): Modalidade de determinação da base ICMS.
• BaseIcms (decimal): Valor da base de cálculo própria.
• ReducaoBaseIcms (decimal): Percentual de redução de base própria.
• AliquotaIcms (decimal): Alíquota do imposto próprio.
• ValorIcms (decimal): Valor do ICMS próprio resultante.
• MotivoDesoneracao (Enum): Motivo da desoneração do ICMS.
• ValorIcmsDesonerado (decimal): Valor do ICMS desonerado.
• ModalidadeBaseSt (Enum): Modalidade de determinação da base ST.
• Mva (decimal): Percentual de MVA ST.
• ReducaoBaseSt (decimal): Percentual de redução de base ST.
• BaseSt (decimal): Valor da base de cálculo do ICMS ST.
• AliquotaSt (decimal): Alíquota do imposto ICMS ST.
• ValorSt (decimal): Valor do ICMS ST resultante.
• BaseFcp (decimal): Base de cálculo do FCP próprio.
• AliquotaFcp (decimal): Alíquota do FCP próprio.
• ValorFcp (decimal): Valor do FCP próprio.
• BaseFcpSt (decimal): Base de cálculo do FCP ST.
• AliquotaFcpSt (decimal): Alíquota do FCP ST.
• ValorFcpSt (decimal): Valor do FCP ST resultante.
*************************************************************************
Dicionário de Enumeradores:
• ModalidadeBaseIcmsNotaFiscalModelEnum:
MargemValorAgregado = Margem Valor Agregado (%).
PrecoPauta = Pauta (Valor).
PrecoTabeladoMax = Preço Tabelado Máx. (valor).
ValorDaOperacao = Valor da operação.
• ModalidadeBaseStNotaFiscalModelEnum:
PrecoTabeladoMaximoSugerido = Preço tabelado ou máximo sugerido.
ListaNegativa = Lista Negativa (valor).
ListaPositiva = Lista Positiva (valor).
ListaNeutra = Lista Neutra (valor).
MargemValorAgregado = Margem Valor Agregado (%).
PrecoPauta = Pauta (valor).
• MotivoDesoneracaoNotaFiscalModelEnum:
Taxi = Táxi.
DeficienteFisico = Deficiente físico.
ProdutorAgropecuario = Produtor agropecuário.
FrotistaLocadora = Frotista/Locadora.
DiplomaticoConsular = Diplomático/consular.
UtilitariosMotocicletasAmazoniaOcidental = Utilitários produzidos na amazônia ocidental.
SUFRAMA = SUFRAMA.
VendaOrgaoPublico = Venda a órgãos públicos.
Outros = Outros.
DeficienteCondutor = Deficiente condutor.
DeficienteNaoCondutor = Deficiente não condutor.
OrgaoDeFomentoDesenvolvimentoAgropecuario = Órgão de fomento e desenvolvimento agropecuário.
ItemNfeTributacaoIcmssnInputModel:
required:
- csosn
type: object
properties:
csosn:
$ref: "#/components/schemas/CsosnNfeModelEnum"
additionalProperties: false
description: |-
Modelo abstrato para a Tributação de ICMSSN (Simples Nacional) da nota fiscal.
O preenchimento dos campos abaixo é condicional ao CSOSN informado.
*************************************************************************
CSOSN 101 - Tributada pelo Simples Nacional com permissão de crédito:
• Csosn: 101.
• AliquotaCreditoSimples (decimal): Alíquota de crédito do simples nacional.
• ValorCreditoSimples (decimal): Valor de crédito do simples nacional.
*************************************************************************
CSOSN 102 - Tributada pelo Simples Nacional sem permissão de crédito:
• Csosn: 102.
• Nota: Não exige campos adicionais de valores ou alíquotas.
*************************************************************************
CSOSN 103 - Isento:
• Csosn: 103.
• Nota: Não exige campos adicionais de valores ou alíquotas.
*************************************************************************
CSOSN 201 - Tributada pelo Simples com permissão de crédito e cobrança de ICMS ST:
• Csosn: 201.
• AliquotaCreditoSimples (decimal): Alíquota de crédito do simples nacional.
• ValorCreditoSimples (decimal): Valor de crédito do simples nacional.
• ModalidadeBaseSt (Enum): Modalidade de base ICMS ST.
• Mva (decimal): Percentual de MVA.
• ReducaoBaseSt (decimal): Percentual de redução de base ICMS ST.
• BaseSt (decimal): Valor da base de cálculo de ICMS ST.
• AliquotaIcmsDeducaoSt (decimal): Alíquota para dedução do ICMS no cálculo do ICMS ST (Utilizada para calcular o valor a ser deduzido do ICMS ST quando o contribuinte for substituído e tiver direito à dedução).
• AliquotaSt (decimal): Alíquota de ICMS ST.
• ValorSt (decimal): Valor de ICMS ST resultante.
• BaseFcpSt (decimal): Base de cálculo do FCP ST.
• AliquotaFcpDeducaoSt (decimal): Alíquota para dedução do FCP no cálculo do FCP ST (Utilizada para calcular o valor a ser deduzido do FCP ST quando o contribuinte for substituído e tiver direito à dedução).
• AliquotaFcpSt (decimal): Alíquota de FCP ST.
• ValorFcpSt (decimal): Valor de FCP ST resultante.
*************************************************************************
CSOSN 202 - Tributada pelo Simples sem permissão de crédito com cobrança de ST:
• Csosn: 202.
• ModalidadeBaseSt (Enum): Modalidade de base ICMS ST.
• Mva (decimal): Percentual de MVA.
• ReducaoBaseSt (decimal): Percentual de redução de base ICMS ST.
• BaseSt (decimal): Valor da base de cálculo de ICMS ST.
• AliquotaIcmsDeducaoSt (decimal): Alíquota para dedução do ICMS no cálculo do ICMS ST (Utilizada para calcular o valor a ser deduzido do ICMS ST quando o contribuinte for substituído e tiver direito à dedução).
• AliquotaSt (decimal): Alíquota de ICMS ST.
• ValorSt (decimal): Valor de ICMS ST resultante.
• BaseFcpSt (decimal): Base de cálculo do FCP ST.
• AliquotaFcpDeducaoSt (decimal): Alíquota para dedução do FCP no cálculo do FCP ST (Utilizada para calcular o valor a ser deduzido do FCP ST quando o contribuinte for substituído e tiver direito à dedução).
• AliquotaFcpSt (decimal): Alíquota de FCP ST.
• ValorFcpSt (decimal): Valor de FCP ST resultante.
*************************************************************************
CSOSN 203 - Isento com ST:
• Csosn: 203.
• ModalidadeBaseSt (Enum): Modalidade de base ICMS ST.
• Mva (decimal): Percentual de MVA.
• ReducaoBaseSt (decimal): Percentual de redução de base ICMS ST.
• BaseSt (decimal): Valor da base de cálculo de ICMS ST.
• AliquotaIcmsDeducaoSt (decimal): Alíquota para dedução do ICMS no cálculo do ICMS ST (Utilizada para calcular o valor a ser deduzido do ICMS ST quando o contribuinte for substituído e tiver direito à dedução).
• AliquotaSt (decimal): Alíquota de ICMS ST.
• ValorSt (decimal): Valor de ICMS ST resultante.
• BaseFcpSt (decimal): Base de cálculo do FCP ST.
• AliquotaFcpDeducaoSt (decimal): Alíquota para dedução do FCP no cálculo do FCP ST (Utilizada para calcular o valor a ser deduzido do FCP ST quando o contribuinte for substituído e tiver direito à dedução).
• AliquotaFcpSt (decimal): Alíquota de FCP ST.
• ValorFcpSt (decimal): Valor de FCP ST resultante.
*************************************************************************
CSOSN 300 - Imune:
• Csosn: 300.
• Nota: Não exige campos adicionais de valores ou alíquotas.
*************************************************************************
CSOSN 400 - Não Tributada:
• Csosn: 400.
• Nota: Não exige campos adicionais de valores ou alíquotas.
*************************************************************************
CSOSN 500 - ICMS cobrado anteriormente por substituição tributária:
• Csosn: 500.
• BaseIcmsRetidoAnteriormente (decimal): Base de ICMS retido anteriormente.
• AliquotaConsumidorFinal (decimal): Alíquota suportada pelo consumidor final.
• ValorIcmsSubstituto (decimal): Valor do ICMS próprio do Substituto.
• ValorIcmsRetido (decimal): Valor do ICMS ST cobrado anteriormente.
• BaseFcpRetidoAnteriormente (decimal): Base do FCP retido anteriormente.
• AliquotaFcpRetidoAnteriormente (decimal): Alíquota de FCP retido anteriormente.
• ValorFcpRetidoAnteriormente (decimal): Valor do FCP retido anteriormente.
• BaseEfetivaIcmsRetido (decimal): Base de ICMS efetivo se ouvesse a cobrança normal de ICMS.
• PercentualReducaoBaseEfetivaIcmsRetido (decimal): Percentual de redução da base de ICMS efetiva se ouvesse a cobrança normal do ICMS.
• AliquotaEfetivaIcmsRetido (decimal): Alíquota de ICMS efetivo se ouvesse a cobrança normal do ICMS.
• ValorEfetivoIcmsRetido (decimal): Valor do ICMS efetivo se ouvesse a cobrança normal de ICMS.
*************************************************************************
CSOSN 900 - Outros:
• Csosn: 900.
• ModalidadeBaseIcms (Enum): Modalidade de determinação da base ICMS.
• BaseIcms (decimal): Valor da base de cálculo do ICMS.
• ReducaoBaseIcms (decimal): Percentual de redução de base ICMS.
• AliquotaIcms (decimal): Alíquota do imposto ICMS.
• ValorIcms (decimal): Valor do ICMS resultante.
• MotivoDesoneracao (Enum): Motivo da desoneração do ICMS.
• ValorIcmsDesonerado (decimal): Valor do ICMS desonerado.
• ModalidadeBaseSt (Enum): Modalidade de base ICMS ST.
• Mva (decimal): Percentual de MVA ST.
• ReducaoBaseSt (decimal): Percentual de redução de base ICMS ST.
• BaseSt (decimal): Valor da base de cálculo de ICMS ST.
• AliquotaIcmsDeducaoSt (decimal): Alíquota para dedução do ICMS no cálculo do ICMS ST (Utilizada para calcular o valor a ser deduzido do ICMS ST quando o contribuinte for substituído e tiver direito à dedução).
• AliquotaSt (decimal): Alíquota de ICMS ST.
• ValorSt (decimal): Valor de ICMS ST resultante.
• BaseFcpSt (decimal): Base de cálculo do FCP ST.
• AliquotaFcpDeducaoSt (decimal): Alíquota para dedução do FCP no cálculo do FCP ST (Utilizada para calcular o valor a ser deduzido do FCP ST quando o contribuinte for substituído e tiver direito à dedução).
• AliquotaFcpSt (decimal): Alíquota do FCP ST.
• ValorFcpSt (decimal): Valor do FCP ST resultante.
• AliquotaCreditoSimples (decimal): Alíquota de crédito do simples nacional.
• ValorCreditoSimples (decimal): Valor de crédito do simples nacional.
*************************************************************************
Dicionário de Enumeradores:
• ModalidadeBaseIcmsNotaFiscalModelEnum:
MargemValorAgregado = Margem Valor Agregado (%).
PrecoPauta = Pauta (Valor).
PrecoTabeladoMax = Preço Tabelado Máx. (valor).
ValorDaOperacao = Valor da operação.
• ModalidadeBaseStNotaFiscalModelEnum:
PrecoTabeladoMaximoSugerido = Preço tabelado ou máximo sugerido.
ListaNegativa = Lista Negativa (valor).
ListaPositiva = Lista Positiva (valor).
ListaNeutra = Lista Neutra (valor).
MargemValorAgregado = Margem Valor Agregado (%).
PrecoPauta = Pauta (valor).
ItemNfeTributacaoIcmsUfDestInputModel:
required:
- aliquotaFcpInternaUfDestino
- aliquotaInterestadual
- aliquotaInternaUfDestino
- baseFcp
- baseIcms
- valorFcpUfDestino
- valorIcmsUfDestino
type: object
properties:
baseIcms:
minimum: 0
type: number
description: Base do ICMS na UF de destino.
format: double
aliquotaInternaUfDestino:
maximum: 100
minimum: 0
exclusiveMinimum: true
type: number
description: Alíquota de ICMS interna na UF de destino.
format: double
aliquotaInterestadual:
maximum: 100
minimum: 0
exclusiveMinimum: true
type: number
description: Alíquota interestadual das UFs envolvidas na operação, conforme
tabela do CONFAZ.
format: double
valorIcmsUfDestino:
minimum: 0
type: number
description: Valor do ICMS devido a UF de destino.
format: double
baseFcp:
minimum: 0
type: number
description: Base do FCP na UF de destino.
format: double
aliquotaFcpInternaUfDestino:
maximum: 100
minimum: 0
type: number
description: Alíquota de FCP interna na UF de destino.
format: double
valorFcpUfDestino:
minimum: 0
type: number
description: Valor do FCP devido a UF de destino.
format: double
additionalProperties: false
description: Informação do ICMS Interestadual destinado a consumidor final em
outra UF.
ItemNfeTributacaoIssqnInputModel:
required:
- aliquotaIssqn
- baseIssqn
- codigoMunicipioFatoGerador
- indicadorExigibilidade
- itemListaServico
- nomeMunicipioFatoGerador
- valorIssqn
type: object
properties:
baseIssqn:
minimum: 0
type: number
description: Base de ISSQN.
format: double
aliquotaIssqn:
maximum: 100
minimum: 0
type: number
description: Alíquota do ISSQN.
format: double
valorIssqn:
minimum: 0
type: number
description: Valor do ISSQN.
format: double
codigoMunicipioFatoGerador:
minLength: 1
pattern: ^\d{7}$
type: string
description: Código do município onde ocorreu o fato gerador.
nomeMunicipioFatoGerador:
maxLength: 60
minLength: 1
type: string
description: Nome do município onde ocorreu o fato gerador.
itemListaServico:
maxLength: 5
minLength: 1
type: string
description: Código do item na lista fiscal de serviços.
valorDeducao:
type: number
description: Valor dedução para redução da Base de Cálculo.
format: double
nullable: true
valorOutrasRetencoes:
type: number
description: Valor de outras retenções.
format: double
nullable: true
valorDescontoCondicional:
type: number
description: Valor de desconto condicional.
format: double
nullable: true
valorDescontoIncondicional:
type: number
description: Valor de desconto incondicional.
format: double
nullable: true
valorRetencaoIssqn:
type: number
description: Valor de retenção do ISSQN.
format: double
nullable: true
indicadorExigibilidade:
$ref: "#/components/schemas/IndicadorExigibilidadeIssqnModelEnum"
codigoServicoMunicipio:
type: string
description: Código do serviço no município.
nullable: true
codigoMunicipioIncidencia:
type: string
description: Código do município onde ocorreu a insidência do serviço.
nullable: true
nomeMunicipioIncidencia:
type: string
description: Nome do município onde ocorreu a insidência do serviço.
nullable: true
codigoPaisIncidencia:
type: string
description: Código do país onde ocorreu a insidência do serviço.
nullable: true
numeroProcesso:
type: string
description: Número do processo judicial ou administrativo de suspensão da
exigibilidade.
nullable: true
utilizouIncentivoFiscal:
type: boolean
description: Indicador de incentivo Fiscal.
additionalProperties: false
description: Dados do ISSQN.
ItemNfeTributacaoIpiInputModel:
required:
- cst
type: object
properties:
cst:
$ref: "#/components/schemas/CstIpiNfeModelEnum"
baseIpi:
minimum: 0
type: number
description: Base do IPI.
format: double
nullable: true
aliquotaIpi:
maximum: 100
minimum: 0
type: number
description: Alíquota do IPI.
format: double
nullable: true
baseQuantidadeIpi:
minimum: 0
type: number
description: Base do IPI pela quantidade.
format: double
nullable: true
aliquotaQuantidadeIpi:
minimum: 0
type: number
description: Valor do IPI pela quantidade.
format: double
nullable: true
valorIpi:
minimum: 0
type: number
description: Valor do IPI.
format: double
nullable: true
cnpjProdutorMercadoria:
type: string
description: CNPJ do produtor da mercadoria, quando diferente do
emitente.Somente para os casos de exportação direta ou indireta.
nullable: true
codigoSeloControle:
type: string
description: Código do selo de controle IPI.
nullable: true
quantidadeSeloControle:
type: integer
description: Quantidade do selo de controle.
format: int32
nullable: true
codigoEnquadramentoLegal:
type: string
description: Código de enquadramento legal.
nullable: true
additionalProperties: false
description: Dados da tributação IPI do item.
ItemNfeTributacaoPisInputModel:
required:
- cst
type: object
properties:
cst:
$ref: "#/components/schemas/CstPisCofinsNfeModelEnum"
basePis:
minimum: 0
type: number
description: Base de cálculo do PIS.
format: double
nullable: true
aliquotaPis:
maximum: 100
minimum: 0
type: number
description: Alíquota do PIS em percentual.
format: double
nullable: true
baseQuantidadePis:
minimum: 0
type: number
description: Base do pis quando quantidade.
format: double
nullable: true
aliquotaQuantidadePis:
maximum: 100
minimum: 0
type: number
description: Valor da alíquota do PIS quando quantidade.
format: double
nullable: true
valorPis:
minimum: 0
type: number
description: Valor do PIS.
format: double
nullable: true
additionalProperties: false
description: Tributação de PIS.
ItemNfeTributacaoCofinsInputModel:
required:
- cst
type: object
properties:
cst:
$ref: "#/components/schemas/CstPisCofinsNfeModelEnum"
baseCofins:
minimum: 0
type: number
description: Base de cálculo do Cofins.
format: double
nullable: true
aliquotaCofins:
maximum: 100
minimum: 0
type: number
description: Alíquota do Cofins em percentual.
format: double
nullable: true
baseQuantidadeCofins:
minimum: 0
type: number
description: Base do Cofins quando quantidade.
format: double
nullable: true
aliquotaQuantidadeCofins:
maximum: 100
minimum: 0
type: number
description: Valor da alíquota do Cofins quando quantidade.
format: double
nullable: true
valorCofins:
minimum: 0
type: number
description: Valor do Cofins.
format: double
nullable: true
additionalProperties: false
description: Dados da tributação COFINS.
ItemNfeImpostoImportacaoInputModel:
required:
- baseImpostoImportacao
- despesaAduaneira
- valorImpostoImportacao
- valorIof
type: object
properties:
baseImpostoImportacao:
minimum: 0
type: number
description: Base do imposto de importação.
format: double
despesaAduaneira:
minimum: 0
type: number
description: Despesa aduaneira.
format: double
valorImpostoImportacao:
minimum: 0
type: number
description: Valor do imposto de importação.
format: double
valorIof:
minimum: 0
type: number
description: Valor do IOF.
format: double
additionalProperties: false
description: Dados do imposto de importação.
ItemNfeTributacaoIbsCbsInputModel:
required:
- cClassTrib
- cst
type: object
properties:
cst:
$ref: "#/components/schemas/CstIbsCbsNfeModelEnum"
cClassTrib:
maxLength: 10
minLength: 1
type: string
description: CClassTrib - Código de Classificação Tributária do IBS e CBS.
baseIbs:
type: number
description: Base IBS e CBS.
format: double
nullable: true
ibsEstadual:
$ref: "#/components/schemas/ItemNfeTributacaoIbsEstadualInputModel"
ibsMunicipal:
$ref: "#/components/schemas/ItemNfeTributacaoIbsMunicipalInputModel"
cbs:
$ref: "#/components/schemas/ItemNfeTributacaoCbsInputModel"
additionalProperties: false
description: Dados do IBS e CSB na tributação do item da nota fiscal. (Reforma
Tributária)
UfNotaFiscalModelEnum:
enum:
- RO
- AC
- AM
- RR
- PA
- AP
- TO
- MA
- PI
- CE
- RN
- PB
- PE
- AL
- SE
- BA
- MG
- ES
- RJ
- SP
- PR
- SC
- RS
- MS
- MT
- GO
- DF
type: string
description: Lista de Unidades Federativas para Nota Fiscal.
TipoViaTransporteNotaFiscalModelEnum:
enum:
- Maritima
- Fluvial
- Lacustre
- Aerea
- Postal
- Ferroviaria
- Rodoviaria
type: string
description: Tipo de via de transporte da declaração de importação.
TipoIntermedioImportacaoNotaFiscalModelEnum:
enum:
- ContaPropria
- ContaOrdem
- Encomenda
type: string
description: Indicador do tipo de intermediador da importação.
UfExtNotaFiscalModelEnum:
enum:
- RO
- AC
- AM
- RR
- PA
- AP
- TO
- MA
- PI
- CE
- RN
- PB
- PE
- AL
- SE
- BA
- MG
- ES
- RJ
- SP
- PR
- SC
- RS
- MS
- MT
- GO
- DF
- EX
type: string
description: Lista de Unidades Federativas para Nota Fiscal incluíndo exterior.
ItemNfeDeclaracaoImportacaoAdicaoInputModel:
required:
- codigoFabricante
- numeroAdicao
- sequencial
type: object
properties:
numeroAdicao:
minimum: 0
exclusiveMinimum: true
type: integer
description: Numero da Adição.
format: int32
sequencial:
minimum: 0
exclusiveMinimum: true
type: integer
description: Numero sequencial do item dentro da Adição.
format: int32
codigoFabricante:
maxLength: 60
minLength: 1
type: string
description: Código do fabricante estrangeiro.
valorDesconto:
type: number
description: Valor do desconto do item da DI – Adição.
format: double
nullable: true
numeroDrawback:
type: string
description: Número do ato concessório de Drawback.
nullable: true
additionalProperties: false
description: Adições da declaração de importação do item da nota fiscal.
TipoProdutoEspecificoNotaFiscalModelEnum:
enum:
- Medicamento
type: string
description: Tipos de produtos específicos para Nota Fiscal.
CstIcmsNfeModelEnum:
enum:
- "00"
- "02"
- "10"
- "15"
- "20"
- "30"
- "40"
- "41"
- "50"
- "51"
- "53"
- "60"
- "61"
- "70"
- "90"
type: string
description: CST de ICMS para NFe.
CsosnNfeModelEnum:
enum:
- "101"
- "102"
- "103"
- "201"
- "202"
- "203"
- "300"
- "400"
- "500"
- "900"
type: string
description: Lista de CSOSN da NFe.
IndicadorExigibilidadeIssqnModelEnum:
enum:
- Exigivel
- NaoIncidencia
- Isencao
- Exportacao
- Imunidade
- ExigibilidadeSuspensaDecisaoJudicial
- ExigibilidadeSuspensaProcessoAdministrativo
type: string
description: Indicador de exigibilidade do ISSQN.
CstIpiNfeModelEnum:
enum:
- "00"
- "01"
- "02"
- "03"
- "04"
- "05"
- "49"
- "50"
- "51"
- "52"
- "53"
- "54"
- "55"
- "99"
type: string
description: CST de IPI.
CstPisCofinsNfeModelEnum:
enum:
- "01"
- "02"
- "03"
- "04"
- "05"
- "06"
- "07"
- 8
- 9
- "49"
- "50"
- "51"
- "52"
- "53"
- "54"
- "55"
- "56"
- "60"
- "61"
- "62"
- "63"
- "64"
- "65"
- "66"
- "67"
- "70"
- "71"
- "72"
- "73"
- "74"
- "75"
- "98"
- "99"
type: string
description: CST de PIS/COFINS para NFe.
CstIbsCbsNfeModelEnum:
enum:
- "000"
- "200"
- "400"
- "410"
- "510"
- "515"
- "550"
- "620"
- "800"
- "810"
- "811"
- "820"
type: string
description: Enumerador para o Código de Situação Tributária (CST) do IBS e CBS
para NFe.
ItemNfeTributacaoIbsEstadualInputModel:
type: object
properties:
aliquotaCheiaIbs:
maximum: 100
minimum: 0
type: number
description: Alíquota cheia de IBS de competência da UF.
format: double
nullable: true
reducaoAliquotaIbs:
maximum: 100
minimum: 0
type: number
description: Percentual de redução da alíquota de IBS de competência da UF.
format: double
nullable: true
aliquotaEfetivaIbs:
maximum: 100
minimum: 0
type: number
description: Alíquota efetiva do IBS de competência da UF.
format: double
nullable: true
valorIbs:
minimum: 0
type: number
description: Valor de IBS de competência da UF.
format: double
nullable: true
percentualDiferimentoIbs:
maximum: 100
minimum: 0
type: number
description: Alíquota cheia de IBS de competência da UF.
format: double
nullable: true
valorDiferimentoIbs:
minimum: 0
type: number
description: Alíquota cheia de IBS de competência da UF.
format: double
nullable: true
additionalProperties: false
description: Dados do IBS - Imposto sobre Bens e Serviços na tributação do item
da nota fiscal de competência da UF.
ItemNfeTributacaoIbsMunicipalInputModel:
type: object
properties:
aliquotaCheiaIbs:
maximum: 100
minimum: 0
type: number
description: Alíquota cheia de IBS de competência do município.
format: double
nullable: true
reducaoAliquotaIbs:
maximum: 100
minimum: 0
type: number
description: Percentual de redução da alíquota de IBS de competência do município.
format: double
nullable: true
aliquotaEfetivaIbs:
maximum: 100
minimum: 0
type: number
description: Alíquota efetiva do IBS de competência do município.
format: double
nullable: true
valorIbs:
minimum: 0
type: number
description: Valor de IBS de competência do município.
format: double
nullable: true
percentualDiferimentoIbs:
maximum: 100
minimum: 0
type: number
description: Alíquota cheia de IBS de competência do município.
format: double
nullable: true
valorDiferimentoIbs:
minimum: 0
type: number
description: Alíquota cheia de IBS de competência do município.
format: double
nullable: true
additionalProperties: false
description: Dados do IBS - Imposto sobre Bens e Serviços na tributação do item
da nota fiscal de competência do município.
ItemNfeTributacaoCbsInputModel:
type: object
properties:
aliquotaCheiaCbs:
minimum: 0
type: number
description: Alíquota cheia do CBS.
format: double
nullable: true
reducaoAliquotaCbs:
maximum: 100
minimum: 0
type: number
description: Percentual de redução da alíquota do CBS.
format: double
nullable: true
aliquotaEfetivaCbs:
minimum: 0
type: number
description: Alíquota efetiva do CBS.
format: double
nullable: true
valorCbs:
minimum: 0
type: number
description: Valor do CBS.
format: double
nullable: true
percentualDiferimentoCbs:
maximum: 100
minimum: 0
type: number
description: Alíquota cheia de CBS.
format: double
nullable: true
valorDiferimentoCbs:
minimum: 0
type: number
description: Alíquota cheia de CBS.
format: double
nullable: true
additionalProperties: false
description: Dados do CBS - Contribuição sobre Bens e Serviços na tributação do
item da nota fiscal.
ItemNfeInputModel:
required:
- cfop
- codigoInterno
- descricao
- impostos
- ncm
- unidade
type: object
properties:
tipoItem:
$ref: "#/components/schemas/TipoItemNotaModelEnum"
codigoInterno:
maxLength: 60
minLength: 1
type: string
description: Código interno do produto ou serviço no ERP.
ean:
type: string
description: EAN do produto.
nullable: true
descricao:
maxLength: 120
minLength: 2
type: string
description: Descrição do produto.
origemMercadoria:
$ref: "#/components/schemas/OrigemMercadoriaNotaFiscalModelEnum"
ncm:
minLength: 1
pattern: ^\d{8}$
type: string
description: NCM do produto. Lista de NCMs válidos em
api/v1/RecursosAdicionais/Ncm/Listar.
cest:
type: string
description: >-
Código Especificador da Substituição Tributária (CEST).
O CEST é utilizado para identificar mercadorias e
bens passíveis de sujeição aos regimes de
substituição tributária e de antecipação do
recolhimento do imposto.
🔍 DICA DE BUSCA: Para obter uma lista de códigos
válidos, utilize o endpoint
`api/v1/RecursosAdicionais/Cest/Listar`. Além disso, ao consultar o
detalhe de um NCM,
o sistema retornará automaticamente os CESTs associados àquela
classificação fiscal.
nullable: true
nve:
type: string
description: Codificação NVE - Nomenclatura de Valor Aduaneiro e Estatística.
(Opcional)
nullable: true
exTipi:
type: integer
description: Extensão da TIPI.
format: int32
nullable: true
cfop:
minLength: 1
pattern: ^\d{4}$
type: string
description: CFOP do item. Lista de CFOPs válidos em
api/v1/RecursosAdicionais/Cfop/Listar.
unidade:
maxLength: 6
minLength: 1
type: string
description: Unidade comercializada.
quantidade:
minimum: 0
exclusiveMinimum: true
type: number
description: Quantidade comercializada.
format: double
valorUnitario:
minimum: 0
type: number
description: Valor unitário do item.
format: double
valorTotalBruto:
minimum: 0
type: number
description: Valor total bruto.
format: double
valorTotalFrete:
minimum: 0
type: number
description: Valor total de frete do item.
format: double
nullable: true
valorTotalSeguro:
minimum: 0
type: number
description: Valor total de seguro do item.
format: double
nullable: true
valorTotalDesconto:
minimum: 0
type: number
description: Valor total de descontos do item.
format: double
nullable: true
valorTotalOutros:
minimum: 0
type: number
description: Valor total de outras despesas do item.
format: double
nullable: true
itemCompoeTotalNota:
type: boolean
description: Indicador de item compõe o total da nota.
nullable: true
numeroPedidoCompra:
type: string
description: Número do pedido de compra.
nullable: true
itemPedidoCompra:
type: integer
description: Item de pedido de compra.
format: int32
nullable: true
impostos:
$ref: "#/components/schemas/ItemNfeImpostoInputModel"
impostoDevolvido:
$ref: "#/components/schemas/ItemNfeImpostoDevolvidoInputModel"
declaracoesImportacao:
type: array
items:
$ref: "#/components/schemas/ItemNfeDeclaracaoImportacaoInputModel"
description: Lista de declaração de importação do item.
nullable: true
exportacao:
$ref: "#/components/schemas/ItemNfeExportacaoInputModel"
produtoEspecifico:
$ref: "#/components/schemas/ItemNfeProdutoEspecificoInputModel"
additionalProperties: false
description: Dados do item da NFe.
```