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:

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.

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:

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.

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.

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.

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