Datenaustausch zwischen Systemen

Was ist ein IDoc?

Intermediate Document

Ein IDoc (Intermediate Document) ist das Standardformat, in dem SAP-Systeme Geschäftsdaten wie Bestellungen, Rechnungen, Lieferavise oder Stammdaten mit anderen Systemen austauschen. Es ist ein strukturierter Datencontainer aus Kontrollsatz, Datensegmenten und Statussätzen und wird in der Regel asynchron verschickt, der Absender wartet also nicht auf die Verarbeitung beim Empfänger.

Wenn ein Kunde elektronisch bestellt oder ein Lieferant seine Rechnung per EDI schickt, kommt die Nachricht in SAP als IDoc an, und wenn eines hängen bleibt, fehlt der Beleg im System.

KI-generiertDieses Bild wurde mit KI erzeugt · Yves Hoppe / KI / cmt
Steht für
Intermediate Document, ein Zwischenformat
Aufbau
Kontrollsatz, Datensegmente, Statussätze
Wichtige Transaktionen
WE02, BD87, WE20, WE21
Verwechselt mit
EDI, ALE und BAPI

Wofür IDocs gebraucht werden

IDocs transportieren Geschäftsvorfälle zwischen Systemen, die nicht direkt miteinander reden sollen oder können. Drei Einsatzfelder sind typisch: der elektronische Austausch mit Kunden und Lieferanten (EDI), die Verteilung von Daten zwischen mehreren SAP-Systemen, etwa Materialstämmen von einer Zentrale an die Werke, und die Anbindung von Nicht-SAP-Systemen wie Lagerverwaltung, Fertigungssteuerung oder Webshop.

Ein Beispiel: Ein Kunde schickt eine Bestellung im EDIFACT-Format. Ein Konverter oder eine Middleware übersetzt sie in ein IDoc vom Typ ORDERS05, SAP nimmt es entgegen und legt daraus einen Kundenauftrag an. Die Auftragsbestätigung geht auf demselben Weg zurück, nur in umgekehrter Richtung. Weil der Austausch asynchron läuft, muss das Zielsystem in dem Moment nicht erreichbar sein, das IDoc wartet, bis es abgeholt oder verarbeitet wird.

Welche Nachricht gemeint ist, sagt der Nachrichtentyp. Die folgende Tabelle zeigt verbreitete Beispiele. Die Ziffer am Ende des Basistyps ist seine Version, neuere Releases bringen teils höhere Versionen mit.

NachrichtentypBasistyp (Beispiel)Inhalt
ORDERSORDERS05Bestellung, beim Empfänger der Kundenauftrag
ORDRSPORDERS05Auftragsbestätigung
DESADVDELVRY07Lieferavis
INVOICINVOIC02Rechnung
MATMASMATMAS05Materialstamm
DEBMASDEBMAS07Kundenstamm

Wie ein IDoc aufgebaut ist

Jedes IDoc besteht aus drei Teilen. Der Kontrollsatz enthält die Adressierung: Absender, Empfänger, Nachrichtentyp, Basistyp und die eindeutige IDoc-Nummer. Die Datensätze tragen den Inhalt in Segmenten, die hierarchisch geschachtelt sind, also zum Beispiel Kopfdaten einer Bestellung mit darunterliegenden Positionen. Die Statussätze protokollieren jeden Verarbeitungsschritt mit Zeitstempel und Meldung. Sie bleiben im jeweiligen System und reisen nicht mit dem IDoc zum Partner.

Im System liegen die drei Teile in eigenen Tabellen, der Kontrollsatz in EDIDC, die Datensätze in EDID4 und die Statussätze in EDIDS. Verlässt ein IDoc das System als Datei, ist es entweder eine Textdatei mit festen Feldlängen oder eine XML-Datei. Vereinfacht sieht eine Bestellung so aus:

EDI_DC40   Kontrollsatz: Absender, Empfänger, ORDERS, ORDERS05
E1EDK01    Kopfdaten: Währung, Belegart
  E1EDKA1  Partner: Auftraggeber, Warenempfänger
E1EDP01    Position 10: Menge, Mengeneinheit
  E1EDP19  Materialnummer
E1EDP01    Position 20: Menge, Mengeneinheit
  E1EDP19  Materialnummer

Segmente des SAP-Standards beginnen mit E1, eigene Segmente aus Kundenerweiterungen mit Z1. Welche Segmente in welcher Reihenfolge und wie oft vorkommen dürfen, legt der Basistyp fest. Die vollständige Satzbeschreibung eines Typs zeigt dir die Transaktion WE60.

Nachrichtentyp, Basistyp und Erweiterung

Der Basistyp beschreibt die technische Struktur, der Nachrichtentyp die fachliche Bedeutung. Deshalb kann derselbe Basistyp mehreren Nachrichtentypen dienen: ORDERS05 trägt sowohl die Bestellung als auch die Auftragsbestätigung. Das System erkennt am Nachrichtentyp, welche Anwendung das IDoc verarbeiten soll.

Fehlen dir Felder, änderst du den Standard nicht, sondern legst eine Erweiterung an. Du definierst ein eigenes Segment, hängst es über einen Erweiterungstyp an den Basistyp und füllst oder liest es an den dafür vorgesehenen Erweiterungsstellen im Programmcode. Der Standardtyp bleibt unverändert und übersteht damit Upgrades.

Was das System für den Versand braucht

Ob ein IDoc überhaupt entsteht und wohin es geht, regeln wenige Einstellungen. In der Partnervereinbarung (WE20) steht je Partner und Nachrichtentyp, welcher Basistyp verwendet wird, ob sofort oder gesammelt verschickt wird und über welchen Port. Der Port (WE21) beschreibt den technischen Kanal, etwa eine RFC-Verbindung zu einem anderen System, eine Dateiablage oder eine Übergabe per XML über HTTP. Zwischen SAP-Systemen kommt das Verteilungsmodell (BD64) dazu, das festlegt, welches System welche Nachrichten an wen schickt.

Fehlt die Partnervereinbarung für einen neuen Partner, wird das IDoc trotzdem erzeugt, bleibt aber mit Fehlerstatus liegen, ohne dass in der Anwendung etwas auffällt. Ein IDoc meldet sich nicht von selbst, wenn es steckenbleibt. Diese Transaktionen brauchst du im Alltag am häufigsten:

TransaktionWofür
WE02, WE05IDocs anzeigen und nach Status, Partner oder Datum filtern
WE09IDocs nach dem Inhalt einzelner Segmentfelder suchen
BD87Statusmonitor, fehlerhafte IDocs erneut verarbeiten
WE19Testwerkzeug: IDoc kopieren und testweise verarbeiten
WE20Partnervereinbarungen pflegen
WE21Ports pflegen
WE30, WE31IDoc-Typen und Segmente anlegen und erweitern
WE60Dokumentation eines IDoc-Typs anzeigen
BD64Verteilungsmodell für den Austausch zwischen SAP-Systemen

Statuswerte lesen

Jeder Verarbeitungsschritt schreibt einen Statussatz mit zweistelliger Nummer. Am Status erkennst du, an welcher Stelle der Kette ein IDoc steht und ob der Fehler technisch oder fachlich ist. Die wichtigsten Werte:

StatusRichtungBedeutung
01AusgangIDoc erzeugt
30AusgangBereit zum Versand, wartet auf den Sammelversand
03AusgangDaten an den Port übergeben
02AusgangFehler bei der Übergabe an den Port
29AusgangFehler im ALE-Dienst, etwa fehlende Partnervereinbarung
64EingangBereit zur Übergabe an die Anwendung
53EingangAnwendungsbeleg gebucht
51EingangAnwendungsbeleg nicht gebucht, fachlicher Fehler
56EingangIDoc mit Fehlern hinzugefügt, oft fehlt die Partnervereinbarung
68EingangFehler, keine weitere Bearbeitung vorgesehen

Status 51 ist der häufigste Fall. Die Meldung im Statussatz ist meist dieselbe, die du bei manueller Erfassung des Belegs bekämst, etwa ein unbekanntes Material oder eine gesperrte Buchungsperiode. Behebst du die Ursache, lässt sich das vorhandene IDoc erneut verarbeiten, ein neues beim Partner anzufordern ist selten nötig.

KI-generiertDieses Bild wurde mit KI erzeugt · Yves Hoppe / KI / cmt
Nicht verwechseln

IDoc und was oft damit gleichgesetzt wird

IDoc gegen EDI

EDI ist der Oberbegriff für den elektronischen Austausch von Geschäftsdokumenten zwischen Unternehmen, meist in Formaten wie EDIFACT, ANSI X12 oder XML-Standards. Das IDoc ist das SAP-interne Format auf der einen Seite dieser Kette. Die Übersetzung zwischen beiden übernimmt ein Konverter oder eine Middleware.

IDoc gegen ALE

ALE (Application Link Enabling) ist das Verfahren, mit dem SAP-Systeme Daten untereinander verteilen, gesteuert über das Verteilungsmodell. Das IDoc ist das Transportformat darin. Verteilte Stammdaten laufen über ALE, nutzen aber dieselben IDoc-Strukturen wie der Austausch mit externen Partnern.

IDoc gegen BAPI

Ein BAPI ist ein synchroner Funktionsaufruf: Das aufrufende System wartet, bis das Ergebnis da ist, und bekommt Erfolg oder Fehler sofort zurück. Ein IDoc geht asynchron auf die Reise, der Absender erfährt vom Ergebnis erst später oder über eine eigene Rückmeldung.

In der Praxis

Ein neuer EDI-Partner ist ein kleines Projekt

Wenn ein Kunde ankündigt, ab nächstem Monat per EDI zu bestellen, klingt das nach einer Einstellung. Tatsächlich müssen drei Stellen zusammenpassen: das Mapping im Konverter, das sein Format in das IDoc übersetzt, die Partnervereinbarung in SAP und die Stammdaten, über die SAP die Angaben des Kunden zuordnet, etwa seine eigenen Materialnummern oder Partnerrollen. Fehlt eines davon, landen die ersten Bestellungen im Status 51 oder 56.

Deshalb lohnt eine Testphase, bevor echte Bestellungen fließen. Mit WE19 kannst du ein Muster-IDoc kopieren, Werte ändern und die Verarbeitung durchspielen, ohne dass der Partner etwas schicken muss. Vereinbare mit dem Partner außerdem, welche Felder Pflicht sind und welche Qualifier er verwendet, denn genau dort entstehen die meisten Missverständnisse.

Nach dem Start gehört der neue Partner für ein paar Wochen auf die tägliche Beobachtungsliste. Die ersten Fehler zeigen fast immer Lücken in den Stammdaten oder im Mapping, und je früher sie auffallen, desto weniger Belege musst du hinterher einzeln korrigieren.

IDoc lernen

Wie du Verbindungen einrichtest, Daten übernimmst und Fehler im Monitor abarbeitest, behandeln die Kurse zu den Schnittstellen von SAP.

Wer die Verarbeitung selbst programmieren oder erweitern will, findet den Einstieg in den Trainings rund um die Entwicklung mit ABAP.

Wissen prüfen

Sitzt IDoc schon?

Lesen fühlt sich schnell nach Können an. Ein kurzer Test zeigt dir, was davon schon sitzt und wo sich ein Kurs lohnt. Kostenlos, ohne Anmeldung, mit einer Erklärung zu jeder Antwort.

Häufige Fragen

Warum heißt es Intermediate Document?
Weil das IDoc ein Zwischenformat ist. Es steht zwischen dem Anwendungsbeleg in SAP, etwa dem Kundenauftrag, und dem Format, das der Partner versteht. So muss die Anwendung nur das IDoc kennen, und die Übersetzung in EDIFACT, XML oder ein anderes Format passiert außerhalb.
Wie finde ich das IDoc zu einer bestimmten Bestellung?
Im Ausgang zeigt der Anwendungsbeleg über seine Nachrichten oder den Belegfluss, welches IDoc erzeugt wurde. Im Eingang hilft WE09: Dort suchst du nach dem Wert eines Segmentfelds, etwa der Bestellnummer des Kunden, und schränkst nach Nachrichtentyp und Zeitraum ein.
Welches Format hat eine IDoc-Datei?
Über einen Dateiport schreibt SAP IDocs entweder als Textdatei mit festen Feldlängen oder als XML-Datei. Der Aufbau folgt immer derselben Logik aus Kontrollsatz und Datensegmenten, die Feldbeschreibung des jeweiligen Typs liefert WE60.
Gibt es IDocs in SAP S/4HANA noch?
Ja, die IDoc-Schnittstelle ist auch in S/4HANA vorhanden, und bestehende EDI- und ALE-Szenarien laufen dort weiter. Für neue Integrationen, vor allem mit Cloud-Anwendungen, stellt SAP zusätzlich APIs auf Basis von OData und SOAP bereit. Welcher Weg passt, hängt davon ab, was Partner und Middleware unterstützen.

Passt thematisch dazu

Sobald ein Beleg im Fehlerstatus liegt, brauchst du keinen Entwickler, sondern das Wissen, wie du ein hängendes IDoc findest und erneut verarbeitest.

Persönlich für dich da

Deine Ansprechpartner

Du willst das Thema nicht nur nachschlagen, sondern anwenden können? Wir beraten dich persönlich und kostenlos.

Yves Hoppe

Yves Hoppe

Weiterbildung & Beratung

Ordnet mit dir ein, welcher Kurs zu deinem Vorwissen passt.

Norbert Jansen

Norbert Jansen

Beratung & Inhouse

Plant Inhouse-Trainings, die an euren eigenen Daten und Abläufen ansetzen.

IDoc im Kurs statt im Lexikon

Nachschlagen bringt dich bis zum Verstehen. Anwenden lernst du an echten Aufgaben.