POST api/Orders/Search

Request Information

URI Parameters

None.

Body Parameters

Name	Description	Type	Additional information
ExternalIdentifier	Search for orders that matching this external reference given when inserting the order.	string	None.
FromDate	Return orders greater than this date/time	date	Required
ToDate	Return orders earlier than this date/time	date	Required
OrderType	The type of orders to return. The ChannelID, see api/Sales/Channels	integer	Required
IncludeCustomerDetails	If only the Eskimo Customer ID is required, then pass false, otherwise pass true and more information about the customer will be included in the CustomerInfo field.	boolean	Required
IncludeProductDetails	If only the Header information is required, then pass false, otherwise pass true and more information about the ordered items will be included in the OrderedItems field.	boolean	Required
CustomerID	The unique ID of the customer. This is in the format 000-000000 where the first three digits represent the Shop/Showroom code.	string	Matching regular expression pattern: \d{3}[-]\d{6} String length: inclusive between 10 and 10
StoreNumber	The Code of the shop the order is assigned to. See api/Shops/All	string	String length: inclusive between 0 and 3

Request Formats

application/json, text/json

Sample:

{
  "ExternalIdentifier": "sample string 1",
  "FromDate": "2025-01-18T03:52:52.889948+00:00",
  "ToDate": "2025-01-18T03:52:52.889948+00:00",
  "OrderType": 4,
  "IncludeCustomerDetails": true,
  "IncludeProductDetails": true,
  "CustomerID": "sample string 7",
  "StoreNumber": "sample string 8"
}

application/xml, text/xml

Sample:

<GetOrdersArguments xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/EskimoClassLibraries">
  <CustomerID>sample string 7</CustomerID>
  <ExternalIdentifier>sample string 1</ExternalIdentifier>
  <FromDate>2025-01-18T03:52:52.889948+00:00</FromDate>
  <IncludeCustomerDetails>true</IncludeCustomerDetails>
  <IncludeProductDetails>true</IncludeProductDetails>
  <OrderType>4</OrderType>
  <StoreNumber>sample string 8</StoreNumber>
  <ToDate>2025-01-18T03:52:52.889948+00:00</ToDate>
</GetOrdersArguments>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Collection of EskimoClassLibraries.clsOrderExt

Name	Description	Type	Additional information
ShippingTypeID	See api/Orders/FulfilmentMethods	integer	None.
ShippingTypeName	The name of the Fulfilment Method	string	None.
CustomerInfo	The Customer's main details.	EskimoClassLibraries.clsCustomer	None.
ShopID	Shop Code that the order is assigned to. See api/Shops/All	string	String length: inclusive between 0 and 3
ShopName	The name of the shop	string	String length: inclusive between 0 and 50
order_id	The numerical ID of the order. This is not an Eskimo ID, but rather the ID generated by website/cart.	integer	Range: inclusive between 0 and 2147483647
ExternalIdentifier	This is an optional secondary reference. Some references are text-based and therefore cannot be inserted into the order_id field. If omitted, a GUID will be assigned.	string	String length: inclusive between 0 and 200
OrderType	The sales channel of the order being inserted. See api/Sales/Channels	integer	Required
eskimo_customer_id	The Eskimo Customer ID in the format 123-123456.	string	Required Matching regular expression pattern: \d{3}[-]\d{6} String length: inclusive between 10 and 10
order_date	The date the customer placed the order	date	Required
invoice_amount	The total value of the order. (A sum of the OrderedItems plus the Carriage)	decimal number	Required
amount_paid	The amount of the order that has been paid.	decimal number	Required
order_discount	The sum of any order level discounts. As Eskimo does not have an order-level discount, this amount will be evenly applied to each product line	decimal number	None.
DeliveryAddress	Exclude if equal to the invoice address	EskimoClassLibraries.clsOrderAddressInfo	None.
InvoiceAddress		EskimoClassLibraries.clsOrderAddressInfo	Required
OrderedItems	All the items the customer purchased	Collection of EskimoClassLibraries.clsOrderItemExt	Required
CustomerReference	Optional reference that the customer wants to refer to the order as. I.e. 'Presents for Debbie'	string	String length: inclusive between 0 and 30
OrderNotes	Free text general notes.	string	None.
DeliveryNotes	Free text delivery notes. i.e. 'Please leave package in porch if no reply.'	string	None.
ShippingRateID	The ID of the shipping rate used on the order. See api/Orders/FulfilmentMethods	integer	Required
ShippingAmountGross	The Shipping Value (inc. tax)	decimal number	Required
CustomerAccountValuePaid	If the client is offering a saving scheme to their customers, this field can be used to reduce the customer's balanace by the amount provided, whilst linking that reduction with this order.	decimal number	Range: inclusive between 0 and 7.92281625142643E+28

Response Formats

application/json, text/json

Sample:

[
  {
    "ShippingTypeID": 1,
    "ShippingTypeName": "sample string 2",
    "CustomerInfo": {
      "ID": "sample string 1",
      "Forename": "sample string 2",
      "Surname": "sample string 3",
      "CompanyName": "sample string 4",
      "MarketingFlagsID": [
        1,
        2
      ],
      "AccountBalance": 1.0,
      "CustomerType": 0,
      "ShopVisibility": {
        "VisibleEverywhere": true,
        "ShopIDs": [
          "sample string 1",
          "sample string 2"
        ]
      },
      "ShopCreatedBy": "sample string 5",
      "PriceListID": null,
      "PriceLevel": 1,
      "AutomaticDiscountPercentage": 0,
      "Notes": "sample string 6",
      "Telephone": "sample string 7",
      "Mobile": "sample string 8",
      "EmailAddress": "sample string 9",
      "WebsiteAddress": "sample string 10",
      "ActiveAccount": true,
      "Address": "sample string 12",
      "PostCode": "sample string 13",
      "TitleID": 1,
      "CountryCode": "sample string 14",
      "ExternalID": "sample string 15",
      "MainAddress": {
        "Company": "sample string 1",
        "Line1": "sample string 2",
        "Line2": "sample string 3",
        "Line3": "sample string 4",
        "PostalTown": "sample string 5",
        "Region": "sample string 6",
        "PostCode": "sample string 7",
        "CountryCode": "sample string 8",
        "Active": true
      }
    },
    "ShopID": "sample string 3",
    "ShopName": "sample string 4",
    "order_id": 5,
    "ExternalIdentifier": "sample string 6",
    "OrderType": 7,
    "eskimo_customer_id": "sample string 8",
    "order_date": "2025-01-18T03:52:52.889948+00:00",
    "invoice_amount": 10.0,
    "amount_paid": 11.0,
    "order_discount": 12.0,
    "DeliveryAddress": {
      "FAO": "sample string 1",
      "AddressLine1": "sample string 2",
      "AddressLine2": "sample string 3",
      "AddressLine3": "sample string 4",
      "PostalTown": "sample string 5",
      "County": "sample string 6",
      "CountryCode": "sample string 7",
      "PostCode": "sample string 8"
    },
    "InvoiceAddress": {
      "FAO": "sample string 1",
      "AddressLine1": "sample string 2",
      "AddressLine2": "sample string 3",
      "AddressLine3": "sample string 4",
      "PostalTown": "sample string 5",
      "County": "sample string 6",
      "CountryCode": "sample string 7",
      "PostCode": "sample string 8"
    },
    "OrderedItems": [
      {
        "qty_shipped": 1,
        "qty_refunded": 2,
        "id": "sample string 3",
        "status": 0,
        "lineID": 1,
        "sku_code": "sample string 4",
        "qty_purchased": 5,
        "unit_price": 6.0,
        "line_discount_amount": 7.0,
        "item_note": "sample string 8",
        "item_description": "sample string 9",
        "vat_rate": 1.0,
        "vat_id": 1,
        "kit_product_type": 1,
        "kit_parent_line": 1
      },
      {
        "qty_shipped": 1,
        "qty_refunded": 2,
        "id": "sample string 3",
        "status": 0,
        "lineID": 1,
        "sku_code": "sample string 4",
        "qty_purchased": 5,
        "unit_price": 6.0,
        "line_discount_amount": 7.0,
        "item_note": "sample string 8",
        "item_description": "sample string 9",
        "vat_rate": 1.0,
        "vat_id": 1,
        "kit_product_type": 1,
        "kit_parent_line": 1
      }
    ],
    "CustomerReference": "sample string 13",
    "OrderNotes": "sample string 14",
    "DeliveryNotes": "sample string 15",
    "ShippingRateID": 16,
    "ShippingAmountGross": 17.0,
    "CustomerAccountValuePaid": 1.0
  },
  {
    "ShippingTypeID": 1,
    "ShippingTypeName": "sample string 2",
    "CustomerInfo": {
      "ID": "sample string 1",
      "Forename": "sample string 2",
      "Surname": "sample string 3",
      "CompanyName": "sample string 4",
      "MarketingFlagsID": [
        1,
        2
      ],
      "AccountBalance": 1.0,
      "CustomerType": 0,
      "ShopVisibility": {
        "VisibleEverywhere": true,
        "ShopIDs": [
          "sample string 1",
          "sample string 2"
        ]
      },
      "ShopCreatedBy": "sample string 5",
      "PriceListID": null,
      "PriceLevel": 1,
      "AutomaticDiscountPercentage": 0,
      "Notes": "sample string 6",
      "Telephone": "sample string 7",
      "Mobile": "sample string 8",
      "EmailAddress": "sample string 9",
      "WebsiteAddress": "sample string 10",
      "ActiveAccount": true,
      "Address": "sample string 12",
      "PostCode": "sample string 13",
      "TitleID": 1,
      "CountryCode": "sample string 14",
      "ExternalID": "sample string 15",
      "MainAddress": {
        "Company": "sample string 1",
        "Line1": "sample string 2",
        "Line2": "sample string 3",
        "Line3": "sample string 4",
        "PostalTown": "sample string 5",
        "Region": "sample string 6",
        "PostCode": "sample string 7",
        "CountryCode": "sample string 8",
        "Active": true
      }
    },
    "ShopID": "sample string 3",
    "ShopName": "sample string 4",
    "order_id": 5,
    "ExternalIdentifier": "sample string 6",
    "OrderType": 7,
    "eskimo_customer_id": "sample string 8",
    "order_date": "2025-01-18T03:52:52.889948+00:00",
    "invoice_amount": 10.0,
    "amount_paid": 11.0,
    "order_discount": 12.0,
    "DeliveryAddress": {
      "FAO": "sample string 1",
      "AddressLine1": "sample string 2",
      "AddressLine2": "sample string 3",
      "AddressLine3": "sample string 4",
      "PostalTown": "sample string 5",
      "County": "sample string 6",
      "CountryCode": "sample string 7",
      "PostCode": "sample string 8"
    },
    "InvoiceAddress": {
      "FAO": "sample string 1",
      "AddressLine1": "sample string 2",
      "AddressLine2": "sample string 3",
      "AddressLine3": "sample string 4",
      "PostalTown": "sample string 5",
      "County": "sample string 6",
      "CountryCode": "sample string 7",
      "PostCode": "sample string 8"
    },
    "OrderedItems": [
      {
        "qty_shipped": 1,
        "qty_refunded": 2,
        "id": "sample string 3",
        "status": 0,
        "lineID": 1,
        "sku_code": "sample string 4",
        "qty_purchased": 5,
        "unit_price": 6.0,
        "line_discount_amount": 7.0,
        "item_note": "sample string 8",
        "item_description": "sample string 9",
        "vat_rate": 1.0,
        "vat_id": 1,
        "kit_product_type": 1,
        "kit_parent_line": 1
      },
      {
        "qty_shipped": 1,
        "qty_refunded": 2,
        "id": "sample string 3",
        "status": 0,
        "lineID": 1,
        "sku_code": "sample string 4",
        "qty_purchased": 5,
        "unit_price": 6.0,
        "line_discount_amount": 7.0,
        "item_note": "sample string 8",
        "item_description": "sample string 9",
        "vat_rate": 1.0,
        "vat_id": 1,
        "kit_product_type": 1,
        "kit_parent_line": 1
      }
    ],
    "CustomerReference": "sample string 13",
    "OrderNotes": "sample string 14",
    "DeliveryNotes": "sample string 15",
    "ShippingRateID": 16,
    "ShippingAmountGross": 17.0,
    "CustomerAccountValuePaid": 1.0
  }
]

application/xml, text/xml

Sample:

<ArrayOfclsOrderExt xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/EskimoClassLibraries">
  <clsOrderExt>
    <CustomerAccountValuePaid>1</CustomerAccountValuePaid>
    <CustomerReference>sample string 13</CustomerReference>
    <DeliveryAddress>
      <AddressLine1>sample string 2</AddressLine1>
      <AddressLine2>sample string 3</AddressLine2>
      <AddressLine3>sample string 4</AddressLine3>
      <CountryCode>sample string 7</CountryCode>
      <County>sample string 6</County>
      <FAO>sample string 1</FAO>
      <PostCode>sample string 8</PostCode>
      <PostalTown>sample string 5</PostalTown>
    </DeliveryAddress>
    <DeliveryNotes>sample string 15</DeliveryNotes>
    <ExternalIdentifier>sample string 6</ExternalIdentifier>
    <InvoiceAddress>
      <AddressLine1>sample string 2</AddressLine1>
      <AddressLine2>sample string 3</AddressLine2>
      <AddressLine3>sample string 4</AddressLine3>
      <CountryCode>sample string 7</CountryCode>
      <County>sample string 6</County>
      <FAO>sample string 1</FAO>
      <PostCode>sample string 8</PostCode>
      <PostalTown>sample string 5</PostalTown>
    </InvoiceAddress>
    <OrderNotes>sample string 14</OrderNotes>
    <OrderType>7</OrderType>
    <OrderedItems>
      <clsOrderItemExt>
        <item_description>sample string 9</item_description>
        <item_note>sample string 8</item_note>
        <kit_parent_line>1</kit_parent_line>
        <kit_product_type>FixedHeader</kit_product_type>
        <lineID>1</lineID>
        <line_discount_amount>7</line_discount_amount>
        <qty_purchased>5</qty_purchased>
        <sku_code>sample string 4</sku_code>
        <unit_price>6</unit_price>
        <vat_id>1</vat_id>
        <vat_rate>1</vat_rate>
        <id>sample string 3</id>
        <qty_refunded>2</qty_refunded>
        <qty_shipped>1</qty_shipped>
        <status>InitialStatus</status>
      </clsOrderItemExt>
      <clsOrderItemExt>
        <item_description>sample string 9</item_description>
        <item_note>sample string 8</item_note>
        <kit_parent_line>1</kit_parent_line>
        <kit_product_type>FixedHeader</kit_product_type>
        <lineID>1</lineID>
        <line_discount_amount>7</line_discount_amount>
        <qty_purchased>5</qty_purchased>
        <sku_code>sample string 4</sku_code>
        <unit_price>6</unit_price>
        <vat_id>1</vat_id>
        <vat_rate>1</vat_rate>
        <id>sample string 3</id>
        <qty_refunded>2</qty_refunded>
        <qty_shipped>1</qty_shipped>
        <status>InitialStatus</status>
      </clsOrderItemExt>
    </OrderedItems>
    <ShippingAmountGross>17</ShippingAmountGross>
    <ShippingRateID>16</ShippingRateID>
    <amount_paid>11</amount_paid>
    <eskimo_customer_id>sample string 8</eskimo_customer_id>
    <invoice_amount>10</invoice_amount>
    <order_date>2025-01-18T03:52:52.889948+00:00</order_date>
    <order_discount>12</order_discount>
    <order_id>5</order_id>
    <CustomerInfo>
      <AccountBalance>1</AccountBalance>
      <ActiveAccount>true</ActiveAccount>
      <Address>sample string 12</Address>
      <CompanyName>sample string 4</CompanyName>
      <CountryCode>sample string 14</CountryCode>
      <CustomerType>TradeCustomer</CustomerType>
      <EmailAddress>sample string 9</EmailAddress>
      <ExternalID>sample string 15</ExternalID>
      <Forename>sample string 2</Forename>
      <ID>sample string 1</ID>
      <MainAddress>
        <Active>true</Active>
        <Company>sample string 1</Company>
        <CountryCode>sample string 8</CountryCode>
        <Line1>sample string 2</Line1>
        <Line2>sample string 3</Line2>
        <Line3>sample string 4</Line3>
        <PostCode>sample string 7</PostCode>
        <PostalTown>sample string 5</PostalTown>
        <Region>sample string 6</Region>
      </MainAddress>
      <MarketingFlagsID xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:int>1</d4p1:int>
        <d4p1:int>2</d4p1:int>
      </MarketingFlagsID>
      <Mobile>sample string 8</Mobile>
      <Notes>sample string 6</Notes>
      <PostCode>sample string 13</PostCode>
      <ShopCreatedBy>sample string 5</ShopCreatedBy>
      <ShopVisibility>
        <ShopIDs xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:string>sample string 1</d5p1:string>
          <d5p1:string>sample string 2</d5p1:string>
        </ShopIDs>
        <VisibleEverywhere>true</VisibleEverywhere>
      </ShopVisibility>
      <Surname>sample string 3</Surname>
      <Telephone>sample string 7</Telephone>
      <TitleID>1</TitleID>
      <WebsiteAddress>sample string 10</WebsiteAddress>
    </CustomerInfo>
    <ShippingTypeID>1</ShippingTypeID>
    <ShippingTypeName>sample string 2</ShippingTypeName>
    <ShopID>sample string 3</ShopID>
    <ShopName>sample string 4</ShopName>
  </clsOrderExt>
  <clsOrderExt>
    <CustomerAccountValuePaid>1</CustomerAccountValuePaid>
    <CustomerReference>sample string 13</CustomerReference>
    <DeliveryAddress>
      <AddressLine1>sample string 2</AddressLine1>
      <AddressLine2>sample string 3</AddressLine2>
      <AddressLine3>sample string 4</AddressLine3>
      <CountryCode>sample string 7</CountryCode>
      <County>sample string 6</County>
      <FAO>sample string 1</FAO>
      <PostCode>sample string 8</PostCode>
      <PostalTown>sample string 5</PostalTown>
    </DeliveryAddress>
    <DeliveryNotes>sample string 15</DeliveryNotes>
    <ExternalIdentifier>sample string 6</ExternalIdentifier>
    <InvoiceAddress>
      <AddressLine1>sample string 2</AddressLine1>
      <AddressLine2>sample string 3</AddressLine2>
      <AddressLine3>sample string 4</AddressLine3>
      <CountryCode>sample string 7</CountryCode>
      <County>sample string 6</County>
      <FAO>sample string 1</FAO>
      <PostCode>sample string 8</PostCode>
      <PostalTown>sample string 5</PostalTown>
    </InvoiceAddress>
    <OrderNotes>sample string 14</OrderNotes>
    <OrderType>7</OrderType>
    <OrderedItems>
      <clsOrderItemExt>
        <item_description>sample string 9</item_description>
        <item_note>sample string 8</item_note>
        <kit_parent_line>1</kit_parent_line>
        <kit_product_type>FixedHeader</kit_product_type>
        <lineID>1</lineID>
        <line_discount_amount>7</line_discount_amount>
        <qty_purchased>5</qty_purchased>
        <sku_code>sample string 4</sku_code>
        <unit_price>6</unit_price>
        <vat_id>1</vat_id>
        <vat_rate>1</vat_rate>
        <id>sample string 3</id>
        <qty_refunded>2</qty_refunded>
        <qty_shipped>1</qty_shipped>
        <status>InitialStatus</status>
      </clsOrderItemExt>
      <clsOrderItemExt>
        <item_description>sample string 9</item_description>
        <item_note>sample string 8</item_note>
        <kit_parent_line>1</kit_parent_line>
        <kit_product_type>FixedHeader</kit_product_type>
        <lineID>1</lineID>
        <line_discount_amount>7</line_discount_amount>
        <qty_purchased>5</qty_purchased>
        <sku_code>sample string 4</sku_code>
        <unit_price>6</unit_price>
        <vat_id>1</vat_id>
        <vat_rate>1</vat_rate>
        <id>sample string 3</id>
        <qty_refunded>2</qty_refunded>
        <qty_shipped>1</qty_shipped>
        <status>InitialStatus</status>
      </clsOrderItemExt>
    </OrderedItems>
    <ShippingAmountGross>17</ShippingAmountGross>
    <ShippingRateID>16</ShippingRateID>
    <amount_paid>11</amount_paid>
    <eskimo_customer_id>sample string 8</eskimo_customer_id>
    <invoice_amount>10</invoice_amount>
    <order_date>2025-01-18T03:52:52.889948+00:00</order_date>
    <order_discount>12</order_discount>
    <order_id>5</order_id>
    <CustomerInfo>
      <AccountBalance>1</AccountBalance>
      <ActiveAccount>true</ActiveAccount>
      <Address>sample string 12</Address>
      <CompanyName>sample string 4</CompanyName>
      <CountryCode>sample string 14</CountryCode>
      <CustomerType>TradeCustomer</CustomerType>
      <EmailAddress>sample string 9</EmailAddress>
      <ExternalID>sample string 15</ExternalID>
      <Forename>sample string 2</Forename>
      <ID>sample string 1</ID>
      <MainAddress>
        <Active>true</Active>
        <Company>sample string 1</Company>
        <CountryCode>sample string 8</CountryCode>
        <Line1>sample string 2</Line1>
        <Line2>sample string 3</Line2>
        <Line3>sample string 4</Line3>
        <PostCode>sample string 7</PostCode>
        <PostalTown>sample string 5</PostalTown>
        <Region>sample string 6</Region>
      </MainAddress>
      <MarketingFlagsID xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:int>1</d4p1:int>
        <d4p1:int>2</d4p1:int>
      </MarketingFlagsID>
      <Mobile>sample string 8</Mobile>
      <Notes>sample string 6</Notes>
      <PostCode>sample string 13</PostCode>
      <ShopCreatedBy>sample string 5</ShopCreatedBy>
      <ShopVisibility>
        <ShopIDs xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:string>sample string 1</d5p1:string>
          <d5p1:string>sample string 2</d5p1:string>
        </ShopIDs>
        <VisibleEverywhere>true</VisibleEverywhere>
      </ShopVisibility>
      <Surname>sample string 3</Surname>
      <Telephone>sample string 7</Telephone>
      <TitleID>1</TitleID>
      <WebsiteAddress>sample string 10</WebsiteAddress>
    </CustomerInfo>
    <ShippingTypeID>1</ShippingTypeID>
    <ShippingTypeName>sample string 2</ShippingTypeName>
    <ShopID>sample string 3</ShopID>
    <ShopName>sample string 4</ShopName>
  </clsOrderExt>
</ArrayOfclsOrderExt>