El rellenado automático mediante UUID no funciona

Envías un enlace al formulario con ?address[ID]=... o ?estate[Id]=..., pero el formulario se abre vacío en lugar de cargar el registro. Estas son las causas más comunes.


1. El campo uuid no está activado en onOffice

En la administración de onOffice debe estar activado el campo uuid:

  • Módulo Direcciones: en Datos maestros
  • Módulo Inmuebles: en Datos técnicos

Sin el campo uuid activado, onOffice no puede proporcionar el UUID y propform no puede buscar con él.


2. Desactivar «Relleno automático con UUID» en la configuración del formulario

Incluso si los campos UUID están activos en onOffice, debes marcar la casilla «Relleno automático con UUID» en la configuración del formulario, en «Editar registros existentes».

Si la casilla está desmarcada, propform rechaza el parámetro UUID y el formulario se abre vacío.


3. Nombre incorrecto del parámetro URL

Los parámetros de ID difieren por módulo en mayúsculas y minúsculas:

Módulo Correcto Incorrecto
Dirección address[ID] address[Id], address[id]
Inmueble estate[Id] estate[ID], estate[id]
Actividad agentsLog[id] agentslog[id], agentsLog[Id]
Tarea task[id] task[ID]
Fecha calendar[id] calendar[ID]
Criterio de búsqueda searchcriteria[id] searchcriteria[ID]

📖 Resumen completo de parámetros URL: Parámetros URL


4. El usuario de la API no tiene derechos de lectura sobre el registro

El usuario de la API de propform debe tener permiso para leer el registro. Causas frecuentes de bloqueo:

  • Derechos sobre el registro: los derechos de lectura sobre la dirección o el inmueble están restringidos
  • Casilla «Privado»: la dirección tiene marcada la casilla «Privado»; solo el usuario que la ha marcado puede verla
  • Módulo de grupos: el usuario de la API no está asignado a ningún grupo

📖 Instrucciones detalladas: Mi formulario no escribe datos en onOffice


5. UUID utilizado incorrectamente en la macro de onOffice

Si creas el enlace en una plantilla de correo electrónico de onOffice con macros:

  • Correcto: ?address[ID]=_Uuidaddress&estate[Id]=_Uuidestate
  • Incorrecto: ?address[ID]=_address.Uuid (no existe)
  • Incorrecto: ?address[ID]=_AdrUUID (no existe)

Las macros correctas:

  • _Uuidaddress — UUID de la dirección vinculada
  • _Uuidestate — UUID del inmueble vinculado

6. El registro se ha eliminado entretanto

Si el registro cuyo UUID figura en el enlace ya ha sido eliminado en onOffice, propform ya no puede cargarlo. El formulario se abrirá entonces vacío.


Lista de comprobación de prueba

Si nada funciona, comprueba lo siguiente en este orden:

  1. En onOffice: Accede manualmente al registro — ¿sigue existiendo?
  2. En onOffice: ¿Está activado el campo uuid? (Datos maestros en direcciones, datos técnicos en inmuebles)
  3. En propform: Ajustes del formulario → ¿Está marcada la casilla «Rellenar previamente con UUID»?
  4. En el parámetro URL: ¿La ortografía es correcta? (Ten en cuenta las mayúsculas y minúsculas)
  5. Usuario de la API: ¿Tiene derechos de lectura sobre el registro?

Si nada funciona

Escríbenos a hello@propform.io con la siguiente información:

  • El enlace completo del formulario con los parámetros de la URL (puedes ocultar el UUID)
  • Fecha y hora de la consulta
  • ¿Qué registro debería haberse cargado?