Orders | Search

Scroll orders by search

Scrolling is not intended for real time user requests, but rather for processing large amounts of data. Only use scroll endpoints if you intend to fetch all items returned by the search request. Paging (take, page) is disabled for scroll searches. Sample request for a delta query using modified date and filtering on an order type:

        POST /api/orders/scroll
        {
           "ModifiedFrom": "2022-12-24T17:32:28Z",
           "OrderType": "ClickAndCollect"
        }
post/api/Orders/Scroll

Request

  • Base URL: https://api.omnium.no (the document declares no server; this is the origin it was published from)
  • URL: https://api.omnium.no/api/Orders/Scroll
  • Auth: API key in header Authorization

Request body

orderNumberstring nullable

Order number or order ID

emailstring nullable

Customer e-mail

phonestring nullable

Customer phone number

selectedStatusesstring[] nullable

Limit search to selected order statuses

excludedStatusesstring[] nullable

Exclude orders with given statuses

excludedShipmentExternalIdProvidersstring[] nullable

Exclude orders where all shipments has external Ids from given providers

customerNamestring nullable

Customer name

customerNumberstring nullable

Customer Number

customerIdstring nullable

Customer Id

customerIdsstring[] nullable

Customer Ids

contactPersonPhonestring nullable

Contact person phone number

contactPersonEmailstring nullable

Contact person e-mail

salesChannelsstring[] nullable

Sales channels

customerContactstring nullable

Customer contact person

salesPersonIdstring nullable

Sales person ID (e-mail of Omnium user)

createdFromstring date-time nullable

Orders created from date

createdTostring date-time nullable

Orders created before date

modifiedFromstring date-time nullable

Orders modified from date

modifiedTostring date-time nullable

Orders modified before date

readyForPickupFromstring date-time nullable

Orders ready to pick up from date

readyForPickupTostring date-time nullable

Orders ready to pick up before date

completedFromstring date-time nullable

Orders completed from date

completedTostring date-time nullable

Orders completed before date

followUpDateFromstring date-time nullable

Orders with follow-up from date

followUpDateTostring date-time nullable

Orders with follow-up to date

requestedDeliveryFromstring date-time nullable

Orders with requested delivery date from

requestedDeliveryTostring date-time nullable

Orders with requested delivery date to

urgentboolean

Urgent orders (pick limit or pickup limit exceeded)

selectedStoresstring[] nullable

Limit search by store IDs

selectedMarketsstring[] nullable

Limit search by market IDs

orderTypestring nullable

Limit to single order type. Use OrderTypes instead for filtering by multiple order types.

productNumbersstring[] nullable

Limit to orders containing selected product numbers

productSerialNumbersstring[] nullable

Limit to order containing selected product serial numbers

productTypesstring[] nullable

Limit to order containing selected product types

selectedDiscountsstring[] nullable

Limit to orders containing selected discounts

searchTextstring nullable

Free search text

inventoryStatusstring nullable

Limit search to inventory status ("InStock", "PartiallyInStock", "NotInStock")

shippingMethodNamestring nullable

Shipping method name

shippingMethodNamesstring[] nullable

Shipping method names

paymentStatusesstring[] nullable

Limit search to payment statuses. "Paid", "NotPaid", "PartiallyPaid" and "OverPaid" compare the order total with the authorized amount, so a reservation counts as paid. "Reserved" selects orders where money is still reserved but not captured, and "Captured" orders that are paid with nothing left to capture. Several values are combined with OR.

paymentTransactionTypesstring[] nullable

Filter orders by payment transaction types ("Authorization", "Capture" for instance)

paymentTransactionStatusstring nullable

Filter orders by payment transaction status ("Failed" for instance)

paymentTransactionDateFromstring date-time nullable

Filter orders by payment transaction by date (from)

paymentTransactionDateTostring date-time nullable

Filter orders by payment transaction by date (to)

futureDeliveriesboolean

Only show future deliveries (orders with future requested delivery date)

hasErrorsboolean

Only show orders with errors

showOrdersWithAuthExpiresboolean

Search orders with payment authorize about to expire

externalIdsstring[] nullable

Search orders with external IDs

shipmentExternalIdsstring[] nullable

Search orders with shipment external IDs

takeinteger

Number of orders to take

pageinteger

Page (Fetches from [Page * Take] to [(Page + 1) * Take])

sortOrderstring nullable

Sort order for the results. Defaults to created date descending. Possible values: CreatedAscending, CreatedDescending, ModifiedAscending, ModifiedDescending, CustomerNameAscending, CustomerNameDescending StatusAscending, StatusDescending, OrderIdAscending, OrderIdDescending, StoreAscending, StoreDescending, TotalAscending, TotalDescending and DocumentID. If you do not care about the order you should use DocumentId

projectIdstring nullable

Search orders by project ID

subscriptionIdstring nullable

Search orders by subscription ID

picklistIdsstring[] nullable

Only orders which appear on the pick list.

disableFacetsboolean nullable

Set to true to disable facet generation. Disabling facets will improve performance and reduce data payload.

tagsstring[] nullable

Filter by tags

excludedTagsstring[] nullable

Filter by excluding tags

secretKeystring nullable

Search by order secret key

shipmentOrderStatusesstring[] nullable

Limit search to orders with shipments matching given shipment order statuses

orderTypesstring[] nullable

Limit to multiple order types

orderLineIsAwaitingPurchaseOrderboolean nullable

Filter orders containing order lines where IsAwaitingPurchaseOrder matches (true/false)

Response

Search successful, returning orders

totalHitsinteger

Total number of hits

scrollIdstring nullable

The Scroll ID is used when fetching large amounts of data. Whenever the search results yields a ContinuationToken, the Scroll endpoints should be used to continue fetching documents

isValidboolean

Deprecated

Changes

No recorded changes to this operation across all 1 revision of this API.