Datenaustausch zwischen Systemen

Was ist ein IDoc?

Intermediate Document

Ein IDoc ist ein standardisiertes Containerformat von SAP, mit dem Geschäftsdaten wie Bestellungen, Rechnungen oder Lieferavise strukturiert an andere Systeme übergeben und von dort entgegengenommen werden, in der Regel asynchron.

Bestellungen, die ein Kunde elektronisch schickt, kommen bei dir nicht als Datei an, sondern als IDoc, und wenn eines hängen bleibt, fehlt der Auftrag im System.

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

Aufbau: Kontrollsatz, Datensätze, Statussätze
Typisch für: Bestellungen, Rechnungen, Lieferavise
Steuerung: Partnervereinbarung und Port
Monitor: Transaktion WE02

Wie ein IDoc aufgebaut ist

Jedes IDoc besteht aus drei Teilen. Der Kontrollsatz enthält Absender, Empfänger, Nachrichtentyp und Basistyp, also die Adressierung. Die Datensätze enthalten den Inhalt in Segmenten, hierarchisch geschachtelt, etwa Kopfdaten einer Bestellung mit darunterliegenden Positionen. Die Statussätze protokollieren jeden Verarbeitungsschritt mit Zeitstempel und Meldung.

Welche Segmente erlaubt sind, legt der Basistyp fest; welcher Geschäftsvorfall gemeint ist, sagt der Nachrichtentyp. Wer eigene Felder braucht, legt sie in einer Erweiterung an, statt den Standard zu ändern. Nur so bleibt der Typ upgradefähig.

Was das System für den Versand wissen muss

Zwei Einstellungen entscheiden, ob etwas rausgeht: die Partnervereinbarung und der Port. In der Partnervereinbarung ist je Partner und Nachrichtentyp hinterlegt, welcher Basistyp verwendet wird und über welchen Weg verschickt wird. Der Port beschreibt den Kanal, also Dateiablage, RFC-Verbindung zum Zielsystem oder Übergabe an eine Middleware.

Fehlt die Partnervereinbarung, wird das IDoc zwar erzeugt, bleibt aber im Fehlerstatus liegen, ohne dass in der Anwendung etwas auffällt. Das ist der Grund, warum ein Monitoring dazugehört: Ein IDoc meldet sich nicht von selbst, wenn es steckenbleibt.

Fehler finden und wiederholen

Beim Eingang bedeuten zwei Statuswerte fast alles: 53 heißt, der Anwendungsbeleg wurde erfolgreich gebucht, 51 heißt, die Anwendung hat den Beleg abgelehnt, etwa weil ein Material unbekannt ist oder ein Preis fehlt. Die zugehörige Meldung steht im Statussatz und ist meist dieselbe, die du auch bei manueller Erfassung bekämst.

Korrigierte IDocs musst du nicht neu anfordern. Nachdem die Ursache behoben ist, also der Stammsatz angelegt oder die Einstellung ergänzt wurde, lässt sich der Eingang erneut verarbeiten. Wichtig ist dabei, den Fehlerbestand täglich abzuarbeiten. Sammeln sich Hunderte fehlerhafte Belege, unterscheidet niemand mehr zwischen alten Karteileichen und dem Ausfall von heute Morgen.

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 übergreifende Begriff für elektronischen Geschäftsdatenaustausch, oft in Formaten wie EDIFACT. Das IDoc ist das SAP-eigene Format davor oder danach, umgesetzt wird die Übersetzung meist von einem Konverter oder einer Middleware.

IDoc gegen BAPI

Ein BAPI ist ein synchroner Funktionsaufruf: Das aufrufende System wartet auf das Ergebnis. Ein IDoc geht asynchron auf die Reise, der Absender erfährt den Erfolg erst über die Statusrückmeldung.

IDoc gegen ALE

ALE ist das Verteilungskonzept zwischen SAP-Systemen, IDoc ist das Transportformat darin. Verteilte Stammdaten laufen über ALE, verwenden aber dieselben IDoc-Strukturen wie der Austausch mit externen Partnern.

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

In der Praxis

IDocs fallen erst auf, wenn keiner mehr ankommt

Ein IDoc besteht aus einem Kontrollsatz mit Absender, Empfänger und Nachrichtentyp, den eigentlichen Daten in Segmenten und einer Statushistorie. Diese Status sind der schnellste Einstieg in die Fehlersuche, denn sie sagen dir, ob das IDoc gar nicht erst erzeugt, nicht versendet oder erst beim Verbuchen abgelehnt wurde.

Damit überhaupt etwas hinausgeht, müssen Partnervereinbarung, Nachrichtenart und Port zusammenpassen. Kommt ein neuer Lieferant dazu und wird die Partnervereinbarung vergessen, bleibt die Nachricht liegen, ohne dass jemand einen Fehler zu sehen bekommt. Genau deshalb gehört der Blick in den Monitor in den Tagesablauf und nicht erst in die Eskalation.

Beim Wiederholen eines fehlerhaften IDocs ist Vorsicht angebracht. Lag der Fehler nur an fehlenden Stammdaten, reicht das erneute Verbuchen. Lag er am Inhalt, erzeugst du beim blinden Wiederholen eine zweite Bestellung, und der Doppelbeleg fällt erst in der Rechnungsprüfung auf.

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 .

Kurse, die IDoc behandeln

Häufige Fragen

Was mache ich mit einem IDoc im Fehlerstatus?

Lies die Meldung im Statussatz, sie nennt die fachliche Ursache. Behebe diese Ursache in der Anwendung, also fehlender Stammsatz, gesperrte Periode oder fehlende Einstellung, und starte die Verarbeitung des vorhandenen IDocs anschließend erneut. Ein neues Anfordern beim Partner ist selten nötig.

Ist ein IDoc dasselbe wie EDI?

Nein. EDI beschreibt den Austausch zwischen Unternehmen und nutzt Formate wie EDIFACT oder ANSI X12. Das IDoc ist die SAP-Seite dieser Kette, die Übersetzung in das jeweilige Marktformat übernimmt ein Konverter.

Kann ich einem Basistyp eigene Felder hinzufügen?

Ja, über eine Erweiterung. Du legst ein eigenes Segment an, hängst es an den Standardbasistyp und füllst es über die vorgesehenen Erweiterungsstellen. Der Standardtyp selbst bleibt unverändert und übersteht damit Upgrades.

Persönlich für dich da