Fallo en la subida de archivos

El usuario del formulario sube un archivo, pero este no llega a onOffice, o bien el formulario se interrumpe durante la subida. Estas son las causas más comunes.

1. Archivo demasiado grande

propform acepta archivos de hasta 128 MB por archivo individual; ese es el límite de nginx del servidor. Los archivos individuales más grandes son rechazados por el servidor antes incluso de llegar a propform.

Si tu archivo es más grande:

• Comprimirlo o reducirlo antes de subirlo.
• Si hay varios archivos grandes: dividirlos en varias operaciones de subida.

2. El usuario de la API no tiene derechos de escritura para los archivos

El usuario de la API de propform necesita derechos de escritura para los archivos en el módulo correspondiente (dirección o inmueble).

Solución: comprueba los derechos de la API — consulta Derechos de usuario de la API de onOffice.

3. La característica del documento no existe o está desactivada

Si has seleccionado una característica de documento en la configuración de campos (solo para cargas de archivos de inmuebles), comprueba en onOffice si esta característica de documento sigue existiendo y está activa.

Error frecuente: Has renombrado o eliminado una característica de documento en onOffice. propform almacena el ID y ya no puede asignar la característica de documento renombrada.

Solución: Edita el campo de subida de archivos en propform y vuelve a seleccionar la característica de documento.

Caso especial: la característica de documento y la subida múltiple son incompatibles

Si has asignado una característica de documento y, aun así, el visitante debe subir varios archivos: esto no es posible a nivel de API (1 característica = 1 archivo).

Síntomas: Solo el último archivo subido llega a onOffice; los demás se descartan de forma silenciosa.

Soluciones:

• Crear varios campos separados con características diferentes
• Activar la agrupación en ZIP/PDF: todos los archivos se convierten en uno solo, que recibe la característica
• Utilizar el campo de archivo sin característica (entonces se pueden realizar tantas subidas como se desee)

4. En subidas de inmuebles: falta el derecho «Comercialización (página web)»

Si al activarse el archivo debe aparecer en una página web (por ejemplo, una imagen para una página de presentación online), el usuario de la API necesita el derecho «Comercialización (página web)».

5. El empaquetado en ZIP o PDF falla

Si quieres combinar varios archivos en un archivo ZIP o PDF:

Empaquetado en PDF — solo imágenes y PDF's

El empaquetado en PDF solo funciona con imágenes (JPG, PNG, HEIC) y archivos PDF. No es posible agrupar otros tipos de archivos (Word, Excel, ZIP, vídeo) en un PDF.

Solución: Selecciona la opción de agrupación en ZIP (funciona con todos los tipos de archivos) o sube los archivos individualmente.

La fusión de PDF falla con archivos PDF protegidos con contraseña → recurso automático a ZIP

Si la opción «Combinar varios archivos en un PDF» está activa y uno de los archivos PDF subidos está protegido con contraseña (por ejemplo, certificados de eficiencia energética de Vonovia, algunos PDF bancarios), la fusión de PDF falla. En ese caso, propform recurre automáticamente a la compresión en ZIP: el destinatario recibe un archivo ZIP en lugar del PDF esperado.

> 💡 La alternativa solo se aplica cuando la opción de fusión está activa. En subidas de un solo archivo o subidas múltiples sin la opción de fusión, el archivo se procesa con normalidad.

Soluciones alternativas:

• Desactivar la opción en la configuración del campo si normalmente solo se espera un único archivo (por ejemplo, solo un PDF de certificado energético)
• Descifrar el PDF previamente (p. ej., mediante la opción «Eliminar configuración de seguridad» de Adobe Acrobat) y volver a subirlo
• Aceptar que, en el caso de archivos PDF de origen protegidos, el resultado sea un ZIP; esto suele ser mejor que los archivos individuales

Agrupación en ZIP

Funciona con todos los tipos de archivo. Si, a pesar de todo, falla, comprueba:

• ¿Son demasiado grandes los archivos individuales? (cada uno debe tener menos de 128 MB; de lo contrario, se aplica el límite de nginx)
• ¿El nombre del archivo contiene algún carácter no válido? (No se permiten caracteres especiales como /, \, :, * no están permitidos en los nombres de archivo)

6. Imágenes HEIC del iPhone

Las imágenes del iPhone en formato HEIC se convierten automáticamente a JPEG antes de subirlas a onOffice. No tienes que hacer nada. Si, a pesar de todo, falla, envíanos un breve mensaje; en muy raras ocasiones hay archivos HEIC defectuosos.

7. iPhone: subir varias fotos a la vez

En el iPhone, el campo de subida de archivos tiene una trampa:

• «Tomar foto» → solo te permite hacer y subir UNA foto
• «Biblioteca» → puedes seleccionar varias fotos a la vez

Solución alternativa para la subida de varias fotos desde el móvil:

1. Primero, toma las fotos con la aplicación normal de la cámara (tantas como sean necesarias)
2. A continuación, ve al formulario → Subida de archivos → selecciona «Biblioteca»
3. Toca varias fotos → todas se guardarán en el campo

> ⚠️ Diferencia importante — campo de carga genérico frente a campo de archivo de la máscara de onOffice: > - El campo genérico «Cargar archivo» (campo superior en la selección de módulos) permite la carga múltiple > - Los campos de archivo creados en la máscara de direcciones/inmuebles de onOffice (p. ej., el campo «Certificado energético») solo permiten UN archivo; se trata de una limitación de la API de onOffice que no se puede modificar

8. Nombres de archivo especiales

Los nombres de archivo muy largos o con caracteres especiales poco habituales pueden causar problemas en onOffice. propform corrige automáticamente los casos típicos, pero los caracteres muy exóticos (por ejemplo, caracteres árabes en el nombre del archivo) pueden provocar problemas.

Solución: Define un nombre de archivo con macros en la configuración del campo —por ejemplo, Anfrage_Name_Vorname—; así, el nombre del archivo se generará automáticamente de forma correcta.

9. El archivo se ha subido, pero no aparece en la API

Si fuera de propform introduces archivos directamente en un campo de archivo de la máscara de direcciones/inmuebles de onOffice (manualmente, no a través del formulario), estos archivos no aparecerán en la llamada a la API GetEstateFiles / GetAddressFiles; por lo tanto, propform no puede procesarlos ni ofrecerlos a través del formulario de descarga.

Contexto: Limitación de la API de onOffice: los archivos en los campos de archivo de la máscara no son accesibles directamente a través de la API.

Solución alternativa: Sube siempre los archivos a través del formulario de propform; propform los coloca primero en la pestaña «Archivos» y luego los referencia en el campo de archivo. De este modo, son accesibles a través de la API.

Si nada funciona

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

• URL del formulario
• Fecha y hora
• Tamaño del archivo + tipo de archivo + nombre del archivo
• Qué opción de agrupación (si está activa)