Definition
An interface to maintain exchange rates.
Business Context and Use
The Web service interface Manage Exchange Rate In enables you to connect external applications to your system to create or invalidate exchange rate information in your system.
The Web service interface Manage Exchange Rate In offers the operations Maintain Bundle and Check Maintain Bundle.
Here is an example of a simple Web service request to create an exchange rate:
<n0:ExchangeRateBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global">
<BasicMessageHeader>
<UUID>12345678-90ab-cdef-0123-456789abcdef</UUID>
</BasicMessageHeader>
<ExchangeRate>
<TypeCode>001</TypeCode>
<SourceCurrencyCode>EUR</SourceCurrencyCode>
<TargetCurrencyCode>USD</TargetCurrencyCode>
<MidRate>1.3</MidRate>
<ValidFromDateTime>2013-01-01T12:00:00.0000000Z</ValidFromDateTime>
</ExchangeRate>
</n0:ExchangeRateBundleMaintainRequest_sync>
More Information
General Information
You can find general information about Web services, their structure and consumption in the Web Services documentation. Please open the Web Services document in a new window.
Scenarios
Possible scenarios include the following:
The system never deletes exchange rates physically. Exchange rates are invalidated using an indicator that marks an exchange rate as deleted. If you want to invalidate an exchange rate you have to set the DeletedIndicator to 'true'.
Updates to an exchange rate are not allowed. Once an exchange rate has been created for a specific valid from date and time, it is not possible to change it. It is only possible to create a new entry for a new valid from date and time.
Definition
To create or invalidate exchange rates.
Structure
The request message of the operation Maintain Bundle contains a BasicMessageHeader node element as well as an ExchangeRate node element that contains the exchange rate data to be created or invalidated. The ExchangeRate node can occur multiple times in the request message. Therefore, multiple exchange rates can be maintained via a single Web service request.
The response message type of the operation Maintain Bundle contains log items and a node specific to exchange rates.
Node ExchangeRate
An exchange rate is identified by the following:
The exchange rate type (element TypeCode) is a configurable entity that you can maintain in the Exchange Rate Types fine-tuning activity. The exchange rate type '001' is the default exchange rate type.
The exchange rates in the elements BidRate, MidRate, and AskRate describe the ratio between amounts in the target currency (element TargetCurrencyCode) and the source currency (element SourceCurrencyCode).
The currency codes for the currencies are specified as three-character codes according to ISO 4217.
The date and time combination that indicates the start of the validity of the exchange rate has to be specified in the element ValidFromDateTime.
If the DeletedIndicator is set to 'true', the system will invalidate the exchange rates (BidRate, MidRate, AskRate) identified by the specified exchange rate type, source and target currency as well as the valid from date and time.
Constraints and Integrity Conditions
Element MidRate must be specified. BidRate and AskRate are optional. If any of the elements BidRate or AskRate are not provided, the system will default these rates from element MidRate.
If you specify BidRate or AskRate, the following constraint must be fullfilled: BidRate is less than or equal to MidRate which in turn is less than or equal to AskRate.
Additional Description
A request for the invalidation of an exchange rate will not be accepted if the exchange rate identified by the exchange rate type, the source and target currency as well as the valid from date and time does not exist in the system, or if the rates do not match.
If there is a request to create an exchange rate, the system will check if there is already a set of records for the specified exchange rate type, the source and target currency as well as the valid from date and time. If this is the case and any of the supplied rates differs from the rates in the system, the service will reject the request. If supplied rates and rates in the system match, then the service will ignore the request.