Générateur de devis PDF

Le Générateur de devis PDF dans Odoo Ventes permet d’envoyer aux clients un fichier PDF entièrement personnalisé pour les devis, mettant en valeur l’entreprise et ses produits et fournissant diverses informations et éléments de conception, au lieu d’afficher simplement le prix et le montant total.

The PDF Quote Builder groups header pages, product descriptions, the price(s), and footer pages to create a detailed quote. It can also inject dynamic texts or custom notes in the PDF to personalize the offer for the customer.

Le fait de disposer d’un PDF personnalisé dans les devis permet aux clients de mieux conclure leur expérience d’achat et confère à l’entreprise un niveau de professionnalisme élégant.

Note

Il est recommandé de modifier les formulaires PDF avec le logiciel Adobe. Les champs de formulaire sur les modèles PDF d’en-tête et de pied de page sont nécessaires pour obtenir des valeurs dynamiques avec Odoo.

Configuration

Afin d’ajouter des fichiers PDF personnalisés pour les devis, la fonctionnalité Générateur de devis PDF doit être configurée.

Pour ce faire, allez à l’application Ventes -‣ Configuration ‣ Paramètres. Ensuite, sur la page des Paramètres, faites défiler jusqu’à la section Devis & Commandes et trouvez la fonctionnalité Générateur de devis PDF.

Texte dynamique dans les PDF

Lors de la création de PDF personnalisés pour les devis, utilisez les textes dynamiques pour qu’Odoo remplisse automatiquement le contenu du PDF avec les informations liées au devis de la base de données Odoo, comme les noms, les prix, etc.

Les valeurs de texte dynamique sont des éléments de formulaire (entrées de texte) qui peuvent être ajoutés dans un fichier PDF et Odoo remplit automatiquement ces valeurs avec des informations relatives au devis.

Valeurs de texte dynamiques

Below are common dynamic text values used in custom PDFs that are already mapped to the correct fields, and what they represent.

For headers and footers PDF:

  • name : Référence de la commande

  • partner_id__name : Nom du client

  • user_id__name: Nom du vendeur

  • amount_untaxed : Montant hors taxes

  • amount_total : Montant total

  • delivery_date : Date de livraison

  • validity_date : Date d’expiration

  • client_order_ref : Référence du client

For product PDF:

  • description : Description du produit

  • quantity : Quantité

  • uom : Unité de mesure (UdM)

  • price_unit : Prix unitaire

  • discount : Remise

  • product_sale_price : Prix du produit

  • taxes : Nom des taxes joint par une virgule (,)

  • tax_excl_price : Prix hors taxes

  • tax_incl_price : Prix toutes taxes comprises

After uploading a PDF, you can then Configure dynamic fields. This will allow you to map any field name found in your PDF to the field you want to show by writing down any existing path. Headers and footers starts from the current sale_order model, whereas product document follows their path from their sale_order_line. Leaving that path empty allows you to fill a custom notes, directly from the specific quote that requires it.

Example

Lorsqu’un PDF est construit, la meilleure pratique consiste à utiliser des valeurs de texte dynamiques communes (name et partner_id_name). Lorsqu’il est téléchargé sur la base de données, Odoo remplit automatiquement ces champs avec les informations de leurs champs respectifs.

Dans ce cas, Odoo remplit automatiquement la référence de la commande dans le champ de texte dynamique name et le nom du client dans le champ partner_id_name.

Le devis PDF est construit en utilisant des placeholders dynamiques communs.

Once the PDF file(s) are complete, save them to the computer’s hard drive, and proceed to upload them to Odoo via Sales app ‣ Configuration ‣ Headers/Footers.

Example

When uploading PDF containing the form field invoice_partner_country, which is an information available in the sales order, configure the path of the Form Field Name to: - partner_invoice_id.country_id.name for a header or footer document - order_id.partner_invoice_id.country_id.name for a product document fills the form with the invoice partner country’s name when the PDF is built.

Example

When uploading any PDF containing the form field custom_note, leaving the path empty allows the seller to write down any note where that form field is in that document and shown when the PDF is built.

Ajouter un PDF au produit

Dans Odoo Ventes, il est également possible d’ajouter un PDF personnalisé à un formulaire de produit. Lorsqu’un PDF est ajouté à un produit et que ce produit est utilisé dans un devis, ce PDF est également inséré dans le PDF final.

To add a custom PDF to a product, start by navigating to Sales app ‣ Products ‣ Products, and select the desired product to add a custom PDF to.

Note

Un document peut également être ajouté à une variante de produit, au lieu d’un produit. S’il existe des documents sur un produit et sur sa variante, seuls les documents de la variante sont affichés.

To add a custom document to a product variant, navigate to Sales app ‣ Products ‣ Product Variants. Select the desired variant, click the Documents smart button, and proceed to upload the custom document to the specific product variant.

On the product page, click the Documents smart button at the top of the page to navigate to a Documents page for that product, where files related to that product can be uploaded. From this page, either click New or Upload.

Le bouton intelligent Documents sur un formulaire de produit dans Odoo Ventes.

Clicking Upload opens the computer’s local file directory. An uploaded document can be further configured on the document card, or by clicking the (vertical ellipsis) icon in the top-right corner of the document card, and then clicking Edit.

En cliquant sur Nouveau, un formulaire de documents vierge apparaît, dans lequel le PDF souhaité peut être chargé via le bouton Charger votre fichier sur le formulaire, situé dans le champ Contenu du fichier.

PDF form configuration

Un formulaire de document standard avec divers champs pour un produit spécifique dans Odoo Ventes.

Le premier champ du formulaire de document est le Nom du document et il est grisé (non cliquable) jusqu’à ce qu’un document soit chargé. Une fois qu’un PDF a été chargé, le champ Nom est rempli automatiquement avec le nom du PDF, et il peut alors être modifié.

Avant de charger un document, il est possible d’indiquer s’il s’agit d’un Fichier ou d’une URL dans le menu déroulant Type.

Un formulaire de document standard avec un PDF chargé dans Odoo Ventes.

Note

Si un PDF est chargé, le champ Type est automatiquement défini sur Fichier et ne peut pas être modifié.

Then, in the Sales section, in the Visible at field, click the drop-down menu, and select either: On quotation, On confirmed order, or Inside quote pdf.

  • Devis : le document est envoyé aux clients (et accessible par eux) à tout moment.

  • Commande confirmée : le document est envoyé aux clients lors de la confirmation d’une commande. Cette option est idéale pour les manuels d’utilisation et autres documents complémentaires.

  • Dans le devis : le document est inclus dans le PDF du devis, entre les pages d’en-tête et la section Prix du devis.

Example

When the Inside quote option for the Visible at field is chosen, and the custom PDF file, Corner Desk.pdf is uploaded, the PDF is visible on the quotation in the customer portal under the Documents field.

Sample of an uploaded pdf with the on quote option chosen in Odoo Sales.

Beside the File Content field, you have the possibility to Configure dynamic fields. When doing so, remember that the starting model is the sale_order_line, unlike for headers and footers that start from the sale_order.

Lastly, in the E-Commerce section, decide whether or not to Publish on Website so that the PDF appears on the product page in the online store.

Example

When the Publish on Website option is enabled, a link to the uploaded document, Corner Desk.pdf, appears on the product’s page in the online store.

Il apparaît dans la section Documents, avec un lien indiquant le nom du document chargé.

Afficher un lien vers un document chargé sur une page produit dans Odoo Ventes.

Devis en PDF

On a sales order, in the Quote Builder tab, select additional documents to be merged into the final PDF. If a selected document has custom fields, they appear as editable text boxes to be filled in.

Selectable quotation headers and footers under the Quote Builder section in a quotation.

Une fois qu’un devis avec un PDF préconfiguré a été confirmé, Odoo permet d’imprimer le devis confirmé pour vérifier qu’il n’y a plus d’erreurs ou de le conserver.

Pour imprimer le devis en PDF, allez au devis confirmé et cliquez sur l’icône ⚙️ (engrenage) pour faire apparaître un menu déroulant. Dans ce menu, cliquez sur Imprimer et sélectionnez Devis en PDF.

L'option d'imprimer un devis en PDF dans le menu déroulant sur la commande confirmée dans Odoo Ventes.

Cette opération télécharge immédiatement le devis en PDF. Une fois ouvert, vous pouvez voir et imprimer le devis en PDF, ainsi que le PDF du produit configuré qui était défini sur Visible dans le devis.

Note

Download these PDF quote builder examples or download sample quotation for added reference.

Pour plus d'infos