@nautical-commerce/graphql-schema 2.17.0 → 2.18.0

package/nautical/schema.graphql

@@ -178,7 +178,9 @@ type Query {
     last: Int
   ): WebhookEventLogCountableConnection
 
-  """List of webhook jobs"""
+  """
+  List of webhook jobs (legacy system - use shopifyWebhookTransactions for Shopify)
+  """
   webhookJobs(
     """Filtering options for webhook jobs"""
     filter: WebhookJobFilterInput
@@ -202,6 +204,32 @@ type Query {
     last: Int
   ): WebhookJobCountableConnection
 
+  """
+  List of Shopify webhook transactions from the new plugin-based architecture. Provides better debugging and tracking than the legacy webhookJobs query. Use this for all new Shopify webhook monitoring.
+  """
+  shopifyWebhookTransactions(
+    """Filtering options for Shopify webhook transactions"""
+    filter: ShopifyWebhookTransactionFilterInput
+
+    """Sort Shopify webhook transactions"""
+    sortBy: ShopifyWebhookTransactionSortingInput
+
+    """Seller global ID to filter by"""
+    sellerId: ID
+
+    """Return the elements in the list that come before the specified cursor."""
+    before: String
+
+    """Return the elements in the list that come after the specified cursor."""
+    after: String
+
+    """Return the first n elements from the list."""
+    first: Int
+
+    """Return the last n elements from the list."""
+    last: Int
+  ): ShopifyWebhookTransactionCountableConnection
+
   """Look up a warehouse by ID."""
   warehouse(
     """ID of an warehouse"""
@@ -1487,6 +1515,33 @@ type Query {
     last: Int
   ): ExportFileCountableConnection
 
+  """Look up an import file by ID."""
+  importFile(
+    """ID of the import file job."""
+    id: ID!
+  ): ImportFile
+
+  """List of import files."""
+  importFiles(
+    """Filtering options for import files."""
+    filter: ImportFileFilterInput
+
+    """Sort import files."""
+    sortBy: ImportFileSortingInput
+
+    """Return the elements in the list that come before the specified cursor."""
+    before: String
+
+    """Return the elements in the list that come after the specified cursor."""
+    after: String
+
+    """Return the first n elements from the list."""
+    first: Int
+
+    """Return the last n elements from the list."""
+    last: Int
+  ): ImportFileCountableConnection
+
   """List of all tax rates available from tax gateway."""
   taxTypes: [TaxType!]!
 
@@ -2652,6 +2707,21 @@ type ProductVariant implements Node & ObjectWithMetadata {
   List of warnings for this product variant that needs to be resolved for publishing.
   """
   warnings: [WarningMessageItem!]!
+
+  """Webhook events related to this variant"""
+  webhookHistory(
+    """Return the elements in the list that come before the specified cursor."""
+    before: String
+
+    """Return the elements in the list that come after the specified cursor."""
+    after: String
+
+    """Return the first n elements from the list."""
+    first: Int
+
+    """Return the last n elements from the list."""
+    last: Int
+  ): WebhookJobCountableConnection
 }
 
 """An enumeration."""
@@ -2838,6 +2908,21 @@ type Product implements Node & ObjectWithMetadata {
 
   """Displays whether the product has warnings or not."""
   hasWarnings: Boolean
+
+  """Webhook events related to this product"""
+  webhookHistory(
+    """Return the elements in the list that come before the specified cursor."""
+    before: String
+
+    """Return the elements in the list that come after the specified cursor."""
+    after: String
+
+    """Return the first n elements from the list."""
+    first: Int
+
+    """Return the last n elements from the list."""
+    last: Int
+  ): WebhookJobCountableConnection
 }
 
 """
@@ -4836,6 +4921,9 @@ enum ProductSubStatusEnum {
 
   """Approved"""
   APPROVED
+
+  """Incomplete data"""
+  INCOMPLETE_DATA
 }
 
 input PriceRangeInput {
@@ -7097,6 +7185,9 @@ enum ProductSubStatus {
 
   """Approved"""
   APPROVED
+
+  """Incomplete data"""
+  INCOMPLETE_DATA
 }
 
 """An enumeration."""
@@ -7299,6 +7390,187 @@ enum ProductWarningEnum {
   DEFAULT_VARIANT_REQUIRED
 }
 
+type WebhookJobCountableConnection {
+  """Pagination data for this connection."""
+  pageInfo: PageInfo!
+  edges: [WebhookJobCountableEdge!]!
+
+  """A total count of items in the collection."""
+  totalCount: Int
+}
+
+type WebhookJobCountableEdge {
+  """The item at the end of the edge."""
+  node: WebhookJob!
+
+  """A cursor for use in pagination."""
+  cursor: String!
+}
+
+"""
+Represents incoming webhook transaction with comprehensive data preservation. New ELT-based approach ensures no data loss and supports partial success states.
+"""
+type WebhookJob implements Node & Job {
+  """The ID of the object"""
+  id: ID!
+
+  """Job status."""
+  status: JobStatusEnum!
+
+  """Job message."""
+  message: String
+
+  """Created date time of job in ISO 8601 format."""
+  createdAt: DateTime!
+
+  """Date time of job last update in ISO 8601 format."""
+  updatedAt: DateTime!
+  tenant: Tenant!
+
+  """Original webhook payload (legacy field)"""
+  body: JSONString
+
+  """Request headers and metadata"""
+  requestMeta: JSONString
+
+  """Webhook source (e.g., 'shopify')"""
+  source: String
+
+  """Normalized event type"""
+  type: GenericWebhookTransactionType
+
+  """Link to vendor entity. DEPRECATED: No longer used."""
+  vendorEntityLink: String @deprecated(reason: "This will be removed on September 26, 2025")
+
+  """
+  Link to marketplace entity (e.g., /products/123). DEPRECATED: Use entities_created instead.
+  """
+  marketplaceEntityLink: String @deprecated(reason: "This will be removed on September 26, 2025")
+
+  """Seller associated with this webhook"""
+  seller: Seller
+
+  """
+  Complete unmodified webhook payload. Preserves all fields from external system, including unmapped ones. Use this for debugging or accessing fields not yet mapped to Nautical.
+  """
+  rawPayload: JSONString
+
+  """
+  Data after field mapping transformation applied. Shows what values were extracted from raw_payload and how they were transformed. Compare with validation_errors to see which fields had issues.
+  """
+  mappedData: JSONString
+
+  """
+  Fields from webhook that don't have Nautical field mappings. Preserved for future use. If you see important data here, request a custom field mapping configuration.
+  """
+  unmappedFields: JSONString
+
+  """
+  Per-field validation errors with severity levels. Format: {field_name: {message, severity, value}}. Severity: 'warning' (non-critical), 'error' (needs fixing), 'critical' (blocks creation).
+  """
+  validationErrors: JSONString
+
+  """
+  Version of field mapping configuration used (e.g., '1.0.0'). Used to track schema evolution. If mappings change, you can identify which webhooks used old vs new mappings.
+  """
+  fieldMappingVersion: String
+
+  """
+  Additional processing context. Includes: ingestion_method, start_time, end_time, entities_created_count, entities_failed_count. Useful for performance analysis and debugging.
+  """
+  processingMetadata: JSONString
+
+  """
+  List of successfully created entities. Format: ['product:123', 'variant:456', 'image:789']. Use this to track what was created from the webhook.
+  """
+  entitiesCreated: [String]
+
+  """
+  List of entities that failed creation with error details. Format: [{type, error, details}]. Review this to understand why some entities couldn't be created.
+  """
+  entitiesFailed: JSONString
+
+  """
+  True if webhook processing succeeded for some but not all entities. Example: Product created but 2 out of 5 images failed. Check entities_failed for details on what went wrong.
+  """
+  isPartialSuccess: Boolean
+}
+
+"""An enumeration."""
+enum GenericWebhookTransactionType {
+  """A payload for order update was received"""
+  ORDER_UPDATE
+
+  """A payload for order cancel was received"""
+  ORDER_CANCEL
+
+  """A payload for product create was received."""
+  PRODUCT_CREATE
+
+  """A payload for product update was received."""
+  PRODUCT_UPDATE
+
+  """A payload for product delete was received."""
+  PRODUCT_DELETE
+
+  """A payload for product inventory tracking update was received."""
+  INVENTORY_TRACKING_UPDATE
+
+  """A payload for stock create was received."""
+  STOCK_CREATE
+
+  """A payload for stock update was received."""
+  STOCK_UPDATE
+
+  """A payload for stock delete was received."""
+  STOCK_DELETE
+
+  """A payload for warehouse create was received."""
+  WAREHOUSE_CREATE
+
+  """A payload for warehouse update was received."""
+  WAREHOUSE_UPDATE
+
+  """A payload for warehouse delete was received."""
+  WAREHOUSE_DELETE
+
+  """A payload for fulfillment create was received."""
+  FULFILLMENT_CREATE
+
+  """A payload for fulfillment update was received."""
+  FULFILLMENT_UPDATE
+
+  """A paylod for customer create was received"""
+  CUSTOMER_CREATE
+
+  """A payload for seller create was received"""
+  SELLER_CREATE
+
+  """Shopify store successfully connected"""
+  SHOPIFY_CONNECTION_ESTABLISHED
+
+  """Shopify store connection updated"""
+  SHOPIFY_CONNECTION_UPDATED
+
+  """Shopify store connection failed"""
+  SHOPIFY_CONNECTION_FAILED
+
+  """Shopify product import started"""
+  SHOPIFY_IMPORT_STARTED
+
+  """Shopify product import completed"""
+  SHOPIFY_IMPORT_COMPLETED
+
+  """Shopify product import failed"""
+  SHOPIFY_IMPORT_FAILED
+
+  """A payload for vehicles was received"""
+  VEHICLE_PAYLOAD
+
+  """A payload for item shipment that was received"""
+  ITEM_SHIP_NOTIFY
+}
+
 """Represents availability of a variant in the storefront."""
 type VariantPricingInfo {
   """Whether it is in sale or not."""
@@ -8197,51 +8469,34 @@ enum WebhookDirectionEnum {
   EMITTED
 }
 
-type WebhookJobCountableConnection {
-  """Pagination data for this connection."""
-  pageInfo: PageInfo!
-  edges: [WebhookJobCountableEdge!]!
-
-  """A total count of items in the collection."""
-  totalCount: Int
+input WebhookJobFilterInput {
+  status: [WebhookJobStatus!]
+  search: String
+  source: [WebhookJobSource!]
+  type: [WebhookJobType!] @deprecated(reason: "This will be removed on September 3, 2025. Use webhook_event_type instead")
+  createdAt: DateTime
+  created: DateRangeInput
+  webhookEventType: [GenericWebhookEventsEnum!]
 }
 
-type WebhookJobCountableEdge {
-  """The item at the end of the edge."""
-  node: WebhookJob!
-
-  """A cursor for use in pagination."""
-  cursor: String!
+enum WebhookJobStatus {
+  SUCCESS
+  FAILED
+  PENDING
+  DELETED
 }
 
-"""Represents job data of incoming webhook."""
-type WebhookJob implements Node & Job {
-  """The ID of the object"""
-  id: ID!
-
-  """Job status."""
-  status: JobStatusEnum!
-
-  """Job message."""
-  message: String
-
-  """Created date time of job in ISO 8601 format."""
-  createdAt: DateTime!
+enum WebhookJobSource {
+  DEFAULT
+  SHOPIFY
+}
 
-  """Date time of job last update in ISO 8601 format."""
-  updatedAt: DateTime!
-  tenant: Tenant!
-  body: JSONString
-  requestMeta: JSONString
-  source: String
-  type: GenericWebhookTransactionType
-  vendorEntityLink: String @deprecated(reason: "This will be removed on September 26, 2025")
-  marketplaceEntityLink: String @deprecated(reason: "This will be removed on September 26, 2025")
-  seller: Seller
+enum WebhookJobType {
+  ORDER_CREATE
+  ORDER_UPDATE
 }
 
-"""An enumeration."""
-enum GenericWebhookTransactionType {
+enum GenericWebhookEventsEnum {
   """A payload for order update was received"""
   ORDER_UPDATE
 
@@ -8309,133 +8564,190 @@ enum GenericWebhookTransactionType {
   SHOPIFY_IMPORT_FAILED
 
   """A payload for vehicles was received"""
-  VEHICLE_PAYLOAD
+  VEHICLE_PAYLOAD @deprecated(reason: "This will be removed on September 26, 2025")
 
   """A payload for item shipment that was received"""
   ITEM_SHIP_NOTIFY
 }
 
-input WebhookJobFilterInput {
-  status: [WebhookJobStatus!]
-  search: String
-  source: [WebhookJobSource!]
-  type: [WebhookJobType!] @deprecated(reason: "This will be removed on September 3, 2025. Use webhook_event_type instead")
-  createdAt: DateTime
-  created: DateRangeInput
-  webhookEventType: [GenericWebhookEventsEnum!]
-}
+input WebhookJobSortingInput {
+  """Specifies the direction in which to sort products."""
+  direction: OrderDirection!
 
-enum WebhookJobStatus {
-  SUCCESS
-  FAILED
-  PENDING
-  DELETED
+  """Sort webhook_jobs by the selected field."""
+  field: WebhookJobSortField!
 }
 
-enum WebhookJobSource {
-  DEFAULT
-  SHOPIFY
-}
+enum WebhookJobSortField {
+  """Sort webhook jobs by source."""
+  SOURCE
 
-enum WebhookJobType {
-  ORDER_CREATE
-  ORDER_UPDATE
+  """Sort webhook jobs by type."""
+  TYPE
+
+  """Sort webhook jobs by status."""
+  STATUS
+
+  """Sort webhook jobs by created at."""
+  CREATED_AT
 }
 
-enum GenericWebhookEventsEnum {
-  """A payload for order update was received"""
-  ORDER_UPDATE
+type ShopifyWebhookTransactionCountableConnection {
+  """Pagination data for this connection."""
+  pageInfo: PageInfo!
+  edges: [ShopifyWebhookTransactionCountableEdge!]!
 
-  """A payload for order cancel was received"""
-  ORDER_CANCEL
+  """A total count of items in the collection."""
+  totalCount: Int
+}
 
-  """A payload for product create was received."""
-  PRODUCT_CREATE
+type ShopifyWebhookTransactionCountableEdge {
+  """The item at the end of the edge."""
+  node: ShopifyWebhookTransaction!
 
-  """A payload for product update was received."""
-  PRODUCT_UPDATE
+  """A cursor for use in pagination."""
+  cursor: String!
+}
 
-  """A payload for product delete was received."""
-  PRODUCT_DELETE
+"""
+Shopify webhook transaction from the new plugin-based architecture. Uses synchronous processing (no Celery queue bugs) and preserves all Shopify data for debugging and future field mapping updates.
+"""
+type ShopifyWebhookTransaction implements Node & Job {
+  """The ID of the object"""
+  id: ID!
 
-  """A payload for product inventory tracking update was received."""
-  INVENTORY_TRACKING_UPDATE
+  """Job status."""
+  status: JobStatusEnum!
 
-  """A payload for stock create was received."""
-  STOCK_CREATE
+  """Job message."""
+  message: String
 
-  """A payload for stock update was received."""
-  STOCK_UPDATE
+  """Created date time of job in ISO 8601 format."""
+  createdAt: DateTime!
 
-  """A payload for stock delete was received."""
-  STOCK_DELETE
+  """Date time of job last update in ISO 8601 format."""
+  updatedAt: DateTime!
+  tenant: Tenant!
 
-  """A payload for warehouse create was received."""
-  WAREHOUSE_CREATE
+  """Seller associated with this webhook"""
+  seller: Seller!
 
-  """A payload for warehouse update was received."""
-  WAREHOUSE_UPDATE
+  """
+  Shopify event type (e.g., 'products/create', 'inventory_levels/update')
+  """
+  eventType: String
 
-  """A payload for warehouse delete was received."""
-  WAREHOUSE_DELETE
+  """Shop domain that sent the webhook (e.g., 'my-store.myshopify.com')"""
+  shopifyDomain: String
 
-  """A payload for fulfillment create was received."""
-  FULFILLMENT_CREATE
+  """Shopify's webhook ID from X-Shopify-Webhook-Id header"""
+  shopifyWebhookId: String
 
-  """A payload for fulfillment update was received."""
-  FULFILLMENT_UPDATE
+  """
+  Complete unmodified Shopify webhook payload. Preserves ALL fields from Shopify, including unmapped ones. Use this for debugging or accessing fields not yet in Nautical schema.
+  """
+  rawPayload: JSONString
 
-  """A paylod for customer create was received"""
-  CUSTOMER_CREATE
+  """
+  Data after field mapping transformation applied. Shows what values were extracted from raw_payload and how they were transformed to Nautical format. Compare with validation_errors to see which fields had issues.
+  """
+  mappedData: JSONString
 
-  """A payload for seller create was received"""
-  SELLER_CREATE
+  """
+  Shopify fields that don't have Nautical field mappings. Preserved for future use. If you see important data here, you can configure custom field mappings in your plugin settings.
+  """
+  unmappedFields: JSONString
 
-  """Shopify store successfully connected"""
-  SHOPIFY_CONNECTION_ESTABLISHED
+  """
+  Version of Shopify field mapping configuration used (e.g., '1.0.0'). Used to track schema evolution. If mappings change, you can identify which webhooks used old vs new mappings.
+  """
+  fieldMappingVersion: String
 
-  """Shopify store connection updated"""
-  SHOPIFY_CONNECTION_UPDATED
+  """
+  Shopify-specific processing context. Includes: API version, processing time, retry count, etc. Useful for performance analysis and debugging.
+  """
+  processingMetadata: JSONString
 
-  """Shopify store connection failed"""
-  SHOPIFY_CONNECTION_FAILED
+  """
+  Per-field validation errors with severity levels. Format: {field_name: {message, severity, value}}. Severity: 'warning' (non-critical), 'error' (needs fixing), 'critical' (blocks creation).
+  """
+  validationErrors: JSONString
 
-  """Shopify product import started"""
-  SHOPIFY_IMPORT_STARTED
+  """
+  List of successfully created entities. Format: ['product:uuid-123', 'variant:uuid-456', 'stock:uuid-789']. Use this to track what Nautical entities were created from the Shopify webhook.
+  """
+  entitiesCreated: [String]
 
-  """Shopify product import completed"""
-  SHOPIFY_IMPORT_COMPLETED
+  """
+  List of entities that failed creation with error details. Format: [{type, shopify_id, error, details}]. Review this to understand why some entities couldn't be created.
+  """
+  entitiesFailed: JSONString
 
-  """Shopify product import failed"""
-  SHOPIFY_IMPORT_FAILED
+  """
+  True if webhook processing succeeded for some but not all entities. Example: Product created but 2 out of 5 variants failed validation. Check entities_failed for details on what went wrong.
+  """
+  isPartialSuccess: Boolean
 
-  """A payload for vehicles was received"""
-  VEHICLE_PAYLOAD @deprecated(reason: "This will be removed on September 26, 2025")
+  """
+  Link to primary created marketplace entity (e.g., '/products/123'). Use this to navigate directly to the created entity in the Dashboard.
+  """
+  marketplaceEntityLink: String
+}
 
-  """A payload for item shipment that was received"""
-  ITEM_SHIP_NOTIFY
+input ShopifyWebhookTransactionFilterInput {
+  status: [WebhookJobStatus!]
+  eventType: [ShopifyEventType!]
+  shopifyDomain: String
+  isPartialSuccess: Boolean
+  createdAt: DateTime
+  search: String
+  created: DateRangeInput
 }
 
-input WebhookJobSortingInput {
+"""Shopify webhook event types (new plugin-based architecture)."""
+enum ShopifyEventType {
+  PRODUCTS_CREATE
+  PRODUCTS_UPDATE
+  PRODUCTS_DELETE
+  INVENTORY_LEVELS_UPDATE
+  INVENTORY_LEVELS_CONNECT
+  INVENTORY_LEVELS_DISCONNECT
+  LOCATIONS_CREATE
+  LOCATIONS_UPDATE
+  LOCATIONS_DELETE
+  ORDERS_CANCELLED
+  FULFILLMENTS_CREATE
+  FULFILLMENTS_UPDATE
+}
+
+"""Sorting options for Shopify webhook transactions."""
+input ShopifyWebhookTransactionSortingInput {
   """Specifies the direction in which to sort products."""
   direction: OrderDirection!
 
-  """Sort webhook_jobs by the selected field."""
-  field: WebhookJobSortField!
+  """Sort shopify_webhook_transactions by the selected field."""
+  field: ShopifyWebhookTransactionSortField!
 }
 
-enum WebhookJobSortField {
-  """Sort webhook jobs by source."""
-  SOURCE
-
-  """Sort webhook jobs by type."""
-  TYPE
+"""Sort fields for Shopify webhook transactions."""
+enum ShopifyWebhookTransactionSortField {
+  """Sort by Shopify event type (e.g., products/create)"""
+  EVENT_TYPE
 
-  """Sort webhook jobs by status."""
+  """Sort by processing status (pending, processing, success, failed)"""
   STATUS
 
-  """Sort webhook jobs by created at."""
+  """Sort by webhook received timestamp"""
   CREATED_AT
+
+  """Sort by last update timestamp"""
+  UPDATED_AT
+
+  """Sort by shop domain"""
+  SHOPIFY_DOMAIN
+
+  """Sort by partial success state"""
+  IS_PARTIAL_SUCCESS
 }
 
 input WarehouseFilterInput {
@@ -11579,6 +11891,114 @@ enum ExportFileSortField {
   UPDATED_AT
 }
 
+"""Represents a job data of exported file."""
+type ImportFile implements Node & Job {
+  """The ID of the object"""
+  id: ID!
+  user: User
+  app: App
+
+  """Job status."""
+  status: JobStatusEnum!
+
+  """Created date time of job in ISO 8601 format."""
+  createdAt: DateTime!
+
+  """Date time of job last update in ISO 8601 format."""
+  updatedAt: DateTime!
+
+  """Job message."""
+  message: String
+
+  """The URL of file to download."""
+  url: String
+
+  """List of events associated with the import."""
+  events: [ImportEvent!]
+}
+
+"""History log of import file."""
+type ImportEvent implements Node {
+  """The ID of the object"""
+  id: ID!
+
+  """Date when event happened at in ISO 8601 format."""
+  date: DateTime!
+
+  """Import event type."""
+  type: ImportEventsEnum!
+
+  """User who performed the action."""
+  user: User
+
+  """App which performed the action."""
+  app: App
+
+  """Content of the event."""
+  message: String!
+}
+
+enum ImportEventsEnum {
+  """Data import was started."""
+  IMPORT_PENDING
+
+  """Data import was completed successfully."""
+  IMPORT_SUCCESS
+
+  """Import Failed"""
+  IMPORT_FAILED
+
+  """Data import failed."""
+  IMPORT_DELETED
+
+  """Import file was deleted."""
+  IMPORTED_FILE_SENT
+}
+
+type ImportFileCountableConnection {
+  """Pagination data for this connection."""
+  pageInfo: PageInfo!
+  edges: [ImportFileCountableEdge!]!
+
+  """A total count of items in the collection."""
+  totalCount: Int
+}
+
+type ImportFileCountableEdge {
+  """The item at the end of the edge."""
+  node: ImportFile!
+
+  """A cursor for use in pagination."""
+  cursor: String!
+}
+
+input ImportFileFilterInput {
+  createdAt: DateTimeRangeInput
+  updatedAt: DateTimeRangeInput
+  status: JobStatusEnum
+  user: String
+  app: String
+}
+
+input ImportFileSortingInput {
+  """Specifies the direction in which to sort products."""
+  direction: OrderDirection!
+
+  """Sort import file by the selected field."""
+  field: ImportFileSortField!
+}
+
+enum ImportFileSortField {
+  """Sort import file by status."""
+  STATUS
+
+  """Sort import file by created at."""
+  CREATED_AT
+
+  """Sort import file by updated at."""
+  UPDATED_AT
+}
+
 """Event object for all models."""
 type Event {
   """The unique identifier across all event tables."""
@@ -12084,7 +12504,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: application/vnd.openxmlformats-officedocument.wordprocessingml.document, image/heic-sequence, application/acad, image/heif-sequence, image/tif, application/eps, application/pdf, application/x-dxf, image/jpeg, image/heic, application/rtf, application/x-tiff, text/svg-xml, application/svg+xml, text/csv, image/svg, application/x-acad, application/zip, application/gzip, image/x-tif, application/x-dwg, application/x-rar-compressed, pplication/vnd.rar, application/x-tif, drawing/x-dwf, text/svg, application/tiff, image/bmp, image/x-dxf, application/x-rar, application/x-rtf, image/dxf, application/x-jpg, application/csv, application/x-gzip, drawing/dwg, image/x-bmp, image/jpg, application/jpg, application/vnd.oasis.opendocument.presentation, image/eps, application/acrobat, application/x-eps, application/excel, application/vnd.ms-word, application/vnd.ms-excel, application/x-autocad, image/x-eps, application/x-csv, application/vnd.pdf, application/dwg, application/vnd.openxmlformats-officedocument.presentationml.slideshow, text/comma-separated-values, application/vnd.openxmlformats-officedocument.presentationml.presentation, application/x-tar, text/x-comma-separated-values, text/x-csv, application/gzip-compressed, image/png, image/webp, image/tiff, image/vnd.dwg, image/svg+xml, text/pdf, application/tif, application/vnd.ms-powerpoint, application/dxf, application/vnd.oasis.opendocument.text, application/x-zip-compressed, image/x-dwg, image/gif, text/rtf, image/x-tiff, application/msword, application/gzipped, drawing/x-dwg, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, image/x-ms-bmp, image/heif, text/plain, text/x-pdf, application/vnd.oasis.opendocument.spreadsheet, application/x-pdf, application/postscript.
+    Used when uploading a new document or file in a multipart request that does not exist in the system already. Supported file types: application/tiff, application/x-rar, application/vnd.oasis.opendocument.text, application/x-jpg, image/x-ms-bmp, application/x-tif, image/webp, application/vnd.oasis.opendocument.spreadsheet, application/zip, image/jpg, application/eps, application/svg+xml, application/vnd.oasis.opendocument.presentation, text/svg, application/x-dxf, text/csv, application/vnd.pdf, image/tif, drawing/x-dwf, image/x-dxf, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, image/vnd.dwg, image/tiff, application/vnd.ms-powerpoint, text/pdf, application/x-autocad, image/heic, application/x-csv, application/x-acad, text/x-csv, application/x-pdf, application/excel, image/heif-sequence, application/vnd.openxmlformats-officedocument.presentationml.presentation, image/svg+xml, image/x-eps, application/x-rar-compressed, application/acad, drawing/dwg, image/jpeg, application/dwg, application/acrobat, image/eps, application/x-gzip, application/x-dwg, application/postscript, image/dxf, application/vnd.ms-word, image/x-tiff, text/comma-separated-values, application/x-tiff, application/pdf, image/gif, application/x-tar, application/x-eps, application/dxf, drawing/x-dwg, application/x-zip-compressed, text/svg-xml, application/tif, image/png, application/gzip-compressed, application/gzip, application/csv, application/vnd.openxmlformats-officedocument.presentationml.slideshow, image/heif, text/rtf, text/x-pdf, application/rtf, application/jpg, pplication/vnd.rar, image/x-tif, image/x-dwg, application/vnd.ms-excel, image/heic-sequence, image/x-bmp, application/vnd.openxmlformats-officedocument.wordprocessingml.document, text/plain, application/msword, text/x-comma-separated-values, image/svg, image/bmp, application/gzipped, application/x-rtf.
     """
     file: Upload!
 
@@ -14341,6 +14761,18 @@ type Mutation {
     input: ExportProductsInput!
   ): ProductsExport
 
+  """Upload CSV file for product import and parse its structure."""
+  createImportFile(
+    """CSV file to upload."""
+    file: Upload!
+  ): CreateImportFile
+
+  """Start processing CSV product import with field mappings."""
+  startCsvImport(
+    """Input data for CSV import"""
+    input: ImportProductsInput!
+  ): StartCSVImport
+
   """Adds a gift card or a voucher to a checkout."""
   checkoutAddPromoCode(
     """Checkout ID."""
@@ -20007,70 +20439,6 @@ type NauticalOrderLinesCsvUpload {
   orderErrors: [OrderError!]!
 }
 
-"""Represents a job data of exported file."""
-type ImportFile implements Node & Job {
-  """The ID of the object"""
-  id: ID!
-  user: User
-  app: App
-
-  """Job status."""
-  status: JobStatusEnum!
-
-  """Created date time of job in ISO 8601 format."""
-  createdAt: DateTime!
-
-  """Date time of job last update in ISO 8601 format."""
-  updatedAt: DateTime!
-
-  """Job message."""
-  message: String
-
-  """The URL of file to download."""
-  url: String
-
-  """List of events associated with the import."""
-  events: [ImportEvent!]
-}
-
-"""History log of import file."""
-type ImportEvent implements Node {
-  """The ID of the object"""
-  id: ID!
-
-  """Date when event happened at in ISO 8601 format."""
-  date: DateTime!
-
-  """Import event type."""
-  type: ImportEventsEnum!
-
-  """User who performed the action."""
-  user: User
-
-  """App which performed the action."""
-  app: App
-
-  """Content of the event."""
-  message: String!
-}
-
-enum ImportEventsEnum {
-  """Data import was started."""
-  IMPORT_PENDING
-
-  """Data import was completed successfully."""
-  IMPORT_SUCCESS
-
-  """Import Failed"""
-  IMPORT_FAILED
-
-  """Data import failed."""
-  IMPORT_DELETED
-
-  """Import file was deleted."""
-  IMPORTED_FILE_SENT
-}
-
 """
 Uploads lines for a draft order via CSV. This mutation must be sent as a `multipart` request. More detailed specs of the upload format can be found here: https://github.com/jaydenseric/graphql-multipart-request-spec
 """
@@ -20944,6 +21312,58 @@ enum FileTypesEnum {
   XLSX
 }
 
+"""Upload CSV file for product import and parse its structure."""
+type CreateImportFile {
+  """The newly created import file with parsed metadata."""
+  importFile: ImportFile
+
+  """Parsed CSV metadata (headers, row count, examples)."""
+  metadata: CSVMetadata
+  importErrors: [ExportError!]!
+}
+
+"""CSV file metadata extracted during parsing."""
+type CSVMetadata {
+  """List of CSV column headers."""
+  headers: [String!]!
+
+  """Total number of rows in CSV (excluding header)."""
+  rowCount: Int!
+
+  """Sample values for each column (first 3 non-empty values)."""
+  examples: JSONString!
+}
+
+"""Start processing CSV product import with field mappings."""
+type StartCSVImport {
+  """The import file being processed."""
+  importFile: ImportFile
+
+  """Celery task ID for tracking import progress."""
+  taskId: String
+  importErrors: [ExportError!]!
+}
+
+"""Input for starting CSV product import."""
+input ImportProductsInput {
+  """ID of the ImportFile to process."""
+  importFileId: ID!
+
+  """
+  Mapping of CSV column headers to Nautical product fields. Example: {"Product Name": "name", "Price": "price", "SKU": "sku"}
+  """
+  fieldMappings: JSONString!
+
+  """Optional default ProductType ID for products without type specified."""
+  defaultProductTypeId: ID
+
+  """Optional default Category ID for products without category specified."""
+  defaultCategoryId: ID
+
+  """Number of rows to process per batch (default 100)."""
+  batchSize: Int = 100
+}
+
 """Adds a gift card or a voucher to a checkout."""
 type CheckoutAddPromoCode {
   """The checkout with the added gift card or voucher."""

package/package.json

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