Megaventory API v2017a

<back to all web services

SalesQuoteGet

Gets information on existing sales quotesUses your API Key and some Filters in an array format and returns the search results using given filters. Optionally, you can use ReturnTopNRecords to limit the number of the results to the specified number (omit, or add ReturnTopNRecords = -1 to get all the available results). The ReturnTopNRecords chooses the top records in a SalesQuoteId descending order.

Examples:



A.

Return the first mvSalesQuotes object that we have to pickup out of Athens. The results are returned as mvSalesQuotes objects.

Value:

 {
   "Filters": [
      {
         "FieldName": "SalesQuoteShippingAddress",
         "SearchOperator": "NotEquals",
         "SearchValue": "Athens"
      }
   ],
   "ReturnTopNRecords": 1
}

Response:

{
   "mvSalesQuotes": [
      {
         "SalesQuoteId": 49411,
         "SalesQuoteTypeId": -10,
         "SalesQuoteTypeAbbreviation": "QUOTE",
         "SalesQuoteTypeDescription": "Sales Quote",
         "SalesQuoteNo": "62",
         "RelatedSalesOrderNo": "",
         "RelatedSalesOrderTypeId": 0,
         "SalesQuoteReferenceNo": "",
         "SalesQuoteReferenceApplication": "",
         "SalesQuoteDate": "/Date(1531342800000-0000)/",
         "SalesQuoteCustomOrderDate1": "/Date(-62135596800000-0000)/",
         "SalesQuoteCustomOrderDate2": "/Date(-62135596800000-0000)/",
         "SalesQuoteCurrencyCode": "USD",
         "SalesQuoteClientID": 5357,
         "SalesQuoteShippingAddress": "",
         "SalesQuoteBillingAddress": "1 Ship Add, Cupertino CA 95014",
         "SalesQuoteContactPerson": "c2",
         "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": 1,
         "SalesQuoteAmountSubtotalWithoutTaxAndDiscount": 0,
         "SalesQuoteAmountTotalDiscount": 0,
         "SalesQuoteAmountTotalTax": 0,
         "SalesQuoteAmountGrandTotal": 0,
         "SalesQuoteAmountShipping": 0,
         "SalesQuoteDetails": [
            {
               "SalesQuoteRowDetailID": 112932,
               "SalesQuoteRowProductID": 66492,
               "SalesQuoteRowProductSKU": "product",
               "SalesQuoteRowProductDescription": "product",
               "SalesQuoteRowQuantity": 1,
               "SalesQuoteRowUnitPriceWithoutTaxOrDiscount": 0,
               "SalesQuoteRowTaxID": 0,
               "SalesQuoteRowTotalTaxAmount": 0,
               "SalesQuoteRowDiscountID": 0,
               "SalesQuoteRowTotalDiscountAmount": 0,
               "SalesQuoteRowTotalAmount": 0,
               "SalesQuoteRowRemarks": ""
            }
         ],
         "SalesQuoteStatus": "Pending",
         "SalesQuoteCreationDate": "/Date(1531413275417-0000)/",
         "SalesQuoteLastUpdatedDate": "/Date(1531413538977-0000)/"
      }
   ],
   "ResponseStatus": {
      "ErrorCode": "0"
   }
}

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

HTTP + SOAP11

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

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

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

<SalesQuoteGet xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Megaventory.APIEndpoints.Operations">
  <Filters xmlns="http://schemas.datacontract.org/2004/07/Megaventory.APIEndpoints">
    <Filter>
      <AndOr>And</AndOr>
      <FieldName>String</FieldName>
      <Group>Undefined</Group>
      <SearchOperator>Undefined</SearchOperator>
      <SearchValue>String</SearchValue>
    </Filter>
  </Filters>
  <ReturnTopNRecords xmlns="http://schemas.datacontract.org/2004/07/Megaventory.APIEndpoints">0</ReturnTopNRecords>
  <APIKEY>String</APIKEY>
  <mvSalesQuoteNo>String</mvSalesQuoteNo>
  <mvSalesQuoteStatus>ValidStatus</mvSalesQuoteStatus>
</SalesQuoteGet>

    </soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

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

<SalesQuoteGetResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Megaventory.APIEndpoints.Operations">
  <mvSalesQuotes xmlns:d2p1="https://api.megaventory.com/types">
    <d2p1:mvSalesQuote>
      <d2p1:SalesQuoteId>0</d2p1:SalesQuoteId>
      <d2p1:SalesQuoteTypeId>0</d2p1:SalesQuoteTypeId>
      <d2p1:SalesQuoteTypeAbbreviation>String</d2p1:SalesQuoteTypeAbbreviation>
      <d2p1:SalesQuoteTypeDescription>String</d2p1:SalesQuoteTypeDescription>
      <d2p1:SalesQuoteNo>String</d2p1:SalesQuoteNo>
      <d2p1:RelatedSalesOrderNo>String</d2p1:RelatedSalesOrderNo>
      <d2p1:RelatedSalesOrderTypeId_x0020_>0</d2p1:RelatedSalesOrderTypeId_x0020_>
      <d2p1:SalesQuoteReferenceNo>String</d2p1:SalesQuoteReferenceNo>
      <d2p1:SalesQuoteReferenceApplication>String</d2p1:SalesQuoteReferenceApplication>
      <d2p1:SalesQuoteDate>0001-01-01T00:00:00</d2p1:SalesQuoteDate>
      <d2p1:SalesQuoteCustomOrderDate1>0001-01-01T00:00:00</d2p1:SalesQuoteCustomOrderDate1>
      <d2p1:SalesQuoteCustomOrderDate2>0001-01-01T00:00:00</d2p1:SalesQuoteCustomOrderDate2>
      <d2p1:SalesQuoteCurrencyCode>String</d2p1:SalesQuoteCurrencyCode>
      <d2p1:SalesQuoteClientID>0</d2p1:SalesQuoteClientID>
      <d2p1:SalesQuoteClientName>String</d2p1:SalesQuoteClientName>
      <d2p1:SalesQuoteBillingAddress>String</d2p1:SalesQuoteBillingAddress>
      <d2p1:SalesQuoteShippingAddress>String</d2p1:SalesQuoteShippingAddress>
      <d2p1:SalesQuoteAddresses>
        <d2p1:mvAddress>
          <d2p1:AddressType>General</d2p1:AddressType>
          <d2p1:AddressLine1>String</d2p1:AddressLine1>
          <d2p1:AddressLine2>String</d2p1:AddressLine2>
          <d2p1:AddressLine3>String</d2p1:AddressLine3>
          <d2p1:Name>String</d2p1:Name>
          <d2p1:Phone>String</d2p1:Phone>
          <d2p1:Email>String</d2p1:Email>
          <d2p1:TaxIdNumber>String</d2p1:TaxIdNumber>
          <d2p1:Organization>String</d2p1:Organization>
          <d2p1:City>String</d2p1:City>
          <d2p1:State>String</d2p1:State>
          <d2p1:Country>NONE</d2p1:Country>
          <d2p1:CountryName>String</d2p1:CountryName>
          <d2p1:Longitude>String</d2p1:Longitude>
          <d2p1:Latitude>String</d2p1:Latitude>
          <d2p1:ZipCode>String</d2p1:ZipCode>
        </d2p1:mvAddress>
      </d2p1:SalesQuoteAddresses>
      <d2p1:SalesQuoteContactPerson>String</d2p1:SalesQuoteContactPerson>
      <d2p1:SalesQuoteInventoryLocationID>0</d2p1:SalesQuoteInventoryLocationID>
      <d2p1:SalesQuoteCustomFlag1>false</d2p1:SalesQuoteCustomFlag1>
      <d2p1:SalesQuoteCustomFlag2>false</d2p1:SalesQuoteCustomFlag2>
      <d2p1:SalesQuoteCustomFlag3>false</d2p1:SalesQuoteCustomFlag3>
      <d2p1:SalesQuoteCustomFlag4>false</d2p1:SalesQuoteCustomFlag4>
      <d2p1:SalesQuoteCustomFlag5>false</d2p1:SalesQuoteCustomFlag5>
      <d2p1:SalesQuoteCustomFlag6>false</d2p1:SalesQuoteCustomFlag6>
      <d2p1:SalesQuoteCustomFlag7>false</d2p1:SalesQuoteCustomFlag7>
      <d2p1:SalesQuoteCustomFlag8>false</d2p1:SalesQuoteCustomFlag8>
      <d2p1:SalesQuoteCustomFlag9>false</d2p1:SalesQuoteCustomFlag9>
      <d2p1:SalesQuoteCustomFlag10>false</d2p1:SalesQuoteCustomFlag10>
      <d2p1:SalesQuoteComments>String</d2p1:SalesQuoteComments>
      <d2p1:SalesQuoteTags>String</d2p1:SalesQuoteTags>
      <d2p1:SalesQuotePaymentTermsEnumeration>None</d2p1:SalesQuotePaymentTermsEnumeration>
      <d2p1:SalesQuotePaymentMethod>None</d2p1:SalesQuotePaymentMethod>
      <d2p1:SalesQuoteTotalQuantity>0</d2p1:SalesQuoteTotalQuantity>
      <d2p1:SalesQuoteAmountSubtotalWithoutTaxAndDiscount>0.00</d2p1:SalesQuoteAmountSubtotalWithoutTaxAndDiscount>
      <d2p1:SalesQuoteAmountShipping>0.00</d2p1:SalesQuoteAmountShipping>
      <d2p1:SalesQuoteAmountTotalDiscount>0.00</d2p1:SalesQuoteAmountTotalDiscount>
      <d2p1:SalesQuoteAmountTotalTax>0.00</d2p1:SalesQuoteAmountTotalTax>
      <d2p1:SalesQuoteAmountGrandTotal>0.00</d2p1:SalesQuoteAmountGrandTotal>
      <d2p1:SalesQuoteTotalWeight>0</d2p1:SalesQuoteTotalWeight>
      <d2p1:SalesQuoteTotalWeightUnitID>0</d2p1:SalesQuoteTotalWeightUnitID>
      <d2p1:SalesQuoteDetails>
        <d2p1:mvSalesQuoteRow>
          <d2p1:SalesQuoteRowDetailID>0</d2p1:SalesQuoteRowDetailID>
          <d2p1:SalesQuoteRowProductID>0</d2p1:SalesQuoteRowProductID>
          <d2p1:SalesQuoteRowProductSKU>String</d2p1:SalesQuoteRowProductSKU>
          <d2p1:SalesQuoteRowProductDescription>String</d2p1:SalesQuoteRowProductDescription>
          <d2p1:SalesQuoteRowQuantity>0</d2p1:SalesQuoteRowQuantity>
          <d2p1:SalesQuoteRowUnitPriceWithoutTaxOrDiscount>0</d2p1:SalesQuoteRowUnitPriceWithoutTaxOrDiscount>
          <d2p1:SalesQuoteRowTaxID>0</d2p1:SalesQuoteRowTaxID>
          <d2p1:SalesQuoteRowTotalTaxAmount>0</d2p1:SalesQuoteRowTotalTaxAmount>
          <d2p1:SalesQuoteRowDiscountID>0</d2p1:SalesQuoteRowDiscountID>
          <d2p1:SalesQuoteRowTotalDiscountAmount>0</d2p1:SalesQuoteRowTotalDiscountAmount>
          <d2p1:SalesQuoteRowTotalAmount>0</d2p1:SalesQuoteRowTotalAmount>
          <d2p1:SalesQuoteRowRemarks>String</d2p1:SalesQuoteRowRemarks>
          <d2p1:SalesQuoteRowTotalWeight>0</d2p1:SalesQuoteRowTotalWeight>
          <d2p1:SalesQuoteRowTotalWeightUnitID>0</d2p1:SalesQuoteRowTotalWeightUnitID>
        </d2p1:mvSalesQuoteRow>
      </d2p1:SalesQuoteDetails>
      <d2p1:SalesQuoteShipDocumentTypeID>String</d2p1:SalesQuoteShipDocumentTypeID>
      <d2p1:SalesQuoteStatus>ValidStatus</d2p1:SalesQuoteStatus>
      <d2p1:SalesQuoteCreationDate>0001-01-01T00:00:00</d2p1:SalesQuoteCreationDate>
      <d2p1:SalesQuoteLastUpdatedDate>0001-01-01T00:00:00</d2p1:SalesQuoteLastUpdatedDate>
    </d2p1:mvSalesQuote>
  </mvSalesQuotes>
  <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>
</SalesQuoteGetResponse>

    </soap:Body>
</soap:Envelope>