Échec du téléchargement de fichier

L'utilisateur du formulaire télécharge un fichier, mais celui-ci n'arrive pas dans onOffice — ou le formulaire s'interrompt pendant le téléchargement. Voici les causes les plus fréquentes.

1. Fichier trop volumineux

propform accepte des fichiers jusqu'à 128 Mo par fichier — il s'agit de la limite nginx côté serveur. Les fichiers individuels plus volumineux sont rejetés par le serveur avant même d'arriver à propform.

Si votre fichier est plus volumineux :

• Compressez-le / réduisez-le avant le téléchargement.
• S'il s'agit de plusieurs fichiers volumineux : répartissez-les sur plusieurs opérations de téléchargement.

2. L'utilisateur de l'API ne dispose pas des droits d'écriture sur les fichiers.

L'utilisateur de l'API propform a besoin de droits d'écriture sur les fichiers dans le module concerné (adresse ou bien immobilier).

Solution : Vérifiez les droits API — voir Droits des utilisateurs de l'API onOffice.

3. La caractéristique du document n'existe pas ou est désactivée

Si vous avez sélectionné une caractéristique de document dans les paramètres du champ (uniquement pour les téléchargements de fichiers immobiliers), vérifiez dans onOffice si cette caractéristique de document existe toujours et si elle est active.

Erreur courante : vous avez renommé ou supprimé une caractéristique de document dans onOffice. propform enregistre l'ID et ne peut plus associer la caractéristique de document renommée.

Solution : Modifiez le champ de téléchargement de fichiers dans propform et sélectionnez à nouveau la caractéristique de document.

Cas particulier : la caractéristique de document et le téléchargement multiple sont incompatibles

Si vous avez attribué une caractéristique de document et que le visiteur doit tout de même télécharger plusieurs fichiers : cela n'est pas possible au niveau de l'API (1 caractéristique = 1 fichier).

Symptômes : seul le dernier fichier téléchargé est enregistré dans onOffice, les autres sont rejetés en silence.

Solutions :

• Créer plusieurs champs distincts avec des caractéristiques différentes
• Activer le regroupement ZIP/PDF — tous les fichiers sont regroupés en un seul qui hérite de la caractéristique
• Utiliser un champ de fichier sans caractéristique (dans ce cas, un nombre illimité de téléchargements est possible)

4. Pour les téléchargements de biens immobiliers : le droit « Commercialisation (site web) » manque

Si le fichier doit être publié sur un site web lors de son activation (par exemple, une image pour une page de présentation en ligne), l'utilisateur de l'API a besoin du droit « Commercialisation (site web) ».

5. L'agrégation en ZIP ou PDF échoue

Si vous regroupez plusieurs fichiers dans un fichier ZIP ou PDF :

Agrégation en PDF — images et PDF uniquement

L'agrégation en PDF ne fonctionne qu'avec des images (JPG, PNG, HEIC) et des fichiers PDF. Les autres types de fichiers (Word, Excel, ZIP, vidéo) ne peuvent pas être regroupés dans un PDF.

Solution : choisissez soit le regroupement ZIP (qui fonctionne avec tous les types de fichiers), soit le téléchargement individuel des fichiers.

La fusion PDF échoue pour les PDF protégés par mot de passe → repli automatique vers le format ZIP

Si l'option « Fusionner plusieurs fichiers en un seul PDF » est activée et que l'un des fichiers PDF téléchargés est protégé par un mot de passe (par exemple, les certificats de performance énergétique Vonovia, certains PDF bancaires), la fusion PDF échoue. propform bascule alors automatiquement vers le format ZIP — le destinataire reçoit un fichier ZIP à la place du PDF attendu.

> 💡 La solution de secours ne s'applique que lorsque l'option de fusion est activée. En cas de téléchargement d'un seul fichier ou de téléchargement multiple sans option de fusion, le fichier est traité normalement.

Solutions de contournement :

• Désactiver l'option dans les paramètres du champ si, la plupart du temps, un seul fichier est attendu (par exemple, un seul PDF de certificat énergétique)
• Décrypter le PDF au préalable (par exemple via Adobe Acrobat « Supprimer les paramètres de sécurité ») et le télécharger à nouveau
• Accepter que les PDF sources protégés soient convertis en ZIP — c'est généralement toujours mieux que des fichiers individuels

Regroupement en ZIP

Fonctionne avec tous les types de fichiers. Si cela échoue malgré tout, vérifiez :

• Les fichiers individuels sont-ils trop volumineux ? (chacun doit être inférieur à 128 Mo, sinon la limite nginx s'applique)
• Le nom de fichier contient-il un caractère non valide ? (Les caractères spéciaux tels que /, \, :, * ne sont pas autorisés dans les noms de fichiers)

6. Images HEIC depuis l'iPhone

Les images iPhone au format HEIC sont automatiquement converties en JPEG par propform avant leur téléchargement vers onOffice. Vous n'avez rien à faire. Si cela échoue malgré tout, envoyez-nous un petit message — il arrive très rarement que des fichiers HEIC soient corrompus.

7. iPhone : télécharger plusieurs photos à la fois

Sur l'iPhone, le champ de téléchargement de fichiers comporte un piège :

• « Prendre une photo » → cela ne vous permet de prendre et de télécharger qu'UNE seule photo
• « Bibliothèque » → vous pouvez sélectionner plusieurs photos à la fois

Solution de contournement pour le téléchargement de plusieurs photos depuis un téléphone portable :

1. Prenez d'abord les photos avec l'application Appareil photo standard (autant que nécessaire)
2. Passez ensuite au formulaire → Téléchargement de fichiers → sélectionnez « Bibliothèque »
3. Appuyez sur plusieurs photos → elles apparaissent toutes dans le champ

> ⚠️ Distinction importante — champ de téléchargement générique vs champ de fichier du masque onOffice : > - Le champ générique « Télécharger un fichier » (champ supérieur dans la sélection des modules) permet le téléchargement multiple > - Les champs de fichiers créés dans le masque d'adresse/immobilier d'onOffice (par ex. le champ « Certificat énergétique ») n'autorisent qu'UN SEUL fichier — il s'agit d'une limitation de l'API onOffice, qui ne peut pas être modifiée

8. Noms de fichiers spéciaux

Les noms de fichiers très longs ou contenant des caractères spéciaux inhabituels peuvent poser des problèmes dans onOffice. propform corrige automatiquement les cas typiques, mais des caractères très exotiques (par exemple, des caractères arabes dans le nom du fichier) peuvent entraîner des problèmes.

Solution : Définissez un nom de fichier avec des macros dans les paramètres du champ — par exemple Anfrage_Name_Vorname — le nom de fichier sera alors généré automatiquement de manière correcte.

9. Le fichier a été téléchargé, mais n'apparaît pas via l'API

Si vous insérez des fichiers en dehors de propform directement dans un champ de fichier du masque d'adresse/immobilier onOffice (manuellement, et non via un formulaire), ces fichiers n'apparaissent pas dans l'appel API GetEstateFiles / GetAddressFiles — propform ne peut donc pas les traiter ni les proposer via le formulaire de téléchargement.

Contexte : limitation de l'API onOffice — les fichiers placés dans les champs de fichiers du masque ne sont pas directement accessibles via l'API.

Solution de contournement : téléchargez toujours les fichiers via le formulaire propform — propform les place d'abord dans l'onglet « Fichiers », puis les référence dans le champ de fichier. Ils sont ainsi accessibles via l'API.

Si rien ne fonctionne

Envoyez-nous un e-mail à hello@propform.io en indiquant les informations suivantes :

• URL du formulaire
• Date et heure
• Taille du fichier + type de fichier + nom du fichier
• Quelle option de regroupement (si active)