Megaventory API v2017a

SalesQuoteUpdate

The following routes are available for this service:
POST	/SalesQuote/SalesQuoteUpdate	Inserts 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 }

The following routes are available for this service:

POST

/SalesQuote/SalesQuoteUpdate

Inserts 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 .jsv suffix or ?format=jsv

HTTP + JSV

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

POST /jsv/reply/SalesQuoteUpdate HTTP/1.1 
Host: api.megaventory.com 
Content-Type: text/jsv
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: 0001-01-01,
		SalesQuoteCustomOrderDate1: 0001-01-01,
		SalesQuoteCustomOrderDate2: 0001-01-01,
		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: 0001-01-01,
		SalesQuoteLastUpdatedDate: 0001-01-01
	},
	mvRecordAction: Insert,
	mvInsertUpdateDeleteSourceApplication: String,
	AutoInsertBundledProductRows: False
}

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

{
	mvSalesQuote: 
	{
		SalesQuoteId: 0,
		SalesQuoteTypeId: 0,
		SalesQuoteTypeAbbreviation: String,
		SalesQuoteTypeDescription: String,
		SalesQuoteNo: String,
		RelatedSalesOrderNo: String,
		RelatedSalesOrderTypeId : 0,
		SalesQuoteReferenceNo: String,
		SalesQuoteReferenceApplication: String,
		SalesQuoteDate: 0001-01-01,
		SalesQuoteCustomOrderDate1: 0001-01-01,
		SalesQuoteCustomOrderDate2: 0001-01-01,
		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: 0001-01-01,
		SalesQuoteLastUpdatedDate: 0001-01-01
	},
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String
			}
		]
	},
	entityID: 0,
	InternalErrorCode: String
}