Ihr Browser unterstützt JavaScript nicht!

PDF Merger

XMQ PDF Merger for Dynamics 365 Business Central – Hilfe und Dokumentation

Der XMQ PDF Merger ist eine Erweiterung der Ximiq AG für Microsoft Dynamics 365 Business Central. Sie führt die Rechnung und die Schweizer QR-Rechnung zu einem einzigen PDF-Dokument zusammen. So erhalten Ihre Kundinnen und Kunden eine vollständige Rechnung in einer Datei.

Auf dieser Seite finden Sie alles, was Sie für Installation, Einrichtung und Nutzung benötigen. Persönliche Unterstützung erhalten Sie auf unserer Supportseite.

Inhalt

  • Funktionen im Überblick

  • Voraussetzungen

  • Installation

  • Einrichtung Schritt für Schritt

  • Nutzung im Alltag

  • Datenschutz

  • Häufige Fragen und Fehlerbehebung

  • Kontakt

Funktionen im Überblick

  • Automatisch beim Buchen: Beim Buchen einer Verkaufsrechnung erstellt Business Central die Rechnung und die QR-Rechnung als PDF. Der PDF Merger führt beide zu einem PDF zusammen und speichert es als Anhang an der gebuchten Verkaufsrechnung.

  • Automatisch beim E-Mail-Versand: Wenn Sie eine gebuchte Verkaufsrechnung per E-Mail senden, wird das zusammengeführte PDF als E-Mail-Anhang verwendet.

  • Manuell zusammenführen: Mit der Aktion „Alle Belege mergen“ erstellen Sie das zusammengeführte PDF für eine oder mehrere gebuchte Verkaufsrechnungen nachträglich. Mit „Markierte Belege mergen“ führen Sie ausgewählte PDF-Anhänge zusammen.

  • Filter nach Zahlungsmethode: Auf Wunsch wird nur bei bestimmten Zahlungsmethoden zusammengeführt, zum Beispiel nur bei Überweisung mit QR-Rechnung.

  • Dateinamen nach Ihren Vorgaben: Präfix, Debitorennummer und Rechnungsnummer lassen sich im Dateinamen kombinieren.

  • Einzeldokumente bleiben erhalten: Die einzelnen Rechnungs- und QR-Rechnungsanhänge werden nicht verändert.

Voraussetzungen

  • Business Central: Microsoft Dynamics 365 Business Central Online, Version 27.0 oder höher. Unterstützte Editionen: Essentials und Premium.

  • Land und Sprache: Die App ist für die Schweiz ausgelegt (QR-Rechnung). Die Oberfläche ist auf Deutsch (Schweiz) und Englisch verfügbar.

  • Dienstzugang von Ximiq: Das Zusammenführen erfolgt über einen Dienst der Ximiq AG. Dafür benötigen Sie einen persönlichen Funktionsschlüssel (Function Key), den Sie von uns erhalten. Kontaktieren Sie uns über die Supportseite.

  • Ausgehende HTTP-Anforderungen erlaubt: Die Erweiterung muss den Ximiq-Dienst aufrufen dürfen. In Sandbox-Umgebungen ist dies standardmässig gesperrt (siehe Einrichtung, Schritt 2).

  • Berechtigungen: Für die Einrichtung und die manuellen Aktionen benötigen Benutzer den Berechtigungssatz XMQ PDF Merger. Für das normale Buchen und Versenden genügt der Standard-Berechtigungssatz D365 BASIC.

  • Berichte: Ein Verkaufsrechnungsbericht und ein QR-Rechnungsbericht, die PDF-Dokumente erzeugen. Standardmässig wird der Microsoft-Bericht 11510 für die QR-Rechnung verwendet.

Installation

  1. Öffnen Sie in Business Central die Seite Erweiterungsverwaltung und wählen Sie Erweiterungs-Marketplace (Microsoft AppSource).

  2. Suchen Sie nach XMQ PDF Merger und wählen Sie Jetzt holen ⟦bitte bestätigen: AppSource-Link nach Veröffentlichung hier verlinken⟧.

  3. Bestätigen Sie die Lizenzbedingungen und die Datenschutzhinweise und starten Sie die Installation.

  4. Nach der Installation erscheint die App in der Erweiterungsverwaltung als „XMQ Business Central PDF-Merger“ ⟦bitte bestätigen: Anzeigename der App⟧.

Weitere Informationen: Erweiterungen installieren und deinstallieren (Microsoft Learn).

Einrichtung Schritt für Schritt

Die Einrichtung erfolgt einmal pro Mandant. Ohne Einrichtung bucht und versendet Business Central wie bisher, es wird nur nichts zusammengeführt.

Schritt 1: Berechtigungen zuweisen

Weisen Sie den Benutzerinnen und Benutzern, die den PDF Merger einrichten oder manuell zusammenführen, den Berechtigungssatz XMQ PDF Merger zu.

Anleitung: Benutzern Berechtigungen zuweisen (Microsoft Learn).

Schritt 2: HTTP-Anforderungen erlauben

  1. Öffnen Sie die Erweiterungsverwaltung.

  2. Wählen Sie die App XMQ Business Central PDF-Merger und dann Konfigurieren.

  3. Aktivieren Sie auf der Seite Erweiterungseinstellungen die Option HttpClient-Anforderungen zulassen (englisch: „Allow HttpClient Requests“).

Schritt 3: Verbindung einrichten

  • Suchen Sie über die Suchfunktion (Alt+Q) nach PDF-Merger Einrichtung und öffnen Sie die Seite.

  • Wählen Sie die Aktion Bearbeiten. Erst dann lassen sich die Verbindungsfelder ändern.

  • Funktions-URL: Der vorgegebene Wert (https://functions.d365backendservices.xmq.cloud) muss in der Regel nicht geändert werden.

  • Funktionsschlüssel: Tragen Sie den Schlüssel ein, den Sie von Ximiq erhalten haben. Der Schlüssel wird maskiert angezeigt. Geben Sie ihn nicht weiter.

Schritt 4: Berichte festlegen

Im Abschnitt Merge Einrichtung:

  • Berichts ID Rechnung: derselbe Verkaufsrechnungsbericht, den Sie in der Berichtsauswahl für Verkaufsrechnungen verwenden.

  • Berichts ID QR-Rechnung: standardmässig 11510. Ändern Sie den Wert nur, wenn Sie einen eigenen QR-Rechnungsbericht verwenden.

Schritt 5: Zahlungsmethoden festlegen (optional)

Im Abschnitt Zahlungsmethodenfilter:

  • Zahlungsmethodencode nutzen ist ausgeschaltet: Der PDF Merger führt bei allen Rechnungen zusammen.

  • Zahlungsmethodencode nutzen ist eingeschaltet: Tragen Sie in der Liste Zahlungsmethoden alle Zahlungsmethoden ein, bei denen eine QR-Rechnung beigefügt werden soll. Rechnungen mit anderen Zahlungsmethoden, etwa Lastschrift, werden ohne QR-Rechnung gespeichert und versendet.

Schritt 6: Dateinamen festlegen (optional)

  • Im Abschnitt Dateikonfiguration bestimmen Sie den Namen des zusammengeführten PDFs:

  • Dateiname Präfix: frei wählbarer Text mit bis zu 20 Zeichen, zum Beispiel „Rechnung“.

  • Dateiname inkl. Debitorennr.: nimmt die Debitorennummer in den Dateinamen auf.

  • Dateiname inkl. Rechnungsnr.: nimmt die Rechnungsnummer in den Dateinamen auf.

Beispiel: Präfix „Rechnung“ und Rechnungsnummer ergeben „Rechnung 103045.pdf“. Ist nichts ausgewählt, wird ein Standardname in der Sprache des Debitors verwendet.

Schritt 7: Testen

Buchen Sie eine Testrechnung in einem Testmandanten und prüfen Sie den neuen Anhang an der gebuchten Verkaufsrechnung. Senden Sie die Rechnung anschliessend per E-Mail an eine interne Adresse.

Nutzung im Alltag

Automatisch beim Buchen

Sie buchen Verkaufsrechnungen wie gewohnt. Ist die Zahlungsmethode berechtigt, wird das zusammengeführte PDF automatisch als Anhang an der gebuchten Verkaufsrechnung gespeichert.

Automatisch beim E-Mail-Versand

Wenn Sie eine gebuchte Verkaufsrechnung per E-Mail senden, hängt Business Central das zusammengeführte PDF an. Die Einzeldokumente bleiben an der Rechnung gespeichert.

Manuell: Alle Belege mergen

Auf der Seite Gebuchte Verkaufsrechnung sowie in der Liste Gebuchte Verkaufsrechnungen steht die Aktion Alle Belege mergen zur Verfügung. Sie führt die Rechnung und die QR-Rechnung gemäss Einrichtung zusammen, auch für mehrere markierte Rechnungen. Nutzen Sie die Aktion zum Beispiel, wenn ein Anhang nachträglich ersetzt wurde.

Manuell: Markierte Belege mergen

  1. Öffnen Sie die Anhänge einer gebuchten Verkaufsrechnung (Seite Dokumentanhang-Details, englisch „Document Attachment Details“).

  2. Setzen Sie bei allen gewünschten PDF-Anhängen das Häkchen Belege mergen.

  3. Wählen Sie die Aktion Markierte Belege mergen.

  4. Laden Sie die Seite neu. Das zusammengeführte PDF erscheint als neuer Anhang.

Datenschutz

Zum Zusammenführen sendet die Erweiterung die betroffenen PDF-Dokumente über eine verschlüsselte Verbindung (HTTPS) an den Dienst der Ximiq AG und erhält das zusammengeführte PDF zurück. Die Dokumente können Personendaten enthalten, zum Beispiel Namen, Adressen und Zahlungsangaben. Wie wir diese Daten bearbeiten, lesen Sie in unserer Datenschutzerklärung.

Häufige Fragen und Fehlerbehebung

Meldung „Die Ximiq PDF-Merger Einrichtung konnte nicht gefunden werden“

Die Einrichtung fehlt im aktuellen Mandanten. Führen Sie die Schritte 3 bis 5 der Einrichtung aus. Die Einrichtung gilt jeweils pro Mandant.

Meldung „Der PDF-Merger-Dienst konnte nicht erreicht werden“

Prüfen Sie, ob die Option HttpClient-Anforderungen zulassen für die App aktiviert ist (Schritt 2) und ob die Funktions-URL korrekt ist. Prüfen Sie auch, ob Ihre Umgebung ausgehende Verbindungen zulässt.

Meldung „Service meldet Fehler (Code: …)“

  • Code 401 oder 403: Der Funktionsschlüssel fehlt, ist falsch oder nicht mehr gültig. Prüfen Sie den Schlüssel oder fordern Sie bei uns einen neuen an.

  • Code 500 oder höher: Der Dienst konnte die Anfrage nicht verarbeiten. Versuchen Sie es später erneut und melden Sie uns den Fehler, falls er bestehen bleibt.

Nach dem Buchen fehlt das zusammengeführte PDF

  • Ist die Einrichtung für diesen Mandanten vorhanden?

  • Ist der Zahlungsmethodenfilter aktiv und fehlt die Zahlungsmethode der Rechnung in der Liste?

  • Stimmen die Berichts-IDs mit Ihrer Berichtsauswahl überein?

Mit der Aktion Alle Belege mergen können Sie das PDF nachträglich erstellen.

Ich sehe die Seite „PDF-Merger Einrichtung“ nicht

Ihnen fehlt der Berechtigungssatz XMQ PDF Merger. Wenden Sie sich an Ihre Administratorin oder Ihren Administrator.

Kann ich mehrere Einrichtungen anlegen?

Nein. Pro Mandant ist genau eine Einrichtung möglich.

Welche Dateien kann ich zusammenführen?

Der PDF Merger verarbeitet PDF-Dokumente. Maximale Dateigrösse und Anzahl Anhänge pro Vorgang: ⟦bitte bestätigen: Grenzwerte des Dienstes⟧.

Was passiert bei der Deinstallation?

Business Central bucht und versendet Rechnungen weiterhin, jedoch ohne Zusammenführung. Bereits gespeicherte Anhänge bleiben erhalten. Die Einrichtung bleibt gespeichert, ausser Sie löschen beim Deinstallieren auch die Erweiterungsdaten.

Support

Sie finden die Möglichkeiten unsere SUpport zu kontaktieren auf der Supportseite.

Lizenz

Die Lizenzbedingungen finden Sie unter Lizenzbedingungen XMQ PDF Merger.

Beratungsbox Logo
Sie haben eine Frage oder ein Problem? Wir unterstützen Sie gerne.