Functionality
You can use this method to change 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 change multiple rating results for each rating procedure. Notethat you can only change one rating result for a particular ratingprocedure within a fixed validity period.
You can change 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 change only one record with ratings for each business partner.
A preprocessing run takes place before the data is changed:

• A check is performed to determine whether the business partner is
available for processing.

• A simple exclusive lock is activated.

This prevents other users from changing the business partner that iscurrently being processed until either the method TransactionCommit
or TransactionRollback for the Business ObjectBapiService is executed. The authorized user can access the samebusiness partner repeatedly.
The rating is not written to the database until the methodTransactionCommit for the Business Object BapiService hasbeen called.

Authorizations
You can make settings for business partner authorization objects to bechecked in Customizing for the SAP Business Partner underBusiness Partner-> Basic Settings-> Authorization Management.

Buffering
This method works with buffering. Change and read methods for thisbusiness object category can be repeatedly used for this instance. Aftercalling the save method, read and write methods can access the bufferedinstances and supply current attributes in the same Logical Unit of Work (LUW)
.

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
.
If you want to change differentiated ratings, the system then carriesout the following checks:


• It checks whether the business partner is available in a role that
permits differentiation.

• It checks whether the differentiation criterion is permissible.

If the entries in the Customizing settings for differentiationare correct, then you can change ratings.
You make settings for differentiation in Customizing for theSAP Business Partner for Financial Services under Settingsfor Financial Services-> General Settings-> Basic Settings->Differentiation-> Define Differentiation Criterions and SetDifferentiation Criterion.
INCLUDE BAPI_RET OBJECT DOKU ID TX
If errors occur, the entire Logical Unit of Work (LUW) must be discarded. To do this, call themethod TransactionRollback for the Business ObjectBapiService.

Further information
Further information is available in the SAP Library for the SAPBusiness Partner for Financial Services under Functions-> SAPBusiness Partner Data-> 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 domain for the data element.

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

Value range
STYLE S_DOCUS1

Description
You can find information on the meaning of the parameter in thecorresponding documentation for the data element: Switchto Simulation Mode for Write BAPIs.

Value range
'X' Method is called in simulation mode, that is to say, the data is notupdated.
' ' Method is not called in simulation mode, that is to say, the data isupdated.

Default
' ' Method is not called in simulation mode.
STYLE *

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.
This is a compulsory parameter.
You have to transfer values for all fields.
Note that fields 'FLG_DEFAULT' and 'TIMESTAMP' are obsolete and, ifthese fields contain entries, they will be intialized by the ratingBAPIs.

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

Description
This is a compulsory parameter.
You can find information on the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.

Value range
'X' Field is change-relevant
' ' Field is not change-relevant

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