ForHosting KIT · Ferramentas para dev

Calcule a taxa de devolução de produtos

A taxa de devolução de produtos mostra qual percentual das unidades vendidas voltou durante o mesmo período de análise.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Informe as quantidades vendida e devolvida para obter um percentual consistente, útil para merchandising, operações e relatórios financeiros. A calculadora aplica a fórmula padrão, valida as duas contagens e rejeita claramente vendas iguais a zero. Você pode usá-la para um SKU, uma categoria, uma loja ou o catálogo inteiro, desde que os dois números correspondam ao mesmo período e escopo.

Escolha contagens comparáveis de vendas e devoluções

Uma taxa útil começa com dois números que representam a mesma parte da operação. Escolha um período, como um mês civil, e um escopo: SKU, categoria, loja, marketplace ou catálogo completo. Informe todas as unidades vendidas nesse escopo e todas as devolvidas no mesmo intervalo. Não misture pedidos e itens: um pedido com três produtos representa três unidades vendidas, enquanto um produto devolvido representa uma unidade devolvida. Mantenha cancelamentos separados, a menos que sua empresa os classifique formalmente como devoluções. A calculadora aceita apenas números inteiros não negativos, pois unidades físicas são discretas. As vendas devem ser maiores que zero; sem denominador, não existe percentual significativo. As devoluções podem ser zero. Também podem superar as vendas do período quando clientes devolvem compras anteriores. Nesse caso, a calculadora preserva o sinal real em vez de limitar silenciosamente o resultado a cem por cento.

Entenda o cálculo do percentual

A fórmula divide as unidades devolvidas pelas vendidas e multiplica o quociente por cem. Se uma loja vendeu 1,250 unidades e registrou 37 devoluções, o cálculo é 37 dividido por 1,250, multiplicado por 100, resultando em 2.96 por cento. O valor é arredondado para no máximo seis casas decimais, mantendo chamadas de API e cálculos no navegador estáveis sem perder precisão útil. Uma taxa representa uma relação, não um diagnóstico. Um percentual alto pode indicar problemas de tamanho, danos, descrições imprecisas, expectativas dos clientes, uma política generosa ou diferença de tempo entre compra e devolução. Compare taxas somente quando as regras de contagem forem consistentes. Relatórios baseados em unidades enviadas e em unidades pedidas não são diretamente comparáveis. A saída repete as duas contagens junto ao percentual, permitindo que você audite o painel e confirme qual denominador foi usado. Guarde esses dados com a taxa quando precisar reproduzir o resultado.

Use a taxa em análises recorrentes

Para acompanhar continuamente, calcule a taxa em uma frequência constante e preserve os dados de cada período. Resultados semanais podem revelar problemas repentinos de processamento ou qualidade, enquanto resultados mensais costumam reduzir o ruído de produtos com volume modesto. Segmente por SKU, fornecedor, categoria, canal, depósito ou campanha para encontrar padrões escondidos pela média geral. Interprete denominadores pequenos com cuidado: uma devolução em duas vendas equivale a cinquenta por cento, mas é menos estável que quinhentas em mil. Combine o percentual com volume, motivos, valor reembolsado e margem antes de decidir sobre o mix. Ao automatizar, envie inteiros obtidos no mesmo fechamento e trate vendas zero como “não aplicável”, não como zero por cento. O navegador é prático para verificações individuais; cada solicitação de API custa US$ 0,002 e atende relatórios agendados. Como não há serviços externos, entradas válidas idênticas sempre produzem a mesma saída.

Compare o desempenho dos produtos

Calcule a taxa de cada SKU com o mesmo período e as mesmas regras para identificar itens que exigem análise.

Monitore mudanças no processamento

Acompanhe percentuais semanais ou mensais após alterações de embalagem, transportadora, depósito ou qualidade.

Crie relatórios de comércio

Adicione aos painéis uma taxa reproduzível, mantendo as contagens de vendas e devoluções usadas.

Qual fórmula a calculadora usa?

Ela divide as unidades devolvidas pelas vendidas e multiplica o resultado por 100.

O que acontece se as unidades vendidas forem zero?

O cálculo retorna um erro de entrada inválida, pois não é possível calcular um percentual com denominador zero.

As unidades devolvidas podem ser zero?

Sim. Com vendas positivas, zero devoluções produz uma taxa de 0 por cento.

O resultado pode superar 100 por cento?

Sim. Isso pode ocorrer quando o período inclui devoluções de produtos vendidos anteriormente.

Quanto custa um cálculo pela API?

Cada solicitação de API custa US$ 0,002. A calculadora também pode ser executada no navegador.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/ecom/return-rate-calculate

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/ecom/return-rate-calculate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"units_sold":1250,"units_returned":37}'
{
  "units_sold": 1250,
  "units_returned": 37
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.return_rate_calculate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →