Problemi e messaggi di errore
Accesso e account
| Problema | Causa da controllare | Azione |
|---|---|---|
| Richiesta codice monouso | OTP già collegato oppure configurazione in corso | Usa l’autenticatore; se appare il QR, completa l’iscrizione |
| Codice OTP rifiutato | Account o ora del dispositivo errati, codice scaduto | Controlla account e ora automatica; prova un codice nuovo |
| Nessun autenticatore disponibile | Recupero del secondo fattore necessario | Contatta un amministratore Netter per il procedimento di recupero |
| Email di verifica non ricevuta | Indirizzo, spam o canale email | Controlla l’indirizzo e segnala l’orario del tentativo |
| Workspace non disponibile | Sospensione o appartenenza revocata | Scegli un altro workspace autorizzato o contatta Netter |
| Google ritorna con errore | Configurazione o collegamento dell’identità | Riporta messaggio e orario, senza condividere la callback completa |
Vedi Accesso e account.
Ricariche e credito
Configurazione fiscale non ancora attivata da Netter
È un controllo globale: il servizio billing non ha TAX_CONFIGURED=true applicato. Un amministratore Netter verifica le impostazioni e abilita Sistema e sicurezza → Fatturazione → Configurazione fiscale approvata. La revisione deve risultare Applicata. Vedi Avvio del servizio.
Calcolo IVA non ancora attivo
Con Stripe configurato manca una registrazione fiscale attiva per il calcolo previsto. Netter deve completarla in Stripe Tax; abilitare soltanto il flag generale non risolve questo secondo controllo.
Bonifico segnalato ma credito a zero
La segnalazione e la ricevuta non confermano un incasso. Attendi che l’operatore riscontri il pagamento e controlla causale e importo. Per Stripe, verifica lo stato del pagamento nel flusso online senza tentare conferme manuali.
Saldo presente ma credito insufficiente
Controlla il wallet usato dalla persona, il credito distribuito ai gruppi, le prenotazioni aperte e i massimi per richiesta/chiave. Una risposta lunga può richiedere una prenotazione maggiore. Le riserve incerte richiedono riconciliazione.
Modelli e richieste AI
| Problema | Verifica |
|---|---|
| Modello assente | Catalogo della chiave, policy, rinomina o mapping disabilitato |
| Protocollo non disponibile | Mapping specifico per chat, Messages, Responses o media |
| Listino scaduto | Prezzo o cambio non aggiornato; intervento Netter sul catalogo |
| Errore provider con saldo cliente positivo | Disponibilità o saldo upstream, distinto dal plafond cliente |
| File illeggibile | Formato, dimensione e presenza di testo; scansioni richiedono un flusso diverso |
| Errore PII | Dipendenza locale necessaria non disponibile; l’invio protetto rimane bloccato |
| Stream interrotto | Trasporto o evento finale mancanti; controllare la contabilizzazione prima di riprovare |
Stati HTTP
| Stato | Interpretazione operativa |
|---|---|
| 400 | Dati o parametri non validi |
| 401 | Sessione o chiave assente, scaduta o non valida |
| 403 | Operazione non autorizzata oppure protezione HTTP; leggere il messaggio |
| 404 | Risorsa inesistente o non visibile nell’ambito corrente |
| 409 | Conflitto di revisione o operazione già registrata |
| 429 | Quota, traffico o concorrenza oltre il limite; rispettare Retry-After |
| 503 | Servizio o configurazione necessari non disponibili |
Il formato e lo stato dell’errore possono variare secondo la superficie. Negli stream gestisci anche errori successivi agli header iniziali.
Come segnalare un problema
Indica workspace, pagina/operazione, nome pubblico del modello, orario con fuso, messaggio esatto e identificativo di richiesta o traccia quando presente. Riproduci il caso con dati sintetici. Non inviare password, API key, QR OTP, prompt privati o URL OAuth completi.