Functionality
You can use this method to read ratings for a business partner.
External service providers, government agencies, or departments withinthe company rate business partners for various business processes. Theratings take account of their payment history, credit standing, or othercriteria. The rating is calculated using a defined rating procedure andfor a specific validity period.
You can read several rating results for each rating procedure. Note thatyou can only read one rating result for a particular rating procedurewithin a fixed validity period.
You can read ratings and trends for a rating procedure only if thebusiness partner grants you permission to acquire the rating and savethe results.
Ratings can be differentiated.

Notes
You can specify the amount of ratings to be read (amount of results). Ifyou enter values for all parameters, a maximum of one rating is read.

Authorizations
The system carries out an authorization check if an authorization objectis entered in the authorization group for thebusiness partner.
The standard system checks the authorization object B_BUPA_GRP with the activity 03 (read).
You can make settings for business partner authorization objects to bechecked in Customizing for the SAP Business Partner underBusiness Partner-> Basic Settings-> Authorization Management.

Dependencies
A rating comprises a rating procedure and a rating result. The ratingresult depends on the underlying rating procedure.
You can make settings for rating procedures and ratings in Customizingfor the SAP Business Partner for Financial Services underSettings for Financial Services -> General Settings ->Ratings/Credit Standing -> Ratings -> Set Rating Procedures and Ratings
.
INCLUDE BAPI_RET OBJECT DOKU ID TX

Further information
Further information is available in the SAP Library for the SAPBusiness Partner for Financial Services under Ratings.

Description
This is a compulsory parameter.
You can find information on the meaning of the parameter in thecorresponding documentation for the data element:
Business Partner Number.

Value range
The value range for this parameter corresponds with the value range forthe data element domain.

Description
This parameter is obsolete and no longer has a function.
The system generates change documents automatically.

Value range

Description
You can find information on the meaning of the parameter in thecorresponding documentation for the data element:Date Details for Rating Result.
The parameter contains a field for the date to which the rating is valid
.
Refer to the relevant data element documentation in the ABAP dictionaryfor information about the individual parameter fields.
You cannot transfer values for the following fields; any entries areignored by the system.
TIMESTAMP (Time stamp)
DIFTVAL Characteristic value for differentiation type (relevant forchange documents)
GRADE_METHOD (Rating procedure)
DATE_FROM (Date details for the rating result)
FLG_PERMIT (Rating allowed)
GRADE (Rating result)
TENDENCY (Trend)
DATE_WHEN (Date details for the rating result)
FLG_DEFAULT (Set as standard)
TEXT (Text field length 60)

Description
You can find information on the meaning of the parameter in thecorresponding documentation for the data element:Characteristic Value of Differentiation Type(change document-relevant).
Refer to the relevant data element documentation in the ABAP dictionaryfor information about the individual parameter fields.
You cannot transfer values for the following fields; any entries areignored by the system.
TIMESTAMP (Time stamp)
DATE_TO (Date details for the rating result)
GRADE_METHOD (Rating procedure)
DATE_FROM (Date details for the rating result)
FLG_PERMIT (Rating allowed)
GRADE (Rating result)
TENDENCY (Trend)
DATE_WHEN (Date details for the rating result)
FLG_DEFAULT (Set as standard)
TEXT (Text field length 60)

Description
You can find information on the meaning of the parameter in thecorresponding documentation for the data element:Rating Procedure.
Refer to the relevant data element documentation in the ABAP dictionaryfor information about the individual parameter fields.
You cannot transfer values for the following fields; any entries areignored by the system.
TIMESTAMP (Time stamp)
DIFTVAL Characteristic value for differentiation type (relevant forchange documents)
DATE_TO (Date details for the rating result)
DATE_FROM (Date details for the rating result)
FLG_PERMIT (Rating allowed)
GRADE (Rating result)
TENDENCY (Trend)
DATE_WHEN (Date details for the rating result)
FLG_DEFAULT (Set as standard)
TEXT (Text field length 60)

Description
You can find information on the meaning of the parameter in thecorresponding documentation for the structure:Ratings.
The parameter contains the time-stamp field for the rating.
Refer to the relevant data element documentation in the ABAP dictionaryfor information about the individual parameter fields.
You cannot transfer values for the following fields; any entries areignored by the system.
DIFTVAL Characteristic value for differentiation type (relevant forchange documents)
DATE_TO (Date details for the rating result)
GRADE_METHOD (Rating procedure)
DATE_FROM (Date details for the rating result)
FLG_PERMIT (Rating allowed)
GRADE (Rating result)
TENDENCY (Trend)
DATE_WHEN (Date details for the rating result)
FLG_DEFAULT (Set as standard)
TEXT (Text field length 60)

Description
You can find information on the meaning of the parameter in thecorresponding documentation for the structure:Ratings.
Refer to the relevant data element documentation in the ABAP dictionaryfor information about the individual parameter fields.
You have to transfer values for all fields.

Value range
The value range for this parameter corresponds with the value range forthe structure component.

Description
This table contains the return messages from the method call.