You are on page 1of 11

Equipment record

Integration with external


system via IDOC
created by
Selvanayagam

on 29-Aug-2014 04:42, last modified by


on 29-Aug-2014 05:23

Karthi Selvanayagam

Karthi

Version 1
inShare

1. SAP Equipment Record functionality


The equipment record is unique information associated with a material number, and a corresponding
serial number for the material in SAP.

This document basically can be categorized into two major segments


The functionality & features available in equipment record in SAP.
And focuses on the integration of equipment masters with other external applications with help

o
of Idocs

Majorly in HI Tech industries the business tracks these equipments in several ways,
its inventoried within the plant with equipment numbers, and stock transfers are
done to Distribution centers with Serial numbers. And lot of customer / End
consumer information is stored in the Equipment record for future support purposes

2. Business purposes of Equipment


o

Equipment records are delivered to customer sites.

Equipment numbers (serial numbers) consumed in a production order as components

Shipped from stock, Shipped to certain partner locations from where it undergoes installation
protocols
Set of Equipment records are then batched for customer acceptance Via SAP CRM

o
o
o
o

Data updates happen on the Equipment records at various stages of the business, Address
details are updated in the equipments.
Customer acceptance is done with equipment record numbers.
Material returns are taken back at plants with serial numbers / Equipment record.

3. High level Integration flow

4. Partner functions definition and assignment

The feature in equipment record, allows you to define & assign partner functions in them.
Sold to Party

Ship to party

Installation partner

Bill to Party

The Equipment used in a customer delivery can automatically copy the values from the Sales order / or
a delivery and assign the partner functions value in the equipment.

The partner functions could be driven later on for Billing relevant reports, it gives information on which
equipment is delivered / or categorized with that sold to or Bill to customer.

5. Class / characteristics in Equipment record


There is a provision where you could define class with characteristics which can be assigned to an
equipment record
Class type 002 Equipment class can be created and assigned to equipments

Mainly the Bundle information in equipment is stored in the picture above, but otherwise any
parameter related to the equipment could be stored as details in the characteristics.

6. Custom status in Equipment record


The Standard SAP status in an equipment indicates the Delivered / in stock / Available statuses.
Based on customers requirement the User status profile can be configured, and assigned to the
equipment category.
The custom statuses could be numbered, and based on sequences certain controls could be put in
place so that the user is prompted to select these in a order defined in the back end configuration.

This is the Equipment view where the user status profile is assigned, and it shows the different level
of the statuses. These statuses can be manually changed with IE02 / or IQ02, but in the current
integration the Inbound Idoc to ECC controls the status set.

6.1 Configuration menu for the User status.

6.2 Definition of the Status profile, with different statuses .

7.Additional data Tab in Equipment record


The other important feature which is implemented is the View profile change in the Equipment. This
gives the flexibility for the users to add more details, basically the end customer relevant information
like customer hierarchy, Location where the device is set, the I P address of the equipment, and much
other consumer information can be stored

7.1 Defining the view profile

7.2 Assign the view profile to the equipment level, Equipment


category

Part 2 of this document - about the Idoc ALE technical


setups

8. Idoc Settings of the Equipment record


Tcode WE81
We will need message type for Equipment integration through IDOC. For this we may use the existing
message type available in the system or create a new message type using Tcode WE81. Here we use
the existing message type in the system.

Tcode WE30 & WE31

We have created custom IDOC to handle our requirement. This IDOC will contain
the standard sturctures and structures to hold the address of the equipment and the
custom fields. The address will be passed using the segment E1BPAD1VL which is
copied from standrard ADRMAS01 IDOC and the custom fields are passed using
custom segment

Tcode WE82

We have assigned the existing equipment create message type to the IDOC which
created in the previous step. This is required for both the inbound and outbound
IDOC processing as we need message type for each IDOC

9. Inbound IDOC settings:


Tcode WE57

Inbound IDOCs are processed by Function modules. We copied the standard


function group ITOB_BAPI_EQ to a custom function group including the function
modules to custom fuction modules to write additional logic to update address and
the custom fields. Then we have to configure the custom function module copied
from the standard function module IDOC_INPUT_EQUIPMENT_CREATE in the tcode
we57. So when ever an equipment IDOC comes into SAP then this function module
will be triggered first with passing the IDOC details

Tcode BD51

In this setting we instruct SAP system to process the IDOC one by one instead of
executing in bunch as the custom function module cannot process such.

10. Outbound IDOC settings:


Settings for change pointer:
Change pointers are created with respect to message types. For each message type if the setting is
there it will create a change pointer.
In Tcode BD50, message type should be enabled for change pointer creation.

In Tcode BD52, the fields were mentioned for which the change pointer should be added. For our
scenario, we need to send IDOC for any change in the equipment, we set the table key as the change
pointer field and we override the change pointer creation using the BADI mentioned below.

In Tcode BD60, a function module should be assigned. This function module will take care of creating
IDOCs from the change pointer. Our function module is a copy of the standard function module
MASTERIDOC_CREATE_SMD_EQUI. To accommodate the custom details like user status and the
customer field data, we have copied the standard function module and changed it.

In Tcode BD64, settings are done as given below. This settings will determine to which system the IDOC
needs to be sent. For partner profile settings to send and receive IDOC please refer the SAP help
documents.

11 Integration:
Create change pointer:

Whenever equipment is changed, we have to send the changes to other party via
IDOC. Because of having large number of additional fields and the fields may be
added more in the future, also user status is not in the EQUI table, we have written
our own logic to create change pointers for the equipment and user status changes.
This logic was written in the BADI EQUI_UPDATE on the method IN_UPDATE which
will be called during the update task. The following is the sample code for writing
the logic to create change pointers. Pass I as a value to the
object_change_indicator field to make an entry in the change pointer table BDCP2