Megaventory API v2017a

<back to all web services

CurrencyUpdate

The following routes are available for this service:
POST/Currency/CurrencyUpdateInserts a currency or updates a current currency.Uses your API Key and applies a mvRecordAction value on an mvCurrency object. We can insert the mvCurrency object we specified using "Insert" as our mvRecordAction. We can update a current currency using "Update". We can insert a currency if it doesn't already exist, update it if it does using "InsertOrUpdate" and we can insert new fields or update non-empty fields of the currency using "InsertOrUpdateNonEmptyFields". Optionally, you can use mvInsertUpdateDeleteSourceApplication when an external application ( eg Magento ) is the one that triggers the CurrencyUpdate call. CurrencyId cannot be updated. There is only one currency that is default. There cannot be a case where a default currency does not exist.

Examples:



A.

Inserts a Non-Default Currency and enables it to appear on reports.

Value:

{
   "mvCurrency": {
      "CurrencyCode": "UGS",
      "CurrencyDescription": "Uganda Shilling (UGS) ",
      "CurrencySymbol": "UGS",
      "CurrencyIsDefault": false,
      "CurrencyInReports": true
   },
   "mvRecordAction": "Insert"
}


Response: 

{
   "mvCurrency": {
      "CurrencyId": 23,
      "CurrencyCode": "UGS",
      "CurrencyDescription": "Uganda Shilling (UGS) ",
      "CurrencySymbol": "UGS",
      "CurrencyIsDefault": false,
      "CurrencyInReports": true
   },
   "ResponseStatus": {
      "ErrorCode": "0"
   },
   "entityID": 23
}

B.



Update the Currency you just added to not appear in reports.

Value: 

{
   "mvCurrency": {
      "CurrencyDescription": "Uganda Shilling (UGS) - new description",
      "CurrencyCode": "UGS",
      "CurrencySymbol": "UGS",
      "CurrencyIsDefault": false,
      "CurrencyInReports": false
   },
   "mvRecordAction": "Update"
}


Response: 

{
   "mvCurrency": {
      "CurrencyId": 23,
      "CurrencyCode": "UGS",
      "CurrencyDescription": "Uganda Shilling (UGS) - new description",
      "CurrencySymbol": "UGS",
      "CurrencyIsDefault": false,
      "CurrencyInReports": false
   },
   "ResponseStatus": {
      "ErrorCode": "0"
   },
   "entityID": 23
}

To override the Content-type in your clients HTTP Accept Header, append the .csv suffix or ?format=csv

HTTP + CSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /csv/reply/CurrencyUpdate HTTP/1.1 
Host: api.megaventory.com 
Content-Type: text/csv
Content-Length: length

CurrencyId,CurrencyCode,CurrencyDescription,CurrencySymbol,CurrencyIsDefault,CurrencyInReports
0,String,String,String,False,False


HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length

CurrencyId,CurrencyCode,CurrencyDescription,CurrencySymbol,CurrencyIsDefault,CurrencyInReports
0,String,String,String,False,False