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

SalesQuoteId,SalesQuoteTypeId,SalesQuoteTypeAbbreviation,SalesQuoteTypeDescription,SalesQuoteNo,RelatedSalesOrderNo,RelatedSalesOrderTypeId ,SalesQuoteReferenceNo,SalesQuoteReferenceApplication,SalesQuoteDate,SalesQuoteCustomOrderDate1,SalesQuoteCustomOrderDate2,SalesQuoteCurrencyCode,SalesQuoteClientID,SalesQuoteClientName,SalesQuoteBillingAddress,SalesQuoteShippingAddress,SalesQuoteAddresses,SalesQuoteContactPerson,SalesQuoteInventoryLocationID,SalesQuoteCustomFlag1,SalesQuoteCustomFlag2,SalesQuoteCustomFlag3,SalesQuoteCustomFlag4,SalesQuoteCustomFlag5,SalesQuoteCustomFlag6,SalesQuoteCustomFlag7,SalesQuoteCustomFlag8,SalesQuoteCustomFlag9,SalesQuoteCustomFlag10,SalesQuoteComments,SalesQuoteTags,SalesQuotePaymentTermsEnumeration,SalesQuotePaymentMethod,SalesQuoteTotalQuantity,SalesQuoteAmountSubtotalWithoutTaxAndDiscount,SalesQuoteAmountShipping,SalesQuoteAmountTotalDiscount,SalesQuoteAmountTotalTax,SalesQuoteAmountGrandTotal,SalesQuoteTotalWeight,SalesQuoteTotalWeightUnitID,SalesQuoteDetails,SalesQuoteShipDocumentTypeID,SalesQuoteStatus,SalesQuoteCreationDate,SalesQuoteLastUpdatedDate
0,0,String,String,String,String,0,String,String,0001-01-01,0001-01-01,0001-01-01,String,0,String,String,String,"[{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}]",String,0,False,False,False,False,False,False,False,False,False,False,String,String,None,None,0,0.00,0.00,0.00,0.00,0.00,0,0,"[{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}]",String,ValidStatus,0001-01-01,0001-01-01


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

SalesQuoteId,SalesQuoteTypeId,SalesQuoteTypeAbbreviation,SalesQuoteTypeDescription,SalesQuoteNo,RelatedSalesOrderNo,RelatedSalesOrderTypeId ,SalesQuoteReferenceNo,SalesQuoteReferenceApplication,SalesQuoteDate,SalesQuoteCustomOrderDate1,SalesQuoteCustomOrderDate2,SalesQuoteCurrencyCode,SalesQuoteClientID,SalesQuoteClientName,SalesQuoteBillingAddress,SalesQuoteShippingAddress,SalesQuoteAddresses,SalesQuoteContactPerson,SalesQuoteInventoryLocationID,SalesQuoteCustomFlag1,SalesQuoteCustomFlag2,SalesQuoteCustomFlag3,SalesQuoteCustomFlag4,SalesQuoteCustomFlag5,SalesQuoteCustomFlag6,SalesQuoteCustomFlag7,SalesQuoteCustomFlag8,SalesQuoteCustomFlag9,SalesQuoteCustomFlag10,SalesQuoteComments,SalesQuoteTags,SalesQuotePaymentTermsEnumeration,SalesQuotePaymentMethod,SalesQuoteTotalQuantity,SalesQuoteAmountSubtotalWithoutTaxAndDiscount,SalesQuoteAmountShipping,SalesQuoteAmountTotalDiscount,SalesQuoteAmountTotalTax,SalesQuoteAmountGrandTotal,SalesQuoteTotalWeight,SalesQuoteTotalWeightUnitID,SalesQuoteDetails,SalesQuoteShipDocumentTypeID,SalesQuoteStatus,SalesQuoteCreationDate,SalesQuoteLastUpdatedDate
0,0,String,String,String,String,0,String,String,0001-01-01,0001-01-01,0001-01-01,String,0,String,String,String,"[{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}]",String,0,False,False,False,False,False,False,False,False,False,False,String,String,None,None,0,0.00,0.00,0.00,0.00,0.00,0,0,"[{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}]",String,ValidStatus,0001-01-01,0001-01-01