Website logo
Docs
API Reference
Postman Collection
Release Notes
Navigate through spaces
⌘K
Introduction
Overview
Getting started with the OS1 Platform
Getting started with building Apps
Concepts
Working with Callbacks
Console UI Overview
Custom Code
Working with GraphQL
Custom Attributes Ownership
Attribute-Based Access Control (ABAC)
Data Listing and Query (DLQS) Search
Core API dev guides
Overview
Authentication And Authorization
Participant
Container
Dispatch
Orchestrator
Workflow
Secure Data Storage
File Management
State Machine
Entity
Notification
Motion Tracking System
Location
Platform Order Management
Address
Scheduler
Logistics Framework API Dev guides
Overview
LogisticsOrder API
User API
Facility API
Vehicle API
How-To Guides
Integrate Your Application with Console UI
Integrate with Participants
Integrate with Containers
Integrate with Users
Integrate with Vehicles
Integrate with Facilities
Integrate with Entities
Integrate with Dispatch
Integrate with Logistics Order
Integrate with Platform Order Management
Integrate with Location Service
Integrate with Orchestrator
GraphQl Schemas
GraphQL: Dispatch Queries
GraphQL: Order Queries
GraphQL: Workflow Queries
GraphQL: Container Queries
Platform SDKs
SDK Overview
Sample Apps
Vehicle Management App
Container App
Resources
FAQs
Glossary
Data Types Used in OS1
Development Guidelines
Entity, Event, and Reason Codes
Service/API Level Error Codes
Docs powered by Archbee
GraphQl Schemas
GraphQL: Order Queries

orderList

7min

Overview

The orderList is a GraphQL API schema that allows you to retrieve and paginate through an ordered list of data.

Arguments

  • tenant: The tenant string specifies the client's information for identification purposes.
  • page: This integer specifies the current page in the paginated list.
  • filter: This is a string used to filter out data that meets certain criteria.
  • size: This integer determines the number of items per page.
  • sort: This string is used to specify the sorting order of the items.

Objects

The orderList returns a data object that includes the following fields:

  • attributes: Contains additional details associated with the order.
  • batchId: Identifier for the batch that the order belongs to.
  • cancellationFailureReasonCode: Specifies the reason code for cancellation failure.
  • cancellationRequested: Indicates if a cancellation has been requested.
  • cancellationRequestedBy: Shows who requested the cancellation.
  • cancellationRequestedOn: Timestamp of when the cancellation was requested.
  • cancellationStatus: Status of the cancellation request.
  • cancellationStatusTimestamp: Timestamp of the current cancellation status.
  • clientId: Identifier for the client that the order belongs to.
  • clientName: Name of the client associated with the order.
  • clientOrderId: Order identifier as set by the client.
  • createdAt: Timestamp of when the order was created.
  • createdBy: User who created the order.
  • domain: The domain that the order belongs to.
  • id: Unique identifier for the order.
  • orderSchemaVersion: The version of the schema used for the order.
  • readyToProcess: Boolean value indicating if the order is ready for processing.
  • shipmentFlow: Information about the shipment process for the order.
  • status: The current status of the order.
  • subStatus: More detailed status information of the order.
  • tenantId: Identifier for the tenant that the order belongs to.
  • type: Specifies the type of order.
  • updatedAt: Timestamp of when the order was last updated.
  • updatedBy: User who last updated the order.
  • workOrderFlowType: Specifies the type of work order flow.

Nested Objects:

  • dropDetails: Contains the contact and location details where the order will be dropped.
  • orderSummary: Contains summary details for the order such as invoice number, total items, total order cost, and total weight.
  • workOrders: Contains the work order details associated with the order.

Each of these nested objects contains further fields which are documented in their respective sections.

Drop Details

  • contact: Contact details for the drop location.
  • location: Contains detailed location information where the order will be dropped. Fields include address, createdAt, createdBy, description, geolocation, locationId, similarityId, tags, tenantId, updatedAt, and updatedBy.

Order Summary

  • invoiceNumber: The invoice number associated with the order.
  • orderDescription: A description of the order.
  • totalItems: The total number of items in the order.
  • totalOrderCost: The total cost of the order.
  • totalWeight: The total weight of the order.

Work Orders

This object includes all associated work orders for the order. It contains several fields such as attributes, cancellationFailureReasonCode, cancellationRequested, cancellationRequestedBy, cancellationRequestedOn, cancellationStatus, cancellationStatusTimestamp, containers, createdAt, createdBy, and more. It also contains nested objects for deliveryDetails, pickupDetails, and returnDetails, each containing further location and timing details.

Please note that each of these nested objects and their fields are similarly structured, containing comprehensive details pertaining to delivery, pickup, and return processes.

Pagination Object

orderList includes a pagination object with the following fields:

  • currPage: This is an integer that represents the current page number.
  • hasNextPage: This is a boolean that signifies whether there are more pages available after the current page.
  • nextPage: This is an integer that indicates the page number of the next page. If there is no next page, this field is null.
  • pageSize: This is an integer that represents the number of orders in the current page.
  • prevPage: This is an integer that indicates the page number of the previous page. If there is no previous page, this field is null.
  • totalCount: This is an integer that represents the total count of orders that meet the specified criteria.



Updated 03 Aug 2023
Did this page help you?
PREVIOUS
order
NEXT
GraphQL: Workflow Queries
Docs powered by Archbee
TABLE OF CONTENTS
Overview
Arguments
Objects
Drop Details
Order Summary
Work Orders
Pagination Object
Docs powered by Archbee