Loading.....

Definition

Business Context and Use

The Read Service Product inbound service operation retrieves the complete data available on a specified service product. This includes information such as the descriptions in different languages, set type data such as the tax classification, and other products connected by relationships.

Further business context is provided in the documentation for the Product Data Maintenance process component and the Service Product business object.

Related Operations

• The Find Service Product Basic Data by Elements inbound service operation finds the basic data of service products that match the specified search critieria.
• The Create Service Product inbound synchronous service operation creates a service product, including such information as basic data, descriptive data, control data, and any other related data.
• The Change Service Product inbound synchronous service operation changes a specified service product, including such information as basic data, descriptive data, control data, and any other related data.
• The Read Service Product Attachment Folder  inbound service operation retrieves a specified document or all documents attached to a given service product.

Features

The service operation allows data to be retrieved for products of type “Service”.

To read a service product the following information is mandatory.

• The internal identifier of the service product (InternalID element)

The response message for this service operation returns all data parts of the service product, including code names (texts) and the formatted name and description. The service oepration always reads the complete product, it is not possible to restrict the selection of data to specific data, such as just the descriptions. The data scope depends on the product category of the service product and the assigned set types. The response message also includes a Log that includes any error messages.

To return the contents of any attachments use the Read Service Product Attachment Folder service operation.

Processing

Reuse Components

AttachmentFolder

TextCollection

Scheme Attributes at IDs and Codes

Error Handling

For every error from validation, mapping and API Adaptor phases, an appropriate error message that often helps to correct the error is sent to the GDT Log . This is returned as part of the response message.

Integration

Notes on SAP Implementation

Processing
See SAP Notes 1251659, 1256151, and 1256762. 

Enhancements

The Business Add-In (BAdI) definition CRM_SE_SRVCPRODIDQRI is available for this operation.

Code Example
The following example is an excerpt of an XML message for the Read Service Product operation.
Note: The example contains sample data that applies to a specific configuration and master data scenario.

<n0:ServiceProductCRMByIDQuery_sync xmlns:n0=" http://sap.com/xi/CRM/Global2 ">
 <ServiceProductSelectionByID>
  <InternalID schemeID="Str 1" schemeAgencyID="Str 2">TEST20100722</InternalID>
  <SourceBusinessSystemID>Q9MCLNT506</SourceBusinessSystemID>
 </ServiceProductSelectionByID>
</n0:ServiceProductCRMByIDQuery_sync>

ES Bundles

This operation is contained in the following ES Bundles:

• Product Master Data Management
• Sales Incentive and Commission Management