Megaventory API v2017a

<back to all web services

ProductSupplierUpdate

Inserts a product-supplier relationship or updates an existing oneUses your API Key and applies a mvRecordAction value on an mvProductSupplier object. We can use "Insert" as our mvRecordAction to add a new product-supplier relationship or update the product-supplier relationship using either "Update" or "InsertOrUpdate" or "InsertOrUpdateNonEmptyFields" as our mvRecordAction.

Examples:



A.

Add a new product-supplier relationship.

Value:

 {
   "mvProductSupplierUpdate": {
    "ProductID": 1,
    "ProductSupplierID": 6,
    "IsMainSupplier": false,
    "ProductSupplierLeadTime": {
      "LeadTimeDescription": "Test Test"
    },
    "ProductSupplierQuantityRange": {
      "QuantityRangeID": "0",
      "QuantityRangeDescription": "Test"
    }
  },
  "mvRecordAction": "Insert"
}


Response: 

 {
    "mvProductSupplier": {
    "ProductID": 1,
    "ProductSupplierID": 6,
    "IsMainSupplier": false,
    "ProductSupplierPrice": 0,
    "ProductSupplierLeadTime": {
      "LeadTimeID": 0,
      "LeadTimeDescription": "Test Test",
      "LeadTimeMinDaysFromNow": 0,
      "LeadTimeMaxDaysFromNow": 0,
      "LeadTimeIsDefault": false
    },
    "ProductSupplierQuantityRange": {
      "QuantityRangeID": 0,
      "QuantityRangeDescription": "Test",
      "QuantityRangeMinQuantity": 0,
      "QuantityRangeMaxQuantity": 0,
      "QuantityRangeIsDefault": false
    },
      "DefaultPurchaseQuantity": 1,
      "MinimumPurchaseQuantity": 1,
      "MaximumPurchaseQuantity": 500
  },
  "ResponseStatus": {
    "ErrorCode": "0"
  }
}

B.

Update a product-supplier relationship.

Value:

 {
   "mvProductSupplierUpdate": {
      "ProductID": "422",
      "ProductSupplierID": "69",
      "IsMainSupplier": "true",
      "ProductSupplierLeadTime": {
         "LeadTimeDescription": "Test Test"
      },
      "ProductPurchasePrice": "0.98",
      "ProductSupplierQuantityRange": {
         "QuantityRange": 0,
         "QuantityRangeDescription": "Test"
      }
   },
   "mvRecordAction": "Update"
}


Response: 

 {
    "mvProductSupplier": {
    "ProductID": 422,
    "ProductSupplierID": 69,
    "IsMainSupplier": true,
    "ProductSupplierPrice": 0,
    "ProductSupplierLeadTime": {
      "LeadTimeID": 0,
      "LeadTimeDescription": "Test Test",
      "LeadTimeMinDaysFromNow": 0,
      "LeadTimeMaxDaysFromNow": 0,
      "LeadTimeIsDefault": false
    },
    "ProductSupplierQuantityRange": {
      "QuantityRangeID": 0,
      "QuantityRangeDescription": "Test",
      "QuantityRangeMinQuantity": 0,
      "QuantityRangeMaxQuantity": 0,
      "QuantityRangeIsDefault": false
    },
      "DefaultPurchaseQuantity": 1,
      "MinimumPurchaseQuantity": 1,
      "MaximumPurchaseQuantity": 500
  },
  "ResponseStatus": {
    "ErrorCode": "0"
  }
}

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

HTTP + SOAP12

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

POST /soap12 HTTP/1.1 
Host: api.megaventory.com 
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
    <soap12:Body>

<ProductSupplierUpdate xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Megaventory.APIEndpoints.Operations">
  <APIKEY>String</APIKEY>
  <mvProductSupplierUpdate xmlns:d2p1="https://api.megaventory.com/types" i:nil="true" />
  <mvRecordAction>Insert</mvRecordAction>
</ProductSupplierUpdate>

    </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
    <soap12:Body>

<ProductSupplierUpdateResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Megaventory.APIEndpoints.Operations">
  <mvProductSupplier xmlns:d2p1="https://api.megaventory.com/types" i:nil="true" />
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
      </d2p1:ResponseError>
    </d2p1:Errors>
  </ResponseStatus>
  <InternalErrorCode>String</InternalErrorCode>
</ProductSupplierUpdateResponse>

    </soap12:Body>
</soap12:Envelope>