CA210
EDI Interface
SAP AG 1999
System R/3
Release 4.6B
September 2000
Mat. No.: 5004 1963
Copyright
SAP AG 1999
Trademarks:
Microsoft ®, Windows ®, NT ®, PowerPoint ®, WinWord ®, Excel ®, Project ®, SQL-Server ®,
Multimedia Viewer ®, Video for Windows ®, Internet Explorer ®, NetShow ®, and HTML Help ®
are registered trademarks of Microsoft Corporation.
Lotus ScreenCam ® is a registered trademark of Lotus Development Corporation.
Vivo ® and VivoActive ® are registered trademarks of RealNetworks, Inc.
ARIS Toolset ® is a registered Trademark of IDS Prof. Scheer GmbH, Saarbrücken
Adobe ® and Acrobat ® are registered trademarks of Adobe Systems Inc.
TouchSend Index ® is a registered trademark of TouchSend Corporation.
Visio ® is a registered trademark of Visio Corporation.
IBM ®, OS/2 ®, DB2/6000 ® and AIX ® are a registered trademark of IBM Corporation.
Indeo ® is a registered trademark of Intel Corporation.
Netscape Navigator ®, and Netscape Communicator ® are registered trademarks of Netscape
Communications, Inc.
OSF/Motif ® is a registered trademark of Open Software Foundation.
ORACLE ® is a registered trademark of ORACLE Corporation, California, USA.
INFORMIX ®-OnLine for SAP is a registered trademark of Informix Software Incorporated.
UNIX ® and X/Open ® are registered trademarks of SCO Santa Cruz Operation.
ADABAS ® is a registered trademark of Software AG
The following are trademarks or registered trademarks of SAP AG; ABAP™, InterSAP, RIVA, R/2,
R/3, R/3 Retail, SAP (Word), SAPaccess, SAPfile, SAPfind, SAPmail, SAPoffice, SAPscript,
SAPtime, SAPtronic, SAP-EDI, SAP EarlyWatch, SAP ArchiveLink, SAP Business Workflow, and
ALE/WEB. The SAP logo and all other SAP products, services, logos, or brand names included
herein are also trademarks or registered trademarks of SAP AG.
Other products, services, logos, or brand names included herein are trademarks or registered
trademarks of their respective owners.
The R/3 Integration Model
SD FI
Sales & Financial
Distribution Accounting
CO
MM Controlling
Materials
PP Mgmt AM
R/3
Production Asset Mgmt
Planning
QM Client / Server PS
Project
Quality
Mgmt
PM ABAP WF
System
Plant Main-
Workflow
tenance
HR IS
Human Industry
Resources Solutions
SAP AG 1999
SAP's R/3 System has set new norms for standard software that can be universally implemented.
R/3 uses advanced development techniques to achieve comprehensive integration of business
administration and data processing.
R/3 combines state-of-the-art technology with comprehensive business administration functionality
to provide a fully integrated business solution for your company.
Business Integration Technologies I
Level 2 Level 3
BC600 2 days BC601 5 days BC610 3 days
SAP Business Build and Use Workflow
SAP Business SAP Business
Workflow - Introduction Workflow - Programming
Workflow
BC615 3 days
SAP ArchiveLink BC670 2 days
BC095 3 days Programming Display
Business Integration Functionality Archiving
Technology
BC660 3 days BC680 2 days
BC400 5 days Data Archiving Data Retention Tool
(DART)
ABAP Workbench
Concepts and Tools
SAP AG 1999
Business Integration Technologies II
Level 2 Level 3
BC619 3 days
Application Link
Enabling (ALE)
Technology
BC620 2 days BC621 1 day
SAP IDoc Interface SAP IDoc Interface - Data Exchange
Technology Development
CA150 2 days
Building Enterprise BC420 5 days
Solutions with SAP Data Transfer
Components BC415 2 days
Communication
CA925 5 days Interfaces in ABAP Interface
Programming with Programming
BAPIs in Visual Basic CA926 5 days
Programming with
CA927 5 days BAPIs in JAVA
R/3 Interface and BAPI
Programming in C++
SAP AG 1999
Course Prerequisites
SAP AG 1999
Target Group
Audience:
Project team EDI analysts responsible for implementing EDI
Duration: 4 days
SAP AG 1999
Contents:
Course Goals
Course Objectives
Course Content
Course Overview Diagram
Main Business Scenario
Course Introduction
SAP AG 1999
SAP AG 1999
SAP AG 1999
Preface
Exercises Appendices
Solutions
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
Contents:
EDI location in SAP
IDoc Overview
Overview of EDI Interface
SAP AG 1999
SAP AG 1999
2
X1 T
EDIFICE
ELFE
C
IFA
ED
CEFIC
HL7
PHOENIX
ARUA
GALIA EANCOM
ODETTE GENCOD
VDA TRADACOMS
UCS II, WINS
SEDAS
BAI, BAI2
ATA SPEC2000 MultiCash
AECMA SPEC2000M S.W.I.F.T.
HBCI
SAP AG 1999
SAP AG 1999
SAP EDI is a cross-application function that is delivered with the SAP Basis component.
SAP EDI allows for Electronic Data Interchange between your company and your trading partners.
In the following chapters you will learn how to configure SAP EDI and enable your partners with the
R/3 Applications.
System 1 System 2
Document IDoc Document
message oriented
asynchronous
SAP AG 1999
IDoc is an SAP Standard format for data exchange between systems. IDoc means Intermediate
Document, and is intermediate in two senses:
Message oriented - Data reside in the applications as well, only in other formats (the application
documents). The IDoc stands between these application documents, as a language, spoken by the
communicating applications. It does not matter whether the application is programmed by SAP or
by another foreign system.
Asynchronous - Data can already reside in IDocs before an application document is created. This
is important, for instance, when wrong data were transmitted: In this case, the application
document shall only be created when the data are corrected.
The IDoc interface is available in R/3 starting with Release 2.1A, in R/2 starting with Release 5.0F.
WWW
message Internet
Intranet
R/2 System
ICR/OCR
Document
ALE IDoc
EDI
EDI Message
Message
SAP AG 1999
SAP AG 1999
The intermediate document, or IDoc, interface was designed by SAP application developers.
It is independent of any EDI standards, and is also independent of any EDI subsystem (translator).
Document
IDoc
SAP System R/3 SAP System R/3
IDoc IDoc
Transaction
EDI Subsystem Message EDI Subsystem
SAP AG 1999
Business partners exchange business documents on a logical level, this is physically achievable by
means of letters, fax or phone. All those methods have one thing in common: the technical structure
of the documents get lost, and the recipient has to re-enter the information in their system.
With EDI the technical structure of the document is retained. This enables the recipient to
automatically process the document using their business software. Since both partners are
independent, they will make independent decisions on their IT infrastructure and their business
software. Hence EDI standards are required, to map from the application data structure of the sender
into the EDI standard, and from the EDI standard into the application data structure of the recipient.
This means the partners stay independent.
The IDoc is the data structure of the SAP application at the interface. This gives a unified interface to
any EDI subsystem regardless of the SAP module, which creates or receives the messages.
By linking SAP systems directly, IDoc can be transmitted without a mapping into EDI standards.
This is the ALE (Application Link Enabling) approach. Partners are, in a technical sense, linked
together, which means they loose some of the independence of their IT infrastructure.
The IDoc format can be considered an EDI standard when used for EDI. However, translating IDocs
into other standards has the advantage of communication with more partners.
The advantage of IDocs is that the SAP applications only have to know the format IDoc - not several
EDI standards and thus, are more easily maintained. The disadvantage is that an EDI Subsystem
must be bought when other EDI standards are to be used.
Application MM Application
SD
...
SAP AG 1999
Please read the left (outbound) from top and the right (inbound) from bottom.
Message Control is in use with transactions of the supply chain, applications MM and SD, in
outbound processing.
Workflow is conditional with all inbound processing by all SAP applications.
Nevertheless Workflow is in use with all SAP applications to report on exceptions in the
implemented processes. For details please refer to the notification and monitoring section.
R/3
R/3 System
System
Create IDoc
Receive Data
do further processing
External
External System
System
SAP AG 1999
In the following, data flow is always viewed from the R/3 system. Therefore, if data is sent from an
R/3 system to an arbitrary external system, this is called outbound processing, or simply outbound.
Outbound processing comprises
Creating the application document
Creating the respective outbound IDoc
Finding the partner and port
Passing the IDoc to the external System via the Port.
R/3
R/3 System
System
Partner
Message Create application document
Profile
Control General
Settings
Create IDoc
Archive Port
IDocs ? Description,
Check Partner, find Port Partner Profile
EDI Documentation
Subsystem ? Tools
Receive Data
do further processing
External
External System
System
SAP AG 1999
External System
no
Ok? no
Error handling
R/3-System
R/3-System
SAP AG 1999
Data reception from an external system plus data processing within the R/3 system is called inbound
processing or, simply, inbound.
Inbound processing comprises:
data takeover from an external system via an inbound port
creating the inbound Idoc(s)
finding the correct processing type via the partner profiles
creating the application document(s)
If an error occurs, error handling (more general: exception handling) starts. This is another kind of
processing and is not only connected to inbound processing.
External
External System
System
EDI Documentation
Subsystem? Pass Data to R/3 system Tools
Port
Archive
Description,
IDocs ? Check Partner, create IDoc
Partner Profile
SAP AG 1999
NOE Food Company must setup its IDoc interface for inbound processing.
The Documentation tools tell the EDI Subsystem which IDoc types it must understand.
The port name must appear in the Port description; otherwise, the IDoc is not accepted.
In the Partner Profiles, NOE Food enters Smartmart as an Inbound Partner for the message
ORDERS. In addition, responsible agents for error processing are entered here, specific for Partner
and message.
In the general settings, NOE Food defines responsible agents which are notified in the case that no
agent could be found from the partner profiles. This is the case when the inbound IDoc originates
from someone which is not defined as a partner in the partner profiles.
As with Smartmart, NOE Foods wants to archive and, afterwards, delete inbound IDocs which are
completely processed.
SAP AG 1999
SAP AG 1999
Contents
IDoc record types
IDoc and IDoc type
IDoc processing: inbound and
outbound direction
SAP AG 1999
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
Application
Control record
Data record
Administrative Segment
Section
Status record
EDI subsystem
SAP AG 1999
This graphic represents the IDoc as the interface between the EDI subsystem and the R/3 application.
It is very important to note that the IDoc is data stored in a structured format - it is not a process or
any kind of executable code.
An IDoc structure can be used to support multiple message types, for example the data in a sales
order is very similar to the data in a purchase order, therefore both of these message types can use
the same IDoc format.
Record structure
control section (key) and data section
identical for outbound and inbound processing
Fields in the data segments according to EDI standards
field length
field type
field values
Application programming interface (API)
creation of IDocs
processing of IDocs
status log
SAP AG 1999
Field lengths and types are compared with the data element directories of
UN/EDIFACT,
ANSI X12 and
SAP’s data repository
Codes for coded fields are taken from international standards where the standard applies. For
example - Country codes, currency codes, and unit of measure codes use the ISO (International
Standards Organization) codes.
SAP AG 1999
IDocs are stored in three tables in SAP. They are stored by record type. The three IDoc tables are:
EDIDC- control records
EDID4 - data records from release 4.x onward
EDID2 - data records from release 3.0C to 3.1I
EDIDD - data records from release 2.0A to 3.0B
EDIDS - status records
Control record
Data records
Status records
SAP AG 1999
SAP AG 1999
The IDoc-ID is an important part of the control record. It is a simple number which is internally
generated. It uniquely identifies the IDoc in the R/3 system. Status reports always refer to that
number.
The control record also contains the key fields of the partner profile: partner and logical message (3
fields each) as well as a test flag. For inbound IDocs, these key fields determine the dependent
parameters of the inbound partner profile, e.g. which was the IDoc should be processed within the
R/3 system.
The three key fields of the partner (e.g. the receiver for outbound IDocs) are:
number (In the R/3 system, this is the master data number which may be internally generated)
type (customer, vendor, bank or logical system in ALE scenarios)
role (important for outbound processing via message control)
The three message fields are:
message type (if possible, follows UN/EDIFACT notations). For example, ORDERS, INVOIC
code (optional)
function (optional; e.g. changed message)
Other fields are related to mapping IDocs to another EDI standard, e.g. the EDI standard structure or
the EDI message archive.
Data record
Control area, contains Application Data
segment name Field 1 Field 2 ...
Segment
SAP AG 1999
The control area of a data record contains the name of the segment. In the R/3 system, the segment is
defined as a structure, i.e. a series of fields of certain length and data type. Generally, one segment
field is related to one application field.
The application data area of a data record is a single field of 1000 bytes. This is where the
application data resides.
By virtue of the segment name field in the control area, the unstructured application data field of the
data record gets its structure. This always happens when the application writes data into the IDoc or
reads data from the IDoc, because data transfer occurs through the segments.
The data type of the segment fields is character.
If possible, coded fields abide by ISO rules.
SAP AG 1999
The IDoc number is an important part of the status record. It points to the IDoc to which the status
records belong. Thus, it is possible that status records can be transferred separately and still be
attached to the right IDoc.
First, status information is given by the status value, or simply status, a two-digit number assigned to
a well defined process step.
More detailed information is given by three fields naming an R/3 message. If, for instance, a
processing error occurs, the error message can be included in the new status record reporting the
error situation.
Consider the message SAPEA211; the three fields then take the following values:
- SAP: R/3 message displayed in a standard window (Field STAMQU)
- EA : message class as defined in table T100 (Field STAMID)
- 211 : message number as defined in table T100 (Field STAMNO)
If STAMQU describes messages defined by an external system, messages of that system may be
displayed in a special way. To that end, a special display program must be written and be entered
into table TEDE3.
Other fields of the status record are the date and time when the record was created, and the name of
the program that created it.
Data records
SAP AG 1999
Control Record
E1HDDOC E1TLSUM
M 1 C 2
E1HDADR E1ITDOC
C 5 M 1
E1ITSCH
C 99 C 5
Status records
SAP AG 1999
Each business process (e.g. a purchase order) is transferred by a special IDoc type which can hold
the relevant data.
An IDoc type is defined through its segments, their hierarchy, order and repeatability. This
information is part of the control area of the data records.
The segment hierarchy can be visualized in a tree as parent and child segments. It gives structure to
the application data.
In conclusion: IDoc types are special data structures tailored to special applications or messages. If
such a structure is filled with application data, an IDoc is created (the instance of the IDoc type).
SAP application
R/3 System
External System
Outbound direction Inbound direction
SAP AG 1999
Directions are always defined as viewed from R/3. Thus, in the outbound direction, IDoc data are
transferred from the application via the IDoc interface to the external system. The inbound direction
processes data from the external system via the IDoc interface to the application.
For inbound processing, the external system must have certain authorizations since it will be creating
documents (IDocs and application documents) within the R/3 system.
Both the inbound and outbound processing directions have multiple ways of processing. These are
explained in the following slides.
SAP application
Document
NAST
record
IDoc
External System
SAP AG 1999
SAP Application
Master
IDoc
External System
SAP AG 1999
During direct outbound processing with ALE scenarios, the ALE services are always called. The
services:
filter the IDoc. Segment fields containing data not necessary for the recipient system are removed
from the IDoc
change the (segment) version. If the recipient system is on an earlier release of SAP or is using an
earlier version of a segment in the IDoc type, the version can be changed here. This means that
less data is transported, since later versions of segment can only contain more fields than former
versions and never less fields.
Occasionally split the IDoc into several IDocs. The can happen in ALE distribution scenarios,
where more than one system receives the data.
To achieve these tasks, the ALE services transform one Master IDoc (passed to the function module
MASTER_IDOC_DISTRIBUTE into one (or more) Communications IDoc(s). Only
Communication IDocs are saved in the database.
The process is slightly different for IDocs created from the FI (financial) area of R/3. A master IDoc
is not created and the ALE services are not called. However, the IDocs are processed through the
IDoc interface to the external system.
External System
IDoc
IDoc +
Process
SAP Application
SAP AG 1999
The external system sends IDocs to the R/3 system via a port name which is defined in R/3. The port
name of the R/3 system can be SAP<SID>CLNT<XXX> e.g. SAPC11CLNT810 for an R/3 system
C11 and client 810.
If the IDoc interface knows the external system (as an inbound port), it accepts the inbound IDocs
and starts processing: For instance, it performs a syntax check and tries to find the IDoc sender,
found in the control record, in the partner profile.
The partner profile determines if the IDoc is directly passed to the application (ALE function
module) or if a workflow is started. If a workflow is started, the ALE services may be called before
the inbound IDocs are stored in the database.
External System
IDoc
IDoc
SAP Application
SAP AG 1999
During direct inbound processing, the ALE services are always called. As in the outbound case, they
can do filtering and change versions. However, inbound IDocs cannot be split.
The ALE processed IDoc is stored in the database. This is called an application IDoc as opposed to
the communication IDoc of outbound processing.
The ALE services can also be called when workflow is invoked.
SAP AG 1999
IDocs are used to move data into and out of the SAP system. It is
therefore necessary to understand what their components are and how
they are used in the SAP system.
1-2 What are the three records types within the Intermediate Document?
___________________________________________________________________
___________________________________________________________________
___________________________________________________________________
1-3 Which IDoc record type contains the data which is used to determine the partner
profile information and the direction the data is to travel (into/out of SAP)?
___________________________________________________________________
1-4 The ____________________ is the main key that links the three record types
within an IDoc.
1-5 Are different IDoc types used for inbound messages as opposed to outbound
messages?
___________________________________________________________________
1-10 Does SAP have a different IDoc type for each transaction or document in R/3?
___________________________________________________________________
___________________________________________________________________
___________________________________________________________________
1-1 An IDoc type is a hierarchical structure containing segments which have fields
that hold application data taken from the SAP database, or application data
which is to create an application document in SAP. Examples are ORDERS02
and MATMAS01, which contain segments that relate to order information and
material master information respectively.
1-2 The three records types within an Intermediate Document (IDoc) are the control
record, data record, and status record.
1-3 The control record contains the fields, which are the keys to the partner profile,
and the direction field value indicates whether the IDoc is outbound or inbound.
1-4 The IDoc ID (number) is the main key that links the three record types within an
IDoc.
1-5 No. The same IDoc types can be used for inbound and outbound messages.
1-6 An IDoc type is a structure which is defined by its segments, hierarchy, order and
repeatability. It is meant to indicate the type of data that will be found in an
IDoc. An IDoc is an instance of an IDoc type with the structure filled with the
application data and assigned an IDoc ID (number) and housed in the IDoc
tables.
1-7 False only the control record and the data records are sent out of SAP. Status
records are sent into SAP to update an IDoc.
1-10 No. The IDoc type represents a series of related business documents. For
example, the MM outbound PO, the SD inbound PO, the SD outbound Order
Confirmation and the MM inbound Order Confirmation all use IDoc type
ORDERS01, which contains the structure for order information.
Contents:
Units of Measure
Logical System
Number Ranges
Process Technology
Workflow Customizing
Event Receiver Linkage
IDoc Administration
Proposal Values for Partner Profile
Map Long Names to Short Names
SAP AG 1999
SAP AG 1999
Payment/Remittance
Port Definitions 4 Process 11
Price Catalog, Inventory
Partner Profiles 5 Advice 12
MM EDI Application
Requirements 6 Test of Processing 13
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
R/3 Customizing
IMG
Basis Components
Basis Services
IDoc
IMG Documentation
Interface
Project Documentation
Project Management
Activities
SAP AG 1999
For the IDoc interface, general parameters can be set using the IMG. The IMG is an implementation
guide helping you to customize your R/3 system according to your needs. Maintaining the relevant
customizing tables is done in activities.
By selecting the appropriate attributes, users can display only the activities that are required in each
case. For example, if a customer wishes to adopt all SAP standard settings, only the activities with
the attribute ”required” must be executed.
The IMG node or path for the IDoc Interface is Basis Components --> Basis Services -->IDoc
Interface / Electronic Data Interchange. You should read the IMG documentation, which is available
for each activity (double-click on the relevant document).
You can also create your own projects from the standard IMG : projects are a type of view of the
standard IMG, which are used by different teams. The IMG offers project management functions
(resource planning, etc.), as well as functions for creating your own project documentation via
customer notes.
CS CSE
CS BOX
CS CSE
CS CAR
SAP AG 1999
There are several fields that may be in the IDoc that are presumed to follow International Standards
Organization values. These fields are currency, country, and unit of measure.
The ISO Unit of Measure may or may not be the same as the SAP internal unit of measure.
Additionally, the trading partner may or may not be following the ISO standard for unit of measure.
It may be necessary to configure additional ISO unit of measure codes to associate with the SAP unit
of measure code.
In the configuration of the SAP unit of measure, there are two fields of interest. The ISO code field is
where the association is made between the ISO unit of measure code and the SAP internal unit of
measure code. The other field is the Primary code field. This is used for inbound information to
determine which single SAP internal unit of measure will be assigned.
For outbound information, many SAP internal units of measure can translate to a single ISO unit of
measure code. The ISO code is placed in the IDoc.
For inbound information an ISO unit of measure code will translate in a single SAP internal unit of
measure code which has the primary code checked.
PR1 PR2
client 100 client 200
SAP AG 1999
A logical system is a way to name each system/client combination in the system landscape. It is the
way to address where information is being sent to or received from.
All EDI transactions are ALE enabled and ALE technology requires the use of a logical system.
The typical naming convention for logical systems is:
system id CLNT client
All clients in a system must have a unique logical system name. It is also true that the same clients
on different instances must have unique logical system names. For example: DEV client 100 could
be named DEVCLNT100, and PRD client 100 could be named PRDCLNT100.
It is usually the function of the Basis systems people to create logical system names and assign them
to each client.
IDoc Interface
[…]
SAP AG 1999
Number ranges are intervals of natural numbers which are assigned to objects by the R/3 system.
This is called “internal number assignment”.
In the IDoc interface, number ranges are set for:
IDocs: The IDoc number is taken from this number range
Ports: These numbers identify the tRFC ports
Mailbags: Mailbags are only used when communicating with an R/2 system. Here, IDocs are
communicated in mailbags. Note that this item only exists prior to release 4.5x
These number ranges are set in the IDoc interface IMG component.
SAP AG 1999
SAP AG 1999
System process code EDIR is used for notification of negative status values of status reports.
The advantage that EDIR has over EDIS is that further processing of incorrect IDocs is possible.
This activity is only required when upgrading to 4.6x. If this is a new installation then EDIR status
code is already assigned.
This item can be run as a simulation run and then as the actual run.
SAP AG 1999
IDoc Interface
Event
Processing
R/3 Application
SAP AG 1999
When IDocs are received, they are first stored in the database. In a second and independent step, they
are processed further (an exception to this rule is the port type “tRFC”, where processing takes place
in one step). This is made possible through the workflow event concept. When IDocs are stored in
the database, an event is created which waits for its “receiver” in the system. The receiver (a function
module) finds the event and starts further inbound processing. Through this step, the function
module has consumed the event: It is no longer there in the system. It is up to the workflow manager
to decide when the consumer starts to look for events. Thus, saving IDocs and processing them
further is separated in time (“asynchronous processing”).
To enable this new form of inbound processing to take place, the corresponding event must be
actively linked to the receiver.
You must therefore activate the event-receiver linkage in the IMG for the IDoc Interface.
SAP AG 1999
The IDoc Administrator is always notified when an error occurs during IDoc processing and no
partner profile could be found. Otherwise, the partner-specific agent (and the message-specific agent,
if required) entered in the partner profile is notified.
In the system environment, the IDoc Interface is informed whether non-Basis components exist, e.g.
Message Control or application components. If these entries are not made, it is possible that the IDoc
Interface may call function modules, for example, which do not exist in the specified system (Basis
system only).
Precessing details:
The maximum number of syntax errors that can be recognized in one IDoc and therefore logged as
status records. The larger this value, the higher the probability that the error messages do not refer
to ”real” errors, but only subsequent errors.
Whether or not inbound processing is triggered synchronously (not via the event-receiver linkage)
(port type File).
System parameters can be entered as ”global parameters” from the IDoc Interface initial screen by
selecting Control -> IDoc Administration or from the IMG for the IDoc Interface.
You should use the F1 Help function for the entry fields.
Tests
Documentation Tools
IDoc Lists (4.0x - 4.5x only)
IDoc Display (4.0x - 4.5x only)
Development (4.0x - 4.5x only)
SAP AG 1999
User-specific parameters of the IDoc interface cannot be set in the IMG. Instead, choose transaction
code WE46 from the entrance menu of the IDoc interface.
The parameters for monitoring the IDoc data flow are display parameters.
The port value is a test parameter, which is proposed as standard by the test programs.
For the documentation tools, you should define the default documentation output, for example,
whether the individual segment fields are also to be included in the documentation of IDoc types.
You can enter a default development class for the development of IDoc types and segments. Course
BC621 contains more information about developing and defining IDoc types.
Monitoring parameters are for layout.
Proposal Value
SAP AG 1999
For quick definition of the partner profile, you set up templates in the IMG.
The templates are set per partner type and direction.
Press the button templates from within the partner profile (transaction WE20) to get the templates for
your actual direction and partner type. Then, modify the defaults according to your needs.
Since partner profiles require a port, you can also define a port in the IMG. Note this item is only
valid through release 4.5x.
In the IDES system, the following message types are set for the vendor or customer, depending on
the direction:
DELINS - forecast/JIT delivery schedule
ORDCHG - change purchase order/sales order
ORDERS - purchase order/sales order
DESADV - shipping notification
INVOIC - invoice/billing document
ORDRSP - order confirmation
SAP AG 1999
Release 4.0 introduced the extended namespace. IDoc interface objects (e.g. IDoc types) new to 4.0
can have longer names than before.
This fact can lead to problems when communicating with older releases, which understand only short
names. If needed, tables must be maintained which map short names to long names and vice versa.
These mapping tables are maintained in the IMG or from the development menu of the IDoc
interface. From the relevant object (IDoc types or segments), choose transaction code WE70 for
Basic IDoc types, WE71 for Extension IDoc types, WE72 for IDoc types or WE73 for Message
types. Also note the online IMG documentation.
SAP AG 1999
IDocs are used to move data into and out of the SAP system. It is
therefore necessary to understand what the general customizing is for
IDoc processing no matter which direction IDocs are going. This
setup is also independent of the use of the IDoc (EDI, ALE, Internet).
1-1 How many different number ranges can be set up for IDoc processing and what are
they?
____________________________________________________________
____________________________________________________________
1-2 How many different number ranges are used for numbering IDocs?
____________________________________________________________
____________________________________________________________
1-4 Which port type does not make use of the event receiver linkage?
____________________________________________________________
____________________________________________________________
1-8-1 Releases of SAP older than 4.0x can understand the long names of Logical
Messages, Basic IDoc Types, Extensions, IDoc Types, and Segments?
______________________________________________________
______________________________________________________
2-1-1 For Test using file interface use Group## for the Testport.
2-1-2 For Output as C header file use C:\Temp\ for the local directory and a local
file w/o extension name of IDoc.
1-2 Only one number range is used to number IDocs no matter whether they are
going into or out of the SAP system. It also does not matter if the IDoc is being
used for EDI, ALE or the Internet.
1-3 If IDocs are to be processed inbound and not synchronously or through the tRFC
port, then IDocs are processed through the workfow event concept. The event
receiver linkage starts the workflow event when inbound IDocs are brought into
the SAP system.
1-4 The tRFC port does not require the event receiver linkage to be executed.
1-5 The IDoc Administrator is important because it is the party to notify when the
party to notify cannot be determined from the message specific partner profile or
the general partner profile.
1-6 When the SAP system is upgraded from 2.1x/2.2x to 3.0x and beyond.
1-7 The use of templates for partner profiles allows for fast entry of partner profiles if
all trading partners have the same messages inbound and/or outbound.
1-8 False. Starting with Release 4.0x the Logical Message, Basic IDoc Types,
Extensions, IDoc Types and Segments increases their length to 30 characters
from 6 – 8 characters prior to 4.0x. If IDocs are sent to earlier releases they only
know the shorter names. Thus there is a series of tables which connect long
names to short names.
Select the [Display <>Change] button and click on the Test tab.
2-1-1 For Test using file interface use enter your Group## in the TestPort field.
2-1-2 Select Documentation tab and enter the following information for C-Header
output:
C-header output
Field Name Input Data
Local directory C:\temp\
Local file w/o extension IDOC
Contents:
Port types and their typical fields of use
Port description
Communication with older releases
SAP AG 1999
SAP AG 1999
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
SAP Application
File
tRFC CPI-C MIME ABAP XML
+ RFC
EDI ALE EC
R/2 Internet Any
Any Any Any
2.1 on 3.1 on 4.5 on 4.6 on
3.0 on 3.0 on
SAP AG 1999
The IDoc interface offers 6 different communication channels, defined by the appropriate port types,
within system R/3.
Port type File - Transfer of information via files and synchronous RFC for triggering of the
destination by the source. This allows transfer of IDoc data and the status report.
Port type tRFC - Transfer of all information via (asynchronous) transactional RFC. This is the
preferred method in ALE scenarios and allows transfer of IDoc data.
Port type CPI-C - Transfer of all information via CPI-C. This option is in use only with system R/2
coupling based on the R/2-IDoc interface as released in R/2, 5.0F. This allows transfer of IDoc data
and the status report.
Port type Internet - Transfer of all information via the Internet as MIME attachment. This allows
transfer of IDoc data.
Port type ABAP - Transfer of all information with customer specific program logic. This is thought
to be a Project-Exit for any unforeseen communication channel. IDocs are exchanged as tables with
an internal R/3 function module. This is the only port type where IDocs don‘t leave the R/3 system.
The function module is customer written and can do anything with the IDoc.
Port type XML - Transfer of all information via XML compatible files, including DTD if requested.
This port type is released as prototype, changes and enhancements are expected for future releases.
RFC Destination
(TCP/IP Connection)
rfcexec
out.script
Outbound Trigger
Outbound File
IDoc File
Inbound File
Status Report
Status File
SAP AG 1999
The IDoc interface port description holds technical communication parameters. To make a port
useable, further parameters outside of the IDoc interface have to be set.
Name and directory of the outbound trigger (a.k.a. command file pre-4.6x) (called by rfcexec) which
starts the external system. This must be set if the R/3 system is to start, or trigger, the external
system (by RFC). For triggering, one needs to define an RFC destination (e.g. SERVER_EXEC).
This is done with transaction SM59 (TCP/IP connections). This setup is usually done by Basis.
Outbound - Directory name - specify a physical directory path or a logical directory path (new with
Release 4.6x). File name - determined via a static name or via a dynamic name based on a function
module (recommended).
Inbound - Directory name - configuration can be optional based on parameters used by the external,
sending system. If the inbound parameters are set here, they serve as default parameters for the test
tools. As with the outbound parameters, a physical directory path or a logical directory path (new
with Release 4.6x) can be specified. File name - determined via a static name (most commonly used
configuration) or via a dynamic name based on a function module.
Status - Directory name - configuration can be optional based on parameters used by the external,
sending system. If the status parameters are set here, they serve as default parameters for the test
tools. As with the outbound and inbound parameters, a physical directory path or a logical directory
path (new with Release 4.6x) can be specified. File name - determined via a static name (most
commonly used configuration) or via a dynamic name based on a function module.
It is important that the port exists even if it is only used for the inbound process, since the IDoc
interface only accepts known port types.
IDoc Interface
Write RFC 4 3
1 2 Read RFC
rfcexec startrfc
IDoc File
IDoc File Status Report in.script
out.script status.script
Read Call 1 2
4 3 Write Call
Subsystem
SAP AG 1999
Outbound direction:
Step 1: The IDoc interface creates a new file and fills it with one or more IDocs.
Step 2: The IDoc interface calls the C program rfcexec, handing over the path to an executable
script (e.g. out.script) and name and location of the IDoc file.
Step 3: out.script calls the external system, passing the IDoc file name and location.
Step 4: After successfully processing, the external system must delete the IDoc file.
Inbound direction for IDocs and status report:
Step 1: The external system creates an IDoc file.
Step 2: It starts the R/3 system via the C program startrfc. Startrfc contains the logon parameters
and the name of the function module, the (ínbound) port and the IDoc file path. The startrfc
command can be held in an executable script (e.g. in.script). It is important that the calling system
is known as an R/3 user who has the appropriate authority to create the application documents
corresponding to the IDocs.
Step3: The R/3 system reads the IDoc file and deletes it after successfully reading and loading the
IDocs into the R/3 system IDoc tables.
The status report is processed in exactly the same manner, with the only difference being that a status
file is passed instead of an IDoc file.
"rfcexec" and "startrfc" are C routines from the RFC library delivered with the R/3 system.
RFC Destination
(R/3 Connection)
Application Server
of the external system
SAP AG 1999
The port description only contains the name of an already existing RFC destination. When the port is
entered, the system generates a name starting with an A and ending with a 9-digit number. The
internal number generation needs a number range, which is set in IDoc interface customizing.
Alternatively to the IDoc interface port description, tRFC ports can be (and generally are) maintained
in the ALE customizing.
The RFC destination is maintained as an R/3 connection using transaction SM59.
IDoc Interface
RFC Interface
TCP/IP
RFC Interface
External System
SAP AG 1999
tRFC means that one system calls a function module of another system. For IDoc exchange, this
means that the sending system is always the active system. It calls the function module in the
receiving system and passes the IDocs as arguments. The function modules of this port type are
inbound function modules.
Inbound function modules are INBOUND_IDOC_ASYNCHRONOUS (new for Release 4.0) and
INBOUND_IDOC_PROCESS (older Releases). To send an IDoc to an R/3 system older than 4.0,
one must call INBOUND_IDOC_PROCESS: This is set in the Port Version.
Non-R/3 systems need the R/3 RFC library. From transaction SE37, the external RFC interface can
be generated. If a non-R/3 system is able to receive an IDoc via tRFC, it must additionally contain a
function module analoguous to INBOUND_IDOC_ASYNCHRONOUS or
INBOUND_IDOC_PROCESS.
All passed IDocs are asynchronously stored in the data base via a single COMMIT WORK
command.
Internet
Destination
Internet address
SAP AG 1999
The most important part of the port description is the internet address (IP address). Together with the
IDoc, it is passed to the internet gateway (or the Microsoft exchange server) via SAPconnect.
Further parts of the port description are the mail attributes:
a description text which can be read as the mail body the mail title of the mail body and a folder of
the owner system where outbound IDocs can be stored for control purposes.
The general settings (IDoc administration) contain the folder where exception messages on inbound
IDocs will be stored.
IDoc
File
IDoc
SAPconnect
SAP AG 1999
For internet delivery, IDocs are stored in another format (SAPoffice name: R3I), a table 255 digits
wide. This table is passed by SAPconnect to
either the internet gateway (program sendmail) or
the Microsoft exchange server.
The program sendmail is already part of a UNIX operating system. It must be bought for a Windows
NT system.
The gateway (or the Microsoft exchange server) convert the IDoc table to the MIME format.
For inbound direction, data flow proceeds exactly the opposite way. Internet IDocs appear as mail
attachments in the mailbox of the addressee.
To use this port type, the following additional parameters must be set (not part of the port
description):
A SAPconnect knot must exist for the address type INT (for routing of the internet messages)
The SAPoffice user must have an address for the address type INT to be able to receive IDocs.
RFC Destination
(TCP/IP Connection)
rfcexec
out.script
Outbound Trigger
SAP AG 1999
IDoc data is written not in IDoc format, but rather in XML format in a file at operating system level.
The names of XML tags refer to the IDoc record types or IDoc segments. XML is designed to be a
self-descriptive Internet-enabled language. Tags can be defined here and recorded in a Document
Type Definition (DTD). As a result, XML is extendible and corresponds in particular to the new
definition of IDoc types concept. IDocs in XML format can be displayed immediately with the
corresponding Internet browser.
Name and directory of the outbound trigger file (called by rfcexec) which starts the external system.
This must be set if the R/3 system is to start, or trigger, the external system (by RFC). For
triggering, one needs to define an RFC destination (e.g. SERVER_EXEC). This is done with
transaction SM59 (TCP/IP connections). This is a set up outside of the IDoc interface.
Outbound - Directory name - specify a physical directory path or a logical directory path (new with
Release 4.6x). File name - determined via a static name or via a dynamic name based on a function
module (recommended).
Choose whether the IDocs should be written together with the corresponding DTD in the XML file.
The DTD contains the tags that are used in the XML IDoc, therefore tags are for the IDoc record
types and the individual segments. The tags are named in the same way as the individual fields.
If possible, you must replace country-specific special characters such as ä,ö,ü with international
characters like ae,oe,ue. In addition, you must maintain the Conversion table and then select Convert
special characters. You must note, however, that the character strings in the segment fields can then
change length.
SAP AG 1999
The above capture was manually edited with line-wraps to enhance the readability.
The file is coded with the code page of the SAP application server.
Because some Browsers are not able to display XML files containing national characters, filters can
be defined with the port definition.
Same as with port type File rfcexec and startrfc with function module EDI_DATA_INCOMING
(rfcexec.exe and startrfc.exe on Windows NT) can be used to trigger between source and destination.
Version 3
Version 2
Version 1
SAP AG 1999
IDoc Record types are defined by their structure in the ABAP dictionary.
Structure definitions have changed in different releases; for instance, the extended name space was
introduced with R/3 Release 4.0. This meant that segment names can now contain 27 digits (instead
of the former 7). This caused the field - segment name - to be longer in the data record control area.
To be able to communicate with earlier releases, the port description contains the version:
Version 1: record types are exchanged with structure of Releases 2.1/2.2
Version 2: record types are exchanged with structure of Releases 3.0/3.1
Version 3: record types are exchanged with structure of Releases 4.X
In addition for the Port type tRFC, a non-R/3 system must know the correct name of the function
module to be called.
The R/2 system record types always have the same structure. Therefore, no version has to be
maintained for the Port Type “CPI-C”.
IDoc Interface
SAP AG 1999
SAP AG 1999
It is necessary to set up a file type port definition to indicate the path that
the data will travel from SAP to a subsystem where the data is kept in a
file until the subsystem is ready to use it or pass it to SAP.
1-1 Create a file port type for your group for the current release of the control record.
1-2 Create the outbound file parameters using the directory path of:
\usr\sap\<SID>\SYS\global\ where SID is the training system id and Function
module EDI_PATH_CREATE_USERNAME.
1-3 Create the command file parameters using the logical destination of
SERVER_EXEC, the directory path of: \usr\sap\<SID>\SYS\global\ where SID
is the training system id and Shell script Converter_start.
1-4 Create the inbound file parameters using the directory path of:
\usr\sap\<SID>\SYS\global\ where SID is the training system id and the Inbound
file name of Inbound.
1-5 Create the status file parameters using the directory path of:
\usr\sap\<SID>\SYS\global\ where SID is the training system id and the Status file
name of Status.
Select the IDoc record types SAP Release 4.x radio button under Version.
1-2
1-2-1 Select Outbound file tab.
1-2-2 Enter the following information:
1-4
1-4-1 Select Inbound file tab.
1-4-2 Enter the following information:
1-5
1-5-1 Select the Status file tab.
1-5-2 Enter the following information:
_________________________________________________________
Contents:
Standard
Fast Entry
SAP AG 1999
SAP AG 1999
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
General Partner
Partner
Profile
receiver of notifications
Partner Outbound
message
Port
IDoc Type
EDI Structure
receiver of notifications Partner
Application
process code
message type
Partner Message Control Parameters
message
process code
receiver of notifications
Inbound
SAP AG 1999
Partner
Partner Description Profile
profile.
SAP AG 1999
The transfer time is only well defined if the external system is triggered, which requires a specific
output mode for the file port type. Triggering helps maintain data consistency.
Non-triggered data transfer includes the danger that IDoc or status files may be multiply processed,
or not processed at all.
Other port types always include triggering (because there is no intermediate data dock like the
operating system file). Thus, there are only output modes with triggering included.
The IDoc interface programs use numbers for the output mode (field OUTMOD). These can take the
values from 1 to 4 (read from top to bottom in the slide).
SAP Application
Document
Message Control
NAST Document
record
General + Outbound
R/3 System
IDoc
Following system
SAP AG 1999
Smartmart wants to send orders via the IDoc interface. From the MM module, output is always
determined by message control. Therefore, Smartmart has to maintain the following parts of the
partner profile:
The general setting: The NOE Food Company's name is entered as the partner number, as it
appears in the master data. Its partner type is LI, identifying NOE Food Company as a vendor in
the R/3 system.
The general outbound parameters: Partner number and type are entered as in the general settings.
An additional parameter is the partner role LF (vendor). The role must be entered because it points
to the corresponding entry in the table NAST of the message control. The message type is
ORDERS. This name utilizes the EDIFACT notation.
The message control parameters: partner role is LF, message type is ORDERS. Keys specific to
NAST are the application EF (purchase order) and the condition type NEU.
The message is used in production. Therefore, the test flag is not set.
Note: Only key fields are mentioned here.
Partn: Noefoods; Appl: EF; cndtype: NEU Object type, NAST record
language,...
Partn: Noefoods; Appl: EF; cndtype: NEU Process code: ME10 Message
Message type : Control
ORDERS settings
SAP AG 1999
As always, key fields uniquely determine the other dependent fields. When Smartmart sends an order
to NOE Food Company, the partner profiles have the following effect:
Message control (NAST) creates a NAST data record containing application EF, condition type
NEU and partner NOE Food Company. These fields uniquely determine the process code ME10
and the message type ORDERS.
The process code names the function module filling the IDoc type with application data. The
message ORDERS and partner NOE Food Company are assigned to the corresponding fields of
the general outbound settings, which are key fields. They determine that the IDoc type
ORDERS01 is to be used (i.e. filled with application data); they also determine the outbound port.
In conclusion, the NAST record determines IDoc type, port and function module, i.e. the whole
outbound processing. Of course, it also determines the non-key fields, e.g. the receiver of
notifications.
The appendix gives a set of commonly used combinations of NAST and outbound partner profile
settings.
Sending System
IDoc
General + Inbound
IDoc +
Process
Document Error
IDoc
SAP Application
SAP AG 1999
NOE Food Company wants to receive purchase orders from SmartMart in the R/3 module SD. The
following parts of the partner profile must be set.
The general settings: Here Smartmart's partner number is entered as it appears in the SD master data.
The partner type is KU (customer).
Inbound processing: partner number and type are entered as in the general settings. Message type is
ORDERS.
The message will be used in production. Therefore, the test flag is not set.
Note: Only fields are mentioned here.
process code:
Partner: Smartmart; message: ORDERS
ORDE; Inbound
receiver of notifications:
EDI-responsible for
processing
orders from partner
Smartmart
SAP AG 1999
As always, key fields uniquely determine the other dependent fields. Therefore, when Quickdeliver
receives an order from Smartmart, the partner profiles have the following effect:
The inbound IDoc contains the partner Smartmart and message type ORDERS in its control
record. Together with the test flag (also part of the control record), these key fields uniquely
determine the inbound process code ORDE.
ORDE names a function module reading the inbound IDoc.
In conclusion, the IDoc determines how it is being processed in the inbound direction. Of course,
it also determines the non-key fields, e.g. the receiver of notifications.
Partner
Example: Message Control Parameters in the Partner profile Profile
Partner
Application
Cond.Type
Process Code
Function module
(writes application data to outbound IDoc) IDoc
SAP AG 1999
A process code is nothing more than a second name for a process, e.g., a function module or a
workflow. Objects of processing are the IDocs.
The partner profiles only contain the process codes, never the real name of the function module.
Thus, it is possible to replace an old process by a new one for all relevant partners in one single step,
assigning the new process to the old process code.
Partner profiles contain process codes for the inbound and outbound direction. In addition, there are
process codes for error handling. These don't save work in the sense outlined above. However, they
were introduced for completeness.
In the outbound case, the process code for output is found on the message control (setup for
messages output from the SD and MM module). There is no process code or Message Control
parameters for messages going out from modules other than SD and MM. The outbound process
codes always identifies a function module.
Partner
Example: Inbound processing Profile
Partner
message
Process Code
Function module/Workflow
(reads data from inbound IDoc and processes it further)
SAP AG 1999
The inbound partner profiles always contain the process code, identifying either a workflow or a
function module (direct way).
There are two types of process codes for error handling:
System: error handling for IDoc processing (both inbound and outbound)
Status: error handling for status processing
All process codes are accessed through the menu entry Control in the IDoc interface.
Check the online documentation (extended help) for further information on process codes.
SAP AG 1999
In the IMG under the IDoc Interface section in the Basis Services area, or under the Control menu of
the IDoc Basis section, you can create proposals for the different messages that are exchanged with
trading partners. These proposals are created by partner type and direction. For example, a proposal
would be created for outbound vendor messages - direction 1 (outbound), partner type LI (vendor).
The logical messages are added to the proposal. Each logical message can be configured for the
appropriate outbound and message control parameters. This configuration consists of defining:
Outbound parameters - partner function, message code and function, port definition, IDoc type
(basic, extension), collect IDocs (if not selected then immediate is assumed) start subsystem (if not
selected then do not start is assumed), receiver of notifications (recipient type, id)
Message Control parameters - application, message type, process code, change message flag
Inbound parameters - partner function, message code and function, trigger background, trigger
immediate, process code, receiver of notifications (recipient type, id)
Partner Profile entry consists of entering the value SAP master data number for the trading partner
and the partner type and selecting the Fast Entry icon. The system will display a screen on which the
direction of the configuration is determined. Once this is selected then the list of logical messages is
presented and the appropriate messages for the trading partner can be selected from the list.
SAP AG 1999
1-1 Examine the general partner profile entry for your vendor.
1-1-1 What is the partner status of your trading partner?
___________________________________________________________
1-1-2 What are the default receiver of notifications for your trading partner?
___________________________________________________________
1-2 Create the outbound parameters vendor partner profile entry for outbound Purchase
Order using message type ORDERS, partner function VD, the file port created in
the Create a File Port exercise, transfer IDoc immed, do not start subsystem, basic
type ORDERS01.
1-3 Create the message control vendor partner profile entry for outbound Purchase
Order using application EF, message type NEU, partner function VD, message type
ORDERS, process code ME10.
1-4 Create the inbound parameters vendor partner profile entry for inbound Purchase
Order Acknowledgment using message type ORDRSP, partner function VD,
process code ORDR, and immediate processing.
1-5 Create the inbound parameters vendor partner profile entry for inbound Advanced
Ship Notification using message type DESADV, partner function VD, process code
DELS, and immediate processing.
2-1 Examine the general partner profile entry for your customer.
2-1-1 What are the 6 different partner types?
___________________________________________________________
2-1-2 Can the default receiver of notifications be changed on the
outbound/inbound parameters screen?
___________________________________________________________
2-2 Create the outbound parameters customer partner profile entry for outbound Sales
Order Acknowledgement using message type ORDRSP, partner function SP, the
file port created in the Create a File Port exercise, Collect IDocs, do not start
subsystem, and basic type ORDERS01.
2-3 Create the message control customer partner profile entry for outbound Sales Order
Acknowledgement using application V1, message type BA01, partner function SP,
message type ORDRSP, and process code SD10.
2-4 Create the outbound parameters customer partner profile entry for outbound
Advance Shipment Notification using message type DESADV, partner function
SH, the file port created in the Create a File Port exercise, transfer IDoc immed, do
not start subsystem, and basic type DELVRY01.
2-5 Create the message control customer partner profile entry for outbound Advance
Shipment Notification using application V2, message type LAVA, partner function
SH, message type DESADV, and process code DELV.
2-7 Create the message control customer partner profile entry for outbound Invoice
using application V3, message type RD00, partner function BP, message type
INVOIC, and process code SD09.
2-8 Create the outbound parameters customer partner profile entry for outbound Price
Catalog using message type PRICAT, partner function SP, the file port created in
the Create a File Port exercise, tranfer IDoc immed, do not start subsystem, and
basic type PRICAT01.
2-9 Create the inbound parameters customer partner profile entry for inbound Sales
Order using message type ORDERS, partner function SP, process code ORDE, and
immediate processing.
1-1-3 A – active, the trading partner must be active in order for messages to be
exchanged. A status of I means that the trading partner is inactive. A
status of T indicates that this trading partner is to be used as a template
for creating new trading partner profiles.
The default receiver of notifications is broken out into Type S for Position,
Agent 50017123- 50017134, 50017155-5001762 for the internal id
number of your Student Group under organizational unit IDoc_Notif
which is found in the PDOrg (Personnel Development Organization
structure) and Lang. EN for English.
1-2
1-2-1 From the Partner Profile screen: Press [Create outbound parameter] button.
1-2-5 Click over to the right and select EDI Standard tab.
1-3
1-3-1 Select the Message Control tab and press the [Insert line] button.
Message Control
Field Name Input Data
Application EF
Message Type NEU
Process Code ME10
1-4
1-4-1 From the Partner Profile screen: Press [Create Inbound parameter] button.
Inbound options
Field Name Input Data
Process Code ORDR
Processing by function module Trigger immediately
1-5
1-5-1 From the Partner Profile screen: Press [Create Inbound parameter] button
Inbound Options
Field Name Input Data
Process Code DELS
Processing by function module Trigger immediately
Contents:
MM Application Requirements
Master Data
Confirmation Control
Sending a Purchase Order
Sending a Scheduling Agreement
Forecast
Delivery Schedule
SAP AG 1999
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
SAP AG 1999
Control record
Vendor master data:
Partner number, type, role Receiver
Message Control
condition record,
medium “6” (EDI)
IDoc
IDoc Type
Type ORDERS01
ORDERS01
SAP AG 1999
The MM master data must contain certain parameters which are sent to the orders IDoc recipient.
Besides partner number and type, the partner function must be set in the vendor's master data. The
partner role must be included in the additional outbound partner profile for message control (NAST).
The vendor master data should contain the own name as it appears as the partner number in the
recipient's partner profile. This name should be entered in the field “account at vendor's side” (LFB1-
EIKTO). It is compared with the partner number of the recipient's inbound partner profile. Not
maintaining the field requires that the recipient must maintain an additional mapping in his system.
The vendor material information must contain the vendor's name of the material to be ordered. The
name is transferred by segment type E1EDP19. From this segment, the SD recipient determines
which material was ordered.
The Message Control condition record must contain a 6 (EDI) denoting the sending medium.
Otherwise, the IDoc interface will not be activated.
MM Acknowledgement Records
Confirmation Categories
External Confirmations
Internal Confirmations
Confirmation Control Keys
Confirmation Sequence / Monitoring
SAP AG 1999
Confirmation sequence:
This allows you to specify the chronological order in which the individual confirmations within a
confirmation control key are expected and which confirmation categories are to be automatically
monitored.
Monitoring Period (MP) - The value in days that a confirmation must be received
Reference Date (D) - Determines the mode of monitoring:
If the acknowledgment is not received in the period between the PO Date plus the monitoring
period then submit the PO for the monitoring report.
If the acknowledgement is not received before the period between the Delivery Date minus the
monitoring then submit the PO for the monitoring report.
Note: The transaction for the acknowledgment monitoring report is ME92 (RM06ENAB). Also for
the PO to be monitored the Order Acknowledgement Req'd field in the PO must turned on.
Processing Time (PT) - Time it takes to process the confirmation.
TolTooE (Early Tolerance) - Sets the maximum number of days before the delivery date that the
order will be accepted
TTL (Late Tolerance) -Sets the maximum number of days after the delivery date that the order will
be accepted
SAP AG 1999
SAP AG 1999
The scheduling agreement can be created with or without releases. Here the difference is based on
which document type is used. Scheduling agreement document type LP denotes without release and
document type LPA is used with release capability. The term release is used here to mean a type of
rolling delivery schedule issued against scheduling agreement and also to connote approval or
“giving the green light” to the vendor.
If we do not use the release strategy then the sequence of events would be as follows: Create the
outline agreement which indicates what materials and total quantity and other pertinent information
similar to a Purchase Order. If configured, as soon as the document is saved, it is considered official
and can be transmitted to the vendor. This will make use of the output condition type NEU found in
output procedure RMBEV1. Next the delivery schedule would be created. This indicates to the
vendor the expected delivery dates and quantities. Again as soon as the document is saved, if
configured, this is an official document which can immediately be transmitted to the vendor. Here
we use output condition type LPET found in output procedure RMBEL1.
In using the release capabilities, we are saying that the scheduling agreement has more of an internal
character and we can change it as necessary and only upon releasing do we wish to transmit the
information to the vendor. We still create the outline agreement but use document type LPA instead
of LP. We would then create a delivery schedule which can contain a forecast of delivery dates and
quantities or Just-in-Time delivery dates and quantities. We then can create releases and send to the
vendor our forecast (output type LPH1) or JIT (output type LPJ1).
If will be doing JIT then need to set the JIT indicator on for the material in the material master.
SAP AG 1999
The vendor master data contains a field owned by the EDI process to
populate a segment in the IDoc. Additionally, cross reference records can
be set up to identify your vendor's material with your material.
1-1 Maintain an account at vendor in the vendor master using your vendor V100## and
the account at vendor of 300##.
1-2 Create the vendor material info record for your material DCC-## and the vendor's
material CCS-##.
Check the timing of the output by selecting the entry and press the [Further
Data] button.
Make sure the Dispatch time entry is Send immediately (when saving the
application).
Green arrow back once.
Press the Save icon.
___________________________________________________
Contents:
Message finding and message editing
Condition elements
Output time
SAP AG 1999
SAP AG 1999
Mess
Message
age Cont
Control
rol &
& IDocs
IDocs 7 Documentation Tools 14
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
SAP Application
Document
find
message control
edit
NAST process
record
SAP AG 1999
Message control (NAST) creates messages from application documents. The possible messages are
created as condition records in the customizing.
From the set of possible messages, NAST searches those that fit to the actual application data. This
message finding can result in more than one, or possibly none. In the following, let us assume that
exactly one message was found.
If supported by the application, the found message is proposed for Editing in the very transaction
which started NAST. In the case of creating an MM purchase order, this means that the message can
be edited before saving the application document.
In any case, the message is created and processed (if not deleted in the editing process). For instance,
when the order is to be printed, the print format is determined, and the message is sent to the printer.
If the message is to be sent out as an IDoc, the corresponding processing program RSNASTED is
already part of the IDoc interface.
The new message creates a new entry in the table NAST. Part of this entry is the processing status
which can hold the following values: 0 = not yet processed, 1 = successfully processed, 2 =
processed with error.
Note: For better reading, the slide does not show the transfer of the IDoc to an external system;
however, this is also part of outbound processing.
application data
message finding
message proposal
NAST record
Processing Table
Table TNAPR
SPFLI
Table
Table RSNASTED
output, e.g. IDoc
TNAPR
IDoc
Program
RSNASTED
SAP AG 1999
The process diagram shows again message finding, message editing and message processing.
NAST allows the setting of a processing time flag: This controls whether the message has to be sent
immediately after creating the application document, or at a later time. In the latter case, you must
run the report RSNAST00 as a batch job; otherwise, the message stays unprocessed.
The NAST table record points to a BOR (Business Object Repository) object which holds all
application data relevant for the message.
The table TNAPR holds the processing programs; in the case of EDI, the entry is the program
RSNASTED.
SAP application
1:n
procedure
m:n
condition type
n:1
access sequence
m:n
access to table
SAP AG 1999
Message finding uses the condition technique which is the same as used in the SD pricing: Messages
are searched according to a pre-defined sequence to save time and allow preferences. The condition
elements and their hierarchy define this sequence.
Messages are records of a condition table. Several condition tables can belong to a condition type.
The condition tables are accessible according to a pre-defined access sequence, and with different
key fields.
Several condition types can belong to a procedure; several procedures can belong to an application,
e.g. the application EF (purchasing).
If an application uses NAST to send an EDI message, only the procedures belonging to that
application are searched for messages, not all procedures present in the R/3 system.
With the condition element access sequence, you can control whether only one message is to be
found. To achieve this, you set the “exclusive” flag.
SAP AG 1999
SAP AG 1999
Condition type configuration is also found in the MM or SD application area of the IMG.
SAP AG 1999
Access sequences are client-independent. They are used to indicate the table number which holds the
condition records.
Access sequences are the matching keys between the conditions record and the application data.
SAP AG 1999
Condition records are created from within the MM or SD application area not from the IMG.
SAP AG 1999
The sending medium is part of the condition record which is pre-defined in the customizing. Sending
media for IDoc processing are:
6 EDI (without distribution model)
A ALE (with distribution model)
With these parameters, the program RSNAST00 starts the EDI message processing program
RSNASTED.
The output mode (field OUTMOD in the control record) "1" and "2" have the effect that single IDocs
are passed from RSNASTED.
With output mode “3" and “4", IDocs are not passed directly. Instead, they are collected by the
program RSEOUT00 in batch mode.
SAP AG 1999
Note that there are two output times when using message control. One controlled by NAST, the other
by the IDoc interface. Each of these "times " can only be switched between now (immediate) and
some time later ( batch). The latter case means that the processing program must be started as a batch
job at a later time, the former case means that it is started immediately during processing.
Because there are two stop signs, one should reflect where to raise them. In many cases, it does not
make too much sense to raise both of them.
If an EDI subsystem is used with port type file, there is even a third stop sign: triggering or non-
triggering.
The right side of the slide shows the EDI terminology for the different timing combinations.
SAP AG 1999
1-1 Create a condition record for the Purchase Order for your vendor trading partner
(V100##) using output type NEU and access Purch Org/Vendor for EDI.
1-2 Create another outbound purchase order for your vendor V100## for 100 cartons of
double chocolate chip cookies at 3.60 a carton. Record your Purchase Order
number.
____________________________________________________________
1-3 Use Monitoring tool, IDoc lists, to check if an outbound Purchase ORDERS IDoc
was created for your vendor.
____________________________________________________________
1-4 Create a condition record for the order acknowledgement for your customer trading
partner (300##) using output type BA01 and access Sales Organization/Customer
nbr.
1-5 Create a condition record for the advanced shipping notice for your customer
trading partner (300##) using output type LAVA and access Sales
Organization/Customer nbr.
1-6 What is the document type(s) used in the condition record(s) of output type RD00?
____________________________________________________________
1-1-2 Press the [Key combination] button and choose the access based on
Purch.Org./Vendor for EDI.
1-1-3 Enter the following information:
1-4-2 Press the [Key combination] button and choose the access based on Sales
Organization/Customer Number.
1-5-2 Press the [Key combination] button and choose the access based on Sales
Organization/Customer Number.
1-5-3 Enter the following information:
1-6-2 Press [Key combination] button and choose access based on Billing type.
______________________________________________________
Contents:
Inbound processing
Exception handling
Notification concept
Units of organization
SAP AG 1999
SAP AG 1999
Workflow
Course Overview 1 and IDocs
8
IDocs in the SD EDI Application
Business Process 2 Requirements 9
Inbound Invoice
General Settings 3 Processing
10
Payment/Remittance
Port Definitions 4 Process 11
Price Catalog, Inventory
Partner Profiles 5 Advice 12
MM EDI Application
Requirements
6 Test of Processing 13
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
IDoc +
process Review
etc...
Document
SAP application
SAP AG 1999
Inbound processing may use a workflow pointed at by an appropriate process code. This workflow
can be defined as needed. Examples are:
Review: First, an application document will be created from the inbound IDoc. Then, the document
will be posted to an agent for review.
Edit: First, the IDoc will be edited by an agent before the application document is created.
Forward: The inbound IDoc will be forwarded to other agents or kick off new outbound IDocs.
NOTE: For better reading, the slide does not display the IDoc inbound from an external system; yet,
this is part of inbound processing.
no
SAP AG 1999
Exception handling is always defined as a workflow. One or more agents can be informed about the
error situation. The agents are defined in the IDoc interface and in the organization model (PD-ORG)
of your company.
SAP delivers only single-step tasks for error handling, both for inbound and outbound processing.
The slide only shows inbound error handling.
SAP application
Document
Message w/
EDIN NAST record
Message Control
EDIM Message
NAST
Record
IDoc w/
EDIX syntax error
IDoc Interface
EDIO IDoc
IDoc
EDIP IDoc batch
EDIS
EDI subsystem EDIR Status report
Customer
SAP AG 1999
EDI subsystem
EDIL Status Report
IDoc
EDIM Message
IDoc with
EDIY syntax error
IDoc
IDoc without
SAP application Application application document
SAP AG 1999
Inbound exception handling is like the outbound case. Errors arising when creating the application
document (e.g. by wrong input data) are sometimes handled by application-specific tasks and
identified by process codes.
The process code EDIL (new with 4.6) is used with error messages received via status reports but
there is no IDoc created.
The process code EDIM holds for both inbound and outbound processing. Here, no IDoc could be
created yet, so no direction is given.
The process code EDII holds for inbound IDocs containing error messages.
The process code EDIY identifies IDoc format or syntax errors.
Notifications from the EDI subsystem prior to IDoc creation can be received with logical message
TXTRAW implemented by IDoc type TXTRAW01 and TXTRAW02. The message can be directed
to any organizational unit as well as any SAP user account.
IDoc type TXTRAW01 takes the recipients from the related partner profile.
IDoc type TXTRAW02 is new with 4.6. The IDoc type allows you to determine the recipients as
well as the heading of the mail from the outside.
Organization
Organization structure
structure
Possible
Possible agents
agents
task
task
Role
Role resolution
resolution Selected agents
Partner
Partner profile
profile
Allowed
Allowed agents
agents
IDoc
IDoc interface
interface
SAP AG 1999
The agents found in the IDoc interface are only the allowed agents of a workflow task. Attached to
the task itself is the set of possible agents. The role resolution determines the set of agents which are
both allowed and possible. These agents are called the actual agents.
All actual agents get the work item (as the instance of the workflow task) into their integrated inbox.
The function module for the role resolution is called EDI_ROLE_FOR_PROCESSING. For
instance, it takes partner and message from the partner profile as role parameters to get the set of
allowed agents.
The corresponding IDocs can only be further processed starting from the integrated inbox.
Note: If the tasks are defined as general tasks, all agents are possible agents, and the set of actual
agents equals the set of allowed agents.
Inbound/
Inbound/ General
General General
General settings
settings
Outbound (IDoc Allowed
Allowed agents
agents
Outbound (IDoc Administration)
Administration)
SAP AG 1999
Allowed agents are maintained in the following parts of the partner profile: inbound and outbound
(optional), and general (required). When an error occurs (e.g. a syntax error), the most specific
allowed agent is determined. The search starts in the inbound or outbound entries, since agents
specific for partner and message can be defined here.
If no agent could be found in the inbound/outbound entries (either because there was none, or
because there was no partner profile for the actual partner/message combination), the general partner
profile is searched for an agent specific to the actual partner.
If the search fails again (because there was no partner profile for the actual partner), search continues
in the IDoc administration (field: EDIADMIN). Since this field is only optional, it may happen that
no one is notified.
Therefore, it's always a good idea to enter an allowed agent in the IDoc administration.
In all cases, the agent can be a single person (type US = user) or a whole group which must exist in
the PD-ORG model, either as a position, job, or an organizational unit.
Organization
Organization structure
structure Possible
Possible agents
agents
Org.Unit
Job
Position
SAP AG 1999
Workflow auto-customizing (transaction SWU3) characterizes all tasks relating to the IDoc interface
as general tasks, i.e. all R/3 system users are possible agents. One can reduce this set using an
organization structure.
The organization structure defines a hierarchy of responsibilities. For instance, one could have a
general organization unit “administrators” comprising as sub-unit the job “IDoc administrator”. This
job can contain several positions held by an equal number of human beings. One could enter the job
(not individuals) as an allowed agent in the IDoc interface.
It is also possible to enter a position (not the individual holding it) as “allowed agent”. The
advantage is that notifications are tied to responsibilities, not to individuals whose responsibilities
can change. This concept can be compared to the process code and the process behind it.
Cost center
assignment
Cost center
Organizational unit
includes ...
Work center
Job Position(s)
specifically
describes ... Owner User
describes ...
Task
SAP AG 1999
Elements of the organization structure which can be entered as possible agents of a standard task are:
organization unit
job
position
Further elements are work center and cost center
Organizational units are organizational areas of a company that are grouped together in a logical
manner
Examples: “department”, “team”, “group”
Jobs are areas of activity in a company described by tasks. Jobs are usually defined for all
organizational units.
Examples: “Administrative Assistant”, “Administrator”, “Accounting Clerk”
Positions are derived from each job. Each position is usually filled by one or more employee / user.
Examples: “SD Administrative Assistant”, “General Administrative Assistant”
Work center is the physical location where an employee performs his/her tasks at the company.
Cost center is an accounting element that may be tied to an organizational unit.
Customizing activity
Entrance from workflow menu
SAP AG 1999
An element of the organization structure must be defined. Second, R/3 system users must be
assigned to elements.
Both can be done in the customizing or from the workflow definition menu (transaction PPOM).
SAP AG 1999
What is involved?
Defining who is responsible for processing a task:
Fixed assignment of a task to an employee
The task “Orders Inbound Error” is performed by
Judy Jones, Mark Miller, and Sam Smith
Flexible assignment of tasks, based on the jobs or
organizational units (groups, projects)
The task “Invoice Inbound Error” is performed by the
employees whose activity profile is described by the job
“Department manager”.
Customizing activity during product implementation
SAP AG 1999
Workflow Inbox
Number of entries 5
ST EU Description AT Rec. on
Material CSS-99 not defined in sales 19.02.1998
EDI/ALE error message 19.02.1998
Inbound partner profile not available 19.02.1998
Order part number # p-3539 19.02.1998
Review Customer Order #7654 19.02.1998
Review Customer Order # 7789 19.02.1998
SAP AG 1999
The integrated inbox can be accessed directly via transaction SO01. Actual agents find here the
workitem, i.e. the concrete instances of the single step tasks.
Workitems can be edited by one agent. As a consequence, it vanishes from the integrated inbox of all
other actual agents.
SAP AG 1999
SAP AG 1999
SAP AG 1999
The business has determined that when IDocs are processed and errors
occur, automatic error notification is to take place.
1-1 Link your user id to the your appropriate position in the Organization Structure
IDOC_NOTIF.
2-1 Delete the inbound parameters for Orders from your customer partner profile. This
will cause an EDI technical error.
2-2 Change your Purchasing Material Info record for your vendor (V100##) and
material (DCC-##) by placing an ‘X’ behind the vendor’s material CCS-##. This
will cause an application error.
______________________________________________________
3-2 The purpose of this portion of the exercise is to simulate inbound processing. Since
there is no actual EDI subsystem, it is necessary to find a source of inbound data.
This is accomplished by using a test utility that changes the direction and other key
fields in the control record of an outbound IDoc, converting it into an inbound
IDoc.
3-2-1 Change the sender information to your customer number, partner type KU,
and partner function SP for the logical message ORDERS.
3-3 Use Monitoring tool, IDoc lists, to check on the status of the inbound sales order.
IDocs that have errors can be processed by personnel that have been
notified. The EDI department members would handle technical errors
and application personnel would handle errors from the application.
4-1 Check your integrated inbox to see if there are any messages that can be processed.
4-1-1 Select an item to process.
4-2 Return to the inbox, refresh and select the message to process.
4-3 Use the Monitoring tool, IDoc lists, to determine the sales order number.
4-3-1 Record the Sales Order number.
______________________________________________________
_______________________________________________
3-2-1 Change the sender information to your customer number, partner type KU,
and partner function SP for the logical message ORDERS.
3-2-1-1 Enter the following information:
IDoc lists
Field Name Input Data
Date Created Keep default
Time Created Keep default
Partner number 300##
___________________________________________________
4-2 Return to the inbox, refresh, select the message and press the Execute icon.
GOTO → IDOC DISPLAY
IDoc lists
Field Name Input Data
Date Created Keep default
Time Created Keep default
Partner number 300##
_______________________________________________
Contents:
z SD Application Requirements
z Booking a Sales Order
SAP AG 1999
SAP AG 1999
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
SAP AG 1999
z SD Configuration EDI
Partner Conversion
Partner Functions
Customer/Supplier Assignments
Handle messages for Inbound Orders
Convert SAP Item Category to IDoc Item Category
z SD/EDI Pricing
EDI Pricing Condition Types
Maintain Pricing Procedure
SAP AG 1999
Control record
Customer master data:
sender Partner number, type, role
Customizing SD:
assignment customer/
vendor to sales organization
IDoc
IDoc Type
Type ORDERS01
ORDERS01
SAP AG 1999
External
External System
System == NOE
NOE Food
Food Company’s
Company’s EDI
EDI subsystem
subsystem
no
SAP AG 1999
SAP AG 1999
The customer master data contains fields owned by the EDI process to
populate a segment in the IDoc. Additionally, cross reference records can
be set up to identify your customer's material with your material.
1-1 Maintain an account at customer in the customer master using your customer 300##
and the account at customer V100##.
1-2 Maintain the customer material info record for your material CCS-## and the
customer's material DCC-##.
1-3 Change your Purchasing Material Information record (DCC-##) for your vendor
(V100##) by removing the ‘X’ from the vendor’s material number (CCS-##).
1-1 Create a Purchase Order using the same data as in the first create outbound
purchase order exercise.
1-1-1 Record the Purchase Order number.
______________________________________________________
1-2 Use the turnaround test tool to bring in your sales order.
1-3 Use Monitoring tool, IDoc lists, to determine the Sales Order number.
______________________________________________________
1-4 From the sales order change screen determine the IDoc number that is linked to the
sales order business object for the outgoing order response.
1-4-2 Use the testing transaction which will send the output from the IDoc
interface layer to the operating system file.
1-5 Use the turnaround test tool to bring in your sales order acknowledgement and
update your Purchase Order.
1-6 Display the purchase order that was acknowledged with the turnaround utility.
1-6-1 Record the acknowledgement number (sales order number).
______________________________________________________
2-1 Create a Delivery note for the sales order created in the last exercise using the
collective delivery note process.
2-1-1 Record the Delivery note number.
______________________________________________________
2-1-2 Once the delivery note has been created, create the warehouse transfer order
using warehouse number 300.
2-2 Use the turnaround test tool to bring in your Advanced ship notice.
2-3 Use Monitoring tool, IDoc lists, to determine if your Advanced ship notice
processed
3-1 Create the Invoice for the delivery note from the previous exercise.
3-1-1 Record the Invoice number.
______________________________________________________
1-1-2 Select the [Company Code] button and then select the Correspondence tab
and enter the following information:
1-1-3 Select the [Sales area data] button and then select the Orders tab and enter
the following information:
Press [Enter].
When the Org. Data screen appears enter the following information:
Create Purchase Order: Org. data
Field Name Input Data
Purchasing org. 3000
Purch. Group 000
Company 3000
Press [Enter].
Record the Purchase Order number.
______________________________________________________
IDoc lists
Field Name Input Data
Date created Keep default
Time created Keep default
Partner number 300##
1-6-1 Press the [Item Details] button and view the vendor's Sales order number in
the Acknowl.no field.
1-6-2 Record the acknowledgement number (sales order number).
___________________________________________________
2-1-2 Once the delivery note document has been created, create the warehouse
transfer order using warehouse number 300.
2-2 Use the turnaround test tool to bring in your Advanced ship notice.
From the SAP Easy Access menu, open folders
TOOLS → BUSINESS COMMUNICATION → IDOC → IDOC BASIS →
TEST → INBOUND PROC. OF MODIFIED OUTBOUND FILE
2-3 Use Monitoring tool, IDoc lists, to determine if your Advanced ship notice
processed successfully.
Create Billing
Field Name or Data Type Values
Delivery note number Delivery note created in previous
exercise
Contents:
Logistics Invoice Verification
Configuration for inbound invoice processing
MM vs FI invoice configuration
Inter-company billing
SAP AG 1999
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
There are currently three flavors of inbound invoice processing - Purchase Order related invoices
which come in two flavors - conventional MM invoice processing and Logistics Invoice
Verification; and non-PO related or financial invoices.
For PO related invoices Logistics Invoice Verification (LIV) is now the recommended methodology
for EDI. The process code for LIV is INVL and executes function module
IDOC_INPUT_INVOIC_MRM found in function group MRMH. Conventional MM invoice
processing may still be used and the process code is INVM which executes function module
IDOC_INPUT_INVOIC_MM found in function group IEDI.
Financial invoices utilize the process code INVF and function module IDOC_INPUT_INVOIC_FI
which is also found in function group IEDI.
SAP AG 1999
Comp. Code Name in the Invoice - The name of the company code in the invoice must correspond to
the name for out company transferred by the EDI partner. EDI incoming processing needs this name
to be able to uniquely determine the company code to which the invoice is to be posted. It is pulled
from the IDoc partner segment (E1EDKA1) with a partner role of ‘RE' (bill-to), field NAME1.
The material/service number corresponds to the name transferred by the EDI partner for produced
goods and services or supplied goods. The G/L account to be posted to is determined via this name.
The entry can be made generically using the character ‘*'; first an entry with the precise name is
searched for, then if no exact entry exists, a search with the generic argument is carried out.
For the surcharge/discount postings for header conditions, the table is accessed with value ‘+'
(surcharge) or ‘-' (discount).
Additional account assignment table includes business area, cost center, controlling area, asset
numbers, order number, project number, network number, plant, profit center and business segment.
It can also be searched generically or a specific search based on data from the IDoc.
Conversion of tax codes from an external format (as received in an EDI message) to an internal
format (as defined with the R/3 system).
Conversion of tax code is based on the tax type and rate field combination compared to data from the
IDoc.
Configuration of the EDI program parameters, determines the program switches and default G/L
posting keys, clearing accounts, and default vendor posting keys.
MM : FI :
Purchase Order Based No Purchase Order
Accounting Assignments General Ledger Account
contained in Purchase Order
Additional Account
Company Code Assignment Assignments
External Tax Codes Company Code Assignment
Program Parameters External Tax Codes
MM in Partner Profile Program Parameters
Message Code field
FI in Partner Profile Message
Code field
SAP AG 1999
There is less configuration for MM (PO related) inbound invoices because the accounting
information (General Ledger account and Special Ledger accounting) is contained within the
Purchase Order.
The inbound invoice makes use of the message function field on the partner profile. This helps the
inbound invoice function module distinguish between PO related (MM) and non-PO related (FI)
invoices.
SAP AG 1999
Inter-company billing is usually based on a transfer of product from one company code to another
within the corporate umbrella.
When the transfer of product has occurred the selling (sending) company invoices the buying
(receiving) company.
The transaction is accomplished by the creating an invoice in the SD application of one company
code and forwarding it to the MM or FI application of the other company code.
The configuration for the IDoc process consists of creating logical addresses for the selling (sending)
company code concatenated with the customer number of the buying (receiving) company. The
destination in the details screen consists of the buying(receiving) company code concatenated with
the vendor number of the selling (sending) company. The application area is V3 which indicates
Sales and Distribution invoice processing.
Partner profiles are created for both sides of the transaction. The outbound partner profile outbound
options of partner function BP, logical message of INVOIC, message code of MM or FI depending
on whether there is a purchase order associated with the transfer of product, appropriate port, transfer
immediate, basic type of INVOIC01 or INVOIC02, transfer immediately and don’t start the
subsystem. Message Control parameters of logical message type of INVOIC, message code of MM
or FI (must be the same as on the outbound options), process code of SD08. The inbound partner
profile consists of no partner function, message type INVOIC, message code of MM or FI (must
match what was entered in the outbound, processes code of INVL (if MM) or INVF (if FI), trigger
immediately
SAP AG 1999
1-1 Create the inbound parameters vendor partner profile entry for inbound Invoice
using message type INVOIC, message code MM, partner function VD, process
code INVM, and immediate processing.
1-2 Use the turnaround test utility to bring the inbound invoice into the system and post.
1-3 Use Monitoring tool, IDoc lists, to determine the Invoice number.
________________________________________________________________
1-1-2 From the Partner Profile screen: Press [Create Inbound parameter] button.
1-1-3 Enter the following information:
Contents:
Outbound Payment/Remittance Advice Configuration
Payment Program Processing
Inbound Lockbox Configuration/Processing
Inbound Bank Statement/Account
Configuration/Processing
Inbound Remittance Advice Configuration/Processing
SAP AG 1999
SAP AG 1999
Payment/Remittance
Port Definitions 4 Process
11
Price Catalog, Inventory
Partner Profiles 5 Advice 12
MM EDI Application
Requirements 6 Test of Processing 13
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
Customer
Customer Payment order Bank
Bank
Payer
Payer
Debit advice
Remit.
Remit. Advice
Advice Bank
Bank transfer
transfer
Check
Invoice
Invoice
Lockbox
Lockbox Info
Info
SAP AG 1999
The SAP EDI invoice and payment cycle could alternatively handle the sending of the invoice from
the vendor to the customer.
The customer runs the payment program to created payment orders and remittance advices. The
remittance advices are sent directly to the vendor(s). The payment orders are sent to the bank.
The bank then notifies the customer of debit advices (the removal of money from the customer's
account) and notifies the vendor of credit advices (the receipt of money in the vendor's account).
Once the payment notification is received from the bank, the vendor will apply the payment to the
open invoices by checking the remittance database to see if remittance advice information has also
been received from the customer to indicate which invoices and invoice line items are to be closed.
Invoice INVOIC02/INVOIC
SAP-
Credit Advice PEXR2002/CREADV
SAP AG 1999
customer remittance
advice
incoming payment
invoice program
collective
payment bank
vendor incoming
payment
outgoing
invoice
remittance
advice
SAP AG 1999
SAP EDI invoice and payment cycle handles the sending of invoices from the SD module from the
vendor to the customer receiving the invoice.
The customer then runs the payment program from the Accounts Payable module found in FI.
The payment program is equipped to handle a variety of payment methods and can generated
payments for a select range of vendors or all vendors.
The payment programs are country specific and payment method specific. The naming convention
for the payment programs is RFFO<country code>_<payment method>, i.e. RFFOUS_C which will
generate check payments.
The payment program will also generate the remittance advices.
The remittance advices and payment orders then are sent to the bank for further processing. The bank
will send the payment and remittance information to the vendor.
The vendor will then apply the payment and remittance advice to Accounts Receivable to clear open
invoices and their items.
House Bank
Partner number
EDI payment methods
SAP AG 1999
Define for each paying company code, the remittance advice form if remittance advices are to be
printed.
Define for each paying company code, the EDI accompanying sheet. This form produces the control
totals report for each payment run.
It is from the house bank configuration that the EDI bank trading partner number (name) is defined
and from where the partner profile for the bank is initiated.
Also in the house bank configuration, in the DME (data medium of exchange) section, is where the
EDI compatible payment methods are defined.
The best source of configuration information is found in the appendix or in the release notes for 3.0D
in the Financial Accounting area for accounts payable.
SAP AG 1999
The partner profile may be set up for the bank, and/or vendor trading partners. The bank receives the
payment order which can also contain the remittance information. The vendor trading partner may be
set up to receive the remittance information directly. Both types of trading partners can be set up for
both test and final (non-test) IDocs to be created from the payment run.
Test IDocs can be generated from the proposal run.
Final IDocs are generated from the payment run.
Set up or verify the following when configuring the Vendor Master with the information that is
specific to EDI:
Payment Transactions Screen (Company Code data)
- Payment Methods
- House bank
- Pmt adv. by EDI = 'x' (for EDI FI remittance advice)
Payment Transactions Screen (General Data)
- Bank account information for Electronic Funds Transfer
SAP AG 1999
The payment program parameters indicate which companies are to be searched, the payment
methods that are to be used, and which accounts (vendor and customer) are to be paid.
Additional program parameters include the additional log, and the print program.
Additional log specifies the results of the due date check, payment method selection in all cases of an
open invoice and if it is included in the proposal for payment, and line items included in the payment
document.
The print program specifies how the payment orders are to be generated i.e. check, wire transfer,
dme file.
The print program variant specifies the options to use with the print program.
x ?
X Selection Print programs Additional log…. B.ex/pmt request
ENTRY 1 1
Accounts Foreign currencies
Vendors (from / to) Customers (from / to
10001 10099 Rat types for conversn
Entry 1 1 Entry 0 0
SAP AG 1999
The payment program parameters indicate which companies are to be searched, the payment
methods that are to be used, and which accounts (vendor and customer) are to be paid.
Sample parameters would be:
- Company codes = '3000’
- Payment Meths = 'C’
- Next posting period = some future time,
- Accounts Vendors = '10099’
- Customers = none
x ?
Other variants
Print forms / Data medium exchange
Report Requested variants More
RFFOAVIS
RFFOEDI1 PAY1
RFFOUS _ C
Lists
Report Requested variants
SAP AG 1999
x ?
X Selection Print programs Additional log…. B.ex/pmt request
Accounts
Vendors (from / to) CustomersENTRY
(from / to 1 1
10001 10099
Accounts Foreign currencies
Vendors (from / to) Customers (from / to
10001 10099 Rat types for conversn
Entry 1 1 Entry 0 0
Entry 1 1 X Entry
x 0 0
SAP AG 1999
The additional log will generate information in the proposal log or the payment log as to why an
invoice was chosen or not based on the due date, what the payment method is for a particular
invoice, and the line item information on the invoice.
x ?
Variant attributes X i
Program run date 22 . 06 . 1998
Identification feature PAY1
Proposal run only
Company code selection
Paying company code 3000 to
Sending company code 3000 to
Further selections
Payment methods C to
Payment methods supplement to
Business area to
House bank 3000 to
Account ID 3000 to
Currency key to
Payment document number to
SAP AG 1999
The print program variant specifies the options to use with the print program
A sample variant would be:
PAY1 which would be associated with RFFOEDI1 report
Use SE38 to change/edit the print program variant PAY1
Relevant data includes (as an example):
Program run date = set to current date, Identification feature = matches payment program, Paying
company code = '3000', Sending company code = '3000', Payment methods = 'C', House bank =
'3000', Account Id = '3000', Generate SAP IDoc = 'x', Print payment advice notes = 'x', Print
payment summary = 'x'
x ?
Variant attributes X i
Print Control
Generate SAP IDoc Printer Print immediately
Print payment advice notes Printer Print immediately
Output Control
Number of invoice details
SAP AG 1999
The print program variant specifies the options to use with the print program
A sample variant would be:
PAY1 which would be associated with RFFOEDI1 report
Use SE38 to change/edit the print program variant PAY1
Relevant data includes (as an example):
Program run date = set to current date, Identification feature = matches payment program, Paying
company code = '3000', Sending company code = '3000', Payment methods = 'C', House bank =
'3000', Account Id = '3000', Generate SAP IDoc = 'x', Print payment advice notes = 'x', Print
payment summary = 'x’.
Schedule Proposal
‘Test’ IDocs
Post and Print
Schedule Payment
Actual IDocs
Post and Print
SAP AG 1999
If test PAYEXT/REMADV records are to be sent out (test flag = 'x') then when the proposal is
scheduled select the Post and Print option.
If actual PAYEXT/REMADV records are to be sent out then do not select the Post and Print option
on the proposal.
After any necessary editing of the payment proposal is done, schedule the payment run. If actual
PAYEXT/REMADV records are to be sent out then select the Post and Print option on the payment
run.
x ?
Status Proposal Parameters Print programs
Identification PAY1
Status
x Entry 0 0
SAP AG 1999
Schedule the proposal run. This will examine all invoices and based on the selection criteria
determine if an invoice will be chosen.
The proposal can then be edited to select the invoices to be paid during the payment run.
If test IDocs are to be generated then mark the Post and Print checkbox.
x ?
Status Log default value Default value Pmnt run Print programs
Identification PAY1
Status
x Entry 0 0
SAP AG 1999
Based on the edited proposal, the final invoices are selected for payment and the payment is created
for the payment method specified in the parameters.
If actual IDocs are to be created, then mark the Post and print checkbox.
SAP AG 1999
SAP AG 1999
A partner profile is created for each house bank sending electronic bank statements or lock box data.
The house bank must be designated as EDI, which is done through the configuration of the house
bank as was done for outbound payments. The DME (data medium of exchange) configuration is
where the trading partner number (name) for the bank is identified. The partner profile can be created
from within the DME configuration or via the normal path to create partner profiles. The partner type
is ‘B' for bank. The house bank DME configuration is done no matter if the incoming payment is via
electronic bank statement or lock box
The Cash Management application must be configured to accept electronic banking statements for
such items as posting rules, company code, data for house bank account, etc.
For lock box, there is also some additional configuration for control parameters, and postings as well
as the configuration items regarding posting rules, company code, data for house bank account, etc.
Please see the appendix or the release notes for 4.0A under Financial Accounting, Bank Accounting,
Enhancements to Inbound Processing in Cash Management.
Customer SAP-User
SAP Server
EDI Server
EDI
EDI IDOC
Interface IDOC
Interface
Pmt. Bank
Advice Stmt.
Table Table
Remittance
Remittance ANSI
Advice ANSI
Advice 823
823Message
Message
Bank Lockbox
LockboxProgram
Program
Lockbox
SAP AG 1999
Customers send their payments to a lockbox. The bank collects the data and sends an ANSI 823
message to the SAP user’s EDI server. The server translates the message using as standard EDI
interface into an IDOC (intermediary document) and sends it to the SAP server.
Once the message is received by the SAP server, the data is stored in the FINSTA01 Lockbox IDoc
Type in the IDoc tables.
At the same time, a program is kicked off which generates the following;
Check information is stored in bank statement tables
Payment advices are created which detail the disposition of the checks i.e. payment amount,
invoice numbers, customer numbers, etc.
Then the lockbox program is launched and the payment advices are cleared against customer open
items. Any checks that could not be fully processed by the lockbox process can be manually
processed using the post processing transaction.
SAP AG 1999
Table T049A indicates the bank identification (Origin) and bank account (Destination). Here also are
specified the company code to receive the funds, house bank, account id, bank G/L account, and the
bank G/L clearing account. The posting parameters are required to determine the posting document
types for the bank and the customer, and the posting keys for the debits and credits for the G/L and
the customer.
Table T049B indicates the general parameters for the lockbox posting. The format that should be
indicated here is LOCKBOX and IDOC. The other posting parameters will be dependant on the
Accounts Receivable department. Typically, the settings would be marked with a check mark for the
G/L account postings, and the Incoming customer payments. If the bank information for the
customer is not already included in the customer master then mark the Insert bank details box and in
the program box insert ADDBNKDETAIL. This will update the customer master with the
customer’s bank information when it coming in on the payment. Additionally, the typical setting for
the G/L account posting type is ‘1’. The setting for partial payments is blank unless the accounts
receivable department will accept partial payments and not wish to create residual items.
Table T049L indicates the lockbox numbers used at your banks for your accounts. All lockboxes for
which you are going to receive checks must be specified here.
As we saw in the creation of outbound payments, we need to configure the partner profile for the
incoming payment transaction. This is done via the DME screen of the House Bank configuration.
Bank statement
IDoc Type FINSTA01 - message type FINSTA
Document type FST (E1IDKU1-BGMTYP)
Bank Account Information (Intraday)
IDoc Type FINSTA01 - message type FINSTA
Document type ACP (E1IDKU1-BGMTYP)
SAP AG 1999
The Account Statement or Electronic Bank Statement can be used for multiple purposes.
It can be a summary statement similar to your personal bank statement showing the month’s
activities in your account(s).
The Account Statement can also be used to show the account activity for a single day and would be
something that would be received on a daily basis.
The differences in the use of the account statement are determined in the field BGMTYP on the
E1IDKU1 segment with FST to indicate the month activities and ACP to indicate the daily activities.
SAP AG 1999
There are several transactions that need to be configured in order for the electronic bank statement or
account polling to work properly.
First we want to add a valid transaction type of IDoc.
The bank must know what transaction type we will be using for the processing. An entry similar to
the lockbox entry is made for the bank identifier and the bank account and the transaction type of
IDoc.
The cash management group should understand what the various activities will be used with the
account and should create the posting rule keys which determine just what the activity is.
The assignment of external transaction codes would be how we interpret the bank’s activity codes
with those we have set up in the system to represent those various activities.
The posting rules will determine what kind of document types are created in the system, the debit
and credit posting keys, and any calculations made on the activity. Again this is something the cash
management or accounts receivable personnel should set up.
As we have seen previously, we may need to set up the bank as a trading partner for the electronic
bank statement. This is done through the House Bank configuration on the DME screen.
SAP AG 1999
Program - SAPLIEDP
Function Group - IEDP
Function Modules:
Outbound - FI_EDI_PAYEXT_PEXR2001_OUT (payment
orders)
Outbound - FI_EDI_REMADV_PEXR2001_OUT (remittance
advices only)
Inbound - IDOC_INPUT_REMADV
Inbound - IDOC_INPUT_FINSTA
Inbound - IDOC_INPUT_LOCKBX
SAP AG 1999
The outbound payment/remittance advice and inbound lockbox, financial statement, and remittance
advice function modules are all found in SAPLIEDP program.
SAP AG 1999
Contents:
Price Catalog
Inventory Advice
SAP AG 1999
SAP AG 1999
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
/3
APR Material PRICAT Creation
S or Article Who gets the information ?
IDocs
and price Which data do they get ?
When do they get the data ?
What is the appropriate format IDocs ALE Layer
tem
ubsys
IS IDoc File
ED
Convert IDoc data into
PRICAT format
Sender
PRICAT Recipients
rs
Use Processing of the Passing on of the
EDI data from PRICAT
PRICAT Message
the database to a
third system Information
SAP AG 1999
We create the price catalog information when we want to send a complete or partial list of product
offerings to our customers.
The price catalog information contains the description of the product, prices and pricing conditions
(including taxes) and logistics information for each product. The price catalog can also contain
general information which is valid for every customer or customer-specific information, such as
special conditions. A time-frame can also be specified for how long the information is valid.
SAP AG 1999
There are many functional areas that require the proper configuration before the PRICAT IDocs can
be created. The materials must be created in the material master with all of the information required
by the price catalog, i.e. the product description, material group, and units of measure to name a few.
The customers must be defined in the customer master and in the appropriate sales are for which you
are going to send the price catalog.
The pricing data must be created. This can take many forms from generic pricing for all customers,
to customer-specific pricing. Any special pricing conditions like discounts and surcharges, freight,
and taxes must be maintained.
Assortment planning gets to what materials are going to be included in the price catalog, and for
which customers in a specific sales area or areas. Assortment planning involved the creation of one
or more assortment modules which are assigned to an assortment. Finally a profile is built and the
units of measure for transfer can be determined.
The creation of the IDoc involves the creation of a partner profile for each recipient defined in
assortment.
The IDocs are created manually via transaction VPRE.
Note: When creating the outbound partner profile, there is no message control involved.
SAP AG 1999
IDoc type WMMBID01 is a very simple IDoc type consisting of a very few segments. A single
header segment which indicates the document and posting dates and the transaction code. A single
item segment which contains the material, plant, storage location, movement type, quantity, unit of
measure, etc.
The transaction code is very important as it indicates if the IDoc is for a goods issue or a transfer
posting. Transaction MB1A is used for goods issue and MB1B is used for transfer posting.
If you would look at the material master, you will find in the plant/storage location data that there are
many buckets which describe the characteristics of the inventory. It is via movement types which are
assigned to one of the two transaction codes that move inventory from one category to another and
perhaps from one plant to another or from a storage location to another storage location.
With the help of the inventory manager, you can decide which plant/storage locations are valid and
what transaction code/movement types are valid for inventory movements.
SAP AG 1999
1-2 Create an Assortment for your group using Sales organization 3000 and
Distribution channel 10, with Material group 010 and your customer number
(300##).
1-6 Use the Monitoring tool, IDoc lists, to look at your PRICAT IDoc.
1-1-2 Select the [Items] button and enter the following information:
1-2-2 Select the [Basic Data] button and enter the following information:
1-2-3 Select the [Material groups] button and enter the following information:
1-2-4 Select the [Assortment user] button and enter the following information:
1-3-2 Select the [Items] button and enter the following information:
1-4-1 Select [New Entries] button and enter the following information:
Contents:
Outbound testing
Inbound testing
Status testing
SAP AG 1999
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
Application
IDoc Interface
WE17
WE14, WE19 WE16
WE18
SAP AG 1999
The arrows show the layers where the tests start, as well as finding the relevant transaction. To the
left is outbound, to the right inbound processing. Depending on the process code (partner profile
entry), the inbound IDocs are processed directly within the application, or via a workflow.
The test tool (WE19) is the most general tool. It allows testing of both inbound and outbound
processing starting with an IDoc created from within the tool.
The other test programs require either a file on the operating system level, an IDoc already present or
a NAST table record (message control).
When choosing a file port for outbound processing, one can run a complete test cycle (outbound and
inbound) including the operating system.
When testing starting from NAST (WE15), one can test if a NAST table record leads to the creation
of a correct outbound IDoc. It requires that processing has to be stopped when the NAST record is
written. This is achieved by setting the message control sending time to 1. The NAST record holds
the processing status 0 (not processed yet). WE15 is nothing more than starting RSNAST00
manually.
Both transaction WE14 and WE19 (IDoc and outbound test tool) test the transfer of one or more
IDocs to the defined port. The former test (WE14) requires an outbound IDoc not yet passed to the
port (IDoc status 30). This is achieved by setting the output mode in the partner profile to collect
IDocs.
Both transactions, modified outbound file (WE12) and test original inbound file (WE16), test the
takeover of an IDoc file by the interface. WE12 changes control record entries to change an
outbound to an inbound IDoc before it passes the IDoc to the interface.
Note: WE16 erases the inbound file after successful reading. This does not apply to the outbound
IDoc file read by WE12. It can be used for further test runs.
SAP AG 1999
The outbound test with transactions WE14 and WE15 requires that areas to be tested do not post and
run immediately, but according to time schedules.
To test creation of IDocs from MM and SD, e.g. ORDERS, DESADV, INVOIC, Message Control
priority has to be 1.
To test transfer of IDocs to file, e.g. EDI subsystem, output mode has to be 3 or 4 in the IDoc
partner profile. Output mode 3 means collect IDocs and start EDI subsystem via synchronous
RFC. Output mode 4 means collect IDocs and do not start EDI subsystem.
With transaction WE15, program RSNAST00, testing of the creation of IDocs is based on the
Message Control record. This is available for applications MM-PUR and SD only, the send priority
in Message Control has to be 1.
With transaction WE14, program RSEOUT00, testing of the forwarding of one or more IDocs to the
receiver system, e.g. an EDI subsystem. This is available for all applications, the output mode in the
IDoc partner profile has to be 3 or 4.
With transaction WE19, the creation of outbound IDoc files is done independently of any application
or implementation.
The IDocs created by WE19 for outbound have as their initial status 42 (instead of status 01) from
release 4.6A on.
SAP AG 1999
The inbound test, whether initiated by transaction WE12 or WE16, picks up IDocs from a file and
posts them to the SAP database. For all three transactions it depends on the process code assigned in
the IDoc partner profile how further processing is done. This affects how and when application
documents are created.
With transaction WE12 a test can be repeated, only the copy is removed, but not the source file itself
(unless the source is overwritten by any other activity or person).
With transaction WE16 the test can be done only once. If it was successful, the source file will be
removed (deleted).
Transaction WE19 allows to repetition of the test via a choice of template (logical message, IDoc
type, or IDoc). Further on it offers functionality to store the IDoc in a file and to use dialog and
debugging modes for the processing.
All IDocs created by WE12, WE16 or WE19 for inbound have as first status 74 (instead of status 50)
from release 4.6A on.
SAP AG 1999
The status test (WE17, WE18) allows checking that status information and details are correct as well
as to test notification procedures defined with SAP Business Workflow. It is required that the status
report references only outbound IDocs that actually exist in the IDoc database.
With transaction WE17 the status report can be processed from the file interface. The test can be
done only once. If it was successful, the source file will be removed (deleted).
With transaction WE18 the status report can be created into a file. The status report can then be
processed immediately or picked up later by transaction WE17.
Transaction WE18 is available from release 4.6A on.
Some port types do not support the status report, therefore it is possible to receive a status report by
IDocs of type SYSTAT01. In this case it is simply an inbound IDoc test with a specific process (e.g.
not ORDERS, but STATUS). Please proceed as described for "IDoc Inbound Testing".
Test Tool
Direct Call
mass testing
(for Inbound only) Function module
create File
SAP AG 1999
SAP AG 1999
Use WE12 (inbound modified outbound file) when MM and SD modules are configured but the EDI
subsystem is not in place yet. This will test the SAP EDI configuration - Message Control, and
Partner Profile configuration.
Use WE16 or WE19 when only one side of the two application modules (MM or SD) is to be
implemented.
Use WE14 or WE15 when you want to simulate the batch environment for outbound documents.
SAP AG 1999
IDocs can be created to test the configuration of the IDoc interface set up
as well as test the application areas. If the legacy system or translator is
not yet available, testing and configuration does not have to wait.
1-1 Copy the successfully posted (status 53) inbound ORDERS IDoc from Unit –
Business Workflow and IDocs, Unit – Error reprocesssing.
1-1-1 Change the quantity fields on the E1EDP01 segment.
1-1-2 Change the quantity field on the E1EDP20 segment to the same number you
changed on the E1EDP01 segment.
1-1-2 Change the overall field on the E1EDS01 segment to reflect your new
quantity times price.
1-1-3 Execute the IDoc by using the function module IDOC_INPUT_ORDERS
1-2 Use Monitoring tool, IDoc lists, to determine the Sales Order number.
________________________________________________________________
1-1-1 Select the Existing IDoc and enter the IDoc number.
1-1-2 Change the quantity fields and net value field on the E1EDP01 segment.
Enter the IDoc number and Press Create icon.
Double click on the E1EDP01 segment.
Change the two quantity fields and the net value field to reflect the new
quantity times the unit price on the E1EDP01 segment.
Press [Enter].
1-1-3 Change the quantity field on the E1EDP20 segment.
Double click on the E1EDP20 segment.
Change the quantity field(s) to match what was entered on the E1EDP01
segment.
Press [Enter].
1-1-4 Change the overall field on the E1EDS01 segment to reflect your new
quantity times price.
Double click on the E1EDS01 segment.
Change the overall field to reflect your new quantity times price.
Press [Enter].
1-1-5 Execute the IDoc by using the function module IDOC_INPUT_ORDERS
Press the [Inbound Function Module] button.
Enter the function module IDOC_INPUT_ORDERS.
Press [Enter].
1-2 Use Monitoring tool, IDoc lists, to determine the sales order number.
From the SAP Easy Access menu, open folders
TOOLS → BUSINESS COMMUNCATION → IDOC → IDOC BASIS →
IDOC → IDOC LISTS
IDoc lists
Field Name Input Data
Date created Keep default
Time created Keep default
Partner number 300##
_______________________________________________
Contents:
Record types, IDoc types, segments
Output formats
Process codes
SAP AG 1999
SAP AG 1999
Documentation Tools
Message Control & IDocs 7 14
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
Segment
Rels.
internal
3.0 external
SAP AG 1999
IDoc Types are distinguished through their segments, i.e. the structure laid upon the unstructured
field SDATA of the data record.These segments exist both in internal and external Form:
the internal form is a release-independent structure (SAP segment names start with E1) containing
all segment fields defined.
the external form is a release-dependent structure (SAP segment names start with E2) containing
only those fields which were defined in the release chosen in the partner profile.
Besides the segments, there are also external and internal structures of the record types. Both have
changed with each release (2.2 to 3.0 to 4.0). Again, the documentation tools only refer to the
external structures.
When running the documentation tools, you have to define:
the release relevant for the segments (which segment definitions). This is the same parameter
which you set when maintaining the partner profile.
the release relevant for the record types. This is the same parameter which you set in the version
when maintaining the port description.
Hierarchy HTML
SAP AG 1999
IDoc types, segments and record types can be displayed in user-friendly and machine readable
formats:
R/3 tree display - this is also used for the record types even if they do not have a hierarchy
HTML - use the *_f file for loading the frame in your Web browser. The other two files created
are the data file (*_d) and the index file (*_i).
Documentation also pertains to the data elements of the segment structure fields. There is application
documentation available for individual IDoc types.
SAP AG 1999
SAP AG 1999
SAP AG 1999
A translator will be used to format IDocs from data received from other
trading partners. It is necessary for the translator to understand the
format of the IDoc type.
1-1 Download the documentation for IDoc type ORDERS01 in ‘C' format.
Contents:
Translating to another Standard
Mandatory control record fields
EDI Subsystem Certification process
SAP AG 1999
SAP AG 1999
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
Communication
SAP AG 1999
The EDI Subsystem has very similar tasks like the IDoc interface - this time, the tasks pertain to the
individual EDI standard, not to the IDoc standard.
The most important task is to translate the two standards (IDoc and EDI standard). This is done by
the Translator
Further processing is called message handling. This is divided into inbound, outbound and status
report, just like in the IDoc interface. The status report on ANSI X.12 messages are called functional
acknowledgements. Instead of IDocs, interchange files are exchanged which may contain more than
one IDoc. A status report on such an interchange file is called an interchange acknowledgement.
The Communication with the external system is like Triggering within the IDoc Interface. Like the
R/3 System, the subsystem owns a gateway.
The Partner Profiles allows configuration processing specific to partner and application document
type. There are also subsystems, which translate into different EDI Standards, depending on the
partner.
The technical communication addresses may be compared to the TXCOM entries in the R/3 system
(see port type CPI-C).
The interchange files and EDI messages are archived in accordance with the legal requirements.
Like the IDoc status, the functional acknowledgements are monitored.
SAP AG 1999
In inbound processing, the IDoc interface connects control record fields to the key fields of the
partner profile. Other fields are explicitly checked during inbound processing.
Therefore, the EDI subsystem must fill certain fields of the control record. Examples:
Partner, message (three fields each) and test flag (1 field) must match one partner profile set. For
instance, the partner function must be left empty if this field is empty in the corresponding partner
profile.
direction = 2 (inbound), structure = EDI_DC40 (external control record structure of Release 4.0).
An R/3 System of Release 3.X would expect another kind of structure.
Receiver's and sender's port
IDoc Type. The IDoc interface checks if it is assigned to a message. The assignment is done via
transaction WE82, starting from the IDoc interface main menu.
Special requirements need additional fields, for example:
(customer's) extension of the IDoc type (see BC621course)
logical Address of Sender/Recipient for automatic forwarding (see “general settings”)
Express flag if inbound processing shall immediately start via an ALE function module.
Other fields will be left empty to avoid mistakes. See the appendix for a complete list of all control
record fields.
Certified process
Purchase Order, out
Customer order, in
Order confirmation, out
P.O. Acknowledgement, in
Certified functionality
file interface w/ RFC
outbound IDoc
status report Document
inbound IDoc
System R/3 System R/3
IDoc IDoc
Transaction
Subsystem Subsystem
SAP AG 1999
The SAP system creates purchase orders in MM. The purchase orders are transferred to the EDI
subsystem as IDocs.
The EDI subsystem translates the IDoc into an EDI message and sends the status report belonging to
that IDoc to SAP. The EDI subsystem then re-translates the EDI message into an IDoc and sends the
IDoc to SAP.
The SAP system receives customer orders in SD. The IDocs are processed and customer orders are
confirmed by order confirmations. The order confirmations are transferred to the EDI subsystem as
IDocs.
The EDI subsystem translates the IDoc into an EDI message and sends the status report belonging to
that IDoc to SAP. The EDI subsystem then re-translates the EDI message into an IDoc and sends the
IDoc to SAP.
The SAP system receives purchase order acknowledgements related to the original purchase orders
in MM. The test cycle is finally evaluated by the application that originated the whole process by
comparing the content of the original purchase order with that of the purchase order
acknowledgement.
A list of certified EDI subsystem vendors you will find in:
OSS note 41365 for releases 3.0/3.1
OSS note 114714 for releases 4.0/4.5/4.6
SAPnet, http://www.sap.com/products/compsoft/certify/index.htm
SAP AG 1999
1-1 _______________ and _______________ are the major tasks of the EDI
subsystem.
1-2 True/False. Functional acknowledgements are sent back into the SAP system.
_________________________________________________________________
1-4 _______________ is similar to the Triggering concept within the IDoc interface.
1-5 What are the mandatory fields on the IDoc control record?
_________________________________________________________________
_________________________________________________________________
1-6 True/False. The partner (number, role, type) and message (type, variant, function)
are the keys to the partner profile and must match exactly with the control record.
_________________________________________________________________
1-1 Translating and Communication are the major tasks of the EDI subsystem.
1-2 False. The results of the functional acknowledgement can be sent back into SAP
as a status record, but the functional acknowledgement itself is not sent back into
SAP.
1-3 True. EDI subsystems have partner profiles that keep such information as the
message type (ANSI 850, EDIFACT ORDERS, etc) and the version, the trading
partner identification, and where to communicate the trading partners
information.
1-4 Communication is similar to the Triggering concept within the IDoc interface.
1-5 The mandatory fields on the IDoc control record are the partner (number, type,
role), message (type, variant, function), test flag.
1-6 False. The test flag is also a key to the partner profile and must also match
exactly between the control record of the IDoc and the partner profile along with
the partner, and message fields.
Contents:
IDoc Display
IDoc Lists and Statistics
Active Monitoring
Find IDoc
Workitem Analysis
Workload Analysis
SAP AG 1999
SAP AG 1999
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc
Mon
Monitori
16
itoring
ng
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
Statistics “RSEIDOCM”
4711
4712
List 4713
4718
Display
SAP AG 1999
In error cases, the IDoc interface always notifies agents actively (error handling via workflow).
In addition, the IDoc interface features three passive and one active program for IDoc monitoring.
The passive monitoring tools can be ordered according to their level of detail. The IDoc statistics
assign IDocs to status groups according to their actual status e.g. “inbound error occurring within the
IDoc interface”. The tool “IDoc list” already lists the single IDocs. Finally, the tool “IDoc display”
allows for direct access to an individual IDoc (display only). Double click goes into the details. The
passive monitoring tools can be found in the IDoc interface menu IDoc.
Active monitoring (Report RSEIDOCM) uses the status groups of IDoc statistics. It is possible to
define boundary values above which responsible agents will be notified via a work item. Active
monitoring can be understood as an individually configurable error handling.
Active monitoring is planned as a job which can be set up through standard job definition. Variants
are created in the ABAP editor.
Control Record
List
List Statistics
Statistics All
All Monitoring
Monitoring
Programs
Programs
Display
Display Display
Display
Active
Active Monitoring
Monitoring
SAP AG 1999
The monitoring programs are reports which select IDocs of the R/3 database according to certain
criteria. These selection fields are part of the IDoc control record.
The most important selection field is the date of IDoc creation. The IDoc statistics tool selects
according to the date of IDoc change. IDoc display offers this field as an additional selection
parameter.
All monitoring programs allow selection of IDocs according to partner and message. In IDoc
statistics, this works via the extended selection.
The highest number of selection fields is offered by the display tool. Besides the IDoc ID, one can
select according to EDI specific parameters (use of an EDI subsystem), e.g. the transmission file
within the EDI subsystem. This enables monitoring of the data flow within the EDI subsystem.
Data Records
Segments
IDoc Display
Statistics
(monitoring
history)
SAP AG 1999
All monitoring programs primarily return fields of the control record. This helps to limit the return
times.
If “repaired IDocs” are traced (function monitoring history in IDoc statistics), then the statistics tool
also checks the status records, which hold IDoc history.
When one goes directly into the display of a single IDoc, all three record types are displayed: control
record, data and status records.
Therefore, IDoc statistics selects all IDocs which have experienced a status change within the pre-set
time interval, while active monitoring selects all IDocs which were created during that time.
4 = “successful
transfer to
target system”
13 = “repeated 12 =
transfer ok” “transfer ok”
39 = “IDoc in
target system
(ALE)”
SAP AG 1999
For better display in active monitoring and statistics, statuses are grouped in status groups.
In the standard, the R/3 system assigns each status to a group via the “qualification” (synonym of
status group). This assignment can be changed from the entrance menu of the IDoc interface by
executing transaction WE47.
For the status groups which are delivered in the R/3 standard, refer to the extended help within the
statistics tool.
Statistics
History
Time Distribution
SAP AG 1999
Graphics may be printed, downloaded to a file or copied to a clipboard for use in presentations.
In IDoc Database or
In IDoc Archive file
SAP AG 1999
It is now possible to find IDocs which contain specific business data. The IDoc data records are
searched for the string of data specified. For example, search for material number 999888.
The search can look for IDocs that are still in the IDoc database or in the IDoc archive file(s).
If the search is made in the archive file, then the prerequisite of the archive file is that an index must
have been built for it. More information about the creation of the archive index is available in the
IDoc Archiving unit.
SAP AG 1999
Workitems are concrete instances of generally defined single step tasks. The IDoc interface mainly
uses them for exception handling in the inbound direction. They contain the faulty IDoc or the faulty
application document which was created from the inbound IDoc.
As in IDoc statistics, the workitem analysis allows for display of a workitem belonging to a specific
task. This can be helpful if no agent could be found for the workitem, and it therefore did not appear
in anybody's inbox. Starting with the workitems, one can jump to IDoc display.
The workitem analysis is reached via transaction SWI2.
SAP AG 1999
Workload analysis shows the distribution of workitems across organizational units or positions.
Workload analysis can be used to determine where there might be an overload situation for one user
as opposed to a too light situation.
The workload analysis is reached via transaction SWI5.
SAP AG 1999
There is a need to determine how many IDocs have been processed and if
they have been processed successfully.
1-1 Determine the number of IDocs by logical message type created during the class
timeframe using the extended evaluation of IDoc statistics.
1-1-1 How many outbound orders have been created and are being sent to the
translator?
1-1-2 How many inbound invoices have successfully created invoice application
documents?
IDoc statistics
Field Name Input Data
Last changed on From date Keep default
Last changed on To date Keep default
Changed at From time Keep default
Changed at To time Keep default
___________________________________________________
1-1-2 Page up using the up arrow on top of screen until come to INVOIC logical
message.
Check value in Completed in application field.
___________________________________________________
Contents:
The Archiving Object IDoc
Status transitions
Achievable Status
SAP AG 1999
SAP AG 1999
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archivin
iving
IDoc
IDocss
17
Miscellaneous Topics 18
Conclusion 19
SAP AG 1999
SAP AG 1999
IDoc interface
Archiving-
programs
optional:
export
File System
SAP AG 1999
Using the archiving programs of the IDoc interface, achievable IDocs are copied from the R/3
database to one or more archive files in the file system (operating system level). The ADK
customizing (archive development kit, extended function library) determines if they are exported to
an external medium, e.g. magnetic-optical disks.
In a second and separate step, the archived IDocs can be deleted from the R/3 database.
The Archiving programs of the IDoc Interface are called via the central archiving transaction SARA,
with argument IDOC as the Archiving object. Through the archiving object, SARA recognizes which
programs to call (object-oriented approach).
The archiving programs require a “variant” containing, for instance, the logical message and the time
period during which IDocs were created. The programs check if the actual status is achievable.
The archiving run is complete after the deleting job is finished. A complete archiving run therefore
really has moved (not copied) IDocs from the database to an external system.
SAP AG 1999
Monitoring
jobs
archives
Customizing
maximum size of archive
direct link to optical archive
logical filename
implicit deleting
Scheduling
SAP AG 1999
Transaction 'SARA' is the control center for any archiving that is done with the ADK:
monitoring scheduled, running or finished jobs
monitoring archives, displaying their status, size, physical location,
Customization allows to control the most important properties like:
maximum size of the archive files
the logical filenames to be used, the mapping from the logical to physical filenames depending on
the various OS is done in transaction FILE
enabling of automatic delete after archiving
link to optical archive
indexing archives
37 31
29
26 2
20
25
42
1
30 3 18 X
39 41
32 33 38 35
40
SAP AG 1999
Status values can be appended to an IDoc only in well-defined combinations. The allowed combinations can be
deduced from the slide. Individual status values are:
01 IDoc created
02 Error passing data to port
03 Data passed to port OK
18 Triggering EDI subsystem OK
20 Error triggering EDI subsystem
25 Processing despite syntax error (outbound)
26 Error during syntax check of IDoc (outbound)
29 Error in ALE service
30 IDoc ready for dispatch (ALE service)
31 Error - no further processing
32 IDoc was edited
33 Original of an IDoc which was edited
35 IDoc reloaded from archive
37 IDoc added incorrectly
38 IDoc archived
39 Receipt confirmed by target system
40 Application document not created in target system
41 Application document created in target system
42 IDoc created by test transaction
X R/3 System connecting point
4 5 7 9 11 23
X 36
24 6 8 10 12 13
15 17
22
14 16
SAP AG 1999
For an EDI Subsystem, the allowed Status transitions are shown above. Symbols/values mean:
X R/3 System connecting point
04 Error within control information of EDI subsystem
05 Error during translation
06 Translation OK
07 Error during syntax check
08 Syntax check OK
09 Error during interchange handling
10 Interchange handling OK
11 Error during dispatch
12 Dispatch OK
13 Retransmission OK
14 Interchange Acknowledgement positive
15 Interchange Acknowledgement negative
16 Functional Acknowledgement positive
17 Functional Acknowledgement negative
22 Dispatch OK, Acknowledgement still due
23 Error during retransmission
24 Control information of EDI subsystem OK
36 Electronic signature not performed (timeout)
56 68
65
63
60
61 52
51
74
50 64 62 53
70 69 73 71 54 57
SAP AG 1999
For inbound processing, the allowed Status transitions are shown above. Values mean:
50 IDoc added
51 Error: Application document not posted
52 Application document not fully posted
53 Application document posted
54 Error during formal application check
56 IDoc with errors added
57 Test IDoc: Error during application check
60 Error during syntax check of IDoc (inbound)
61 Processing despite syntax error (inbound)
62 IDoc passed to application
63 Error passing IDoc to application
64 IDoc ready to be passed to application
65 Error in ALE service
68 Error - no further processing
69 IDoc was edited
70 Original of an IDoc which was edited
71 IDoc reloaded from archive
73 IDoc archived
74 IDoc added by test transaction
IDoc status ..
Description ...
Processing
Direction .
Processing level .
Effect
Qualification
.
Archiving
Poss.
excluded
SAP AG 1999
From the entrance menu of the IDoc interface, use transaction WE47 to assign different attributes to
the individual status values. One attribute is the IDoc with that status as achievable.
Use this transaction to find the general description of status values.
SAP AG 1999
Contents:
Process Codes
System
Status
Status Groups
Display Status
tRFC
File Interface
Generate File Name
SAP AG 1999
SAP AG 1999
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous
Topics
18
Conclusion 19
SAP AG 1999
SAP AG 1999
SAP AG 1999
The system process codes represent the technical error tasks that can occur during IDoc processing.
Some examples would be if the outbound file could not be opened perhaps because of permissions,
the system attempted to create the IDoc from Message Control and had a problem, the system
couldn’t find a partner profile or a message specific partner profile.
New is the ability to set an express flag and notify the IDoc administrator(s). Here we would see a
pop up box when an error has occurred. It is also possible now to deactivate the technical messages
from workflow notification. This would not be recommended however, unless you have other
monitoring in place.
The status process codes are invoked when error statuses are received by SAP from the external
system. Some examples would be if the IDoc could not successfully be translated, or perhaps we
receive a negative functional acknowledgment back from our trading partner.
New also is the ability to set an express flag and receive a pop up box indicating that the error status
has been received so that more proactive action can be taken.
Status Groups:
8 categories for outbound
8 categories for inbound
Assigned to status codes
Used in IDoc statistics monitoring tool
Stop light concept
red - processing completed with errors
yellow - processing incomplete
green - processing completed successfully
SAP AG 1999
Each status code used in IDoc processing is assigned to one of 16 categories (8 outbound, 8
inbound).
Status codes 00 - 49 are assigned to the outbound categories which include generated, ready for
dispatch, being sent, completed in target system, with errors in interface, with errors in external
system, and with delete flag (logically deleted).
Status codes 50-99 are assigned to the inbound categories which include generated, transferred to
application, transferred to dialog, completed in application, with errors in interface, with errors in
application, and with delete flag (logically deleted).
Each of the 16 categories follow a red light concept which we see in the IDoc lists. The red are for
processing completed with errors, yellow are for processing incomplete, and green where processing
has been successfully completed.
SAP AG 1999
While inbound IDoc files are being process or if the inbound file processing is terminated early, an
entry is made in the table EDFI2. The directory path and file name are entered. Additional
information found in this table are the restart points in the file.
Normally, once an inbound file is completely and successfully processed the entry is removed from
this table. If you find entries in this table, it is a red flag that you may be missing inbound
information as some terminations have taken place.
If files of the same directory path and file name are found on this table an attempt will be made to
restart the file from the last record and last IDoc number.
You can clean up this table by resending the file from the translator or utilizing the inbound original
inbound file transaction. You would also want to investigate why files are terminating and staying in
this table.
SAP AG 1999
If the SAP provided function modules for the naming of files sent to the operating system does not
meet your requirements then you can create your own function modules. The new function modules
can be added to the list of valid function modules.
When new ports are created, the new function modules will be available for use.
SAP AG 1999
Contents:
Curriculum Path
SAP AG 1999
SAP AG 1999
SAP AG 1999
Working with an
EDI Subsystem 15
IDoc Monitoring 16
Archiving IDocs 17
Miscellaneous Topics 18
Conclusion
ion 19
SAP AG 1999
BC600
BC600 CA210
CA210 BC619
BC619
BC601
BC601 BC621
BC621
BC610
BC610 WB350 BC660
BC660
SAP AG 1999
CA210 SAP EDI Interface - At the end of CA210 you will be able to configure and implement EDI
within the SAP standard.
BC621 SAP IDoc Development and Extension - At the end of BC621 you will be able to develop
new IDoc types or extend existing IDoc types.
BC600 SAP Business Workflow - Introduction - At the end of BC600 you will be able to use and
implement workflow templates.
BC601 SAP Business Workflow - Build and Use - At the end of BC601 you will be able to build
your own workflows within the SAP standard.
BC610 SAP Business Workflow - Programming - At the end of BC610 you will be able to program
you own workflows within the SAP standard
BC619 SAP ALE Interface - At the end of BC619 you will be able to configure and implement ALE
within the SAP standard.
BC660 Data Archiving - At the end of BC660 you will be able to configure and implement archiving
within the SAP standard.
WB350 Condition Technique - At the end of WB350 you will be able to configure and implement
the various condition techniques within the SAP standard.
SAP AG 1999
SAP AG 1999
Contents:
This section contains supplementary material to be used
as reference
This material is not part of the standard course
Therefore, the instructor might not cover this during the
course presentation
SAP AG 1999
Basic type IDoc type supplied by SAP. Basic types can be modified by
customers to create a new, upward-compatible IDoc type.
Condition record Data record in which the key fields represent the condition under
which the message is "found". The remaining fields describe the
message itself. Therefore, if one of the data records transferred
from the application matches these key fields, the message is
found and can be processed (e.g. exported as a print form or as
an electronic message.
Control record The part of an IDoc which contains the data for identifying the
sender and recipient, as well as the structure of the IDoc itself.
Each IDoc always has one control record.
Data record The part of an IDoc which contains the application data. An
IDoc usually contains more than one data record.
EDI subsystem System which converts the SAP standard IDoc into an
EDI standard (e.g. EDIFACT, ANSI X12) and vice versa. In addition to this
task (which is carried out by the EDI subsystem converter), there are also
administration activities, e.g. archiving the transferred messages, and
technical tasks, e.g. technical connection to the subsequent system and
syntax checks for formats, to be considered.
Field catalog Contains all fields which can be selected as key fields for
condition tables in Message Control.
IDoc Interface Definition of IDoc types and data interchange methods (port
definitions) between SAP Systems and partner systems.
IDoc type SAP format in which the data for business process is to be sent.
An IDoc is a real business process, formatted according to a
certain IDoc type.
Inbound processing Conversion and processing of data for a business process from
the time the data is received in IDoc format to the posting of the
corresponding document(s) in the SAP application.
Mapping Rules for assigning the data elements of an EDI message type to
the fields of an IDoc type.
Message Control Module designed to offer interfaces for further processing for
applications. This includes descriptions of the various data
configurations and the required actions. An example of an action
is printing a document at a certain time in German. The action is
triggered when the application transfers data that matches your
configuration.
Optional segment Part of an IDoc type (standard format for data communication),
which can include additional, optional data about the business
process. The segment does not therefore have to appear in an
IDoc for a specific business process.
Outbound file Contains certain IDocs to be sent for port type “File”.
Outbound processing Conversion and processing of SAP document data from posting a
document to sending the data in IDoc format.
Record type An IDoc type consists of the following three record types:
- Control record
- Data record
- Status record
Required segment The part of an IDoc type which contains important application
data and must therefore exist in an IDoc for an actual business
process.
Segment Structure that includes the application data for an IDoc from the
data records. As a result, the data can be assigned to the correct
application fields.
Status file File that contains the status records sent to the IDoc Interface by
the EDI subsystem for outbound messages.
Status group The status group contains several statuses ("milestones" in the
process chain), so that the monitoring programs only have to
consider these groups and not each individual status. Examples:
Group 3 = outbound: IDoc in the external system
Group B = inbound: IDoc sent to application
Translator Converts internal data formats (IDocs) into EDI messages and
vice versa. The translator is a component of the EDI subsystem.
Tools AcceleratedSAP Customizing Edit Project [SAP Reference IMG] button Basis
Components Basis Services IDoc Interface/Electronic Data Interchange Map long names to
short names.
Tools AcceleratedSAP Customizing Edit Project [SAP Reference IMG] button Financial
Accounting Account Receivable and Accounts Payable Business Transactions Outgoing
Payments Automatic Outgoing Payments Payment Method/Bank Selection Configure
Payment Program Banks Master records Enter company code value [House banks] button
Select the house bank [DME] button Enter EDI partner number [Partner profile] button.
Tools AcceleratedSAP Customizing Edit Project [SAP Reference IMG] Financial
Accounting Account Receivable and Accounts Payable Business Transactions Outgoing
Payments Automatic Outgoing Payments Payment Method/Bank Selection Configure
Payment Program Banks Master records Enter company code value [House banks] button
Select the house bank [DME] btton [EDI-compatible pymt meth.] button.
Sales and Distribution Master Data and Application Processing menu paths:
Logistics Sales and Distribution Master data Business partners Customer Create
Complete.
Logistics Sales and Distribution Master data Business partners Customer Change
Complete.
Logistics Sales and Distribution Master data Business partners Customer Display
Complete.
Logistics Sales and Distribution Master Data Agreements Customer Material Information
Create.
Logistics Sales and Distribution Master Data Agreements Customer Material Information
Change.
Logistics Sales and Distribution Master Data Agreements Customer Material Information
Display.
Logistics Sales and Distribution Sales Order Create.
Logistics Sales and Distribution Sales Order Change. Enter the sales order number then
System Object services Linked IDocs.
Logistics Sales and Distribution Sales Order Display.
Logistics Sales and Distribution Master Data Products Assortments Assortment
Module Create.
Logistics Sales and Distribution Master Data Products Assortments General Assortment
Create.
Logistics Sales and Distribution Master Data Products Assortments Assortment
Module Assortment Assignment Maintain.
Logistics Sales and Distribution Master Data Agreements Catalogs Pricing Catalog
Create.
The following tables contain the fields from the IDoc control record which:
• must always be entered by the external system in structure EDI_DC40
• must be entered in special cases by the external system in structure EDI_DC40
• may be entered by the external system in structure EDI_DC40 (optional fields). If the
values are entered, they are checked by the IDoc Interface.
Field Description
TABNAM Record type (structure): = “EDIDC_40” for IDocs to be processed in Release 4.0.
DIRECT Direction: = “2” (inbound).
IDOCTYP Basic type.
MESTYP Message type, e.g. ORDERS. Assigned to one or more IDoc types in the IDoc
Interface.
SNDPOR Sender port. Must be defined as a port in the receiving R/3 System.
SNDPRN Partner number of the sender. Must correspond to a partner number from the
partner profiles.
SNDPRT Partner type of the sender. “LS” (logical system) in ALE scenarios. In non-ALE
scenarios, this value is usually “KU” (customer) or “LI” (vendor).
RCVPOR Receiver port: = “SAP<SYSID>”, where <SYSID> is the ID of the receiving R/3
System, e.g. C11.
RCVPRN Partner number of the recipient. In ALE scenarios, this value is
<SYSID>CLNT<CLNT>, where <CLNT> is the client of the receiving R/3
System and <SYSID> is defined in the field RCVPOR. In non-ALE scenarios,
this value is application-specific (e.g. the value can be the organization number).
RCVPRT Partner type of the recipient “LS” (logical system) in ALE scenarios. In non-ALE
scenarios, this value is application-specific (e.g. “SD” for the SD module).
Field Description
CIMTYP Customer extension to a basic type. Must be present in the corresponding partner
profile.
MESFCT Message function for further message division. Must be present in the
corresponding partner profile.
MESCOD Message code for further message division. Must be present in the corresponding
partner profile.
SNDPFC Partner function for further partner division. Must be present in the corresponding
partner profile.
TEST Test flag.
EXPRSS Express flag: if this flag is set, the ALE services are called immediately in IDoc
inbound processing.
Optional fields
Field Description
MANDT Client in the R/3 System. An incorrect entry causes an error.
DOCREL R/3 release version. An incorrect entry causes an error.
OUTMOD Outbound processing mode (e.g. send IDocs individually, start subsystem). Each
value is overwritten in inbound processing.
DOCNUM IDoc ID. As the inbound IDoc is generated first in the database, each value here is
overwritten by the internal IDoc ID.
CREDAT Date of IDoc generation. Handling as in DOCNUM.
CRETIM Time of IDoc generation. Handling as in DOCNUM.
Process code and Message type are fields in the IDoc partner profiles, all other fields belong to
Message Control (MC):
#!/bin/sh
DIRWORK=/users/ediadm
cd $DIRWORK
FILE='basename $1'
date >> $DIRWORK/ediadm.trace
echo ++ run external system with file $FILE >> $DIRWORK/ediadm.trace
# insert command to start EDI subsystem here
echo ++ removed IDoc file $FILE from application server >> $DIRWORK/ediadm.trace
chmod 666 $DIRWORK/ediadm.trace
#!/bin/sh
DIREXEC=/users/ediadm/run
DIRWORK=/users/ediadm
cd $DIRWORK
date >> $DIRWORK/ediadm.trace
echo ++ start SAP system with file $1 >> $DIRWORK/ediadm.trace
$DIREXEC/startrfc -3 -t
-d <system ID> -u <user> -p <password> -c <client>
-h <router string> -s <system number>
-g <gateway machine> -x <gateway name>
-F EDI_DATA_INCOMING
-E PATHNAME=$DIRWORK/$1
-E PORT=<subsystem>
chmod 666 $DIRWORK/ediadm.trace
Note: the script for status files only differs from the script for inbound IDocs because the
function module EDI_STATUS_INCOMING is called.
TCP/IP
1. Start Communication
Status records
LU 6.2
SAP AG
The R/2 system is always passive: Communication is always started from the R/3 system. Data
flows are:
- Outbound, IDoc from R/3 to R/2 (R/3 sends IDocs)
- Inbound, IDoc from R/2 to R/3 (R/3 receives IDocs)
- Status report (R/3 sends and receives exactly one Status record per IDoc)
Communication uses the CPI-C commands (Common User Programming Interface). The Gateway
translates the CPI commands to
- commands of the LU 6.2-protocol on the R/2 side (IBM Mainframe)
- commands of the TCP/IP protocol on the R/3 side (Client/Server Systems).
IDocs are stored synchronously in the database.
ID oc Interface
ID O C _IN B O U N D _A S Y N C H R O N O U S
O w n_function O w n _p ro g ram
?
SA P AG 2000
The purpose of the port type ABAP programming interface or „ABAP“ is to allow individually
taylored processing of IDocs. This comprises support of translation and formatting functionality.
For outbound processing the port definition takes the name of a custom implemented function
module. Inside the function module the formatting and communication has to be implemented. The
custom function module has to follow the interface of the template function module
OWN_FUNCTION.
For inbound processing any custom program has to invoke function module
IDOC_INBOUND_ASYNCHRONOUS with the data in IDoc format.
All application tasks can be found by the logical message as search term!
SAP AG 2000
The role resolutions 30000013 and 00000134 hook in on the partner profile level by evaluating the
control record. This requires a unique IDoc in the situation of error.
The role resolution 70000141 hooks in on the partner profile level by deriving that information from
the message control record (NAST record) given.
The role resolution 30000001 hooks in on the IDoc interface profile level, because of an IDoc does
not exist (e.g. file open error), or the technical nature of the error (e.g. syntax error in EDI
subsystem).
The role resolution 30200013 is specific, because the receiver of notification is given explicitly when
the progam RSEIDOCM, which may initiate the notification, is scheduled.
For convenience in the Business Workflow Explorer the notification tasks are grouped into task
groups:
TG70000015 All administration tasks mentioned in above table
TG70000016 All generic tasks of processing, e.g.Forward IDoc
TG20000010 All application tasks for notification mentioned in above table
in use with EDI in the supply-chain.
TG20000011 The 3 groups mentioned before plus inbound processes
implemented as SAP Business Workflows in the supply-chain.
Description
Payment orders and debit memos, which used to be sent by diskette or
telecommunications to the bank executing the order, can now be transmitted via
electronic data interchange (EDI). Thus the house bank receives payment information
quicker than before and can carry out further processing automatically.
Procedure
The application first stores all payment data in intermediate documents (IDoc). At the
same time, the payment program indicates each payment order that can be sent via EDI.
In this way, these payments are reserved for EDI: they cannot be settled via DME or
form printing.
The new payment medium program, RFFOEDI1, processes data to be sent by EDI,
storing the payment data in intermediate documents and transferring it to the EDI
subsystem.
For further information see the program documentation RFFOEDI1.
An external converter creates a standardized message out of the generated data and
sends it to the bank. Subsequent confirmation and authorization can be made within a
workflow. A reference IDoc containing the status of all processed payment IDocs is
returned to the application. Once the bank receives authorization, it begins executing
the transmitted transactions.
To send the created IDocs, you have to make additional settings in the EDI subsystem.
To make these settings, choose Administration Process technology in the System
Administration menu.
For more detailed information on the following points see the “Basis IDoc interface”
documentation.
1. First maintain the port descriptions for one or more ports throught which data
exchange is to be made. To do this, choose IDoc Port definition in the Process
Technology menu.
2. You also need to maintain the partner profiles for each house bank. To do so
choose IDoc Partner profile.
a) First maintain the general data for each bank with partner type “B”. Partner
type “B” is defined in client 000 of the standard system.
b) Define the outbound parameters and the used intermediate document type
“PEXR2001” for each message type (e.g. “PAYEXT” or “DIRDEB”)
c) Define the outbound parameters for the logical bracket around all payment
orders with message type “EUPEXR” and intermediate document type
“IDCREF01”.
d) Define the inbound parameters for the logical bracket around all payment orders
with message type “EUPEXR”. If you want the system to automatically start
processing when an IDoc is received, specify the required process code. If
possible, copy process code “FI04”, which is delivered with the standard
system, from client 000.
3. You can also define your own process codes. To do this choose Control
Inbound process code.
Before confirming and authorizing an EDI message, you need to make sure that the
correct data has been processed and sent. To do this, you compare the reference data
returned by the subsystem with the output data. Data verification and subsequent
authorization can be made within a workflow. Workflow “WS00400051” is delivered
as a model. To use the workflow model in a different client, copy it from client “000”
with the workflow workbench tools and specify an administrator in the basic data for
the workflow.
In the workflow model, the data received is first checked in a background job to see
whether it is correct and complete. A responsible body (person, job, position) is then
determined via a role module (“00400131”) and, depending on the result of the
verification procedure, is later called to confirm the data or erase the reason for an
error.
Further customizing
ISO-Codes are transmitted by EDI – therefore you must maintain both fully and
correctly the tables for converting the SAP codes into ISO codes for currency, units of
measure and countries. For more information on this, access the Implementation Guide
under “Global settings” in the following chapters:
Set countries
Currencies
From an organizational point of view, you need to make sure that no other payment
medium programs access the same dataset at the same time that RFFOEDI1 accesses it.
When you schedule the payment runs in the payment program, RFFOEDI1 will be run
before all other payment medium programs.
If one or more payments could not be made via EDI, you can modify the EDI status of
the payment documents by using program RFFOEDI2. You can then either retransmit
the data by EDI or create a conventional data medium. For further information see the
documentation for program RFFOEDI2.
When using the standard workflow, you need to make sure that an administrator, who
is automatically informed of any errors that occur, is defined with the basic workflow
data.
When you create the output data, you can access the dataset via well-defined interfaces
in order to read or change it. For this purpose, the system supports several customer
functions, which are accessed either dynamically or at predefined (static) points in time.
2. Dynamic calls
In addition to accessing at predefined points in time, you can access the current dataset
via a customer function when writing individual segments. To do this, you first need to
define at which segments the corresponding call up is to take place.
To start with you maintain table “FEDICUS”. For further information, see the step
Call up customer functions in the Financial Accounting Implementation Guide.
Depending on the message type used, the following customer functions are called up:
a) Message type REMADV – accessing function module “001”:
For detailed information, see the documentation for the function module
EXIT_SAPLIEDP_001.
b) Message type PAYEXT – accessing function module “002”:
For detailed information, see the documentation for the function module
EXIT_SAPLIEDP_002.
c) Message type DIRDEB – accessing function module “003”:
For detailed information, see the documentation for the function module
EXIT_SAPLIEDP_003.
Software/hardware requirements
Within a test system you can change all the data within a created IDoc. To do this you
need the following authorizations:
Object: S_’IDOCMONI’
Activity: ‘02’
All changes to an IDoc are logged in the system. To ensure that the subsystem
processes the original data of a payment IDoc, this authorization is restricted to
exceptions and is only for temporary use in the productive system.
Planning
Further notes
The EDI interface enhancement concept allows you to add further segments to the
existing IDoc structures e.g. for industry-specific or customer-specific data. These
segments must then be processed accordingly by the converter.
Example
You can transfer the segment text for an incoming invoice to the payment recipient by
defining a user-defined text segment within the position data as an enhancement and
filling it with a customer function.
For further information on Customizing see the “Accounts Receivable and Accounts
Payable” step in the Financial Accounting Implementation Guide.
Description
This program generates the Intermediate Documents (IDoc) for payment orders made
via EDI.
In addition to the payment media, you can output the related advice notes, EDI
accompanying sheets and payment summaries in a single program run.
For a more detailed description of the entire functionality, see EDI Outgoing Payment
Orders.
Requirements
The parameters that control the process for the payment medium programs are
configured in customizing. For further information on payment program configuration,
refer to the Implementation Guide.
1) Here you need to make specification for the paying company code. To do this,
select the relevant paying company code via Company codes Paying.
If payment advices are to be printed, define a SAPscript payment advice form for
use with all company code payment methods. You will find the form
F110_IN_AVIS as an example in the standard system.
You need to create and enter text modules in which the texts for the header, footer,
signature and sender are stored. These modules can be included in the forms when
they are used. To do this, select Goto Sender details, from where you can also
branch into text maintenance by selecting the modules. The names of the text can
be defined by the user, for example, F_0001_HEADER for the letter header in
company code 0001.
In addition to the payment advice form, you define here the EDI accompanying
sheet (F110_EDI_01 in the standard system).
2) Here you need to make company code specifications for the payment method. To
do this, choose Payment methods In company code, then select the paying
company code and the payment method and maintain the following data via Goto
Form data:
Note: The issuer details are used on the accompanying sheet and must be filled out
as follows:
Line 1 issuer name 1
Line 2 issuer name 2
Line 3 street/P.O.box
Line 4 city
3. The user must define instruction keys to control which instructions are given to the
banks that are required to carry out the payment order.
4. You need to make further specifications for creating the payment medium using the
house banks configuration functions. To do this, select your house bank from the
house bank maintenance screen after entering the paying company code via Goto
House banks, and then maintain the necessary data via Goto DME. For more
details, refer to the online documentation for the relevant fields.
Define a partner number for each house bank that offers EDI. Choose Goto to
maintain the partner profiles and the payment methods allowed for EDI for each
house bank.
5. You must define state control bank indicators which are used in the report to the
central bank.
These central bank indicators are specified when posting the invoice document in
the screen containing extra data. The “SCB/supplying country” field group of the
payments abroad data must therefore be set to required entry or optional entry fields
via the reconciliation account field status.
The following describes the layout of the SAPscript forms in brief. If the forms
available in the standard system are sufficient for your requirements, you can skip this
part of the documentation.
You can find further information on forms and the SAPscript editor in the guides on
styles and form maintenance and Word processing in the SAPscript editor: select the
menu path Help R/3 library.
© SAP AG CA210 20-29
1. When setting up SAPscript forms (layout sets), symbols are included in the text;
these are then replaced by actual values when the payment medium programs are
run. The fields which can be used for this are defined in the Repository and
contained in the following structures:
2.
Note: if you want the document long text for an accounting invoice document to be
printed on the payment advice form, you must make the following enhancement in
element ‘Long text for invoice document’ (specially designed for this purpose):
The text ID that you must enter for this text (xyz) is defined in the configuration
menu and can be read from there. In the standard system, text ID 0003 is
predefined for the payment advice information.
Note: the check totals in the EDI accompanying sheet can be issued via structure
E1IDRS1.
Pages
Pages
FIRST EDI accompanying sheet
LAST form summary section per house bank
Periodic processing
Before the payment medium programs can be started, the payment program run must
have been successfully completed. Check the status of the payment run, or schedule
the payment medium programs by specifying one or more variants.
Note: If you want to use the ‘Payment document update’ option, the payment
documents must be updated between the time of the payment program run and the time
of the payment medium program run.
Output
Printout files are created per company code and house bank. These can either be
printed via the print manager or immediately. Depending on the parameter you select,
you can print out one or more of the following:
The number of output files is specified in the flow trace; this makes finding and
allocating them within the print manager easier.
Note: If the program was started online, then you reach the print manager from the list
generated by selecting one of the output files displayed.
As well as printing payment advice notes, they can also be sent by fax or EDI.
Using an external translator, the IDoc generated by the program must be converted
into the required EDI format (e.g. REMADV) and sent.
2. To send a customer of vendor a payment advice by fax, the output type (print or
fax) selected must be defined using process interface 00002040 (Open FI). A
prerequisite is that preparations for faxing have been made in Basis.
You can also use process interface 00002050 to change the print parameters for
payment advice notes.
IDoc
Payment instructions that have previously been sent to the bank on disk or by data
transmission are now transmitted by EDI via the IDoc interface.
The payment data are stored in the system as SAP intermediate documents. An
external EDI sub-system generates a standardized message based on these IDoc and
sends it to the bank. After receiving confirmation from the payer (e.g. by electronic
signature), the bank processes the payment orders.
Relevant information on each IDoc (file format, creation date, payment amount in local
currency, payment documents used etc.) is stored in the system and, identically to
conventional data media, this can be called up using the DME management functions.
Termination of processing
You can find out the reason why processing was terminated (for example, production
run not yet carried out, form does not exist or is not active) by looking at the error
message or the related long text.
Error log
If errors, which do not terminate the payment medium program occur when creating the
output, the system lists them in the error log. If such a log is created, you must look it
over because only you can decide whether the payment medium or payment advices are
useless due to the errors the system finds, and decide whether they must be recreated
after the errors have been rectified.
During background processing, the system outputs the error log twice, in the flow trace
for the job and in a printout file. The flow trace contains information on how to rectify
the errors (from the error message long texts).
You can display the long text online by choosing the error log from the list of generated
output files and then the error message in question.
Payment orders that cannot be issued by EDI due to various errors that have occurred
are listed in the error log and marked as defective. You then have two options:
3. Send the payment orders in question to the bank using a conventional payment
medium, which is created by the program specified for this purpose in the country-
specific configuration screen for this payment method.
2. Solve the problem described in the long text in the log and then change the status of
the payment from ‘Transmission error’ to ‘Not yet transmitted’, which enables you
to restart the EDI transmission process.
Description
The account statement that was previously retrieved using a file interface can now be
imported by electronic data interchange (EDI). This process is automatic and allows
you to process account statement information in the system.
An account statement consists of two levels. On the summary level, the house bank
account is identified and the current account balance is transmitted. On the sales level,
transactions for the bank account are logged. Sales can be described in detail in some
messages (credit memo or debit note). In this case, only a reference to these messages
is transferred in the account statement.
EDI account statement processing takes place in three steps. In the first step, data is
automatically imported into the system and stored in bank data storage or in the
payment advice note database. In the next step, you have to plan program RFEBKA30,
which generates the postings from the account statement. The subsequent processing
transaction for the electronic bank statement (FEBA) is also available for processing
the account statement.
Procedure
The payee’s bank sends an account statement as an EDI message (like FINSTA in
EDIFACT standard) to its customers. The customer’s EDI subsystem generates an
intermediate document (IDoc type FINSTA01, logical message FINSTA) from the EDI
message, and the intermediate document is forwarded to the SAP system. The process
code from the partner profile controls processing of the intermediate document.
Processing
When the intermediate document is processed, its data is transferred to SAP data
storage for the account statement and the payment advice notes. Customizing will be
evaluated and this data (posting rules, company code, data for house bank account, etc.)
added to the account statement. The system then searches for the credit memos and
debit notes referenced in the account statement and stores the key from the payment
advice note database in the account statement. Information for payment clearing is
© SAP AG CA210 20-35
taken from the advice notes, which contain the document number as well as any other
criteria required by the user. If no detailed data is stored in the credit memo or the
debit note (no advice note items), the data is transferred to the account statement and
the advice note is deleted. If no errors occur, inbound processing ends with an update
of bank data storage. The postings that result from the account statement must then be
generated by a program (RFEBKA30 above).
To set up a partner for inbound account statements with EDI, you have to maintain the
partner profiles for EDI in the system administration menu. Choose Administration
Process Technology IDoc Partner profiles
You have to create a partner with process code ‘FINS’ (input parameters) for input.
The matching message name is ‘FINSTA’. For the credit memo, the process code is
‘CREA’, message ‘CREADV’, while you use process code ‘DEBA’ and message
‘DEBADV’ for the debit note.
For the partner profile for a bank (partner type ‘B’), the bank must be ‘EDI-able’. You
indicate this by entering the EDI partner number in the ‘DME’ part of the house bank
data. This step must be completed prior to maintaining the partner profile, as only
banks marked as ‘EDI-able’ banks can be selected at that point.
Further Customizing
ISO-Codes are transmitted by EDI – therefore you must maintain both fully and
correctly the tables for converting the SAP codes into ISO coded for currency, units of
measure and countries.
For more information on this, access the Implementation Guide under “Global settings”
in the following chapters:
Set countries
Currencies
Data Maintenance:
Activity types
Assign banks
Key for posting rules
Assign activities
Posting rules
Report selection
Maintain task
When the intermediate document is processed, you can access the dataset from defined
interfaces to read or change it. To this end, customer functions are supported that can
be called up at certain times. The function modules are stored in the ‘FEDI0005’
enhancement.
The following customer functions are called when intermediate documents of type
FINSTA01 are processed and can be used for customer modifications:
2. Dynamic Calls
You can also access the dataset when individual segments for each customer
function are written. But you must first define for which segments a call is to take
place.
Maintain the table ‘FEDICUS’.
Function module 202 is called for processing the segments specified in table
FEDICUS.
Detailed information is available in the documentation for function module
EXIT_SAPLIEDP_202 FEDI0005.
Important note:
Enhancement FEB00001 for the electronic bank statement also runs for IDoc input
(program RFEBKA30 calls the program, where the user exit is called). It is not
necessary to transfer the code that may be stored there to one of the customer functions
in enhancement FEDI0005.
Soft/Hardware Conditions
Peculiarities of Installation
You can change all the data from a generated IDoc change within a test system.
However, you require the following authorization:
Object: S_’IDOCMONI’
Activity: ‘02’
Further notes
The enhancement concept for EDI interfaces allows you to add more segments – for
industry or customer-specific data, for instance – to existing IDoc structures. These
must be delivered by the translator.
Description
Lockbox, which has, until now, been retrieved from the house bank using mormal
telecommunications of a lockbox provider, can now be received using Electronic Data
Interchange (EDI). The data flows into the system automatically and you can process it
there.
EDI lockbox processing consists of three steps. In the first step, the data is
automatically imported into the system and stored in the bank data store. The next step
is to schedule the report program RFEBLB30; this uses the lockbox data to generate the
following postings. The last step is to process the lockbox data using transaction
FLB1.
Procedure
The bank or lockbox provider sends the lockbox data as an EDI message (for example:
823 in ANSI X.12 standard) to its customers. The customer’s EDI subsystem uses the
EDI message to create an interim document (IDoc type FINSTA01, logical message
LOCKBX) which it then passes on to the SAP System. Further processing of the
interim document is controlled by the transaction code form the partner agreement.
Processing
During processing, the data is transferred from the interim document into the data store
for lockbox data. The customizing is evaluated and this data (posting rules, company
code, house bank account data, and so on) is added to the lockbox data. If no errors
occur, the system updates the bank data store which completes processing. You must
then run program RFEBLB30 to generate the postings resulting from the lockbox data.
To set up a partner for entering lockbox data using EDI, you must maintain the EDI
partner agreements in the system administration menu. To do this, go to the system
administration menu and choose Administration Process Technology IDoc
Partner profile. You must then create a partner with process code “LOBX” (inbound
parameters). The matching message name is “LOCKBX”. For more information, read
the Basis EDI interface documentation.
Maintain Partner Profiles
In the case of the partner profile for bank/lockbox providers (partner type “B”), the
latter must be flagged as “EDI-compatible”. You effect this by entering the EDI
partner number in the DME part of the house bank data. You must do this BEFORE
Further Customizing
ISO-Codes are transmitted by EDI – therefore you must maintain both fully and
correctly the tables for converting the SAP codes into ISO codes for currency, units of
measure and countries.
For more information on this, access the Implementation Guide under “Global settings”
in the following chapters:
Set countries
Currencies
Generally speaking, you maintain the customizing tables for lockbox processing as you
would for other lockbox formats.
For more information on customizing, go to the Treasury implementation guide and
choose Cash Management Inbox.
Maintaining Data:
Control parameters
Postings
In the event of errors, the system triggers the standard workflow task
LOCKBX_ERROR. You must ensure that the basic data for workflow includes an
administrator that can be automatically informed of any errors.
Maintain Task
During interim document processing, you can intervene to read or change the dataset
using clearly defined interfaces. To this end, the system supports a number of customer
functions, which are accessed at particular times. The function modules are stored in
the enhancement “FEDI00005”.
The following customer functions are accessed during processing of type FINSTA01
interim documents; you can use them for customer modification:
2. Dynamic Access
It is also possible to access the dataset when writing individual segments. You
must first define the segments where you want this to happen.
First, maintain table FEDICUS. For more information, go to the “Access customer
functions” step in the Financial Accounting implementation guide.
Function module 202 is now accessed for processing of the segments specified in
table FEDICUS. For detailed information, read the documentation on function
module EXIT_SAPLIEDP_202 in enhancement FEDI0005.
Important Note:
Enhancement FEBLB001 for lockbox data will also run when IDoc is received.
(Program RFEBLB30 accesses program RFEBLB20, where the user exits are
accessed.) This means that it is not necessary to transfer the data stored there to one of
the customer functions in enhancement FEDI0005.
Soft-/Hardware Prerequisites
You can change all the data from a generated IDoc in a test system. To do this, you
need the following authorization:
Object: S_’IDOCMONI’
Activity: ‘02’
The system logs all the changes made to an IDoc. They ensure that the subsystem
actually does process the original data from a payment IDoc, this authorization should
only be granted in exceptional cases in productive systems, and then only for a limited
time.
Further notes
The Enhancement Concept for the EDI Interface enables you to add segments, such
as for industry- or customer-specific data, to the existing IDoc structure. These must
then be delivered by the converter.
Description
Lockbox Service
Payment transaction in the USA are conducted almost exclusively by check. So that
checks can be deposited more quickly, the banks offer a “lockbox service” whereby
checks are sent directly from customer to the bank (lockbox). The bank credits the
checks to the payee’s account and uses file transfer to pass the information on to the
payee.
Procedure
The bank sends a data carrier to the payee, sometimes several times a day, containing
the most important information on the check (MICR number) and, where appropriate,
the document numbers from the payment memo.
This data carrier is then used to generate postings for accounts receivable and general
ledger (G/L) accounting.
• Quicker check collection, depositing, and crediting means better liquidity for
payees.
• Payees need spend less time on processing payments.
When you use the IDoc interface, SAP Lockbox Processing is a three step process.
- Data is read in automatically and stored in the bank data.
- You must then schedule program RFEBLB30 which processes the lockbox
data (by producing payment memos and postings, creating the check and
posting logs, generating batch input for creating new bank details).
- You can process the data further with transaction FLB1.
Here, you can maintain the parameters for the type of posting and the format of the
lockbox file. Choose “BDB” as the format here.
For each lockbox, you stipulate which accounts are to be posted with which document
types and posting keys. The key is the bank account ID (destination, origin) as
supplied by the lockbox file.
The following list maps the logical messages and IDoc types to the
corresponding ANSI X12 transaction sets. That is, the logical message can be
copied to the transaction sets named.
860 Purchase Order Change Request Outbound ANSI MM/PUR 2.1A ORD_ID01
ORDCHG
3.0A ORDERS01
ORDCHG
3.0D ORDERS02
ORDCHG
4.0A ORDERS03
ORDCHG 4.5A ORDERS04
ORDCHG
4.6A ORDERS05
ORDCHG