Voraussetzung zum Betrieb ist, dass die jeweilige Microsoft Dynamics 365 Business Central Version sich noch im regulären Support befindet. Der erweiterte Support (extended Support) wird ausgeschlossen.
# Unterstützte Digivoice Versionen Für den Anschluss vom eInvoice Sender an Microsoft Dynamics 365 Business Central und für den Betrieb wird ein lizensiertes Digivoice System benötigt. **License**: Gültige Digivoice Lizenz # Installation # Lizenzen ### Microsoft Informationen zu den [Microsoft Business Central Lizenzen](https://docs.squeeze.one/books/dexpro-business-central-apps/page/bc-lizenzen). ### Digivoice Das DEXPRO Digivoice System welches an Business Central angeschlossen werden soll benötigt eine gültige Kunden-Lizenz. # Bezug der DEXPRO Module Detailliertere Informationen finden Sie [hier](https://docs.squeeze.one/books/dexpro-business-central-apps/page/bezug-der-dexpro-module). ### OnPrem Für OnPrem Installationen wird auf Anfrage eines registrierten Resellers / Partners ein Runtime Package mit den benötigten Apps zur Verfügung gestellt. Diese werden durch den Partner der Kundenlizenz hinzugefügt und im Anschluss in das Microsoft Dynamics Business Central eingespielt. ### Cloud Für Cloud Installationen benötigt man lediglich Zugriff auf den Microsoft [AppSource](https://appsource.microsoft.com/de-de/product/dynamics-365-business-central/PUBID.dexprosolutionsgmbh%7CAID.72374%7CPAPPID.37f06ebc-53f0-4d9c-9572-7229113363f9?exp=ubp8&tab=Overview). Hier werden die benötigten DEXPRO Apps heruntergeladen. [](https://appsource.microsoft.com/de-de/product/dynamics-365-business-central/PUBID.dexprosolutionsgmbh%7CAID.72374%7CPAPPID.37f06ebc-53f0-4d9c-9572-7229113363f9?exp=ubp8&tab=Overview) # Einrichtungsassistent Dieser führt den Anwender Schritt für Schritt durch die unterschiedlichen Einrichtungen des Moduls. ### Geführter Einrichtungsassistent 1. Navigieren sie über die Suche zu **DEXPRO eInvoice Einrichtung** 2. Klicken sie auf **Geführter Einrichtungsassistent** um diesen zu starten 3. Folgen Sie den Schritten: #### Schritt 1: Willkommen - Überprüfen Sie die Einleitung - **Aktivieren sie die Experteneinrichtungen** wenn Sie erweiterte Konfigurationsoptionen benötigen #### Schritt 2: Grundlegende Informationen zur Einrichtung Konfigurieren Sie die grundlegenden Einstellungen für die elektronische Rechnungsstellung: - **Base URL**: Webservice-Endpunkt für die Dokumentenerstellung - **Anmeldeinformationen**: Details zur Authentifizierung - **Standard Konfiguration**: Standard Konfigurationsoptionen #### Schritt 3: Zahlungsinformationen (wenn der Expertenmodus aktiviert ist) - Konfigurieren der Zuordnungen von Zahlungsmethoden - Bankverbindung einrichten - Definieren Sie die Zahlungsbedingungen #### Schritt 4: Validierungseinrichtung (wenn der Expertenmodus aktiviert ist) - Regeln für die Dokumentenvalidierung konfigurieren - Feldüberprüfungsmuster festlegen - Anforderungen für Pflichtfelder definieren #### Schritt 5: Abschließende Überprüfung - Überprüfen sie alle Einrichtungen - Klicken sie auf **Beenden** um die Einrichtung abzuschließen ### Optionen für die manuelle Einrichtung Zugriff auf zusätzliche Einstellungen über die **DEXPRO eInvoice Einrichtungsseite**: **Verfügbare Aktionen:** - **Belegwarteschlange**: Ansicht und Verwaltung ausstehender Dokumente - **Prozessprotokoll**: Überprüfung der Verarbeitungshistorie und Fehler - **Debitoreneinrichtung**: Konfigurieren Sie kundenspezifische Einstellungen - **Kreditoreneinrichtung**: Konfigurieren Sie lieferantenspezifische Einstellungen **Mappings Section:** - **Zahlungsbedingungen Keywords**: Zuordnung von Zahlungsbedingungen zu XRechnung-Codes - **Einheiten Code Mappings**: Zuordnung von Maßeinheiten zu internationalen Standards # Konfiguration & Administration # Berechtigungssätze Um die Module nutzen zu können, muss den jeweiligen Anwendern der passende Berechtigungssatz zugewiesen werden. Folgende werden mit ausgeliefert: - DXP Core Admin - DEXPRO Core Administrator - DXP Core User - DEXPRO Core Benutzer - DXP eInvoice Admin - DEXPRO eInvoice Administrator - DXP eInvoice User - DEXPRO eInvoice Benutzer - DXP eInvoice Support - DEXPRO eInvoice Support (schreibgeschützter Zugriff mit nur Leserechten auf alle eInvoice-Tabellen, einschließlich Artefakt-Daten und Protokolle, zzgl. Ausführungsrecht; vorgesehen für Support und Audit zur Diagnose ohne Schreibrechte) ### Benutzer ohne eInvoice-Berechtigungssatz Benutzer, die nicht mit E-Rechnungen arbeiten, benötigen keinen eInvoice-Berechtigungssatz. Die Standardseiten und -abläufe, die die App erweitert, funktionieren für sie weiterhin, zum Beispiel die gebuchten Verkaufs-, Service- und Einkaufsbelege, die Einkaufsgutschrift, die Seiten Zahlungsformen und MwSt.-Klauseln, Buchungen von Belegen, die keine E-Rechnung werden können (etwa Einkaufsrechnungen oder Lieferungen), sowie der E-Mail-Versand solcher Belege. Für diese Benutzer gilt: - Die Spalte **eInvoice-Zahlungstyp** auf der Seite Zahlungsformen zeigt **Keine**. - Zahlungsformen, die sie anlegen, ändern, umbenennen oder löschen, werden nicht in die Zahlungszuordnung der E-Rechnung übernommen. Ein Benutzer mit eInvoice-Berechtigungssatz sollte danach den **eInvoice-Zahlungstyp** einer neuen oder umbenannten Zahlungsform auf der Seite Zahlungsformen setzen. - Die KoSIT-Bericht-Aktionen auf gebuchten Belegen finden keinen Bericht, und die E-Rechnungs-Feldvalidierung auf der Einkaufsgutschrift bleibt ausgeschaltet.Benutzer, die Belege buchen oder versenden, aus denen E-Rechnungen werden (Verkaufs- und Servicerechnungen und -gutschriften, Einkaufsgutschriften), oder die mit den E-Rechnungsseiten arbeiten, benötigen weiterhin einen der eInvoice-Berechtigungssätze.
# DEXPRO Core Der DEXPRO Core verwaltet die einzelnen DEXPRO Apps und deren Dokumente pro Mandant. Es werden alle Belege, welche über die unterschiedlichen DEXPRO Module in Microsoft Dynamics 365 Business Central eingelaufen und verarbeitet worden sind, angezeigt. Zur Nachvervollgung von einzelnen Belegen wird auf eine globale Nummernserie, welche über alle DEXPRO Apps genutzt wird, gesetzt. Dies bietet den Vorteil, dass die Anwender mit nur einer Nummernserie pro Beleg arbeiten. Weitere Informationen finden sie [hier](https://docs.squeeze.one/books/dexpro-business-central-apps/chapter/dexpro-core). # eInvoice Sender Einrichtung In der eInvoice Sender Einrichtung wird sowohl die Anbindung an das DIGIvoice System, als auch die Verarbeitung innerhalb der App eingerichtet. ### Menü #### Konfiguration herunterladen Hiermit wird die Konfiguration und der Aufbau der e-Rechnungsstrukturen heruntergeladen. ### Zugehörig #### Belegwarteschlange Über diesen Menüpunkt erreichen Sie die Belegwarteschlange. #### Prozessprotokoll Über diesen Menüpunkt erreichen Sie das Prozessprotokoll der Transaktionen mit Digivoice. #### Debitoreneinrichtung Über diesen Menüpunkt erreichen Sie die [debitorenspezifische Einrichtung](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/debitoren-und-kreditoren-einrichtung). #### Kreditoreneinrichtung Über diesen Menüpunkt erreichen Sie die [kreditorenspezifische Einrichtung](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/debitoren-und-kreditoren-einrichtung). #### OAuth 2.0 Einrichtung Über diesen Menüpunkt erreichen Sie die [OAuth 2.0 Einrichtung](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/oauth-20-einrichtung) zur Authentifizierung am Digivoice System. #### Zuordnungen - Schlüsselwörter für Zahlungsbedingungen - Zuordnung der e-Rechnungsschlüsselwörter auf vorhandene Zahlungsbedingungen - Einheitencodes - Zuordnung der e-Rechnungseinheiten auf die vorhandenen Einheitencodes - XR-Feldstruktur - Struktur der e-Rechnungsbelege ### Allgemein In diesem FastTab kann man die Nutzung dieser App aktivieren/deaktivieren und die Verbindung zum Digivoice System einrichten. [](https://docs.squeeze.one/uploads/images/gallery/2025-06/image-1749192640622.png) ### Export-Einstellungen Hier werden die Standards für den Export hinterlegt. [](https://docs.squeeze.one/uploads/images/gallery/2025-06/image-1749192716345.png) #### XRechnung 3.0 Standardwerte Die Export-Standardwerte werden für den aktuellen XRechnung-3.0-Standard vorkonfiguriert ausgeliefert. Der **Geschäftsprozesstyp** und die **Spezifikationskennung** sind die beiden Profilfelder, die den E-Rechnungsstandard kennzeichnen, gegen den jeder Beleg generiert wird: - **Geschäftsprozesstyp** - Standardwert **urn:fdc:peppol.eu:2017:poacc:billing:01:1.0**. - **Spezifikationskennung** - Standardwert **urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung\_3.0** (die XRechnung-3.0-CIUS-Kennung).Diese Standardwerte stellen sicher, dass generierte Belege die Konformität zu XRechnung 3.0 deklarieren. Ändern Sie sie nur, wenn Sie ein anderes Profil anstreben und die Auswirkungen auf die nachgelagerte Validierung verstehen.
#### E-Rechnung im E-Mail-Versand Wird ein Beleg über den E-Mail-Versand von Business Central verschickt (Aktion **E-Mail** am gebuchten Beleg), ergänzt die App die E-Mail. Zwei Felder steuern die Anhänge: - **eInvoice zu E-Mail-Anhängen hinzufügen** – hängt die E-Rechnung im Format des Sendeprofils an die E-Mail an. - **Standard-PDF zusätzlich zu ZUGFeRD behalten** – beim Sendeprofil ZUGFeRD ersetzt das ZUGFeRD-PDF das Standard-PDF des Belegs. Ist dieses Feld aktiviert, bleibt das Standard-PDF zusätzlich in der E-Mail. Standardmäßig ist es deaktiviert. Dabei gilt: - Ersetzt wird ausschließlich das Standard-PDF, das Business Central als **<Belegart> <Belegnr.>.pdf** anhängt. Alle anderen Anhänge – z. B. AGB, Dateien aus Eingangsbelegen oder Anhänge anderer Erweiterungen – bleiben immer erhalten. - Die App bearbeitet nur den Beleg, der tatsächlich versendet wird. Beim Versand einer registrierten Mahnung bleibt die E-Mail unverändert: Das Mahnungs-PDF bleibt der Anhang, und für die gemahnten Rechnungen wird keine E-Rechnung erzeugt. - Ist **App aktiviert** ausgeschaltet, greift die App nicht in den E-Mail-Versand ein – weder in die Anhänge noch in Empfänger und CC.Benennt eine andere Erweiterung das Standard-PDF so um, dass die Belegnummer im Dateinamen fehlt, erkennt die App es nicht als Standard-PDF. Es bleibt dann neben dem ZUGFeRD-PDF in der E-Mail.
#### Beleganhänge in der E-Rechnung Ist **Beleganhänge zur eInvoice hinzufügen** aktiviert, werden die Anhänge des gebuchten Belegs als rechnungsbegründende Unterlagen in die E-Rechnung eingebettet - jeweils mit Inhalt, MIME-Code und Dateinamen einschließlich Erweiterung. Das Feld ist standardmäßig deaktiviert, denn alles Eingebettete geht an den Kunden: Aktivieren Sie es nur, wenn alle Anhänge Ihrer gebuchten Belege weitergegeben werden dürfen. - Eingebettet werden nur die Dateitypen, die XRechnung für eingebettete Dokumente zulässt: pdf, png, jpg/jpeg, csv, xlsx und ods. Anhänge anderer Typen und Anhänge ohne Inhalt werden weggelassen; die E-Rechnung selbst wird trotzdem erzeugt. - Die E-Rechnungsdatei, die die App selbst an den gebuchten Beleg anhängt (**eInvoice zu Beleganhängen hinzufügen**), wird nicht noch einmal eingebettet. - Dateinamen müssen je Beleg eindeutig sein: Zwei Anhänge mit gleichem Namen und gleicher Erweiterung lassen die E-Rechnung an der KoSIT-Prüfung scheitern. - Die Konformitätsprüfung meldet einen nicht zulässigen Dateityp und einen mehrfach verwendeten Dateinamen als Warnung (Regel VAL-ATT-001). ### eInvoice Konformitätsprüfung Hier finden Sie die Einstellungen zu der Konformitätsprüfung. [](https://docs.squeeze.one/uploads/images/gallery/2025-06/image-1749192817111.png) ### Belegwarteschlange Hier wird festgelegt, wie lange die Einträge aufbewahrt werden sollen. [](https://docs.squeeze.one/uploads/images/gallery/2025-06/image-1749192836601.png) ### Experteneinstellungen Der Schalter **Experteneinstellungen anzeigen** blendet erweiterte, systemnahe Konfiguration standardmäßig aus. Es handelt sich um einen reinen Oberflächenschalter (er wird nicht in der Einrichtung gespeichert). Wenn Sie ihn aktivieren, werden auf der Einrichtungsseite die folgenden zusätzlichen Gruppen sichtbar: - **XRechnung** - Profilkennungen und XRechnung-spezifische Export-Standardwerte (siehe XRechnung 3.0 Standardwerte oben). - **XML-Validierung** - Einstellungen zur Steuerung der Schema-/Schematron-Validierung des generierten XML. - **Validierungsmuster** - die von den Konformitätsregeln verwendeten regulären Ausdrücke (Muster). - **Objektschemata** - die Schemadefinitionen, die die Struktur des Belegobjekts beschreiben.Lassen Sie die Experteneinstellungen im Normalbetrieb ausgeschaltet. Diese Gruppen legen fest, wie Belege aufgebaut und validiert werden - fehlerhafte Änderungen können dazu führen, dass die Generierung oder Validierung fehlschlägt.
Das Verhalten einzelner Konformitätsregeln (Aktivieren/Deaktivieren, Schweregrad-Übersteuerung, Kategorie und Stufe) wird gesondert konfiguriert - siehe die Seite [Regel-Einrichtung](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/regel-einrichtung). # Debitoren und Kreditoren Einrichtung ### Debitorenspezifische Einrichtungen Zugang über **DEXPRO eInvoice Einrichtung** → **Debitoreneinrichtung** [](https://docs.squeeze.one/uploads/images/gallery/2025-06/image-1749193551004.png) **Konfigurationsoptionen:** - **Kontakt-E-Mail überschreiben**: Andere E-Mail als Standard verwenden - **CC-E-Mail-Adresse**: Weitere Empfänger, die beim Versand in CC gesetzt werden - **Belege automatisch versenden**: Automatisches Senden von Dokumenten aktivieren/deaktivieren - **Standard Sendeprofil**: Standardformat für diesen Kunden - **Käufer-Referenz**: Kundenspezifische Referenzanforderungen ### Kreditorenspezifische Einrichtungen Eine ähnliche Konfiguration ist für Lieferanten für Einkaufsgutschriften verfügbar. [](https://docs.squeeze.one/uploads/images/gallery/2025-06/image-1749193595601.png) ### Email Vorlagen Das System verwendet Word-basierte E-Mail-Vorlagen: **Verfügbare Templates:** - **SalesInvoiceEmail.docx**: Verkaufsrechnungs emails - **SalesCreditMemoEmail.docx**: Verkaufsgutschriften emails - **ServiceInvoiceEmail.docx**: Service Rechnungen emails - **PurchaseCreditMemoEmail.docx**: Einkaufsgutschriften emails **Funktionen der Vorlagen:** - Professionelle Formatierung - Dynamische Einfügung von Inhalten - Branding des Unternehmens - Unterstützung mehrerer Sprachen # OAuth 2.0 Einrichtung Hier werden die OAuth 2.0 / Open Id User und deren Access Token verwaltet. [](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677251925318.png) # Artefakte (GoBD-Revisionshistorie) Die Seite **Artefakte** (DXP eInv Artifacts) ist die unveränderliche Revisionshistorie jeder E-Rechnung, die die App erzeugt hat. Jede Zeile erfasst ein generiertes Artefakt zusammen mit den exakten Eingabedaten, dem Validierungsurteil und den kryptografischen Hashwerten, die belegen, was erzeugt und gesendet wurde. Die Seite ist darauf ausgelegt, die deutschen **GoBD**-Anforderungen an die nachvollziehbare, unveränderbare Aufbewahrung von Geschäftsdokumenten zu erfüllen. {Screenshot von Artefakte (GoBD-Revisionshistorie) hier einfügen} ## Felder - **Format** - das Format der gespeicherten E-Rechnung. Es ist immer **XRechnung XML**, auch beim Sendeprofil **ZUGFeRD PDF**: Das Artefakt enthält die XRechnung, die die KoSIT-Prüfung validiert; das ZUGFeRD-PDF wird erst beim Versand der E-Mail erstellt. - **Status** - der Lebenszyklus-Zustand des Artefakts: **Erstellt**, **KoSIT-geprüft**, **Freigegeben**, **Übermittelt**. - **Artefakt-Hash** - der SHA-256-Hash der gespeicherten E-Rechnungs-Bytes. - **Payload-Hash** - der SHA-256-Hash der JSON-Payload (standardmäßig ausgeblendet). - **KoSIT bestanden** - das Urteil des KoSIT-Validators als Bestanden/Nicht-bestanden-Kennzeichen (nur aussagekräftig, sobald der Status KoSIT-geprüft oder höher ist). - **Validator-Konfigurationsversion** - die Version der verwendeten KoSIT-Validator-Konfiguration, damit das Urteil später reproduziert werden kann. - **Generiert am** / **Freigegeben am** / **Übertragen am** - die Zeitstempel für jeden Meilenstein. - **Ersetzt durch** - falls ein späteres Artefakt dieses ersetzt hat, ein Verweis auf das neuere Artefakt. ## Unveränderbarkeit und GoBD-Relevanz Sobald ein Artefakt den Zustand **Freigegeben** erreicht, wird es unveränderlich - sein Inhalt, seine Hashwerte und sein Urteil können sich nicht mehr ändern. Muss ein Beleg neu ausgestellt werden, wird ein neues Artefakt erstellt und das alte mit **Ersetzt durch** gekennzeichnet, sodass die vollständige Kette erhalten bleibt, anstatt die Historie zu überschreiben.Die SHA-256-Hashwerte sowohl der Quell-Payload als auch des generierten Artefakts erlauben es Ihnen, im Nachhinein nachzuweisen, dass eine gespeicherte E-Rechnung Byte für Byte diejenige ist, die validiert und übertragen wurde. Zusammen mit der Validator-Konfigurationsversion und den Meilenstein-Zeitstempeln ergibt dies den vollständigen, manipulationssicheren Prüfpfad, den die GoBD erwarten.
## Aktionen - **E-Rechnung herunterladen** - lädt das generierte E-Rechnungsartefakt herunter. - **Payload herunterladen** - lädt die Quell-Payload herunter, aus der das Artefakt erstellt wurde. - **KoSIT-Bericht anzeigen** / **KoSIT-Bericht herunterladen** - öffnet den offiziellen [KoSIT-Bericht](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/kosit-bericht) im Viewer oder lädt ihn als Datei herunter. - **Quellbeleg anzeigen** - navigiert zum gebuchten geschäftlichen Quellbeleg (Rechnung, Gutschrift), aus dem das Artefakt generiert wurde. # Regel-Einrichtung Auf der Seite **Regel-Einrichtung** (DXP eInv Rule Setup) wird jede einzelne Konformitätsregel konfiguriert. Die App wird mit einem vollständigen Regelkatalog ausgeliefert, und diese Seite erlaubt es Ihnen, das Verhalten jeder Regel anzupassen - ob sie ausgeführt wird, wie schwerwiegend ihre Feststellungen sind und wie sie kategorisiert wird -, ohne die zugrunde liegende Implementierung zu berühren. {Screenshot von Regel-Einrichtung hier einfügen} ## Konfiguration je Regel - **Aktiviert** - schaltet die Regel ein oder aus. - **Schweregrad-Übersteuerung** - übersteuert den Standard-Schweregrad der Regel (**Fehler**, **Warnung** oder **Information**). Feststellungen mit Schweregrad Fehler blockieren Generierung und Übertragung; Warnung und Information tun dies nicht. - **Kategorie** - die Gruppierung, zu der die Regel gehört, dient der Organisation des Katalogs. - **Stufe** - die Stufe, in der die Regel ausgeführt wird: **Quelldaten-Validierung**, **Geschäftsvalidierung** oder **Rechnungsmodell-Validierung**. Quelldaten und Geschäftsvalidierung laufen live auf nicht gebuchten Belegen; die Rechnungsmodell-Validierung läuft in der Versand-Pipeline und, wenn **Buchungssperre bei Validierungsfehler** aktiviert ist, zusätzlich während der Buchung gegen den gebuchten Beleg, bevor die Buchung festgeschrieben wird (siehe [Live-Konformitätsprüfung (Infobox)](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/live-konformitatsprufung-infobox)). - **Beschreibung** - eine für Menschen lesbare Beschreibung dessen, was die Regel prüft.Die Regelliste wird beim ersten Öffnen der Seite automatisch befüllt, sodass jede Katalogregel mit ihren Standardeinstellungen bereit zur Anpassung erscheint.
## Der Regelkatalog Der Katalog kombiniert zwei Arten von Regeln: - **Offizielle Regeln** - die standardisierten Geschäftsregeln aus der Spezifikation EN 16931 / XRechnung: die Regeln **BR-CO** und **BR-DE**, allgemeine Regeln wie **BR-25**, **BR-32** und **BR-37** sowie die Regeln der einzelnen MwSt.-Kategorien (**BR-S**, **BR-Z**, **BR-E**, **BR-AE**, **BR-IC**, **BR-G**, **BR-O**). - **App-spezifische Regeln** - zusätzliche **VAL-\***-Regeln der App, um Datenprobleme früher und präziser zu erkennen. Die Regeln verteilen sich auf die drei Stufen, damit Probleme so früh wie möglich sichtbar werden: **SourceData** prüft die rohen Belegdaten, **BusinessValidation** prüft Einschränkungen auf Geschäftsebene und **InvoiceModel** prüft das zusammengesetzte Rechnungsmodell unmittelbar vor der Generierung. ## Zwingend blockierende Regeln (Blocking-Mandatory) Eine Teilmenge der offiziellen Regeln ist **Blocking-Mandatory**: Ein Verstoß gegen eine dieser Regeln führt sicher zur Ablehnung durch KoSIT. Diese Regeln können nicht einfach abgeschaltet werden. Es sind: - die arithmetischen Identitäten **BR-CO**, die sicherstellen, dass die Rechnungssummen korrekt aufgehen (BR-CO-10 sowie BR-CO-13 bis BR-CO-17); - **BR-32** und **BR-37** - jeder Nachlass und jeder Zuschlag auf Belegebene trägt eine MwSt.-Kategorie; - **BR-S-08**, **BR-Z-08**, **BR-E-08**, **BR-AE-08**, **BR-IC-08**, **BR-G-08** und **BR-O-08** - der steuerpflichtige Betrag jeder MwSt.-Kategorie stimmt mit den Zeilen, Nachlässen und Zuschlägen dieser Kategorie überein; - **BR-Z-01**, **BR-E-01**, **BR-AE-01**, **BR-IC-01**, **BR-G-01** und **BR-O-01** - eine MwSt.-Kategorie außer dem Normalsatz steht genau einmal in der MwSt.-Aufschlüsselung, wenn eine Zeile, ein Nachlass oder ein Zuschlag sie verwendet, und sonst gar nicht. Das Setzen von **Aktiviert** auf Nein reicht bei einer solchen Regel allein nicht aus - die Regel bleibt faktisch aktiv, bis eine **Konformitäts-Übersteuerung (compliance override)** bestätigt wird. Das Bestätigen der Übersteuerung stempelt den Benutzer sowie Datum/Uhrzeit auf die Regelzeile; das Zurücknehmen entfernt diesen Stempel, und die Regel wird wieder faktisch aktiv.Dies ist eine bewusste Schutzvorkehrung: Das Abschalten einer zwingend blockierenden Regel erzeugt Belege, die die KoSIT-Validierung möglicherweise nicht bestehen und rechtlich nicht konform sein könnten. Deshalb wird die Entscheidung protokolliert (wer sie bestätigt hat und wann), um sie nachvollziehbar zu halten. Deaktivieren Sie diese Regeln nur, wenn Sie die Konsequenzen vollständig verstehen.
# Zahlungsart- und Maßeinheiten-Zuordnung Eine E-Rechnung muss Zahlungsdetails und Mengen mit standardisierten, international anerkannten Codes ausdrücken statt mit den innerhalb von Business Central verwendeten Freitextwerten. Diese Seite beschreibt die beiden Zuordnungslisten, die diese Übersetzung vornehmen, sowie das Routing-Feld, das den Empfänger identifiziert. ## Zuordnung der Zahlungsformen Jede **Zahlungsform** in Business Central wird einem **eInvoice-Zahlungstyp** zugeordnet (dem standardisierten Zahlungsmittel-Code, der vom E-Rechnungsformat gefordert wird). Beim Export eines Belegs schlägt die App die Zahlungsform des Belegs nach und schreibt den zugeordneten Zahlungstyp in die E-Rechnung. {Screenshot von Zahlungsart- und Maßeinheiten-Zuordnung hier einfügen} - **Zahlungsform** - der Zahlungsformcode aus Business Central (das Feld **eInvoice-Zahlungstyp** wird direkt zur Standardliste der Zahlungsformen hinzugefügt). - **eInvoice-Zahlungstyp** - der standardisierte Zahlungsmittel-Code, dem die Zahlungsform zugeordnet wird. Die verfügbaren Werte sind Keine, Barzahlung, Scheckzahlung, Kartenzahlung, Lastschrift und Banküberweisung (abgestimmt auf die Zahlungsmittel-Codes nach UNTDID 4461).Zwei Zahlungstypen erfordern mehr als die Zuordnung. **Kartenzahlung** lässt sich für E-Rechnungsempfänger nicht verwenden: XRechnung verlangt dann die letzten Ziffern der Kartennummer, die Business Central nicht speichert, deshalb meldet die Konformitätsprüfung einen Fehler - ordnen Sie solche Zahlungsformen einem anderen Zahlungstyp zu oder verwenden Sie für E-Rechnungsempfänger eine andere Zahlungsform. **Lastschrift** benötigt auf dem Beleg ein Lastschriftmandat, dessen Debitorenbankkonto eine IBAN oder Kontonummer hat, sowie eine SEPA-Gläubiger-ID: Tragen Sie sie beim Bankkonto des Unternehmens auf dem Beleg als Gläubiger-ID ein (oder bei allen Bankkonten des Unternehmens, wenn Sie nur eine Gläubiger-ID verwenden).
Die zugehörige Zuordnungsliste **Schlüsselwörter für Zahlungsbedingungen** verfügt über die Aktion **Zahlungsmethoden importieren**, die alle Zeilen der Liste löscht und aus den vorhandenen Business-Central-Zahlungsformen neu anlegt und dabei den Zahlungstyp nach Möglichkeit automatisch erkennt, sodass Sie nur noch den Zeilen ohne erkannten Zahlungstyp einen zuweisen müssen, statt die Zeilen von Hand einzugeben. Die Liste zeigt außerdem, welche Zeilen noch nicht zugeordnet sind.Die Aktion **Zahlungsmethoden importieren** löscht alle Zeilen der Liste ohne Rückfrage. Von Hand zugewiesene Zahlungstypen - auch die im Feld **eInvoice-Zahlungstyp** auf der Seite Zahlungsformen gesetzten - und alle weiteren Schlüsselwörter gehen verloren und werden durch die automatische Erkennung ersetzt. Prüfen Sie danach jede Zeile.
## Internationale Maßeinheiten-Codes Die Liste **Internationale Maßeinheiten-Codes** ordnet Maßeinheiten aus Business Central den international standardisierten Maßeinheiten-Codes zu, die in der E-Rechnung gefordert sind. Jede Menge, die in eine E-Rechnung geschrieben wird, muss einen dieser Standardcodes referenzieren; stellen Sie daher sicher, dass die auf Ihren berechneten Artikeln verwendeten Maßeinheiten hier abgebildet sind. Auf der Standardseite der Maßeinheiten hilft die Aktion **Standardcodes automatisch erkennen** beim Zuweisen des internationalen Codes, und das Feld Internationaler Standardcode bietet einen Lookup in diese Liste. ## E-Rechnungs-Leitweg-ID (Routing-Nr.) Das Routing-Feld steht sowohl auf der **Debitoren-** als auch auf der **Kreditorenkarte** zur Verfügung. Es enthält die Routing-Kennung des Empfängers (zum Beispiel die *Leitweg-ID*, die von deutschen Empfängern der öffentlichen Verwaltung verwendet wird), die der empfangenden Plattform mitteilt, wohin die E-Rechnung zuzustellen ist. Beim Debitor trägt es die Bezeichnung **E-Rechnungs-Leitweg-ID (Routing-Nr.)**; beim Kreditor die Bezeichnung **Käuferreferenz (E-Rechnungs-Leitweg-ID / Routing-Nr.)**.Vervollständigen Sie diese Zuordnungen vor dem Produktivstart. Eine fehlende Zahlungstyp- oder Maßeinheiten-Code-Zuordnung oder eine fehlende Routing-Nummer wird als Konformitätsfeststellung sichtbar und kann die Generierung oder Übertragung blockieren.
# Die Versand-Pipeline und Aufgabenwarteschlange Jede E-Rechnung, die die App erzeugt, wird von einer festen, siebenstufigen Pipeline verarbeitet. Belege werden bei der Buchung automatisch in die Warteschlange eingereiht, und ein wiederkehrender Eintrag der Aufgabenwarteschlange arbeitet die Warteschlange im Hintergrund ab. Diese Seite erläutert die Stufen, wann Belege eingereiht werden und wie Wiederholungen und Dead-Lettering funktionieren. ## Die sieben Stufen - **Stufe 1 - Quelldaten-Validierung**: die rohen Belegdaten werden validiert (SourceData-Regeln). - **Stufe 2 - Geschäftsvalidierung**: Einschränkungen auf Geschäftsebene werden validiert (BusinessValidation-Regeln). - **Stufe 3 - Rechnungsmodell-Validierung**: das zusammengesetzte Rechnungsmodell wird validiert (InvoiceModel-Regeln). - **Stufe 4 - Artefakt serialisieren & persistieren**: die validierte Payload wird serialisiert und als unveränderliches [Artefakt](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/artefakte-gobd-revisionshistorie) gespeichert. - **Stufe 5 - XML generieren**: die E-Rechnung wird über die Digivoice-API als XRechnung-XML generiert und als Artefakt gespeichert. Das gilt für jedes Sendeprofil, denn die KoSIT-Prüfung validiert die XRechnung; beim Sendeprofil ZUGFeRD wird das ZUGFeRD-PDF erst beim Versand der E-Mail erstellt. - **Stufe 6 - KoSIT-Vorabvalidierung**: wenn **XML-Validierung aktivieren** in der Einrichtung eingeschaltet ist, wird der generierte Beleg gegen den offiziellen [KoSIT-Validator](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/kosit-bericht) geprüft, bevor er das System verlässt. Eine KoSIT-Ablehnung ist ein dauerhafter Fehler. - **Stufe 7 - Freigeben & übertragen**: das Artefakt wird freigegeben (und dadurch unveränderlich), und die E-Rechnung wird per E-Mail an den Empfänger übertragen.Belege, die nur eingereiht werden, um an den gebuchten Beleg oder die E-Mail angehängt zu werden (statt automatisch versendet zu werden), stoppen nach der Generierung im Status **Generiert** - sie werden in Stufe 7 nicht übertragen.
Die Stufen 1-3 müssen alle bestanden werden, bevor generiert wird. Wird eine Feststellung mit Schweregrad Fehler ausgelöst, fährt der Beleg nicht fort - prüfen Sie die [Validierungsergebnisse](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/validierungsergebnisse) und korrigieren Sie die Daten.
## Wann werden Belege eingereiht? Ein Beleg wird zum Buchungszeitpunkt für die folgenden Belegarten automatisch eingereiht: - Verkaufsrechnung und Verkaufsgutschrift - Servicerechnung und Servicegutschrift - Einkaufsgutschrift ## Die wiederkehrende Aufgabenwarteschlange Die Verarbeitung wird durch einen wiederkehrenden Eintrag der Aufgabenwarteschlange gesteuert: - **Kategorie**: DXPEINV - **Zeitplan**: Montag bis Freitag, 08:00-18:00 Uhr - **Häufigkeit**: alle 30 Minuten Bei jedem Lauf prüft die Aufgabenwarteschlange zuerst kürzlich abgelehnte Einträge erneut (siehe unten), greift dann alle **Ausstehend**-Einträge sowie die **Fehler**-Einträge auf, deren Wiederholung fällig ist, und bewegt sie durch die Pipeline. Jeder Eintrag wird in einer eigenen Transaktion verarbeitet, sodass ein Fehler in einem Eintrag die anderen weder zurücknimmt noch aufhält. ## Wiederholung, Backoff und Dead-Lettering Schlägt eine Stufe mit einem behebbaren Fehler fehl, geht der Eintrag in den Status **Fehler** und wird nach einem ansteigenden Backoff-Zeitplan mit zusätzlichem Jitter wiederholt, um Häufungen zu vermeiden: - Versuchsverzögerungen: **5 Minuten → 15 Minuten → 1 Stunde → 6 Stunden → 24 Stunden**, zzgl. eines kleinen deterministischen Jitters (bis zu 59 Sekunden, abgeleitet aus der Eintragsnummer), sodass Wiederholungen nicht alle im selben Moment ausgelöst werden. - **Max. Wiederholungsversuche**: Standard **5**. Sind die Versuche aufgebraucht, wird der Eintrag in den Status **Fehlgeschlagen** (Dead-Letter) verschoben.Dauerhafte Fehler und Authentifizierungsfehler warten nicht auf Wiederholungen - sie landen **sofort im Dead-Letter**. Ein Dead-Letter-Eintrag (Fehlgeschlagen) wird nicht mehr nach dem Backoff-Zeitplan wiederholt; beheben Sie die Ursache und verwenden Sie **Erneut einreihen** auf der Seite [Belegstatus](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/belegstatus) (oder, für mehrere markierte Einträge gleichzeitig, auf der Seite der Belegwarteschlange), um den Versuchszähler zurückzusetzen und den Eintrag auf Ausstehend zurückzustellen. Die einzige Ausnahme ist eine kürzlich erfolgte inhaltliche Ablehnung, siehe unten.
### Korrigierte Ablehnungen werden automatisch erneut eingereiht Bevor sie die Warteschlange abarbeitet, prüft jeder Lauf der Aufgabenwarteschlange die **Fehlgeschlagen**-Einträge der letzten 30 Tage erneut, die wegen ihres Inhalts abgelehnt wurden - durch die Prüfungen der Stufen 1-3 oder durch KoSIT. Besteht der Beleg die Stufen 1-3 jetzt und ergibt er eine andere E-Rechnung als die abgelehnte, etwa weil die Daten korrigiert wurden, geht der Eintrag zurück auf **Ausstehend** und wird noch im selben Lauf verarbeitet. Ein unveränderter Beleg bleibt, wie er ist, und verursacht keinen Aufruf des Digivoice-Dienstes. Nicht automatisch erneut eingereiht werden Einträge, die an einem Authentifizierungsfehler oder an einem dauerhaften Fehler des Digivoice-Dienstes gescheitert sind, sowie Ablehnungen, die älter als 30 Tage sind. Verwenden Sie für diese **Erneut einreihen**.Ist der automatische Versand aktiviert, wird ein so erneut eingereihter Eintrag ohne weiteres Zutun an den Empfänger gesendet. Das gilt auch nach einem App-Update, das die erzeugte E-Rechnung verändert: Inhaltliche Ablehnungen der letzten 30 Tage werden dann neu generiert und, wenn sie jetzt bestehen, versendet.
Wird ein Beleg außerhalb der Warteschlange über die Standardaktion **E-Mail** versendet, werden seine Einträge im Status Ausstehend, Fehler und Fehlgeschlagen als **Gesendet** abgeschlossen, damit die Aufgabenwarteschlange den Beleg kein zweites Mal versendet. # MwSt.-Klauseln und VATEX-Codes Wird eine Rechnungszeile nicht mit dem Normalsatz oder dem Nullsatz besteuert - bei einer innergemeinschaftlichen Lieferung, bei Steuerschuldnerschaft des Leistungsempfängers (Reverse Charge) oder bei einer Steuerbefreiung -, muss die E-Rechnung für ihre MwSt.-Kategorie einen Befreiungsgrund angeben: einen Text und einen Code aus der EU-Codeliste **VATEX**. Der Text ist die Beschreibung der MwSt.-Klausel in der MwSt.-Buchungsmatrix. Der **Code** einer MwSt.-Klausel in Business Central (zum Beispiel **EU-19**) ist ein frei vergebener Schlüssel und wird nie als Code des Befreiungsgrunds gesendet; stattdessen ergänzt die App jede MwSt.-Klausel um das Feld **eInvoice-VATEX-Code**. {add screenshot of MwSt.-Klauseln here} ## Felder und Aktionen auf der Seite MwSt.-Klauseln - **eInvoice-VATEX-Code** - der VATEX-Code, den die E-Rechnung für diese Klausel sendet. Lassen Sie das Feld leer, um den erkannten Code zu verwenden. - **Erkannter eInvoice-VATEX-Code** - der Code, den die App aus Code und Beschreibung der Klausel erkennt, zum Beispiel VATEX-EU-IC für „Steuerfreie innergemeinschaftliche Lieferung“. Er gilt, solange an der Klausel kein VATEX-Code hinterlegt ist. Ist er leer oder falsch, hinterlegen Sie den VATEX-Code an der Klausel. - **VATEX-Codes vorschlagen** - listet die Klauseln ohne VATEX-Code mit ihrem erkannten Code auf und speichert die erkannten Codes an diesen Klauseln, nachdem Sie die Liste bestätigt haben. Klauseln, für die kein Code erkannt wurde, bleiben leer; hinterlegen Sie deren Code manuell. Solange die App aktiviert ist, wird beim Anlegen oder Bearbeiten einer MwSt.-Klausel der erkannte Code eingetragen, wenn die Klausel noch keinen VATEX-Code hat. Ein an der Klausel hinterlegter VATEX-Code wird nie überschrieben - weder beim Bearbeiten der Klausel noch durch eine spätere App-Version mit geänderter Erkennung.Die Liste bietet die EU-weiten VATEX-Codes an, die der KoSIT-Validator des Digivoice-Dienstes akzeptiert. Nationale Codes (VATEX-FR-..., VATEX-ES-...) und Codes, die erst kürzlich in die Codeliste aufgenommen wurden, etwa VATEX-EU-144, VATEX-EU-146-1E oder VATEX-EU-159, werden nicht angeboten, weil dieser Validator sie ablehnen würde.
## Wie der Code erkannt wird Ist der Code der Klausel selbst ein VATEX-Code - **VATEX-EU-IC** oder ohne Präfix **EU-IC** -, wird er unverändert übernommen. Andernfalls liest die App Code, **Beschreibung** und **Beschreibung 2** der Klausel und erkennt die üblichen deutschen und englischen Formulierungen, gängige Abkürzungen, Verweise auf das UStG und die MwSt-Systemrichtlinie (zum Beispiel § 4 Nr. 1b, § 6a oder § 13b UStG, Art. 138, 146 oder 194 der MwSt-Systemrichtlinie) sowie die Schlüsselbegriffe auf Französisch, Italienisch, Niederländisch und Spanisch. Erkannt werden: - innergemeinschaftliche Lieferung von Waren - VATEX-EU-IC; - Steuerschuldnerschaft des Leistungsempfängers (Reverse Charge) - VATEX-EU-AE; - Ausfuhr aus der EU - VATEX-EU-G; - nicht steuerbar - VATEX-EU-O; - die Differenzbesteuerung für Reisebüros, Gebrauchtgegenstände, Kunstgegenstände sowie Sammlungsstücke und Antiquitäten - VATEX-EU-D, VATEX-EU-F, VATEX-EU-I und VATEX-EU-J. Es zählen nur exakte Muster. Passt nichts oder passt die Formulierung auf mehr als einen Fall (zum Beispiel eine „innergemeinschaftliche Lieferung“, in der auch „Reverse Charge“ steht), wird kein Code erkannt. Prüfen Sie die erkannten Codes einmal und speichern Sie sie mit **VATEX-Codes vorschlagen** oder hinterlegen Sie sie manuell; ein gespeicherter Code hängt nicht mehr von der Erkennung ab. ## MwSt.-Kategorie einer MwSt.-Buchungsmatrix Die MwSt.-Kategorie einer Rechnungszeile ergibt sich aus ihrer MwSt.-Buchungsmatrix:| MwSt.-Buchungsmatrix | MwSt.-Kategorie |
|---|---|
| MwSt.-Berechnungsart **Erwerbsbesteuerung** | K (innergemeinschaftliche Lieferung) oder AE (Steuerschuldnerschaft des Leistungsempfängers) - siehe unten |
| MwSt.-Berechnungsart **Verkaufssteuer** mit MwSt. % 0 | E (steuerbefreit) |
| **Normale MwSt.** oder **Volle MwSt.** mit MwSt. % 0, als **EU-Dienstleistung** gekennzeichnet | K (innergemeinschaftliche Lieferung) |
| **Normale MwSt.** oder **Volle MwSt.** mit MwSt. % 0 | Z (Nullsatz) |
| **Normale MwSt.** oder **Volle MwSt.** mit einem MwSt. % über 0 | S (Normalsatz) |
Ab Business Central 28.4 ergänzt die PEPPOL-App von Microsoft die MwSt.-Klausel um ein eigenes Feld für den VATEX-Code. Der eInvoice Sender liest es nicht, damit die E-Rechnung nicht von einer anderen App abhängt - pflegen Sie immer den **eInvoice-VATEX-Code**.
# Anwendung / Nutzung # Arbeiten mit elektronischen Rechnungen ### Verkaufsdokumente #### Verkaufsaufträge und Rechnungen Verkaufsdokumente wie Aufträge und Rechnungen haben nun eine Factbox für die e-Rechnungskonformitätsprüfung erhalten. In dieser wird der User auf Folgendes hingewiesen: - Erforderliche Pflichtfelder, die leer sind - Validierungswarnungen - Status der Konformität [](https://docs.squeeze.one/uploads/images/gallery/2025-06/image-1749194066171.png) [](https://docs.squeeze.one/uploads/images/gallery/2025-06/image-1749194124342.png) **Häufig fehlende Felder:** - fehlende Umsatzsteuer-Identifikationsnummern der Kunden - Unvollständige Rechnungsadressen - Ungültige E-Mail-Adressen - Codes der Zahlungsarten #### Gebuchte Verkaufsrechnungen Sie finden in der **gebuchten Verkaufsrechnungen** Übersicht: **Neue Felder:** - **E-Rechnung gesendet**: Zeigt an, ob ein elektronisches Dokument gesendet wurde **Neue Aktionen:** {add screenshot of Gebuchte Verkaufsrechnung here} - **DEXPRO eInvoice herunterladen**: Elektronisches Dokument herunterladen #### Gebuchte Verkaufsgutschriften Ähnliche Funktionalität verfügbar in den **gebuchten Verkaufsgutschriften**: - Verfolgung des Dokumentenstatus - Download-Aktion; der E-Mail-Versand läuft wie bei Rechnungen über die Standardaktion **E-Mail** #### Service Rechnungen Die elektronische Rechnungsstellung ist mit den gleichen Funktionalitäten ebenfalls auch für **Service Rechnungen** möglich. ### Dokumenttypen und -formate Beim Herunterladen von Dokumenten können Sie wählen zwischen: [](https://docs.squeeze.one/uploads/images/gallery/2025-06/image-1749194324973.png) 1. **XRechnung XML**: Reines XML-Format, das den deutschen Standards entspricht 2. **ZUGFeRD PDF**: Hybrid-PDF mit eingebetteten XML-Daten 3. **XRechnung XML und Standard PDF**: Beide Formate in einer ZIP-Datei ### Versenden von Dokumenten #### Manuelles Senden 1. Öffnen Sie einen beliebigen gebuchten Verkaufsbeleg 2. Klicken Sie auf **E-Mail**, die Standardaktion von Business Central 3. Die App ergänzt die E-Mail automatisch: - Hängt die E-Rechnung im Format des Sendeprofils an, wenn **eInvoice zu E-Mail-Anhängen hinzufügen** aktiviert ist - Verwendet die **Kontakt-E-Mail überschreiben** als Empfänger und die **CC-E-Mail-Adresse** als CC aus der Debitoreneinrichtung, sofern hinterlegt - Kennzeichnet den Beleg nach dem Versand als **E-Rechnung gesendet** und schließt seine Einträge in der **Belegwarteschlange**, die noch im Status Ausstehend, Fehler oder Fehlgeschlagen sind, als Gesendet ab, damit die Hintergrundverarbeitung den Beleg kein zweites Mal versendet Welche Anhänge die App ersetzt und welche erhalten bleiben, beschreibt die Seite [eInvoice Sender Einrichtung](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/einvoice-sender-einrichtung) im Abschnitt E-Rechnung im E-Mail-Versand. #### Automatisches Verarbeiten Das System kann Dokumente automatisch über die **Belegwarteschlange** verarbeiten: - Belege werden bei der Buchung in eine Warteschlange gestellt - Hintergrundverarbeitung erzeugt und versendet elektronische Dokumente - Statusverfolgung zeigt den Bearbeitungsfortschritt # Live-Konformitätsprüfung (Infobox) Die Infobox **eInvoice Konformitätsprüfung** liefert Ihnen eine Live-Rückmeldung zur E-Rechnungs-Validierung, während Sie einen *nicht gebuchten* Beleg noch bearbeiten. Sie führt dieselben Konformitätsregeln aus, die auch die Versand-Pipeline verwendet, sodass Probleme bereits vor der Buchung erkannt werden statt danach - dann, wenn ihre Behebung deutlich günstiger ist. {Screenshot von Live-Konformitätsprüfung (Infobox) hier einfügen} ## Wo sie erscheint Die Infobox wird auf nicht gebuchten **Verkaufsbelegen** (Angebot, Auftrag, Rechnung, Gutschrift), **Servicebelegen** (Auftrag, Rechnung, Gutschrift) sowie der **Einkaufsgutschrift** angezeigt. Sie wertet neu aus, während Sie den Beleg ändern, und zeigt die aktuellen Feststellungen je Beleg an. ## Was sie anzeigt - Ein grünes Häkchen mit "Beleg bereit für den DEXPRO eInvoice-Export!", wenn der Beleg derzeit alle Konformitätsregeln besteht. - Eine Blockierungs-Anzeige mit einer **Liste von Feststellungen**, wenn dies nicht der Fall ist - jede Zeile zeigt den Feldnamen, den Schweregrad und die Regel-ID. Zu jeder Feststellung kann per Drilldown direkt zum **genauen Feld** gesprungen werden, das Aufmerksamkeit erfordert, sodass Sie nicht nach dem beanstandeten Wert suchen müssen. ## Die Prüfung ein- oder ausschalten Die Live-Prüfung wird durch den übergeordneten Schalter **Feldvalidierung aktivieren** in der eInvoice-Einrichtung aktiviert und dann je Belegbereich über drei Umschalter gesteuert: - **Verkaufsbelege prüfen** - **Servicebelege prüfen** - **Einkaufsbelege prüfen** Deaktivieren Sie einen Umschalter, wenn die Infobox Belege in diesem Bereich nicht auswerten soll. ## Buchungssperre bei Validierungsfehler Wenn **Buchungssperre bei Validierungsfehler** aktiviert ist, werden die Konformitätsfeststellungen zum Buchungszeitpunkt erzwungen und nicht nur angezeigt. Jede Feststellung mit Schweregrad Fehler wird als **sammelbares ErrorInfo** ausgelöst, sodass der Benutzer alle blockierenden Probleme auf einmal sieht statt nacheinander. Jedes ErrorInfo trägt zwei Aktionen: - **Zugehörigen Datensatz öffnen** - navigiert zum Datensatz/Feld, das die Feststellung verursacht hat (wird angezeigt, wenn für die Feststellung ein zugehöriger Datensatz erfasst wurde). - **eInvoice-Einrichtung öffnen** - öffnet die eInvoice Sender Einrichtung, zum Beispiel um die Regelkonfiguration anzupassen.Bei aktivierter Option Buchungssperre bei Validierungsfehler kann ein Beleg mit einer Feststellung des Schweregrads Fehler erst gebucht werden, wenn die Feststellungen behoben sind. Feststellungen der Schweregrade Warnung und Information werden angezeigt, blockieren die Buchung jedoch nicht.
### Prüfung des gebuchten Belegs Die Prüfung oben beurteilt den noch nicht gebuchten Beleg, die E-Rechnung entsteht aber aus dem gebuchten. Ist **Buchungssperre bei Validierungsfehler** aktiviert, prüft die App deshalb zusätzlich die E-Rechnung, die die Buchung tatsächlich ergibt: Sobald der gebuchte Beleg existiert, die Buchung aber noch nicht festgeschrieben ist, baut sie die E-Rechnungsdaten genau wie die Versand-Pipeline aus dem gebuchten Beleg auf und führt die Rechnungsmodell-Regeln aus - zum Beispiel die BR-CO-Summenregeln und die Regeln der MwSt.-Kategorien. Bleibt eine Feststellung mit Schweregrad Fehler übrig, wird die gesamte Buchung zurückgenommen und nichts gebucht. Der Benutzer sieht **Buchung gestoppt: Die E-Rechnung würde abgelehnt** mit Regel-ID und Text jeder Feststellung sowie der Aktion **eInvoice-Einrichtung öffnen**. Lassen sich die E-Rechnungsdaten aus dem gebuchten Beleg gar nicht aufbauen, wird die Buchung ebenfalls zurückgenommen, und die Meldung nennt den Grund. - Die Prüfung verwendet dieselben Schalter wie die Prüfung oben (**Feldvalidierung aktivieren** und den Umschalter des Belegbereichs) und erfasst nur Belege, die eine E-Rechnung ergeben. Aufträge und Reklamationen werden nur geprüft, wenn sie fakturiert werden. - Eine Buchungsvorschau wird nie geprüft oder gestoppt. - Während der Buchung wird der Digivoice-Dienst nicht aufgerufen; die KoSIT-Prüfung selbst läuft weiterhin später in der Versand-Pipeline. - Muss ein Beleg trotzdem gebucht werden, etwa um eine Rechnung zu stornieren, die vor Einführung dieser Prüfung gebucht wurde, schalten Sie **Buchungssperre bei Validierungsfehler** für diese Buchung aus.**Buchungssperre bei Validierungsfehler** ist standardmäßig ausgeschaltet. Mit den Standardeinstellungen ergibt jede gebuchte Rechnung und Gutschrift eine E-Rechnung, auch an Endverbraucher. Bevor Sie die Option einschalten, stellen Sie sicher, dass nur Belege für tatsächliche E-Rechnungsempfänger eine E-Rechnung ergeben - das steuern **Belege automatisch versenden** (eInvoice-Einrichtung sowie Debitoren- und Kreditoreneinrichtung) und **eInvoice zu Beleganhängen hinzufügen**.
# Dokumenten Verwaltung ### Belegwarteschlange Zugang über **DEXPRO eInvoice Einrichtung** → **Belegwarteschlange** [](https://docs.squeeze.one/uploads/images/gallery/2025-06/image-1749194373943.png) **Angezeigte Spalten:** - **Lfd.Nr.**: Eindeutiger Bezeichner - **XRechnung Belegart**: XRechnung-Code für den Rechnungstyp (zum Beispiel 380 Rechnung, 381 Gutschrift) - **Quelle Tabellen Nr.**: Nummer der Tabelle, die den gebuchten Quellbeleg enthält - **Belegnr.**: Business Central Belegnummer - **Debitor/Kreditor Nr.**: Handelspartner - **Status**: Aktueller Bearbeitungsstand - **Erstellungszeitstempel**: Eintragungszeit in der Warteschlange - **Sendeprofil**: Zu erzeugendes Format - **Versuche**: Wie oft die Verarbeitung mit einem wiederholbaren Fehler fehlgeschlagen ist - **Nächster Versuch am**: Wann die nächste Wiederholung fällig ist - **Letzte Fehlerklasse**: Klasse des letzten Fehlers (Wiederholbar, Dauerhaft oder Authentifizierungsfehler) **Verfügbare Aktionen:** - **Ausgewählte verarbeiten**: Manuelles Auslösen der Verarbeitung für die markierten Einträge. Jeder Eintrag wird für sich verarbeitet, sodass ein Fehler in einem Eintrag die anderen nicht zurücknimmt. Am Ende zeigt eine Meldung, wie viele Einträge verarbeitet wurden und wie viele davon ohne Erfolg; der Status eines Eintrags zeigt, was schiefgegangen ist. - **Erneut einreihen**: Stellt die markierten Einträge im Status Fehler oder Fehlgeschlagen mit neuem Wiederholungszähler auf Ausstehend zurück, sodass der nächste Lauf der Aufgabenwarteschlange sie erneut verarbeitet - zum Beispiel nachdem Sie die Daten korrigiert haben, die eine KoSIT-Ablehnung bemängelt hat. Einträge in einem anderen Status werden übersprungen. - **Löschen**: Aus der Warteschlange entfernen ### Prozessprotokoll Überwachung aller Systemaktivitäten über **DEXPRO eInvoice Einrichtung** → **Prozessprotokoll** [](https://docs.squeeze.one/uploads/images/gallery/2025-06/image-1749194418493.png) **Aufgezeichnete Informationen:** - Zeitstempel der Verarbeitungen - Status Erfolg/Misserfolg - Fehlermeldungen - Belegdetails # Belegstatus Die Seite **Belegstatus** (DXP eInv Document Status) zeigt den aktuellen Verarbeitungsstatus jedes Belegs, der vom eInvoice Sender aufgegriffen wurde. Jede Zeile steht für einen Beleg in der Warteschlange und spiegelt wider, an welcher Stelle der Versand-Pipeline sich dieser Beleg gerade befindet, samt eventuell aufgetretenem Fehler und dem Ziel, an das die fertige E-Rechnung gesendet wurde. {Screenshot von Belegstatus hier einfügen} ## Informationen je Eintrag - **Status** - der aktuelle Verarbeitungsstatus des Eintrags (siehe Lebenszyklus weiter unten). - **Verarbeitungszeitpunkt** - wann der Eintrag zuletzt verarbeitet wurde. - **Gesendet an** - die Empfänger-E-Mail-Adresse, an die die freigegebene E-Rechnung nach abgeschlossener Übertragung gesendet wurde (ermittelt aus der übersteuernden E-Mail, der Beleg-E-Mail oder der Debitoren-/Kreditorenkarte). - **Fehlermeldung** - der letzte für den Eintrag gemeldete Fehler. Wird ausgefüllt, wenn der Status Fehler oder Fehlgeschlagen lautet; andernfalls leer. ## Status-Lebenszyklus Ein Eintrag durchläuft die folgenden Zustände, während ihn die Pipeline verarbeitet: - **Ausstehend (Pending)** - in der Warteschlange und wartet darauf, von der Aufgabenwarteschlange aufgegriffen zu werden. - **In Verarbeitung (Processing)** - wird gerade von der Pipeline bearbeitet. - **Validiert (Validated)** - die Prüfungen der Quelldaten sowie die Geschäfts- und Rechnungsmodell-Validierungen wurden bestanden. - **Generiert (Generated)** - das E-Rechnungsartefakt (XML/PDF) wurde erzeugt. - **Gesendet (Sent)** - die E-Rechnung wurde freigegeben und an den Empfänger übertragen. Ein Eintrag im Status Ausstehend, Fehler oder Fehlgeschlagen wird außerdem auf Gesendet gesetzt, wenn der Beleg außerhalb der Warteschlange über die Standardaktion **E-Mail** versendet wird; die Aufgabenwarteschlange versendet den Beleg dann kein zweites Mal. - **Fehler (Error)** - die Verarbeitung wurde durch einen behebbaren Fehler gestoppt; der Eintrag wird gemäß dem Backoff-Zeitplan wiederholt. - **Fehlgeschlagen (Failed)** - der Eintrag hat seine Wiederholungen aufgebraucht (oder ist auf einen dauerhaften Fehler bzw. Authentifizierungsfehler gestoßen) und wurde in den **Dead-Letter**-Zustand verschoben. Er wird nicht mehr nach dem Backoff-Zeitplan wiederholt. Ein Eintrag, der in den letzten 30 Tagen wegen seines Inhalts abgelehnt wurde (durch die Prüfungen vor der Generierung oder durch KoSIT), wird automatisch erneut eingereiht, sobald der korrigierte Beleg eine andere E-Rechnung ergibt; jeder andere fehlgeschlagene Eintrag muss manuell über **Erneut einreihen** zurückgestellt werden.Validiert und Generiert sind Zwischenstationen innerhalb eines einzelnen Durchlaufs. Ein fehlerfreier Beleg durchläuft typischerweise Ausstehend → In Verarbeitung → Validiert → Generiert → Gesendet.
## Aktionen - **Status zurücksetzen** - setzt einen Eintrag, der in **In Verarbeitung** hängengeblieben ist, auf **Ausstehend** zurück (nur aus dem Status In Verarbeitung nutzbar). Der Wiederholungszähler wird dabei nicht zurückgesetzt - verwenden Sie dafür Erneut einreihen. - **Erneut einreihen** - verschiebt einen Eintrag im Status **Fehler** oder **Fehlgeschlagen** zurück auf **Ausstehend**, setzt den Wiederholungszähler zurück, löscht den Fehler und zeigt eine Bestätigungsmeldung an, sodass der Eintrag beim nächsten Lauf der Aufgabenwarteschlange erneut verarbeitet wird. Verwenden Sie dies, nachdem Sie das zugrunde liegende Datenproblem behoben haben. Auf der Seite der Belegwarteschlange steht dieselbe Aktion für mehrere markierte Einträge gleichzeitig zur Verfügung. - **Diagnosepaket herunterladen** - fasst den Status, den Wiederholungsstatus, die Artefakt-Metadaten (Hashwerte, nicht den Inhalt) und die letzten Zeilen des Prozessprotokolls zur Fehlerbehebung in einer Textdatei zusammen. - **Prozessprotokoll anzeigen** - öffnet das Prozessprotokoll des Eintrags und zeigt die schrittweise Nachverfolgung des Austauschs mit dem Digivoice-System. - **Validierungsergebnisse anzeigen** - öffnet die gespeicherten [Validierungsergebnisse](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/validierungsergebnisse) aus dem letzten Validierungslauf. - **KoSIT-Bericht anzeigen** / **KoSIT-Bericht herunterladen** - öffnet den offiziellen [KoSIT-Bericht](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/kosit-bericht) im Viewer oder lädt ihn als Datei herunter.Ein Eintrag im Status **Fehlgeschlagen** ist ein Dead-Letter. Von selbst werden nur inhaltliche Ablehnungen der letzten 30 Tage erneut aufgegriffen, und zwar erst, wenn der Beleg eine andere E-Rechnung ergibt; ist der automatische Versand aktiviert, wird ein solcher Eintrag noch im selben Lauf der Aufgabenwarteschlange an den Empfänger gesendet. Jeder andere fehlgeschlagene Eintrag bleibt unverändert liegen, bis jemand die Ursache behebt und **Erneut einreihen** verwendet.
# KoSIT-Bericht Der **KoSIT-Bericht**-Viewer (DXP eInv KoSIT Report Viewer) zeigt den offiziellen KoSIT-*Prüfbericht* (Validierungsbericht) für eine generierte E-Rechnung direkt in Business Central an. ## Was ist KoSIT? KoSIT (Koordinierungsstelle für IT-Standards) ist die für den XRechnung-Standard zuständige Stelle der öffentlichen Verwaltung in Deutschland. Sie veröffentlicht den offiziellen Validator, der prüft, ob eine E-Rechnung XRechnung-konform ist. Wenn die App einen Beleg vorab validiert, prüft sie ihn gegen diesen offiziellen Validator; der Validator liefert einen *Prüfbericht* zurück - den maßgeblichen Validierungsbericht, der genau beschreibt, welche Regeln bestanden und welche nicht bestanden wurden. ## Der Viewer Der KoSIT-Bericht wird als HTML-Dokument erzeugt. Der Viewer stellt dieses HTML in einem **WebPageViewer**-Steuerelement dar, sodass Sie den offiziellen Bericht - mit seiner gesamten Formatierung, den Regelverweisen und den Bestanden/Nicht-bestanden-Details - lesen können, ohne Business Central zu verlassen. {Screenshot von KoSIT-Bericht hier einfügen} ## Aktion - **Bericht herunterladen** - speichert den KoSIT-Bericht in einer Datei, sodass er archiviert oder weitergeleitet werden kann (zum Beispiel als Validierungsnachweis).Sie können den KoSIT-Bericht für einen Eintrag über die Seite [Belegstatus](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/belegstatus) oder über die Seite [Artefakte](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/artefakte-gobd-revisionshistorie) per **KoSIT-Bericht anzeigen** öffnen.
# Validierungsergebnisse Die Seite **Validierungsergebnisse** (DXP eInv Validation Result) zeigt die schreibgeschützten, gespeicherten Feststellungen des letzten Validierungslaufs für einen Beleg. Immer wenn die Pipeline (oder die Live-Konformitätsprüfung) einen Beleg validiert, wird hier jede Regel gespeichert, die etwas gemeldet hat, sodass sie im Nachhinein überprüft werden kann - Sie sehen das aufgezeichnete Ergebnis und führen die Validierung nicht erneut aus. {Screenshot von Validierungsergebnisse hier einfügen} ## Felder - **Regel-ID** - die Kennung der Regel, die die Feststellung erzeugt hat (zum Beispiel eine offizielle BR-CO-/BR-DE-Regel oder eine app-spezifische VAL-\*-Regel). - **Schweregrad** - **Fehler**, **Warnung** oder **Information**. Fehler blockieren Generierung und Übertragung; Warnungen und Informationen tun dies nicht. - **Feldbezeichnung** - die Bezeichnung des Feldes, auf das sich die Feststellung bezieht, damit Sie genau wissen, worauf zu achten ist. - **Behebung** - ein kurzer, umsetzbarer Hinweis, der das Problem beschreibt und erläutert, wie es in Business Central zu lösen ist.Die Stufe, in der eine Regel ausgeführt wird (Quelldaten, Geschäftsvalidierung oder Rechnungsmodell), wird auf der Seite [Regel-Einrichtung](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/regel-einrichtung) konfiguriert und nicht hier als Spalte angezeigt.
## Drilldown Zu jeder Feststellung kann per Drilldown der zugehörige Datensatz geöffnet werden - der Quellbeleg oder der konkrete Datensatz, der den beanstandeten Wert trägt -, sodass Sie die Daten direkt aus der Feststellung heraus korrigieren können.Diese Feststellungen werden aus dem letzten Lauf gespeichert. Nachdem Sie die Daten korrigiert haben, führen Sie die Validierung erneut aus (oder reihen den Beleg über die Seite [Belegstatus](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/belegstatus) erneut ein), um sie zu aktualisieren.
# Erweiterbarkeit (für Entwickler) Der eInvoice Sender ist um eine kleine Menge von AL-Schnittstellen herum aufgebaut, sodass Partner und Kunden ihn erweitern können - Unterstützung für neue Belegarten hinzufügen, einen anderen Reader einbinden oder eigene Validierungsregeln ergänzen -, ohne die Basis-App zu verändern. Diese Seite richtet sich an **Entwickler**. ## Schnittstelle 1 - DXP eInv Doc Exporter Implementieren Sie **DXP eInv Doc Exporter**, um die Export-Payload für eine bestimmte Belegart zu erstellen. Sie besitzt eine einzige Methode, `CreateDocument(DocHeader: Variant): JsonObject` - sie wandelt eine Art von Business-Central-Beleg in die JSON-Payload um, die die Pipeline serialisiert und an die Generierung sendet. Implementierungen werden über das erweiterbare Enum **Export Document** gebunden: Fügen Sie einen Wert für Ihre Belegart hinzu und verweisen Sie ihn auf Ihre implementierende Codeunit. Die Pipeline wählt den Exporter durch Auflösen dieses Enums aus, sodass das Registrieren eines neuen Exporters lediglich eine Erweiterung des Enums ist. ## Schnittstelle 2 - DXP eInv Doc Reader V2 Implementieren Sie **DXP eInv Doc Reader V2**, um einen Reader über die CIM-Darstellung (Common Information Model) eines Belegs bereitzustellen - seine Methode `ReadDocument` füllt die CIM-Puffer (Beleg, Partei, Zeile, Zu-/Abschlag, Zahlung, Anhang), sodass Regeln und Generierung die Daten einheitlich verarbeiten können.Das Enum **Export Document** bindet *beide* Schnittstellen: jeder Enum-Wert verweist auf einen Exporter und einen Reader für diese Belegart. Wenn Sie eine neue Belegart hinzufügen, stellen Sie beide bereit.
## Schnittstelle 3 - DXP eInv IValidation Rule Implementieren Sie **DXP eInv IValidation Rule**, um Validierungsregeln hinzuzufügen. Sie besitzt zwei Methoden: `Evaluate` (führt die Prüfung aus und hängt Feststellungen an) und `GetMetadata` (liefert Kategorie, Standard-Schweregrad, Stufe, Beschreibung und Behebungshinweis der Regel zurück - was die Regel-Einrichtung befüllt). Eine einzige Codeunit kann anhand der Regel-ID verzweigen und viele Regeln bedienen, sodass das Budget für Objekt-IDs eingehalten wird. Regeln werden über das erweiterbare Enum **Validation Rule** gebunden, das einen dedizierten Erweiterungspunkt **CUSTOM** für kunden- und partnereigene Regeln bereitstellt. Fügen Sie einen an Ihre implementierende Codeunit gebundenen Enum-Wert hinzu, und die Regel nimmt wie jede eingebaute Regel an der Validierung teil - sie erscheint in der [Regel-Einrichtung](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de/page/regel-einrichtung), wo ihr Aktiviert-Kennzeichen, ihre Schweregrad-Übersteuerung und ihre Stufe konfiguriert werden können. ## Das Ereignis OnCollectValidationRules Die App veröffentlicht das Integrationsereignis **OnCollectValidationRules**. Abonnieren Sie es, um Ihre Regelimplementierungen zur Laufzeit bei der Validierungs-Engine zu registrieren. Dies ist der Einhängepunkt, über den eine erweiternde App Regeln zu der Sammlung beisteuert, die sowohl die Pipeline als auch die Live-Konformitätsprüfung verwenden.Zusammen decken diese drei Schnittstellen plus das Integrationsereignis die wichtigsten Erweiterungsszenarien ab: neue Belegart (Doc Exporter + Enum Export Document), benutzerdefiniertes Modell-Lesen (Doc Reader V2) und benutzerdefinierte Validierung (IValidation Rule + Enum Validation Rule, registriert über OnCollectValidationRules).
# FAQ Hier finden sie Fragen und Antworten zu verschiedenen Szenarien. # Troubleshooting ### Verbreitete Probleme #### Dokument wird nicht generiert **Prüfen Sie:** 1. Alle erforderlichen Felder sind ausgefüllt (verwenden Sie die Infobox DEXPRO eInvoice Konformitätsprüfung) 2. Der Debitor hat eine gültige E-Mail Adresse 3. MwSt. Einrichtung ist korrekt 4. Die Verbindung zum Web Service funktioniert #### Email wird nicht versandt **Prüfen Sie:** 1. Email Einrichtung in Business Central 2. Debitoren email Adresse ist gültig 3. SMTP Konfiguration 4. Prozessprotokoll für Fehlerdetails #### Validierungsfehler **Verbreitete Fälle:** - Fehlende Umsatzsteuer-Identifikationsnummer - Ungültige GLN codes - Unvollständige Adressdaten - Nicht unterstützte Zahlungsarten ### Fehlerbehebung #### Prozessprotokoll-Analyse 1. Öffnen Sie das **Prozessprotokoll** aus der Einrichtung 2. Filter nach Datumsbereich oder Dokumentennummer 3. Fehlermeldungen überprüfen 4. Prüfen Sie das Feld „Kontext“ auf spezifische Probleme #### Belegwarteschlangen-Verwaltung 1. Öffnen Sie die **Belegwarteschlange** 2. Identifizieren Sie fehlgeschlagene Elemente (Statusindikatoren) 3. Nutzen Sie **Erneut einreihen**, um die Bearbeitung von Einträgen im Status Fehler oder Fehlgeschlagen zu wiederholen 4. Prüfen der Dokumentendaten vor der Weiterverarbeitung ### Hilfe bekommen #### Eingebauter Leitfaden - **Tool Tips**: Bewegen Sie den Mauszeiger über die Felder für Erklärungen - Infobox **DEXPRO eInvoice Konformitätsprüfung**: Zeigt Validierungsprobleme - **Prozessprotokoll**: Detaillierte Fehlerinformationen #### Hilfsmittel - Feldüberprüfungsmeldungen prüfen - Überprüfung der Prozessprotokolleinträge - Überprüfen der Setup-Konfiguration - Kontaktieren Sie DEXPRO Solutions GmbH für technische Unterstützung ### Bewährte Praktiken 1. **Erst die Einrichtung abschließen**: Führen Sie die geführte Einrichtung vollständig aus, bevor Sie Dokumente verarbeiten 2. **Test mit Beispieldaten**: Bearbeitung von Testdokumenten vor der Inbetriebnahme 3. **Prozessprotokoll prüfen**: Regelmäßige Überprüfung auf Verarbeitungsprobleme 4. **Pflegen Sie Kundendaten**: E-Mail-Adressen und Mehrwertsteuernummern auf dem neuesten Stand halten 5. **Belegwarteschlange prüfen**: Status der automatischen Verarbeitung überwachen