This is an old version of this page. To the new page please click here

Das ist eine alte Version dieser Seite. Zur neuen Seite klicken sie hier

Technische Dokumentation "EPO Rechnungsausgangsbuch für den Versand aus SAP"

Das Rechnungsausgangsbuch wird mit der Transaktion /EPO1/OIL aufgerufen.

Das EPO Rechnungsausgangsbuch (kurz "RAB") kann für den Versand von

- PDF Rechnungen und

- XML Rechnungen verwendet bzw. ge-customized werden.

Das Rechnungsausgangsbuch unterstützt folgende Versand-Methoden:

- Versand per E-Mail

- Versand per Web Service

- Versand per JSON REST API

- Versand per PEPPOL

- Ausdruck über einen Drucker.

Anmerkung: Allen Transaktionen, die mit / beginnen, also insbesondere allen Transaktionen die mit /EPO1 beginnen, ist beim Aufruf über das Transaktionsfeld ein /n voranzustellen. Bei der Anlage von Favoriten zu den Transaktionen ist das nicht nötig.

Customizing

Customizing für SD Fakturen

Transaktion NACE

Die Beschreibung in diesem Kapitel sind Vorschläge. Die Einstellungen können von ihrem SAP SD Berater auch abweichend vorgenommen werden.

Customizing der Nachrichtenart ZUBE [XRechng. E-Mail] oder ZUBL [XRechng. PEPPOL]. Als Sendemedien ist [1] = [Druck] einzustellen. Sendemedium 1 hat den Vorteil, dass auch eine Druckvorschau, d.h. eine XML eRechnung Vorschau angezeigt werden kann.

Druckprogramm /EPO1/UBL_RLB_INVOICE_21, Form ENTRY

Das Druckprogramm muss nicht kopiert werden, sondern die darin enthaltenen Methoden können über Redefinitionen angepasst werden.

Im Fehlerfall, wenn die inkludierten Prüfungen einen Fehler ergeben, wird vor der XML Rechnung die Fehlertabelle in der Druckvorschau angezeigt.

Customizing für das EPO Rechnungsausgangsbuch

Das Rechnungsausgangsbuch wird mit der Transaktion /EPO1/OIL aufgerufen.

Tabelle /EPO1/INVUBL - Pflege der Versionen von e-Rechnungen

Versionen der XRechnung, ZUUFeRD und andere e-Rechnungen

Schematron	Version	gültig bis	gültig von	VersionID	CustomizationID	SchemeID	ProfileID
FatturaPA		31.12.9999	01.01.2021
UBL_AT_BBG	2.1	31.12.9999	01.02.2022	2.1	urn:www.cenbii.eu:transaction:biicoretrdm010:ver1.0:#urn:www.peppol.eu:bis:peppol4a:ver1.0	PEPPOL	urn:www.cenbii.eu:profile:bii04:ver1.0
XRechnung		31.12.2020	01.01.2000		urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_1.2
XRechnung	1.2	31.12.2020	01.01.2000		urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_1.2
XRechnung	2.0	31.01.2022	01.01.2021		urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_2.0
XRechnung	2.1	31.07.2022	01.02.2022		Urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung 2.1
XRechnung	2.2	31.12.9999	01.08.2022		Urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung 2.2

Hinweis: bei Neukunden müssen die alten Versionen nicht eingetragen werden, sondern nur die aktuelle Version!

Tabelle /EPO1/CODE_UOM - Maßeinheiten in e-Rechnungen

Code Liste Maßeinheiten.

Siehe auch Tabelle /EPO1/UNIT_T_UOM für das Mapping.

Code	Text
H87	Piece
HUR	Hour
A9	Pauschale
AB	Pack
BB	Karton
DAY	Tag
E48	Leistungseinheit
KWH	Kilowattstunde
LTR	Liter
MAW	Megawatt
MLT	Millimeter
MND	Kilo Gewicht
PK	Packung
PR	Paar
QB	Blatt
RO	Rolle

 

Tabelle /EPO1/UNIT_T_UOM - Mapping Maßeinheiten

Tabelle /EPO1/UNIT_T_UOM für das Mapping von SAP Maßeinheiten zu den e-Rechnungs-Maßeinheiten.

SAP Maßeinheit	Code Maßeinheit
H	HUR
KAR	BB
KG	MND
KWH	KWH
L	LTR
MGW	MAW
ML	MLT
PAA	PR
PAK	AB
ROL	H87
ST	H87
TAGTAG	DAY

Tabelle /EPO1/OI_INVTYPS - EPO Rechnungsarten Definition

beinhaltet die EPO ebInterface Rechnungsausgangsbuch Rechnungsarten

Die eRechnungsart dient als zentrales Kriterium für die weiteren Einstellungen.

Tabellentyp: Customizing

Pflege über SM30 oder Transaktionen /EPO1/OIL_INVTYP12 und /EPO1/OIL_INVTYP3

Definition eRechnunsarten (Vorschläge - keine Unterscheidung zwischen Rechnungen und Gutschriften):

• z.B. AE Ausgangs-eRechnung per E-Mail,
• z.B. ZF ZUGFeRD

Tabelle /EPO1/OI_INVTYPE - EPO Rechnungsarten Einstellungen

Einstellungen zu den eRechnungsarten

Tabellentyp: Customizing

Pflege über SM30

oder Transaktionen /EPO1/OIL_INVCONF12 und /EPO1/OIL_INVCONF3

• [Response XML Anzeige] Bei manuellem Versand einer eRechnung aus dem RAB wird die Antwort (der Response) in einem Pop-up Fenster angezeigt.
• [Kein Versand] Kein Versand aus dem Rechnungsbuch möglich.
• [Keine Anh. versenden] Es werden keine Anhänge zu einer Rechnung mitversandt.
• [Servicename] EPO Connector Service laut Tabelle /EPO1/CONFIGOUTY (Zuordnung EPO Connector Services je sy-sysid). Die Zuordnung auf das eigentliche EPO Client Service erfolgt in dieser Tabelle.
• [Erlaubte File Extensions] File Endungen für Upload von Anhängen mit Pipe getrennt.
• [Max. Größe Anhänge] Maximale Filegröße eines Anhangs.
• [XSLT für Rechng.] Stylesheet für Darstellung der XML Rechnung als HTML Rechnung. Standard XSLT ist /EPO1/EBINTERFACE_V40_EPO; Kann in SE80 kopiert und geändert werden (siehe Transformationen oder Transaktion XSLT_TOOL).
• [List Funktion] Hier kann ein Funktionsbaustein eingetragen werden, welcher die „Wechseln zu“ Funktionalität (Doppel-Klick auf Fremdschlüssel) ändert. Muss eine Kopie des Standard Funktionsbausteins /EPO1/OI_INVOICE_LIST_FUNCTION sein.
• [Custom Prüffunkt.] Hier kann ein Funktionsbaustein eingetragen werden, welcher beim Wechseln zur Detail Dokumentansicht eine Prüfung durchführt. Muss eine Kopie des Funktionsbausteins /EPO1/OI_CUSTOM_CHECK sein.
• [GZIP Komp.Stufe] GZIP Kompressionsstufe für die Speicherung von Dokumenten im RAB (Tabelle /EPO1/OI_DOC). Default ist 6.
• [Keine Berechtigungsprüfung] Es wird keine Berechtigungsprüfung laut dem Berechtigungsobjekt /EPO1/OIHD (Feld /EPO1/OIIT für Invoice Type und Feld /EPO1/OICN für Buchungskreis) sowie für das Berechtigungsobjekt V_VBAK_VKO (mit ACTV=03) durchgeführt und alle selektieren eRechnungen werden angezeigt.
• [Kein XML editieren] eInvoiceXML Rechnungen können nicht mit dem eingebauten XML Editor editiert werden.
• Versand von Emails: Sender ermitteln: EMAIL_SENDER setzen: aktueller SAP GUI User (Actual-USR) oder Rechnungsersteller (OI-CREATOR)

Tabelle /EPO1/EB_FKINVTY - Zuordnung SAP SD zu EPO Rechnungsarten

Zuordnung von SD Fakturaarten zum eRechnungs-Fakturatyp

Tabellentyp: Customizing

Pflege über SM30

oder Transaktionen /EPO1/OIL_FKART12 und /EPO1/OIL_FKART3

Hinweis: ist ev. nicht nötig

 

Tabelle /EPO1/OI_DEFAULT - Rechnungsarten Defaulteinstellungen

Default Werte zu den eRechnungsarten

• [E-Mail Adresse] Wird für UBL XRechnungs-XML nicht verwendet.
• [Kontonummer b. Deb.] Die Biller InvoiceRecipientsBillerID im eInvoiceXML. Wird verwendet, wenn im Debitorenstamm des Regulierers in der Buchhaltungssicht „Korrespondenz“ keine „Kontonummer b. Debitor“ (KNB1-EIKTO) eingetragen ist.
• [Adresse FuBa] Wird nicht mehr verwendet.
• [Name1-4 Sort.] Wird für UBL XRechnungs-XML nicht verwendet.
• [Form. anhängen] Wird für UBL XRechnungs-XML nicht verwendet. Das Smartform / SapScript Formular wird als Anhang zur Rechnung in das RAB gestellt.

Tabelle /EPO1/OI_EDIFIEL - XML Editor Einstellungen

XML Elemente welche im RAB eingebauten XML Editor änderbar sind.

Tabellentyp: Customizing

Pflege über SM30

Tabelle /EPO1/OI_INVARCH - Archivierung

Einstellungen, welche Dokumente nach einem erfolgreichen Versand zu archivieren sind.

Diese Tabelle stellt eine Zuordnung zur Customizing Tabelle TOAOM her.

Tabellentyp: Customizing

Pflege über SM30 oder Transaktionen /EPO1/OIL_INVARCH12 und /EPO1/OIL_INVARCH3

Tabelle /EPO1/EC_EB_WSFM - Sende-Funktionsbausteine

EPO eInvoiceWeb Service Funktion

Tabellentyp: Customizing

Pflege über SM30 oder Transaktionen /EPO1/EC_EB_WSFM12 und /EPO1/EC_EB_WSFM3

• [SAP-System-ID] SY-SYSID Eintrag, womit hier wiederum pro System ein unterschiedlicher Web Service Ausführungs-Funktionsbaustein möglich wäre.
• [Servicename] Servicename aus Tabelle /EPO1/CONFIGOUTY (system-unabhängig).
• [AusführungsFB] Ein EPO Connector Ausführungs-Funktionsbaustein, welcher die eRechnungen versendet.

Versand per E-Mail: /EPO1/EC_UM_EMAIL_ATTACHMENT

Versand per PEPPOL via ecosio: /EPO1/ECOSIO_SEND_DOCUMENT

• [Präfix ID] Präfix für object_id Wert für Archivierung (in TOA01).
• [No R.Store] Für UBL XML nicht verwendet.

Tabelle /EPO1/OI_CBUTTON - ALV Custom Buttons Definition

Customizing Tabelle für GUI Buttons - Benutzerdefinierte Methoden

Pflege über SM30

Tabelleninhalte siehe ScreenShot

Klasse /EPO1/CL_INVOICE_CUSTOM_DEV ist mit den jeweiligen Methoden zu erweitern

Anwenden von Custom Buttons:

Tabelle /EPO1/OI_CBUTTON erweitern um Methode, Button-Text und Button-Icon

Methode muss in der Klasse /EPO1/CL_INVOICE_CUSTOM_DEV mit gleichem Namen (Methodenname in Tabelle) implementiert werden.

Methodenaufruf erfolgt im Include /EPO1/OI_INVOICE_F02

Form: call_custom_method

Handling erfolgt in der Klassenmethode

Methodenspezifikation:

Importing-Parameter: keine

Exporting-Parameter: keine

In Methode kann Klassenvariable (Tabelle von selektiertem/n Invoice/s: MT_STYLED_OI) verwendet werden.

Wichtig: Returnvalue (= Klassenattribut) in der Methode setzen für weitere Verarbeitung (Refresh/Fehlerhandling).

Lesen von Return-Attribut über Klassenmethode GET_RETURN

Tabelle /EPO1/OI_CFUNC - ALV Custom Buttons Funktionen

Customizing Tabelle für GUI Buttons - Funktionsbausteine

Pflege über SM30

Tabelleninhalte siehe ScreenShot

Customizing für e-Rechnungen

Tabelle /EPO1/CODE_UOM - Maßeinheiten in e-Rechnungen

Code Liste Maßeinheiten.

Siehe auch Tabelle /EPO1/UNIT_T_UOM für das Mapping.

Code	Text
H87	Piece
HUR	Hour
A9	Pauschale
AB	Pack
BB	Karton
DAY	Tag
E48	Leistungseinheit
KWH	Kilowattstunde
LTR	Liter
MAW	Megawatt
MLT	Millimeter
MND	Kilo Gewicht
PK	Packung
PR	Paar
QB	Blatt
RO	Rolle

 

Tabelle /EPO1/UNIT_T_UOM - Mapping Maßeinheiten

Tabelle /EPO1/UNIT_T_UOM für das Mapping von SAP Maßeinheiten zu den e-Rechnungs-Maßeinheiten.

SAP Maßeinheit	Code Maßeinheit
H	HUR
KAR	BB
KG	MND
KWH	KWH
L	LTR
MGW	MAW
ML	MLT
PAA	PR
PAK	AB
ROL	H87
ST	H87
TAGTAG	DAY

Tabelle /EPO1/ECOSIO_ESI - ECOSIO Status

Customizing Tabelle für Ecosio Status Ampel. Diese Tabelle muss nur bei Versand über die ecosio.com Plattform gepflegt werden.

Pflege über SM30

Tabelleninhalte siehe ScreenShot

Custom Button Email Web Client - RAB Einstellungen

Tabelle /EPO1/OI_CBUTTON erweitern um WEB_MAIL: Email (siehe Screen Shot)

Standarttext in Transaktion SO10 anlegen

Für Email-Subject:

Textname = /EPO1/INV_EMAIL_SUBJECT

Text ID = ST

Language = EN

Textinhalt = eInvoice & attached

Info: Sprache übersetzen für DE

Language = DE

Textinhalt = eRechnung & im Anhang

(Info: Analog zu Textelementen wird im Code '&' mit Variablenwert befüllt, hier: Invoice_key)

Für Email-Body:

Textname = /EPO1/INV_EMAIL_BODY

Text ID = ST

Language = EN

Textinhalt:

* Please read and process our invoice (see PDF attachment).

/

/ Best Regards.

/ [this is an automated e-mail]

Info: Sprache übersetzen für DE

Language = DE

Textinhalt:

Sehr geehrte Damen und Herren!

/

/ Anbei unsere Rechnung.

/

/ Mit freundlichen Grüßen!

/ [dies ist eine automatisierte E-Mail]

-------------------------------------------------------------------------

SO10 Textelemente werden in Klasse /EPO1/CL_INVOICE_EMAIL an Super-Constructor mitgegeben

Customizing EPO Connector für den Versand von e-Rechnungen

EPO Connector Menü über Transaktion /EPO1/EXC

Customizing EPO Connector initial

EPO Connector Nummernkreis /EPO1/NOR

Da alle Web Services und auch der Versand per E-Mail mitprotokolliert werden (können), muss ein Nummernkreis für die EPO Connector-Transaktions-IDs eingestellt werden.

Sie müssen für die Generierung der TransaktionsIDs der EXC Nachrichten einen Nummernkreis einrichten. Es wird der Default Nummernkreis 01 des Nummernkreisobjekts /EPO1/NOR verwendet.

Sie müssen den Nummernkreis auf allen Systemen separat einrichten. Ein Transport ist nur bei erstmaliger Einrichtung möglich.

Transaktion: /EPO1/NOR

Menü: [EPO Connector Konfiguration] – [Pflege Default Nummernkreis /EPO1/NOR]

EPO Connector Lizenzschlüssel

Für die Verwendung des EPO Connector müssen Sie den Lizenzschlüssel laden. Sie erhalten den Lizenzschlüssel von EPO Consulting. Für die Generierung des Lizenzschlüssels müssen Sie die SAP Installationsnummer bekanntgeben (Menü: [System] – [Status]).

Hinweis: Der Lizenzschlüssel ist nur auf Produktivsystemen und Testsystemen zwingend erforderlich. Auf Entwicklungssystemen wird der Lizenzschlüssel nicht benötigt.

Transaktion: /EPO1/SETLICENSE

Menü: [EPO Connector Administration] – [Laden des Lizenzschlüssels für den EPO Connector]

Option Versand per E-Mail

Transaktion: /EPO1/SERVICES12

Menü: [EPO Connector Konfiguration] – [Services für EPO Connector - Pflege]

Service: EMail

Transaktion: /EPO1/EPORTOUT12

Sie können hier die Operations der Services konfigurieren.

Menü: [EPO Connector Konfiguration] – [Outbound Service Konfiguration] – [EPO Client] – [Out: EPO Client Services Konfiguration]

Operation: sost

Option Versand per PEPPOL über den ecosio Integration Hub

Siehe Dokumentation für EPO Connector für ecosio EDI.

Das Setup ist ident zum Versand von IDocs. Es werden die gleichen EPO Connector Services verwendet.

Transaktion: /EPO1/ECSIDOUT12

Zuordnung von SAP Systemen zu den EPO Connector Outbound Services

Dev und Test zuordnen dem EPO Connector Test Service

Produktion zuordnen dem EPO Connector Produktiv-Service

Workbench Anpassungen für den Versand

Option 1: Durch Re-Definition von Methode (Details sind beim jeweiligen Versand-Funktionsbaustein dokumentiert)

Option 2: Durch Z-Kopie eines /EPO1/-Versand-Funktionsbausteins

 

Job für automatischen Versand - Report /EPO1/OI_INVOICE_SEND

Bei Bedarf kann ein periodisch eingeplanter Job das Versenden der aktuellen Rechnungen übernehmen. Die Kontrolle auf erfolgreichen Versand (bzw. Fehler) muß dennoch manuell im Rechnungsausgangsbuch (Transaktion /EPO1/OIL) durchgeführt werden.

Report: /EPO1/OI_INVOICE_SEND

Den Selektionsschirm entsprechend den Anforderungen einstellen, zumindest die Rechnungsart und der Sende-Status sollten eingetragen sein.

Sendestatus - wichtigste Werte

• 50: Rechnung wurde gespeichert (aber noch nicht versendet)
• 51: Fehler beim Versenden
• 53: Rechnung wurde erfolgreich versandt

 

Status setzen und Einträge löschen

Sollten Einträge im RAB vorhanden sein, die nicht mehr erwünscht sind, so können diese gelöscht oder auf einen anderen Status gesetzt werden

Transaktion: /EPO1/OIL_STATUSADM

Hier müssen über den Selektionsschirm Einträge ausgewählt werden, die gelöscht bzw. bei denen der Status geändert werden soll.

Wenn der Status geändert werden soll, dann im rot markierten Block den entsprechenden Status auswählen. Soll gelöscht werden, dann die Checkbox "Löscht gesamten Eintrag" markieren. Beides gleichzeitig ist nicht möglich. Unter Ausführungsoptionen muss gewählt werden, ob die Einträge entsprechend der Selektion angezeigt (Testlauf) oder sofort verarbeitet (Echtlauf) werden sollen. Bei löschen kommt noch eine Sicherheitsabfrage, ob XXX Einträge gelöscht werden sollen.

Versionen

Produkt ID (nur für interne Referenz): E-INVOICE

Version 2.5.5

Transportauftrag WK1K903377 EPO e-Invoice v2.5.5 am 10.04.2023

• Signature option added for e-mail fms.
• Call of e-mail app with customizing option
• New report /EPO1/OI_INVOICE_ARCHIVE for archiving documents from oil and deleting field /EPO1/OI_DOC-DOCUMENT, if archived

Version 2.5.4

Transportauftrag WK1K903316 EPO e-Invoice v2.5.4 am 19.02.2023

• Technischer Update für EPO Connector SP12 notwendig

Version 2.5.3

Transportauftrag WK1K903293 02.02.2023

• Archivierung, Fuba /EPO1/OI_ARCHIVEDOC: kein Update der Dokumenten-Tabelle bei DOCUMENT_NUMBER = 0 (vermeidet Fehlermeldung)
• Neue Customizingfelder für e-Mail in /EPO1/OI_INVTYPE: SET_SIGN und DISCLOSURE

Aktivitäten vor dem Import:

• Update des EPO-Connector: SP12 - Vorab Version 4.8.8 (WK1K903278) vom 02.02.2023, oder neuer

Version 2.5.2

Transportauftrag WK1K902812 27.05.2022

• Zuschläge/Abschläge: Konditionskennzeichen KINAK (=inaktiv) und KSTAT (=statistisch) berücksichtigen

Version 2.5.1

Transportauftrag WK1K902767 29.04.2022

• Korrektur in der IDOC-Manipulation, die Prüfung beim Einfügen neuer Segmente hat mnachmal zu streng geprüft

Version 2.3.2

Transportauftrag WK1K9020?? 12.08.2021

• Korrektur SKONTO für ZUGFeRD - Rechnungen: Basisdatum, Periode, Grundbetrag und Beschreibungstext

Version 2.3.1

Transportauftrag WK1K902070 10.08.2021

• XML Element cac:PayeeParty wird nicht mehr befüllt

Version 2.3.0

Transportauftrag WK1K901988 25.06.2021

• Support für SKONTO - Informationen (für ZUGFeRD - Rechnungen)

Version 2.2.6

Transportauftrag WK1K901954 11.06.2021

• Restrukturierung von Paketen: Auslagern von OI relevante Elemente ins ECOSIO_Document

Version 2.2.3

Transportauftrag WK1K901722 08.03.2021

• Korrektur SD UBL Klassen - Methode UBL_PROCESS

Version 2.2.2

Transportauftrag WK1K901717 08.03.2021

• Syntax-Korrektur für ältere Releases, Klasse /EPO1/CL_UBL_HELPERS
• Erweiterung /EPO1/OI_SCHEMATRON Domänenfestwert

Version 2.2.0

Transportauftrag WK1K901607 21.01.2021

• Versions-info hinzugefügt, Klasse /EPO1/CL_VERSION_INVOICE_UBL
• Bereinigung des Auslieferungspaketes, der SDI-Teil ist nun separat
• Syntax-Anpassungen für alte SAP-Releases