Megaventory API v2017a

<back to all web services

SalesQuoteUpdate

The following routes are available for this service:
POST/SalesQuote/SalesQuoteUpdateInserts a new sales quote or updates an existing one.Uses your API Key and applies a mvRecordAction value on an mvSalesQuote object. We can insert the mvSalesQuote we specified using "Insert" as our mvRecordAction.SalesQuoteId, SalesQuoteClientID, SalesQuoteStatus are mandatory fields.

We can update an existing Sales Quote using "Update". SalesQuoteInventoryLocationID is mandatory only we "Update" a Sales Quote as "Closed".

Examples:



A.

Insert a new sales quote for products going to one of our clients.

Value:

{
  "mvSalesQuote": {
    "SalesQuoteClientID": 5421,
    "SalesQuoteDetails": [
      {
        "SalesQuoteRowProductSKU": "product",
        "SalesQuoteRowQuantity": 21
      }
    ],
    "SalesQuoteStatus": "Pending"

  },
  "mvRecordAction": "Insert"
} 


Response:

 {
  "mvSalesQuote": {
    "SalesQuoteId": 100116,
    "SalesQuoteTypeId": -10,
    "SalesQuoteTypeAbbreviation": "QUOTE",
    "SalesQuoteTypeDescription": "Sales Quote",
    "SalesQuoteNo": "78",
    "SalesQuoteReferenceNo": "",
    "SalesQuoteReferenceApplication": "",
    "SalesQuoteDate": "/Date(1591909200000-0000)/",
    "SalesQuoteCustomOrderDate1": "/Date(-62135596800000-0000)/",
    "SalesQuoteCustomOrderDate2": "/Date(-62135596800000-0000)/",
    "SalesQuoteCurrencyCode": "USD",
    "SalesQuoteClientID": 5421,
    "SalesQuoteBillingAddress": "1 Infinite Loop, Cupertino CA 95014",
    "SalesQuoteShippingAddress": "1600 Amphitheatre Parkway, Mountain View  CA",
    "SalesQuoteContactPerson": "",
    "SalesQuoteInventoryLocationID": 0,
    "SalesQuoteCustomFlag1": false,
    "SalesQuoteCustomFlag2": false,
    "SalesQuoteCustomFlag3": false,
    "SalesQuoteCustomFlag4": false,
    "SalesQuoteCustomFlag5": false,
    "SalesQuoteCustomFlag6": false,
    "SalesQuoteCustomFlag7": false,
    "SalesQuoteCustomFlag8": false,
    "SalesQuoteCustomFlag9": false,
    "SalesQuoteCustomFlag10": false,
    "SalesQuoteComments": "",
    "SalesQuoteTags": "",
    "SalesQuotePaymentTermsEnumeration": "None",
    "SalesQuoteTotalQuantity": 21,
    "SalesQuoteAmountSubtotalWithoutTaxAndDiscount": 0,
    "SalesQuoteAmountShipping": 0,
    "SalesQuoteAmountTotalDiscount": 0,
    "SalesQuoteAmountTotalTax": 0,
    "SalesQuoteAmountGrandTotal": 0,
    "SalesQuoteDetails": [
      {
        "SalesQuoteRowDetailID": 117915,
        "SalesQuoteRowProductID": 66492,
        "SalesQuoteRowProductSKU": "product",
        "SalesQuoteRowProductDescription": "qdq",
        "SalesQuoteRowQuantity": 21,
        "SalesQuoteRowUnitPriceWithoutTaxOrDiscount": 0,
        "SalesQuoteRowTaxID": 0,
        "SalesQuoteRowTotalTaxAmount": 0,
        "SalesQuoteRowDiscountID": 0,
        "SalesQuoteRowTotalDiscountAmount": 0,
        "SalesQuoteRowTotalAmount": 0,
        "SalesQuoteRowRemarks": ""
      }
    ],
    "SalesQuoteStatus": "Pending",
    "SalesQuoteCreationDate": "/Date(1591948006507+0300)/",
    "SalesQuoteLastUpdatedDate": "/Date(1591948006511+0300)/"
  },
  "ResponseStatus": {
    "ErrorCode": "0"
  },
  "entityID": 100116
}

B.

Update a sales quote to Closed for some products going to one of our clients.

Value:

{
  "mvSalesQuote": {
    "SalesQuoteId": 100120,
    "SalesQuoteClientID": 5421,
    "SalesQuoteInventoryLocationID": 4435,
    "SalesQuoteDetails": [
      {
        "SalesQuoteRowProductSKU": "product",
        "SalesQuoteRowQuantity": 22
      }
    ],
    "SalesQuoteStatus": "Closed"

  },
  "mvRecordAction": "Update"
} 


Response:

 {
    "mvSalesQuote": {
    "SalesQuoteId": 100120,
    "SalesQuoteTypeId": -10,
    "SalesQuoteTypeAbbreviation": "QUOTE",
    "SalesQuoteTypeDescription": "Sales Quote",
    "SalesQuoteNo": "82",
    "SalesQuoteReferenceNo": "",
    "SalesQuoteReferenceApplication": "",
    "SalesQuoteDate": "/Date(1591909200000-0000)/",
    "SalesQuoteCustomOrderDate1": "/Date(-62135596800000-0000)/",
    "SalesQuoteCustomOrderDate2": "/Date(-62135596800000-0000)/",
    "SalesQuoteCurrencyCode": "USD",
    "SalesQuoteClientID": 5421,
    "SalesQuoteBillingAddress": "",
    "SalesQuoteShippingAddress": "",
    "SalesQuoteContactPerson": "",
    "SalesQuoteInventoryLocationID": 4435,
    "SalesQuoteCustomFlag1": false,
    "SalesQuoteCustomFlag2": false,
    "SalesQuoteCustomFlag3": false,
    "SalesQuoteCustomFlag4": false,
    "SalesQuoteCustomFlag5": false,
    "SalesQuoteCustomFlag6": false,
    "SalesQuoteCustomFlag7": false,
    "SalesQuoteCustomFlag8": false,
    "SalesQuoteCustomFlag9": false,
    "SalesQuoteCustomFlag10": false,
    "SalesQuoteComments": "",
    "SalesQuoteTags": "",
    "SalesQuotePaymentTermsEnumeration": "None",
    "SalesQuoteTotalQuantity": 22,
    "SalesQuoteAmountSubtotalWithoutTaxAndDiscount": 0,
    "SalesQuoteAmountShipping": 0,
    "SalesQuoteAmountTotalDiscount": 0,
    "SalesQuoteAmountTotalTax": 0,
    "SalesQuoteAmountGrandTotal": 0,
    "SalesQuoteDetails": [
      {
        "SalesQuoteRowDetailID": 117920,
        "SalesQuoteRowProductID": 66492,
        "SalesQuoteRowProductSKU": "product",
        "SalesQuoteRowProductDescription": "qdq",
        "SalesQuoteRowQuantity": 22,
        "SalesQuoteRowUnitPriceWithoutTaxOrDiscount": 0,
        "SalesQuoteRowTaxID": 0,
        "SalesQuoteRowTotalTaxAmount": 0,
        "SalesQuoteRowDiscountID": 0,
        "SalesQuoteRowTotalDiscountAmount": 0,
        "SalesQuoteRowTotalAmount": 0,
        "SalesQuoteRowRemarks": ""
      }
    ],
    "SalesQuoteStatus": "Closed",
    "SalesQuoteCreationDate": "/Date(1591949447527-0000)/",
    "SalesQuoteLastUpdatedDate": "/Date(1591949505092+0300)/"
  },
  "ResponseStatus": {
    "ErrorCode": "0"
  },
  "entityID": 100120
}

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/SalesQuoteUpdate HTTP/1.1 
Host: api.megaventory.com 
Content-Type: application/json
Content-Length: length

{"APIKEY":"String","mvSalesQuote":{"SalesQuoteId":0,"SalesQuoteTypeId":0,"SalesQuoteTypeAbbreviation":"String","SalesQuoteTypeDescription":"String","SalesQuoteNo":"String","RelatedSalesOrderNo":"String","RelatedSalesOrderTypeId ":0,"SalesQuoteReferenceNo":"String","SalesQuoteReferenceApplication":"String","SalesQuoteDate":"\/Date(-62135596800000-0000)\/","SalesQuoteCustomOrderDate1":"\/Date(-62135596800000-0000)\/","SalesQuoteCustomOrderDate2":"\/Date(-62135596800000-0000)\/","SalesQuoteCurrencyCode":"String","SalesQuoteClientID":0,"SalesQuoteClientName":"String","SalesQuoteBillingAddress":"String","SalesQuoteShippingAddress":"String","SalesQuoteAddresses":[{"AddressType":"General","AddressLine1":"String","AddressLine2":"String","AddressLine3":"String","Name":"String","Phone":"String","Email":"String","TaxIdNumber":"String","Organization":"String","City":"String","State":"String","Country":"NONE","CountryName":"String","Longitude":"String","Latitude":"String","ZipCode":"String"}],"SalesQuoteContactPerson":"String","SalesQuoteInventoryLocationID":0,"SalesQuoteCustomFlag1":false,"SalesQuoteCustomFlag2":false,"SalesQuoteCustomFlag3":false,"SalesQuoteCustomFlag4":false,"SalesQuoteCustomFlag5":false,"SalesQuoteCustomFlag6":false,"SalesQuoteCustomFlag7":false,"SalesQuoteCustomFlag8":false,"SalesQuoteCustomFlag9":false,"SalesQuoteCustomFlag10":false,"SalesQuoteComments":"String","SalesQuoteTags":"String","SalesQuotePaymentTermsEnumeration":"None","SalesQuotePaymentMethod":"None","SalesQuoteTotalQuantity":0,"SalesQuoteAmountSubtotalWithoutTaxAndDiscount":0.00,"SalesQuoteAmountShipping":0.00,"SalesQuoteAmountTotalDiscount":0.00,"SalesQuoteAmountTotalTax":0.00,"SalesQuoteAmountGrandTotal":0.00,"SalesQuoteTotalWeight":0,"SalesQuoteTotalWeightUnitID":0,"SalesQuoteDetails":[{"SalesQuoteRowDetailID":0,"SalesQuoteRowProductID":0,"SalesQuoteRowProductSKU":"String","SalesQuoteRowProductDescription":"String","SalesQuoteRowQuantity":0,"SalesQuoteRowUnitPriceWithoutTaxOrDiscount":0,"SalesQuoteRowTaxID":0,"SalesQuoteRowTotalTaxAmount":0,"SalesQuoteRowDiscountID":0,"SalesQuoteRowTotalDiscountAmount":0,"SalesQuoteRowTotalAmount":0,"SalesQuoteRowRemarks":"String","SalesQuoteRowTotalWeight":0,"SalesQuoteRowTotalWeightUnitID":0}],"SalesQuoteShipDocumentTypeID":"String","SalesQuoteStatus":"ValidStatus","SalesQuoteCreationDate":"\/Date(-62135596800000-0000)\/","SalesQuoteLastUpdatedDate":"\/Date(-62135596800000-0000)\/"},"mvRecordAction":"Insert","mvInsertUpdateDeleteSourceApplication":"String","AutoInsertBundledProductRows":false}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"mvSalesQuote":{"SalesQuoteId":0,"SalesQuoteTypeId":0,"SalesQuoteTypeAbbreviation":"String","SalesQuoteTypeDescription":"String","SalesQuoteNo":"String","RelatedSalesOrderNo":"String","RelatedSalesOrderTypeId ":0,"SalesQuoteReferenceNo":"String","SalesQuoteReferenceApplication":"String","SalesQuoteDate":"\/Date(-62135596800000-0000)\/","SalesQuoteCustomOrderDate1":"\/Date(-62135596800000-0000)\/","SalesQuoteCustomOrderDate2":"\/Date(-62135596800000-0000)\/","SalesQuoteCurrencyCode":"String","SalesQuoteClientID":0,"SalesQuoteClientName":"String","SalesQuoteBillingAddress":"String","SalesQuoteShippingAddress":"String","SalesQuoteAddresses":[{"AddressType":"General","AddressLine1":"String","AddressLine2":"String","AddressLine3":"String","Name":"String","Phone":"String","Email":"String","TaxIdNumber":"String","Organization":"String","City":"String","State":"String","Country":"NONE","CountryName":"String","Longitude":"String","Latitude":"String","ZipCode":"String"}],"SalesQuoteContactPerson":"String","SalesQuoteInventoryLocationID":0,"SalesQuoteCustomFlag1":false,"SalesQuoteCustomFlag2":false,"SalesQuoteCustomFlag3":false,"SalesQuoteCustomFlag4":false,"SalesQuoteCustomFlag5":false,"SalesQuoteCustomFlag6":false,"SalesQuoteCustomFlag7":false,"SalesQuoteCustomFlag8":false,"SalesQuoteCustomFlag9":false,"SalesQuoteCustomFlag10":false,"SalesQuoteComments":"String","SalesQuoteTags":"String","SalesQuotePaymentTermsEnumeration":"None","SalesQuotePaymentMethod":"None","SalesQuoteTotalQuantity":0,"SalesQuoteAmountSubtotalWithoutTaxAndDiscount":0.00,"SalesQuoteAmountShipping":0.00,"SalesQuoteAmountTotalDiscount":0.00,"SalesQuoteAmountTotalTax":0.00,"SalesQuoteAmountGrandTotal":0.00,"SalesQuoteTotalWeight":0,"SalesQuoteTotalWeightUnitID":0,"SalesQuoteDetails":[{"SalesQuoteRowDetailID":0,"SalesQuoteRowProductID":0,"SalesQuoteRowProductSKU":"String","SalesQuoteRowProductDescription":"String","SalesQuoteRowQuantity":0,"SalesQuoteRowUnitPriceWithoutTaxOrDiscount":0,"SalesQuoteRowTaxID":0,"SalesQuoteRowTotalTaxAmount":0,"SalesQuoteRowDiscountID":0,"SalesQuoteRowTotalDiscountAmount":0,"SalesQuoteRowTotalAmount":0,"SalesQuoteRowRemarks":"String","SalesQuoteRowTotalWeight":0,"SalesQuoteRowTotalWeightUnitID":0}],"SalesQuoteShipDocumentTypeID":"String","SalesQuoteStatus":"ValidStatus","SalesQuoteCreationDate":"\/Date(-62135596800000-0000)\/","SalesQuoteLastUpdatedDate":"\/Date(-62135596800000-0000)\/"},"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String"}]},"entityID":0,"InternalErrorCode":"String"}