@nautical-commerce/graphql-schema 2.27.0 → 2.29.0

package/nautical/schema.graphql

@@ -1728,6 +1728,17 @@ type Query {
     sellerId: ID
   ): SalesMetrics
 
+  """
+  Get sales velocity metrics (30/60/90 day windows) for product variants. Shows units sold and sales amount for each time window, plus current inventory. Useful for inventory planning and identifying fast/slow-moving products. Automatically filtered by seller for seller staff users.
+  """
+  salesVelocity(
+    """Maximum number of items to return"""
+    first: Int = 50
+
+    """Number of items to skip (for pagination)"""
+    offset: Int = 0
+  ): SalesVelocityReport
+
   """Look up a marketplace agreement by ID or slug."""
   agreement(
     """ID of the marketplace agreement."""
@@ -2810,6 +2821,11 @@ type Product implements Node & ObjectWithMetadata {
   isDigital: Boolean!
   productSource: ProductProductSource!
 
+  """
+  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!
+
   """
   List of private metadata items.Requires proper staff permissions to access.
   """
@@ -3213,6 +3229,11 @@ type MarketplaceConfiguration {
   """Determines scope for checking duplicated variant attribute sets"""
   variantUniqueness: VariantUniquenessEnum
 
+  """
+  Whether cross-sell products feature is enabled. When True, sellers can create variants on other sellers' products (if the product allows it).
+  """
+  enableMasterProducts: Boolean!
+
   """Returns list of default checklists for seller."""
   defaultSellerChecklists: [DefaultSellerChecklist!]!
   enableStockAllocationForDrafts: Boolean!
@@ -4886,6 +4907,7 @@ input ProductFilterInput {
   sellers: [ID]
   subStatus: ProductSubStatusEnum
   slug: [String!]
+  allowSellerVariants: Boolean
   price: PriceRangeInput
   minimalPrice: PriceRangeInput
   createdAt: DateTimeRangeInput
@@ -9191,6 +9213,12 @@ type Plugin implements Node {
   description: String!
   active: Boolean!
   configuration: [ConfigurationItem!]
+  seller: Seller
+
+  """
+  Optional custom field mappings for webhook ingestion. Format: {'product': [...], 'variant': [...], 'image': [...]} where each list contains FieldMapping configurations. If null, uses default mappings from plugin.
+  """
+  customFieldMappings: JSONString
   company: String
   category: PluginConfigurationCategory
   descriptionShort: String!
@@ -12281,6 +12309,9 @@ type OrderMetrics {
 
   """Orders broken down by status for pie chart"""
   statusBreakdown: [PieChartSegment!]!
+
+  """Orders broken down by seller (MPO only)"""
+  bySeller: [PieChartSegment!]
 }
 
 """Represents a single point in time-series data for charts"""
@@ -12344,6 +12375,63 @@ type SalesMetrics {
 
   """Sales broken down by product category"""
   byCategory: [PieChartSegment!]!
+
+  """Sales broken down by product variant (Seller only)"""
+  byVariant: [PieChartSegment!]
+}
+
+"""Sales velocity report for inventory planning"""
+type SalesVelocityReport {
+  """List of variants with sales velocity metrics"""
+  items: [SalesVelocityItem!]!
+
+  """Total number of variants"""
+  totalCount: Int!
+
+  """Currency code for sales figures"""
+  currency: String!
+}
+
+"""Sales velocity metrics for inventory planning (30/60/90 day windows)"""
+type SalesVelocityItem {
+  """Global ID of the product variant"""
+  variantId: ID!
+
+  """Name of the variant"""
+  variantName: String!
+
+  """Name of the parent product"""
+  productName: String!
+
+  """SKU of the variant"""
+  sku: String
+
+  """Name of the seller (MPO only)"""
+  sellerName: String
+
+  """Current inventory quantity across all warehouses"""
+  currentQuantity: Int!
+
+  """Currency code for sales figures"""
+  currency: String!
+
+  """Units sold in last 30 days"""
+  sold30d: Int!
+
+  """Sales amount in last 30 days"""
+  sales30d: Decimal!
+
+  """Units sold in last 60 days"""
+  sold60d: Int!
+
+  """Sales amount in last 60 days"""
+  sales60d: Decimal!
+
+  """Units sold in last 90 days"""
+  sold90d: Int!
+
+  """Sales amount in last 90 days"""
+  sales90d: Decimal!
 }
 
 type AgreementCountableConnection {
@@ -12631,7 +12719,7 @@ type Mutation {
     description: String
 
     """
-    Used when uploading a new document or file in a multipart request that does not exist in the system already. Supported file types: text/svg-xml, application/x-dwg, image/tif, application/vnd.openxmlformats-officedocument.wordprocessingml.document, text/x-pdf, application/tiff, drawing/dwg, text/rtf, application/acad, application/dxf, image/heif-sequence, application/x-gzip, image/jpeg, application/vnd.ms-powerpoint, image/heic-sequence, text/csv, application/eps, application/csv, application/x-rtf, text/x-comma-separated-values, text/pdf, application/jpg, application/acrobat, image/tiff, application/gzip, application/x-pdf, image/eps, application/x-autocad, image/x-eps, application/zip, image/x-tif, image/x-dxf, application/x-dxf, application/vnd.ms-excel, application/svg+xml, application/dwg, application/x-eps, application/gzip-compressed, application/pdf, image/dxf, drawing/x-dwf, application/x-jpg, application/gzipped, application/vnd.openxmlformats-officedocument.presentationml.slideshow, image/x-tiff, text/x-csv, application/x-tiff, image/jpg, application/excel, application/msword, application/x-tif, application/vnd.openxmlformats-officedocument.presentationml.presentation, image/png, application/x-tar, image/x-bmp, text/comma-separated-values, image/heif, application/x-rar, text/plain, image/gif, application/x-zip-compressed, application/rtf, image/x-dwg, image/bmp, text/svg, image/svg, application/x-acad, application/tif, pplication/vnd.rar, application/x-rar-compressed, image/x-ms-bmp, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.oasis.opendocument.presentation, application/postscript, application/x-csv, image/heic, drawing/x-dwg, application/vnd.oasis.opendocument.spreadsheet, application/vnd.ms-word, image/webp, image/svg+xml, image/vnd.dwg, application/vnd.oasis.opendocument.text, application/vnd.pdf.
+    Used when uploading a new document or file in a multipart request that does not exist in the system already. Supported file types: image/heif, application/vnd.pdf, image/heif-sequence, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/acad, application/svg+xml, application/vnd.ms-excel, application/x-eps, application/x-tif, application/x-pdf, image/eps, text/rtf, image/heic, image/vnd.dwg, application/vnd.openxmlformats-officedocument.presentationml.slideshow, application/x-acad, application/tiff, application/x-rar, application/rtf, application/vnd.oasis.opendocument.text, image/tif, application/excel, application/x-gzip, application/x-rar-compressed, application/x-zip-compressed, application/vnd.oasis.opendocument.presentation, image/x-dxf, application/zip, drawing/x-dwf, drawing/dwg, image/svg, image/x-tiff, application/x-tiff, image/tiff, text/svg, application/eps, image/x-ms-bmp, application/vnd.openxmlformats-officedocument.presentationml.presentation, image/x-tif, application/dwg, application/jpg, image/gif, text/x-csv, application/vnd.oasis.opendocument.spreadsheet, image/dxf, text/csv, image/x-bmp, image/jpg, text/comma-separated-values, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/csv, application/x-tar, image/x-eps, image/jpeg, application/dxf, application/gzip-compressed, application/x-csv, application/vnd.ms-word, image/webp, application/x-dxf, application/gzipped, application/pdf, application/vnd.ms-powerpoint, image/x-dwg, application/tif, image/png, image/svg+xml, application/postscript, text/pdf, application/msword, text/plain, text/svg-xml, application/x-autocad, application/acrobat, application/x-rtf, application/x-dwg, application/x-jpg, drawing/x-dwg, pplication/vnd.rar, image/heic-sequence, image/bmp, application/gzip, text/x-pdf, text/x-comma-separated-values.
     """
     file: Upload!
 
@@ -15921,6 +16009,11 @@ input MarketplaceConfigurationInput {
   """Determines scope for checking duplicated variant attribute sets"""
   variantUniqueness: VariantUniquenessEnum = null
 
+  """
+  Enable cross-sell products feature. When enabled, sellers can create variants on other sellers' products (if the product allows it). Requires variant_uniqueness to be UNIQUE_PER_SELLER.
+  """
+  enableMasterProducts: Boolean
+
   """List of all default checklists for seller."""
   defaultSellerChecklists: [DefaultSellerChecklistInput!]
 
@@ -18230,6 +18323,11 @@ input ProductCreateInput {
   """Product dimensions."""
   dimensions: ProductDimensionsInput
 
+  """
+  When enabled, other sellers can create their own variants on this product (cross-sell). Requires marketplace-level enable_master_products to be True. Only the product owner can modify this setting.
+  """
+  allowSellerVariants: Boolean
+
   """ID of the seller that product belongs to."""
   seller: ID!
 
@@ -18454,6 +18552,11 @@ input ProductBulkCreateInput {
   """Product dimensions."""
   dimensions: ProductDimensionsInput
 
+  """
+  When enabled, other sellers can create their own variants on this product (cross-sell). Requires marketplace-level enable_master_products to be True. Only the product owner can modify this setting.
+  """
+  allowSellerVariants: Boolean
+
   """ID of the seller that product belongs to."""
   seller: ID!
 
@@ -18627,6 +18730,11 @@ input ProductInput {
 
   """Product dimensions."""
   dimensions: ProductDimensionsInput
+
+  """
+  When enabled, other sellers can create their own variants on this product (cross-sell). Requires marketplace-level enable_master_products to be True. Only the product owner can modify this setting.
+  """
+  allowSellerVariants: Boolean
 }
 
 """Set product availability for purchase date."""

package/package.json

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