@nautical-commerce/graphql-schema 4.1.1 → 4.2.0

package/nautical/schema.graphql

@@ -188,8 +188,10 @@ enum AccountErrorCode {
   OUT_OF_SCOPE_GROUP
   OUT_OF_SCOPE_PERMISSION
   OUT_OF_SCOPE_SELLER
+  PASSWORD_LOGIN_DISABLED
   PERMISSION_DENIED
   PASSWORD_ENTIRELY_NUMERIC
+  THROTTLED
   PASSWORD_IDENTICAL
   PASSWORD_TOO_COMMON
   PASSWORD_TOO_SHORT
@@ -802,11 +804,11 @@ type AgreementFeesEventCountableEdge {
 Agreement(id, publication_date, is_published, created_at, updated_at, content, content_html, tenant, seo_title, seo_description, slug, title, default_commission, is_active)
 """
 input AgreementFilterInput {
-  search: String
   AND: AgreementFilterInput
   OR: AgreementFilterInput
   NOT: AgreementFilterInput
   DISTINCT: Boolean
+  search: String
 }
 
 """Type of granular commission (e.g., by category)."""
@@ -1760,6 +1762,10 @@ input AttributeFilterInput {
   filterableInStorefront: Boolean
   filterableInDashboard: Boolean
   availableInGrid: Boolean
+  AND: AttributeFilterInput
+  OR: AttributeFilterInput
+  NOT: AttributeFilterInput
+  DISTINCT: Boolean
   search: String
   ids: [ID]
   hasAssignedProductOrVariant: Boolean
@@ -1771,10 +1777,6 @@ input AttributeFilterInput {
   inVariantSearch: String
   metadata: MetadataFilterInput
   privateMetadata: MetadataFilterInput
-  AND: AttributeFilterInput
-  OR: AttributeFilterInput
-  NOT: AttributeFilterInput
-  DISTINCT: Boolean
 }
 
 """Input for attribute filtering"""
@@ -2108,12 +2110,12 @@ type AttributeValueDelete {
 AttributeValue(id, sort_order, tenant, seller, name, value, slug, attribute, date_time, plain_text, rich_text, currency, amount, reference, boolean, file, file_url, money)
 """
 input AttributeValueFilterInput {
-  search: String
-  attributeIds: [ID]
   AND: AttributeValueFilterInput
   OR: AttributeValueFilterInput
   NOT: AttributeValueFilterInput
   DISTINCT: Boolean
+  search: String
+  attributeIds: [ID]
 }
 
 """Represents an attribute value for product/collection custom fields."""
@@ -3037,16 +3039,16 @@ Category(id, private_metadata, metadata, description, description_html, deleted_
 """
 input CategoryFilterInput {
   allowProductAssignment: Boolean
+  AND: CategoryFilterInput
+  OR: CategoryFilterInput
+  NOT: CategoryFilterInput
+  DISTINCT: Boolean
   search: String
   ids: [ID]
   level: Int
   customFields: [AttributeInput!]
   metadata: MetadataFilterInput
   privateMetadata: MetadataFilterInput
-  AND: CategoryFilterInput
-  OR: CategoryFilterInput
-  NOT: CategoryFilterInput
-  DISTINCT: Boolean
 }
 
 """GraphQL type for CategoryIdentitySchema"""
@@ -3154,6 +3156,11 @@ type Checkout implements Node & ObjectWithMetadata {
   """Whether the checkout has an authenticated user."""
   isAuthenticated: Boolean!
 
+  """
+  Problems that would prevent this checkout from completing — insufficient stock, unavailable variants, missing addresses or shipping method. Read-only preview of completion-time validation; payment coverage and totals are still validated at checkoutComplete.
+  """
+  problems: [CheckoutProblem!]!
+
   """Email of the customer."""
   email: String!
 
@@ -3446,12 +3453,12 @@ type CheckoutEventCountableEdge {
 
 """CheckoutEvent(tenant, id, created_at, type, checkout_id)"""
 input CheckoutEventFilterInput {
-  createdAt: DateTimeRangeInput
-  type: [CheckoutEventType!]
   AND: CheckoutEventFilterInput
   OR: CheckoutEventFilterInput
   NOT: CheckoutEventFilterInput
   DISTINCT: Boolean
+  createdAt: DateTimeRangeInput
+  type: [CheckoutEventType!]
 }
 
 """Fields available for sorting checkout events"""
@@ -3629,6 +3636,33 @@ type CheckoutPaymentCreate {
   paymentErrors: [PaymentError!]!
 }
 
+"""A problem that would prevent this checkout from completing."""
+type CheckoutProblem {
+  """Machine-addressable problem code."""
+  code: CheckoutProblemCode!
+
+  """Human-readable explanation."""
+  message: String!
+
+  """Global ID of the affected checkout line, for line-scoped problems."""
+  lineId: ID
+
+  """Display name of the affected variant, for line-scoped problems."""
+  variantName: String
+
+  """Quantity currently available, for INSUFFICIENT_STOCK problems."""
+  availableQuantity: Int
+}
+
+"""Machine-addressable reasons a checkout cannot complete."""
+enum CheckoutProblemCode {
+  INSUFFICIENT_STOCK
+  VARIANT_UNAVAILABLE
+  SHIPPING_ADDRESS_NOT_SET
+  SHIPPING_METHOD_NOT_SET
+  BILLING_ADDRESS_NOT_SET
+}
+
 """Result of checkout remove PO numbers mutation."""
 type CheckoutRemovePONumbers {
   """The checkout with the purchase order numbers removed."""
@@ -4055,6 +4089,10 @@ type CollectionDelete {
 Collection(id, publication_date, is_published, private_metadata, metadata, description, description_html, tenant, seo_title, seo_description, type, is_visible, name, slug, background_image, background_image_alt)
 """
 input CollectionFilterInput {
+  AND: CollectionFilterInput
+  OR: CollectionFilterInput
+  NOT: CollectionFilterInput
+  DISTINCT: Boolean
   search: String
   ids: [ID]
   published: CollectionPublished
@@ -4063,10 +4101,6 @@ input CollectionFilterInput {
   metadata: MetadataFilterInput
   privateMetadata: MetadataFilterInput
   customFields: [AttributeInput!]
-  AND: CollectionFilterInput
-  OR: CollectionFilterInput
-  NOT: CollectionFilterInput
-  DISTINCT: Boolean
 }
 
 input CollectionInput {
@@ -4346,11 +4380,11 @@ input ContentDuplicateInput {
 
 """Media(tenant, id, title, created_at, image, alt)"""
 input ContentFilterInput {
-  search: String
   AND: ContentFilterInput
   OR: ContentFilterInput
   NOT: ContentFilterInput
   DISTINCT: Boolean
+  search: String
 }
 
 """Content page data with SEO."""
@@ -4993,10 +5027,12 @@ enum CustomerEventsEnum {
   NOTE_ADDED
 }
 
-"""
-User(id, password, last_login, private_metadata, metadata, external_id, external_source, external_inventory_id, tenant, external_payout_account_id, external_payout_source, external_payout_onboarding_url, company_name, is_superuser, email, first_name, last_name, is_staff, is_active, note, date_joined, last_status_changed_at, default_shipping_address, default_billing_address, avatar, jwt_token_key, personal_phone, tax_exempt_code, vat_identification_number, ledger)
-"""
+"""A customer, staff member or marketplace operator account."""
 input CustomerFilterInput {
+  AND: CustomerFilterInput
+  OR: CustomerFilterInput
+  NOT: CustomerFilterInput
+  DISTINCT: Boolean
   dateJoined: DateRangeInput
   placedOrders: DateRangeInput
   moneySpent: PriceRangeInput
@@ -5004,10 +5040,6 @@ input CustomerFilterInput {
   isActive: Boolean
   search: String
   customFields: [AttributeInput!]
-  AND: CustomerFilterInput
-  OR: CustomerFilterInput
-  NOT: CustomerFilterInput
-  DISTINCT: Boolean
 }
 
 input CustomerInput {
@@ -5044,9 +5076,13 @@ input CustomerInput {
 }
 
 """
-NauticalOrder(id, private_metadata, metadata, external_id, external_source, external_inventory_id, tenant, order_source, created, updated, status, sub_status, user, language_code, tracking_client_id, billing_address, shipping_address, user_email, currency, shipping_price_net_amount, shipping_price_gross_amount, marketplace_shipping_price_net_amount, marketplace_shipping_price_gross_amount, is_marketplace_shipping_price_overridden, marketplace_shipping_method, marketplace_shipping_method_name, eu_invoice_messaging, vat_identification_number, mp_vat_identification_number, token, checkout_token, total_net_amount, total_gross_amount, discounted_total_net_amount, discounted_total_gross_amount, domiciled_price_info, domiciled_to_transaction_rate, original_total_net_amount, original_total_gross_amount, voucher, sale, shipping_discount_amount, discount_amount, discount_name, translated_discount_name, display_gross_prices, customer_note, weight, imported_at, po_numbers, shipping_price_net, shipping_price_gross, marketplace_shipping_price_net, marketplace_shipping_price_gross, marketplace_shipping_price, shipping_price, total_net, total_gross, total, discounted_total_net, discounted_total_gross, discounted_total, original_total_net, original_total_gross, original_total, shipping_discount, discount)
+A marketplace order — the buyer's full order, split into per-seller orders.
 """
 input CustomerNauticalOrderFilterInput {
+  AND: CustomerNauticalOrderFilterInput
+  OR: CustomerNauticalOrderFilterInput
+  NOT: CustomerNauticalOrderFilterInput
+  DISTINCT: Boolean
   paymentStatus: [PaymentChargeStatusEnum!]
   status: [OrderStatusFilter!]
   source: [OrderSourceFilter!]
@@ -5058,16 +5094,14 @@ input CustomerNauticalOrderFilterInput {
   metadata: MetadataFilterInput
   privateMetadata: MetadataFilterInput
   ids: [ID]
-  AND: CustomerNauticalOrderFilterInput
-  OR: CustomerNauticalOrderFilterInput
-  NOT: CustomerNauticalOrderFilterInput
-  DISTINCT: Boolean
 }
 
-"""
-Order(id, private_metadata, metadata, external_id, external_source, external_inventory_id, tenant, order_source, seller, created, updated, status, sub_status, payout_status, user, language_code, tracking_client_id, billing_address, shipping_address, user_email, vat_code, eu_invoice_messaging, vat_identification_number, mp_vat_identification_number, currency, shipping_method, shipping_method_name, shipping_price_net_amount, shipping_price_gross_amount, is_shipping_price_overridden, fulfilled_by_marketplace, token, checkout_token, total_net_amount, total_gross_amount, domiciled_price_info, domiciled_to_transaction_rate, original_total_net_amount, original_total_gross_amount, voucher, discount_amount, discount_name, translated_discount_name, display_gross_prices, customer_note, weight, imported_at, nautical_order, financials, shipping_price_net, shipping_price_gross, shipping_price, total_net, total_gross, total, original_total_net, original_total_gross, original_total, discount)
-"""
+"""A seller-level order — one seller's portion of a marketplace order."""
 input CustomerOrderFilterInput {
+  AND: CustomerOrderFilterInput
+  OR: CustomerOrderFilterInput
+  NOT: CustomerOrderFilterInput
+  DISTINCT: Boolean
   paymentStatus: [PaymentChargeStatusEnum!]
   status: [OrderStatusFilter!]
   source: [OrderSourceFilter!]
@@ -5082,10 +5116,6 @@ input CustomerOrderFilterInput {
   ids: [ID]
   vendorPayouts: [ID]
   payouts: [ID]
-  AND: CustomerOrderFilterInput
-  OR: CustomerOrderFilterInput
-  NOT: CustomerOrderFilterInput
-  DISTINCT: Boolean
 }
 
 """Customer report row."""
@@ -6220,6 +6250,10 @@ type EmailEventCountableEdge {
 
 """Model used to store events that happened during the email lifecycle."""
 input EmailEventFilterInput {
+  AND: EmailEventFilterInput
+  OR: EmailEventFilterInput
+  NOT: EmailEventFilterInput
+  DISTINCT: Boolean
   fromEmail: String
   toEmail: String
 
@@ -6228,10 +6262,6 @@ input EmailEventFilterInput {
   """
   date: DateTimeRangeInput
   messageType: [NotifyEventTypeEnum!]
-  AND: EmailEventFilterInput
-  OR: EmailEventFilterInput
-  NOT: EmailEventFilterInput
-  DISTINCT: Boolean
 }
 
 """Email event message types for notification tracking."""
@@ -6342,13 +6372,13 @@ type EmailTemplateCountableEdge {
 
 """Model for email templates."""
 input EmailTemplateFilterInput {
-  title: String
-  recipientType: RecipientTypeEnum
-  eventType: EventTypeEnum
   AND: EmailTemplateFilterInput
   OR: EmailTemplateFilterInput
   NOT: EmailTemplateFilterInput
   DISTINCT: Boolean
+  title: String
+  recipientType: RecipientTypeEnum
+  eventType: EventTypeEnum
 }
 
 """Represents an email template preview."""
@@ -6597,15 +6627,15 @@ type ExportFileCountableEdge {
 ExportFile(id, status, message, created_at, updated_at, tenant, user, app, content_file)
 """
 input ExportFileFilterInput {
+  AND: ExportFileFilterInput
+  OR: ExportFileFilterInput
+  NOT: ExportFileFilterInput
+  DISTINCT: Boolean
   status: JobStatusEnum
   user: String
   app: String
   createdAt: DateTimeRangeInput
   updatedAt: DateTimeRangeInput
-  AND: ExportFileFilterInput
-  OR: ExportFileFilterInput
-  NOT: ExportFileFilterInput
-  DISTINCT: Boolean
 }
 
 """Fields available for sorting export files"""
@@ -7338,15 +7368,15 @@ type ImportFileCountableEdge {
 ImportFile(id, status, message, created_at, updated_at, tenant, user, app, content_file, metadata, import_config, seller)
 """
 input ImportFileFilterInput {
+  AND: ImportFileFilterInput
+  OR: ImportFileFilterInput
+  NOT: ImportFileFilterInput
+  DISTINCT: Boolean
   status: JobStatusEnum
   user: String
   app: String
   createdAt: DateTimeRangeInput
   updatedAt: DateTimeRangeInput
-  AND: ImportFileFilterInput
-  OR: ImportFileFilterInput
-  NOT: ImportFileFilterInput
-  DISTINCT: Boolean
 }
 
 """Fields available for sorting import files"""
@@ -7774,6 +7804,10 @@ type JournalEntryCountableEdge {
 JournalEntry(private_metadata, metadata, created_at, updated_at, tenant, id, corrects, description, fulfillment_line, nautical_order, order, order_line, payment, refund, refund_line, vendor_payout, type)
 """
 input JournalEntryFilterInput {
+  AND: JournalEntryFilterInput
+  OR: JournalEntryFilterInput
+  NOT: JournalEntryFilterInput
+  DISTINCT: Boolean
   type: JournalEntryTypeEnum
   createdAt: DateTimeRangeInput
   fulfillmentLineIds: [ID]
@@ -7783,10 +7817,6 @@ input JournalEntryFilterInput {
   paymentIds: [ID]
   refundLineIds: [ID]
   vendorPayoutIds: [ID]
-  AND: JournalEntryFilterInput
-  OR: JournalEntryFilterInput
-  NOT: JournalEntryFilterInput
-  DISTINCT: Boolean
 }
 
 """Fields available for sorting journal entries"""
@@ -7978,12 +8008,12 @@ type LedgerEntry implements Node & ObjectWithMetadata {
 LedgerEntry(private_metadata, metadata, created_at, updated_at, tenant, id, amount, book_balance, currency, journal_entry, ledger, ledger_version)
 """
 input LedgerEntryFilterInput {
-  type: LedgerTypeEnum
-  sellerIds: [ID]
   AND: LedgerEntryFilterInput
   OR: LedgerEntryFilterInput
   NOT: LedgerEntryFilterInput
   DISTINCT: Boolean
+  type: LedgerTypeEnum
+  sellerIds: [ID]
 }
 
 input LedgerEntryInput {
@@ -8141,6 +8171,11 @@ type MarketplaceConfiguration {
   customerSetPasswordUrl: String
   chargeTaxesOnShipping: Boolean!
 
+  """
+  Expire (cancel) placed orders that still await payment after this many minutes without updates. Applies to any order with the AWAITING_PAYMENT sub-status, including draft/quote orders sent to customers for payment. Null disables expiration.
+  """
+  expireUnpaidOrdersAfterMinutes: Int
+
   """Shop's description."""
   description: String!
 
@@ -8156,6 +8191,9 @@ type MarketplaceConfiguration {
   """Determines the fulfillment model for the marketplace."""
   fulfillmentModel: FulfillmentModelEnum!
 
+  """Who may authenticate with email + password (tokenCreate)."""
+  passwordLoginMode: PasswordLoginModeEnum!
+
   """Default weight unit."""
   defaultWeightUnit: WeightUnitsEnum!
 
@@ -8429,6 +8467,16 @@ input MarketplaceConfigurationInput {
   customerSetPasswordUrl: String = null
   chargeTaxesOnShipping: Boolean = null
 
+  """
+  Expire placed orders still awaiting payment after this many minutes without updates (minimum 60). Pass 0 to disable expiration.
+  """
+  expireUnpaidOrdersAfterMinutes: Int = null
+
+  """
+  Who may authenticate with email + password (tokenCreate). Restricting to CUSTOMERS_ONLY or DISABLED requires an active SSO integration; platform-support users always retain password login.
+  """
+  passwordLoginMode: PasswordLoginModeEnum = null
+
   """Update attribute template strategy"""
   attributeTemplateStrategy: AttributeTemplateStrategyEnum = null @deprecated(reason: "This field will be removed on July 23, 2025.")
 
@@ -8650,11 +8698,11 @@ input MediaCreateInput {
 
 """Media(tenant, id, title, created_at, image, alt)"""
 input MediaFilterInput {
-  search: String
   AND: MediaFilterInput
   OR: MediaFilterInput
   NOT: MediaFilterInput
   DISTINCT: Boolean
+  search: String
 }
 
 """Fields available for sorting media"""
@@ -8790,12 +8838,12 @@ enum MenuErrorCode {
 
 """Menu(id, tenant, name, slug)"""
 input MenuFilterInput {
-  search: String
-  slug: [String!]
   AND: MenuFilterInput
   OR: MenuFilterInput
   NOT: MenuFilterInput
   DISTINCT: Boolean
+  search: String
+  slug: [String!]
 }
 
 """Input for menu operations"""
@@ -8940,11 +8988,11 @@ type MenuItemDelete {
 MenuItem(id, sort_order, tenant, menu, name, parent, url, category, collection, page, seller, product, content, policy)
 """
 input MenuItemFilterInput {
-  search: String
   AND: MenuItemFilterInput
   OR: MenuItemFilterInput
   NOT: MenuItemFilterInput
   DISTINCT: Boolean
+  search: String
 }
 
 """Fields for a menu item (used in menu creation and updates)."""
@@ -9370,6 +9418,11 @@ type Mutation {
   """Deletes vouchers."""
   voucherBulkDelete(ids: [ID!]!): VoucherBulkDelete!
 
+  """
+  Deletes voucher codes. The mirror row of a voucher's primary code cannot be deleted — rename the voucher's code instead.
+  """
+  voucherCodeBulkDelete(ids: [ID!]!): VoucherCodeBulkDelete!
+
   """Deletes sales."""
   saleBulkDelete(ids: [ID!]!): SaleBulkDelete!
 
@@ -9595,6 +9648,11 @@ type Mutation {
   """
   orderDeclineFulfillment(input: DeclineFulfillInput!, order: ID = null): OrderDeclineFulfillment!
 
+  """
+  Import already-settled historical orders (seller migrations). Skips ledger, stock, webhooks and price recalculation; amounts are written verbatim and seller sub-orders are marked PAID_OUT. Requires MANAGE_ORDERS permission.
+  """
+  nauticalOrderBulkImport(input: [NauticalOrderImportInput!]!): NauticalOrderBulkImport!
+
   """Bulk cancel seller orders."""
   orderBulkCancel(ids: [ID!]!): OrderBulkCancel!
 
@@ -11041,6 +11099,30 @@ type NauticalOrderBulkAssignCustomer {
   orderErrors: [OrderError!]!
 }
 
+"""Result of the historical order bulk import."""
+type NauticalOrderBulkImport {
+  """Number of orders imported."""
+  count: Int!
+
+  """Per-row outcomes, in request order."""
+  results: [NauticalOrderBulkImportResult!]!
+
+  """Batch-level errors (empty when the batch was processed)."""
+  orderErrors: [OrderError!]!
+}
+
+"""Per-row outcome of a historical order import."""
+type NauticalOrderBulkImportResult {
+  """Position of the row in the request."""
+  index: Int!
+
+  """The imported order, when the row succeeded."""
+  nauticalOrder: NauticalOrder
+
+  """Errors that failed this row."""
+  orderErrors: [OrderError!]!
+}
+
 """Result of nautical order cancel mutation."""
 type NauticalOrderCancel {
   """NauticalOrderCancel result."""
@@ -11081,9 +11163,13 @@ type NauticalOrderCountableEdge {
 }
 
 """
-NauticalOrder(id, private_metadata, metadata, external_id, external_source, external_inventory_id, tenant, order_source, created, updated, status, sub_status, user, language_code, tracking_client_id, billing_address, shipping_address, user_email, currency, shipping_price_net_amount, shipping_price_gross_amount, marketplace_shipping_price_net_amount, marketplace_shipping_price_gross_amount, is_marketplace_shipping_price_overridden, marketplace_shipping_method, marketplace_shipping_method_name, eu_invoice_messaging, vat_identification_number, mp_vat_identification_number, token, checkout_token, total_net_amount, total_gross_amount, discounted_total_net_amount, discounted_total_gross_amount, domiciled_price_info, domiciled_to_transaction_rate, original_total_net_amount, original_total_gross_amount, voucher, sale, shipping_discount_amount, discount_amount, discount_name, translated_discount_name, display_gross_prices, customer_note, weight, imported_at, po_numbers, shipping_price_net, shipping_price_gross, marketplace_shipping_price_net, marketplace_shipping_price_gross, marketplace_shipping_price, shipping_price, total_net, total_gross, total, discounted_total_net, discounted_total_gross, discounted_total, original_total_net, original_total_gross, original_total, shipping_discount, discount)
+A marketplace order — the buyer's full order, split into per-seller orders.
 """
 input NauticalOrderDraftFilterInput {
+  AND: NauticalOrderDraftFilterInput
+  OR: NauticalOrderDraftFilterInput
+  NOT: NauticalOrderDraftFilterInput
+  DISTINCT: Boolean
   customer: String
   search: String
   created: DateRangeInput
@@ -11093,10 +11179,6 @@ input NauticalOrderDraftFilterInput {
   metadata: MetadataFilterInput
   privateMetadata: MetadataFilterInput
   ids: [ID]
-  AND: NauticalOrderDraftFilterInput
-  OR: NauticalOrderDraftFilterInput
-  NOT: NauticalOrderDraftFilterInput
-  DISTINCT: Boolean
 }
 
 """Represents a nautical order event in the order history."""
@@ -11166,9 +11248,13 @@ type NauticalOrderEventOrderLineObject {
 }
 
 """
-NauticalOrder(id, private_metadata, metadata, external_id, external_source, external_inventory_id, tenant, order_source, created, updated, status, sub_status, user, language_code, tracking_client_id, billing_address, shipping_address, user_email, currency, shipping_price_net_amount, shipping_price_gross_amount, marketplace_shipping_price_net_amount, marketplace_shipping_price_gross_amount, is_marketplace_shipping_price_overridden, marketplace_shipping_method, marketplace_shipping_method_name, eu_invoice_messaging, vat_identification_number, mp_vat_identification_number, token, checkout_token, total_net_amount, total_gross_amount, discounted_total_net_amount, discounted_total_gross_amount, domiciled_price_info, domiciled_to_transaction_rate, original_total_net_amount, original_total_gross_amount, voucher, sale, shipping_discount_amount, discount_amount, discount_name, translated_discount_name, display_gross_prices, customer_note, weight, imported_at, po_numbers, shipping_price_net, shipping_price_gross, marketplace_shipping_price_net, marketplace_shipping_price_gross, marketplace_shipping_price, shipping_price, total_net, total_gross, total, discounted_total_net, discounted_total_gross, discounted_total, original_total_net, original_total_gross, original_total, shipping_discount, discount)
+A marketplace order — the buyer's full order, split into per-seller orders.
 """
 input NauticalOrderFilterInput {
+  AND: NauticalOrderFilterInput
+  OR: NauticalOrderFilterInput
+  NOT: NauticalOrderFilterInput
+  DISTINCT: Boolean
   paymentStatus: [PaymentChargeStatusEnum!]
   status: [OrderStatusFilter!]
   source: [OrderSourceFilter!]
@@ -11180,10 +11266,6 @@ input NauticalOrderFilterInput {
   metadata: MetadataFilterInput
   privateMetadata: MetadataFilterInput
   ids: [ID]
-  AND: NauticalOrderFilterInput
-  OR: NauticalOrderFilterInput
-  NOT: NauticalOrderFilterInput
-  DISTINCT: Boolean
 }
 
 """Result of nautical order fulfill mutation."""
@@ -11219,6 +11301,56 @@ input NauticalOrderFulfillLineInput {
   stocks: [OrderFulfillStockInput!]!
 }
 
+"""One historical order to import."""
+input NauticalOrderImportInput {
+  """Idempotency key from the source platform."""
+  externalId: String!
+
+  """Customer email on the source order."""
+  userEmail: String!
+
+  """Order lines."""
+  lines: [NauticalOrderImportLineInput!]!
+
+  """Imported status; defaults to DELIVERED."""
+  status: NauticalOrderImportStatus = null
+
+  """Historical placement time."""
+  createdAt: DateTime = null
+
+  """Order currency; defaults to the marketplace default."""
+  currency: String = null
+
+  """Order-level shipping amount."""
+  shippingPrice: PositiveDecimal = null
+
+  """Source platform label (e.g. shopify)."""
+  externalSource: String = null
+}
+
+"""One line of a historical order import."""
+input NauticalOrderImportLineInput {
+  """SKU of an existing variant (resolved per tenant)."""
+  sku: String!
+
+  """Quantity purchased."""
+  quantity: Int!
+
+  """Unit price in the order currency; written verbatim (net = gross)."""
+  unitPrice: PositiveDecimal!
+
+  """Line total override; defaults to quantity × unitPrice."""
+  totalPrice: PositiveDecimal = null
+}
+
+"""Statuses accepted by nauticalOrderBulkImport (settled orders only)."""
+enum NauticalOrderImportStatus {
+  UNFULFILLED
+  FULFILLED
+  DELIVERED
+  CANCELED
+}
+
 """Represents nautical order line in the marketplace order."""
 type NauticalOrderLine implements Node & ObjectWithMetadata {
   """The Globally Unique ID of this object"""
@@ -12110,10 +12242,12 @@ enum OrderDirection {
   DESC
 }
 
-"""
-Order(id, private_metadata, metadata, external_id, external_source, external_inventory_id, tenant, order_source, seller, created, updated, status, sub_status, payout_status, user, language_code, tracking_client_id, billing_address, shipping_address, user_email, vat_code, eu_invoice_messaging, vat_identification_number, mp_vat_identification_number, currency, shipping_method, shipping_method_name, shipping_price_net_amount, shipping_price_gross_amount, is_shipping_price_overridden, fulfilled_by_marketplace, token, checkout_token, total_net_amount, total_gross_amount, domiciled_price_info, domiciled_to_transaction_rate, original_total_net_amount, original_total_gross_amount, voucher, discount_amount, discount_name, translated_discount_name, display_gross_prices, customer_note, weight, imported_at, nautical_order, financials, shipping_price_net, shipping_price_gross, shipping_price, total_net, total_gross, total, original_total_net, original_total_gross, original_total, discount)
-"""
+"""A seller-level order — one seller's portion of a marketplace order."""
 input OrderDraftFilterInput {
+  AND: OrderDraftFilterInput
+  OR: OrderDraftFilterInput
+  NOT: OrderDraftFilterInput
+  DISTINCT: Boolean
   customer: String
   search: String
   created: DateRangeInput
@@ -12123,10 +12257,6 @@ input OrderDraftFilterInput {
   metadata: MetadataFilterInput
   privateMetadata: MetadataFilterInput
   ids: [ID]
-  AND: OrderDraftFilterInput
-  OR: OrderDraftFilterInput
-  NOT: OrderDraftFilterInput
-  DISTINCT: Boolean
 }
 
 """Represents errors from order operations."""
@@ -12295,6 +12425,7 @@ enum OrderEventsEnum {
   PLACED_FROM_QUOTE
   OVERSOLD_ITEMS
   CANCELED
+  EXPIRED
   ORDER_MARKED_AS_PAID
   ORDER_MARKED_AS_DELIVERED
   ORDER_FULLY_PAID
@@ -12399,10 +12530,12 @@ input OrderFeeInput {
   feeValue: Decimal!
 }
 
-"""
-Order(id, private_metadata, metadata, external_id, external_source, external_inventory_id, tenant, order_source, seller, created, updated, status, sub_status, payout_status, user, language_code, tracking_client_id, billing_address, shipping_address, user_email, vat_code, eu_invoice_messaging, vat_identification_number, mp_vat_identification_number, currency, shipping_method, shipping_method_name, shipping_price_net_amount, shipping_price_gross_amount, is_shipping_price_overridden, fulfilled_by_marketplace, token, checkout_token, total_net_amount, total_gross_amount, domiciled_price_info, domiciled_to_transaction_rate, original_total_net_amount, original_total_gross_amount, voucher, discount_amount, discount_name, translated_discount_name, display_gross_prices, customer_note, weight, imported_at, nautical_order, financials, shipping_price_net, shipping_price_gross, shipping_price, total_net, total_gross, total, original_total_net, original_total_gross, original_total, discount)
-"""
+"""A seller-level order — one seller's portion of a marketplace order."""
 input OrderFilterInput {
+  AND: OrderFilterInput
+  OR: OrderFilterInput
+  NOT: OrderFilterInput
+  DISTINCT: Boolean
   paymentStatus: [PaymentChargeStatusEnum!]
   status: [OrderStatusFilter!]
   source: [OrderSourceFilter!]
@@ -12417,10 +12550,6 @@ input OrderFilterInput {
   ids: [ID]
   vendorPayouts: [ID]
   payouts: [ID]
-  AND: OrderFilterInput
-  OR: OrderFilterInput
-  NOT: OrderFilterInput
-  DISTINCT: Boolean
 }
 
 """Result of order fulfill mutation."""
@@ -13075,11 +13204,11 @@ enum PageErrorCode {
 Page(id, publication_date, is_published, private_metadata, metadata, created_at, updated_at, content, content_html, tenant, seo_title, seo_description, slug, title, image_url, image_alt)
 """
 input PageFilterInput {
-  search: String
   AND: PageFilterInput
   OR: PageFilterInput
   NOT: PageFilterInput
   DISTINCT: Boolean
+  search: String
 }
 
 """Result of page image delete mutation."""
@@ -13175,6 +13304,15 @@ type PasswordChange {
   accountErrors: [AccountError!]!
 }
 
+"""
+Who may authenticate with email + password (tokenCreate). SSO login mutations are unaffected.
+"""
+enum PasswordLoginModeEnum {
+  ENABLED
+  CUSTOMERS_ONLY
+  DISABLED
+}
+
 """Result of password request reset mutation."""
 type PasswordRequestReset {
   """The user (hidden for security)."""
@@ -13671,14 +13809,14 @@ enum PayoutErrorCode {
 Payout(id, private_metadata, metadata, tenant, created, updated, start_date, end_date, status, name, currency)
 """
 input PayoutFilterInput {
-  status: [PayoutStatusFilter!]
-  search: String
-  created: DateRangeInput
-  netSales: PriceRangeInput
   AND: PayoutFilterInput
   OR: PayoutFilterInput
   NOT: PayoutFilterInput
   DISTINCT: Boolean
+  status: [PayoutStatusFilter!]
+  search: String
+  created: DateRangeInput
+  netSales: PriceRangeInput
 }
 
 """Result of payout process mutation."""
@@ -13867,11 +14005,11 @@ enum PermissionGroupErrorCode {
 
 """Group(id, tenant, name)"""
 input PermissionGroupFilterInput {
-  search: String
   AND: PermissionGroupFilterInput
   OR: PermissionGroupFilterInput
   NOT: PermissionGroupFilterInput
   DISTINCT: Boolean
+  search: String
 }
 
 """Fields available for sorting permission groups"""
@@ -14217,15 +14355,15 @@ enum PolicyErrorCode {
 Policy(id, publication_date, is_published, created_at, updated_at, content, content_html, tenant, seo_title, seo_description, category, slug, title, seller)
 """
 input PolicyFilterInput {
+  AND: PolicyFilterInput
+  OR: PolicyFilterInput
+  NOT: PolicyFilterInput
+  DISTINCT: Boolean
   search: String
   isPublished: Boolean
   category: String
   seller: String
   marketplaceOnly: Boolean
-  AND: PolicyFilterInput
-  OR: PolicyFilterInput
-  NOT: PolicyFilterInput
-  DISTINCT: Boolean
 }
 
 """Fields required to create or update a policy."""
@@ -15069,14 +15207,19 @@ input ProductFilterInput {
   When enabled, other sellers can create their own variants on this product (cross-sell). Requires marketplace-level enable_master_products to be True.
   """
   allowSellerVariants: Boolean
+  AND: ProductFilterInput
+  OR: ProductFilterInput
+  NOT: ProductFilterInput
+  DISTINCT: Boolean
+  search: String
+  advancedSearch: ProductSearchInput
   ids: [ID]
   categories: [ID]
   collections: [ID]
   productTypes: [ID]
+  productType: ID
   sellers: [ID]
   seller: ID
-  search: String
-  advancedSearch: ProductSearchInput
   price: PriceRangeInput
   minimalPrice: PriceRangeInput
   createdAt: DateTimeRangeInput
@@ -15092,14 +15235,9 @@ input ProductFilterInput {
   hasWarnings: Boolean
   hasCategory: Boolean
   slug: [String!]
+  dates: CustomDateRangeInput @deprecated(reason: "This will be removed on July 29, 2025")
   isStaff: Boolean
   isSimple: Boolean
-  dates: CustomDateRangeInput @deprecated(reason: "This will be removed on July 29, 2025")
-  productType: ID
-  AND: ProductFilterInput
-  OR: ProductFilterInput
-  NOT: ProductFilterInput
-  DISTINCT: Boolean
 }
 
 """Represents a product image."""
@@ -15832,6 +15970,10 @@ ProductType(id, private_metadata, metadata, description, description_html, exter
 input ProductTypeFilterInput {
   isDigital: Boolean
   isShippingRequired: Boolean
+  AND: ProductTypeFilterInput
+  OR: ProductTypeFilterInput
+  NOT: ProductTypeFilterInput
+  DISTINCT: Boolean
   search: String
   ids: [ID]
   configurable: ProductTypeConfigurable
@@ -15839,10 +15981,6 @@ input ProductTypeFilterInput {
   showExternal: Boolean
   metadata: MetadataFilterInput
   privateMetadata: MetadataFilterInput
-  AND: ProductTypeFilterInput
-  OR: ProductTypeFilterInput
-  NOT: ProductTypeFilterInput
-  DISTINCT: Boolean
 }
 
 input ProductTypeInput {
@@ -16387,6 +16525,12 @@ input ProductVariantFilterInput {
   isPublished: Boolean
   status: String
   trackInventory: Boolean
+  AND: ProductVariantFilterInput
+  OR: ProductVariantFilterInput
+  NOT: ProductVariantFilterInput
+  DISTINCT: Boolean
+  search: String
+  advancedSearch: ProductVariantSearchInput
   ids: [ID]
   product: ID
   productIds: [ID]
@@ -16394,8 +16538,6 @@ input ProductVariantFilterInput {
   seller: ID
   sku: [String!]
   nsn: [String!]
-  search: String
-  advancedSearch: ProductVariantSearchInput
   categories: [ID]
   collections: [ID]
   productTypes: [ID]
@@ -16409,10 +16551,6 @@ input ProductVariantFilterInput {
   createdAt: DateTimeRangeInput
   updatedAt: DateTimeRangeInput
   isStaff: Boolean
-  AND: ProductVariantFilterInput
-  OR: ProductVariantFilterInput
-  NOT: ProductVariantFilterInput
-  DISTINCT: Boolean
 }
 
 """Result of product variant image assign mutation."""
@@ -17355,6 +17493,7 @@ type Query {
   """List of the shop's customers"""
   customers(
     filter: CustomerFilterInput
+    search: String = null
     sortBy: UserSortingInput = null
 
     """Returns the items in the list that come before the specified cursor."""
@@ -17472,6 +17611,7 @@ type Query {
   orderByToken(token: NauticalUUID!): Order
   orders(
     filter: OrderFilterInput
+    search: String = null
     sortBy: OrderSortingInput = null
     identifier: ID = null
 
@@ -17536,6 +17676,7 @@ type Query {
   nauticalOrderByToken(token: NauticalUUID!): NauticalOrder
   nauticalOrders(
     filter: NauticalOrderFilterInput
+    search: String = null
     sortBy: OrderSortingInput = null
 
     """Returns the items in the list that come before the specified cursor."""
@@ -18581,6 +18722,10 @@ enum RefundErrorCode {
 Refund(private_metadata, metadata, created_at, updated_at, description, description_html, deleted_at, deleted_by_user, deleted_by_app, deletion_batch_uuid, tenant, id, name, external_id, status, token, buyer, order)
 """
 input RefundFilterInput {
+  AND: RefundFilterInput
+  OR: RefundFilterInput
+  NOT: RefundFilterInput
+  DISTINCT: Boolean
   name: String
   buyer: String
   externalId: String
@@ -18588,10 +18733,6 @@ input RefundFilterInput {
   status: RefundStatusEnum
   createdAt: DateTimeRangeInput
   updatedAt: DateTimeRangeInput
-  AND: RefundFilterInput
-  OR: RefundFilterInput
-  NOT: RefundFilterInput
-  DISTINCT: Boolean
 }
 
 """Represents a refund line."""
@@ -18951,14 +19092,14 @@ enum ReportingPeriod {
 Fulfillment(id, private_metadata, metadata, external_id, external_source, external_inventory_id, tenant, fulfillment_order, related_to, order, nautical_order, status, tracking_company, tracking_number, tracking_url, shipping_label_url, created, updated, total_lines_quantity, total_lines_price, user)
 """
 input ReturnFulfillmentFilterInput {
-  status: [FulfillmentStatusFilter!]
-  customer: String
-  search: String
-  created: DateRangeInput
   AND: ReturnFulfillmentFilterInput
   OR: ReturnFulfillmentFilterInput
   NOT: ReturnFulfillmentFilterInput
   DISTINCT: Boolean
+  status: [FulfillmentStatusFilter!]
+  customer: String
+  search: String
+  created: DateRangeInput
 }
 
 """Fields available for sorting return fulfillments"""
@@ -19171,14 +19312,14 @@ type SaleDelete {
 Sale(id, deleted_at, deleted_by_user, deleted_by_app, deletion_batch_uuid, tenant, name, type, sale_type, value, start_date, end_date, currency, min_spent_amount, min_checkout_items_quantity, discount, min_spent)
 """
 input SaleFilterInput {
-  status: [DiscountStatusEnum!]
-  saleType: DiscountValueTypeEnum
-  started: DateTimeRangeInput
-  search: String
   AND: SaleFilterInput
   OR: SaleFilterInput
   NOT: SaleFilterInput
   DISTINCT: Boolean
+  status: [DiscountStatusEnum!]
+  saleType: DiscountValueTypeEnum
+  started: DateTimeRangeInput
+  search: String
 }
 
 """Input for creating or updating a sale."""
@@ -20046,6 +20187,10 @@ enum SellerExternalPayoutSource {
 Seller(id, private_metadata, metadata, created_at, updated_at, tenant, external_payout_account_id, external_payout_source, external_payout_onboarding_url, company_name, slug, is_marketplace_seller, logo, identification, default_shipping_address, default_billing_address, owner, default_currency, fulfilled_by_marketplace, status, agreement_decision_reason, banner, store_description, external_payouts_enabled, external_payout_schedule, external_payout_status_synced_at)
 """
 input SellerFilterInput {
+  AND: SellerFilterInput
+  OR: SellerFilterInput
+  NOT: SellerFilterInput
+  DISTINCT: Boolean
   status: [SellerStatusFilter!]
   search: String
   created: DateRangeInput
@@ -20055,10 +20200,6 @@ input SellerFilterInput {
   metadata: MetadataFilterInput
   privateMetadata: MetadataFilterInput
   ids: [ID]
-  AND: SellerFilterInput
-  OR: SellerFilterInput
-  NOT: SellerFilterInput
-  DISTINCT: Boolean
 }
 
 """Input for creating a seller"""
@@ -20846,12 +20987,12 @@ type ShippingZoneDelete {
 ShippingZone(id, private_metadata, metadata, tenant, name, countries, seller)
 """
 input ShippingZoneFilterInput {
-  search: String
-  seller: ID
   AND: ShippingZoneFilterInput
   OR: ShippingZoneFilterInput
   NOT: ShippingZoneFilterInput
   DISTINCT: Boolean
+  search: String
+  seller: ID
 }
 
 """Result of shipping zone update mutation."""
@@ -21406,18 +21547,16 @@ input StaffUpdateInput {
   taxExemptCode: String = null
 }
 
-"""
-User(id, password, last_login, private_metadata, metadata, external_id, external_source, external_inventory_id, tenant, external_payout_account_id, external_payout_source, external_payout_onboarding_url, company_name, is_superuser, email, first_name, last_name, is_staff, is_active, note, date_joined, last_status_changed_at, default_shipping_address, default_billing_address, avatar, jwt_token_key, personal_phone, tax_exempt_code, vat_identification_number, ledger)
-"""
+"""A customer, staff member or marketplace operator account."""
 input StaffUserInput {
-  status: StaffMemberStatus
-  isUserActive: Boolean
-  search: String
-  customFields: [AttributeInput!]
   AND: StaffUserInput
   OR: StaffUserInput
   NOT: StaffUserInput
   DISTINCT: Boolean
+  status: StaffMemberStatus
+  isUserActive: Boolean
+  search: String
+  customFields: [AttributeInput!]
 }
 
 """Result of start CSV import mutation."""
@@ -21561,11 +21700,11 @@ This allows distinguishing Shopify-managed inventory from manually-created stock
 input StockFilterInput {
   id: ID
   quantity: Decimal
-  search: String
   AND: StockFilterInput
   OR: StockFilterInput
   NOT: StockFilterInput
   DISTINCT: Boolean
+  search: String
 }
 
 input StockInput {
@@ -23067,7 +23206,7 @@ type Voucher implements Node {
   name: String
 
   """Voucher code"""
-  code: String!
+  code: String! @deprecated(reason: "Use `codes` — a voucher can carry multiple codes.")
 
   """Maximum usage limit"""
   usageLimit: Int
@@ -23084,6 +23223,9 @@ type Voucher implements Node {
   """Whether to apply once per customer"""
   applyOncePerCustomer: Boolean!
 
+  """Whether each code can be redeemed only once"""
+  singleUse: Boolean!
+
   """Minimum checkout items quantity required"""
   minCheckoutItemsQuantity: Int
 
@@ -23108,6 +23250,21 @@ type Voucher implements Node {
   """List of countries this voucher applies to."""
   countries: [CountryDisplay!]!
 
+  """Codes that can be redeemed for this voucher."""
+  codes(
+    """Returns the items in the list that come before the specified cursor."""
+    before: String = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    after: String = null
+
+    """Returns the first n items from the list."""
+    first: Int = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    last: Int = null
+  ): VoucherCodeCountableConnection!
+
   """List of categories this voucher applies to."""
   categories(
     """Returns the items in the list that come before the specified cursor."""
@@ -23187,6 +23344,54 @@ type VoucherBulkDelete {
   discountErrors: [DiscountError!]!
 }
 
+"""A redeemable code belonging to a voucher."""
+type VoucherCode implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+
+  """The code value."""
+  code: String!
+
+  """Number of times this code was used."""
+  used: Int!
+
+  """Whether the code can still be redeemed."""
+  isActive: Boolean!
+
+  """When the code was created."""
+  createdAt: DateTime!
+}
+
+"""Result of voucher code bulk delete mutation."""
+type VoucherCodeBulkDelete {
+  """Number of voucher codes deleted."""
+  count: Int!
+
+  """List of errors that occurred executing the mutation."""
+  discountErrors: [DiscountError!]!
+}
+
+"""A connection to a list of items."""
+type VoucherCodeCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [VoucherCodeCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type VoucherCodeCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: VoucherCode!
+}
+
 """A connection to a list of items."""
 type VoucherCountableConnection {
   """Pagination data for this connection"""
@@ -23234,18 +23439,18 @@ enum VoucherDiscountType {
 }
 
 """
-Voucher(id, tenant, type, name, code, usage_limit, used, start_date, end_date, apply_once_per_order, apply_once_per_customer, discount_value_type, discount_value, countries, currency, min_spent_amount, min_checkout_items_quantity, discount, min_spent)
+Voucher(id, tenant, type, name, code, usage_limit, used, start_date, end_date, apply_once_per_order, apply_once_per_customer, single_use, discount_value_type, discount_value, countries, currency, min_spent_amount, min_checkout_items_quantity, discount, min_spent)
 """
 input VoucherFilterInput {
+  AND: VoucherFilterInput
+  OR: VoucherFilterInput
+  NOT: VoucherFilterInput
+  DISTINCT: Boolean
   status: [DiscountStatusEnum!]
   discountType: [VoucherDiscountType!]
   timesUsed: IntRangeInput
   started: DateTimeRangeInput
   search: String
-  AND: VoucherFilterInput
-  OR: VoucherFilterInput
-  NOT: VoucherFilterInput
-  DISTINCT: Boolean
 }
 
 """Input for creating or updating a voucher."""
@@ -23259,6 +23464,12 @@ input VoucherInput {
   """Code to use the voucher. If empty, a code will be generated."""
   code: String = null
 
+  """Additional codes to attach to the voucher."""
+  addCodes: [String!] = null
+
+  """Whether each voucher code can be redeemed only once."""
+  singleUse: Boolean = null
+
   """Start date of the voucher in ISO 8601 format."""
   startDate: DateTime = null
 
@@ -23484,14 +23695,14 @@ Warehouse(private_metadata, metadata, external_id, external_source, external_inv
 """
 input WarehouseFilterInput {
   id: ID
-  ids: [ID]
   sellerId: ID
-  search: String
-  seller: ID
   AND: WarehouseFilterInput
   OR: WarehouseFilterInput
   NOT: WarehouseFilterInput
   DISTINCT: Boolean
+  ids: [ID]
+  search: String
+  seller: ID
 }
 
 """Fields available for sorting warehouses"""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nautical-commerce/graphql-schema",
-  "version": "4.1.1",
+  "version": "4.2.0",
   "description": "Traide API GraphQL Schema",
   "main": "./nautical/schema.graphql",
   "scripts": {