Ir al contenido
Claro
Español

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í.

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

La 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": "..." }.