Description of Interface (SAP Library - External Services Management (MM-SRV))

Description of Interface

The interface for data interchange is based on the Business Application Interfaces (BAPIs) of MM Materials Management. It enables you to exchange the following objects:

Service master records
Purchase orders
Contracts
Service entry sheets

The data is converted from an external format into the SAP format or vice-versa with the aid of the SAP enhancement SRVESI. This allows you to adjust the data format to suit your requirements.

A precondition is that you must activate the SAP enhancement SRVESI in Customizing.

Data interchange is still possible if you do not activate this enhancement, but in this case the system automatically uses a predefined data format.

Predefined Data Format

The predefined data format is also oriented on the Business Application Interface (BAPI) for external service documents (e.g. BAPI_REQUISITION_CREATE) and the SAP data model.

Record Types

The user data is exchanged in the form of data records whose structures are defined in the SAP Data Dictionary. Each structure is uniquely assigned to a record type:

DDIC structure	Record type	Meaning
BAPI_STAT	0	Status record
BAPI_MDRV	1	Header/item data, purch. doc.
		(RFQ, quote, PO, contract)
BAPI_ESLL	2	Service/outline line
BAPI_ESUC	3	Limits, purchase order
BAPI_ASMD	4	Service master
BAPI_ESSR	5	Entry sheet header
BAPI_EKKN	6	Acct. assignment, purch. doc.
BAPI_ESKN	7	Acct. assignment, entry sheet
BAPI_ESKL	8	Acct. assgt. link, service line

Data Model

The SAP data records are linked in accordance with the SAP data model.
You can access detailed information on the SAP data model (graphical display, data records, fields) within the SAP development environment using the SAP transaction SD11.

The following list contains the most important assignment rules for the data records:

Assignment of data records	Realized with fields
Purchasing document - service outline	PACKNO
Entry sheet - service outline	PACKNO
Service outline - services	SUB_PACKNO, PACKNO
Purchasing document - account assignment	EBELN, EBELP
Entry sheet - account assignment	LBLNI, PACKNO
Service account assignment link - account assignment	ZEKKN

Data Carrier Format

The file is organized sequentially.

The data records are outputted in ASCII format.

The data carrier record length is 78 bytes.

Each data carrier data record ends with the character ‘ <’.

SAP data records with a length of more than 78 characters are divided among several data carrier records. The continuation character is ‘>’.

The following data record description results:

Character	Contents
1	Record type or continuation character
2-77	User data
78	End character

Note

It was decided to limit the data carrier record length to 78 characters to facilitate secure transmission of the data via Internet mail.

Interface ID

Each transfer file starts with the data record BAPI_STAT. The specific instances of the fields SATZART and MARK are predefined.

SATZART ‘0’
MARK ‘SAP R/3’.

All other fields in the structure are for information and are at your disposal.

Further Information

For more detailed information on the predefined data format, refer to R/3 Note no. 77272, Exchange of Data During Entry of Services Performed.