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.
Calcular
Seção intitulada “Calcular”Rota: {host}/public/v1/calcular-impostos-pedidoMétodo: POSTBody: jsonA 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": "..." }.