Ho esaurito i crediti/quota inclusi: cosa succede e come verificare lo stato

Sintomo

Una richiesta di generazione documento fallisce con un errore relativo alla quota, oppure il plugin WordPress mostra un avviso che la quota inclusa nel piano è esaurita.

Causa

Ogni piano POP include un numero di operazioni mensili (“crediti”) a consumo. La generazione locale di un documento (XML, PDF, UBL, FA(3)) non consuma mai un credito: a consumarlo è solo l’operazione successiva, quando prevista, cioè l’invio a un canale (SdI, PEPPOL, KSeF, Zoho, Fatture in Cloud, Aruba, SdI via PEC), la consegna via webhook, l’invio email del PDF o la conservazione sostitutiva. Quando la quota inclusa è esaurita:

• se il tuo piano non prevede overquota (uso extra oltre l’incluso), le nuove richieste vengono rifiutate finché non rinnova il ciclo o fai upgrade;
• se il tuo piano prevede overquota ed è abilitata sul tuo account, l’uso extra continua ma può essere fatturato automaticamente, fino a un tetto mensile configurato sul tuo account.

Verifica lo stato del tuo account

GET /wp-json/api/v2/overquota-policy (autenticata con la tua license_key) restituisce lo stato completo: quota inclusa (included_quota), quota già usata (used_quota), se l’overquota è abilitata (overquota_enabled/effective_overquota_enabled), la tariffa per richiesta extra configurata sul tuo account (rate_eur) e il tetto mensile (monthly_cap_eur), oltre a un messaggio di stato leggibile (status_message) con l’azione suggerita (suggested_action).

Fix

• Quota esaurita, overquota non abilitata: attendi il rinnovo del ciclo mensile oppure fai upgrade del piano da popapi.io > Account.
• Overquota abilitata ma hai raggiunto il tetto mensile configurato: le richieste extra vengono bloccate finché non rinnova il ciclo o il tetto viene alzato, contatta il supporto per rivedere il tetto mensile del tuo account.
• Nessun metodo di pagamento valido collegato: l’overquota a pagamento richiede un metodo di pagamento Stripe valido salvato sull’account, aggiungilo dal pannello account prima che l’uso extra possa proseguire.
• Hai un saldo overquota da regolarizzare: se un ordine overquota di un ciclo precedente è rimasto non pagato per più di 30 giorni, il nuovo uso extra a pagamento viene bloccato finché non lo salde, controlla settlement_pending nella risposta di overquota-policy o lo stato pagamenti dal pannello account.
• Non sai se l’overquota è abilitata sul tuo account: non è un’opzione self-service dal plugin, contatta il supporto per attivarla o modificarne i limiti.

Configurazione correlata

Vedi api/overview per l’autenticazione delle chiamate API.