Skip to Content
Odoo Menu
  • Sign in
  • Try it free
  • Apps
    Finance
    • Accounting
    • Invoicing
    • Expenses
    • Spreadsheet (BI)
    • Documents
    • Sign
    Sales
    • CRM
    • Sales
    • POS Shop
    • POS Restaurant
    • Subscriptions
    • Rental
    Websites
    • Website Builder
    • eCommerce
    • Blog
    • Forum
    • Live Chat
    • eLearning
    Supply Chain
    • Inventory
    • Manufacturing
    • PLM
    • Purchase
    • Maintenance
    • Quality
    Human Resources
    • Employees
    • Recruitment
    • Time Off
    • Appraisals
    • Referrals
    • Fleet
    Marketing
    • Social Marketing
    • Email Marketing
    • SMS Marketing
    • Events
    • Marketing Automation
    • Surveys
    Services
    • Project
    • Timesheets
    • Field Service
    • Helpdesk
    • Planning
    • Appointments
    Productivity
    • Discuss
    • Approvals
    • IoT
    • VoIP
    • Knowledge
    • WhatsApp
    Third party apps Odoo Studio Odoo Cloud Platform
  • Industries
    Retail
    • Book Store
    • Clothing Store
    • Furniture Store
    • Grocery Store
    • Hardware Store
    • Toy Store
    Food & Hospitality
    • Bar and Pub
    • Restaurant
    • Fast Food
    • Guest House
    • Beverage Distributor
    • Hotel
    Real Estate
    • Real Estate Agency
    • Architecture Firm
    • Construction
    • Property Management
    • Gardening
    • Property Owner Association
    Consulting
    • Accounting Firm
    • Odoo Partner
    • Marketing Agency
    • Law firm
    • Talent Acquisition
    • Audit & Certification
    Manufacturing
    • Textile
    • Metal
    • Furnitures
    • Food
    • Brewery
    • Corporate Gifts
    Health & Fitness
    • Sports Club
    • Eyewear Store
    • Fitness Center
    • Wellness Practitioners
    • Pharmacy
    • Hair Salon
    Trades
    • Handyman
    • IT Hardware & Support
    • Solar Energy Systems
    • Shoe Maker
    • Cleaning Services
    • HVAC Services
    Others
    • Nonprofit Organization
    • Environmental Agency
    • Billboard Rental
    • Photography
    • Bike Leasing
    • Software Reseller
    Browse all Industries
  • Community
    Learn
    • Tutorials
    • Documentation
    • Certifications
    • Training
    • Blog
    • Podcast
    Empower Education
    • Education Program
    • Scale Up! Business Game
    • Visit Odoo
    Get the Software
    • Download
    • Compare Editions
    • Releases
    Collaborate
    • Github
    • Forum
    • Events
    • Translations
    • Become a Partner
    • Services for Partners
    • Register your Accounting Firm
    Get Services
    • Find a Partner
    • Find an Accountant
      • Get a Tailored Demo
    • Implementation Services
    • Customer References
    • Support
    • Upgrades
    Github Youtube Twitter Linkedin Instagram Facebook Spotify
    +32 2 290 34 90
    • Get a Tailored Demo
  • Pricing
  • Help
  1. APPS
  2. Documents
  3. Create Branded PDFs from any record: invoices, quotes, orders and more. v 17.0
  4. Sales Conditions FAQ

Create Branded PDFs from any record: invoices, quotes, orders and more.

by PDF Generator API https://pdfgeneratorapi.com
Odoo
v 17.0 Third Party 11
Download for v 17.0 Deploy on Odoo.sh
Apps purchases are linked to your Odoo account, please sign in or sign up first.
Versions 17.0 18.0 19.0
You bought this module and need support? Click here!
Versions 17.0 18.0 19.0
  • Description
  • Manifest

This module plugs pdfgeneratorapi.com into Odoo: design templates with a visual drag-and-drop editor, map Odoo fields to template placeholders without code, and generate PDFs from invoices, quotations, purchase orders, transfers, manufacturing orders, and rental orders.

The pdfgeneratorapi.com drag-and-drop editor embedded in Odoo, designing an invoice template against a real record

Key features

  • Drag-and-drop template editor. Open the pdfgeneratorapi.com editor inside Odoo. Design templates visually, with no QWeb, no XML overrides, and no developer required. Preview against a real Odoo record while you design.
  • Smart field mapping. Per-model datasets map Odoo fields to template placeholders, including repeated sections (order lines, taxes) and expressions composing several fields. Editable from the UI with a drag-and-drop field palette, no code required.
  • Send-by-email integration. With the Invoicing bridge installed, the Send wizard adds a toggle and a template picker with a live preview, so customers receive your PDF Generator API design instead of the default invoice report.
  • Async batch dispatch. Select hundreds of records in a list view and generate PDFs for all of them in one click. Per-record async jobs with a signed webhook callback keep Odoo responsive while pdfgeneratorapi.com renders in the background. Follow every job through the Async Jobs list (Pending, Dispatched, Completed, Failed).
  • Coverage diagnostics. A built-in Check coverage wizard compares your template's placeholders against the dataset and reports an X / Y placeholders covered count, plus what is Missing from dataset and Unused by template, so you catch broken templates before your customers do.
  • Multi-company & secure. Per-company API credentials with a global fallback, JWT-signed requests (HS256), webhook signature verification, and secret redaction in logs. An audit message is posted to the record's chatter on every generation.

See it in action

From credentials to a branded PDF in your customer's inbox. Every step happens inside Odoo.

1. Connect your workspace

Paste your pdfgeneratorapi.com API key, secret, and workspace identifier under Settings → PDF Generator API and click Test Connection. Then tick the document types you need. Each one installs its bridge module and seeds a ready-to-edit field dataset.

PDF Generator API settings showing the API credentials fields and the document-type toggles for invoices, sales, purchase, delivery, manufacturing and rental

2. Tune the advanced options (optional)

Override the regional API endpoint or the editor's browser URL for on-premise and Docker setups, and decide what happens to older PDFs when you re-generate: Keep all versions or Replace previously generated PDFs on the record. Manually uploaded files are never touched.

Advanced settings with API base URL and editor web URL overrides, and the attachment cleanup policy options

3. Map Odoo fields to placeholders

Every document type gets a field dataset. Map each template placeholder to an Odoo field or a composed expression, mark repeating sections (order lines, taxes) as lists, and drag fields straight from the palette onto a row, no code required. Check coverage tells you exactly which placeholders are still unmapped.

Field Datasets list showing the seeded datasets for invoice, manufacturing order, purchase order, sale order and stock transfer Field dataset form with the placeholder-to-Odoo-field mapping table and the drag-and-drop field palette on the right

4. Design in the visual editor

Pick a template, a dataset, and a real record, then Open the pdfgeneratorapi.com editor right inside Odoo and design against live data. Opening one of the default templates creates an editable copy under My Templates, so the originals stay intact.

The pdfgeneratorapi.com drag-and-drop editor embedded in Odoo, designing an invoice template against a real record

5. Generate on any record

Click Generate custom PDF on a supported record. The PDF is attached and an audit line is posted to the chatter. Prefer to grab the file straight away? Use the Generate and Download option in the dropdown.

A sale order with the Generate custom PDF split button open, showing the Generate and Download option

6. Email your design

With the Invoicing bridge installed, the invoice Send wizard shows a toggle and a template picker with a live preview. Flip it on and your customer receives your branded design in place of the standard Odoo report.

Invoice Send wizard with the PDF Generator API toggle enabled and a preview of the generated branded invoice

7. Batch-generate asynchronously

Select any number of records in a list view, click Generate custom PDF, choose a template, and Dispatch. Each record runs as its own async job with a signed webhook callback, and you are redirected to the Async Jobs list to follow progress.

Sales quotations list with two records selected and the Generate custom PDF and View Async Jobs toolbar buttons Batch dispatch dialog confirming records will be sent to pdfgeneratorapi.com, with dataset and template pickers

How it is organised

This is the framework module: it ships the API client, the template editor embed, per-model field datasets, coverage diagnostics, and the async job machinery. It adds no buttons to your documents by itself; you pick the document types you want under Settings → PDF Generator API → Document types, and Odoo installs the matching bridge module automatically:

Document type Bridge module What it adds
Customer invoices, vendor bills & credit notes pdfgeneratorapi_connector_account Generate button on invoices, plus a toggle in the Send wizard so customers receive your PDF Generator API design instead of the standard report
Quotations & sale orders pdfgeneratorapi_connector_sale Generate button + starter dataset for sale.order
Purchase orders pdfgeneratorapi_connector_purchase Generate button + starter dataset for purchase.order
Delivery slips & receipts pdfgeneratorapi_connector_stock Generate button + starter dataset for stock.picking
Manufacturing orders pdfgeneratorapi_connector_mrp Generate button + starter dataset for mrp.production
Rental orders pdfgeneratorapi_connector_rental Rental-specific dataset on top of the Sales bridge. Requires Odoo's Rental app (sale_renting, shipped with Odoo Enterprise)

The same machinery extends to any other Odoo model: create a field dataset for the model and inherit the document mixin, with no hardcoded document types anywhere.


Hosting compatibility

Hosting Install Outbound HTTPS
Odoo.shYesYes
Odoo on-premise (Enterprise)YesYes
Odoo CommunityYesYes
Odoo Online (SaaS)NoN/A

Odoo Online does not allow third-party apps; this module cannot run there. The Rental bridge additionally requires the Rental app (sale_renting), which ships with Odoo Enterprise.


Configuration

  1. Sign up at pdfgeneratorapi.com and copy your API key, API secret, and workspace identifier (usually your account email). This module requires a pdfgeneratorapi.com account; the PDF rendering itself happens on their service.
  2. In Odoo, open Settings → PDF Generator API.
  3. Paste the credentials and click Test Connection.
  4. Tick the document types you want, save, and click Generate custom PDF on any matching record.

Privacy & data flow

When you generate a PDF, the record data mapped in your dataset is transmitted to pdfgeneratorapi.com over HTTPS. For an invoice, this typically includes: number, dates, state, currency, company and customer details (name, address, VAT), line items (description, quantity, price, taxes), totals, payment reference, and notes.

Requests are signed with a short-lived JWT (HS256) using your API secret. No data leaves Odoo outside an explicit Generate action (or an async batch you dispatched).

See the PDF Generator API privacy notice (at pdfgeneratorapi.com/privacy-notice) for how transmitted data is handled.

© PDF Generator API, licensed under LGPL-3 Support: support@pdfgeneratorapi.com
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Lines of code 3799
Technical Name pdfgeneratorapi_connector
LicenseLGPL-3
Websitehttps://pdfgeneratorapi.com

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Community
  • Tutorials
  • Documentation
  • Forum
Open Source
  • Download
  • Github
  • Runbot
  • Translations
Services
  • Odoo.sh Hosting
  • Support
  • Upgrade
  • Custom Developments
  • Education
  • Find an Accountant
  • Find a Partner
  • Become a Partner
About us
  • Our company
  • Brand Assets
  • Contact us
  • Jobs
  • Events
  • Podcast
  • Blog
  • Customers
  • Legal • Privacy
  • Security

Odoo is a suite of open source business apps that cover all your company needs: CRM, eCommerce, accounting, inventory, point of sale, project management, etc.

Odoo's unique value proposition is to be at the same time very easy to use and fully integrated.

Website made with