@nautical-commerce/graphql-schema 2.27.0 → 2.28.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."""
@@ -9191,6 +9202,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 +12298,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 +12364,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 +12708,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: application/vnd.oasis.opendocument.spreadsheet, image/bmp, application/vnd.openxmlformats-officedocument.presentationml.presentation, image/gif, application/jpg, drawing/dwg, text/svg-xml, text/x-comma-separated-values, application/tiff, application/x-eps, application/rtf, image/webp, image/heic-sequence, application/vnd.oasis.opendocument.text, application/excel, image/svg+xml, application/x-dxf, image/dxf, image/x-dxf, application/dwg, text/rtf, application/x-autocad, application/pdf, image/x-tif, image/jpeg, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-excel, image/jpg, application/x-zip-compressed, application/x-csv, application/x-acad, application/x-gzip, application/x-tif, application/acad, application/dxf, application/gzip, text/plain, application/zip, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/svg+xml, image/x-bmp, image/png, application/acrobat, pplication/vnd.rar, application/vnd.openxmlformats-officedocument.presentationml.slideshow, image/eps, application/postscript, drawing/x-dwf, application/gzip-compressed, text/csv, application/x-pdf, image/heif-sequence, image/heic, image/x-eps, application/vnd.pdf, image/x-dwg, image/svg, application/csv, text/pdf, application/vnd.ms-powerpoint, application/x-rtf, application/x-jpg, application/x-rar-compressed, application/vnd.ms-word, image/x-ms-bmp, application/x-rar, text/svg, image/heif, text/x-pdf, drawing/x-dwg, application/x-tar, application/msword, application/vnd.oasis.opendocument.presentation, application/x-dwg, application/x-tiff, image/vnd.dwg, image/x-tiff, image/tif, application/gzipped, text/comma-separated-values, application/eps, image/tiff, application/tif, text/x-csv.
     """
     file: Upload!
 

package/package.json

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