Schema breakdown for Noms admin graphql endpoint
Required Headers
| Name | Value | Example |
|---|---|---|
| x-nacelle-space-id | The spaceID for the request | "x-nacelle-space-id": "a space id" |
| Authorization | An authorization token granting access to the space id | "Authorization": "Bearer ey...." |
Schema Types
Table of Contents
- Query
- Objects
- Address
- CalcResult
- CalcResultEntry
- CalcResultEntryBreakdown
- CalcResultItemsData
- CalcResultShippingData
- Customer
- CustomerConnection
- CustomerEdge
- Fulfillment
- FulfillmentConnection
- FulfillmentEdge
- FulfillmentOrderItem
- Money
- Order
- OrderConnection
- OrderEdge
- OrderItem
- OrderItemConnection
- OrderItemEdge
- PageInfo
- Payment
- Inputs
- Enums
- Scalars
Query
The query root.
| Field | Argument | Type | Description |
|---|---|---|---|
| order | Order | This query will return a single order given its id. | |
| id | UUID! | The id of the order to retrieve | |
| customer | Customer | This query will return a customer event given its id. | |
| id | UUID! | The id of the customer to retrieve | |
| customerOrders | OrderConnection! | This query will return an OrderConnection containing the requested data along with pagination information for users to continue paging through this customers orders. | |
| customerID | UUID! | The id of the customer to retrieve orders for | |
| filter | OrderFilter | (Optional) Supported filter parameters | |
| orders | OrderConnection! | This query will return an OrderConnection containing the requested data along with pagination information for users to continue paging through all filtered orders. | |
| filter | OrderFilter | (Optional) Supported filter parameters | |
| customers | CustomerConnection! | This query will return an CustomerConnection containing the requested data along with pagination information for users to continue paging through all filtered customers. | |
| filter | CustomerFilter | (Optional) Supported filter parameters | |
Objects
Address
An Address is a object representing a physical address that can be used for shipping or billing
| Field | Argument | Type | Description |
|---|---|---|---|
| id | UUID! | The unique address id | |
| countryISO2 | String! | The two-letter code for the country of the address. | |
| province | String | The region of the address, such as the province, state, or district. | |
| city | String! | The name of the city, district, village, or town | |
| postalCode | String! | The postal code for the address | |
| state | String! | The state for the address | |
| address1 | String! | The first line of the address. Typically the street address or PO Box number. | |
| address2 | String | The second line of the address. Typically the number of the apartment, suite, or unit. | |
| comment | String | A comment about the address | |
| zip ⚠️ | String! | ⚠️ DEPRECATED
| |
| country ⚠️ | String! | ⚠️ DEPRECATED
| |
CalcResult
Represents a tax result calculated by a tax service containing the tax data for the cart
| Field | Argument | Type | Description |
|---|---|---|---|
| createdAt | Int | When the tax result was created | |
| service | Service | Service that was used for generating tax data | |
| currency | String | Currency in ISO 4217 three-letter format. | |
| items | CalcResultItemsData | Tax data for order items. | |
| shipping | CalcResultShippingData | Tax data for order shipping. | |
| expiresAt | Int | Time at which the tax data will expire. Measured in seconds since the Unix epoch. | |
| externalID | String | External ID used in tax service API (e.g. stripe). | |
| taxDate | Int | Tax datetime that was used for calculating the tax data. Measured in seconds since the Unix epoch. | |
CalcResultEntry
Represents a tax result entry
| Field | Argument | Type | Description |
|---|---|---|---|
| orderItemID | String | Item ID. Filled only for items data. | |
| amount | String | Amount used for calculating taxes in string-decimal format. | |
| taxAmount | String | Amount of taxes for this object in string-decimal format. | |
| quantity | Uint | Quantity of items. Filled only for items data. | |
| taxBehavior | String | Specifies whether the | |
| taxCode | String | Tax code used for calculating taxes for this object. | |
| breakdown | [CalcResultEntryBreakdown] | Tax details breakdown (if tax service API provides this data). | |
CalcResultEntryBreakdown
Represents a breakdown of a tax result entry
| Field | Argument | Type | Description |
|---|---|---|---|
| amount | String | Amount of tax in string-decimal format. | |
| taxabilityReason | String | The reasoning behind this tax. | |
| displayName | String | A localized display name for tax type, intended to be human-readable. | |
| percentage | String | The tax rate percentage in string-decimal format. | |
| taxType | String | The tax type, such as 'vat' or 'sales_tax'. | |
CalcResultItemsData
Represents a tax result of all item data
| Field | Argument | Type | Description |
|---|---|---|---|
| totalAmount | String | Total amount of items without taxes in string-decimal format. | |
| totalTaxAmount | String | Total amount of items taxes in string-decimal format. | |
| totalWithTaxAmount | String | Total amount of items with taxes in string-decimal format. | |
| entries | [CalcResultEntry] | Tax details for these items. | |
CalcResultShippingData
Represents a tax result of shipping data
| Field | Argument | Type | Description |
|---|---|---|---|
| totalAmount | String | Total amount of shipping without taxes in string-decimal format. | |
| totalTaxAmount | String | Total amount of shipping taxes in string-decimal format. | |
| totalWithTaxAmount | String | Total amount of shipping with taxes in string-decimal format. | |
| entries | CalcResultEntry | Tax details for the shipping. | |
Customer
Represents a customer in the system
| Field | Argument | Type | Description |
|---|---|---|---|
| id | UUID! | The unique customer id | |
| firstName | String | The customers first name | |
| lastName | String | The customers last name | |
| String | The customers email | ||
| phone | String | The customers phone number | |
| meta | Map | A map of meta data for the customer | |
| addresses | [Address] | The customers addresses | |
| createdAt | Time | When the customer was created | |
| modifiedAt | Time | When the customer was last modified | |
| sourceExternalID | String | The external id of the source, used for syncing with external systems | |
| destinationExternalID | String | The destination id of the customer, used for syncing with external systems | |
CustomerConnection
An object containing an array of Customer data and pagination information
| Field | Argument | Type | Description |
|---|---|---|---|
| pageInfo | PageInfo! | Information to aid in pagination. | |
| edges | [CustomerEdge]! | A list of edges. | |
CustomerEdge
An object containing a node with Customer data and a cursor
Fulfillment
Represents a fulfillment in the system
| Field | Argument | Type | Description |
|---|---|---|---|
| id | UUID! | The unique fulfillment id | |
| externalId | String! | The external id for the fulfillment | |
| assignedLocationId | String | External location ID that has been assigned for fulfillment work | |
| destinationAddress | Address | The destination where the items should be sent | |
| deliveryType | String! | The type of delivery | |
| deliveryMethod | String! | The type of delivery method | |
| nacelle_status | FulfillmentStatus! | The nacelle status of the fulfillment | |
| status | String | The merchant status of the fulfillment | |
| shipmentStatus | String | The current shipment status of the fulfillment | |
| deliveryDate | Int | Timestamp at which the Fulfillment has been delivered (unix timestamp in seconds) | |
| deliveryEstimation | String | Comment describing when delivery expected, received from the shipping company. | |
| trackingCompany | String | The name of the tracking company | |
| trackingNumbers | [String!] | A list of tracking numbers provided by the shipping company | |
| trackingUrls | [String!] | A list of tracking URLs | |
| fulfillmentOrderItems | [FulfillmentOrderItem!] | A list of order item fulfillment data | |
FulfillmentConnection
An object containing an array of Fulfillment data and pagination information
| Field | Argument | Type | Description |
|---|---|---|---|
| pageInfo | PageInfo! | Information to aid in pagination. | |
| edges | [FulfillmentEdge]! | An array of FulfillmentsEdge's. | |
FulfillmentEdge
An object containing a node with Fulfillment data and a cursor
| Field | Argument | Type | Description |
|---|---|---|---|
| cursor | Cursor! | A cursor for use in pagination. | |
| node | Fulfillment! | The fulfillment data | |
FulfillmentOrderItem
Represents a fulfillment order item data attached to the Fulfillment object.
Money
Represents a single price
Order
Represents a single order in the system
| Field | Argument | Type | Description |
|---|---|---|---|
| id | UUID! | The unique order id | |
| status | String! | The status of the order | |
| nacelleEntryId | String | The nacelle entry id of the order | |
| String | The email address associated with the customer. | ||
| phone | String | The phone number associated with the customer. | |
| sourceExternalId | String | The external id of the orders source | |
| destinationExternalId | String | The destination id of the order, used for syncing with external systems | |
| comment | String | A comment about the order | |
| createdAt | Time! | When the order was created | |
| modifiedAt | Time! | When the order was last modified | |
| canceledAt | NullTime | When the order was canceled | |
| canceledReason | String | The reason the order was canceled | |
| currency | String | The currency of the order for example USD, CAD, etc. | |
| shippingMethod | String | The shipping method for the order | |
| meta | Map | [source] The meta data for the order | |
| customer | Customer | [source] The customer for the order | |
| shippingAddress | Address | [source] The shipping address for the order | |
| billingAddress | Address | [source] The billing address for the order | |
| payment | Payment | [source] The payment information for the order | |
| taxResult | CalcResult | [source] The tax calculation information for the order | |
| taxRate | String | The tax rate of the order in string-decimal format | |
| shippingPrice | Money | The shipping price of the order | |
| deadline | Uint | ||
| orderItems ⚠️ | [OrderItem]! | ⚠️ DEPRECATED
| |
| items | OrderItemConnection! | [source] A query to get all the order items based on the filter | |
| filter | OrderItemFilter | [source] Supported filter parameters | |
| fulfillments | FulfillmentConnection! | [source] A query to get all the fulfillments based on the filter | |
| filter | FulfillmentFilter | [source] Supported filter parameters | |
| price | Money | [source] The total price of the order | |
| subtotalPrice | Money | [source] The subtotal price of the order | |
| tax | Money | [source] The total tax of the order | |
| discounts | Money | [source] The total discounts of the order | |
| paymentMethod ⚠️ | String | ⚠️ DEPRECATED
| |
| paymentService ⚠️ | String | ⚠️ DEPRECATED
| |
| paymentStatus ⚠️ | String | ⚠️ DEPRECATED
| |
| totalPrice ⚠️ | Int | ⚠️ DEPRECATED
| |
| totalSubtotalPrice ⚠️ | Int | ⚠️ DEPRECATED
| |
| totalTotalTax ⚠️ | Int | ⚠️ DEPRECATED
| |
| totalDiscounts ⚠️ | Int | ⚠️ DEPRECATED
| |
OrderConnection
An object containing an array of Order data and pagination information
OrderEdge
An object containing a node with Order data and a cursor
OrderItem
Represents a single order item in an order
| Field | Argument | Type | Description |
|---|---|---|---|
| id | UUID! | The unique order item id | |
| productID | String | The nacelle entry id of the product this item represents | |
| variantID | String | The nacelle entery id of the variant this item represents | |
| status | String! | The status of the order item | |
| sourceExternalID | String | The external id of the order item | |
| destinationExternalID | String | The destination id of the order item, used for syncing with external systems | |
| comment | String | A comment about the order item | |
| priceAmount | Money | The total price of the order item | |
| subtotalPriceAmount | Money | The subtotal price of the order item | |
| taxAmount | Money | The total tax of the order item | |
| discountsAmount | Money | The total discounts of the order item | |
| taxRate | String | The tax rate of the order item in string-decimal format | |
| quantity | Uint | The total quantity of the order item | |
| meta | Map | The meta data for the order item | |
| sku | String | The product sku | |
| createdAt | Time! | When the order item was created | |
| description ⚠️ | String | ⚠️ DEPRECATED
| |
| nacelleEntryID ⚠️ | String | ⚠️ DEPRECATED
| |
| productExternalID ⚠️ | String | ⚠️ DEPRECATED
| |
| price ⚠️ | Int | ⚠️ DEPRECATED
| |
OrderItemConnection
An object containing an array of OrderItem data and pagination information
| Field | Argument | Type | Description |
|---|---|---|---|
| pageInfo | PageInfo! | Information to aid in pagination. | |
| edges | [OrderItemEdge]! | An array of OrderItemsEdge's. | |
OrderItemEdge
An object containing a node with OrderItem data and a cursor
PageInfo
Contains information that can be used to navigate through paginated data, additionally details whether there are more pages to query.
Payment
Represents a payment in the system
| Field | Argument | Type | Description |
|---|---|---|---|
| id | UUID! | The unique payment id | |
| status | PaymentStatus! | The status of the payment | |
| amountValue | Money | The total price of the payment | |
| currency | String! | The currency of the payment for example USD, CAD, etc. | |
| external_id | String | The external id for the payment for example the stripe payment intent id | |
| processor_name | String | The payment processor name for the payment. For example Stripe, Paypal, etc. | |
| payment_type | String | The type of payment. For example credit card, paypal, etc. | |
| processor_status | String | The status of the payment processor | |
| payment_data | Map | The meta data for the payment | |
| cardBrand | String | The brand of the card used for the payment. For example Visa, Mastercard, etc. | |
| amount ⚠️ | Int! | ⚠️ DEPRECATED
| |
| brand ⚠️ | String | ⚠️ DEPRECATED
| |
Inputs
CustomerFilter
Filter results for Customer collections
FulfillmentFilter
Filter results for Fulfillment collections
| Field | Type | Description | |
|---|---|---|---|
| after | Cursor | (Optional) A cursor for navigating in forwards through data | |
| before | Cursor | (Optional) A cursor for navigating in backwards through data | |
| first | Int | (Optional) How many records to return. Defaults to 50. Max value of 100 | |
| orderBy | OrderBy | (Optional) How the returned rows are ordered either version, or timestamp. | |
| direction | Direction | (Optional) What direction the data is retrieved by. | |
OrderFilter
Filter results for Order collections
| Field | Type | Description | |
|---|---|---|---|
| after | Cursor | (Optional) A cursor for navigating in forwards through data | |
| before | Cursor | (Optional) A cursor for navigating in backwards through data | |
| start | Time | (Optional) A timestamp that filters out all events before it, timezone is utc +00:00 | |
| end | Time | (Optional) A timestamp that filters out all events after it, timezone is utc +00:00 | |
| first | Int! | (Optional) First denotes how many records to return | |
| id | UUID | (Optional) The order id to filter by | |
| search | String | (Optional) The string to search for in the order | |
| status | String | (Optional) The status to filter by | |
| orderBy | OrderBy | (Optional) How the returned rows are ordered either version, or timestamp. | |
| direction | Direction | (Optional) What direction the data is retrieved by. | |
OrderItemFilter
Filter results for OrderItem collections
| Field | Type | Description | |
|---|---|---|---|
| after | Cursor | (Optional) A cursor for navigating in forwards through data | |
| before | Cursor | (Optional) A cursor for navigating in backwards through data | |
| first | Int | (Optional) How many records to return. Defaults to 50. Max value of 100 | |
| orderBy | OrderBy | (Optional) How the returned rows are ordered either version, or timestamp. | |
| direction | Direction | (Optional) What direction the data is retrieved by. | |
| showCanceled | Boolean | (Optional) Whether to return canceled items | |
Enums
Direction
Direction to return results in
| Value | Description |
|---|---|
| ASC | |
| DESC |
OrderBy
What to order results by in a collection
| Value | Description |
|---|---|
| CREATEDAT | |
| MODIFIEDAT |
Scalars
Boolean
The Boolean scalar type represents true or false.
Count
Cursor
A base64 encoded string
FulfillmentStatus
Represents the status of a fulfillment. Possible values: open, partially_fulfilled, in_progress, scheduled, cancelled, on_hold, incomplete, succeeded
Int
The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
Map
Maps represent a custom json object attached to a resource.
NullTime
Represents a nullable time
PaymentStatus
Represents the status of a payment. Possible values: created, pending, succeeded, failed, requires_confirmation, balance_due, credit_owed
Service
Represents the enum for services used for calculating TaxResult
String
The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
Time
Represents a date and time according to ISO-8601
UUID
Represents a UUID according to RFC 4122
Uint
Represents a positive integer value
