Risoluzione dei problemi

Non riesco ad accedere

• Controlla di essere su app.manisma.com e non su api.manisma.com.
• Controlla e-mail e password; chiedi a un Admin di verificare lo stato del tuo account.
• Un tecnico necessita sia di un account utente sia di un collegamento a un record tecnico.
• Un abbonamento annullato o sospeso può bloccare l’app, anche se il login è corretto.

Il menu Gestione è assente

Gestione compare solo per il ruolo Admin dell’app. Planner, Office e Technician non vedono questo menu. Il ruolo Admin dell’app non è la stessa cosa dell’Administrator Directus integrato.

Un indirizzo non ha percorso o tempo di viaggio

Controlla via, numero civico, CAP, comune e paese. Salva di nuovo l’indirizzo o usa Gestione → Import / Export → Localizza indirizzi. Una quota della mappa può fermare temporaneamente l’elaborazione massiva.

Una commessa non può essere pianificata correttamente

Controlla indirizzo di servizio, durata stimata, competenze richieste, numero di tecnici, orari di lavoro, pause ed eccezioni per data. Un avviso non sempre blocca la pianificazione manuale, ma l’IA rispetta i vincoli rigidi di disponibilità.

Il cliente non riceve l’e-mail

1. Controlla che l’e-mail sia abilitata.
2. Controlla host SMTP, porta, nome utente, mittente e impostazione secure.
3. Salva di nuovo una nuova password se potrebbe essere stata modificata; la password esistente non viene mai mostrata di nuovo.
4. Invia un’e-mail di prova e controlla lo spam.
5. Controlla che il cliente o il contatto abbia un indirizzo e-mail valido.

Foto o firma mancante

Attendi il completamento del caricamento prima di confermare il modulo. Controlla connessione di rete e dimensione del file. Per un artefatto obbligatorio, il modulo deve segnalare cosa manca. Segnala perdite ripetute all’amministratore così che storage e backup possano essere verificati.

Vedo dati vecchi

Tocca il pulsante di aggiornamento (frecce circolari) nella barra superiore. Su Mia pianificazione e su una commessa puoi anche tirare verso il basso per aggiornare. Se vieni da una zona senza copertura, torna online così che l’app recuperi i dati più recenti. I dati mostrati offline hanno al massimo 24 ore di età e mostrano una barra offline arancione.

Le mie modifiche offline non sono sincronizzate

1. Controlla la connessione; la sincronizzazione avviene automaticamente non appena torni online o ti autentichi di nuovo.
2. Guarda la barra con il numero di modifiche in attesa e scegli Sincronizza ora.
3. Le modifiche che non possono essere elaborate restano nella barra; esaminale lì e rimuovile se necessario.
4. Non disconnetterti inutilmente mentre ci sono modifiche in attesa. Restano salvate, ma è preferibile sincronizzare prima quando c’è connessione.

L’app non mostra una nuova versione

Chiudi l’app completamente e riaprila. Una nuova versione si autoinstalla dopo che l’app viene chiusa completamente e riaperta.

L’API restituisce 401 o 403

• 401: intestazione o chiave mancante, chiave errata o disattivata.
• 403: aggiungi lo scope write per POST/PATCH. L’API attuale consente GET con qualsiasi chiave attiva valida; usa comunque read come chiara indicazione amministrativa.
• La chiave grezza non può essere riletta; in caso di dubbio creane una nuova.

L’API restituisce 404 per un id esistente

L’API restituisce 404 anche quando il record appartiene a un altro tenant. Controlla di usare la chiave dell’organizzazione corretta e che l’id provenga da una risposta precedente di quella stessa chiave.

Test webhook non riuscito

Controlla HTTPS, certificato pubblico valido, porta 443/8443, DNS e una risposta 2xx rapida. Redirect e indirizzi privati vengono rifiutati. Verifica la firma sul body grezzo. Controlla il log delle consegne per lo stato HTTP e l’ultimo errore.

La fatturazione blocca l’accesso

Un Admin apre Gestione → Fatturazione. Completa un pagamento aperto, aggiorna il metodo di pagamento o riattiva un abbonamento annullato. L’annullamento è immediato. Prima della fine di un periodo di conservazione, esegui un export completo dei dati quando occorre conservare le informazioni.