Ihr Browser unterstützt JavaScript nicht!

PDF Merger

XMQ PDF Merger for Dynamics 365 Business Central – Help and Documentation

XMQ PDF Merger is an extension by Ximiq AG for Microsoft Dynamics 365 Business Central. It combines the invoice and the Swiss QR-bill into a single PDF document, so your customers receive a complete invoice in one file.

This page contains everything you need to install, set up and use the app. For personal assistance, please visit our support page.

Contents

  • Features at a glance

  • Prerequisites

  • Installation

  • Step-by-step setup

  • Everyday use

  • Data protection

  • Frequently asked questions and troubleshooting

  • Contact

Features at a glance

  • Automatically when posting: When you post a sales invoice, Business Central creates the invoice and the QR-bill as PDF files. PDF Merger combines both into one PDF and saves it as an attachment to the posted sales invoice.

  • Automatically when sending by email: When you email a posted sales invoice, the combined PDF is used as the email attachment.

  • Merge manually: Use the "Merge all documents" action to create the combined PDF for one or more posted sales invoices afterwards. Use "Merge selected documents" to combine selected PDF attachments.

  • Filter by payment method: Optionally, documents are only combined for specific payment methods, for example only for bank transfers with a QR-bill.

  • File names to your specification: Combine a prefix, the customer number and the invoice number in the file name.

  • Individual documents are kept: The separate invoice and QR-bill attachments remain unchanged.

Prerequisites

  • Business Central: Microsoft Dynamics 365 Business Central online, version 27.0 or later. Supported editions: Essentials and Premium.

  • Country and language: The app is designed for Switzerland (QR-bill). The user interface is available in German (Switzerland) and English.

  • Service access from Ximiq: Documents are combined by a service operated by Ximiq AG. You need a personal function key, which you receive from us. Contact us via the support page.

  • Outgoing HTTP requests allowed: The extension must be allowed to call the Ximiq service. In sandbox environments, this is blocked by default (see setup, step 2).

  • Permissions: Users who set up the app or use the manual actions need the XMQ PDF Merger permission set. The standard D365 BASIC permission set is sufficient for regular posting and sending.

  • Reports: A sales invoice report and a QR-bill report that produce PDF documents. By default, Microsoft report 11510 is used for the QR-bill.

Installation

  1. In Business Central, open the Extension Management page and choose Extension Marketplace (Microsoft AppSource).

  2. Search for XMQ PDF Merger and choose Get it now ⟦please confirm: link the AppSource listing here after publication⟧.

  3. Accept the license terms and the privacy notice, and start the installation.

  4. After installation, the app is shown in Extension Management as "XMQ Business Central PDF-Merger" ⟦please confirm: display name of the app⟧.

More information: Install and uninstall extensions (Microsoft Learn).

Step-by-step setup

Setup is done once per company. Without setup, Business Central posts and sends documents as before; nothing is combined.

Step 1: Assign permissions

Assign the XMQ PDF Merger permission set to users who set up PDF Merger or combine documents manually. Instructions: Assign permissions to users (Microsoft Learn).

Step 2: Allow HTTP requests

  1. Open Extension Management.

  2. Select the app XMQ Business Central PDF-Merger and choose Configure.

  3. On the Extension Settings page, select Allow HttpClient Requests.

Step 3: Set up the connection

  1. Use search (Alt+Q) to find and open PDF-Merger Setup.

  2. Choose the Edit action. Only then can the connection fields be changed.

  3. Function URL: The default value (https://functions.d365backendservices.xmq.cloud) usually does not need to be changed.

  4. Function Key: Enter the key you received from Ximiq. The key is shown masked. Do not share it.

Step 4: Specify the reports

In the Merge Setup section:

  • Report id Invoice: the same sales invoice report that you use in the report selection for sales invoices.

  • Report id QR-Invoice: 11510 by default. Only change this value if you use your own QR-bill report.

Step 5: Specify payment methods (optional)

In the Payment Method Filter section:

  • Use Payment Method Code is turned off: PDF Merger combines documents for all invoices.

  • Use Payment Method Code is turned on: In the Payment Methods list, enter every payment method for which a QR-bill should be included. Invoices with other payment methods, such as direct debit, are saved and sent without a QR-bill.

Step 6: Specify file names (optional)

In the File Configuration section, you define the name of the combined PDF:

  • Filename Prefix: any text of up to 20 characters, for example "Invoice".

  • Filename incl. Customer No.: adds the customer number to the file name.

  • Filename incl. Invoice No.: adds the invoice number to the file name.

Example: the prefix "Invoice" and the invoice number result in "Invoice 103045.pdf". If nothing is selected, a default name in the customer's language is used.

Step 7: Test

Post a test invoice in a test company and check the new attachment on the posted sales invoice. Then email the invoice to an internal address.

Everyday use

Automatically when posting

Post sales invoices as usual. If the payment method is eligible, the combined PDF is automatically saved as an attachment to the posted sales invoice.

Automatically when sending by email

When you email a posted sales invoice, Business Central attaches the combined PDF. The individual documents remain saved on the invoice.

Manually: Merge all documents

The Merge all documents action is available on the Posted Sales Invoice page and in the Posted Sales Invoices list. It combines the invoice and the QR-bill according to the setup, also for several selected invoices. Use the action, for example, if an attachment was replaced afterwards.

Manually: Merge selected documents

  1. Open the attachments of a posted sales invoice (Document Attachment Details page).

  2. Select the Combine attachment check box for all PDF attachments you want to combine.

  3. Choose the Merge selected documents action.

  4. Reload the page. The combined PDF is shown as a new attachment.

Data protection

To combine documents, the extension sends the relevant PDF documents over an encrypted connection (HTTPS) to the Ximiq AG service and receives the combined PDF in return. The documents may contain personal data, such as names, addresses and payment details. For information on how we process this data, see our privacy policy.

Frequently asked questions and troubleshooting

Message "The Ximiq PDF-Merger setup could not be found"

The setup is missing in the current company. Complete steps 3 to 5 of the setup. The setup applies per company.

Message "The PDF merger service could not be reached"

Check that Allow HttpClient Requests is selected for the app (step 2) and that the function URL is correct. Also check that your environment allows outgoing connections.

Message "Service reports error (Code: …)"

  • Code 401 or 403: The function key is missing, incorrect or no longer valid. Check the key or request a new one from us.

  • Code 500 or higher: The service could not process the request. Try again later and report the error to us if it persists.

The combined PDF is missing after posting

  • Does a setup exist for this company?

  • Is the payment method filter active and is the invoice's payment method missing from the list?

  • Do the report IDs match your report selection?

You can create the PDF afterwards with the Merge all documents action.

I can't see the PDF-Merger Setup page

You are missing the XMQ PDF Merger permission set. Please contact your administrator.

Can I create more than one setup?

No. Exactly one setup is possible per company.

Which files can I combine?

PDF Merger processes PDF documents. Maximum file size and number of attachments per operation: ⟦please confirm: service limits⟧.

What happens if I uninstall the app?

Business Central continues to post and send invoices, but without combining documents. Attachments already saved are kept. The setup remains stored unless you also delete the extension data during uninstallation.

Support

The possibilities to contact our support are listed on the support page.

License

The license terms are available at XMQ PDF Merger license terms.

Beratungsbox Logo
Do you have a question or a problem? We look forward to support you.