API de Demander - Cálculo de impuestos del pedido
Este artículo forma parte de la documentación de la API de integración REST.
Calculas el IPI, el ICMS-ST y la tasa adicional de un pedido que todavía no se grabó. No se guarda nada.
La cuenta usa la tributación registrada en su empresa. El impuesto calculado en Sankhya, Avalara o Focco no entra aquí.
Calcular
Sección titulada «Calcular»Rota: {host}/public/v1/calcular-impostos-pedidoMétodo: POSTBody: jsonLa respuesta llega con estado 200, con los totales y el impuesto de cada ítem.
| Propiedad | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| uniqueIdCliente | string | ✓ | Identificador del cliente. A partir de él, Demander conoce la UF, el tipo tributario y los segmentos. |
| codTipoPedido | string o int | ✓ | Tipo de pedido. Define si entran IPI, ICMS-ST y tasa adicional. |
| codListaPreco | string o int | ✓ | Lista de precios. Define si el precio ya incluye impuesto y, cuando la regla es por unidad, el IPI de cada unidad. |
| codFilial | string o int | Sucursal. Entra en la elección de la regla de tributación. | |
| codTipoDesconto | string o int | Tipo de descuento. Entra en la elección de la regla de tributación. | |
| valorFrete | number | Flete. Entra en la base del impuesto cuando tu empresa considera el flete en esta cuenta. Si no lo envías, vale 0. |
|
| valorDespesasAcessorias | number | Gastos accesorios. Entran en la misma base del flete. Si no lo envías, vale 0. |
|
| descontoDestacado | number | Solo disminuye el total del pedido en la respuesta. No entra en la base del impuesto. Si no lo envías, vale 0. |
|
| itensPedido | array | ✓ | Ítems. Envíe al menos uno. |
Cada ítem de itensPedido:
| Propiedad | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| codProduto | string | ✓ | Código del producto. |
| qtde | number | ✓ | Cantidad. |
| valorUnitarioSemDesconto | number | ✓ | Valor unitario de tabla, sin descuento. |
| valorUnitarioComDesconto | number | ✓ | Valor unitario de venta, con descuento. |
| valorTotalVenda | number | Total del ítem. Sirve para prorratear flete y gastos. | |
| valorTotalProdutosComDesconto | number | Lo mismo que valorTotalVenda. Obligatorio cuando no viene valorTotalVenda. |
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 } ]}Respuesta. Los valores dependen de la tributación de tu 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 } ]}El impuesto y los totales del pedido salen con 2 decimales. valorUnitarioComImpostos puede tener más decimales.
Si el cliente, el tipo de pedido o la lista de precios no existen, la respuesta es 404 con { "erro": "..." }. JSON inválido o campo obligatorio ausente responde 422 con { "erro": "..." }.