SAP IDOC Tutorial: Definition, Structure, Types, Format & Tables

Details: Last Updated: 25 September 2018

What is an IDOC?

IDOC is simply a data container used to exchange information between any two processes that can understand the syntax and semantics of the data.

In other words, an IDOC is like a data file with a specified format which is exchanged between 2 systems which know how to interpret that data.

IDOC stands for " Intermediate Document"

When we execute an outbound ALE or EDI Process, an IDOC is created.

In the SAP System, I DOCs are stored in database. Every IDOC has a unique number(within a client).

In this tutorial you will learn:

What is an IDOC?
Structure of an IDOC
IDOC Types
What is a Segment?
What is Extension IDOC type?
IDOC Views
Partner Profiles
Port
The Outbound Process
The Inbound Process

Key Features

IDOCs are independent of the sending and receiving systems.(SAP-to-SAP as well as Non-SAP)
IDOCs are based on EDI standards, ANSI ASC X12 and EDIFACT. In a case of any conflict in data size, it adopts one with greater length.
IDOCs are independent of the direction of data exchange e.g. ORDERS01: Purchasing module: Inbound and Outbound
IDOCs can be viewed in a text editor. Data is stored in character format instead of binary format.

Structure of an IDOC

The I doc structure consists of 3 parts -

The administration part(Control Record)- which has the type of idoc, message type, the current status, the sender, receiver etc. This is referred to as the Control record.
The application data (Data Record) - Which contains the data. These are called the data records/segments.
The Status information (Status Record)- These give you information about the various stages the idoc has passed through.

You can view an I-DOC using transaction WE02 or WE05

As seen the screenshot above IDOC record has three parts Control, Data and Status. Let's look into them in detail - Control Record

All control record data is stored in EDIDC table. The key to this table is the IDOC Number
It contains information like IDOC number, the direction(inbound/outbound), sender, recipient information, channel it is using, which port it is using etc.
Direction '1' indicates outbound, '2' indicates inbound.

Data Record

Data record contains application data like employee header info, weekly details, client details etc
All data record data is stored in EDID2 to EDID4 tables and EDIDD is a structure where you can see its components.
It contains data like the idoc number, name and number of the segment in the idoc, the hierarchy and the data
The actual data is stored as a string in a field called SDATA, which is a 1000 char long field.

Status Record

Status record is attached to an I-DOC at every milestone or when it encounter errors.
All status record data is stored in EDIDS table.
Statuses 1-42 are for outbound while 50-75 for inbound

IDOC Types

An I DOC Type, (Basic) defines the structure and format of the business document that is to be exchanged. An IDOC is an instance of an IDOC Type , just like the concept of variables and variables types in programming languages. You can define IDOC types using WE30

What is a Segment?

A Segment defines the format and structure of a data record in I-DOC. Segments are reusable components.

For each segment SAP creates

Segment Type (version independent)
Segment Definition (version dependent)
Segment Documentation

The last 3 characters is the version of the segment

Definitions keep changing as per the version but the segment type remains the same.

Transaction:WE31

What is Extension IDOC type?

An IDOC is of 2 types:-

Basic
Extension

SAP provides many a pre-defined Basic IDOC Types which can not be modified. In case you want to add more data to these restricted basic type you may use an extension type. Most of the times you will NOT use extension.

Documentation

Each IDOC are thoroughly documented in transaction WE60

Message Type

A message represents a specific type of document that is transmitted between two partners Ex. Orders, orders responses, invoices etc

An idoc type can be associated with many message types

Also, a message type can be associated with different idoc types. Transaction WE81

IDOC Views

An IDOC type can be used for more than one message type, which results in IDOCs containing more fields than required for a particular message type.
IDOC views are used to improve performance in generating IDOCs to ensure only the relevant segments are filled with data. IDOC Views are important only for Outbound Processing.

Partner Profiles

A partner is defined as a business partner with whom you conduct business and exchange documents

In the partner profile of a partner that we exchange Idocs with, we maintain the parameters that are necessary for exchanging the data. The transaction used is WE20.

Port

The port defines the technical characteristics of the connection between your SAP system and the other system you want to transfer data with (subsystem). The port defines the medium in which data is exchanged between the 2 systems.

There are different types of ports. The 2 most commonly used are the TRFC ports used in ALE and File ports which EDI uses.

For TRFC ports we have to give the name of the logical destination created using SM59.

When using file port you can specify the directory where the IDOC file should be placed. The other system or the middleware will pick up the file from here. The Function module can be used to generate a file name for the idoc. While Testing you can use "Outbound file" to specify a constant file name. The tab "outbound trigger" can be used to supply information if we want to trigger some processing on the subsystem when an idoc is created at this location. We have to specify the command file name and the directory which has to be run.

This is so CONFUSING!

Let's understand the process of creating an IDOC with an example -

Whenever a Purchase Order (PO) is created we want to send the IDOC to a vendor.
The PO is sent in the form of an IDOC to the vendor (partner). That partner has to be EDI enabled in that system. SAP should realize that it could send doc to this vendor electronically.
The PO sent as an outbound idoc by the customer will be inbound idoc for the vendor. The SAP system on the vendor's side can process this to create an application document (a sales order) on their system.
Quotation, RFQ, PO, SO, Invoice, delivery note etc are some of the commonly exchanged documents through IDOC

The process of data transfer out of your SAP system is called the Outbound process, while that of data moving into you SAP system is called Inbound process. As a developer or a consultant who will be involved in setting up theses process for your organization. Here are the steps how to set them up-

The Outbound Process

Steps Involved -

Create segments(WE31)
Create an idoc type(WE30)
Create a message type (WE81)
Associate a message type to idoc type(WE82)
Create a port(WE21)
If you are going to use the message control method to trigger idocs then create the function module for creating the idoc and associate the function module to an outbound process code
Otherwise, create the function module or stand-alone program which will create the idoc
Create a partner profile(WE20) with the necessary information in the outbound parameters for the partner you want to exchange the idoc with.Trigger the idoc.