Skip to main content

Billomat

Prerequisites​

  • A PolyDoc account and API key — sign up for free, no credit card required. The free plan includes 150 PDF conversions per month.
  • A Billomat account — start a free trial to explore the platform.

Use Case 1: Custom-Branded Invoice PDFs​

Replace Billomat's built-in invoice PDF with a fully custom-branded version generated by PolyDoc, triggered whenever a new invoice is created.
New invoice -> Webhook -> Automation tool -> PolyDoc API -> Email with branded PDF

Enable API access in Billomat​

In your Billomat account, go to Settings → API and enable API access. Note your Billomat subdomain and generate an API key.

Screenshot placeholder: /img/guides/billomat/billomat-uc1-enable-api.png

Set up a webhook for new invoices​

Configure a webhook for the invoice.created event (via the Billomat API or a Zapier/Make integration). Point the webhook to your automation platform's endpoint URL.

Screenshot placeholder: /img/guides/billomat/billomat-uc1-webhook.png

Connect an automation tool​

In your automation tool (Make, Zapier, or n8n), receive the webhook payload and use the invoice ID to fetch full invoice details from the Billomat REST API, including client data and line items.

Screenshot placeholder: /img/guides/billomat/billomat-uc1-automation-tool.png

Map invoice data to your PolyDoc template​

Add an HTTP request step that calls PolyDoc:

  • URL: https://api.polydoc.tech/pdf/convert
  • Method: POST
  • Headers:
    • Authorization: Bearer YOUR_API_KEY (get from the Dashboard)
    • Content-Type: application/json
    • X-Sandbox: true
  • Body: Map the Billomat invoice fields (number, date, client, items) to your branded PolyDoc template
Screenshot placeholder: /img/guides/billomat/billomat-uc1-polydoc-step.png

Deliver the branded PDF​

Add an email step to send the branded PDF to the client. Test by creating a sample invoice in Billomat and verifying the PDF arrives with your custom design.

Screenshot placeholder: /img/guides/billomat/billomat-uc1-deliver-pdf.png

Use Case 2: Batch Export as Branded PDFs​

Export multiple invoices from Billomat as custom-branded PDFs in a single batch — useful for monthly statements or archival.
Billomat API (list invoices) -> Loop -> PolyDoc API -> Storage

Fetch invoices via the Billomat API​

Use the Billomat REST API to fetch a list of invoices for the desired period:

  • GET https://YOUR_SUBDOMAIN.billomat.net/api/invoices
  • Header: X-BillomatApiKey: YOUR_BILLOMAT_KEY
  • Filter by date range, status, or client as needed
Screenshot placeholder: /img/guides/billomat/billomat-uc2-fetch-invoices.png

Map each invoice to your PolyDoc template​

Loop through each invoice and map its fields (invoice number, date, client details, line items, totals) to your PolyDoc template's expected JSON structure.

Screenshot placeholder: /img/guides/billomat/billomat-uc2-map-data.png

Generate and store the PDFs​

Call the PolyDoc API for each invoice and save the returned PDF to cloud storage (Google Drive, S3, etc.) or a local directory. Name each file using the invoice number for easy retrieval.

Screenshot placeholder: /img/guides/billomat/billomat-uc2-store-pdfs.png