IDoc Interface E
Embed Size (px)
Transcript of IDoc Interface E

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 1/39
IS-T/IS-U IDoc Interfaces for theFI-CA Document Transfer
From External Billing Systems
Christian Weiß, SAP

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 2/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
FI-CA Document Interfaces
IDocs
Document Transfer Interface
Terminology1
3
Archive Link Interface4
Reversal Interface5
Mass Processing6
Content
7
2

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 3/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Explanation of Terms I
RM-CA (Revenue Management)=
FI-CA
+ IS-T enhancements such as:» Telephone number management/Hot list
» IDoc interfaces

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 4/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
IDocIntermediate Document
EDIElectronic Data Interchange
EDIFACTElectronic Data Interchange for Administration,
Commerce and Transport
ALE Application Link Enabling
EBS
External Billing System
Explanation of Terms II

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 5/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
EDI and ALE
Document
IDoc
Message
IDocIDoc
SAP R/3 SystemSAP R/3 System
EDI SubsystemEDI Subsystem EDI SubsystemEDI Subsystem
SAP R/3 SystemSAP R/3 System

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 6/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
IDoc - Intermediate Document
Message-oriented
System 2System 1
IDocDocument Document
An IDoc is used to exchange business data with an external
system, or with another R/3 System
Asynchronous

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 7/39© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Control record IDoc IDPartner
IDoc type and logical message
External structure
Data recordData record
Control part, contains
segment names
Application data
Field 2Field 1 ...
Status record IDoc IDStatus information
Structure of an IDoc

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 8/39© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
IDoc Type
An IDoc type is a hierarchy made up of segments
and complex data structures that contain businessdata for an application
An IDoc type can be enhanced, without SAP
modifications
An IDoc is linked to an IDoc type

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 9/39© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
IDoc Segment
A segment consists of:
SAP Release-independent segment type. Prefix „E1“
SAP Release-dependent name. Prefix „E2“
-> Version management
Segment types are structures in the ABAP Repository
All segment fields are from type CHAR

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 10/39© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Version Management and Release Management
Integrated version and release management
When the segments and IDoc types are released, the
interface definitions are frozen
Further development leads to new type and segment
versionsdownward compatibility

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 11/39© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
IDoc - Structure

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 12/39© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
IDoc Development Tools
IDoc Type Editor
WE30
E1HDDOCSegment editor
WE31

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 13/39© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Components of IDoc Processing
Application
Function layer
Program
Report
Business workflow
Function layer
IDoc interface
Segment
type
Segment
IDoc type
Segment
name O u t p u t
p r o
c e s s I n p u
t p r o
c e s s
D a t a
s t r u c t u r e

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 14/39© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Inbound/Outbound Processing
Outbound Inbound
IDoc Interface / ALE Services
External System
SAP Application
R/3 SystemR/3 System

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 15/39© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Process Flow: Receiving Data
Outbound Processing
Comm. IDocComm. IDocComm. IDocComm. IDocComm. IDocComm. IDocComm. IDocComm. IDoc Comm. IDocComm. IDocComm. IDocComm. IDoc
M a s t e r I D o c
M a s t e r I D o c
M a s t e r I D o c
M a s t e r I D o c
SAP Application
External System
IDoc Interface / ALE Services
MCMC
recordrecordMCMC
recordrecord
DocumentDocumentDocumentDocument
Message Control (MC)

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 16/39© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
DocumentDocumentDocumentDocument
IDoc +IDoc +
processprocess
IDoc +IDoc +
processprocess
IDocIDocIDocIDoc
SAP Application
SAP Business Workflow
External System
IDoc Interface / ALE Services
IDocIDocIDocIDoc
Inbound Processing

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 17/39© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Inbound Processing in Detail
Application
IDOC
DB
1. 2.
Trigger by backTrigger by backggroundroundprogramprogram
Trigger Trigger immediatelyimmediately
App DataApp Data

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 18/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
R/3 System 1
R/3 System 2
'output'
Determinerecipients
Filter/convert dataCreate IDoc
'input'
Application functionsApplication functions
Filter/convert data
Applicationdata
ApplicationApplicationApplicationApplication
IDoc
Master-IDoc
Comm.-IDocComm.-
IDocComm.-IDoc
Comm.-IDoc
Carrier Carrier
Application ALE Communica-tion
Information Flow
Application ALE

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 19/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
IDoc Port Types
IDoc Interface
XML CPI-C
R/2 System
tRFC
External System
File/
RFC
IDoc/IDoc/
statusstatus
IDoc/IDoc/
statusstatusIDocIDocIDocIDoc
IDoc/IDoc/
statusstatus
IDoc/IDoc/
statusstatusIDocIDocIDocIDoc
PI
IDocIDocIDocIDoc
Internet
IDocIDocIDocIDoc

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 20/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Sender
IDOC
DB
TapeTape
Receiver
IDOC
DB
TRFC QueueTRFC Queue
INBOUND_IDOC_PROCESSINBOUND_IDOC_PROCESS
1. CopyCopy
TRFC callTRFC call
5.
3. StoreStore
AcknowledgeAcknowledge
2.
6. DeleteDelete
TRFC QueueTRFC Queue
4. DeleteDelete
TRFC Example

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 21/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
IDoc Error Processing
Errors are processed in the system in which they occur
En error starts the processing workflow
The employee responsible receives a work item
The error can be verified
The faulty IDoc can be processed again
The work item can be forwarded

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 22/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
IDoc Interface: Summary
Business data is exchanged with an external system via
the IDoc interface. Scenarios are: Electronic Data Interchange (EDI)
Application Link Enabling (ALE)
Coupling of any other business application system (such as PC
applications, external workflow tools) via an IDoc.
The IDoc interface consists of the definition of a data
structure, and a processing logic for this data structure.
Information
(SAP Library – Basis Components Basis Services/CommunicationInterfaces The IDoc Interface)

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 23/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
IS-T/IS-U IDOC Interfaces
1. Bill document transfer + optional CO-PA update
2. Archive Link to optical archived bills
3. Mass reversal
Optical Archiv2
Bel. Nr. Rechn. Nr. Betrag… … …0000815 4709 xx.xx0000816 4710 xx.xx 0000817 4711 storno0000818 4712 xx.xx0000819 4713 xx.xx… … …
Bill 4711
xx.xx3
FI-CA
Bill 4711
xx.xx
Bill 4711
xx.xx
Bill 4711
xx.xx
Bill 4711
xx.xx
FI-CABel. Nr. Rechn. Nr. Betrag… … …0000815 4709 xx.xx0000816 4710 xx.xx 0000817 4711 xx.xx0000818 4712 xx.xx0000819 4713 xx.xx… … …1
EBS
FI Konto Betrag
880000 … 175000 xx.xx
CO-PASparte Menge Betrag
Festnetz xxxx xx.xx
Mobil xxxx xx.xx
Internet xxxx xx.xx
Bill D t T f (B i S i )

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 24/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Bill Document Transfer (Business Scenario)
externes Billing System (EBS)
Doc.no. Item G/L account Amount Quantity
4711 1 175000 8.00
4711 1 080000 50.00 20
4711 2 175000 8.00
4711 2 080000 50.00 10
4711 3 175000 16.00
4711 3 080000 100.00 5
General ledger items (tax and revenue postings)
Doc.no. Currency Date
4711 DEM 09/21/1999
Document header
Business partner items
Doc.no. Item Bus. partner Contr.acct G/L account Amount
4711 1 Mustermann MM01 140000 58.00
4711 2 Mustermann MM01 140000 58.00
4711 3 Mustermann MM01 140000 116.00
IS-T/IS-U FI-CA
Bill
Transfer
Open items
Subtotal 200.00 32.00
Martin Mustermann
Bill number 4711
50.0050.00
100.00
20 Local call10 National
05 International
8.008.00
16.00
Qty Rate Price Taxes
Total 232.00
Value fields
Characteristics
Characteristics
Rate Quantity Revenue
Local call 20 50.00
National 10 50.00
International 5 100.00
CO-PA

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 25/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
IDoc – Structure Type IST_EBS_TOI_COPA
TAX_BASE AMOUNT TAX_ID TAXJURCODE TAX_DATE
CTRACT_ID NET_DATE AMOUNT POS_ID1 POS_ID5....
.TAXJURCODE
TAX_BASE AMOUNT TAX_ID TAXJURCODE TAX_DATE
E1IST_EBS_TOI_HEADER 1-5000 pro iDoc
E1_IST_EBS_TOI_ITEMS 1-9999
E1IST_EBS_TOI_TAX 0 bis 1
E1IST_EBS_TOI_TAX_ALL 0 bis n
REF_DOC_NO DOC_DATE POST_DATE CURRENCY CURRENCY_ISO OBJ_KEY
QUANTITY
CHARACTNAME CHARACTVALUE
E1IST_EBS_TOI_COPA 0 bis 1
UNIT_OF_MEASURE
E1IST_EBS_TOI_COPA 0 bis n

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 26/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Customizing
IMG path
Financial Accounting – Contract Accounting – BusinessTransactions – Periodic Communication with Billing Systems
for IS-T or IS-U
Bill document transfer
•Settings for document transfer •Define CO-PA characteristic derivation for postings•Define Conversion of External Item Identification•Define Conversion of External Tax Identification

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 27/39
P i L i

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 28/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Processing Logic
Generation of G/L offsetting items
Read IDoc data
Reconciliation key assignment
Start mass run
Conversion to SAP format
Create open items and tax lines
Check tax data at document level
Post documents
Stop mass run
Logic
in processing
(Development class IST20,Function group IST_EBS_BILLPOST)
Function moduleIST_EBS_TOI_IDOC_INPUT_COPA
Call with IDoc package,(IDoc up to 5000 documents)
CO-PA external characteristic deriv.
Copy PAOBJNR and quantity fields toG/L items
CO-PA internal characteristic deriv.
T407
End of processing T408
T405
Tax check and line level T406
T401
FuBa
Events
T409
or
1100
1102
1101
Ch t i ti f FI CA D t I

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 29/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Characteristics of FI-CA Document I
Is contained in the Idoc
control record and
corresponds to
the entry in the partner
agreements
Is generated by the EBS
and must be clear within
the EBS
Constant
value
EBS 1
EBS 2
RM-CA
OPBEL...
10000001
AWSYS
LogSys 1
AWKEY
0004711
AWTYP
ISTBS
...
Document header data (table DFKKKO)
...
LogSys1 0004712
LogSys1 0004713
LogSys2 0004711
10000002
10000003
10000004
LogSys2 000471210000005
LogSys2 000471310000006 ISTBS
The key that consists of the fields
AWSYS, AWKEY and AWTYP is used for accessing
the corresponding RM-CA documents, and must
therefore be clear
ISTBS
ISTBS
ISTBS
ISTBS
Ch t i ti f th FI CA D t II

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 30/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Characteristics of the FI-CA Document II
Reconciliation key
•Bill document transfer XPddmmyyyy-nnn(nnn: 001-999)or assignment in EVENT T401•Mass reversal XRddmmyyyy-nnn(nnn: 001-999)
or assignment in EVENT T401
Source•IS-T T1•IS-U R2
Document type•Freely definable in Customizing
A hi Li k t O ti l A hi

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 31/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Archive Link to Optical Archive
EBSBill document transfer
Archiv
ArchiveLink-to Optical Archive(Dokument-ID
oder Path- & filename)
R/3
OPBEL
10000815
AWYS
LS
AWKEY
4711
AWTYP
ISTBS
...
Document header (Table DFKKKO)
... SAP_OBJECT
CA_REF_DOC
OBJECT_ID
LS4711EBS
ARCHIV_ID
A5
ARC_DOC_ID
112.334.56.32
...
Linkage table (Table TOA0x)
Bill document transfer and Archiv
Link Transfer could be done
independent
The values AWSYS, AWKEY and AWTYP building the OBJECT_ID.
The OBJECT_ID is save in the linkage table.
M R l I t f

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 32/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Mass Reversal Interface
RM-CA
Open items
The bill document transfer interface generates
open items in RM-CA. The key
that consists of the fields
AWSYS, AWKEY and AWTYP is created
in the document header
OPBEL...
10000001
AWSYS
LogSys
AWKEY
0004711
AWTYP
ISTBS
...
Document header data (table DFKKKO)
...
LogSys 0004712
LogSys 0004713
10000002
10000003
ISTBS
ISTBS
EBS
Mass reversal
The mass reversal interface only transfers field AWKEY.
This field is sufficient to create the whole key, and to identify
and reverse the corresponding bill document
M A ti iti

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 33/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Mass Activities
Bill document transfer
Transaction: IST_EBS_TOI/IST_EBS_TOI_E
Bill document transfer with CO-PA characteristicsTransaction: IST_EBS_TOI_COPA/IST_EBS_TOI_COPA_E
Mass reversalTransaction: IST_EBS_MRD/IST_EBS_ MRD _E
Archive Link transfer Transaction: IST_EBS_TOI/IST_EBS_TOI_E
Parallel Processing

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 34/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Parallel Processing
x IDocs
Interval 1 Interval 2 Interval mInterval 4Interval 3 ...
Job 1 Job 2 Job n...
x IDocs are divided
into m intervals
m intervals are
processed
in parallel by n Jobs
(n < m)
1000 IDocs
Interval 1
(1 - 200)
Interval 2
(201 - 400)
Interval 4
(601 - 800)
Interval 3
(401 - 600)
Job 1 Job 2
Interval 5
(801 - 1000)
Possible Processing Runs

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 35/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Possible Processing Runs
Status „64“
(IDoc is ready for input
in the application)
Data is sent from the EBS
to the RM-CA
Very high error rate
(due to incorrect
Customizing settings,
for example)
Processing by
mass
activityStatus „53“
(application document
posted)
Status „51“
(application documentnot posted)
Low error rate(manual correction)
Error processing
(change to Customizing
settings, for example)
and scheduling via
mass processing
Status „69“(IDoc was edited)
Scheduling via
mass processing
(NUR STATUS „69“)
Status „53“
(application document
posted)
FI CA Document Interfaces I

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 36/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
FI-CA Document Interfaces I
RFKKBIB0(direct input interface)
+ Mass processing
o File interface- Detailed FI-CA data is required
IS-U Migration workbench
+ Mass processing
o File interface
- Detailed FI-CA data is required
(Batch Input)
FI CA Document Interfaces II

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 37/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
FI-CA Document Interfaces II
IS-U/IS-T IDoc interface
+ Communication interface+ High-performance interface
+ Mass processing
+ Good error processing
+ Remote control of processing by billing system- Complexity (IDOC, ALE, customer enhancement)
Availability / Contact Persons

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 38/39
© SAP AG 2002, FI-CA iDoc Schnittstelle, Christian Weiß
Availability / Contact Persons
Available: IS-T from Release 4.61, CO-PA enhancement with Release
4.63 AOSP10
IS-U from SAP IS-U/CCS 4.64
Contact Persons
Development, Weiß Christian Consulting, Kurt Wieser
Cookbook from Release 4.64 not yet available in SAPNet
Technical Background Programming Objects

7/28/2019 IDoc Interface E
http://slidepdf.com/reader/full/idoc-interface-e 39/39
Technical Background – Programming Objects
Transactions
WE30 -> Definition and release of IDoc types
WE31 -> Definition and release of segments
WE02 -> IDOC list, display IDOCS
WE19 -> IDOC test tool
Mass activities Bill document transfer transaction: IST_EBS_TOI/IST_EBS_TOI_E
Bill document transfer transaction: IST_EBS_TOI_COPA/IST_EBS_TOI_COPA_E
Mass reversal transaction: IST_EBS_MRD/IST_EBS_ MRD _E
Archive Link transfer transaction: IST_EBS_TOI/IST_EBS_TOI_E
Other objects
Development class IST20