Megaventory API v2017a

<back to all web services

TaxUpdate

The following routes are available for this service:
POST/Tax/TaxUpdateInserts a tax or updates a current tax.Uses your API Key and applies a mvRecordAction value on an mvTax object. We can insert the mvTax object we specified using "Insert" as our mvRecordAction. We can update a current tax using "Update", we can insert it 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 tax using "InsertOrUpdateNonEmptyFields". Optionally, you can use mvInsertUpdateDeleteSourceApplication when an external application ( eg Magento ) is the one that triggers the TaxUpdate call. Only the TaxDescription field can be updated.

Examples:



A.

Updates a tax's description.

Value:

{
   "mvTax": {
      "TaxID": 3,
      "TaxName": "tea",
      "TaxDescription": "NEW DESCRIPTION",
      "TaxValue": 6.6
   },
   "mvRecordAction": "Update"
} 


Response:

{
   "mvTax": {
      "TaxID": 3,
      "TaxName": "tea",
      "TaxDescription": "NEW DESCRIPTION",
      "TaxValue": 6.6
   },
   "ResponseStatus": {
      "ErrorCode": "0"
   },
   "entityID": 3
}
 

B.



Insert a new tax to our list of taxes.

Value:

 {
   "mvTax": {
      "TaxName": "newsteepTAX",
      "TaxDescription": "Inserting a new steep tax",
      "TaxValue": 16.16
   },
   "mvRecordAction": "Insert",
   "mvInsertUpdateDeleteSourceApplication": "Magento"
} 


Response:

 {
   "mvTax": {
      "TaxID": 12,
      "TaxName": "newsteepTAX",
      "TaxDescription": "Inserting a new steep tax",
      "TaxValue": 16.16
   },
   "ResponseStatus": {
      "ErrorCode": "0"
   },
   "entityID": 12
} 

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

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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

POST /json/reply/TaxUpdate HTTP/1.1 
Host: api.megaventory.com 
Content-Type: application/json
Content-Length: length

{"APIKEY":"String","mvTax":{"TaxID":0,"TaxName":"String","TaxDescription":"String","TaxValue":0.00},"mvRecordAction":"Insert","mvInsertUpdateDeleteSourceApplication":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"mvTax":{"TaxID":0,"TaxName":"String","TaxDescription":"String","TaxValue":0.00},"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String"}]},"entityID":0,"InternalErrorCode":"String"}