globe with meridians Sprache: Deutsch · English

open book Version 1 - Elektronische Rechnungen - XRechnung und ZUGFeRD

Version 1 - Elektronische Rechnungen - XRechnung und ZUGFeRD – Referenz zum Nuclet.

REFERENZ INTEGRATOREN STAND: JUL 2026 GILT FUER NUCLOS 4.2026.X

Auf dieser Seite

Releases

VersionDatumHinweiseKompatibilität
1.0.011.03.2021Erste veröffentlichte Fassungab Nuclos 4.44.1
1.1.02.09.2023Aktualisierung auf XRechnung 2.3.1ab Nuclos 4.46.9

Überblick

Das Nuclet ermöglicht die Erzeugung elektronischer Rechnungen im xml-Format, deren offizielle Validierung und deren Darstellung in einer html-Datei.

Unterstützt wir das Format XRechnung in der Version 2.3.1, das den xml-Anteil der Spezifikation ZUGFeRD mindestens in der Version 2.0 abdeckt.
Hinweis: Eine zusätzliche Integration in eine pdf-Datei wäre durch Erweiterung des Nuclets grundsätzlich möglich, allerdings nicht Format PDF/A-3 (notwendig für ZUGFeRD-Rechnungen).

Die Erzeugung erfolgt über einen in einem geeigneten Layout eingebundenen Knopf (Button) und erstellt folgende Dateien in einem geeigneten Unterformular:

⦁ xml-Datei gemäß Standard XRechnung
⦁ html-Datei als Vorschau auf die erzeugten Daten
⦁ html-Datei mit Ergebnissen der Validierung
⦁ log-Datei mit Ergebnissen der Rechnungserzeugung

Optional ist außerdem eine Validierung der Leitweg-ID im Nuclet enthalten.

Ein Beispiel ist im angehängten  Beispiel-Nuclet verfügbar.

Hinweise zu Version 1.1.0

Neuer Parameter Ablagepfad

  • Pfad für die temporäre Ablage der Dateien zur Rechnungserzeugung.
  • Bei Angabe von "." wird automatisch ein temporäres Verzeichnis ermittelt.
  • Bei Angabe eines relativen Verzeichnisses wird ein Unterverzeichnis im Nuclos-Ausführungspfad (../bin) erstellt.

Integration

Die Integration nach erfolgtem Nucletimport (siehe Nuclet Import) ist wie folgt vorzunehmen.

SchrittBeschreibungScreenshot
1

Nach Import muss die Serverinstanz neu gestartet werden, da das Nuclet eigene Extensions enthält.

2

Es werden drei Businessobjekte benötigt, die unter Konfiguration Integrationspunkt eingebunden werden müssen

  • Rechnung
  • Rechnungsdokument
  • Rechnungsempfänger (Kunde) [optional]

3

Außerdem muss es noch ein Businessobjekt für die Rechnungspositionen geben, dieses wird aber nicht für die Integrationspunkte benötigt.

4

Das Nuclet enthält außerdem drei Datenquellen (Konfiguation → Datenquellen → Report & Formular), die noch an die jeweiligen Gegebenheiten angepasst werden müssen.

  • Ausgangsrechnung XRechnung
  • Ausgangsrechnung XRechnung Positionen
  • Ausgangsrechnung XRechnung Kommentare

Diese liefern die eigentlichen Daten zur Erzeugung der elektronischen Rechnung. Ein Beispiel ist im angehängten Beispiel-Nuclet verfügbar. Die Zuordnung der Datenfelder zu den Inhalten der elektronischen Rechnung erfolgt gemäß Standard XRechnung, es wird jedoch nur ein Teil der verfügbaren Felder unterstützt (siehe Datenquellen bzw. Testfallgruppe_01.xlsx).

5

Danach kann die Regel ErzeugeXRechnung mit dem entsprechenden Businessobjekt verknüpft (Konfiguration → Server Regelmanager) und über einen Knopf (Button) im Layout (Konfiguration → Layout) eingebunden werden.

Die Regeln zur Validierung der Leitweg-ID werden automatisch mit dem Businessojekt Rechnungsempfänger verknüpft.

6Im Falle valider Daten werden über den Knopf die oben beschriebenen vier Dateien erzeugt und das Ergebnis in einer Meldung präsentiert.

Verwandte Seiten

open book Schnittstellen


Kategorie

Öffnen →

open book Nuclet Wiki


Alle Kategorien

Öffnen →

  • Keine Stichwörter