How-to: SAP IDoc per HTTP empfangen
Nicht nur das Senden eines IDoc, sondern auch das Empfangen ist per HTTP möglich. Beide Richtungen der Datenübermittlung sind unabhängig voneinander konfigurierbar. Um das Empfangen von IDocs per HTTP möglich zu machen, ist es erforderlich, den entsprechenden Dienst zu aktivieren. Was genau zu tun ist, zeigen wir Ihnen in diesem Beitrag.
Service zum Empfangen des IDocs aktivieren
Im ersten Schritt aktivieren Sie den Service „idoc_xml“. Dazu wird die Transaktion SICF (Pflege der Services) aufgerufen und nach dem Hierarchie-Typ „SERVICE“ gefiltert.
Pflege der Services – Einstiegsbildschirm
Im darauffolgenden Fenster können Sie nach dem Servicenamen „idoc_xml“ filtern und den Service per Rechtsklick auf „Service aktivieren“ aktivieren. Der Service befindet sich in dem Pfad default_host\sap\bc\.
Pflege der Services – Aktivierung idoc_xml
Hinweis
In der Partnervereinbarung muss der entsprechende Eingangsparameter für den Dokumenttyp gesetzt sein. Dies ist in der Transaktion WE20 für den beteiligten Partner möglich.
Test: Empfangen des IDocs
Zum Testen können Sie die App „Postman“ aus dem Chrome Web Store verwenden. Mit Hilfe dieser App können Sie ein HTTP-Request an das SAP-System senden und den erfolgreichen Eingang überprüfen. In Postman geben Sie die Request URL in folgender Form ein:
http://[System-Adresse]:[Port]/sap/bc/idoc._xml?sap-client=[clientnr]
Falls erforderlich, können Sie im Reiter „Autorisierung“ die Zugangsdaten pflegen. Im Reiter „Body“ wird das IDoc als XML eingefügt. Über die Schaltfläche „Send“ senden Sie die Anfrage an das SAP-System.
Postman Konfiguration
In Postman sehen Sie bei erfolgreicher Übermittlung den Status „200 OK“. Dies bedeutet, dass die Übermittlung des IDocs an das SAP-System erfolgreich war.
Ergebnis – Postman
Im SAP-System können Sie sich das Ergebnis in der Transaktion WE02 anzeigen lassen. Dort befindet sich nun ein eingegangenes IDoc. Dieses IDoc findet man unter dem entsprechenden Dokumententyp. Dort erhält man über den Status Informationen über den Verarbeitungsstand innerhalb von SAP.
Ergebnis – SAP-System
Wir unterstützen Sie dabei, Schnittstellen in Ihrer Systemlandschaft optimal zu konfigurieren, zu administrieren und zu überwachen – und typische PI-Herausforderungen souverän zu meistern.
Spezialfall: Statusänderung
Ein Spezialfall eines eingehenden IDoc ist eines vom Typ STATUS. Dieser Typ eignet sich dafür, den Status eines bestehenden IDoc zu verändern. So kann zum Beispiel ein System, das ein IDoc empfangen hat, eine Rückmeldung über den Verarbeitungsstand geben. Damit das SAP-System ein solches IDoc verarbeiten kann, müssen Sie die entsprechende Partnervereinbarung anpassen. In der Partnervereinbarung muss in den Eingangsparametern der Nachrichtentyp STATUS hinzugefügt werden. SAP liefert den entsprechenden Vorgangscode „STA1“ direkt mit. Ein Beispiel für ein Statusupdate im XML-Format könnte wie folgt aussehen:
XML Statusupdate
Die entscheidenden Elemente sind dabei diejenigen, die das Statusupdate enthalten. Im Element <E1Stats> werden alle Informationen gesammelt. Dazu gehören:
- die Nummer des zu ändernden IDoc (<DOCNUM>)
- Datum und Zeit der Änderung (<LOGDAT>, <LOGTIM>)
- der Status, den das IDoc bekommen soll (<STATUS>)
Durch die Angabe des Vorgangscodes im Eingangsparameter wird die Statusänderung automatisch verarbeitet. Im Beispiel wird der Status auf 12 gesetzt:
Erfolgreiche Statusänderung
Auf diese Art und Weise können SAP-Systeme und auch Nicht-SAP-Systeme eine Rückmeldung zu einem IDoc geben.
Wie Sie das Versenden eines IDoc per HTTP konfigurieren können, erfahren Sie hier.
Websession: IDoc
Haben Sie noch weitere Fragen zum Empfangen von IDocs per HTTP oder generell zum Thema IDoc? Vereinbaren Sie gerne einen unverbindlichen Termin mit unseren Experten und wir besprechen Ihr Anliegen.
Dieser Artikel erschien bereits im Februar 2017. Der Artikel wurde am 20.11.2025 erneut geprüft und mit leichten Anpassungen aktualisiert.
FAQ
Wie kann das Empfangen von IDocs per HTTP aktiviert werden?
Um den Empfang von IDocs per HTTP zu ermöglichen, müssen Sie den Service „idoc_xml“ aktivieren. Dies erfolgt über die Transaktion SICF, indem der Service im Pfad default_host\sap\bc\ gefiltert und aktiviert wird.
Welche Schritte sind notwendig, um das IDoc per HTTP zu testen?
Zum Testen der IDoc-Übermittlung können Sie die App „Postman“ verwenden. Geben Sie in Postman die URL im Format http://[System-Adresse]:[Port]/sap/bc/idoc._xml?sap-client=[clientnr] ein, fügen Sie das IDoc als XML im Reiter „Body“ ein und senden Sie es. Bei erfolgreicher Übermittlung zeigt Postman den Status „200 OK“ an.
Wie kann ich den Status eines IDocs ändern?
Eine Statusänderung eines IDocs erfolgt über den Nachrichtentyp „STATUS“. Der XML-Datenbestand muss das entsprechende Statusupdate enthalten, und in der Partnervereinbarung muss der Nachrichtentyp „STATUS“ hinzugefügt werden, damit das SAP-System den Status ändern kann.
Wo kann ich den Erfolg des Empfangs eines IDocs einsehen?
Den Erfolg der IDoc-Übermittlung können Sie in der Transaktion WE02 im SAP-System überprüfen. Dort ist das empfangene IDoc unter dem entsprechenden Dokumententyp sichtbar, und der Status des IDocs gibt Auskunft über den Verarbeitungsstand im SAP-System.
