ForHosting KIT · Strumenti per sviluppatori

Calcolo del prorata per il cambio di piano di abbonamento

Questo calcolatore del prorata mostra l’effetto economico del passaggio di un cliente da un piano a un altro prima della fine del ciclo di fatturazione in corso.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Inserisca i prezzi per ciclo completo del piano attuale e di quello nuovo, i giorni non utilizzati e la durata totale del ciclo. Il risultato separa il credito riconosciuto per il periodo non fruito dall’addebito del nuovo piano per lo stesso periodo, quindi riporta l’importo netto e specifica se si tratta di un addebito, di un credito o di nessuna rettifica.

Inserisca prezzi e durate di ciclo confrontabili

Utilizzi il prezzo di ciascun piano per un intero ciclo di fatturazione. Entrambi i prezzi devono essere espressi nella stessa valuta e riferirsi alla stessa periodicità: confronti un mensile con un mensile oppure un annuale con un annuale. Indichi il numero totale di giorni interi del ciclo attivo e poi i giorni interi rimanenti nel momento in cui il cambio diventa effettivo. Se il passaggio avviene alla fine del ciclo, i giorni rimanenti possono essere zero e tutte le rettifiche saranno pari a zero. Il calcolatore rifiuta un numero di giorni rimanenti superiore alla durata completa del ciclo, perché i dati sarebbero incoerenti. Rifiuta inoltre prezzi negativi, frazioni di giorno, valori non finiti e cicli inferiori a un giorno. Imposte, sconti, saldo del conto, addebiti a consumo e costi di pagamento non rientrano nel calcolo. Se pertinenti, calcoli prima qui la rettifica base del piano e applichi poi la Sua politica di fatturazione in un passaggio separato e verificabile. Questa separazione rende più semplice spiegare il risultato al cliente e riconciliarlo con la fattura.

Interpreti credito, addebito e importo netto

La frazione non utilizzata è data dai giorni rimanenti divisi per i giorni totali del ciclo. Il credito proporzionale moltiplica il prezzo del piano attuale per tale frazione e rappresenta il valore del servizio pagato ma non fruito. L’addebito proporzionale moltiplica il prezzo del nuovo piano per la stessa frazione e rappresenta il costo del piano sostitutivo negli stessi giorni. Ogni componente monetaria viene arrotondata a due decimali prima di calcolare l’importo netto, come avviene normalmente con righe di fattura distinte. L’importo netto è l’addebito proporzionale meno il credito proporzionale. Un valore positivo ha direzione addebito: il cliente deve pagare la differenza per il passaggio a un piano superiore. Un valore negativo ha direzione credito: sul conto va riconosciuto il valore assoluto per il passaggio a un piano inferiore. Lo zero indica nessuna rettifica. Credito e addebito restano voci non negative, mentre l’importo netto con segno comunica chiaramente il saldo finale.

Applichi il risultato in modo coerente alla fatturazione

Utilizzi l’output come registrazione trasparente del calcolo, invece di conservare soltanto un importo netto privo di contesto. Archivi i quattro input originali insieme alla frazione non utilizzata, al credito proporzionale, all’addebito proporzionale, all’importo netto e alla direzione. In questo modo i team finanziari e di assistenza potranno riprodurre il calcolo senza dover ricostruire le date in seguito. Prima di registrare le righe in fattura, verifichi se la Sua organizzazione considera la data di efficacia come utilizzata o non utilizzata, perché tale regola determina i giorni rimanenti. Verifichi inoltre se il sistema calcola il prorata in secondi di calendario anziché in giorni interi; questa capacità usa intenzionalmente giorni interi e non va combinata con una politica basata sui secondi. Per prezzi comprensivi di imposte, stabilisca se le norme locali richiedono un credito fiscale separato. Per abbonamenti scontati, inserisca i prezzi effettivi dell’intero ciclo se lo sconto deve partecipare al calcolo. L’API costa $0.002 per calcolo e non usa rete, data corrente o stato memorizzato, quindi input validi identici producono sempre lo stesso risultato.

Preventivare un upgrade a metà ciclo

Mostri al cliente il credito per il piano non utilizzato, l’addebito del piano sostitutivo e l’importo aggiuntivo prima della conferma.

Gestire un downgrade dell’abbonamento

Calcoli il credito sul conto quando un piano meno costoso sostituisce quello attuale per i giorni rimanenti.

Riconciliare le rettifiche di fatturazione

Riproduca il prorata della fattura dai prezzi e dai giorni di ciclo archiviati durante una verifica finanziaria o di assistenza.

Quanto costa il calcolo?

Ogni calcolo tramite API costa $0.002. La versione per browser può essere eseguita localmente in questa pagina.

Come viene calcolato il credito proporzionale?

Il prezzo del piano attuale per un ciclo completo viene moltiplicato per i giorni rimanenti divisi per i giorni totali del ciclo e arrotondato a due decimali.

Come viene calcolato l’addebito proporzionale?

Il prezzo del nuovo piano per un ciclo completo viene moltiplicato per la stessa frazione non utilizzata e arrotondato a due decimali.

Che cosa indica un importo netto negativo?

Indica che il credito proporzionale supera l’addebito. La direzione è credito e il valore assoluto dell’importo netto è il credito da applicare.

I giorni rimanenti possono superare la durata del ciclo?

No. Il dato incoerente restituisce un errore di input non valido. Imposte e sconti non vengono aggiunti automaticamente; inserisca i prezzi applicabili e gestisca le imposte secondo la Sua politica.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/ecom/subscription-proration-calc

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

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"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →