IDoc

IDoc, dument, is a SAP document format for business transaction data transfers.^[1] Non SAP-systems can use IDocs as the standard interface (computing) for data transfer.^[2] IDoc is similar to XML in purpose, but differs in syntax. Both serve the purpose of data exchange and automation in computer systems, but the IDoc-Technology takes a different approach.

While XML allows having some metadata about the document itself, an IDoc is obliged to have information at its header like its creator, creation time etc. While XML has a tag-like tree structure containing data and meta-data, IDocs use a table with the data and meta-data. IDocs also have a session that explains all the processes which the document passed or will pass, allowing one to debug and trace the status of the document.

Different IDoc types are available to handle different types of messages. For example, the IDoc format ORDERS01 may be used for both purchase orders and order confirmations.

IDoc technology offers many tools for automation, monitoring and error handling. For example, if the IDocs are customised that way on a particular server, then a user of SAP R/3 system creates a purchase order; this is automatically sent via an IDoc and a sales order is immediately created on the vendor's system.

When this order cannot be created because of an application error (for example: The price per piece is lower than allowed for this material), then the administrator on the vendor's system sees this IDoc among the erroneous ones and can solve the situation. If the error is in the master data at the vendor's system, he can correct them and order the IDoc to be processed again.

Because of the flexibility and transparency of IDoc technology, some non-SAP technologies use them as well.

Structure of the IDoc

An IDoc consists of

• Control record (it contains the type of IDoc, port of the partner, release of SAP R/3 which produced the IDoc etc.)
• Data records of different types. The number and type of segments is mostly fixed for each IDoc type, but there is some flexibility (for example an SD order can have any number of items).
• Status records containing messages like 'IDoc created', 'The recipient exists', 'IDoc was successfully passed to the port', 'Could not book the invoice because..'

IDoc Transactions in SAP

The following transactions can be used to create and process IDocs. The list does not include any transaction required for the development of new IDoc types. Please note that you get a comprehensive list of available transactions by using area menu WEDI.

• WE02 - IDoc List report
• WE05 - IDoc List
• WE09 - IDoc Search for Business Content
• WLF_IDOC - IDoc Processing

This transaction is used to display and edit IDocs.

• WE19 - Test Tool for Idoc Processing
• WE20 - Partner Profile

This transaction determines a processing code based on the partner profile identified by the control record of the IDoc.

• WE21 - Ports in IDoc processing

This transaction identifies an external port (RFC, File, ABAP-PI, etc.) that controls the IDoc flow to an external system.

• WE30 - IDoc Type Development
• WE31 - Development IDoc Segment
• WE32 - Development IDoc View
• WE41 - Outbound process code

This transaction links an outbound processing code specified in a partner profile to a function module.

• WE42 - Inbound process code

This transaction links an inbound processing code specified in a partner profile to a function module.

• BD87 - Inbound processing

This transaction processes outbound IDocs.

Error Handling

SAP provides a standard report (WE02) or (WE05) to display and edit IDocs. Unfortunately, the provided functionality is very basic; therefore, most customers are forced to create their own custom solution..

References

External links

• Introduction into IDoc + references at sdn.sap.com
• IDoc Medic - Error Handling for SAP
• IDoc Basics For Functional Consultants