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.
| Nachrichtentyp | Basistyp (Beispiel) | Inhalt |
|---|---|---|
| ORDERS | ORDERS05 | Bestellung, beim Empfänger der Kundenauftrag |
| ORDRSP | ORDERS05 | Auftragsbestätigung |
| DESADV | DELVRY07 | Lieferavis |
| INVOIC | INVOIC02 | Rechnung |
| MATMAS | MATMAS05 | Materialstamm |
| DEBMAS | DEBMAS07 | Kundenstamm |
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:
| Transaktion | Wofür |
|---|---|
| WE02, WE05 | IDocs anzeigen und nach Status, Partner oder Datum filtern |
| WE09 | IDocs nach dem Inhalt einzelner Segmentfelder suchen |
| BD87 | Statusmonitor, fehlerhafte IDocs erneut verarbeiten |
| WE19 | Testwerkzeug: IDoc kopieren und testweise verarbeiten |
| WE20 | Partnervereinbarungen pflegen |
| WE21 | Ports pflegen |
| WE30, WE31 | IDoc-Typen und Segmente anlegen und erweitern |
| WE60 | Dokumentation eines IDoc-Typs anzeigen |
| BD64 | Verteilungsmodell 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:
| Status | Richtung | Bedeutung |
|---|---|---|
| 01 | Ausgang | IDoc erzeugt |
| 30 | Ausgang | Bereit zum Versand, wartet auf den Sammelversand |
| 03 | Ausgang | Daten an den Port übergeben |
| 02 | Ausgang | Fehler bei der Übergabe an den Port |
| 29 | Ausgang | Fehler im ALE-Dienst, etwa fehlende Partnervereinbarung |
| 64 | Eingang | Bereit zur Übergabe an die Anwendung |
| 53 | Eingang | Anwendungsbeleg gebucht |
| 51 | Eingang | Anwendungsbeleg nicht gebucht, fachlicher Fehler |
| 56 | Eingang | IDoc mit Fehlern hinzugefügt, oft fehlt die Partnervereinbarung |
| 68 | Eingang | Fehler, 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
IDoc und was oft damit gleichgesetzt wird
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.
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.
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.
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.
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.
Kurse, die IDoc behandeln
Häufige Fragen
Warum heißt es Intermediate Document?
Wie finde ich das IDoc zu einer bestimmten Bestellung?
Welches Format hat eine IDoc-Datei?
Gibt es IDocs in SAP S/4HANA noch?
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.
Deine Ansprechpartner
Du willst das Thema nicht nur nachschlagen, sondern anwenden können? Wir beraten dich persönlich und kostenlos.
Yves Hoppe
Weiterbildung & Beratung
Ordnet mit dir ein, welcher Kurs zu deinem Vorwissen passt.
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.
Verwandte Begriffe
Alle Begriffe im Glossar