¶ 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 |
| TAG | 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.6.1
Transportauftrag WK1K903769 am 15.09.2023
- Klasse /EPO1/CL_INVOICE_PDF, Methode MERGE_PDFS: Aufruf der Klasse CL_RSPO_PDF_MERGE dynamisch gestalten - verhindert Syntaxfehler beim Paket-Import, wenn diese Klasse nicht verfügbar ist
Version 2.6.0
Transportauftrag WK1K903706 EPO e-Invoice v2.6.0 am 23.08.2023
- skip sub-positions of SET - positions (without value): /EPO1/CL_UBL_CREDITNOTE_OUT_SD, /EPO1/CL_UBL_INVOICE_OUT_SD method REMOVE_SET_POSITIONS
- new authority-check in /EPO1/OI_INVOICE_LIST , created new authority object '/EPO1/OIH2' includes the FKEY1 field with 40 chars
Version 2.5.6
Transportauftrag WK1K903601 EPO e-Invoice v2.5.6 am 05.07.2023
- e-mail address: from RE with higher prio, AG only as fallback (class /EPO1/CL_UBL_HELPERS->GET_EMAIL_RECEIVER)
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
Aktivitäten vor dem Import:
- Update des EPO-Connector: SP12 - Vorab Version 4.8.9 (WK1K903321) vom 12.05.2023, oder neuer
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 machmal 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