Objetivo

A finalidade deste método é possibilitar a consulta dos dados tributários dos produtos.

Chamada

GET /api/v4/produtos/tributacao-produtos

Informações para Requisição (Request Information)

Parâmetros URI (URI Parameters)

Nome (Name)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)
CNPJEmpresaCNPJ da empresa utilizada como filtro de informações, sem traços ou pontos. Formato: 00000000000000stringNão há
regimeTributacaoRegime especial de tributaçãostringNão há
uFClienteFornecedorUF do cliente ou fornecedor para consulta da tributação. Se não informado, é considerada a UF da empresa de consulta.stringNão há
tipoTributacaoTipo de tributação para consulta. ED = Entrada de Distribuidor, EI = Entrada de Indústria, EM = Entrada de Microempresa, SD = Saída para Devolução Distribuidor, SI = Saída para Devolução a Indústria, SM = Saída para Devolução a Microempresa, SC = Saída para Contribuintes, SN = Saída para Não Contribuintes. Padrão: “SN”.stringNão há
idCategoriaCódigo sequencial do cadastro de categoria.IntegerNão há
codigoAcessoCódigos de acessos associados ao produto (GTIN, Interno, Fornecedor)string

Quando não informado o IdFornecedor, a busca irá se basear apenas nos tipos de códigos de acesso: EAN, DUN e Interno (E, D e B).

descricaoProdutoDescrição cadastrada para o produtostringNão há
dataAtualizacaoData da ultima atualização Formato: YYYY-MM-DDThh:mm:ssstringNão há
idFamiliaCódigo sequencial do cadastro de família do produtoIntegerNão há
idProdutoCódigo sequencial do cadastro do produtoIntegerNão há
idFornecedorCódigo sequencial do cadastro de fornecedorIntegerQuando informado IdFornecedor, a busca também irá considerar o código de acesso do tipo Fornecedor (F).
_pageNo
IntegerNão há
_pageSize
IntegerNão há

Parâmetros do Corpo (Body Parameters)

Não há.

Informações para Resposta (Response Information)

Descrição do Recurso (Resource Description)

Nome (Name)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)
NumeroEmpresaNúmero da empresaIntegerNão há
UFEmpresaDescrição da categoriaStringNão há
UFDestinoUF do cliente ou fornecedor para consulta da tributação. Se não informado, é considerada a UF da empresa de consulta.StringNão há
RegimeTributacaoRegime especial de tributaçãoStringNão há
NumeroDivisaoNúmero da Divisão da empresa consultadaIntegerNão há
NumeroTributacaoNúmero da tributação vinculada ao produto, de acordo com a divisão da empresa consultadaIntegerNão há
TipoTributacaoVer detalhes do parâmetro “Tipo de Tributação”StringNão há
CstIcmsCódigo da situação tributária de ICMSStringNão há
PercentualICMSPercentual tributado de ICMSNumberNão há
PercentualIsentoICMSPercentual de isenção de ICMSNumberNão há
AliquotaICMSAlíquota do ICMSNumberNão há
AliquotaPISAlíquota de PISNumberNão há
AliquotaCofinsAlíquota de COFINSNumberNão há
MVAPercentual de acréscimo MVA / IVANumberNão há
AliquotaICMSSTAlíquota destino para cálculo de STNumberNão há
ReducaoBaseICMSSTPercentual redução da base de ICMS STIntegerNão há
ValorPautaICMSSTValor pauta de ICMS STNumberNão há
AliquotaIPIAlíquota de IPIIntegerNão há
ValorPautaIPIValor de pauta de IPINumberNão há
AliquotaFCPICMSAlíquota de FCP ICMSNumberNão há
UsaPMCBaseSTUsa PMC para cálculo da base de ICMS STStringNão há
STConformeEntradaUtiliza valor da última entrada na base de ICMS STStringNão há
SomaIPInoSTAgrega IPI no cálculo do ICMS STStringNão há
CodigoAcessoPrincipalCódigo de acesso principalStringNão há
IdProdutoCódigo sequencial do cadastro do produtoIntegerNão há
IdFamiliaCódigo sequencial do cadastro da família do produtoIntegerNão há
IdProdutoBaseCódigo sequencial do cadastro do produto baseIntegerNão há
DataUltimaAtualizacaoData da ultima atualizaçãoStringNão há

Formatos de Resposta (Response Formats)

application/json, text/json

Exemplo (Sample):

{
  "NumeroEmpresa": 0,
  "UFEmpresa": "string",
  "UFDestino": "string",
  "RegimeTributacao": "string",
  "NumeroDivisao": 0,
  "NumeroTributacao": 0,
  "TipoTributacao": "string",
  "CstIcms": "string",
  "PercentualICMS": 0,
  "PercentualIsentoICMS": 0,
  "AliquotaICMS": 0,
  "AliquotaPIS": 0,
  "AliquotaCofins": 0,
  "MVA": 0,
  "AliquotaICMSST": 0,
  "ReducaoBaseICMSST": 0,
  "ValorPautaICMSST": 0,
  "AliquotaIPI": 0,
  "ValorPautaIPI": 0,
  "AliquotaFCPICMS": 0,
  "UsaPMCBaseST": "string",
  "STConformeEntrada": "string",
  "SomaIPInoST": "string",
  "CodigoAcessoPrincipal": "string",
  "IdProduto": 0,
  "IdFamilia": 0,
  "IdProdutoBase": 0,
  "DataUltimaAtualizacao": "2020-06-30T11:53:05Z"
}