POST Agents/Quote/GetQuoteEntity

• 5 minutes to read

POST /api/v1/Agents/Quote/GetQuoteEntity

Get a Quote

Query String Parameters

Parameter Name	Type	Description
$select	string	Optional comma separated list of properties to include in the result. Other fields are then nulled out to reduce payload size: "Name,department,category". Default = show all fields.

POST /api/v1/Agents/Quote/GetQuoteEntity?$select=name,department,category/id

Request Headers

Parameter Name	Description
Authorization	Supports 'Basic', 'SoTicket' and 'Bearer' schemes, depending on installation type.
X-XSRF-TOKEN	If not using Authorization header, you must provide XSRF value from cookie or hidden input field
Content-Type	Content-type of the request body: `application/json`, `text/json`, `application/xml`, `text/xml`, `application/x-www-form-urlencoded`, `application/json-patch+json`, `application/merge-patch+json`
Accept	Content-type(s) you would like the response in: `application/json`, `text/json`, `application/xml`, `text/xml`, `application/json-patch+json`, `application/merge-patch+json`
Accept-Language	Convert string references and multi-language values into a specified language (iso2) code.
SO-Language	Convert string references and multi-language values into a specified language (iso2) code. Overrides Accept-Language value.
SO-Culture	Number, date formatting in a specified culture (iso2 language) code. Partially overrides SO-Language/Accept-Language value. Ignored if no Language set.
SO-TimeZone	Specify the timezone code that you would like date/time responses converted to.
SO-AppToken	The application token that identifies the partner app. Used when calling Online WebAPI from a server.

Request Body: request

QuoteId

Property Name	Type	Description
QuoteId	Integer

Response:

Response	Description
200	OK

Response body: QuoteEntity

Property Name	Type	Description
QuoteId	int32	Primary key
SaleId	int32	The foreign key to the corresponding sale
QuoteConnectionId	int32	The connection in the CRM system to where this quote came from. Identifies the ERP connection used for this quote. Each quote is bound to one and only one connection.
ERPQuoteKey	string	Foreign key of quote (if available). The key in the ERP system that identifies this sale's Quote (as opposed to the later Order information)
ERPOrderKey	string	The key in the ERP system that identifies this sale's Order, as transferred and possibly later edited in the ERP system. Only filled out if there exists a corresponding order representation of the quote in the ERP system.
ActiveQuoteVersionId	int32	The primary key of the Quote Version that is currently active. (The active version will always be the latest version.)
AcceptedQuoteAlternativeId	int32	The primary key of the Quote Alternative which was finally accepted by the customer. Set when the user is marking a quote as accepted.
UseValuesFromQuote	int32	If true, then the Earning, Earning_Percent and Amount fields are populated from the QuoteVersion.QuoteAlternative (current revision, most-likely alternative).
DocumentId	int32	The ID of the main Quote Document
PoNumber	string	Customer's Purchase order number
OrderComment	string	A comment that is intended for the Invoice, Order, Packing list and similar stages - AFTER the quote has become an order and goes to ERP for processing
PreferredEmailCulture	string	When emails are sent (offer or confirmation), a language can be chosen in the GUI; this field saves the most recent choice and can be used to default the next such choice. Default-default is user's current language
QuoteVersions	array	Array og QuoteVersions connected to the quote.
TableRight	TableRight	The carrier's table right
FieldProperties	object	Field property dictionary mapping field names to field access rights.

Sample request

POST /api/v1/Agents/Quote/GetQuoteEntity
Authorization: Basic dGplMDpUamUw
Accept: application/json; charset=utf-8
Accept-Language: sv
Content-Type: application/json; charset=utf-8

{
  "QuoteId": 188
}

Sample response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "QuoteId": 410,
  "SaleId": 862,
  "QuoteConnectionId": 870,
  "ERPQuoteKey": "nihil",
  "ERPOrderKey": "deleniti",
  "ActiveQuoteVersionId": 753,
  "AcceptedQuoteAlternativeId": 587,
  "UseValuesFromQuote": 152,
  "DocumentId": 153,
  "PoNumber": "949148",
  "OrderComment": "soluta",
  "PreferredEmailCulture": "vanessa_lind@cormier.us",
  "QuoteVersions": [
    {
      "QuoteVersionId": 708,
      "ERPQuoteVersionKey": "accusamus",
      "QuoteId": 948,
      "Description": "Sharable contextually-based matrix",
      "Number": "1094609",
      "State": "Archived",
      "ArchivedState": "Archived",
      "Status": "Error",
      "Reason": "",
      "LikelyQuoteAlternativeId": 598,
      "SentDate": "2024-09-09T14:13:41.1095702+02:00",
      "FollowupId": 98,
      "ExpirationDate": "2020-09-23T14:13:41.1095702+02:00",
      "DeliveryCountryId": 519,
      "HasOwnDeliveryAddress": false,
      "InvoiceCountryId": 879,
      "HasOwnInvoiceAddress": false,
      "ERPPaymentTermsKey": "odit",
      "ERPPaymentTypeKey": "aut",
      "ERPDeliveryTermsKey": "voluptatem",
      "ERPDeliveryTypeKey": "molestiae",
      "Rank": 981,
      "ApprovedBy": 702,
      "ApprovedText": "aliquam",
      "ApprovedRegisteredBy": 773,
      "ApprovedRegisteredDate": "2018-06-02T14:13:41.1095702+02:00",
      "ExtraField1": "quia",
      "ExtraField2": "deserunt",
      "ExtraField3": "quas",
      "ExtraField4": "est",
      "ExtraField5": "unde",
      "LastRecalculated": "2011-09-11T14:13:41.1095702+02:00",
      "Updated": "2014-05-28T14:13:41.1095702+02:00",
      "UpdatedAssociateId": 266,
      "Registered": "2011-03-14T14:13:41.1095702+01:00",
      "RegisteredAssociateId": 150,
      "RequestAssociateId": 700,
      "RequestComment": "et",
      "QuoteAlternatives": [
        {},
        {}
      ],
      "TableRight": null,
      "FieldProperties": {
        "fieldName": {
          "FieldRight": null,
          "FieldType": "System.Int32",
          "FieldLength": 126
        }
      }
    }
  ],
  "TableRight": null,
  "FieldProperties": {
    "fieldName": {
      "FieldRight": null,
      "FieldType": "System.Int32",
      "FieldLength": 210
    }
  }
}