Konfiguration & Administration
- Berechtigungssätze
- DEXPRO Core
- eInvoice Sender Einrichtung
- Debitoren und Kreditoren Einrichtung
- OAuth 2.0 Einrichtung
- Artefakte (GoBD-Revisionshistorie)
- Regel-Einrichtung
- Zahlungsart- und Maßeinheiten-Zuordnung
- Die Versand-Pipeline und Aufgabenwarteschlange
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)
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.
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
- 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.
Export-Einstellungen
Hier werden die Standards für den Export hinterlegt.
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.
eInvoice Konformitätsprüfung
Hier finden Sie die Einstellungen zu der Konformitätsprüfung.
Belegwarteschlange
Hier wird festgelegt, wie lange die Einträge aufbewahrt werden sollen.
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.
Debitoren und Kreditoren Einrichtung
Debitorenspezifische Einrichtungen
Zugang über DEXPRO eInvoice Einrichtung → Debitoreneinrichtung
Konfigurationsoptionen:
- E-Mail überschreiben: Andere E-Mail als Standard verwenden
- Automatische Verarbeitung: Automatisches Senden von Dokumenten aktivieren/deaktivieren
- 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.
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.
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 Sendeprofil, für das das Artefakt generiert wurde (XRechnung, ZUGFeRD, ...).
- 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 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.
- 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 BR-CO und BR-DE aus der Spezifikation EN 16931 / XRechnung.
- 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 - 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.
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}
- Zahlungsart - der Zahlungsart-Code aus Business Central (das Feld eInvoice-Zahlungstyp wird direkt zur Standardliste der Zahlungsarten hinzugefügt).
- eInvoice-Zahlungstyp - der standardisierte Zahlungsmittel-Code, dem die Zahlungsart zugeordnet wird. Die verfügbaren Werte sind Keine, Barzahlung, Scheckzahlung, Kartenzahlung, Lastschrift und Banküberweisung (abgestimmt auf die Zahlungsmittel-Codes nach UNTDID 4461).
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.
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 gespeichert.
- Stufe 5 - XML/PDF generieren: das E-Rechnungs-XML (und PDF) wird über die Digivoice-API generiert.
- Stufe 6 - KoSIT-Vorabvalidierung: wenn XML-Validierung aktivieren in der Einrichtung eingeschaltet ist, wird der generierte Beleg gegen den offiziellen KoSIT-Validator 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 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 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:
- 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. Versuche: 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 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.