Pular para o conteúdo
Claro
Português

API do Demander - Cálculo de Impostos do Pedido

Este artigo faz parte da documentação da API de Integração REST.

Você calcula o IPI, o ICMS-ST e a taxa adicional de um pedido que ainda não foi gravado. Nada é salvo.

A conta usa a tributação cadastrada na sua empresa. O imposto calculado no Sankhya, na Avalara ou no Focco não entra aqui.

Rota: {host}/public/v1/calcular-impostos-pedido
Método: POST
Body: json

A resposta vem com status 200, com os totais e o imposto de cada item.

Propriedade Tipo Obrigatório Descrição
uniqueIdCliente string ✓ Identificador do cliente. A partir dele o Demander sabe a UF, o tipo tributário e os segmentos.
codTipoPedido string ou int ✓ Tipo de pedido. Define se entra IPI, ICMS-ST e taxa adicional.
codListaPreco string ou int ✓ Lista de preço. Define se o preço já inclui imposto e, quando a regra for por unidade, o IPI de cada unidade.
codFilial string ou int Filial. Entra na escolha da regra de tributação.
codTipoDesconto string ou int Tipo de desconto. Entra na escolha da regra de tributação.
valorFrete number Frete. Entra na base do imposto quando a sua empresa considera frete nessa conta. Se você não enviar, vale 0.
valorDespesasAcessorias number Despesas acessórias. Entram na mesma base do frete. Se você não enviar, vale 0.
descontoDestacado number Só diminui o total do pedido na resposta. Não entra na base do imposto. Se você não enviar, vale 0.
itensPedido array ✓ Itens. Envie pelo menos um.

Cada item de itensPedido:

Propriedade Tipo Obrigatório Descrição
codProduto string ✓ Código do produto.
qtde number ✓ Quantidade.
valorUnitarioSemDesconto number ✓ Valor unitário de tabela, sem desconto.
valorUnitarioComDesconto number ✓ Valor unitário de venda, com desconto.
valorTotalVenda number Total do item. Serve para ratear frete e despesas.
valorTotalProdutosComDesconto number O mesmo que valorTotalVenda. Obrigatório quando valorTotalVenda não vier.

Body:

{
"uniqueIdCliente": "CLI-100",
"codTipoPedido": 2,
"codListaPreco": "101",
"codFilial": "1",
"valorFrete": 0,
"valorDespesasAcessorias": 0,
"descontoDestacado": 0,
"itensPedido": [
{
"codProduto": "65471",
"qtde": 10,
"valorUnitarioSemDesconto": 14.74,
"valorUnitarioComDesconto": 14.74,
"valorTotalProdutosComDesconto": 147.4
}
]
}

Resposta. Os valores dependem da tributação da sua empresa:

{
"valorProdutosSemDescAcres": 147.4,
"valorProdutosComDescAcres": 147.4,
"valorFrete": 0,
"valorDespesasAcessorias": 0,
"descontoDestacado": 0,
"valorIPI": 45.8,
"valorICMS_ST": 17.42,
"totalTaxaAdicional": 0,
"valorTotalPedido": 210.62,
"itensPedido": [
{
"codProduto": "65471",
"qtde": 10,
"valorUnitarioComDesconto": 14.74,
"valorTotalProdutosComDesconto": 147.4,
"aliquotaIPI": 5,
"aliquotaICMS": 17,
"aliquotaIcmsSt": 17,
"valorTotalICMSProprio": 17.79,
"valorTotalIPI": 45.8,
"valorTotalICMSST": 17.42,
"valorTaxaAdicional": 0,
"valorUnitarioComImpostos": 21.061759,
"valorTotalComImpostos": 210.62
}
]
}

O imposto e os totais do pedido saem com 2 casas decimais. valorUnitarioComImpostos pode ter mais casas.

Se o cliente, o tipo de pedido ou a lista de preço não existirem, a resposta é 404 com { "erro": "..." }. JSON inválido ou campo obrigatório ausente responde 422 com { "erro": "..." }.