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



© 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




Explanation of Terms I

RM-CA (Revenue Management)=

FI-CA

+ IS-T enhancements such as:» Telephone number management/Hot list

» IDoc interfaces




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




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




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


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



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



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



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



IDoc - Structure



IDoc Development Tools

IDoc Type Editor

WE30

E1HDDOCSegment editor

WE31



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



Inbound/Outbound Processing

Outbound Inbound

IDoc Interface / ALE Services

External System

SAP Application

R/3 SystemR/3 System



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


MCMC

recordrecordMCMC

recordrecord

DocumentDocumentDocumentDocument

Message Control (MC)



DocumentDocumentDocumentDocument

IDoc +IDoc +

processprocess

IDoc +IDoc +

processprocess

IDocIDocIDocIDoc

SAP Application

SAP Business Workflow

External System


IDocIDocIDocIDoc

Inbound Processing



Inbound Processing in Detail

Application

IDOC

DB

1. 2.

Trigger by backTrigger by backggroundroundprogramprogram

Trigger Trigger immediatelyimmediately

App DataApp Data




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




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




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




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




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)




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 )




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




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




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



P i L i




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




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




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




Archive Link to Optical Archive

EBSBill document transfer

Archiv

ArchiveLink-to Optical Archive(Dokument-ID

oder Path- & filename)

PRINT

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




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




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




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




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




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




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




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



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

Documents

IDoc Interface E