Record di indirizzo con questo UUID non trovato

Clicchi su un link propform da un modello di email onOffice e ricevi il messaggio di errore "Record di indirizzo con questo UUID non trovato" (o analogo per gli immobili)? Ciò ha quasi sempre una delle quattro cause.

> 💡 Prima di approfondire: verifica innanzitutto se l'UUID nell'URL è completo (?address[ID]=... con I maiuscolo e D, ?estate[Id]=... con I maiuscolo e d minuscolo). Gli errori di digitazione nella scrittura delle parentesi sono la causa n. 0.


Sequenza di diagnosi (4 livelli)

Esamina i quattro livelli in questo ordine — le cause più comuni per prime.

1. Il record è stato cancellato

  • Apri onOffice → Modulo Indirizzi / Immobili
  • Cerca l'UUID (o il record corrispondente)
  • Se non è più presente → il record è stato cancellato manualmente o rimosso tramite un'operazione di cancellazione automatica del Process Manager
  • Soluzione: ripristino tramite Amministrazione onOffice → Cestino (se attivato), oppure creare un nuovo record

2. L'utente API non ha diritti di lettura sul modulo

  • onOffice → Strumenti → Impostazioni → Amministrazione → Utenti API → selezionare l'utente API propform
  • Scheda "Diritti" → verificare se "Indirizzi" o "Immobili" sono contrassegnati con il segno di spunta "Lettura"
  • Soluzione: spuntare la casella + salvare. Ha effetto immediato, nessuna cache.

3. Diritti sui record di dati per dipendenti/gruppi troppo restrittivi

In onOffice i record di dati possono essere limitati a determinati dipendenti o gruppi (condivisione).

  • Aprire il record di dati in onOffice → scheda "Diritti" (o "Diritti sui record di dati")
  • Verificare se l'utente API (o il suo gruppo) ha accesso
  • Soluzione: aggiungere l'utente API ai gruppi autorizzati o ampliare le impostazioni di condivisione

> 💡 Nelle versioni di onOffice con modulo gruppi: l'utente API spesso necessita del gruppo "Tutti" o di un gruppo di condivisione specifico.

4. Il record è contrassegnato come "Privato" + l'utente API non è il proprietario

  • Aprire il record → verificare la spunta su "Privato"
  • Se attiva: solo il proprietario (il collaboratore che ha creato il record) vede il record, tutti gli altri — compresi gli utenti API — ne sono esclusi
  • Soluzione: rimuovere il segno di spunta o modificare il proprietario impostando l'utente API

Configurazione di test utile

Se desideri riprodurre l'errore in modo sistematico:

  1. Crea un record di prova in onOffice
  2. Annota l'UUID
  3. Richiama il modulo di prova con l'URL ?address[ID]=<UUID>
  4. Funziona → record, diritti e utente API sono sostanzialmente OK
  5. Non funziona → controlla uno dei quattro livelli sopra indicati

Argomenti correlati