Enable Currency Overriding and Rate Overriding for a Customer
If you are using the contract-based REST API to integrate MYOB Acumatica with an external system, this external system can enable currency overriding and rate overriding for a customer.
Testing of the Request
Before you test the code below, you need to do the following to configure your client application and the MYOB Acumatica instance to be used:
- Deploy a new MYOB Acumatica instance with the U100 dataset. For details on deploying an instance, see To Deploy an MYOB Acumatica Instance.
- To sign in to the instance in the client application, use the tenant name (which you specified when you created the instance) and the HEADOFFICE branch.
- If you use Postman as the client application for testing, in the IntegrationDevelopmentGuide.postman_collection.json collection (which is located in the IntegrationDevelopment\Help folder of the Help-and-Training-Examples repository on GitHub), make sure the collection variables have the proper values.
- On the Enable/Disable Features (CS100000) form, make sure that the Inventory and Order Management and Multicurrency Accounting features are enabled.
- Configure multicurrency support as follows:
- On the Currencies (CM202000) form, open EUR, select the Active and Use for Accounting boxes, and specify the following values in the other boxes:
- Realized Gain Account: 83100
- Realized Loss Account: 83100
- Unrealized Gain Account: 84000
- Unrealized Loss Account: 84000
- Revaluation Gain Account: 83200
- Revaluation Loss Account: 83200
- Rounding Gain Account: 83100
- Rounding Loss Account: 83100
Save your changes.
- On the Currency Management Preferences (CM101000) form, click Save.
- On the Currency Rate Entry tab of the Currency Rates (CM301000) form, add a row with the following settings:
- From Currency: EUR
- Currency Rate Type: SPOT
- Currency Effective Date: Today
- Currency Rate: 1.1
- Mult./Div.: Multiply
Save your changes.
- On the Currencies (CM202000) form, open EUR, select the Active and Use for Accounting boxes, and specify the following values in the other boxes:
Request
You can use the following request example to update the FRUITICO customer through the contract-based REST API. Through the executing of this request, currency overriding and rate overriding are enabled and the SPOT currency rate type is specified for the customer.
Tip:
In the request example below,
<MYOB Acumatica instance URL>
is the URL of the MYOB Acumatica
instance (such as https://my.acumatica.com/MyInstance). You can omit the instance
name in the URL (that is, you can use https://my.acumatica.com) if the instance
is installed in the root of the website.PUT / HTTP/1.1
Host: [<Acumatica ERP instance URL>]/entity/Default/23.200.001/Customer
Accept: application/json
Content-Type: application/json
{
"CustomerID": {"value": "FRUITICO"},
"EnableCurrencyOverride": {"value": true},
"EnableRateOverride": {"value": true},
"CurrencyRateType": {"value": "SPOT"}
}