--- title: "Calcular Impostos em Vendas" method: POST path: "/v1/fiscal/impostos/calculo" tags: ["Fiscal"] --- # Calcular Impostos em Vendas `POST /v1/fiscal/impostos/calculo` Este endpoint calcula os impostos incidentes sobre uma operação de venda. Com base nos dados fornecidos, como empresa, cliente, produtos e despesas acessórias, a API retorna os valores calculados, incluindo base de cálculo, alíquotas e valores de impostos. É importante ressaltar que toda a parametrização tributária deve ser previamente configurada no SankhyaOm, pois o endpoint não realiza essa configuração, apenas aplica as regras já definidas no SankhyaOm. Serviço está disponível no SankhyaOm a partir da versão 4.31. ## Request body - NegociacaoRequest - `notaModelo` integer, required — Este atributo é utilizado para preparar a inclusão do movimento no SankhyaOm, permitindo que o serviço obtenha informações essenciais, como empresa, tipo de operação, natureza, entre outros. Para saber mais como configurar um Modelo de Nota, [clique aqui](https://ajuda.sankhya.com.br/hc/pt-br/articles/360047012513-Config-Modelo-de-Notas) - `codigoCliente` integer, required — Para realizar o cálculo de impostos, informe neste atributo o "código do cliente" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "Parceiro" (CODPARC). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoEmpresa` integer — Este atributo é opcional e caso não seja enviado, a API irá assumir a empresa configurada na Nota Modelo. Para mudar a empresa contida na Nota Modelo, informe neste atributo o "código da empresa" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "Empresa" (CODEMP). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoTipoOperacao` integer — Este atributo é opcional e caso não seja enviado, a API irá assumir o Tipo de Operação configurada na Nota Modelo. Para utilizar um Tipo de Operação diferente do que está configurado na Nota Modelo, informe neste atributo o "código do tipo de operação" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "TipoOperacao" (CODTIPOPER). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `finalidadeOperacao` integer — Informe neste atributo a "finalidade da operação" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "FinalidadeOperacao" (NUFOP). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `despesasAcessorias` DespesasAcessorias — Despesas adicionais relacionadas à negociação, como frete, seguro e outras despesas. A API não irá tratar de forma separada valores de destaque, juros e embalagem de forma separada, com isso, estas despesas serão enquadradas como "outros" e receberão a tratativa de "destaque". - `frete` number, double — Valor do frete associado à negociação. - `seguro` number, double — Valor do seguro aplicado à negociação. - `outras` number, double — Outras despesas acessórias da negociação (ex.: embalagem, juros, destaque, etc.). - `produtos` Produto[], required — Lista de produtos para realizar o cálculo de impostos - `codigoProduto` integer, required — Para registrar os produtos utilizados da negociação, informe neste atributo o "código do produto" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "Produto" (CODPROD). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `unidade` string, required — Unidade de medida utilizada na negociação do produto - `quantidade` integer, required — Quantidade negociada do produto - `valorUnitario` number, double, required — Preço unitário do produto - `valorDesconto` number, double — Valor de desconto aplicado no produto ## Response `200` Impostos calculados com sucesso. - NegociacaoResponse - `produtos` ProdutoImposto[] — Lista de produtos com os respectivos impostos calculados. - `codigoProduto` integer — Para registrar os produtos utilizados da negociação, informe neste atributo o "código do produto" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "Produto" (CODPROD). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `origemProduto` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 — Origem do Produto. Os valores retornados aqui são com base no manual da Nota Fiscal Eletrônica (anexo I). Seguem valores aceitos: - 0 - Nacional, exceto as indicadas nos códigos 3, 4, 5 e 8; - 1 - Estrangeira - Importação direta, exceto a indicada no código 6; - 2 - Estrangeira - Adquirida no mercado interno, exceto a indicada no código 7; - 3 - Nacional, mercadoria ou bem com Conteúdo de Importação superior a 40% e inferior ou igual a 70%; - 4 - Nacional, cuja produção tenha sido feita em conformidade com os processos produtivos básicos de que tratam as legislações citadas nos Ajustes; - 5 - Nacional, mercadoria ou bem com Conteúdo de Importação inferior ou igual a 40%; - 6 - Estrangeira - Importação direta, sem similar nacional, constante em lista da CAMEX e gás natural; - 7 - Estrangeira - Adquirida no mercado interno, sem similar nacional, constante lista CAMEX e gás natural. - 8 - Nacional, mercadoria ou bem com Conteúdo de Importação superior a 70%; - `unidade` string — Unidade de medida utilizada na negociação do produto. - `quantidade` integer — Quantidade negociada do produto - `valorUnitario` number, double — Preço unitário do produto - `valorDesconto` number, double — Valor de desconto aplicado no produto - `valorTotal` number, double — Valor total do produto considerando a quantidade negociada - `despesasAcessorias` number, double — Despesas acessórias alocadas para o produto específico - `impostos` CalculoImpostosImpostos[] - `tipo` 'icms' | 'st' | 'ipi' | 'irpj' | 'cpp' | 'iss' | 'inss' | 'pis' | 'cofins' | 'irf' | 'cssl' | 'ibsuf' | 'ibsmun' | 'cbs' | 'is' | 'ibsmono' | 'cbsmono' | 'outros' — Tipo do imposto. Os valores previstos neste atributo são: - icms - st - ipi - irpj - cpp - iss - inss - pis - cofins - irf - cssl - ibsuf - ibsmun - cbs - is - ibsmono - cbsmono - outros - `cst` string — Código de Situação Tributária. Os valores retornados aqui são com base no manual da Nota Fiscal Eletrônica (anexo I). - `modalidadeBaseCalculo` 0 | 1 | 2 | 3 | 4 | 5 — Código da Modalidade de Base de Cálculo. Os valores retornados aqui são com base no manual da Nota Fiscal Eletrônica (anexo I). Valores previstos para ICMS: - 0 - Margem Valor Agregado (%) - 1 - Pauta (Valor) - 2 - Preço Tabelado Máx. (valor) - 3 - Valor da operação Valores previstos para ST: - 0 - Preço tabelado ou máximo sugerido - 1 - Lista Negativa (valor) - 2 - Lista Positiva (valor) - 3 - Lista Neutra (valor) - 4 - Margem Valor Agregado (%) - 5 - Pauta (valor) - `valorOperacao` number, double — Valor envaido na requisição para realizar o cálculo. - `aliquota` number, double — Aliquota do imposto - `valorBase` number, double — Valor da base de cálculo com reduções caso existam - `valorImposto` number, double — Valor do imposto calculado - `percentualFCP` number, double — Percentual do Fundo de Combate a Pobreza (FCP). - `valorFCP` number, double — Valor do Fundo de Combate a Pobreza (FCP). - `valorDesoneracao` number, double — Valor do imposto calculado - `motivoDesoneracao` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 12 | 16 | 90 — Lista de motivos da desoneração de impostos para ICMS e ST. Segue relação de valores para ICMS: - 1 - Táxi - 2 - Deficiente Físico - 3 - Produtor Agropecuário - 4 - Frotista/Locadora - 5 - Diplomático/Consular - 6 - Utilitários e Motocicletas da Amazônia Ocidental e Áreas de Livre Comércio - 7 - SUFRAMA - 8 - Venda a Órgãos Públicos - 9 - Outros - 16 - Olimpíadas Rio 2016 - 90 - Solicitado pelo Fisco Segue relação de valores exclusivos para ST: - 9 - Outros - 3 - Uso na agropecuária - 12 - Fomento agropecuário - `indicadorRepasseDesoneracao` 0 | 1 — Indica se o valor do ICMS desonerado deduz do valor do item. Seguem valores aceitos: - 0 - Valor do ICMS desonerado não deduz do valor do item / total da NF-e - 1 - Valor do ICMS desonerado deduz do valor do item / total da NF-e ## Other responses - `400` — Informações Inválidas. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `401` — Não autenticado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `403` — Autenticação inválida. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `404` — Dados não encontrados. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `500` — Erro interno no servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `501` — Não implementado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `502` — Retorno inválido do servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `503` — Serviço indisponível no momento. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `504` — Tempo de execução excedido. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. --- [API](https://skmtc.net/sankhya/apis/api-sankhya.md) · [All operations](https://skmtc.net/sankhya/apis/api-sankhya/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sankhya/api-sankhya/revisions/0a3e81ca6195/schema)