Veendo génère des PDF professionnels de commandes et de devis à la demande. Les PDF sont créés en arrière-plan, enregistrés sur AWS S3 et notifiés au client par e-mail et par notifications in-app.
Génération de PDF à la demande
Lorsque vous demandez le PDF d'une commande ou d'un devis, le système publie une tâche SNS vers veendo-task, qui lit le document depuis MongoDB, génère le HTML depuis le template Handlebars, le convertit en PDF via DocuEngine (bridge HTTPS), et enregistre le fichier sur S3 dans le bucket attachment du tenant.
Le chemin S3 est `{tenantCode}/docs/{documentId}.pdf`. Le document est mis à jour avec les références au PDF (clé S3, bucket, date de génération, taille) et le client reçoit une notification in-app dès que le PDF est prêt.
- Génération asynchrone via SNS et tâche en arrière-plan
- Enregistrement sur AWS S3 dans le bucket du tenant
- Template Handlebars pour une mise en page personnalisée
- Notification in-app et e-mail au client quand le PDF est prêt
Téléchargement et accès aux PDF
Les PDF de commandes et de devis sont téléchargeables de deux manières : par le client connecté (accès authentifié) ou via un lien public unique. Chaque document a un `publicToken` qui permet le téléchargement sans connexion. Les liens publics utilisent une pré-autorisation S3 temporaire (pre-signed URL) avec expiration.
Depuis le panneau admin, vous pouvez télécharger n'importe quel PDF ; le client ne voit le bouton de téléchargement que si le PDF a été généré.
- Téléchargement authentifié : le client connecté accède instantanément
- Téléchargement public : lien unique avec token, aucune connexion requise
- Pre-signed URLs d'AWS S3 avec expiration dans le temps
- Bouton de téléchargement disponible uniquement si le PDF est généré
Branding et personnalisation du PDF
Le template PDF (Handlebars) extrait les données du document (commande/devis) et du setup du tenant : nom de l'entreprise, logo, adresse, messages personnalisés, couleurs du thème. Le setup inclut aussi des informations de facturation optionnelles (numéro d'enregistrement, numéro de TVA, données IBAN) qui apparaissent dans le PDF.
Chaque tenant a son propre template local dans veendo-task, ce qui permet des personnalisations poussées. Pour des personnalisations spécifiques, contactez l'équipe Veendo pour un override du template.
- Template Handlebars avec données dynamiques de la commande et du setup
- Logo, couleurs et nom de l'entreprise depuis le branding setup
- Informations fiscales et IBAN optionnels dans le PDF
- Template personnalisé par tenant sur demande
Sécurité et stockage
Les PDF sont enregistrés sur S3 dans un bucket privé du tenant, avec isolation des données pour la sécurité. L'accès est géré via des pre-signed URLs avec expiration (7 jours par défaut) ou une authentification directe via API. Aucun coût de stockage S3 supplémentaire : le bucket est inclus dans l'infrastructure Veendo.
Les PDF sont tracés dans les logs d'accès pour audit : qui a téléchargé quoi et quand. Les fichiers ne sont jamais supprimés automatiquement, ce qui permet la recherche historique et la reconstitution des documents.
Les PDF restent disponibles indéfiniment sur S3 pour les recherches historiques et les audits.