Endpoint - Quote

Endpoint which should return the available quotes for an order.

Request

Post

QuoteRequest

Field NameTypeDescription
AuthorizationTokenGuidAuthorization token uniquely identifying each integration profile
NameStringCustomer name
CompanyNameStringCompany name
AddressLine1StringAddress Line 1
AddressLine2StringAddress Line 2
AddressLine3StringAddress Line 3
TownStringAddress Town / City
RegionStringAddress State / County / Region
CountryCodeStringCountry code ISO 3166-2
PostalcodeStringPostal code / Zip code
EmailStringEmail address of the customer
PhoneStringPhone number of the customer
PackagesPackage[]List of package class. See Endpoint - Quote - Package
OrderReferenceStringLinnworks order reference number
OrderCurrencyStringCurrency code (3 characters)
OrderValueDecimalOrder value
OrderExtendedPropertiesOrderExtendedProperties[]List of extended properties items mapped to order extended properties. See Endpoint - Quote - OrderExtendedProperties

Package

Field NameTypeDescription
SequenceNumberIntegerSequence number of a package
PackageWeightDecimalPackage weight (grams)
PackageWidthDecimalPackage width (cm)
PackageHeightDecimalPackage height (cm)
PackageDepthDecimalPackage depth (cm)
PackageFormatStringPackaging type: BOX
PARCEL
PACKET
LETTER
ItemsItem[]Property title. See Endpoint - Quote - Item

Item

Field NameTypeDescription
ItemNameStringName of the product
ProductCodeStringSKU
QuantityIntegerItem quantity
UnitValueDecimalProduct unit cost (OrderCurrency)
UnitWeightDecimalProduct unit weight (gram)
HeightDecimalProduct height (cm)
WidthDecimalProduct width (cm)
LengthDecimalProduct length (cm)
ExtendedPropertiesExtendedProperty[]Extended property as mapped to Linnworks item extended property. See Endpoint - Quote - ExtendedProperty

Extended Property

Field NameTypeDescription
NameStringExtended Property name as defined
ValueStringLinnworks item extended property value

OrderExtendedProperties

Field NameTypeDescription
NameStringExtended Property name as defined
ValueStringLinnworks order extended property value

Sample

{
  "AuthorizationToken": "a8e53e86eead4b69beaa0afcc29b67fb",
  "Name": "Customer name",
  "CompanyName": "Company name",
  "AddressLine1": "Great Russell St",
  "AddressLine2": "Bloomsbury",
  "AddressLine3": "",
  "Town": "London",
  "Region": "Greater London",
  "CountryCode": "GB",
  "Postalcode": "WC1B 3DG",
  "DeliveryNote": "Some note",
  "Email": "[email protected]",
  "Phone": "+44 00000000000",
  "Packages": [
    {
      "SequenceNumber": 0,
      "Items": [
        {
          "ExtendedProperties": [
            {
              "Name": "ExtendedCover",
              "Value": "True"
            }
          ],
          "ItemName": "Product 1",
          "ProductCode": "SKU001",
          "Quantity": 1,
          "UnitValue": 1,
          "UnitWeight": 1,
          "Height": 1,
          "Width": 1,
          "Length": 1
        }
      ],
      "PackageWeight": 1,
      "PackageWidth": 1,
      "PackageHeight": 1,
      "PackageDepth": 1,
      "PackageFormat": "BOX"
    }
  ],
  "OrderReference": "ORDERREFERENCE",
  "OrderCurrency": "GBP",
  "OrderValue": 1,
  "OrderExtendedProperties": [
    {
      "Name": "SafePlace",
      "Value": "Some message"
    }
  ]
}

Response

QuoteResponse

Field NameTypeDescription
QuoteItemsQuoteItem[]List of Quote Item class. See Endpoint - Quote - QuoteItem
IsErrorBooleanIndicates if there is an error
ErrorMessageString / nullError message

QuoteItem

Field NameTypeDescription
ServiceNameStringService name as appears to the user
ServiceCodeStringService code
ServiceIdGuidService Id defined in UserAvailableServices
ServiceTagStringService Tag
CollectionDateDateTimeDate on which the parcel will be sent / collected
EstimatedDeliveryDateDateTimeEstimated delivery date
CostDecimalCost of the service
TaxDecimalService tax
TotalCostDecimalTotal cost of the delivery
CurrencyStringCurrency code (3 chars)
PropertyItemQuoteProperty[]List of Quote Property class. See Endpoint - Quote - QuoteProperty
OptionsQuoteServiceOption[]List of Quote Service Option class. See Endpoint - Quote - QuoteServiceOption

QuoteProperty

Field NameTypeDescription
TitleStringProperty title
ValueStringProperty value

QuoteServiceOption

Field NameTypeDescription
OptionNameStringOption name
OptionValueStringOption value
{
  "QuoteItems": [
    {
      "ServiceName": "Fast2Door Next Day",
      "ServiceCode": "CODE1",
      "ServiceId": "6a47631504db4d25a25ce6917a1bcad9",
      "ServiceTag": "SOMETAG",
      "CollectionDate": "/Date(1565283600000)/",
      "EstimatedDeliveryDate": "/Date(1565370000000)/",
      "Cost": 1,
      "Tax": 1,
      "TotalCost": 2,
      "Currency": "GBP",
      "PropertyItem": [
        {
          "Title": "PropertyName",
          "Value": "PropertyValue123"
        }
      ],
      "Options": [
        {
          "OptionName": "OptionName",
          "OptionValue": "OptionValue123"
        }
      ]
    }
  ],
  "IsError": false,
  "ErrorMessage": null
}