Queries#
Queries are read-only operations used to fetch data from the API. All queries are sent as POST requests to https://afosto.app/graphql.
account) require a user token obtained via logInCustomer. Most other queries work with a standard API key.account#
Fetch the currently authenticated account. Requires a user token.
No arguments.
Returns: Account
| Name | Type | Required | Description |
|---|---|---|---|
email | String! | Required | Email address |
given_name | String! | Required | First name |
additional_name | String! | Required | Middle name |
family_name | String! | Required | Last name |
Example#
address#
Fetch an address by ID.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the address |
Returns: Address
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID |
address_line_1 | String! | Required | Street address line 1 |
address_line_2 | String | Optional | Street address line 2 |
locality | String! | Required | City / locality |
Example#
addressOptions#
Fetch the address formatting rules for a country: which address fields are required or allowed, expected input formats, and the administrative areas (e.g. provinces) with their municipalities. Useful for building and validating address forms.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
country_code | String | Optional | ISO country code to fetch address options for (e.g. "NL") |
Returns: AddressOptions
| Name | Type | Required | Description |
|---|---|---|---|
country_code | String! | Optional | ISO country code these options apply to |
required | [String]! | Optional | Address fields that are required in this country |
allowed | [String]! | Optional | Address fields that are allowed in this country |
format | AddressOptionFormats!▾ | Optional | Expected input formats per address field |
prefix | AddressOptionPrefixes!▾ | Optional | Prefixes used per address field |
types | AddressOptionTypes!▾ | Optional | Field type hints per address component |
administrative_areas | [AdministrativeArea]!▾ | Optional | Administrative areas (e.g. provinces or states) of the country |
Example#
agreement#
Fetch a single payment agreement by ID. Agreements define payment terms — such as down payments, post-payment, cash on delivery, or marketplace settlement — including their conditions and localized texts.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID of the agreement |
Returns: Agreement
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique agreement ID |
is_default_enabled | Boolean! | Optional | Whether this agreement is enabled by default |
enabled_rule_set | RuleSet▾ | Optional | Rule set that determines when this agreement is enabled |
conditions | [AgreementCondition]!▾ | Optional | Payment conditions attached to the agreement |
type | AgreementType!▾ | Optional | Agreement type |
name | String! | Optional | Agreement name |
instructions | String! | Optional | Payment instructions shown to the customer |
description | String! | Optional | Agreement description |
i18n | [Internationalization]!▾ | Optional | Localized name, description and instructions |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
agreements#
Fetch a paginated list of payment agreements, optionally narrowed with a query filter. Agreements define payment terms such as down payments, post-payment, cash on delivery, or marketplace settlement.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
query | QueryFilter▾ | Optional | Opaque query filter to narrow results |
Returns: AgreementConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [Agreement]!▾ | Optional | The agreements on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
announcement#
Fetch a single delivery announcement by ID. An announcement notifies a location or warehouse of an expected incoming delivery (e.g. from a supplier), including the announced items and receiving statistics.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the announcement |
Returns: Announcement
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique announcement ID |
type | String! | Optional | Announcement type |
state | AnnouncementState!▾ | Optional | Current state |
status | AnnouncementState!▾ | Optional | Current status (alias of state) |
number | String! | Optional | Human-readable announcement number |
description | String! | Optional | Announcement description |
currency | Currency!▾ | Optional | ISO 4217 currency code |
expected_at | DateTime!▾ | Optional | Expected delivery date |
buyer | Business▾ | Optional | The buying business |
location | Location▾ | Optional | Receiving location |
sender | DeliveryRequestSender!▾ | Optional | The sending party of the delivery |
supplier | Business▾ | Optional | The supplying business |
items | [AnnouncementItem]!▾ | Optional | Announced delivery items |
statistics | AnnouncementStatistics!▾ | Optional | Receiving progress statistics |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
announcementItem#
Fetch a single delivery announcement item by ID. An announcement item is one announced unit of an incoming delivery, including its cost price, specification (batch, serial, weight), the parent announcement, and the related product.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the announcement item |
Returns: DeliveryAnnouncementItem
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique announcement item ID |
state | String! | Optional | Current state of the item |
status | String! | Optional | Current status of the item |
sku | String! | Optional | Product SKU |
cost_price | Int64! | Optional | Cost price in cents |
specification | AnnouncementItemSpecification!▾ | Optional | Item specification details |
meta_data | JsonObject▾ | Optional | Arbitrary metadata |
announcement | Announcement▾ | Optional | Parent delivery announcement |
product | Product▾ | Optional | The related product |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
announcements#
Fetch a paginated list of delivery announcements — notifications of expected incoming deliveries — filtered by state, buyer, or receiving location.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
before | String | Optional | Cursor for backward pagination |
filters | AnnouncementsFilterInput!▾ | Required | Filters to apply |
Returns: AnnouncementConnection!
| Name | Type | Required | Description |
|---|---|---|---|
announcements | [Announcement]!▾ | Optional | The announcements on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
bucket#
Fetch a single bucket by ID. A bucket is a named endpoint with its connected integrations, identified by a code.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the bucket |
Returns: Bucket
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique bucket ID |
name | String! | Optional | Bucket name |
endpoint | String! | Optional | Endpoint URL of the bucket |
code | String! | Optional | Unique bucket code |
integrations | [Integration]!▾ | Optional | Integrations connected to the bucket |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
buckets#
Fetch a paginated list of buckets — named endpoints with their connected integrations — with optional ordering by name or date.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
orderBy | BucketsOrderByInput▾ | Optional | Ordering of the results |
sort | BucketsOrderByInput▾ | Optional | Alternative sort input (same shape as orderBy) |
Returns: BucketConnection!
| Name | Type | Required | Description |
|---|---|---|---|
buckets | [Bucket]!▾ | Optional | The buckets on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
business#
Fetch a physical store location by ID.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the business |
Returns: Business
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID |
type | String! | Required | Business type |
name | String! | Required | Name |
email | String | Optional | Email address |
Example#
See also: businesses
businesses#
Fetch a paginated list of business locations.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to returnDefault: 10 |
after | String | Optional | Cursor for forward pagination |
before | String | Optional | Cursor for backward pagination |
type | String | Optional | Filter by business type |
sort | BusinessesSortInput▾ | Optional | Sort order |
Returns: Business
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID |
type | String! | Required | Business type |
name | String! | Required | Name |
email | String | Optional | Email address |
Example#
See also: business
cart#
Fetch a cart by ID.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the cart |
intent | TrackingEvent▾ | Optional | Optional tracking event |
Returns: Cart
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID of the cart |
number | String! | Required | Cart number |
total | Money! | Required | Total value |
subtotal | Money! | Required | Total before discounts |
Example#
channel#
Fetch a channel (storefront) by ID. If no ID is provided, the default channel is returned.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String | Optional | The ID of the channel (optional — omit for default) |
Returns: Channel
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID |
name | String! | Required | Channel name |
type | String! | Required | Channel type |
description | String! | Required | Channel description |
Example#
claim#
Fetch a single inventory claim by ID. A claim holds a quantity of a product in a warehouse for a business — for example a reservation or commitment — until it expires.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the claim |
Returns: Claim
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique claim ID |
product | Product!▾ | Optional | The claimed product |
quantity | Int! | Optional | Claimed quantity |
state | ClaimState!▾ | Optional | Current state of the claim |
status | ClaimState!▾ | Optional | Current status (alias of state) |
expires_at | DateTime!▾ | Optional | When the claim expires |
warehouse | Warehouse!▾ | Optional | Warehouse holding the claimed stock |
business | Business!▾ | Optional | Business the claim belongs to |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
comment#
Fetch a single task comment by ID. Comments are notes attached to tasks and include the comment body, the parent task and the user who wrote it.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The comment ID |
Returns: Comment
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique comment ID |
body | String! | Optional | The comment text |
sub | String! | Optional | Subject identifier of the comment author |
task | Task!▾ | Optional | The task this comment belongs to |
created_at | DateTime!▾ | Optional | Creation date |
user | User▾ | Optional | The user who wrote the comment |
Example#
contact#
Fetch a contact by ID.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the contact |
version | String | Optional | Optional version string for cache busting |
Returns: Contact
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID |
email | String! | Required | Email address |
given_name | String! | Required | First name |
family_name | String | Optional | Last name |
Example#
delivery#
Fetch a single delivery by ID. A delivery represents a planned shipment from a sender to a receiver, including the shipping method, carrier options, the from/to addresses and the parcels it is packed into.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The delivery ID |
Returns: Delivery
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique delivery ID |
number | String! | Optional | Human-readable delivery number |
status | String! | Optional | Current delivery status |
handle_at | DateTime!▾ | Optional | Date the delivery should be handled |
expected_at | DateTime!▾ | Optional | Expected delivery date |
method | ShippingMethod▾ | Optional | The shipping method used for this delivery |
provider_method | ProviderOption▾ | Optional | Method as resolved by the shipping provider |
provider_option | ProviderOption▾ | Optional | Selected carrier option from the shipping provider |
from | ShippingAddresses!▾ | Optional | Sender address, pickup point or location |
to | ShippingAddresses!▾ | Optional | Receiver address, pickup point or location |
parcels | [Parcel]!▾ | Optional | Parcels that make up this delivery |
handled_at | DateTime!▾ | Optional | Date the delivery was handled |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
deliveryRequest#
Fetch a single delivery request by ID. A delivery request asks a sender — a business, supplier or one of your locations — to deliver a set of items, and tracks the state of each requested item until the request is closed.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The delivery request ID |
Returns: DeliveryRequest
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique delivery request ID |
state | DeliveryRequestItemState!▾ | Optional | Current state of the request |
status | DeliveryRequestItemState!▾ | Optional | Alias of state |
number | String! | Optional | Human-readable request number |
description | String! | Optional | Request description |
currency | Currency!▾ | Optional | ISO 4217 currency code |
close_at | DateTime!▾ | Optional | Date the request closes |
sender | DeliveryRequestSender!▾ | Optional | The party asked to deliver the items |
requester | Business▾ | Optional | The business that requested the delivery |
location | Location▾ | Optional | The location the items should be delivered to |
items | [DeliveryRequestItem]!▾ | Optional | The items requested for delivery |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
deliveryRequestItem#
Fetch a single delivery request item by ID. The item describes one requested product line — its SKU, cost price and fulfilment state — together with the delivery request, order and product it relates to.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The delivery request item ID |
Returns: ListedDeliveryRequestItem
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique delivery request item ID |
sku | String! | Optional | SKU of the requested product |
state | DeliveryRequestItemState!▾ | Optional | Current item state |
status | DeliveryRequestItemState!▾ | Optional | Alias of state |
cost_price | Money!▾ | Optional | Cost price of the item |
position | String! | Optional | Warehouse position |
order | Order▾ | Optional | The order the item is requested for |
order_item | CollectionItem▾ | Optional | The order item the request covers |
meta_data | JsonObject!▾ | Optional | Arbitrary metadata |
request | DeliveryRequest▾ | Optional | The delivery request this item belongs to |
product | Product▾ | Optional | The requested product |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
drawer#
Fetch a single POS cash drawer by ID, including its current status, the sales channel it belongs to, the starting float and the expected cash amount based on registered mutations.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The drawer ID |
Returns: Drawer
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique drawer ID |
label | String! | Optional | Drawer label (e.g. "Register 1") |
channel | Channel!▾ | Optional | The sales channel the drawer belongs to |
status | DrawerStatus!▾ | Optional | Current drawer status |
starting_amount | Money!▾ | Optional | Starting float when the drawer was opened |
expected_amount | Money!▾ | Optional | Expected cash amount based on registered mutations |
last_started_at | DateTime▾ | Optional | When the current or last session started |
last_closed_at | DateTime▾ | Optional | When the drawer was last closed |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
drawerMutation#
Fetch a single cash drawer mutation by ID. A drawer mutation records a manual deposit into or withdrawal from a POS drawer, with a note explaining the change and the affected amount.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The drawer mutation ID |
Returns: DrawerMutation
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique mutation ID |
type | MutationType!▾ | Optional | Mutation type |
note | String! | Optional | Note explaining the mutation |
amount | Money!▾ | Optional | The mutated amount |
status | String! | Optional | Mutation status |
drawer | Drawer!▾ | Optional | The drawer the mutation applies to |
created_at | DateTime!▾ | Optional | Creation date |
Example#
drawerReport#
Fetch a single drawer report by ID. A drawer report covers one till session and reconciles the starting float, the expected amount, the counted (actual) amount and the skimmed and closing amounts, together with all cash mutations registered during the session.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The drawer report ID |
Returns: DrawerReport
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique report ID |
start_at | DateTime!▾ | Optional | Start of the reported session |
end_at | DateTime!▾ | Optional | End of the reported session |
drawer | Drawer!▾ | Optional | The drawer the report is for |
user | User▾ | Optional | The user who closed the drawer |
starting_amount | Money!▾ | Optional | Float at the start of the session |
expected_amount | Money!▾ | Optional | Expected amount based on registered mutations |
actual_amount | Money!▾ | Optional | Counted amount at close |
skimmed_amount | Money!▾ | Optional | Amount skimmed (taken to the safe or bank) |
closing_amount | Money!▾ | Optional | Amount left in the drawer at close |
mutations | [DrawerMutation]!▾ | Optional | Cash mutations registered during the session |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
drawerReports#
Fetch a paginated list of drawer reports. Each report reconciles one till session — starting float, expected, counted, skimmed and closing amounts — and can be filtered by drawer or by open/closed sessions.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
filters | DrawerReportsFilterInput▾ | Optional | Filter the reports |
query | QueryFilter▾ | Optional | Opaque query filter to narrow results |
Returns: DrawerReportConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [DrawerReport]!▾ | Optional | The drawer reports on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
drawers#
Fetch a paginated list of POS cash drawers, filtered by ID, sales channel or state. Each drawer carries its current status, starting float and expected cash amount.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
filters | DrawersFilterInput!▾ | Required | Filter the drawers |
Returns: DrawerConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [Drawer]!▾ | Optional | The drawers on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
file#
Fetch a single stored file (such as a product image, invoice PDF, or other uploaded asset) by its ID, including its public URL and metadata.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | Unique ID of the file to fetch |
Returns: File
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique file ID |
filename | String! | Optional | Original file name |
label | String! | Optional | Human-readable label for the file |
dir | String! | Optional | Directory path the file is stored under |
type | String! | Optional | File type (e.g. image, document) |
mime | String! | Optional | MIME type (e.g. "image/jpeg") |
url | String! | Optional | URL where the file can be accessed |
metadata | JsonObject▾ | Optional | Arbitrary metadata attached to the file |
meta_data | JsonObject▾ | Optional | Arbitrary metadata attached to the file (alias of metadata) |
is_public | Boolean! | Optional | Whether the file is publicly accessible |
is_listed | Boolean! | Optional | Whether the file is shown in file listings |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
index#
Fetch a single search index configuration by ID, including its field mappings, synonyms, ranking rules, and facet settings.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | Unique ID of the index to fetch |
Returns: Index
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique index ID |
name | String! | Optional | Index name |
alias | String! | Optional | Alias used to query the index |
state | IndexState!▾ | Optional | Current state of the index |
status | IndexState!▾ | Optional | Current status of the index (alias of state) |
source | IndexSource!▾ | Optional | Data source that feeds the index |
synonyms | [Synonym]!▾ | Optional | Synonym mappings applied during search |
fields | [IndexField]!▾ | Optional | Field mappings from source data to index fields |
stop_words | [String]! | Optional | Words ignored during search |
ranking_rules | [String]! | Optional | Ordered ranking rules applied to results |
facet_fields | [String]! | Optional | Fields available for faceting |
search_fields | [String]! | Optional | Fields that are searched |
distinct_field | String! | Optional | Field used to deduplicate results |
display_fields | [String]! | Optional | Fields returned in search results |
available_fields | [String]! | Optional | All fields available on the index |
filters | [IndexFilter]!▾ | Optional | Filters configured on the index |
last_processed_at | DateTime!▾ | Optional | When the index was last processed |
is_active | Boolean! | Optional | Whether the index is active |
has_pending_updates | Boolean! | Optional | Whether the index has updates waiting to be processed |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
inventory#
Fetch a paginated list of inventory records across your warehouses. Filter by SKU, warehouse, or business to see stock levels, reservations, costs, and positions per product.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
ids | [String] | Optional | Filter by inventory record ID(s) |
sku | String | Optional | Filter by product SKU |
warehouse_id | String | Optional | Filter by warehouse ID |
business_id | String | Optional | Filter by business ID |
filters | InventoryFilterInput▾ | Optional | Combined inventory filters |
query | QueryFilter▾ | Optional | Opaque query filter to narrow results |
Returns: InventoryConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [Inventory]!▾ | Optional | The inventory records on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
inventoryAtLocation#
Fetch a summary of the stock present at a single location, optionally narrowed to a specific SKU or warehouse position. Useful for store or warehouse staff checking what is on hand at their site.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
filter | InventoryAtLocationFilter!▾ | Required | Location filter for the lookup |
Returns: InventoryAtLocationPayload!
| Name | Type | Required | Description |
|---|---|---|---|
items | [InventorySummary]!▾ | Optional | Stock summaries at the location |
Example#
inventoryItems#
Fetch a paginated list of individual inventory items filtered by SKU, serial number, or batch number. Each item represents a distinct stock record with its own state, position, and cost.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
filters | InventoryItemFilterInput!▾ | Required | Filters to select inventory items |
Returns: InventoryItemConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [InventoryItem]!▾ | Optional | The inventory items on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
inventoryList#
Fetch a single inventory count list (stock take) by ID, including the location it applies to, the items to be counted, and its progress timestamps.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | Unique ID of the inventory list to fetch |
Returns: InventoryList
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique inventory list ID |
state | String! | Optional | Current state of the count |
status | String! | Optional | Current status of the count (alias of state) |
number | String! | Optional | Human-readable list number |
location | Location▾ | Optional | Location where the count takes place |
business | Business▾ | Optional | Business the count belongs to |
description | String! | Optional | Description of the count |
inventorize_at | DateTime!▾ | Optional | When the count is planned |
items | InventoryListItemConnection!▾ | Optional | Paginated items to be counted |
started_at | DateTime!▾ | Optional | When the count was started |
finished_at | DateTime!▾ | Optional | When the count was finished |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
invoice#
Fetch an invoice by ID.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the invoice |
Returns: Invoice
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID |
number | String! | Required | Invoice number |
subtotal | Money! | Required | Subtotal (scalar — integer in cents) |
total_ex_vat | Money! | Required | Total excluding VAT (scalar — integer in cents) |
Example#
item#
Fetch a single collection item (physical inventory item) by ID.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the item |
Returns: CollectionItem
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID (CollectionItem ID, UUID) |
sku | String! | Required | SKU |
label | String! | Required | Display name |
product | Product!▾ | Required | The associated product |
Example#
See also: items
items#
Fetch a paginated list of collection items (inventory items) with filtering.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to returnDefault: 10 |
after | String | Optional | Cursor for forward pagination |
before | String | Optional | Cursor for backward pagination |
filters | CollectionItemFilterInput!▾ | Required | Filter criteria |
Returns: CollectionItem
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID (CollectionItem ID, UUID) |
sku | String! | Required | SKU |
label | String! | Required | Display name |
product | Product!▾ | Required | The associated product |
Example#
See also: item
list#
Fetch a single task list by ID, including its tasks, ranking, and role-based access settings. Lists group tasks (system-generated or user-created) into boards.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | Unique ID of the list to fetch |
Returns: List
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique list ID |
label | String! | Optional | List label |
description | String! | Optional | List description |
parent_list | List▾ | Optional | Parent list, when this list is nested |
rank | Int! | Optional | Sort rank of the list |
rbac | Rbac!▾ | Optional | Role-based access control settings |
tasks | [Task]!▾ | Optional | Tasks on this list |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
deleted_at | DateTime!▾ | Optional | Deletion date, when the list has been deleted |
Example#
location#
Fetch a single physical location (store, warehouse site, or pickup point) by ID, including its address, opening hours, cut-off times, and linked warehouse and integrations.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | Unique ID of the location to fetch |
Returns: Location
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique location ID |
name | String! | Optional | Location name |
address | Address▾ | Optional | Address of the location |
openings | [Opening]!▾ | Optional | Opening hours per day of the week |
cut_off_times | [CutOffTime]!▾ | Optional | Order cut-off times per day of the week |
imi_integration | Integration▾ | Optional | Integration used for in-store inventory management |
fulfilment_integration | Integration▾ | Optional | Integration used for fulfilment at this location |
warehouse | Warehouse▾ | Optional | Warehouse linked to this location |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
deleted_at | DateTime!▾ | Optional | Deletion date, when the location has been deleted |
Example#
locations#
Fetch a paginated list of physical locations (stores, warehouse sites, pickup points), with optional ID filtering and sorting.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
id | IdFilter▾ | Optional | Filter by location ID(s) |
sort | LocationsSortInput▾ | Optional | Sort order for the results |
Returns: LocationConnection!
| Name | Type | Required | Description |
|---|---|---|---|
locations | [Location]!▾ | Optional | The locations on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
order#
Fetch an order by ID.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the order |
options | OrderOptionsInput▾ | Optional | Options to control included pricing data |
Returns: Order
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID |
number | String! | Required | Order number |
total | Money! | Required | Total value |
currency | Currency! | Required | Currency code |
Example#
See also: orders
orders#
Fetch a paginated list of orders with filtering.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to returnDefault: 10 |
after | String | Optional | Cursor for forward pagination |
before | String | Optional | Cursor for backward pagination |
id | IdFilter▾ | Optional | Filter by order ID(s) |
progress | OrderProgressFilter▾ | Optional | Filter by progress |
created_at | InequalityFilter▾ | Optional | Filter by creation date |
number | NumberFilter▾ | Optional | Filter by order number |
email | String | Optional | Filter by customer email |
Returns: Order
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID |
number | String! | Required | Order number |
total | Money! | Required | Total value |
currency | Currency! | Required | Currency code |
Example#
See also: order
organisation#
Fetch an organisation by ID.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the organisation |
version | String | Optional | Optional version string |
Returns: Organisation
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID |
name | String | Optional | Organisation name |
type | OrganisationType!▾ | Required | Type of organisation |
number | String | Optional | Organisation number |
Example#
parcel#
Fetch a parcel (shipment) by ID.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the parcel |
Returns: Parcel
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID |
number | String! | Required | Parcel number |
status | ParcelStatus!▾ | Required | Current status |
track_trace | TrackTrace!▾ | Required | Track & trace details |
Example#
See also: parcels
parcels#
Fetch a paginated list of parcels with filtering.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to returnDefault: 10 |
after | String | Optional | Cursor for forward pagination |
id | IdFilter▾ | Optional | Filter by parcel ID(s) |
delivery_id | IdFilter▾ | Optional | Filter by delivery ID |
track_trace_number | String | Optional | Filter by track & trace number |
Returns: Parcel
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID |
number | String! | Required | Parcel number |
status | ParcelStatus!▾ | Required | Current status |
track_trace | TrackTrace!▾ | Required | Track & trace details |
Example#
See also: parcel
payment#
Fetch a single payment by ID, including the charged amounts, payment status, PSP details, any refunds and the order it belongs to.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The payment ID |
Returns: Payment
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique payment ID |
type | String! | Optional | Payment type |
token | String! | Optional | Payment token |
amount | Money!▾ | Optional | Payment amount |
amount_fee | Money!▾ | Optional | Fee charged on top of the payment amount |
amount_total | Money!▾ | Optional | Total amount including fees |
amount_paid | Money!▾ | Optional | Amount actually paid so far |
status | PaymentStatus!▾ | Optional | Payment status |
reference | PaymentReference!▾ | Optional | The entity this payment refers to |
description | String | Optional | Payment description |
return_url | String! | Optional | URL the customer returns to after paying |
is_refund | Boolean! | Optional | Whether this payment is a refund |
is_paid | Boolean! | Optional | Whether the payment is paid |
is_captured | Boolean! | Optional | Whether the payment is captured |
is_pre_authorized | Boolean! | Optional | Whether the payment is pre-authorized |
is_authorized | Boolean! | Optional | Whether the payment is authorized |
is_cancelled | Boolean! | Optional | Whether the payment is cancelled |
is_expired | Boolean! | Optional | Whether the payment is expired |
is_pending | Boolean! | Optional | Whether the payment is pending |
currency | Currency!▾ | Optional | ISO 4217 currency code |
method_id | String! | Optional | Payment method ID used |
issuer_id | String! | Optional | Issuer ID (e.g. the selected iDEAL bank) |
refunds | [Payment]▾ | Optional | Refund payments linked to this payment |
paid_at | DateTime!▾ | Optional | Date the payment was paid |
psp_payment | PspPayment▾ | Optional | Details of the payment at the payment service provider |
order | Order▾ | Optional | The order this payment belongs to |
express | Express▾ | Optional | Express checkout details (e.g. PayPal Express) |
meta_data | JsonObject▾ | Optional | Arbitrary metadata |
Example#
paymentMethod#
Fetch a payment method by ID.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the payment method |
Returns: PaymentMethod
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID |
code | String! | Required | Payment method code |
name | String! | Required | Display name |
is_enabled | Boolean! | Required | Whether enabled |
Example#
See also: paymentMethods
paymentMethods#
Fetch a paginated list of available payment methods.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to returnDefault: 10 |
after | String | Optional | Cursor for forward pagination |
before | String | Optional | Cursor for backward pagination |
codes | [String!] | Optional | Filter by payment method codes |
is_manual | Boolean | Optional | Filter by manual payment methods |
sort | PaymentMethodsOrderByInput▾ | Optional | Sort order |
Returns: PaymentMethod
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID |
code | String! | Required | Payment method code |
name | String! | Required | Display name |
is_enabled | Boolean! | Required | Whether enabled |
Example#
See also: paymentMethod
phoneNumber#
Fetch a phone number by ID.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the phone number |
Returns: PhoneNumber
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID |
country_code | String! | Required | Country calling code |
national | String! | Required | National number |
number | String! | Required | Full international number |
Example#
picklist#
Fetch a single picklist by ID, including the warehouse location it is picked at, per-order picking statistics, its items and their picking state.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The picklist ID |
Returns: Picklist
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique picklist ID |
number | String! | Optional | Picklist number |
state | PicklistState!▾ | Optional | Current picklist state |
status | PicklistState!▾ | Optional | Current picklist status (alias of state) |
business | Business!▾ | Optional | The business the picklist belongs to |
location | Location!▾ | Optional | Warehouse location the picklist is picked at |
settings | PicklistSettings!▾ | Optional | Picklist processing settings |
statistics | [PicklistStatistics]!▾ | Optional | Picking statistics per order on the picklist |
due_at | DateTime!▾ | Optional | Date the picklist is due |
items | [PicklistItem]!▾ | Optional | The items on the picklist |
tags | [Tag]!▾ | Optional | Tags attached to the picklist |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
picklistItem#
Fetch a single picklist item by ID, including its picking state, warehouse position, the order and order item it belongs to, and the picklist it is on.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The picklist item ID |
Returns: ListedPicklistItem
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique picklist item ID |
sku | String! | Optional | SKU of the product to pick |
position | String! | Optional | Warehouse position of the item |
state | PicklistItemState!▾ | Optional | Picking state of the item |
status | PicklistItemState!▾ | Optional | Picking status of the item (alias of state) |
order | Order!▾ | Optional | The order the item belongs to |
order_item | CollectionItem!▾ | Optional | The order item being picked |
is_collected | Boolean! | Optional | Whether the item has been collected |
is_picked | Boolean! | Optional | Whether the item has been picked |
meta_data | JsonObject!▾ | Optional | Arbitrary metadata |
picklist | Picklist▾ | Optional | The picklist this item is on |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
picklistItems#
Fetch a paginated list of items on a picklist, grouped by the fields you specify (e.g. by SKU) and optionally filtered by picking state, SKU, position or order.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
picklist_id | String! | Required | ID of the picklist to list items for |
filters | PicklistItemFilterInput▾ | Optional | Filter the items on the picklist |
groupBy | [String]! | Required | Field names to group items by (e.g. "sku") |
group | [String]! | Required | Group values to narrow the result to |
Returns: PicklistItemConnection!
| Name | Type | Required | Description |
|---|---|---|---|
items | [PicklistItemGroup]!▾ | Optional | The grouped picklist items on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
picklistPreset#
Fetch a single picklist preset by ID. A preset holds the configuration used to generate picklists, such as the processing mode, location, order and item limits, and restrictions on channels, delivery methods, assignees and SKUs.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The picklist preset ID |
Returns: PicklistPreset
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique preset ID |
description | String! | Optional | Preset description |
configuration | PicklistPresetConfiguration!▾ | Optional | Configuration used when generating picklists from this preset |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
picklistPresets#
Fetch a paginated list of picklist presets — reusable configurations for generating picklists.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
Returns: PicklistPresetConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [PicklistPreset]!▾ | Optional | The picklist presets on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
price#
Fetch a price from a price list by item ID.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the price entry |
Returns: Price
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | The ID |
sku | String! | Required | SKU this price applies to |
amount | Money! | Required | The price amount |
original_amount | Money! | Required | Original undiscounted amount |
Example#
priceList#
Fetch a single price list by ID, including its currency, VAT handling and the prices it contains per SKU.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The price list ID |
Returns: PriceList
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique price list ID |
name | String! | Optional | Price list name |
is_included_vat | Boolean! | Optional | Whether prices in this list include VAT |
currency | Currency!▾ | Optional | ISO 4217 currency code |
prices | [Price]!▾ | Optional | The prices in this list |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
deleted_at | DateTime!▾ | Optional | Deletion date |
Example#
priceRule#
Fetch a single price rule by ID. Price rules apply discounts or price adjustments to a target when their rule set matches, optionally granting incentive products.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The price rule ID |
Returns: PriceRule
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique price rule ID |
name | String! | Optional | Price rule name |
reference | String! | Optional | External reference for the rule |
i18n | [PriceRuleTranslation]!▾ | Optional | Localized rule names |
target | String! | Optional | What the rule targets (e.g. items or the order) |
rule_set | RuleSet▾ | Optional | Rule set that determines when this rule applies |
target_rule_set | RuleSet▾ | Optional | Rule set that selects the items the adjustment applies to |
incentives | [Incentive]!▾ | Optional | Incentive products granted when the rule applies |
adjustment | PriceRuleAdjustment!▾ | Optional | The price adjustment applied by this rule |
adjustments | [PriceRuleAdjustment]!▾ | Optional | All price adjustments applied by this rule |
grant_limit | Int! | Optional | Maximum number of times the rule may be granted |
priority | Int! | Optional | Priority relative to other rules |
is_last_rule | Boolean! | Optional | Whether no further rules are evaluated after this one |
is_strict | Boolean! | Optional | Whether the rule is applied strictly |
is_active | Boolean! | Optional | Whether the rule is currently active |
active_at | Int64! | Optional | Unix milliseconds timestamp the rule becomes active |
expires_at | Int64! | Optional | Unix milliseconds timestamp the rule expires |
created_at | Int64! | Optional | Unix milliseconds creation timestamp |
updated_at | Int64! | Optional | Unix milliseconds last update timestamp |
Example#
product#
Fetch a product by SKU.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
sku | String! | Required | The SKU of the product |
Returns: Product
| Name | Type | Required | Description |
|---|---|---|---|
sku | String! | Required | SKU |
label | String! | Required | Display name |
slug | String! | Required | URL slug |
brand | String! | Required | Brand name |
Example#
See also: products
products#
Fetch products by a list of SKUs.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
skus | [String!]! | Required | List of SKUs to fetch |
Returns: Product
| Name | Type | Required | Description |
|---|---|---|---|
sku | String! | Required | SKU |
label | String! | Required | Display name |
slug | String! | Required | URL slug |
brand | String! | Required | Brand name |
Example#
See also: product
productViewingHistory#
Fetch a product viewing history list by token.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
token | String! | Required | The token of the viewing history |
Returns: ProductViewingHistory
| Name | Type | Required | Description |
|---|---|---|---|
label | String! | Required | Label |
token | String! | Required | Token identifier |
items | [ViewingHistoryItem!]!▾ | Required | Viewed items |
expires_at | DateTime! | Required | Expiration date |
Example#
project#
Fetch a single project by ID. A project groups orders, contacts, shipping addresses and files for an organisation over a defined period (from starts_at to ends_at).
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The project ID |
Returns: Project
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique project ID |
version | String! | Optional | Project version |
audience | Audience!▾ | Optional | Audience the project belongs to |
name | String! | Optional | Project name |
number | String! | Optional | Project number |
description | String! | Optional | Project description |
organisation | Organisation▾ | Optional | Organisation the project belongs to |
shipping | [Address]!▾ | Optional | Shipping addresses linked to the project |
meta_data | JsonObject▾ | Optional | Arbitrary metadata |
starts_at | DateTime!▾ | Optional | Date the project starts |
ends_at | DateTime!▾ | Optional | Date the project ends |
orders | ProjectOrderConnection!▾ | Optional | Paginated orders in the project |
contacts | [Contact]!▾ | Optional | Contacts linked to the project |
files | [File]!▾ | Optional | Files attached to the project |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
deleted_at | DateTime!▾ | Optional | Deletion date |
Example#
proxy#
Fetch a single search proxy by ID. A proxy fronts one or more search indexes and holds the search configuration for a channel, such as filter behaviour, autocomplete and click tracking.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | ID of the proxy to fetch |
Returns: Proxy
| Name | Type | Required | Description |
|---|---|---|---|
key | String! | Optional | Public key used to address the proxy |
filters | ProxyFilters!▾ | Optional | Filter behaviour configuration |
is_autocomplete | Boolean! | Optional | Whether autocomplete is enabled for this proxy |
click_tracking | ProxyClickTracking!▾ | Optional | Click tracking configuration |
indexes | [ProxyIndex]!▾ | Optional | Search indexes served by this proxy |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
reorderNotification#
Fetch a single reorder notification configuration by ID. A reorder notification emails a list of recipients on a schedule whenever products in a warehouse drop below their reorder point.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | ID of the reorder notification to fetch |
Returns: ReorderNotification
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique reorder notification ID |
warehouse | Warehouse!▾ | Optional | Warehouse the notification watches |
businesses | [Business]!▾ | Optional | Businesses the notification applies to |
schedules | [ReorderNotificationSchedule]!▾ | Optional | Weekly schedule on which notification emails are sent |
recipients | [ReorderNotificationRecipient]!▾ | Optional | People who receive the notification emails |
is_enabled | Boolean! | Optional | Whether the notification is enabled |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
reorderNotificationItem#
Fetch a single reorder notification item by ID. An item represents one product in a warehouse that has hit its reorder point, along with whether it has already been included in a notification email.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | ID of the reorder notification item to fetch |
Returns: ReorderNotificationItem
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique reorder notification item ID |
product | Product!▾ | Optional | Product that needs reordering |
warehouse | Warehouse!▾ | Optional | Warehouse where the stock is low |
business | Business!▾ | Optional | Business the item belongs to |
preference | StockPreference▾ | Optional | Stock preference that triggered the notification |
is_notified | Boolean! | Optional | Whether a notification has been sent for this item |
notified_at | DateTime!▾ | Optional | When the notification was sent |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
reorderNotificationItems#
Fetch a paginated list of reorder notification items for a warehouse and business — products that have hit their reorder point, optionally filtered by SKU or notification status.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
filters | ReorderNotificationItemsFilterInput!▾ | Required | Filters to narrow the items |
Returns: ReorderNotificationItemsConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [ReorderNotificationItem]!▾ | Optional | The reorder notification items on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
reorderNotifications#
Fetch a paginated list of reorder notification configurations for a warehouse and business, optionally filtered by recipient email or enabled state.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
filters | ReorderNotificationFilterInput!▾ | Required | Filters to narrow the notifications |
Returns: ReorderNotificationsConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [ReorderNotification]!▾ | Optional | The reorder notifications on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
replenishment#
Fetch a single replenishment by ID. A replenishment moves stock towards a target — restocking from a supplier, relocating between warehouses, or exporting — and carries the items with their suggested and ordered quantities.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | ID of the replenishment to fetch |
Returns: Replenishment
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique replenishment ID |
number | String! | Optional | Human-readable replenishment number |
type | ReplenishmentType!▾ | Optional | What the replenishment does |
state | ReplenishmentState!▾ | Optional | Replenishment state |
status | ReplenishmentState!▾ | Optional | Replenishment status |
supplier | Business▾ | Optional | Supplier the stock is ordered from |
filters | [ReplenishmentFilter]!▾ | Optional | Filters that selected the items in this replenishment |
source | ReplenishmentSource▾ | Optional | Where the stock comes from |
target | ReplenishmentTarget▾ | Optional | Where the stock goes |
items | ReplenishmentItemConnection!▾ | Optional | Paginated items in this replenishment |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
replenishmentItem#
Fetch a single replenishment item by ID — one product line within a replenishment, with its suggested, ordered, announced and open quantities plus the source and target warehouse or business.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | ID of the replenishment item to fetch |
Returns: ReplenishmentItem
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique replenishment item ID |
product | Product!▾ | Optional | Product being replenished |
state | ReplenishmentState!▾ | Optional | Item state |
status | ReplenishmentState!▾ | Optional | Item status |
quantity_units_ordered | Int! | Optional | Units ordered |
quantity_suggested | Int! | Optional | Suggested quantity to order |
quantity_available | Int! | Optional | Quantity currently available |
quantity_needed | Int! | Optional | Quantity needed |
quantity_announced | Int! | Optional | Quantity announced for delivery |
quantity_open | Int! | Optional | Quantity still open |
quantity_reorder | Int! | Optional | Reorder point quantity |
quantity_maximum | Int! | Optional | Maximum stock quantity |
unit | String! | Optional | Ordering unit |
unit_quantity | Int! | Optional | Number of pieces per unit |
target_warehouse | Warehouse▾ | Optional | Warehouse the stock moves to |
target_business | Business▾ | Optional | Business the stock moves to |
source_warehouse | Warehouse▾ | Optional | Warehouse the stock comes from |
source_business | Business▾ | Optional | Business the stock comes from |
replenishment | Replenishment!▾ | Optional | Replenishment this item belongs to |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
reservation#
Fetch a single stock reservation by ID. A reservation holds quantities of products in a warehouse for a contact via a channel — for example a click-and-collect order — until it expires, and exposes the underlying stock claims.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | ID of the reservation to fetch |
Returns: Reservation
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique reservation ID |
number | String! | Optional | Human-readable reservation number |
referencing_number | String! | Optional | External reference number (e.g. an order number) |
notes | String! | Optional | Free-form notes on the reservation |
channel | Channel!▾ | Optional | Channel the reservation was made through |
contact | Contact▾ | Optional | Contact the stock is reserved for |
warehouse | Warehouse!▾ | Optional | Warehouse holding the reserved stock |
business | Business!▾ | Optional | Business the reservation belongs to |
items | [ReservationItem]!▾ | Optional | Reserved products and quantities |
claims | [Claim]!▾ | Optional | Stock claims backing this reservation |
expires_at | DateTime!▾ | Optional | When the reservation expires |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
returnMethod#
Fetch a return method by ID.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the return method |
Returns: ReturnMethod
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID |
name | String! | Required | Display name |
is_enabled | Boolean! | Required | Whether enabled |
carrier | String | Optional | Carrier name |
Example#
See also: returnMethods
returnMethods#
Fetch a paginated list of return methods.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to returnDefault: 10 |
after | String | Optional | Cursor for forward pagination |
query | QueryFilter | Optional | Search filter string |
Returns: ReturnMethod
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID |
name | String! | Required | Display name |
is_enabled | Boolean! | Required | Whether enabled |
carrier | String | Optional | Carrier name |
Example#
See also: returnMethod
rma#
Fetch a single RMA (return merchandise authorisation) by ID, including the returned items with their reasons and authorisation status, the chosen return method and the available shipping options.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | ID of the RMA to fetch |
Returns: Rma
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique RMA ID |
number | String! | Optional | Human-readable RMA number |
status | RmaStatus!▾ | Optional | RMA status |
contact | Contact▾ | Optional | Contact returning the items |
organisation | Organisation▾ | Optional | Organisation the return belongs to |
address | Address▾ | Optional | Pickup or return address |
due_at | Int64! | Optional | Deadline for the return (Unix ms timestamp) |
items | [RmaItem]!▾ | Optional | Items being returned |
options | RmaOptions!▾ | Optional | Options available for handling the return |
return_method | ReturnMethod▾ | Optional | Chosen return method |
provider_option | ProviderOption▾ | Optional | Chosen carrier product for the return shipment |
channel | Channel▾ | Optional | Channel the return was requested through |
created_at | Int64! | Optional | Creation timestamp (Unix ms) |
updated_at | Int64! | Optional | Last update timestamp (Unix ms) |
Example#
rmas#
Fetch a paginated list of RMAs (return merchandise authorisations). Each RMA groups the items a customer wants to return, together with the contact, return method and due date, and can be filtered by status.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
filters | RmaFiltersInput!▾ | Required | Filters to narrow the RMA list |
Returns: RmaConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [Rma]!▾ | Optional | The RMAs on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
ruleSet#
Fetch a single rule set by ID, optionally pinned to a specific version. Rule sets hold prioritised rules with when/then clauses that drive conditional behaviour on the platform, such as enabling payment agreements or shipping methods.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | ID of the rule set to fetch |
version | String | Optional | Specific rule set version to fetch (defaults to the latest) |
Returns: RuleSet
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique rule set ID |
type | String! | Optional | Rule set type |
version | String! | Optional | Rule set version |
category | String! | Optional | Rule set category |
entity | EntityReference!▾ | Optional | Entity the rule set applies to |
result | RuleSetResult!▾ | Optional | Result produced when the rule set is evaluated |
rules | [Rule]!▾ | Optional | Rules in this set, evaluated by priority |
meta_data | JsonObject▾ | Optional | Free-form metadata attached to the rule set |
Example#
searchPicklistItem#
Find a single picklist item position matching a SKU, picklist, location and/or collection state. Used in warehouse picking flows to look up where an order item should be picked from and where it is headed.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
picklist_id | String | Optional | Limit the search to a specific picklist |
sku | String | Optional | SKU of the item to find |
is_collected | Boolean! | Required | Match items that have (or have not) been collected |
state | PicklistItemState▾ | Optional | Filter by picklist item state |
status | PicklistItemState▾ | Optional | Filter by picklist item status |
location_id | String | Optional | Limit the search to a specific location |
Returns: PicklistItemPosition
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique picklist item position ID |
sku | String! | Optional | SKU of the item at this position |
order | Order!▾ | Optional | Order the item belongs to |
order_item | CollectionItem!▾ | Optional | The order item to pick |
source | String! | Optional | Position to pick the item from |
target | String! | Optional | Position to bring the item to |
list | Picklist▾ | Optional | Picklist the item is on |
is_collected | Boolean! | Optional | Whether the item has been collected |
is_picked | Boolean! | Optional | Whether the item has been picked |
Example#
searchPicklistItems#
Search across picklist item positions with a paginated result. Returns the pick position, target position and underlying order item for each match, so warehouse staff can work through open picks.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
query | QueryFilter▾ | Optional | Opaque query filter to narrow results |
Returns: PicklistItemsConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [PicklistItemPosition]!▾ | Optional | The picklist item positions on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
searchRmaItems#
Search order items that are eligible for return, with pagination. Filter by channel, SKU, order, contact or organisation, or by items whose warranty or withdrawal window is still open after a given date.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
filters | RmaItemFiltersInput!▾ | Required | Filters to narrow the search |
Returns: SearchRmaItemConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [SearchRmaItem]!▾ | Optional | The returnable order items on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
service#
Fetch a single service by ID. Services are extra operations offered on order items — such as gift wrapping, customisation, assembly, preparation or packaging — including their localized texts and configuration schema.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Required | ID of the service to fetch |
Returns: Service
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique service ID |
name | String! | Optional | Service name |
description | String! | Optional | Service description |
instruction | String! | Optional | Instruction shown when executing the service |
i18n | [Internationalization]!▾ | Optional | Localized name, description and instruction |
type | ServiceType!▾ | Optional | Kind of service |
priority | Int | Optional | Execution priority of the service |
version | String! | Optional | Service version |
schema | JsonObject!▾ | Optional | JSON schema describing the service configuration |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
services#
Fetch a paginated list of services offered on order items, such as gift wrapping, customisation, assembly, preparation and packaging.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
query | QueryFilter▾ | Optional | Opaque query filter to narrow results |
Returns: ServicesConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [Service]!▾ | Optional | The services on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
serviceTasks#
Fetch a paginated list of service tasks. A service task is a unit of work — such as gift wrapping or assembling a specific order item — with its configuration, the user executing it and start/end timestamps.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
query | QueryFilter▾ | Optional | Opaque query filter to narrow results |
Returns: ServiceTasksConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [ServiceItemTask]!▾ | Optional | The service tasks on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
shelf#
Fetch a single shelf by ID. A shelf links a SKU to a warehouse position for a business, with a stock limit and an optional temporary flag — the building block for locating inventory in a warehouse.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | ID of the shelf to fetch |
Returns: Shelf
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique shelf ID |
sku | String! | Optional | SKU stored on this shelf |
position | Position!▾ | Optional | Warehouse position of the shelf |
position_limit | Int64! | Optional | Maximum number of items the shelf can hold |
is_temporary | Boolean! | Optional | Whether the shelf is a temporary placement |
business | Business!▾ | Optional | Business that owns the stock on this shelf |
warehouse | Warehouse!▾ | Optional | Warehouse the shelf is in |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
shelves#
Fetch a paginated list of shelves — the physical positions where a SKU is stored inside a warehouse. Filter by SKU, warehouse, or business to inspect where stock is located.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
sku | String | Optional | Filter shelves by product SKU |
warehouse_id | String | Optional | Filter shelves by warehouse ID |
business_id | String | Optional | Filter shelves by business ID |
Returns: ShelfConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [Shelf]!▾ | Optional | The shelves on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
shippingMethod#
Fetch a shipping method by ID.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID of the shipping method |
Returns: ShippingMethod
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID |
name | String! | Required | Display name |
is_enabled | Boolean! | Required | Whether enabled |
carrier | String | Optional | Carrier name |
Example#
See also: shippingMethods
shippingMethods#
Fetch a paginated list of shipping methods.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to returnDefault: 10 |
after | String | Optional | Cursor for forward pagination |
before | String | Optional | Cursor for backward pagination |
sort | ShippingMethodsOrderByInput▾ | Optional | Sort order |
Returns: ShippingMethod
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | The ID |
name | String! | Required | Display name |
is_enabled | Boolean! | Required | Whether enabled |
carrier | String | Optional | Carrier name |
Example#
See also: shippingMethod
shippingProviderOptions#
Fetch the shipping options offered by connected carrier integrations, such as parcel services with their cost, dimension, and weight constraints. Narrow the list by IDs or by filters like carrier, country, or shipping method.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
ids | [String] | Optional | Restrict to specific provider option IDs |
filters | ShippingProviderOptionsFiltersInput▾ | Optional | Filter the available provider options |
Returns: [ProviderOption]!
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique provider option ID |
name | String! | Optional | Name of the shipping option |
carrier | String! | Optional | Carrier that offers this option |
description | String! | Optional | Description of the option |
cost | ProviderOptionCost▾ | Optional | Cost of the shipping option |
dimension | ProviderOptionDimension▾ | Optional | Maximum parcel dimensions |
weight | ProviderOptionWeight▾ | Optional | Weight range for this option |
integration | Integration▾ | Optional | Carrier integration that provides this option |
Example#
stockMutations#
Fetch a paginated list of stock mutations — every change to inventory levels, such as allocations, restocks, corrections, and register sales — including their processing status and channel sync messages.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
query | QueryFilter▾ | Optional | Opaque query filter to narrow results |
Returns: StockMutationsConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [StockMutation]!▾ | Optional | The stock mutations on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
stockPreference#
Fetch a single stock preference by ID. A stock preference defines the inventory rules for a SKU in a warehouse, such as minimum, maximum, and optimal quantities, the reorder point, and whether backorders are allowed.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | ID of the stock preference to fetch |
Returns: StockPreference
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique stock preference ID |
sku | String! | Optional | SKU the preference applies to |
minimum_quantity | Int64! | Optional | Minimum stock quantity to keep |
maximum_quantity | Int64! | Optional | Maximum stock quantity to keep |
optimal_quantity | Int64! | Optional | Optimal stock quantity |
reorder_point | Int64! | Optional | Quantity at which a reorder is triggered |
is_restricted_to_single_position | Boolean! | Optional | Whether the SKU may only occupy a single warehouse position |
preorder_deadline_at | DateTime▾ | Optional | Deadline until which preorders are accepted |
is_backorder_allowed | Boolean! | Optional | Whether backorders are allowed for this SKU |
is_notified | Boolean! | Optional | Whether a low-stock notification has been sent |
notified_at | DateTime▾ | Optional | Date the notification was sent |
business | Business!▾ | Optional | Business the preference belongs to |
warehouse | Warehouse!▾ | Optional | Warehouse the preference applies to |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
stockPreferences#
Fetch a paginated list of stock preferences — the inventory rules per SKU and warehouse, such as minimum, maximum, and optimal quantities and the reorder point. Filter by SKU, warehouse, or business.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
sku | String | Optional | Filter preferences by product SKU |
warehouse_id | String | Optional | Filter preferences by warehouse ID |
business_id | String | Optional | Filter preferences by business ID |
Returns: StockPreferenceConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [StockPreference]!▾ | Optional | The stock preferences on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
supplies#
Fetch a paginated list of supplies — inbound goods-receiving sessions in which announced or purchased items are registered, cross-docked, and distributed to warehouse positions. Filter by state to find pending or in-progress receipts.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
before | String | Optional | Cursor for backward pagination |
state | SupplyStateFilter▾ | Optional | Filter by supply state |
status | SupplyStateFilter▾ | Optional | Filter by supply status (alias of state) |
Returns: SupplyConnection!
| Name | Type | Required | Description |
|---|---|---|---|
supplies | [Supply]!▾ | Optional | The supplies on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
supply#
Fetch a single supply by ID — an inbound goods-receiving session including its announcements, purchase orders, cross-dock distributions, and overages.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | ID of the supply to fetch |
Returns: Supply
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique supply ID |
number | String! | Optional | Supply number |
state | SupplyState!▾ | Optional | Current state of the supply |
status | SupplyState!▾ | Optional | Current status (alias of state) |
announcements | [Announcement]!▾ | Optional | Supplier announcements linked to this supply |
due_at | DateTime!▾ | Optional | Date the supply is due |
settings | SupplySettings!▾ | Optional | Processing settings for the supply |
started_at | DateTime!▾ | Optional | Date receiving started |
cancelled_at | DateTime!▾ | Optional | Date the supply was cancelled |
finished_at | DateTime!▾ | Optional | Date receiving finished |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
crossdock_proposal | CrossDockProposal▾ | Optional | Proposed cross-dock match for a scanned item |
crossdock_distribution | [CrossDockDistribution]!▾ | Optional | Cross-dock distributions applied during this supply |
purchases | [SupplyPurchase]!▾ | Optional | Purchase orders received in this supply |
overages | [SupplyOverage]!▾ | Optional | Items received in excess of what was expected |
business | Business▾ | Optional | Business receiving the supply |
location | Location▾ | Optional | Location where the supply is received |
Example#
table#
Fetch a single data table by ID or category. Tables define how listing data (such as orders or products) is sourced, processed, and displayed, including their columns and saved views.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | ID (or category value) of the table to fetch |
category | QueryTableBy▾ | Optional | How to interpret the id argument |
Returns: Table
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique table ID |
name | String! | Optional | Table name |
category | String! | Optional | Table category |
is_system_table | Boolean! | Optional | Whether this is a built-in system table |
sourcing | Sourcing!▾ | Optional | How the table sources its data |
processing | Processing!▾ | Optional | Processing rules applied to sourced data |
columns | [Columns]!▾ | Optional | Column definitions of the table |
views | [View]!▾ | Optional | Saved views on this table |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
task#
Fetch a single task by ID, including its status, list, comments, and attachments. Tasks are to-dos on the tenant's work lists, created by users or generated by the system.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | ID of the task to fetch |
Returns: Task
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique task ID |
title | String! | Optional | Task title |
description | String! | Optional | Task description |
due_at | Int | Optional | Due timestamp |
status | TaskStatus!▾ | Optional | Current status of the task |
type | TaskType!▾ | Optional | Origin of the task |
list | List!▾ | Optional | The list the task belongs to |
rank | Int! | Optional | Sort rank within the list |
assignee | String | Optional | User the task is assigned to |
system | System▾ | Optional | System metadata for system-generated tasks |
comments | [Comment]!▾ | Optional | Comments on the task |
attachments | [Attachment]!▾ | Optional | Files attached to the task |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
transport#
Fetch a single transport by ID. A transport is a planned, route-based delivery run that bundles one or more orders with a pickup and delivery moment.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | Unique transport ID |
Returns: Transport
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique transport ID |
number | String! | Optional | Human-readable transport number |
state | TransportState!▾ | Optional | Current transport state |
route_label | String! | Optional | Label of the route this transport belongs to |
delivery_at | DateTime!▾ | Optional | Planned delivery moment |
pickup_at | DateTime!▾ | Optional | Planned pickup moment |
orders | [Order]!▾ | Optional | Orders included in this transport |
items | [SummarizedItem]!▾ | Optional | Summarized items carried in this transport |
integration | Integration▾ | Optional | Integration that manages this transport |
Example#
transports#
Fetch a paginated list of transports — planned, route-based delivery runs that bundle orders with pickup and delivery moments. Results can be narrowed with a query filter.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
query | QueryFilter▾ | Optional | Opaque query filter to narrow results |
Returns: TransportConnection!
| Name | Type | Required | Description |
|---|---|---|---|
transports | [Transport]!▾ | Optional | The transports on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
user#
Fetch a single user by ID. Users are the staff accounts of a tenant (back office and POS), including their roles and verification state.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | Unique user ID |
Returns: User
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique user ID |
email | String! | Optional | Email address of the user |
name | String! | Optional | Full name of the user |
is_verified | Boolean! | Optional | Whether the user has verified their account |
is_pending_invite | Boolean! | Optional | Whether the user still has a pending invite |
is_primary | Boolean! | Optional | Whether this is the primary user of the tenant |
is_pin_only | Boolean! | Optional | Whether the user can only sign in with a PIN (e.g. POS-only accounts) |
tenant | Tenant!▾ | Optional | Tenant the user belongs to |
roles | [Role]!▾ | Optional | Roles assigned to the user |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
vatException#
Fetch a single VAT exception by ID. A VAT exception overrides the VAT rate for a specific SKU in a specific country (optionally narrowed to an administrative area).
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | Unique VAT exception ID |
Returns: VatException
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique VAT exception ID |
sku | String! | Optional | SKU the exception applies to |
country_code | String! | Optional | ISO country code where the exception applies |
administrative_area | String | Optional | Administrative area (state/province) the exception is limited to |
reference | Int! | Optional | Reference number of the exception |
vat_rate | Float! | Optional | VAT rate applied instead of the default (e.g. 9.0) |
Example#
view#
Fetch a saved table view by ID. A view stores the column layout, sorting, page size and filters for a data table, plus the roles that may use it.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | Unique view ID |
Returns: View
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique view ID |
label | String! | Optional | Display label of the view |
columns | String! | Optional | Column configuration of the view |
pagesize | Int! | Optional | Number of rows shown per page |
sort | String! | Optional | Sort configuration of the view |
category | String! | Optional | Category the view belongs to |
is_default | Boolean! | Optional | Whether this is the default view for its table |
table | Table!▾ | Optional | Table this view is defined on |
rbac | Rbac!▾ | Optional | Role-based access control for the view |
filters | [Filters]!▾ | Optional | Filters applied by the view |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
Example#
warehouse#
Fetch a single warehouse by ID, including its location, linked businesses and storage positions.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | Unique warehouse ID |
Returns: Warehouse
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique warehouse ID |
label | String! | Optional | Warehouse label |
location | Location!▾ | Optional | Physical location of the warehouse |
type | WarehouseType!▾ | Optional | Warehouse type |
businesses | [Business]!▾ | Optional | Businesses linked to this warehouse |
is_restricted_to_single_position | Boolean! | Optional | Whether each SKU is restricted to a single position |
position_limit | Int64! | Optional | Maximum number of positions allowed |
position_count | Int64! | Optional | Current number of positions |
positions | [Position]!▾ | Optional | Storage positions in the warehouse |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
deleted_at | DateTime!▾ | Optional | Deletion date |
Example#
warehouseItem#
Fetch a single warehouse item by ID — one unit of physical stock, with its position, batch and serial numbers, weight and cost value.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | Unique warehouse item ID |
Returns: WarehouseItem
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique warehouse item ID |
sku | String! | Optional | Stock keeping unit |
quantity | Int! | Optional | Quantity of this item |
state | String! | Optional | Current state of the item |
status | String! | Optional | Current status of the item |
reason | String | Optional | Reason attached to the item (e.g. for a correction) |
position | Position▾ | Optional | Storage position the item is stored at |
rfid | String! | Optional | RFID tag of the item |
batch_number | String! | Optional | Batch number |
serial_number | String! | Optional | Serial number |
expires_at | DateTime!▾ | Optional | Expiry date of the item |
warehouse | Warehouse!▾ | Optional | Warehouse the item belongs to |
business | Business!▾ | Optional | Business that owns the stock |
created_at | DateTime!▾ | Optional | Creation date |
updated_at | DateTime!▾ | Optional | Last update date |
weight | Weight!▾ | Optional | Weight of the item |
cost | MonetaryValue!▾ | Optional | Cost value of the item |
gtin | [String]! | Optional | Global trade item numbers |
Example#
warehouses#
Fetch a paginated list of warehouses, including each warehouse's location, type and position counts.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
first | Int | Optional | Number of items to return |
after | String | Optional | Cursor for forward pagination |
Returns: WarehouseConnection!
| Name | Type | Required | Description |
|---|---|---|---|
nodes | [ListedWarehouse]!▾ | Optional | The warehouses on this page |
pageInfo | PageInfo!▾ | Optional | Pagination info |
Example#
wishlist#
Fetch a wishlist by token.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
token | String! | Required | The token of the wishlist |
Returns: Wishlist
| Name | Type | Required | Description |
|---|---|---|---|
label | String! | Required | Label |
token | String! | Required | Token identifier |
items | [WishlistItem!]!▾ | Required | Items on the wishlist |
expires_at | DateTime! | Required | Expiration date |
Example#
zone#
Fetch a single zone by ID. A zone groups a set of countries (e.g. for shipping or delivery coverage), optionally gated by a rule set.
Arguments:
| Name | Type | Required | Description |
|---|---|---|---|
id | String! | Required | Unique zone ID |
Returns: Zone
| Name | Type | Required | Description |
|---|---|---|---|
id | ID! | Optional | Unique zone ID |
name | String! | Optional | Zone name |
rule_set | RuleSet▾ | Optional | Rule set that determines when this zone applies |
countries | [String]! | Optional | ISO country codes covered by this zone |