Functionality
This function module reads the TSW partner role for a fully specifiedkey.

Notes
A partner role is defined in the master data record used to define abusiness partner. The partner role includes information about theactivities that the business partner can carry out and where thebusiness partner carries out these activities. Stockholding objects,such as plants and storage locations, can also be defined as partnerroles.
A partner role is defined using existing SAP System master data recordssuch as a vendor, customer, or plant.
Because the partner role defines the activities which a businesspartner carries out within the TSW supply chain, transport systemsand/or locations must be assigned in the master data record of eachpartner role.

Structure
Each partner object (vendor, customer, plant, storage location)corresponds to certain pre-defined role types. The role type, in turn,determines which differentiator object (transport system and/orlocation) is valid for the partner role being defined. A role type andthe associated differentiator is assigned when creating the master datarecord of each partner role.
The following table illustrates the relationship between partner object,role type, and differentiator when creating a TSW partner role.
Partner Object ,,Role Type ID ,,Desciption ,,Differentiator
Vendor ,,TSW001 ,,Carrier ,,Transport System
Vendor ,,TSW002 ,,Shipper ,,Transport System
Vendor ,,TSW003 ,,Supplier ,,Transport System location
Plant ,,TSW003 ,,Supplier ,,Transport System location
Plant/Storage Loc. ,,TSW003 ,,Supplier ,,Transport System location
Vendor ,,TSW004 ,,Suppl.in Pipe ,,Transport System
Customer ,,TSW005 ,,Receiver ,,Transport System location
Plant ,,TSW005 ,,Receiver ,,Transport System location
Plant/Storage Loc. ,,TSW005 ,,Receiver ,,Transport System location
Customer ,,TSW006 ,,Rec. in Pipe ,,Transport System
Vendor ,,TSW007 ,,Consignee
Vendor ,,TSW008 ,,Tanker ,,Transport System location
Customer ,,TSW008 ,,Tanker ,,Transport System location
Vendor ,,TSW009 ,,Inspector ,,Location
Plant/Storage Loc. ,,TSW010 ,,Breakout S/L ,,Transport System location

Examples
To read the vendor ABC partner data (within the TSW supply chain)defined as a carrier for transport system XYZ , enter the following keyfields.
VENDORID ,,,,ABC
ROLETYPE ,,,,TSW001
ROLETYPEDIFFERNTIATOR XYZ
To read the plant / storage location ABCD/EFGH partner data defined as asupplying plant for transport system UVW at Location XYZ, enter thefollowing key fields.
PLANTID ,,,,ABCD
STORAGELOCATIONID ,,EFGH
ROLETYPE ,,,,TSW003
ROLETYPEDIFFERNTIATOR UVW XYZ

Note
As the role type differentiator is a composite of transport system IDand/or location ID, the first 10 characters of the field receive theTransport System ID and the last 10 characters ofthe field contain the Location ID.

Description
CUSTOMERID

Description
PLANTID

Definition
A TSW partner role type determines the business function that can becarried out by a partner.

Use
At the present time, the following role types are recognized inconnection with the primary distribution process:

• TSW001 - Carrier


• TSW002 - Shipper


• TSW003 - Supplier


• TSW004 - Supplier in pipe


• TSW005 - Receiver


• TSW006 - Receiver in pipe


• TSW007 - Consignee


• TSW008 - Tanker


• TSW009 - Inspector


• TSW010 - Breakout storage location - locational


• TSW011 - Breakout storage location - notional

Procedure
Some of the available TSW role types can be used according to the rolepartner types.


Role Partner Type : Customer


• TSW005 - Receiver


• TSW006 - Receiver in pipe


• TSW008 - Tanker

Role Partner Type : Vendor

• TSW001 - Carrier


• TSW002 - Shipper


• TSW003 - Supplier


• TSW004 - Supplier in pipe


• TSW007 - Consignee


• TSW008 - Tanker


• TSW009 - Inspector

Role Partner Type : Plant

• TSW003 - Supplier


• TSW005 - Receiver


• TSW010 - Breakout storage location - locational


• TSW011 - Breakout storage location - notional

Role partner type : Plant / storage location

• TSW003 - Supplier


• TSW005 - Receiver


• TSW010 - Breakout storage location - locational


• TSW011 - Breakout storage location - notional

Description
Partner roles are defined with a particular role type and are associatedwith a transport system, location, or transport system-locationcombination.

Description
Storage Location ID

Description
Vendor Number
This table allows you to add to the export parameters of the BAPIwithout modifying it.
With this table you can:


• Adapt existing SAP database tables by

Adding customer-specific fields to SAP tables
Including existing database fields

• Includr additional customer-specific database tables

The following BAPI table extension is available:

• BAPI_TE_OIJRRA

TSW Partner Role Master Data (IS-Oil TSW)

Description

Description

Fields
CUSTOMERID
VENDORID
PLANTID
STORAGELOCATIONID
ROLETYPEE
PARTNERTYPETEXT
ROLETYPEDIFFERNTIATOR
TRANSPORTSYSTEM
TRANSPORTSYSTEMNAME
LOCATIOND
LOCATIONNAME
PARTNERTYPE
COMMONPARTNERID
PARTNERIDBYTS
TICKNUMBERRULE
BLOCKINGINDICATOR
DELTIONINDICATOR

Description
Return parameter
INCLUDE BAPI_TABLE
For information on the meaning of the individual fields in the
structure, see the corresponding data element documentation for the
individual fields.

Value range

Type,,ID Number Message
E ,,OD 675 You are not authorized to run this program
S ,,OIJ_IF 009 Partner role &1 for object &23 and differentiator 4 exists
E ,,OIJ_IF 010 Key fields not completely specified
W OIJ_IF 011 Partner role &1 for obj. &2 &3and differentiator &4 marked for deletion
E ,,OIJ_IF 012 Partner role &1 for obj. &23 and differentiator 4 does not exist