Comunidade
Dúvida sobre cálculo de frete via API - Cubagem x Peso
Olá pessoal!
Estamos com uma integração de cotação de frete via API no nosso e-commerce e precisamos de um esclarecimento sobre como o cálculo está sendo feito.
Como nosso sistema funciona
Quando um cliente acessa o carrinho/checkout e informa o CEP de destino, nosso sistema envia automaticamente uma requisição para a API da Rodonaves (endpoint: quotation-apigateway.rte.com.br/api/v1/gera-cotacao) com os dados do produto: peso, dimensões e valor da mercadoria. Com base na resposta da API, exibimos o valor do frete para o cliente.
O teste que fizemos
Usamos um produto de exemplo com as seguintes características:
- Peso: 38 kg
- Dimensões: 90 cm × 27 cm × 90 cm
- Valor da mercadoria: R$ 1.367,31
- CEP de origem: 85875-418
- CEP de destino: 89700-065
Fizemos duas cotações via API, enviando exatamente os mesmos dados nas duas, com a única diferença sendo o envio ou não das dimensões:
Cotação 1 - COM dimensões:
Peso: 38 kg
Dimensões: Comprimento 90, Altura 27, Largura 90
Valor da mercadoria: R$ 1.367,31
Resultado: R$ 277,71
Cotação 2 - SEM dimensões:
Peso: 38 kg
Dimensões: não informadas
Valor da mercadoria: R$ 1.367,31
Resultado: R$ 126,19
O que nos intriga
Foi nos informado que a loja utiliza fator de cubagem 200, e que o frete é calculado pelo maior valor entre peso real e peso cubado.
Calculamos os dois cenários possíveis:
Se a API espera dimensões em metros (0,90 × 0,27 × 0,90):
Volume = 0,2187 m³
Peso cubado = 0,2187 × 200 = 43,74 kg
vs 38 kg real → cubagem aplicaria, diferença pequena (~15%) → esperaríamos um frete em torno de R$ 145, não R$ 277,71
Se a API espera dimensões em centímetros (90 × 27 × 90):
Volume = 218.700 cm³
Peso cubado = 218.700 ÷ 200 = 1.093,5 kg
vs 38 kg real → cubagem aplicaria com enorme diferença → esperaríamos um frete muito acima de R$ 277,71
Nenhum dos dois cenários explica matematicamente o valor de R$ 277,71 retornado pela API.
Além disso, a própria resposta da API retorna o campo "Cubed": false nas duas cotações - indicando que a cubagem não foi aplicada - mas o valor muda R$ 151,52 dependendo de enviarmos ou não as dimensões.
O que precisamos saber
- A API espera as dimensões em centímetros ou em metros?
- Para esse produto (90×27×90 cm, 38 kg), com o fator de cubagem 200, qual é o valor correto do frete?
- O campo "Cubed": false na resposta significa que a cubagem não foi aplicada no cálculo? Se não foi, por que o valor muda ao enviarmos as dimensões?
- Devemos ou não enviar as dimensões para que o frete seja calculado corretamente?
Precisamos dessa confirmação para garantir que o valor exibido no checkout seja exatamente o que será cobrado na hora do despacho, sem diferenças para o vendedor.
Agradeço desde já.