Documentazione

1Fatturazione e addebito

La fatturazione comprende tutto ciò che riguarda l’importo da addebitare. L’addebito è il processo con cui il denaro viene effettivamente incassato dall’abbonato. Questi due processi sono disaccoppiati nel nostro sistema. Ciò significa che l’addebito non deve essere eseguito direttamente dopo la fatturazione. Questo passaggio può essere posticipato (vedere Strategie di addebito). Inoltre, l’importo che deve essere addebitato non dipende solo dall’importo calcolato dal processo di fatturazione. Può essere diverso.

Una volta che l’abbonamento è attivo, teniamo un registro dell’abbonamento per ogni abbonato. Durante il periodo potete aggiungere voci al registro dell’abbonato fornendo rapporti di utilizzo o aggiungendo voci di registro aggiuntive per i servizi che desiderate fatturare al vostro abbonato. Una volta trascorso il periodo, il token dell’abbonato verrà addebitato e verrà creata una fattura di periodo che sarà inviata al vostro abbonato.

Esistono diversi tipi di addebiti che vengono registrati automaticamente dal sistema nel registro dell’abbonato. Tuttavia, avete anche la possibilità di creare manualmente delle voci di registro. Nel caso in cui utilizziate una tariffa a consumo, dovete creare dei rapporti di utilizzo metrico, che indicano che le unità consumate possono essere addebitate.

2Rapporti di utilizzo metrico

I rapporti di utilizzo metrico vengono utilizzati per addebitare ai vostri abbonati le unità consumate nel caso in cui utilizziate tariffe a consumo sul vostro prodotto.

2.1Creare rapporti di utilizzo metrico

I rapporti di utilizzo metrico vengono utilizzati per fatturare l’utilizzo misurato dei vostri prodotti con un prezzo a consumo. Potete creare il rapporto di utilizzo metrico nel backend tramite Space > Abbonamento > Rapporti di utilizzo metrico.

I rapporti di utilizzo metrico vengono generalmente creati tramite l’API web service. Potete anche usare l’operazione create sul Subscription Metric Usage Service per creare un rapporto di utilizzo.

Request

{
	"consumedUnits": "150",
	"description": "Transaction usage subscription 101",
	"externalId": "15-04-transaction-usage",
	"metric": {
		"id": 1
	},
	"subscription": {
		"id": 3
	}
}

2.2Addebitare i rapporti di utilizzo metrico

Tutti i rapporti di utilizzo metrico verranno addebitati automaticamente al vostro abbonato alla fine del periodo. Sommiamo tutti i rapporti di utilizzo metrico di un abbonato e applichiamo automaticamente la tariffa a consumo definita nel prodotto.

3Voci di registro

Nel caso in cui vogliate aggiungere addebiti o accrediti al vostro abbonato, potete farlo tramite le voci di registro.

3.1Creare voci di registro

Le voci di registro possono essere aggiunte manualmente. Aprite l’abbonamento e passate alla scheda delle voci di registro per aggiungere posizioni.

Potete anche aggiungere voci di registro tramite l’API utilizzando l’operazione create sul Subscription Ledger Entry Service.

Note
Gli importi negativi corrispondono ad accrediti.

Request

{
	"amountIncludingTax": "55",
	"externalId": "subscriber-101-consulting-service",
	"quantity": "1",
	"subscriptionVersion": {
		"id": 3
	},
	"taxes": [{
		"rate": "8",
		"title": "VAT Switzerland"
	}],
	"title": "Consulting Services"
}

3.2Addebitare le voci di registro

Una volta create, le voci di registro si trovano nello stato open. Le voci di registro aperte vengono addebitate automaticamente quando il periodo successivo giunge a scadenza. In alternativa, potete anche addebitare manualmente le voci di registro creando un addebito per l’abbonamento.

Gli addebiti possono essere creati tramite il backend navigando alla scheda Addebiti nell’abbonamento. Un addebito è composto da una data di esecuzione pianificata e da un riferimento. Una volta raggiunta la data di esecuzione pianificata, tutte le voci di registro aperte verranno addebitate. In alternativa, potete anche creare addebiti tramite l’API web service utilizzando l’operazione create sul Subscription Charge Service.

Request

{
	"externalId": "1-charge-subscription-101",
	"plannedExecutionDate": "2017-04-25T07:50:15.596Z",
	"processingType": "SYNCHRONOUS",
	"reference": "1-charge-subscription-101",
	"subscription": {
		"id": 3
	}
}

4Strategie di addebito

Gli addebiti vengono normalmente eseguiti automaticamente una volta terminato il periodo. Tuttavia, avete la possibilità di configurare delle strategie di addebito speciali per stabilire quando deve avvenire l’addebito del vostro abbonato. Questo avviene sotto Space > Abbonamenti > Configurazione > Strategie. Qui potete selezionare una strategia di addebito.

Potete anche configurare più strategie di addebito e applicare delle condizioni che determinano come vengono selezionate. Le condizioni di strategia possono essere definite sotto Space > Abbonamenti > Condizioni di strategia.

Ad esempio, se l’importo totale da addebitare è inferiore a 5 EUR, l’addebito potrebbe non avere senso perché le commissioni sono troppo elevate. Si può quindi definire una strategia di addebito che salta l’addebito per questo periodo specifico. L’importo verrà riportato al periodo successivo.

Un altro caso d’uso potrebbe essere che l’addebito debba avvenire sempre all’inizio del mese perché vi aspettate che l’abbonato abbia allora abbastanza denaro sul conto bancario. Potete quindi configurare una strategia di addebito che posticipa l’addebito fino al successivo inizio del mese.