@nautical-commerce/graphql-schema 4.5.2 → 4.6.0

package/nautical/schema.graphql

@@ -175,6 +175,7 @@ enum AccountErrorCode {
   DELETE_STAFF_ACCOUNT
   DELETE_SUPERUSER_ACCOUNT
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   INVALID_PHONE
   INVALID_PASSWORD
@@ -602,6 +603,7 @@ type AgreementError {
 """An enumeration of possible error codes for agreement operations."""
 enum AgreementErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   PERMISSION_DENIED
@@ -1103,6 +1105,7 @@ enum AnalyticsExportErrorCode {
   INVALID_DATE_RANGE
   PERMISSION_DENIED
   EXPORT_TYPE_NOT_AVAILABLE
+  INTERNAL_ERROR
   INVALID
 }
 
@@ -1302,6 +1305,7 @@ type AppError {
 enum AppErrorCode {
   FORBIDDEN
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   INVALID_STATUS
   INVALID_PERMISSION
@@ -5458,6 +5462,7 @@ type DesignerError {
 enum DesignerErrorCode {
   CANNOT_ASSIGN_NODE
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED
@@ -5964,6 +5969,7 @@ enum DocumentErrorCode {
   NUMBER_NOT_SET
   INVALID_STATUS
   NOT_FOUND
+  INTERNAL_ERROR
   INVALID
   GRAPHQL_ERROR
   UNSUPPORTED_FILE_TYPE
@@ -6546,6 +6552,7 @@ type ExportError {
 """An enumeration of possible error codes for export operations."""
 enum ExportErrorCode {
   FORBIDDEN
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED
@@ -6792,6 +6799,7 @@ type FinancialError {
 """An enumeration of possible error codes for financial operations."""
 enum FinancialErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED
@@ -6994,6 +7002,15 @@ type FulfillmentCountableEdge {
   node: Fulfillment!
 }
 
+"""
+How a catalog entity is fulfilled (SPEC-029). Source of truth for isDigital/isShippingRequired, which are derived projections.
+"""
+enum FulfillmentKind {
+  SHIPMENT
+  DIGITAL_FILE
+  SERVICE
+}
+
 """Represents a line in a fulfillment."""
 type FulfillmentLine implements Node {
   """The Globally Unique ID of this object"""
@@ -7285,6 +7302,7 @@ type ImportError {
 """An enumeration of possible error codes for import operations."""
 enum ImportErrorCode {
   FORBIDDEN
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED
@@ -8242,6 +8260,11 @@ type MarketplaceConfiguration {
   """Supported countries for the marketplace."""
   supportedCountries: [String!]!
 
+  """
+  Which fulfillment kinds this marketplace allows on catalog entities (SPEC-029).
+  """
+  enabledFulfillmentKinds: [FulfillmentKind!]!
+
   """The default country for the marketplace."""
   defaultCountry: String!
 
@@ -8460,6 +8483,7 @@ An enumeration of possible error codes for marketplace configuration operations.
 """
 enum MarketplaceConfigurationErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
 }
 
@@ -8483,6 +8507,11 @@ input MarketplaceConfigurationInput {
   automaticFulfillmentDigitalProducts: Boolean = null
   defaultDigitalMaxDownloads: Int = null
   defaultDigitalUrlValidDays: Int = null
+
+  """
+  Which fulfillment kinds this marketplace allows on catalog entities (SPEC-029).
+  """
+  enabledFulfillmentKinds: [FulfillmentKind!] = null
   trackInventoryByDefault: Boolean = null
   name: String = null
   description: String = null
@@ -9148,6 +9177,7 @@ type MetadataError {
 """An enumeration of possible error codes for metadata operations."""
 enum MetadataErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   PERMISSION_DENIED
@@ -10578,6 +10608,7 @@ An enumeration of possible error codes for nautical configuration operations.
 """
 enum NauticalConfigurationErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
 }
 
@@ -11402,6 +11433,7 @@ type NauticalOrderLine implements Node & ObjectWithMetadata {
   variantName: String!
   productSku: String
   isShippingRequired: Boolean!
+  fulfillmentKind: OrdersNauticalOrderLineFulfillmentKindEnum!
   quantity: Int!
   quantityFulfilled: Int!
   currency: String!
@@ -11734,6 +11766,7 @@ type NotificationError {
 """An enumeration of possible error codes for notification operations."""
 enum NotificationErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   NOT_FOUND
   REQUIRED
   INVALID
@@ -12650,6 +12683,7 @@ type OrderLine implements Node & ObjectWithMetadata {
   variantName: String!
   productSku: String
   isShippingRequired: Boolean!
+  fulfillmentKind: OrderOrderLineFulfillmentKindEnum!
   quantity: Int!
   quantityFulfilled: Int!
   quantityDeclined: Int!
@@ -12817,6 +12851,36 @@ type OrderMetrics {
   bySeller: [PieChartSegment!]
 }
 
+"""order line | fulfillment kind"""
+enum OrderOrderLineFulfillmentKindEnum {
+  """Shipment"""
+  shipment
+
+  """Digital file"""
+  digital_file
+
+  """Service"""
+  service
+
+  """License key"""
+  license_key
+
+  """Code"""
+  code
+
+  """Gift card"""
+  gift_card
+
+  """External provisioning"""
+  external
+
+  """Booking"""
+  booking
+
+  """Ticket"""
+  ticket
+}
+
 """Order source values."""
 enum OrderOrderSource {
   CHECKOUT
@@ -13119,6 +13183,36 @@ type OrdersByStatusType {
   count: Int
 }
 
+"""nautical order line | fulfillment kind"""
+enum OrdersNauticalOrderLineFulfillmentKindEnum {
+  """Shipment"""
+  shipment
+
+  """Digital file"""
+  digital_file
+
+  """Service"""
+  service
+
+  """License key"""
+  license_key
+
+  """Code"""
+  code
+
+  """Gift card"""
+  gift_card
+
+  """External provisioning"""
+  external
+
+  """Booking"""
+  booking
+
+  """Ticket"""
+  ticket
+}
+
 """
 A static page that can be manually added by a shop operator through the dashboard.
 """
@@ -13219,6 +13313,7 @@ type PageError {
 """An enumeration of possible error codes for page operations."""
 enum PageErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED
@@ -14026,6 +14121,7 @@ enum PermissionGroupErrorCode {
   ASSIGN_NON_STAFF_MEMBER
   DUPLICATED_INPUT_ITEM
   CANNOT_REMOVE_FROM_LAST_GROUP
+  INTERNAL_ERROR
   LEFT_NOT_MANAGEABLE_PERMISSION
   OUT_OF_SCOPE_PERMISSION
   OUT_OF_SCOPE_USER
@@ -14375,6 +14471,7 @@ type PolicyError {
 """An enumeration of possible error codes for policy operations."""
 enum PolicyErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED
@@ -14582,6 +14679,11 @@ type Product implements Node & ObjectWithMetadata {
   """
   timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
 
+  """
+  Typed fulfillment kind (SPEC-029) — source of truth for isDigital/isShippingRequired
+  """
+  fulfillmentKind: FulfillmentKind!
+
   """Sort order of the product"""
   sortOrder: Int
 
@@ -14885,6 +14987,11 @@ input ProductBulkCreateInput {
   """Set whether this product is digital."""
   isDigital: Boolean = null
 
+  """
+  Typed fulfillment kind (SPEC-029). Takes precedence over isDigital/isShippingRequired.
+  """
+  fulfillmentKind: FulfillmentKind = null
+
   """Set whether this product allows price overrides."""
   isPriceOverrideAllowed: Boolean = null
   weight: WeightScalar = null
@@ -15081,6 +15188,11 @@ input ProductCreateInput {
   """
   isDigital: Boolean = null
 
+  """
+  Typed fulfillment kind (SPEC-029). Takes precedence over isDigital/isShippingRequired, which become derived projections of it.
+  """
+  fulfillmentKind: FulfillmentKind = null
+
   """
   Set whether this product allows price overrides by default, will be controlled by product type if provided.
   """
@@ -15226,7 +15338,7 @@ enum ProductFieldEnum {
 }
 
 """
-Product(id, publication_date, is_published, private_metadata, metadata, description, description_html, deleted_at, deleted_by_user, deleted_by_app, deletion_batch_uuid, external_id, external_source, external_inventory_id, tenant, seller, seo_title, seo_description, product_type, name, slug, search_vector, category, currency, minimal_variant_price_amount, updated_at, created_at, charge_taxes, weight, available_for_purchase, visible_in_listings, default_variant, cumulative_price_amount, override_price, override_currency, status, sub_status, is_price_override_allowed, is_shipping_required, is_digital, is_bundle, warnings, product_source, allow_seller_variants, minimal_variant_price, cumulative_price)
+Product(id, publication_date, is_published, private_metadata, metadata, description, description_html, deleted_at, deleted_by_user, deleted_by_app, deletion_batch_uuid, external_id, external_source, external_inventory_id, tenant, seller, seo_title, seo_description, product_type, name, slug, search_vector, category, currency, minimal_variant_price_amount, updated_at, created_at, charge_taxes, weight, available_for_purchase, visible_in_listings, default_variant, cumulative_price_amount, override_price, override_currency, status, sub_status, is_price_override_allowed, is_shipping_required, is_digital, fulfillment_kind, is_bundle, warnings, product_source, allow_seller_variants, minimal_variant_price, cumulative_price)
 """
 input ProductFilterInput {
   isPublished: Boolean
@@ -15564,6 +15676,11 @@ input ProductInput {
   """
   isDigital: Boolean = null
 
+  """
+  Typed fulfillment kind (SPEC-029). Takes precedence over isDigital/isShippingRequired, which become derived projections of it.
+  """
+  fulfillmentKind: FulfillmentKind = null
+
   """
   Set whether this product allows price overrides by default, will be controlled by product type if provided.
   """
@@ -15820,6 +15937,11 @@ type ProductType implements Node & ObjectWithMetadata {
     last: Int = null
   ): ProductTypeAuditEventCountableConnection!
 
+  """
+  Typed fulfillment kind (SPEC-029) — source of truth for isDigital/isShippingRequired
+  """
+  fulfillmentKind: FulfillmentKind!
+
   """Legacy indicator, always true"""
   hasVariants: Boolean!
 
@@ -15996,7 +16118,7 @@ enum ProductTypeEnum {
 }
 
 """
-ProductType(id, private_metadata, metadata, description, description_html, external_id, external_source, external_inventory_id, tenant, name, slug, is_shipping_required, is_locked, is_digital, externally_managed, weight, is_price_override_allowed, created_by)
+ProductType(id, private_metadata, metadata, description, description_html, external_id, external_source, external_inventory_id, tenant, name, slug, is_shipping_required, is_locked, is_digital, fulfillment_kind, externally_managed, weight, is_price_override_allowed, created_by)
 """
 input ProductTypeFilterInput {
   isDigital: Boolean
@@ -16022,6 +16144,7 @@ input ProductTypeInput {
   variantAttributes: [ID!] = null
   isShippingRequired: Boolean = null
   isDigital: Boolean = null
+  fulfillmentKind: FulfillmentKind = null
   weight: WeightScalar = null
   taxCode: String = null
 
@@ -16177,6 +16300,11 @@ type ProductVariant implements Node & ObjectWithMetadata {
   """
   currency: String!
 
+  """
+  Typed fulfillment kind (SPEC-029) — source of truth for isDigital/isShippingRequired
+  """
+  fulfillmentKind: FulfillmentKind!
+
   """Status of the variant"""
   status: ProductVariantStatus!
 
@@ -16404,6 +16532,11 @@ input ProductVariantBulkCreateInput {
   """Set whether this variant is digital."""
   isDigital: Boolean = null
 
+  """
+  Typed fulfillment kind (SPEC-029). Takes precedence over isDigital/isShippingRequired.
+  """
+  fulfillmentKind: FulfillmentKind = null
+
   """Set whether this variant allows price overrides."""
   isPriceOverrideAllowed: Boolean = null
 
@@ -16520,6 +16653,11 @@ input ProductVariantCreateInput {
   """
   isDigital: Boolean = null
 
+  """
+  Typed fulfillment kind (SPEC-029). Takes precedence over isDigital/isShippingRequired, which become derived projections of it.
+  """
+  fulfillmentKind: FulfillmentKind = null
+
   """
   Set whether this variant allows price overrides by default, will be overridden by product type attached to product if available.
   """
@@ -16552,7 +16690,7 @@ type ProductVariantDelete {
 }
 
 """
-ProductVariant(id, sort_order, private_metadata, metadata, created_at, updated_at, deleted_at, deleted_by_user, deleted_by_app, deletion_batch_uuid, external_id, external_source, external_inventory_id, tenant, seo_title, seo_description, sku, name, is_user_defined_name, nautical_stock_number, status, sub_status, currency, price_amount, product, track_inventory, cost_price_amount, weight, seller, published_at, is_published, override_currency, search_vector, allow_backorders, is_price_override_allowed, is_shipping_required, is_digital, warnings, price, cost_price)
+ProductVariant(id, sort_order, private_metadata, metadata, created_at, updated_at, deleted_at, deleted_by_user, deleted_by_app, deletion_batch_uuid, external_id, external_source, external_inventory_id, tenant, seo_title, seo_description, sku, name, is_user_defined_name, nautical_stock_number, status, sub_status, currency, price_amount, product, track_inventory, cost_price_amount, weight, seller, published_at, is_published, override_currency, search_vector, allow_backorders, is_price_override_allowed, is_shipping_required, is_digital, fulfillment_kind, warnings, price, cost_price)
 """
 input ProductVariantFilterInput {
   isPublished: Boolean
@@ -16689,6 +16827,11 @@ input ProductVariantInput {
   """
   isDigital: Boolean = null
 
+  """
+  Typed fulfillment kind (SPEC-029). Takes precedence over isDigital/isShippingRequired, which become derived projections of it.
+  """
+  fulfillmentKind: FulfillmentKind = null
+
   """
   Set whether this variant allows price overrides by default, will be overridden by product type attached to product if available.
   """
@@ -17087,6 +17230,7 @@ enum ProductWarningEnum {
   VARIANT_ATTRIBUTE_VALUE_REQUIRED
   DEFAULT_VARIANT_REQUIRED
   SELLER_PAUSED
+  SELLER_DIGITAL_SUSPENDED
 }
 
 """Result of products export mutation."""
@@ -19562,6 +19706,9 @@ type Seller implements Node & ObjectWithMetadata {
   """List of seller identification values (e.g., tax IDs)"""
   identification: [String!]
 
+  """Whether this seller may sell digital-kind products (SPEC-029)"""
+  digitalSalesStatus: SellersSellerDigitalSalesStatusEnum!
+
   """Reason for agreement decision"""
   agreementDecisionReason: String!
 
@@ -20133,6 +20280,15 @@ type SellerDataUpdate {
   sellerErrors: [SellerError!]!
 }
 
+"""
+Whether a seller may sell digital-kind products (SPEC-029). SUSPENDED unpublishes the seller's digital products with a stamped warning.
+"""
+enum SellerDigitalSalesStatus {
+  NOT_REQUESTED
+  APPROVED
+  SUSPENDED
+}
+
 """Represents errors from seller operations."""
 type SellerError {
   field: String
@@ -20223,7 +20379,7 @@ 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)
+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, digital_sales_status, agreement_decision_reason, banner, store_description, external_payouts_enabled, external_payout_schedule, external_payout_status_synced_at)
 """
 input SellerFilterInput {
   AND: SellerFilterInput
@@ -20637,6 +20793,11 @@ input SellerUpdateInput {
   """New seller status"""
   status: String = null
 
+  """
+  Whether this seller may sell digital-kind products (SPEC-029). Requires MANAGE_MARKETPLACE. SUSPENDED unpublishes the seller's digital products with a stamped warning.
+  """
+  digitalSalesStatus: SellerDigitalSalesStatus = null
+
   """ID of user to set as owner"""
   user: ID = null
 
@@ -20727,6 +20888,18 @@ type SellerWithOwnerCreate {
   sellerErrors: [SellerError!]!
 }
 
+"""seller | digital sales status"""
+enum SellersSellerDigitalSalesStatusEnum {
+  """Not Requested"""
+  NOT_REQUESTED
+
+  """Approved"""
+  APPROVED
+
+  """Suspended"""
+  SUSPENDED
+}
+
 input SeoInput {
   title: String = null
   description: String = null
@@ -21147,6 +21320,7 @@ enum ShopErrorCode {
   ALREADY_EXISTS
   CANNOT_FETCH_TAX_RATES
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   PERMISSION_DENIED
@@ -23747,6 +23921,7 @@ enum WarehouseErrorCode {
   ALREADY_EXISTS
   FORBIDDEN
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED
@@ -23937,6 +24112,7 @@ type WebhookError {
 """An enumeration of possible error codes for webhook operations."""
 enum WebhookErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED

package/package.json

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