Lede: Il tuo script Deluge ha successo ma la "Valuta principale" dell'account o un campo valuta non cambiano. Questo di solito deriva dalla confusione tra le impostazioni valutarie a livello di account e i campi valuta a livello di record, o da problemi di localizzazione/formattazione che bloccano gli aggiornamenti Deluge.
Cosa significa — spiegazione concreta legata alla superficie dell'API Zoho, citata [^N]
La "Valuta principale" è un'impostazione a livello di account gestita in Setup > General > Company Details > Currencies e non può essere modificata liberamente tramite normali chiamate API o Deluge una volta impostata; modificarla richiede il consenso e l'intervento del supporto Zoho poiché influisce su tutti i record e sulla configurazione dei tassi di cambio [5][6]. Separatamente, le chiamate di aggiornamento Deluge operano sui record dei moduli (ad esempio zoho.crm.updateRecord("Deals", id, map)) e richiedono il nome API corretto del campo, i tipi di dati e la struttura del record; uno script che chiama updateRecord ma utilizza la chiave sbagliata o la struttura del payload sbagliata può non mostrare alcun cambiamento visibile anche quando la funzione riporta successo [4][8]. Infine, recenti problemi di CRM relativi ai separatori decimali e delle migliaia hanno causato errori di calcolo Deluge sui campi Valuta/Decimale per le localizzazioni che utilizzano formati come 1.234.567,89; ciò può far sì che gli aggiornamenti falliscano silenziosamente o interpretino erroneamente i valori [1][2].
Cause comuni
- Tentativo di modificare la valuta principale a livello di account da uno script Deluge invece di modificare le impostazioni dell'azienda o contattare il supporto [5][6].
- Utilizzo del nome API o della struttura del payload errati durante la chiamata a zoho.crm.updateRecord (chiavi della mappa errate, accesso a campi personalizzati nidificati), in modo che il record non riceva mai il valore desiderato [4][8].
- Passaggio di numeri con separatori specifici della localizzazione (virgole o punti) che CRM/Deluge interpreta erroneamente; CRM non converte automaticamente i decimali in virgola incollati allo stesso modo in cui fa a volte Books [1][2].
- Permesso mancante o tentativo di aggiornare un campo protetto dal sistema che solo i super amministratori o il supporto possono modificare [5].
Come risolvere
- Conferma cosa devi modificare: apri Setup > General > Company Details > Currencies e verifica se devi modificare la "Valuta principale" dell'account o un campo valuta a livello di modulo [5].
- Se devi modificare la Valuta principale, non scriptarla. Fai in modo che il tuo super amministratore contatti support@zohocrm.com e richieda il reset; Zoho deve eseguirlo e spiegherà le conseguenze (eliminazione di più valute, modifiche dei simboli) [5].
- Se stai aggiornando un campo di un record, ispeziona il record con zoho.crm.getRecordById("Module", id) per ottenere i nomi API esatti e la struttura prima di aggiornare; utilizza le chiavi restituite nella tua mappa di aggiornamento, ad esempio, mp.put("FieldAPIName", value) e zoho.crm.updateRecord("Module", id.toLong(), mp) [4][8].
- Normalizza l'input numerico prima di inviarlo: rimuovi i separatori delle migliaia e converti i decimali in virgola in decimali in punto in Deluge (o passa tipi numerici invece di stringhe) in modo che CRM interpreti correttamente il valore; testa prima con una semplice letterale numerica [2][1].
- Aggiungi log di debug e controlla l'oggetto di risposta dell'aggiornamento per errori o codici di errore; se la risposta mostra un fallimento o una struttura inattesa, cattura quell'output e confrontalo con il tuo payload [4][8].
- Riprova dopo aver applicato le correzioni. Se il comportamento corrisponde a un bug noto (ad esempio, un formato numerico specifico blocca Deluge), controlla la community/annunci di Zoho e applica eventuali soluzioni alternative o note di patch fornite [1].
Quando escalare
Escala al Supporto Zoho quando devi modificare la valuta principale dell'account o quando hai convalidato nomi di campo/payload corretti ma Deluge fallisce ancora