Skip to main content
Skip table of contents

Wichtige Hinweise zu geänderten Abläufen ( ab i-effect 3.1.13 )

Es ergeben sich bei Einsatz unter i-effect (ab Version 3.1.14) einige Änderungen im Ablauf.

Neue Steuerfelder in der Kopfdatei

Die im folgenden beschriebenen Felder der Kopfdatei ZF23INVHT wurde angepasst und/oder hinzugefügt. Beim Auslesen oder Beschreiben dieser Felder sind die folgenden Hinweise zu beachten.

Feld

Beispielinhalt

Erläuterung

HTNAPPREF

ZUGFERD
XRECHNUNG
PEPPOL

Es handelt sich um Schnittstellendaten aus oder für das ZUGFeRD Format.
Es handelt sich um Schnittstellendaten aus oder für das XRECHNUNG Format.
Es handelt sich um Schnittstellendaten aus oder für das PEPPOL BIS Billing Format.

HTNAPPVER

2.3.2
2.3.3
2.1.1
3.0.2
3.0.1
2.3.1
2.2.0
2.1.1
3.0

ZUGFeRD Version 2.3.2
ZUGFeRD Version 2.3.3
ZUGFeRD Version 2.1.1
XRECHNUNG Version 3.0.2
XRECHNUNG Version 3.0.1
XRECHNUNG Version 2.3.1
XRECHNUNG Version 2.2.0
XRECHNUNG Version 2.1.1
PEPPOL Version 3.0

HTNAPPFMT

UBL
CII
COMFORT
EXTENDED
XRECHNUNG

Daten stammen oder sind bestimmt für die Darstellung einer XRECHNUNG oder PEPPOL BIS-Billing Rechnung im Universal Business Language (UBL) Format.
Daten stammen oder sind bestimmt für die Darstellung einer XRECHNUNG Rechnung im CII (Cross Industry Invoice) Format
Daten stammen oder sind bestimmt für die Darstellung einer ZUGFeRD Rechnung im COMFORT Profil
Daten stammen oder sind bestimmt für die Darstellung einer ZUGFeRD Rechnung im EXTENDED Profil
Daten stammen oder sind bestimmt für die Darstellung einer ZUGFeRD Rechnung im XRECHNUNG Profil

HTNPROCESS

Identifiziert den Geschäftsprozesskontext, in dem die Transaktion auftritt, damit der Käufer die Rechnung in geeigneter Weise bearbeiten kann.

Identifikation

Typ

urn:cen.eu:en16931:2017#conformant#urn:factur-x.eu:1p0:extended

ZUGFERD 2.3.3

urn:cen.eu:en16931:2017

ZUGFERD 2.3.3

urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0

XRECHNUNG CII / UBL 3.0.2

urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0#conformant#urn:xeinkauf.de:kosit:extension:xrechnung_3.0

XRECHNUNG CII / UBL 3.0.2

urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_2.3

XRECHNUNG CII / UBL 2.3.1

urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_2.3#conformant#urn:xoev-de:kosit:extension:xrechnung_2.3

XRECHNUNG CII / UBL 2.3.1

urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_2.2

XRECHNUNG CII / UBL 2.2.0

urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_2.2#conformant#urn:xoev-de:kosit:extension:xrechnung_2.2

XRECHNUNG CII / UBL 2.2.0

urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_2.1

XRECHNUNG CII / UB L2.1.1

urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_2.1#conformant#urn:xoev-de:kosit:extension:xrechnung_2.1

XRECHNUNG CII / UBL 2.1.1

urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0

PEPPOL UBL INVOICE 3.0
PEPPOL UBL CREDITNOTE 3.0

urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_2.0

XRECHNUNG CII / UBL 2.0.0

MANDANT

01

Das Feld kann zur Selektion oder Kennzeichnung von Datensätzen für verschiedene Organisationen verwendet werden.
Bei der Verarbeitung von Eingangsdateien kann über den PARMS( (MANDANT ‘01’)) Parameter der zu schreibende Inhalt für das Feld vorgegeben werden.
Bei der Verarbeitung von Ausgangsdaten wird nur Datensätze selektiert, die dem vorgegebenen Wert in der übergebenen Variable MANDANT entsprechen. Wird der Parameter weggelassen, werden alle Datensätze selektiert.

CUSTOM1

DE

Ein Feld, welches beim Nachrichteneingang durch Angabe von PARMS( (CUSTOM1 ‘DE’)) mit einem eigenen Wert belegt werden kann.

CUSTOM2

01735

Ein Feld, welches beim Nachrichteneingang durch Angabe von PARMS( (CUSTOM2 ‘01735’)) mit einem eigenen Wert belegt werden kann.

CUSTOM3

A

Ein Feld, welches beim Nachrichteneingang durch Angabe von PARMS( (CUSTOM3 ‘A’)) mit einem eigenen Wert belegt werden kann.

HTDIRECT

*OUT
*IN

Daten zur Erzeugung von Dateien
Eingelesene Daten

HTSTATE

leer = soll verarbeitet werden (HTDIRECT='*OUT') oder wurde eingelesen und noch nicht verarbeitet (HTDIRECT='*IN')
1 = erfolgreich verarbeitet
2 = fehlerhafte Verarbeitung

EXTERNAL_ORIGINATOR

Name einer abweichenden Absenderidentifikation, die in den Stammdaten von i-effect definiert ist, und für den Versand dieser Daten verwendet werden soll. Siehe ZUGFeRD oder xRechnung versenden mit SNDFILE

EXTERNAL_RECIPIENT

Name einer abweichenden Empfängeridentifikation, die in den Stammdaten von i-effect definiert ist, und für den Versand dieser Daten verwendet werden soll. Siehe ZUGFeRD oder xRechnung versenden mit SNDFILE

PDF-Template und bereits vorhandene PDF-Dateien

Es besteht die Möglichkeit eine PDF, welche während des Mappings mit der erzeugten XML kombiniert wird, per Template zu erzeugen oder eine bereits vorhandene PDF-Datei für die ZUGFeRD-PDF zu nutzen. Welcher Weg gewählt wird, hängt vom Inhalt der Datenbankfelder HTTEMPLDIR und HTPDF ab:

Feld

Inhalt

Funktion

HTTEMPLDIR

extended
comfort

Der Ordnername des Templates, mit welchem eine PDF erzeugt werden soll. Der Ordner muss sich unter /home/ieffect/zugferd/templates befinden. Ist das Feld leer, so wird automatisch der zum Mapping passende Template-Ordner verwendet.

Dieser Parameter dient dazu eigene Templates in einem eigenen Ordner ansprechen zu können.

HTPDF

/home/ieffect/pdf/zugferd.pdf

zugferd.pdf

Der Pfad zu einer existierenden PDF-Datei oder der Name der zu erzeugenden PDF.

Wird ein vollständiger Pfad (mit führendem / ) angegeben, so wird keine PDF erzeugt, sondern versucht die angegebene PDF für das Kombinieren von XML und PDF zu verwenden.

Wird nur ein Dateiname (inklusive Dateiendung) angegeben, so wird die PDF per Template erzeugt und erhält den angegebenen Namen. Die Datei wird im Ausgabeverzeichnis erzeugt, welcher im RUNMAP-Befehl angegeben wurde.

ist das Feld leer, so wird automatisch ein Name nach diesem Muster erzeugt:
ZUGFeRD_<COMFORT|EXTENDED>_<BELEGNUMMER>_<UNIQUE>.pdf
Die Datei wird in diesem Fall in das im Parameter RUNMAP angegebene Verzeichnis erstellt.

Vereinheitlichte Aufrufparameter zur Erzeugung von E-Rechnungen

  • Der Sonderwert %FILENAME% wird nun sowohl für XRechnungen als auch für ZUGFeRD Belege im Aufruf verwendet um die automatische Generierung von eindeutigen Dateinamen zu veranlassen.

  • Die Namen der Mappings wurden vereinheitlicht und die Mappings an die neue Datenbankstruktur angepasst.

Mit Einsatz der Version 3.1.13 von i-effect müssen die dafür passenden Mappings angefordert und eingespielt werden. Sie befinden sich nicht im Lieferumfang von i-effect

Beispiel:

Zur Erstellung von Rechnungen im ZUGFeRD Format, Version 2.3.3, Profil EXTENDED, für alle Datensätze in der Schnittstelle, die im Feld Mandant eine ‘01’ haben:

CODE 
RUNMAP 
  MAPID('ZUGFERD_2.3.3_EXTENDED_OUT') 
  FS(*NONE)
  TOPATH('/home/ieffect/data/out/%FILENAME%') 
  ERRPATH('/home/ieffect/data/out/error') 
  ARCPATH('/home/ieffect/data/out/archive') 
  PARMS((MANDANT '01'))

Zur Erstellung von Rechnungen im ZUGFeRD Format, Version 2.3.2, Profil EXTENDED, für alle Datensätze in der Schnittstelle, die im Feld Mandant eine ‘01’ haben:

CODE 
RUNMAP 
  MAPID('ZUGFERD_2.3.2_EXTENDED_OUT') 
  FS(*NONE)
  TOPATH('/home/ieffect/data/out/%FILENAME%') 
  ERRPATH('/home/ieffect/data/out/error') 
  ARCPATH('/home/ieffect/data/out/archive') 
  PARMS((MANDANT '01'))

Zur Erstellung von Rechnungen im ZUGFeRD Format, Version 2.3.3, Profil COMFORT, für alle Datensätze in der Schnittstelle, die im Feld Mandant eine ‘01’ haben:

CODE 
RUNMAP 
  MAPID('ZUGFERD_2.3.3_COMFORT_OUT') 
  FS(*NONE)
  TOPATH('/home/ieffect/data/out/%FILENAME%') 
  ERRPATH('/home/ieffect/data/out/error') 
  ARCPATH('/home/ieffect/data/out/archive') 
  PARMS((MANDANT '01'))

Zur Erstellung von Rechnungen im XRECHNUNG Format, Version 3.0.2, Format CII, für alle Datensätze in der Schnittstelle, die im Feld Mandant eine ‘01’ haben:

CODE 
RUNMAP 
  MAPID('XRECHNUNG_CII_3.0.2_OUT') 
  FS(*NONE)
  TOPATH('/home/ieffect/data/out/%FILENAME%') 
  ERRPATH('/home/ieffect/data/out/error') 
  ARCPATH('/home/ieffect/data/out/archive') 
  PARMS((MANDANT '01'))

Zur Erstellung von Rechnungen im XRECHNUNG Format, Version 3.0.2, Format UBL, für alle Datensätze in der Schnittstelle, die im Feld Mandant eine ‘01’ haben:

CODE 
RUNMAP 
  MAPID('XRECHNUNG_UBL_3.0.2_OUT') 
  FS(*NONE)
  TOPATH('/home/ieffect/data/out/%FILENAME%') 
  ERRPATH('/home/ieffect/data/out/error') 
  ARCPATH('/home/ieffect/data/out/archive') 
  PARMS((MANDANT '01'))

Neue Mappings

Die folgende Liste zeigt alle derzeit verfügbaren Mappings für die unterstützen Formate PEPPOL, ZUGFERD und XRECHNUNG.

(Warnung) Die Mappings sind nicht im Standard Lieferumfang des Produkts enthalten, können aber bei Bedarf angefordert werden.

Format

Version

Richtung

Mapping

ZUGFeRD COMFORT

2.3.3 (1)

*OUT

ZUGFERD_2.3.3_COMFORT_OUT

ZUGFeRD EXTENDED

2.3.3 (1)

*OUT

ZUGFERD_2.3.3_EXTENDED_OUT

ZUGFERD (EXTENDED/COMFORT)

Alle Versionen

*IN

ZUGFERD_2.3.3_IN

ZUGFeRD COMFORT

2.3.2

*OUT

ZUGFERD_2.3.2_COMFORT_OUT

ZUGFeRD EXTENDED

2.3.2

*OUT

ZUGFERD_2.3.2_EXTENDED_OUT

ZUGFERD (EXTENDED/COMFORT)

2.3.2

*IN

ZUGFERD_2.3.2_IN

ZUGFeRD COMFORT

2.1.1 (2)

*OUT

ZUGFERD_2.3.3_COMFORT_OUT

ZUGFeRD EXTENDED

2.1.1 (2)

*OUT

ZUGFERD_2.3.3_EXTENDED_OUT

XRECHNUNG UBL

3.0.x

*IN

XRECHNUNG_UBL_3.0.2_IN

XRECHNUNG UBL

3.0.2

*OUT

XRECHNUNG_UBL_3.0.2_OUT

XRECHNUNG CII

3.0.x

*IN

XRECHNUNG_CII_3.0.2_IN

XRECHNUNG CII

3.0.2

*OUT

XRECHNUNG_CII_3.0.2_OUT

XRECHNUNG UBL

2.3.x

*IN

XRECHNUNG_UBL_2.3.1_IN

XRECHNUNG UBL

2.3.1

*OUT

XRECHNUNG_UBL_2.3.1_OUT

XRECHNUNG CII

2.3.x

*IN

XRECHNUNG_CII_2.3.1_IN

XRECHNUNG CII

2.3.1

*OUT

XRECHNUNG_CII_2.3.1_OUT

XRECHNUNG UBL

2.2.x

*IN

XRECHNUNG_UBL_2.2.0_IN

XRECHNUNG UBL

2.2.0

*OUT

XRECHNUNG_UBL_2.2.0_OUT

XRECHNUNG CII

2.2.x

*IN

XRECHNUNG_CII_2.2.0_IN

XRECHNUNG CII

2.2.0

*OUT

XRECHNUNG_CII_2.2.0_OUT

XRECHNUNG UBL

2.1.x

*IN

XRECHNUNG_UBL_2.1.1_IN

XRECHNUNG UBL

2.1.1

*OUT

XRECHNUNG_UBL_2.1.1_OUT

XRECHNUNG CII

2.1.x

*IN

XRECHNUNG_CII_2.1.1_IN

XRECHNUNG CII

2.1.1

*OUT

XRECHNUNG_CII_2.1.1_OUT

PEPPOL UBL INVOICE

3.0

*IN

PEPPOL_UBL_INVOICE_3.0_IN

PEPPOL UBL INVOICE

3.0

*OUT

PEPPOL_UBL_INVOICE_3.0_OUT

PEPPOL UBL CREDIT NOTE

3.0

*IN

PEPPOL_UBL_CREDITNOTE_3.0_IN

PEPPOL UBL CREDIT NOTE

3.0

*OUT

PEPPOL_UBL_CREDITNOTE_3.0_OUT

(Info) (1) Die ZUGFerd Mappings ZUGFERD_2.3.3_COMFORT_OUT und ZUGFERD_2.3.3_EXTENDED_OUT erzeugen ZUGFeRD PDF Dateien, die kompatibel zu ZUGFeRD 2.2.x und 2.3.x sind.

(Info) (2) Die ZUGFerd Mappings ZUGFERD_2.1.1_COMFORT_OUT und ZUGFERD_2.1.1_EXTENDED_OUT erzeugen ZUGFeRD PDF Dateien, die kompatibel zu ZUGFeRD 2.0.x und 2.1.x sind.

Vereinfachter Ablauf zur Eingangsverarbeitung von E-Rechnungen

Mit dem neuen Verarbeitungsbefehl PRCEINVOIC können automatisiert alle eingehenden E-Rechnungsformate und Versionen verarbeitet werden.
Es erfolgt eine automatisierte Erkennung des Formats sowie die Extraktion von XML Daten aus ZUGFeRD Daten. Sofern gewünscht werden XRECHNUNGEN visualisiert und die erkannten XML Daten in die i-effect Schnittstellen eingelesen.

CODE 
PRCEINVOIC 
  FRMIFSFILE('%IFSPATH%/%IFSFILE%')
  ERRORPATH('/home/ieffect/data/in/error')
  VISUALIZE('/home/ieffect/data/in/docs')
  MAP(*YES '/home/ieffect/data/in/error' '/home/ieffect/data/in/archive') 
  PARMS((MANDANT 'MANDANT') (CUSTOM1 'CUSTOM1') (CUSTOM2 'CUSTOM2') (CUSTOM3 'CUSTOM3'))

Mit Vereinheitlichung der ZUGeRD und XRECHNUNG Schnittstellen ist es jetzt auch möglich eine Konvertierung “umzudrehen”. In die Schnittstelle eingelesene Daten können durch Setzen von HTDIRECT='*OUT' und Aufruf der entsprechenden Konvertierung (s.o.) wieder in das Ursprungsformat zurück gewandelt werden.

Weitere Mappingparameter

Die im folgenden benannten Parameter können beim Aufruf eines Mappings zusätzlich angegeben werden

Variable

Beschreibung

PDFPATH

Name des Ausgabepfades für generierte ZUGFeRD PDF Dateien. Wenn der Parameter nicht angegeben ist, wird die PDF Datei im gleichen Verzeichnis abgelegt, in dem auch die .xml Daten erzeugt werden.

AUDITPATH

Name des Ausgabepfades für eine ausgehende Konvertierung, in welchem der erzeugte Prüfbericht abgelegt wird. Wenn der Parameter nicht angegeben ist, wird der Prüfbericht im gleichen Verzeichnis abgelegt, in dem auch die erzeugten .xml oder .pdf Daten abgelegt werden.

CONVERTPDF

Sofern dieser Parameter gesetzte ist und den Wert “1” enthält, wird die in Feld HTPDF angegebene PDF Datei in das Format PDF/A-3 umgewandelt, bevor die XML Daten in das Dokument gemischt werden.

(Warnung) Um diese Funktion verwenden zu können, muss ghostscript installiert sein

Überprüfung mit:

CODE 
/QOpenSys/pkgs/bin/gs -v

Zur Installation die folgenden Befehl ausführen:

CODE 
export QIBM_MULTI_THREADED=Y
yum install ghostscript
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.

Contact Support Close