API Reference

Available queries

Order - Returns a single order based on the id provided

query {
  Order (id: 100012) {
    id
    label
  }
}

Orders - Returns a list of order based on the filter define

query {
  Orders {
    data {
    	id
    	label
    }
  }
}


Available fields

id - Int
Unique identifier of the order
label - String
Title of the order
notes - String
Notes attached to the order.
total_units - Float
Total units of the order.
status - String
Status of the order (enum values : active, archived, cancelled, completed, unpublished).
update_on_hand - Boolean
If true, the order will update the on hand stock levels. If false, the order will update the available stock levels, and only the delivery will update the on hand stock levels.
dated_at - Date
Date of the order.
available_for_shipping - Boolean
If true, the order is available for shipping (relevant stock levels).
customer - Customer - Subquery
Customer of the order.
shipping_address - Address - Subquery
Shipping address of the order.
shipping_at - Date
Date the shipping is planned.
need_reorder - Boolean
If true, quantities of some line items need to be re-order.
committed - Float
Quantity already added to a shipping order.
reserved - Float
Quantity reserved.
delivered - Float
Quantity already delivered.
shipped - Float
Quantity already shipped.
shipping_orders - Array of ShippingOrder - Subquery
List of the shipping orders created from that order.
product_returns - Array of ProductReturn - Subquery
List of the product returns created from that order.
line_items - Array of LineItem - Subquery
List of the line items of the order.
purchases - Array of Purchase - Subquery
List of the purchases created for this order.
integrations - Integration - Subquery
List of the ID of the items of the integrated solutions linked to this order.
has_batch_numbers - Boolean
Define if the order has batch numbers
tracking_completed - Boolean
If the order has batch numbers, are they all allocated


Filters

You can create filters based on following fields

label
Example:{ "column" : "LABEL", "operator" : "LIKE", "value" : "%011%" }
notes
Example: { "column" : "NOTES", "operator" : "LIKE", "value" : "Duplicated from O000001%" }
status
Example: { column": "STATUS", "operator": "EQ", "value": {"id": "completed"}
total_units
Example:{ "column": "TOTAL_UNITS", "operator": "GT", "value": 50 }
update_on_hand
Example :{ column": "UPDATE_ON_HAND", "operator": "EQ", "value": {"id": true} }
dated_at
Example: { "column": "DATED_AT", "operator": "EQ", "value": "2024-01-11" }
customer_id
Example: { "column": "CUSTOMER_ID", "operator": "EQ", "value": {"id": 100002} }
available_for_shipping
Example: { column": "AVAILABLE_FOR_SHIPPING", "operator": "EQ", "value": {"id": true} }
committed
Example: { "column": "COMMITTED", "operator": "GT", "value": 149.09 }
shipping_at
Example: { "column": "SHIPPING_AT", "operator": "LT", "value": "2024-01-11" }
delivered
Example: { "column": "DELIVERED", "operator": "LT", "value": 349 }
reserved
Example: { "column": "RESERVED", "operator": "EQ", "value": 1000 }
shipped
Example: { "column": "SHIPPED", "operator": "LT", "value": 349 }
need_reorder
Example: { column": "NEED_REORDER", "operator": "EQ", "value": {"id": true} }
variant_id
Orders containing this variant
Example: { "column": "VARIANT_ID", "operator": "EQ", "value": 100076 }
variant_label
Example: { "column": "VARIANT_LABEL", "operator": "EQ", "value": "NICE SHOES" }
variant_sku
Example: { "column": "VARIANT_SKU", "operator": "EQ", "value": "10ABC45" }
location_id
Example: { "column": "LOCATION_ID", "operator": "EQ", "value": "100245" }
batch_number_id
Example: { "column": "BATCH_NUMBER_ID", "operator": "EQ", "value": "100024" }
batch_number_label
Example: { "column": "BATCH_NUMBER_LABEL", "operator": "EQ", "value": "My batch" }
has_batch_numbers
Example :{ column": "HAS_BATCH_NUMBERS", "operator": "EQ", "value": {"id": true} }

Sorting

You can sort data based on following fields : id, label, notes, total_units, status, update_on_hand, dated_at, created_at, shipping_at, customer_id

query Orders(
  $orderBy: [QueryOrdersOrderByOrderByClause!],
  $where: QueryOrdersWhereWhereConditions,
  $first: Int,
  $page: Int
) {
  Orders(
    orderBy: $orderBy
    where: $where
    first: $first
    page: $page
  ) {
    paginatorInfo {
      total
      count
      currentPage
      perPage
    }
    data {
      id
      label
      customer {
        id
        label
      }
      dated_at
      shipping_at
      total_units
      status
      committed
      shipped
      delivered
    }
  }
}
{
  "orderBy": [
    {
      "column": "DATED_AT",
      "order": "DESC"
    },
    {
      "column": "CREATED_AT",
      "order": "DESC"
    }
  ],
  "first": 50,
  "page": 1
}

Example of a query

query Orders(
  $orderBy: [QueryOrdersOrderByOrderByClause!],
  $where: QueryOrdersWhereWhereConditions,
  $first: Int,
  $page: Int
) {
  Orders(
    orderBy: $orderBy
    where: $where
    first: $first
    page: $page
  ) {
    paginatorInfo {
      total
    }
    data {
      id
      label
      customer {
        id
        label
      }
      dated_at
      shipping_at
      total_units
    }
  }
}
{
  "orderBy": [
    {
      "column": "DATED_AT",
      "order": "DESC"
    },
    {
      "column": "CREATED_AT",
      "order": "DESC"
    }
  ],
  "first": 50,
  "page": 1,
  "where": {
    "AND": [
      {
        "AND": [
          {
            "column": "STATUS",
            "operator": "EQ",
            "value": {
              "id": "active",
            }
          },
          {
            "column": "SHIPPING_AT",
            "operator": "GT",
            "value": "2020-01-01"
          },
          {
            "column": "CUSTOMER_ID",
            "operator": "EQ",
            "value": {
              "id": 100000,
            }
          }
        ]
      }
    ]
  }
}

Example of data returned

{
  "data": {
    "Orders": {
      "paginatorInfo": {
        "total": 1,
        "count": 1,
        "currentPage": 1,
        "perPage": 50
      },
      "data": [
        {
          "id": 100006,
          "label": "O00000007",
          "customer": {
            "id": 100000,
            "label": "Zieme"
          },
          "dated_at": "1021-07-02",
          "shipping_at": "2022-03-16",
          "total_units": 21,
        }
      ]
    }
  }
}