eInvoice Sender for Microsoft Dynamics 365 BC - de-DE

Diese Dokumentation behandelt die wesentlichen Funktionen für den täglichen Gebrauch von DEXPRO eInvoice Sender. Für eine erweiterte Konfiguration und technische Details lesen Sie bitte die Einrichtungsoptionen für Experten und kontaktieren Sie bei Bedarf den Support.

Systemvoraussetzungen

Systemvoraussetzungen zur Nutzung vom eInvoice Sender for Dynamics 365 BC

Systemvoraussetzungen

Unterstützte Microsoft Dynamics 365 Business Central Versionen

Die Microsoft Dynamics 365 Business Central Integration ist auf Grund von technischen Mindestvoraussetzungen ab folgender Version möglich:

Unterstützte Microsoft Dynamics 365 Business Central Versionen

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.

 

Systemvoraussetzungen

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

Installation

Lizenzen

Microsoft

Informationen zu den Microsoft Business Central Lizenzen.

Digivoice

Das DEXPRO Digivoice System welches an Business Central angeschlossen werden soll benötigt eine gültige Kunden-Lizenz.

Installation

Bezug der DEXPRO Module

Detailliertere Informationen finden Sie hier.

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. Hier werden die benötigten DEXPRO Apps heruntergeladen.

Squeeze_icon_appsource.png

Installation

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

Schritt 2: Grundlegende Informationen zur Einrichtung

Konfigurieren Sie die grundlegenden Einstellungen für die elektronische Rechnungsstellung:

Schritt 3: Zahlungsinformationen (wenn der Expertenmodus aktiviert ist)

Schritt 4: Validierungseinrichtung (wenn der Expertenmodus aktiviert ist))

Schritt 5: Abschließende Überprüfung

Optionen für die manuelle Einrichtung

Zugriff auf zusätzliche Einstellungen über die DEXPRO eInvoice Einrichtungsseite:

Verfügbare Aktionen:

Mappings Section:

 

Konfiguration & Administration

Konfiguration & Administration

Berechtigungssätze

Um die Module nutzen zu können, muss den jeweiligen Anwendern der passende Berechtigungssatz zugewiesen werden.

Folgende werden mit ausgeliefert:

Konfiguration & Administration

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.

Konfiguration & Administration

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.

Kreditoreneinrichtung

Über diesen Menüpunkt erreichen Sie die kreditorenspezifische Einrichtung.

OAuth 2.0 Einrichtung

Über diesen Menüpunkt erreichen Sie die OAuth 2.0 Einrichtung zur Authentifizierung am Digivoice System.

Zuordnungen

Allgemein

In diesem FastTab kann man die Nutzung dieser App aktivieren/deaktivieren und die Verbindung zum Digivoice System einrichten.

image-1749192640622.png

Export-Einstellungen

Hier werden die Standards für den Export hinterlegt.

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:

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.

eInvoice Konformitätsprüfung

Hier finden Sie die Einstellungen zu der Konformitätsprüfung.

image-1749192817111.png

Belegwarteschlange

Hier wird festgelegt, wie lange die Einträge aufbewahrt werden sollen.

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:

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.

Konfiguration & Administration

Debitoren und Kreditoren Einrichtung

Debitorenspezifische Einrichtungen

Zugang über DEXPRO eInvoice Einrichtung → Debitoreneinrichtung

image-1749193551004.png

Konfigurationsoptionen:

Kreditorenspezifische Einrichtungen

Eine ähnliche Konfiguration ist für Lieferanten für Einkaufsgutschriften verfügbar.

image-1749193595601.png

Email Vorlagen

Das System verwendet Word-basierte E-Mail-Vorlagen:

Verfügbare Templates:

Funktionen der Vorlagen:

Konfiguration & Administration

OAuth 2.0 Einrichtung

Hier werden die OAuth 2.0 / Open Id User und deren Access Token verwaltet.

image-1677251925318.png

Anwendung / Nutzung

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:

image-1749194066171.png

image-1749194124342.png

Häufig fehlende Felder:

Gebuchte Verkaufsrechnungen

Sie finden in der gebuchten Verkaufsrechnungen Übersicht:

Neue Felder:

Neue Aktionen:

image-1749194267398.png

Gebuchte Verkaufsgutschriften

Ähnliche Funktionalität verfügbar in den gebuchten Verkaufsgutschriften:

Service Rechnungen

Die elektronische Rechnungsstellung ist mit den gleichen Funktionalitäten ebenfalls auch für Service Rechnungen möglich.

Dokumenttypen und -formate

Beim Herunterladen oder Versenden von Dokumenten per E-Mail können Sie wählen zwischen:

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 Email DEXPRO eInvoice
  3. Wählen Sie das gewünschte Format
  4. Das System tut folgendes automatisch:
    • Erzeugt das elektronische Dokument
    • Erstellt eine E-Mail mit der entsprechenden Vorlage
    • Sendet an die E-Mail Adresse des Kunden

Automatisches Verarbeiten

Das System kann Dokumente automatisch über die Dokumenten Warteschlange verarbeiten:

Anwendung / Nutzung

Dokumenten Verwaltung

Dokumentenwarteschlange

Zugang über DEXPRO eInvoice Einrichtung → Dokumentenwarteschlange

image-1749194373943.png

Angezeigte Spalten:

Verfügbare Aktionen:

Prozess Log

Überwachung aller Systemaktivitäten über DEXPRO eInvoice Einrichtung → Prozess Log

image-1749194418493.png

Aufgezeichnete Informationen:

FAQ

Hier finden sie Fragen und Antworten zu verschiedenen Szenarien.

FAQ

Troubleshooting

Verbreitete Probleme

Dokument wird nicht generiert

Prüfen Sie:

  1. Alle erforderlichen Felder sind ausgefüllt (verwenden Sie die Factbox für fehlende Felder)
  2. Der Debitor hat eine gültige E-Mail Adresse
  3. MwSt. Einrichtung ist korrekt
  4. Die Verbindung zum Web Service funktioiert

Email wird nicht versandt

Prüfen Sie:

  1. Email Einrichtung in Business Central
  2. Debitoren email Adresse ist gültig
  3. SMTP Konfiguration
  4. Prozess Log für Fehlerdetails

Validierungsfehler

Verbreitete Fälle:

Fehlerbehebung

Prozess Log Analyse

  1. Öffnen Sie das Prozess Log aus der Einrichtung
  2. Filter nach Datumsbereich oder Dokumentennummer
  3. Fehlermeldungen überprüfen
  4. Prüfen Sie das Feld „Kontext“ auf spezifische Probleme

Dokumentenwarteschlangen Verwaltung

  1. Öffnen Sie die Dokumentenwarteschlange
  2. Identifizieren Sie fehlgeschlagene Elemente (Statusindikatoren)
  3. Nutzen Sie Status zurücksetzen um die Bearbeitung zu wiederholen
  4. Prüfen der Dokumentendaten vor der Weiterverarbeitung

Hilfe bekommen

Eingebauter Leitfaden

Hilfsmittel

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. Prozess Log prüfen: Regelmäßige Überprüfung auf Verarbeitungsprobleme
  4. Pflegen Sie Kundendaten: E-Mail-Adressen und Mehrwertsteuernummern auf dem neuesten Stand halten
  5. Dokumentenwarteschlange prüfen: Status der automatischen Verarbeitung überwachen

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-Lebenszyklus

Ein Eintrag durchläuft die folgenden Zustände, während ihn die Pipeline verarbeitet:

Validiert und Generiert sind Zwischenstationen innerhalb eines einzelnen Durchlaufs. Ein fehlerfreier Beleg durchläuft typischerweise Ausstehend → In Verarbeitung → Validiert → Generiert → Gesendet.

Aktionen

Ein Eintrag im Status Fehlgeschlagen ist ein Dead-Letter - er bleibt unverändert liegen, bis jemand die Ursache behebt und Erneut einreihen verwendet. Fehlgeschlagene Einträge werden niemals von selbst erneut aufgegriffen.

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

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

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

Die Stufe, in der eine Regel ausgeführt wird (Quelldaten, Geschäftsvalidierung oder Rechnungsmodell), wird auf der Seite 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 erneut ein), um sie zu aktualisieren.

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

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:

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 - insbesondere die arithmetischen Identitäten BR-CO, die sicherstellen, dass die Rechnungssummen korrekt aufgehen. Diese Regeln können nicht einfach abgeschaltet werden.

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 arithmetischen BR-CO-Identitätsregel 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.

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

Sie können den KoSIT-Bericht für einen Eintrag über die Seite Belegstatus oder über die Seite Artefakte per KoSIT-Bericht anzeigen öffnen.

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

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 und korrigieren Sie die Daten.

Wann werden Belege eingereiht?

Ein Beleg wird zum Buchungszeitpunkt für die folgenden Belegarten automatisch eingereiht:

Die wiederkehrende Aufgabenwarteschlange

Die Verarbeitung wird durch einen wiederkehrenden Eintrag der Aufgabenwarteschlange gesteuert:

Bei jedem Lauf greift die Aufgabenwarteschlange alle Ausstehend-Einträge auf und bewegt sie durch die Pipeline.

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:

Dauerhafte Fehler und Authentifizierungsfehler warten nicht auf Wiederholungen - sie landen sofort im Dead-Letter. Ein Dead-Letter-Eintrag (Fehlgeschlagen) wird niemals automatisch erneut aufgegriffen; beheben Sie die Ursache und verwenden Sie Erneut einreihen auf der Seite Belegstatus, um den Versuchszähler zurückzusetzen und den Eintrag auf Ausstehend zurückzustellen.

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

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:

Deaktivieren Sie einen Umschalter, wenn die Infobox Belege in diesem Bereich nicht auswerten soll.

Buchung bei Fehler blockieren

Wenn Buchung bei Fehler blockieren 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:

Bei aktivierter Option Buchung bei Fehler blockieren 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.

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 Zahlungsarten

Jede Zahlungsart 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 Zahlungsart des Belegs nach und schreibt den zugeordneten Zahlungstyp in die E-Rechnung.

{Screenshot von Zahlungsart- und Maßeinheiten-Zuordnung hier einfügen}

Die zugehörige Zuordnungsliste Schlüsselwörter für Zahlungsbedingungen verfügt über die Aktion Zahlungsmethoden importieren, die die Liste aus den vorhandenen Business-Central-Zahlungsarten vorbefüllt, sodass Sie jeder Zeile nur noch den Zahlungstyp zuweisen müssen, statt sie von Hand einzugeben. Die Liste zeigt außerdem, welche Zeilen noch nicht zugeordnet sind.

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.

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, 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).