Cicli di Fatturazione

Come IronFlock calcola e genera fatture mensili per risorse infrastrutturali e utilizzo di app di terze parti.

Panoramica

IronFlock esegue un ciclo di fatturazione mensile che produce due tipi separati di fatture per ogni cliente:

Fatture infrastrutturali — Addebiti per l’utilizzo dell’infrastruttura IronFlock (archiviazione, rete, dispositivi virtuali, AI)
Fatture app — Addebiti per l’utilizzo di app di terze parti (app-day), dove i ricavi fluiscono verso il distributore dell’app

Entrambi i flussi di fatturazione vengono elaborati indipendentemente e appaiono come voci separate nella fattura del cliente.

Cadenza di Fatturazione

Il sistema di fatturazione esegue tre attività in background ogni 60 minuti:

Attività	Descrizione
Ciclo fatture	Genera o aggiorna i record di fatturazione per tutti gli account. Alla fine di ogni periodo mensile, le fatture finalizzate vengono raggruppate in una fattura Stripe e addebitate automaticamente.
Controllo dettagli pagamento	Rileva gli account che hanno superato il livello di utilizzo gratuito ma non hanno un metodo di pagamento registrato. I dispositivi su questi account vengono limitati finché non viene aggiunto un metodo di pagamento valido.
Email di avviso budget	Invia avvisi quando l’utilizzo si avvicina o supera il budget configurato dal cliente. Viene inviato un avviso di limite soft alla soglia percentuale del budget. Viene inviato un avviso di limite hard quando viene superato l’intero budget.

Fatturazione Infrastrutturale

Le fatture infrastrutturali coprono le risorse proprie di IronFlock utilizzate dal cliente. Questi addebiti vanno direttamente a IronFlock.

Risorsa	Come viene Misurata
Archiviazione	GB archiviati nei backend del progetto
Rete	MB trasferiti (in entrata + in uscita)
Dispositivi virtuali	Giorni attivi × tariffa giornaliera (tariffa determinata dal livello VM)
Token AI	Crediti AI

Il prodotto attivo di ogni cliente definisce le risorse incluse. Il sistema di fatturazione confronta l’utilizzo effettivo con queste quote:


overage = actual_usage - included_amount
billable_amount = overage × unit_price

Se l’utilizzo rimane entro la quota inclusa, non viene applicato alcun addebito aggiuntivo per quella risorsa.

Fatturazione App

Le fatture app coprono l’utilizzo di app di terze parti pubblicate dai distributori. I ricavi di queste fatture sono condivisi tra il distributore e IronFlock.

Come vengono Fatturati gli App-Day

Conta gli app-day — Per ogni app su ogni dispositivo, conta il numero di giorni in cui è stata eseguita in modalità PROD durante il periodo di fatturazione.
Sottrai le unità incluse — Deduci le unità ricorrenti incluse del prodotto e le eventuali unità una tantum rimanenti dal totale. Le unità una tantum incluse sono un’allocazione a vita che diminuisce nei periodi di fatturazione.
Applica gli sconti sul volume — Gli app-day totali vengono sommati su tutti i dispositivi che utilizzano l’app per quel cliente. Il parametro rebate calcola il prezzo effettivo per unità:
```
effective_price = base_price × units^(-rebate)
total_cost = effective_price × units
```
Genera la fattura — Viene creato un record di fatturazione separato per distributore. Se un cliente usa app di più distributori, ognuno riceve un record di fatturazione indipendente.

Esempio

Un cliente usa 20 dispositivi con la tua app per un mese intero (30 giorni):

Passaggio	Calcolo
App-day totali	20 × 30 = 600
Unità ricorrenti incluse	14
Unità fatturabili	600 − 14 = 586
Prezzo base / rebate	€5,00 / 0,3
Prezzo effettivo	€5,00 × 586^(−0,3) ≈ €0,63 per unità
Totale fattura	€0,63 × 586 ≈ €369,18

Ciclo di Vita della Fattura

Ogni fattura attraversa fasi definite:

Fase	Descrizione
Bozza	L’utilizzo è in accumulo. Aggiornato ogni ora. Non ancora addebitato.
Finalizzata	Il periodo di fatturazione è terminato. L’importo totale è bloccato.
Fatturata	Fattura Stripe creata. Addebiti infrastrutturali e app raggruppati in una singola fattura.
Pagata	Metodo di pagamento del cliente addebitato. La quota di ricavi del distributore dell’app diventa disponibile per il pagamento.

Visualizzazione dello Storico di Fatturazione

I clienti possono visualizzare lo storico di fatturazione in Impostazioni Utente → Fatturazione, inclusi:

Ripartizione degli addebiti per periodo di fatturazione
Voci separate per utilizzo infrastrutturale e per ogni app di terze parti
Stato della fattura (in sospeso, pagata, fallita)
Link per scaricare i PDF delle fatture da Stripe

Come distributore di app, puoi vedere i ricavi generati dalle tue app nella sezione Venditore delle Impostazioni Utente.