ForHosting KIT · Ferramentas para dev

Calculadora de prorrateio na troca de plano de assinatura

Esta calculadora de prorrateio de troca de plano mostra o efeito financeiro de migrar um cliente entre planos antes do fim do ciclo de cobrança atual.

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

Informe os preços de ciclo completo do plano atual e do novo plano, os dias não utilizados e a duração total do ciclo. O resultado separa o crédito pelo período não utilizado da cobrança do novo plano para o mesmo intervalo e apresenta o valor líquido, indicando se haverá cobrança, crédito ou nenhum ajuste.

Informe preços e períodos de ciclo comparáveis

Use o preço de cada plano para um ciclo de cobrança completo. Os dois preços devem estar na mesma moeda e seguir a mesma periodicidade; compare mensal com mensal ou anual com anual. Informe o total de dias inteiros do ciclo ativo e, em seguida, quantos dias inteiros restam quando a mudança entra em vigor. Se a troca ocorrer no fim do ciclo, os dias restantes podem ser zero e todos os ajustes também serão zero. A calculadora rejeita uma quantidade de dias restantes maior que o ciclo completo, pois esses dados são incompatíveis. Também rejeita preços negativos, dias fracionários, valores não finitos e ciclos com menos de um dia. Impostos, descontos, saldo da conta, cobranças por uso e processamento de pagamento não fazem parte deste cálculo. Quando forem aplicáveis, calcule primeiro o ajuste básico do plano e depois aplique sua política de cobrança em uma etapa separada e auditável. Essa separação facilita explicar o resultado ao cliente e conciliá-lo com a fatura.

Entenda o crédito, a cobrança e o valor líquido

A fração não utilizada corresponde aos dias restantes divididos pelo total de dias do ciclo. O crédito proporcional multiplica o preço do plano atual por essa fração e representa o serviço já pago, mas ainda não utilizado. A cobrança proporcional multiplica o preço do novo plano pela mesma fração e representa o custo do plano substituto durante os mesmos dias. Cada componente monetário é arredondado para duas casas decimais antes do cálculo do valor líquido, como em um fluxo comum com itens separados na fatura. O valor líquido é a cobrança proporcional menos o crédito proporcional. Um resultado positivo recebe a direção cobrança, indicando que o cliente deve pagar a diferença de um upgrade. Um resultado negativo recebe a direção crédito, indicando que a conta deve receber o valor absoluto em um downgrade. Zero recebe a direção nenhum. Crédito e cobrança permanecem como itens não negativos, enquanto o valor líquido com sinal comunica claramente o saldo final.

Aplique o resultado com consistência na cobrança

Use a saída como um registro transparente do cálculo, em vez de guardar somente um valor líquido sem explicação. Armazene as quatro entradas originais junto com a fração não utilizada, o crédito proporcional, a cobrança proporcional, o valor líquido e a direção. Assim, as equipes financeira e de atendimento conseguem reproduzir a conta sem reconstruir datas posteriormente. Antes de lançar os itens na fatura, confirme se sua organização considera a data efetiva como utilizada ou não utilizada, pois essa política define os dias restantes. Confirme também se seu sistema calcula proporção por segundos corridos, e não por dias inteiros; esta capacidade usa deliberadamente dias inteiros e não deve ser combinada com uma política baseada em segundos. Em preços com impostos incluídos, verifique se as regras locais exigem crédito tributário separado. Para assinaturas com desconto, informe os preços efetivos do ciclo completo quando o desconto participar do prorrateio. A API custa US$ 0,002 por cálculo e não usa rede, data atual nem estado armazenado; portanto, entradas válidas idênticas sempre geram o mesmo resultado.

Simular um upgrade no meio do ciclo

Mostre ao cliente o crédito do plano não utilizado, a cobrança do plano substituto e o valor adicional antes de confirmar o upgrade.

Processar um downgrade de assinatura

Calcule o crédito na conta quando um plano mais barato substitui o atual durante os dias restantes.

Conciliar ajustes de cobrança

Reproduza o prorrateio da fatura com os preços e dias de ciclo armazenados durante uma análise financeira ou de atendimento.

Quanto custa o cálculo?

Cada cálculo pela API custa US$ 0,002. A versão para navegador pode ser executada localmente nesta página.

Como o crédito proporcional é calculado?

O preço do plano atual para o ciclo completo é multiplicado pelos dias restantes divididos pelo total de dias do ciclo e arredondado para duas casas decimais.

Como a cobrança proporcional é calculada?

O preço do novo plano para o ciclo completo é multiplicado pela mesma fração não utilizada e arredondado para duas casas decimais.

O que significa um valor líquido negativo?

Significa que o crédito proporcional é maior que a cobrança. A direção será crédito, e o valor absoluto do resultado líquido será o crédito aplicável.

Os dias restantes podem superar a duração do ciclo?

Não. Essa entrada é incoerente e retorna um erro de entrada inválida. Impostos e descontos não são adicionados automaticamente; informe os preços aplicáveis e trate os impostos conforme sua política.

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/subscription-proration-calc

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/subscription-proration-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"current_plan_price":30,"new_plan_price":60,"days_remaining":10,"billing_cycle_days":30}'
{
  "current_plan_price": 30,
  "new_plan_price": 60,
  "days_remaining": 10,
  "billing_cycle_days": 30
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.subscription_proration_calc",
  "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 →