El script Deluge de Zoho CRM no actualiza el campo de moneda principal

Introducción

Tu script Deluge tiene éxito, pero la "Moneda principal" de la cuenta o un campo de moneda no cambia. Esto generalmente se debe a la confusión entre la configuración de moneda a nivel de cuenta y los campos de moneda a nivel de registro, o a problemas de configuración regional/formato que impiden las actualizaciones de Deluge.

Qué significa — explicación concreta ligada a la superficie de la API de Zoho, citada [^N]

La "Moneda principal" es una configuración a nivel de cuenta administrada en Configuración > General > Detalles de la empresa > Monedas y no se puede cambiar libremente a través de llamadas normales de API o Deluge una vez establecida; cambiarla requiere el consentimiento y la intervención del soporte de Zoho porque afecta a todos los registros y a la configuración de tipos de cambio ^[5][6]. Por separado, las llamadas de actualización de Deluge operan sobre registros de módulos (por ejemplo, zoho.crm.updateRecord("Deals", id, map)) y requieren el nombre de API de campo correcto, tipos de datos y estructura de registro; un script que llama a updateRecord pero usa la clave incorrecta o la estructura de carga incorrecta puede no mostrar ningún cambio visible, incluso cuando la función informa éxito ^[4][8]. Finalmente, problemas recientes de CRM en torno a los separadores decimales y de miles han causado errores de cálculo de Deluge en campos de Moneda/Decimal para configuraciones regionales que usan formatos como 1.234.567,89; eso puede hacer que las actualizaciones fallen silenciosamente o que los valores se interpreten incorrectamente ^[1][2].

Causas comunes

• Intentar cambiar la moneda principal a nivel de cuenta desde un script Deluge en lugar de editar la configuración de la empresa o contactar al soporte ^[5][6].
• Usar el nombre de API o la estructura de carga incorrectos al llamar a zoho.crm.updateRecord (claves de mapa incorrectas, acceso a campos personalizados anidados), por lo que el registro nunca recibe el valor deseado ^[4][8].
• Pasar números con separadores específicos de la configuración regional (comas o puntos) que CRM/Deluge interpreta incorrectamente; CRM no convierte automáticamente las comas decimales pegadas de la misma manera que a veces lo hace Books ^[1][2].
• Falta de permiso o intento de actualizar un campo protegido por el sistema que solo los superadministradores o el soporte pueden cambiar ^[5].

Cómo solucionarlo

1. Confirma qué necesitas cambiar: abre Configuración > General > Detalles de la empresa > Monedas y verifica si necesitas cambiar la "Moneda principal" de la cuenta o un campo de moneda a nivel de módulo ^[5].
2. Si necesitas cambiar la Moneda principal, no lo hagas mediante scripting. Haz que tu superadministrador contacte a support@zohocrm.com y solicite el restablecimiento; Zoho debe realizarlo y explicará las consecuencias (eliminación de múltiples monedas, cambios de símbolo) ^[5].
3. Si estás actualizando un campo de registro, inspecciona el registro con zoho.crm.getRecordById("Module", id) para obtener los nombres de API y la estructura exactos antes de actualizar; usa las claves devueltas en tu mapa de actualización, por ejemplo, mp.put("FieldAPIName", value) y zoho.crm.updateRecord("Module", id.toLong(), mp) ^[4][8].
4. Normaliza la entrada numérica antes de enviarla: elimina los separadores de miles y convierte los decimales de coma a decimales de punto en Deluge (o pasa tipos numéricos en lugar de cadenas) para que CRM interprete el valor correctamente; prueba primero con un literal numérico simple ^[2][1].
5. Agrega registros de depuración y verifica el objeto de respuesta de actualización en busca de errores o códigos de error; si la respuesta muestra un fallo o una estructura inesperada, captura esa salida y compárala con tu carga útil ^[4][8].
6. Vuelve a intentarlo después de aplicar las correcciones. Si el comportamiento coincide con un error conocido (por ejemplo, un formato de número específico bloquea Deluge), consulta la comunidad/anuncio de Zoho y aplica cualquier solución alternativa o notas de parche proporcionadas ^[1].

Cuándo escalar

Escala al Soporte de Zoho cuando necesites cambiar la moneda principal de la cuenta o cuando hayas validado los nombres de campo/cargas útiles correctos pero Deluge aún falle