@fluentcommerce/fc-connect-sdk 0.1.54 → 0.1.55

package/docs/04-REFERENCE/schema/fluent-commerce-schema.json

@@ -1,764 +1,764 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "Fluent Commerce GraphQL Schema",
-  "description": "Representative GraphQL schema for Fluent Commerce API - Generated for fc-connect-sdk documentation validation",
-  "version": "2025.1",
-  "generatedOn": "2025-01-19",
-  "note": "This schema represents common Fluent Commerce API patterns based on SDK connectors and documentation. Always validate against your specific Fluent Commerce environment using: npx @fluentcommerce/fc-connect-sdk introspect-schema --url YOUR_FLUENT_URL",
-
-  "types": {
-    "Query": {
-      "kind": "OBJECT",
-      "description": "Root query type for retrieving data from Fluent Commerce",
-      "fields": {
-        "inventoryPositions": {
-          "description": "Query inventory positions with pagination",
-          "type": "InventoryPositionConnection!",
-          "args": {
-            "first": { "type": "Int", "description": "Number of records to return" },
-            "after": { "type": "String", "description": "Cursor for pagination" },
-            "filter": { "type": "JSON", "description": "Filter criteria" },
-            "updatedOn": { "type": "DateTimeRange", "description": "Filter by update time range" }
-          }
-        },
-        "products": {
-          "description": "Query products with pagination",
-          "type": "ProductConnection!",
-          "args": {
-            "first": { "type": "Int" },
-            "after": { "type": "String" },
-            "filter": { "type": "JSON" },
-            "ref": { "type": "String" }
-          }
-        },
-        "product": {
-          "description": "Get single product by ref",
-          "type": "Product",
-          "args": {
-            "ref": { "type": "String!" }
-          }
-        },
-        "orders": {
-          "description": "Query orders with pagination",
-          "type": "OrderConnection!",
-          "args": {
-            "first": { "type": "Int" },
-            "after": { "type": "String" },
-            "filter": { "type": "JSON" },
-            "createdOn": { "type": "DateTimeRange" },
-            "updatedOn": { "type": "DateTimeRange" }
-          }
-        },
-        "order": {
-          "description": "Get single order by ref",
-          "type": "Order",
-          "args": {
-            "ref": { "type": "String!" }
-          }
-        },
-        "locations": {
-          "description": "Query locations with pagination",
-          "type": "LocationConnection!",
-          "args": {
-            "first": { "type": "Int" },
-            "after": { "type": "String" }
-          }
-        },
-        "customers": {
-          "description": "Query customers",
-          "type": "CustomerConnection!",
-          "args": {
-            "email": { "type": "String" },
-            "first": { "type": "Int" },
-            "after": { "type": "String" }
-          }
-        }
-      }
-    },
-
-    "Mutation": {
-      "kind": "OBJECT",
-      "description": "Root mutation type for modifying data in Fluent Commerce",
-      "fields": {
-        "createOrder": {
-          "description": "Create a new order",
-          "type": "Order!",
-          "args": {
-            "input": { "type": "CreateOrderInput!" }
-          }
-        },
-        "updateInventoryPositions": {
-          "description": "Update inventory positions (use batch API instead for better performance)",
-          "type": "UpdateInventoryPositionsPayload",
-          "args": {
-            "input": { "type": "[UpdateInventoryPositionInput]!" }
-          }
-        },
-        "upsertInventoryPosition": {
-          "description": "Upsert single inventory position",
-          "type": "InventoryPosition",
-          "args": {
-            "input": { "type": "UpsertInventoryPositionInput!" }
-          }
-        },
-        "sendBatch": {
-          "description": "Send batch of entities for processing (Batch API - INVENTORY_POSITION only)",
-          "type": "Batch!",
-          "args": {
-            "input": { "type": "BatchInput!" }
-          }
-        },
-        "createJob": {
-          "description": "Create a job for batch processing",
-          "type": "Job!",
-          "args": {
-            "input": { "type": "CreateJobInput!" }
-          }
-        },
-        "createCustomer": {
-          "description": "Create a customer",
-          "type": "Customer!",
-          "args": {
-            "input": { "type": "CreateCustomerInput!" }
-          }
-        }
-      }
-    },
-
-    "InventoryPosition": {
-      "kind": "OBJECT",
-      "description": "Represents an inventory position at a specific location",
-      "fields": {
-        "id": { "type": "ID!", "description": "Unique identifier" },
-        "ref": { "type": "String!", "description": "Reference code" },
-        "productRef": { "type": "String!", "description": "Product reference" },
-        "locationRef": { "type": "String!", "description": "Location reference" },
-        "qty": { "type": "Int!", "description": "Quantity available" },
-        "status": { "type": "String", "description": "Position status (e.g., AVAILABLE, RESERVED)" },
-        "createdOn": { "type": "DateTime", "description": "Creation timestamp" },
-        "updatedOn": { "type": "DateTime", "description": "Last update timestamp" },
-        "product": { "type": "Product", "description": "Associated product" },
-        "location": { "type": "Location", "description": "Associated location" },
-        "quantities": { "type": "QuantityConnection", "description": "Quantity breakdown" }
-      }
-    },
-
-    "Product": {
-      "kind": "OBJECT",
-      "description": "Represents a product in the catalog",
-      "fields": {
-        "id": { "type": "ID!", "description": "Unique identifier" },
-        "ref": { "type": "String!", "description": "Product reference/SKU" },
-        "name": { "type": "String", "description": "Product name" },
-        "gtin": { "type": "String", "description": "Global Trade Item Number" },
-        "description": { "type": "String", "description": "Product description" },
-        "catalogue": { "type": "Catalogue", "description": "Product catalogue" },
-        "categories": { "type": "CategoryConnection", "description": "Product categories" },
-        "attributes": { "type": "[Attribute]", "description": "Product attributes" },
-        "inventoryPositions": { "type": "InventoryPositionConnection", "description": "Inventory positions" },
-        "createdOn": { "type": "DateTime" },
-        "updatedOn": { "type": "DateTime" }
-      }
-    },
-
-    "Order": {
-      "kind": "OBJECT",
-      "description": "Represents a customer order",
-      "fields": {
-        "id": { "type": "ID!", "description": "Unique identifier" },
-        "ref": { "type": "String!", "description": "Order reference number" },
-        "type": { "type": "OrderType!", "description": "Order type (e.g., STANDARD, CC)" },
-        "status": { "type": "String", "description": "Order status" },
-        "totalPrice": { "type": "Float!", "description": "Total price" },
-        "totalTaxPrice": { "type": "Float", "description": "Total tax amount" },
-        "currency": { "type": "String!", "description": "Currency code (e.g., USD)" },
-        "customer": { "type": "Customer", "description": "Customer information" },
-        "billingAddress": { "type": "Address", "description": "Billing address" },
-        "items": { "type": "OrderItemConnection!", "description": "Order items" },
-        "fulfilments": { "type": "FulfilmentConnection", "description": "Order fulfilments" },
-        "financialTransactions": { "type": "[FinancialTransaction]", "description": "Payment transactions" },
-        "attributes": { "type": "[Attribute]", "description": "Custom attributes" },
-        "createdOn": { "type": "DateTime!", "description": "Creation timestamp" },
-        "updatedOn": { "type": "DateTime", "description": "Last update timestamp" },
-        "retailer": { "type": "Retailer!", "description": "Retailer" }
-      }
-    },
-
-    "OrderItem": {
-      "kind": "OBJECT",
-      "description": "Represents an item in an order",
-      "fields": {
-        "ref": { "type": "String!", "description": "Item reference" },
-        "productRef": { "type": "String!", "description": "Product reference/SKU" },
-        "productCatalogueRef": { "type": "String", "description": "Product catalogue reference" },
-        "quantity": { "type": "Int!", "description": "Quantity ordered" },
-        "price": { "type": "Float!", "description": "Unit price" },
-        "paidPrice": { "type": "Float", "description": "Price after discounts" },
-        "totalPrice": { "type": "Float!", "description": "Total price for this item" },
-        "taxPrice": { "type": "Float", "description": "Tax amount" },
-        "totalTaxPrice": { "type": "Float", "description": "Total tax" },
-        "currency": { "type": "String!", "description": "Currency code" },
-        "fulfilmentChoiceRef": { "type": "String", "description": "Fulfilment choice reference" },
-        "attributes": { "type": "[Attribute]", "description": "Item attributes" }
-      }
-    },
-
-    "Customer": {
-      "kind": "OBJECT",
-      "description": "Represents a customer",
-      "fields": {
-        "id": { "type": "ID!", "description": "Unique identifier" },
-        "ref": { "type": "String!", "description": "Customer reference" },
-        "email": { "type": "String", "description": "Email address" },
-        "firstName": { "type": "String", "description": "First name" },
-        "lastName": { "type": "String", "description": "Last name" },
-        "phone": { "type": "String", "description": "Phone number" },
-        "addresses": { "type": "[Address]", "description": "Customer addresses" }
-      }
-    },
-
-    "Location": {
-      "kind": "OBJECT",
-      "description": "Represents a physical location (warehouse, store, etc.)",
-      "fields": {
-        "id": { "type": "ID!", "description": "Unique identifier" },
-        "ref": { "type": "String!", "description": "Location reference code" },
-        "name": { "type": "String!", "description": "Location name" },
-        "type": { "type": "String", "description": "Location type (WAREHOUSE, STORE, etc.)" },
-        "address": { "type": "Address", "description": "Location address" },
-        "attributes": { "type": "[Attribute]", "description": "Location attributes" }
-      }
-    },
-
-    "Catalogue": {
-      "kind": "OBJECT",
-      "description": "Represents a product catalogue",
-      "fields": {
-        "ref": { "type": "String!", "description": "Catalogue reference" },
-        "name": { "type": "String", "description": "Catalogue name" }
-      }
-    },
-
-    "Address": {
-      "kind": "OBJECT",
-      "description": "Represents a physical address",
-      "fields": {
-        "street": { "type": "String", "description": "Street address" },
-        "street2": { "type": "String", "description": "Additional address line" },
-        "city": { "type": "String", "description": "City" },
-        "state": { "type": "String", "description": "State/province code" },
-        "postcode": { "type": "String", "description": "Postal/ZIP code" },
-        "country": { "type": "String", "description": "Country code" },
-        "phone": { "type": "String", "description": "Contact phone" }
-      }
-    },
-
-    "Attribute": {
-      "kind": "OBJECT",
-      "description": "Custom attribute key-value pair",
-      "fields": {
-        "name": { "type": "String!", "description": "Attribute name" },
-        "value": { "type": "String!", "description": "Attribute value" },
-        "type": { "type": "String", "description": "Attribute type" }
-      }
-    },
-
-    "Fulfilment": {
-      "kind": "OBJECT",
-      "description": "Represents an order fulfilment",
-      "fields": {
-        "id": { "type": "ID!" },
-        "ref": { "type": "String!" },
-        "status": { "type": "String" },
-        "type": { "type": "String" },
-        "deliveryType": { "type": "String" },
-        "items": { "type": "FulfilmentItemConnection" }
-      }
-    },
-
-    "FinancialTransaction": {
-      "kind": "OBJECT",
-      "description": "Represents a financial transaction/payment",
-      "fields": {
-        "ref": { "type": "String!", "description": "Transaction reference" },
-        "type": { "type": "String!", "description": "Transaction type (AUTHORIZATION, CAPTURE, etc.)" },
-        "amount": { "type": "Float!", "description": "Transaction amount" },
-        "currency": { "type": "String!", "description": "Currency code" },
-        "cardType": { "type": "String", "description": "Card type (Visa, MasterCard, etc.)" },
-        "paymentMethod": { "type": "String!", "description": "Payment method" },
-        "externalTransactionCode": { "type": "String", "description": "External auth code" },
-        "externalTransactionId": { "type": "String", "description": "External transaction ID" },
-        "attributes": { "type": "[Attribute]", "description": "Transaction attributes" }
-      }
-    },
-
-    "Retailer": {
-      "kind": "OBJECT",
-      "description": "Represents a retailer",
-      "fields": {
-        "id": { "type": "ID!", "description": "Retailer ID" },
-        "ref": { "type": "String", "description": "Retailer reference" }
-      }
-    },
-
-    "Job": {
-      "kind": "OBJECT",
-      "description": "Represents a batch processing job",
-      "fields": {
-        "id": { "type": "ID!", "description": "Job ID" },
-        "name": { "type": "String", "description": "Job name" },
-        "status": { "type": "JobStatus", "description": "Job status" },
-        "progress": { "type": "Float", "description": "Progress percentage" }
-      }
-    },
-
-    "Batch": {
-      "kind": "OBJECT",
-      "description": "Represents a batch submission",
-      "fields": {
-        "id": { "type": "ID!", "description": "Batch ID" },
-        "status": { "type": "BatchStatus", "description": "Batch status" }
-      }
-    }
-  },
-
-  "inputs": {
-    "CreateOrderInput": {
-      "kind": "INPUT_OBJECT",
-      "description": "Input for creating an order",
-      "fields": {
-        "ref": { "type": "String!", "description": "Order reference (Required)" },
-        "type": { "type": "OrderType!", "description": "Order type (Required)" },
-        "retailer": { "type": "RetailerInput!", "description": "Retailer information (Required)" },
-        "totalPrice": { "type": "Float!", "description": "Total price (Required)" },
-        "totalTaxPrice": { "type": "Float", "description": "Total tax amount" },
-        "currency": { "type": "String!", "description": "Currency code (Required)" },
-        "customer": { "type": "CustomerInput!", "description": "Customer information (Required)" },
-        "billingAddress": { "type": "AddressInput", "description": "Billing address" },
-        "items": { "type": "[OrderItemInput]!", "description": "Order items (Required)" },
-        "fulfilmentChoices": { "type": "[FulfilmentChoiceInput]", "description": "Fulfilment choices" },
-        "financialTransactions": { "type": "[FinancialTransactionInput]", "description": "Payment transactions" },
-        "attributes": { "type": "[AttributeInput]", "description": "Custom attributes" }
-      }
-    },
-
-    "OrderItemInput": {
-      "kind": "INPUT_OBJECT",
-      "description": "Input for order item",
-      "fields": {
-        "ref": { "type": "String!", "description": "Item reference (Required)" },
-        "productRef": { "type": "String!", "description": "Product reference (Required)" },
-        "productCatalogueRef": { "type": "String", "description": "Product catalogue reference" },
-        "quantity": { "type": "Int!", "description": "Quantity (Required)" },
-        "price": { "type": "Float!", "description": "Unit price (Required)" },
-        "paidPrice": { "type": "Float", "description": "Price after discounts" },
-        "totalPrice": { "type": "Float!", "description": "Total price (Required)" },
-        "taxPrice": { "type": "Float", "description": "Tax amount" },
-        "totalTaxPrice": { "type": "Float", "description": "Total tax" },
-        "currency": { "type": "String!", "description": "Currency code (Required)" },
-        "fulfilmentChoiceRef": { "type": "String", "description": "Fulfilment choice reference" },
-        "attributes": { "type": "[AttributeInput]", "description": "Item attributes" }
-      }
-    },
-
-    "CustomerInput": {
-      "kind": "INPUT_OBJECT",
-      "description": "Input for customer",
-      "fields": {
-        "id": { "type": "ID", "description": "Customer ID (for existing customer)" },
-        "ref": { "type": "String", "description": "Customer reference" },
-        "email": { "type": "String", "description": "Email address" },
-        "firstName": { "type": "String", "description": "First name" },
-        "lastName": { "type": "String", "description": "Last name" }
-      }
-    },
-
-    "RetailerInput": {
-      "kind": "INPUT_OBJECT",
-      "description": "Input for retailer",
-      "fields": {
-        "id": { "type": "ID!", "description": "Retailer ID (Required)" }
-      }
-    },
-
-    "AddressInput": {
-      "kind": "INPUT_OBJECT",
-      "description": "Input for address",
-      "fields": {
-        "street": { "type": "String" },
-        "street2": { "type": "String" },
-        "city": { "type": "String" },
-        "state": { "type": "String" },
-        "postcode": { "type": "String" },
-        "country": { "type": "String" },
-        "phone": { "type": "String" }
-      }
-    },
-
-    "FulfilmentChoiceInput": {
-      "kind": "INPUT_OBJECT",
-      "description": "Input for fulfilment choice",
-      "fields": {
-        "ref": { "type": "String!", "description": "Fulfilment choice reference" },
-        "deliveryType": { "type": "String", "description": "Delivery type" },
-        "deliveryAddress": { "type": "AddressInput", "description": "Delivery address" }
-      }
-    },
-
-    "FinancialTransactionInput": {
-      "kind": "INPUT_OBJECT",
-      "description": "Input for financial transaction",
-      "fields": {
-        "ref": { "type": "String!", "description": "Transaction reference (Required)" },
-        "type": { "type": "String!", "description": "Transaction type (Required)" },
-        "amount": { "type": "Float!", "description": "Amount (Required)" },
-        "currency": { "type": "String!", "description": "Currency (Required)" },
-        "cardType": { "type": "String" },
-        "paymentMethod": { "type": "String!" },
-        "externalTransactionCode": { "type": "String" },
-        "externalTransactionId": { "type": "String" },
-        "attributes": { "type": "[AttributeInput]" }
-      }
-    },
-
-    "AttributeInput": {
-      "kind": "INPUT_OBJECT",
-      "description": "Input for attribute",
-      "fields": {
-        "name": { "type": "String!", "description": "Attribute name (Required)" },
-        "value": { "type": "String!", "description": "Attribute value (Required)" },
-        "type": { "type": "String", "description": "Attribute type" }
-      }
-    },
-
-    "UpsertInventoryPositionInput": {
-      "kind": "INPUT_OBJECT",
-      "description": "Input for upserting inventory position",
-      "fields": {
-        "ref": { "type": "String!", "description": "Position reference (Required)" },
-        "productRef": { "type": "String!", "description": "Product reference (Required)" },
-        "locationRef": { "type": "String!", "description": "Location reference (Required)" },
-        "qty": { "type": "Int!", "description": "Quantity (Required)" },
-        "status": { "type": "String", "description": "Status (e.g., AVAILABLE, RESERVED)" },
-        "type": { "type": "String", "description": "Position type" }
-      }
-    },
-
-    "UpdateInventoryPositionInput": {
-      "kind": "INPUT_OBJECT",
-      "description": "Input for updating inventory position (use batch API for better performance)",
-      "fields": {
-        "ref": { "type": "String!", "description": "Position reference" },
-        "productRef": { "type": "String", "description": "Product reference" },
-        "locationRef": { "type": "String", "description": "Location reference" },
-        "qty": { "type": "Int", "description": "Quantity adjustment" },
-        "status": { "type": "String", "description": "Status" }
-      }
-    },
-
-    "BatchInput": {
-      "kind": "INPUT_OBJECT",
-      "description": "Input for batch submission (Batch API - INVENTORY_POSITION only)",
-      "fields": {
-        "action": { "type": "BatchAction!", "description": "Batch action (UPSERT only)" },
-        "entityType": { "type": "EntityType!", "description": "Entity type (INVENTORY_POSITION only)" },
-        "retailerId": { "type": "ID!", "description": "Retailer ID (Required)" },
-        "entities": { "type": "[InventoryPositionInput]!", "description": "Entities to process (Required)" }
-      }
-    },
-
-    "InventoryPositionInput": {
-      "kind": "INPUT_OBJECT",
-      "description": "Input for inventory position in batch",
-      "fields": {
-        "ref": { "type": "String!", "description": "Position reference (Required)" },
-        "productRef": { "type": "String!", "description": "Product reference (Required)" },
-        "locationRef": { "type": "String!", "description": "Location reference (Required)" },
-        "qty": { "type": "Int!", "description": "Quantity (Required)" },
-        "status": { "type": "String", "description": "Status" }
-      }
-    },
-
-    "CreateJobInput": {
-      "kind": "INPUT_OBJECT",
-      "description": "Input for creating a job",
-      "fields": {
-        "name": { "type": "String!", "description": "Job name (Required)" },
-        "retailerId": { "type": "ID!", "description": "Retailer ID (Required)" },
-        "metadata": { "type": "JSON", "description": "Job metadata" }
-      }
-    },
-
-    "CreateCustomerInput": {
-      "kind": "INPUT_OBJECT",
-      "description": "Input for creating a customer",
-      "fields": {
-        "ref": { "type": "String", "description": "Customer reference" },
-        "email": { "type": "String", "description": "Email address" },
-        "firstName": { "type": "String", "description": "First name" },
-        "lastName": { "type": "String", "description": "Last name" }
-      }
-    },
-
-    "DateTimeRange": {
-      "kind": "INPUT_OBJECT",
-      "description": "Date time range filter",
-      "fields": {
-        "from": { "type": "DateTime", "description": "Start date" },
-        "to": { "type": "DateTime", "description": "End date" }
-      }
-    }
-  },
-
-  "enums": {
-    "OrderType": {
-      "kind": "ENUM",
-      "description": "Order type enumeration",
-      "values": ["STANDARD", "HD", "CC", "SALES"]
-    },
-
-    "EntityType": {
-      "kind": "ENUM",
-      "description": "Entity type for batch operations (Batch API limitation)",
-      "values": ["INVENTORY_POSITION"],
-      "note": "Batch API ONLY supports INVENTORY_POSITION. For other entities (ORDER, PRODUCT, LOCATION), use GraphQL mutations directly."
-    },
-
-    "BatchAction": {
-      "kind": "ENUM",
-      "description": "Batch action type",
-      "values": ["UPSERT"],
-      "note": "Batch API ONLY supports UPSERT action"
-    },
-
-    "JobStatus": {
-      "kind": "ENUM",
-      "description": "Job status enumeration",
-      "values": ["PENDING", "RUNNING", "COMPLETED", "FAILED", "COMPLETED_WITH_ERRORS"]
-    },
-
-    "BatchStatus": {
-      "kind": "ENUM",
-      "description": "Batch status enumeration",
-      "values": ["PENDING", "PROCESSING", "COMPLETED", "FAILED"]
-    }
-  },
-
-  "connections": {
-    "InventoryPositionConnection": {
-      "kind": "OBJECT",
-      "description": "Paginated inventory positions",
-      "fields": {
-        "edges": { "type": "[InventoryPositionEdge]!", "description": "Array of edges" },
-        "pageInfo": { "type": "PageInfo!", "description": "Pagination info" }
-      }
-    },
-
-    "InventoryPositionEdge": {
-      "kind": "OBJECT",
-      "description": "Edge for inventory position",
-      "fields": {
-        "cursor": { "type": "String!", "description": "Cursor for this edge" },
-        "node": { "type": "InventoryPosition!", "description": "The inventory position" }
-      }
-    },
-
-    "ProductConnection": {
-      "kind": "OBJECT",
-      "description": "Paginated products",
-      "fields": {
-        "edges": { "type": "[ProductEdge]!" },
-        "pageInfo": { "type": "PageInfo!" }
-      }
-    },
-
-    "ProductEdge": {
-      "kind": "OBJECT",
-      "fields": {
-        "cursor": { "type": "String!" },
-        "node": { "type": "Product!" }
-      }
-    },
-
-    "OrderConnection": {
-      "kind": "OBJECT",
-      "description": "Paginated orders",
-      "fields": {
-        "edges": { "type": "[OrderEdge]!" },
-        "pageInfo": { "type": "PageInfo!" }
-      }
-    },
-
-    "OrderEdge": {
-      "kind": "OBJECT",
-      "fields": {
-        "cursor": { "type": "String!" },
-        "node": { "type": "Order!" }
-      }
-    },
-
-    "OrderItemConnection": {
-      "kind": "OBJECT",
-      "description": "Paginated order items",
-      "fields": {
-        "edges": { "type": "[OrderItemEdge]!" }
-      }
-    },
-
-    "OrderItemEdge": {
-      "kind": "OBJECT",
-      "fields": {
-        "node": { "type": "OrderItem!" }
-      }
-    },
-
-    "LocationConnection": {
-      "kind": "OBJECT",
-      "fields": {
-        "edges": { "type": "[LocationEdge]!" },
-        "pageInfo": { "type": "PageInfo!" }
-      }
-    },
-
-    "LocationEdge": {
-      "kind": "OBJECT",
-      "fields": {
-        "cursor": { "type": "String!" },
-        "node": { "type": "Location!" }
-      }
-    },
-
-    "CustomerConnection": {
-      "kind": "OBJECT",
-      "fields": {
-        "edges": { "type": "[CustomerEdge]!" },
-        "pageInfo": { "type": "PageInfo!" }
-      }
-    },
-
-    "CustomerEdge": {
-      "kind": "OBJECT",
-      "fields": {
-        "cursor": { "type": "String!" },
-        "node": { "type": "Customer!" }
-      }
-    },
-
-    "CategoryConnection": {
-      "kind": "OBJECT",
-      "fields": {
-        "edges": { "type": "[CategoryEdge]!" }
-      }
-    },
-
-    "CategoryEdge": {
-      "kind": "OBJECT",
-      "fields": {
-        "node": { "type": "Category!" }
-      }
-    },
-
-    "FulfilmentConnection": {
-      "kind": "OBJECT",
-      "fields": {
-        "edges": { "type": "[FulfilmentEdge]!" }
-      }
-    },
-
-    "FulfilmentEdge": {
-      "kind": "OBJECT",
-      "fields": {
-        "node": { "type": "Fulfilment!" }
-      }
-    },
-
-    "FulfilmentItemConnection": {
-      "kind": "OBJECT",
-      "fields": {
-        "edges": { "type": "[FulfilmentItemEdge]!" }
-      }
-    },
-
-    "FulfilmentItemEdge": {
-      "kind": "OBJECT",
-      "fields": {
-        "node": { "type": "FulfilmentItem!" }
-      }
-    },
-
-    "QuantityConnection": {
-      "kind": "OBJECT",
-      "fields": {
-        "edges": { "type": "[QuantityEdge]!" }
-      }
-    },
-
-    "QuantityEdge": {
-      "kind": "OBJECT",
-      "fields": {
-        "node": { "type": "Quantity!" }
-      }
-    },
-
-    "PageInfo": {
-      "kind": "OBJECT",
-      "description": "Pagination information - IMPORTANT: Fluent does NOT return startCursor/endCursor (deviation from Relay spec)",
-      "fields": {
-        "hasNextPage": { "type": "Boolean!", "description": "Whether more records exist (Required)" },
-        "hasPreviousPage": { "type": "Boolean!", "description": "Whether previous records exist (Required)" }
-      },
-      "notAvailableInFluent": {
-        "startCursor": "NOT AVAILABLE - Use edges[0].cursor instead",
-        "endCursor": "NOT AVAILABLE - Use edges[edges.length-1].cursor instead"
-      },
-      "usageNote": "Unlike full Relay spec, Fluent Commerce does NOT return startCursor/endCursor in pageInfo. To get the cursor for the next page, use the cursor from the last edge: edges[edges.length-1].cursor"
-    }
-  },
-
-  "scalars": {
-    "DateTime": {
-      "kind": "SCALAR",
-      "description": "ISO8601 date-time string (e.g., '2025-01-14T10:30:00Z')"
-    },
-    "JSON": {
-      "kind": "SCALAR",
-      "description": "Arbitrary JSON value"
-    }
-  },
-
-  "validationNotes": {
-    "batchAPI": {
-      "limitation": "The Batch API ONLY supports INVENTORY_POSITION entity type with UPSERT action. For ORDER, PRODUCT, LOCATION, or other entities, use GraphQL mutations directly (e.g., createOrder, updateProduct).",
-      "requiredFields": ["retailerId", "action", "entityType", "entities"],
-      "example": "See docs/guides/ingestion.md for complete Batch API usage"
-    },
-    "pagination": {
-      "cursorFields": "All connection types provide `edges[].cursor` and `pageInfo.endCursor` for pagination. Use `endCursor` as the `after` parameter for next page.",
-      "example": "See docs/guides/auto-pagination/ for auto-pagination implementation"
-    },
-    "mutations": {
-      "createOrder": "Requires all fields marked with '!' in CreateOrderInput. See connectors/versori-sfcc-connector/mappings/sfcc-to-fluent-order-mapping.json for complete example.",
-      "upsertInventoryPosition": "Can be used for single position updates. For bulk updates, use Batch API.",
-      "validation": "Run 'npx @fluentcommerce/fc-connect-sdk validate-schema --mapping your-mapping.json --schema this-file.json' to validate your mappings"
-    }
-  },
-
-  "exampleQueries": {
-    "inventoryExtraction": {
-      "description": "Extract inventory positions with product and location details",
-      "query": "query ExtractInventory($after: String, $first: Int!) {\n  inventoryPositions(after: $after, first: $first) {\n    pageInfo {\n      hasNextPage\n      endCursor\n    }\n    edges {\n      cursor\n      node {\n        id\n        ref\n        productRef\n        locationRef\n        qty\n        status\n        createdOn\n        updatedOn\n        product {\n          ref\n          name\n          gtin\n          catalogue {\n            ref\n            name\n          }\n        }\n        location {\n          ref\n          name\n          type\n        }\n      }\n    }\n  }\n}",
-      "variables": {
-        "first": 100,
-        "after": null
-      }
-    },
-
-    "orderDetails": {
-      "description": "Get order details with items and fulfilments",
-      "query": "query GetOrderDetails($ref: String!) {\n  order(ref: $ref) {\n    id\n    ref\n    type\n    status\n    totalPrice\n    totalTaxPrice\n    currency\n    customer {\n      ref\n      email\n      firstName\n      lastName\n    }\n    items {\n      edges {\n        node {\n          ref\n          productRef\n          quantity\n          price\n          totalPrice\n        }\n      }\n    }\n    fulfilments {\n      edges {\n        node {\n          ref\n          status\n          deliveryType\n        }\n      }\n    }\n  }\n}",
-      "variables": {
-        "ref": "ORD-2025-001"
-      }
-    }
-  }
-}
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Fluent Commerce GraphQL Schema",
+  "description": "Representative GraphQL schema for Fluent Commerce API - Generated for fc-connect-sdk documentation validation",
+  "version": "2025.1",
+  "generatedOn": "2025-01-19",
+  "note": "This schema represents common Fluent Commerce API patterns based on SDK connectors and documentation. Always validate against your specific Fluent Commerce environment using: npx @fluentcommerce/fc-connect-sdk introspect-schema --url YOUR_FLUENT_URL",
+
+  "types": {
+    "Query": {
+      "kind": "OBJECT",
+      "description": "Root query type for retrieving data from Fluent Commerce",
+      "fields": {
+        "inventoryPositions": {
+          "description": "Query inventory positions with pagination",
+          "type": "InventoryPositionConnection!",
+          "args": {
+            "first": { "type": "Int", "description": "Number of records to return" },
+            "after": { "type": "String", "description": "Cursor for pagination" },
+            "filter": { "type": "JSON", "description": "Filter criteria" },
+            "updatedOn": { "type": "DateTimeRange", "description": "Filter by update time range" }
+          }
+        },
+        "products": {
+          "description": "Query products with pagination",
+          "type": "ProductConnection!",
+          "args": {
+            "first": { "type": "Int" },
+            "after": { "type": "String" },
+            "filter": { "type": "JSON" },
+            "ref": { "type": "String" }
+          }
+        },
+        "product": {
+          "description": "Get single product by ref",
+          "type": "Product",
+          "args": {
+            "ref": { "type": "String!" }
+          }
+        },
+        "orders": {
+          "description": "Query orders with pagination",
+          "type": "OrderConnection!",
+          "args": {
+            "first": { "type": "Int" },
+            "after": { "type": "String" },
+            "filter": { "type": "JSON" },
+            "createdOn": { "type": "DateTimeRange" },
+            "updatedOn": { "type": "DateTimeRange" }
+          }
+        },
+        "order": {
+          "description": "Get single order by ref",
+          "type": "Order",
+          "args": {
+            "ref": { "type": "String!" }
+          }
+        },
+        "locations": {
+          "description": "Query locations with pagination",
+          "type": "LocationConnection!",
+          "args": {
+            "first": { "type": "Int" },
+            "after": { "type": "String" }
+          }
+        },
+        "customers": {
+          "description": "Query customers",
+          "type": "CustomerConnection!",
+          "args": {
+            "email": { "type": "String" },
+            "first": { "type": "Int" },
+            "after": { "type": "String" }
+          }
+        }
+      }
+    },
+
+    "Mutation": {
+      "kind": "OBJECT",
+      "description": "Root mutation type for modifying data in Fluent Commerce",
+      "fields": {
+        "createOrder": {
+          "description": "Create a new order",
+          "type": "Order!",
+          "args": {
+            "input": { "type": "CreateOrderInput!" }
+          }
+        },
+        "updateInventoryPositions": {
+          "description": "Update inventory positions (use batch API instead for better performance)",
+          "type": "UpdateInventoryPositionsPayload",
+          "args": {
+            "input": { "type": "[UpdateInventoryPositionInput]!" }
+          }
+        },
+        "upsertInventoryPosition": {
+          "description": "Upsert single inventory position",
+          "type": "InventoryPosition",
+          "args": {
+            "input": { "type": "UpsertInventoryPositionInput!" }
+          }
+        },
+        "sendBatch": {
+          "description": "Send batch of entities for processing (Batch API - INVENTORY_POSITION only)",
+          "type": "Batch!",
+          "args": {
+            "input": { "type": "BatchInput!" }
+          }
+        },
+        "createJob": {
+          "description": "Create a job for batch processing",
+          "type": "Job!",
+          "args": {
+            "input": { "type": "CreateJobInput!" }
+          }
+        },
+        "createCustomer": {
+          "description": "Create a customer",
+          "type": "Customer!",
+          "args": {
+            "input": { "type": "CreateCustomerInput!" }
+          }
+        }
+      }
+    },
+
+    "InventoryPosition": {
+      "kind": "OBJECT",
+      "description": "Represents an inventory position at a specific location",
+      "fields": {
+        "id": { "type": "ID!", "description": "Unique identifier" },
+        "ref": { "type": "String!", "description": "Reference code" },
+        "productRef": { "type": "String!", "description": "Product reference" },
+        "locationRef": { "type": "String!", "description": "Location reference" },
+        "qty": { "type": "Int!", "description": "Quantity available" },
+        "status": { "type": "String", "description": "Position status (e.g., AVAILABLE, RESERVED)" },
+        "createdOn": { "type": "DateTime", "description": "Creation timestamp" },
+        "updatedOn": { "type": "DateTime", "description": "Last update timestamp" },
+        "product": { "type": "Product", "description": "Associated product" },
+        "location": { "type": "Location", "description": "Associated location" },
+        "quantities": { "type": "QuantityConnection", "description": "Quantity breakdown" }
+      }
+    },
+
+    "Product": {
+      "kind": "OBJECT",
+      "description": "Represents a product in the catalog",
+      "fields": {
+        "id": { "type": "ID!", "description": "Unique identifier" },
+        "ref": { "type": "String!", "description": "Product reference/SKU" },
+        "name": { "type": "String", "description": "Product name" },
+        "gtin": { "type": "String", "description": "Global Trade Item Number" },
+        "description": { "type": "String", "description": "Product description" },
+        "catalogue": { "type": "Catalogue", "description": "Product catalogue" },
+        "categories": { "type": "CategoryConnection", "description": "Product categories" },
+        "attributes": { "type": "[Attribute]", "description": "Product attributes" },
+        "inventoryPositions": { "type": "InventoryPositionConnection", "description": "Inventory positions" },
+        "createdOn": { "type": "DateTime" },
+        "updatedOn": { "type": "DateTime" }
+      }
+    },
+
+    "Order": {
+      "kind": "OBJECT",
+      "description": "Represents a customer order",
+      "fields": {
+        "id": { "type": "ID!", "description": "Unique identifier" },
+        "ref": { "type": "String!", "description": "Order reference number" },
+        "type": { "type": "OrderType!", "description": "Order type (e.g., STANDARD, CC)" },
+        "status": { "type": "String", "description": "Order status" },
+        "totalPrice": { "type": "Float!", "description": "Total price" },
+        "totalTaxPrice": { "type": "Float", "description": "Total tax amount" },
+        "currency": { "type": "String!", "description": "Currency code (e.g., USD)" },
+        "customer": { "type": "Customer", "description": "Customer information" },
+        "billingAddress": { "type": "Address", "description": "Billing address" },
+        "items": { "type": "OrderItemConnection!", "description": "Order items" },
+        "fulfilments": { "type": "FulfilmentConnection", "description": "Order fulfilments" },
+        "financialTransactions": { "type": "[FinancialTransaction]", "description": "Payment transactions" },
+        "attributes": { "type": "[Attribute]", "description": "Custom attributes" },
+        "createdOn": { "type": "DateTime!", "description": "Creation timestamp" },
+        "updatedOn": { "type": "DateTime", "description": "Last update timestamp" },
+        "retailer": { "type": "Retailer!", "description": "Retailer" }
+      }
+    },
+
+    "OrderItem": {
+      "kind": "OBJECT",
+      "description": "Represents an item in an order",
+      "fields": {
+        "ref": { "type": "String!", "description": "Item reference" },
+        "productRef": { "type": "String!", "description": "Product reference/SKU" },
+        "productCatalogueRef": { "type": "String", "description": "Product catalogue reference" },
+        "quantity": { "type": "Int!", "description": "Quantity ordered" },
+        "price": { "type": "Float!", "description": "Unit price" },
+        "paidPrice": { "type": "Float", "description": "Price after discounts" },
+        "totalPrice": { "type": "Float!", "description": "Total price for this item" },
+        "taxPrice": { "type": "Float", "description": "Tax amount" },
+        "totalTaxPrice": { "type": "Float", "description": "Total tax" },
+        "currency": { "type": "String!", "description": "Currency code" },
+        "fulfilmentChoiceRef": { "type": "String", "description": "Fulfilment choice reference" },
+        "attributes": { "type": "[Attribute]", "description": "Item attributes" }
+      }
+    },
+
+    "Customer": {
+      "kind": "OBJECT",
+      "description": "Represents a customer",
+      "fields": {
+        "id": { "type": "ID!", "description": "Unique identifier" },
+        "ref": { "type": "String!", "description": "Customer reference" },
+        "email": { "type": "String", "description": "Email address" },
+        "firstName": { "type": "String", "description": "First name" },
+        "lastName": { "type": "String", "description": "Last name" },
+        "phone": { "type": "String", "description": "Phone number" },
+        "addresses": { "type": "[Address]", "description": "Customer addresses" }
+      }
+    },
+
+    "Location": {
+      "kind": "OBJECT",
+      "description": "Represents a physical location (warehouse, store, etc.)",
+      "fields": {
+        "id": { "type": "ID!", "description": "Unique identifier" },
+        "ref": { "type": "String!", "description": "Location reference code" },
+        "name": { "type": "String!", "description": "Location name" },
+        "type": { "type": "String", "description": "Location type (WAREHOUSE, STORE, etc.)" },
+        "address": { "type": "Address", "description": "Location address" },
+        "attributes": { "type": "[Attribute]", "description": "Location attributes" }
+      }
+    },
+
+    "Catalogue": {
+      "kind": "OBJECT",
+      "description": "Represents a product catalogue",
+      "fields": {
+        "ref": { "type": "String!", "description": "Catalogue reference" },
+        "name": { "type": "String", "description": "Catalogue name" }
+      }
+    },
+
+    "Address": {
+      "kind": "OBJECT",
+      "description": "Represents a physical address",
+      "fields": {
+        "street": { "type": "String", "description": "Street address" },
+        "street2": { "type": "String", "description": "Additional address line" },
+        "city": { "type": "String", "description": "City" },
+        "state": { "type": "String", "description": "State/province code" },
+        "postcode": { "type": "String", "description": "Postal/ZIP code" },
+        "country": { "type": "String", "description": "Country code" },
+        "phone": { "type": "String", "description": "Contact phone" }
+      }
+    },
+
+    "Attribute": {
+      "kind": "OBJECT",
+      "description": "Custom attribute key-value pair",
+      "fields": {
+        "name": { "type": "String!", "description": "Attribute name" },
+        "value": { "type": "String!", "description": "Attribute value" },
+        "type": { "type": "String", "description": "Attribute type" }
+      }
+    },
+
+    "Fulfilment": {
+      "kind": "OBJECT",
+      "description": "Represents an order fulfilment",
+      "fields": {
+        "id": { "type": "ID!" },
+        "ref": { "type": "String!" },
+        "status": { "type": "String" },
+        "type": { "type": "String" },
+        "deliveryType": { "type": "String" },
+        "items": { "type": "FulfilmentItemConnection" }
+      }
+    },
+
+    "FinancialTransaction": {
+      "kind": "OBJECT",
+      "description": "Represents a financial transaction/payment",
+      "fields": {
+        "ref": { "type": "String!", "description": "Transaction reference" },
+        "type": { "type": "String!", "description": "Transaction type (AUTHORIZATION, CAPTURE, etc.)" },
+        "amount": { "type": "Float!", "description": "Transaction amount" },
+        "currency": { "type": "String!", "description": "Currency code" },
+        "cardType": { "type": "String", "description": "Card type (Visa, MasterCard, etc.)" },
+        "paymentMethod": { "type": "String!", "description": "Payment method" },
+        "externalTransactionCode": { "type": "String", "description": "External auth code" },
+        "externalTransactionId": { "type": "String", "description": "External transaction ID" },
+        "attributes": { "type": "[Attribute]", "description": "Transaction attributes" }
+      }
+    },
+
+    "Retailer": {
+      "kind": "OBJECT",
+      "description": "Represents a retailer",
+      "fields": {
+        "id": { "type": "ID!", "description": "Retailer ID" },
+        "ref": { "type": "String", "description": "Retailer reference" }
+      }
+    },
+
+    "Job": {
+      "kind": "OBJECT",
+      "description": "Represents a batch processing job",
+      "fields": {
+        "id": { "type": "ID!", "description": "Job ID" },
+        "name": { "type": "String", "description": "Job name" },
+        "status": { "type": "JobStatus", "description": "Job status" },
+        "progress": { "type": "Float", "description": "Progress percentage" }
+      }
+    },
+
+    "Batch": {
+      "kind": "OBJECT",
+      "description": "Represents a batch submission",
+      "fields": {
+        "id": { "type": "ID!", "description": "Batch ID" },
+        "status": { "type": "BatchStatus", "description": "Batch status" }
+      }
+    }
+  },
+
+  "inputs": {
+    "CreateOrderInput": {
+      "kind": "INPUT_OBJECT",
+      "description": "Input for creating an order",
+      "fields": {
+        "ref": { "type": "String!", "description": "Order reference (Required)" },
+        "type": { "type": "OrderType!", "description": "Order type (Required)" },
+        "retailer": { "type": "RetailerInput!", "description": "Retailer information (Required)" },
+        "totalPrice": { "type": "Float!", "description": "Total price (Required)" },
+        "totalTaxPrice": { "type": "Float", "description": "Total tax amount" },
+        "currency": { "type": "String!", "description": "Currency code (Required)" },
+        "customer": { "type": "CustomerInput!", "description": "Customer information (Required)" },
+        "billingAddress": { "type": "AddressInput", "description": "Billing address" },
+        "items": { "type": "[OrderItemInput]!", "description": "Order items (Required)" },
+        "fulfilmentChoices": { "type": "[FulfilmentChoiceInput]", "description": "Fulfilment choices" },
+        "financialTransactions": { "type": "[FinancialTransactionInput]", "description": "Payment transactions" },
+        "attributes": { "type": "[AttributeInput]", "description": "Custom attributes" }
+      }
+    },
+
+    "OrderItemInput": {
+      "kind": "INPUT_OBJECT",
+      "description": "Input for order item",
+      "fields": {
+        "ref": { "type": "String!", "description": "Item reference (Required)" },
+        "productRef": { "type": "String!", "description": "Product reference (Required)" },
+        "productCatalogueRef": { "type": "String", "description": "Product catalogue reference" },
+        "quantity": { "type": "Int!", "description": "Quantity (Required)" },
+        "price": { "type": "Float!", "description": "Unit price (Required)" },
+        "paidPrice": { "type": "Float", "description": "Price after discounts" },
+        "totalPrice": { "type": "Float!", "description": "Total price (Required)" },
+        "taxPrice": { "type": "Float", "description": "Tax amount" },
+        "totalTaxPrice": { "type": "Float", "description": "Total tax" },
+        "currency": { "type": "String!", "description": "Currency code (Required)" },
+        "fulfilmentChoiceRef": { "type": "String", "description": "Fulfilment choice reference" },
+        "attributes": { "type": "[AttributeInput]", "description": "Item attributes" }
+      }
+    },
+
+    "CustomerInput": {
+      "kind": "INPUT_OBJECT",
+      "description": "Input for customer",
+      "fields": {
+        "id": { "type": "ID", "description": "Customer ID (for existing customer)" },
+        "ref": { "type": "String", "description": "Customer reference" },
+        "email": { "type": "String", "description": "Email address" },
+        "firstName": { "type": "String", "description": "First name" },
+        "lastName": { "type": "String", "description": "Last name" }
+      }
+    },
+
+    "RetailerInput": {
+      "kind": "INPUT_OBJECT",
+      "description": "Input for retailer",
+      "fields": {
+        "id": { "type": "ID!", "description": "Retailer ID (Required)" }
+      }
+    },
+
+    "AddressInput": {
+      "kind": "INPUT_OBJECT",
+      "description": "Input for address",
+      "fields": {
+        "street": { "type": "String" },
+        "street2": { "type": "String" },
+        "city": { "type": "String" },
+        "state": { "type": "String" },
+        "postcode": { "type": "String" },
+        "country": { "type": "String" },
+        "phone": { "type": "String" }
+      }
+    },
+
+    "FulfilmentChoiceInput": {
+      "kind": "INPUT_OBJECT",
+      "description": "Input for fulfilment choice",
+      "fields": {
+        "ref": { "type": "String!", "description": "Fulfilment choice reference" },
+        "deliveryType": { "type": "String", "description": "Delivery type" },
+        "deliveryAddress": { "type": "AddressInput", "description": "Delivery address" }
+      }
+    },
+
+    "FinancialTransactionInput": {
+      "kind": "INPUT_OBJECT",
+      "description": "Input for financial transaction",
+      "fields": {
+        "ref": { "type": "String!", "description": "Transaction reference (Required)" },
+        "type": { "type": "String!", "description": "Transaction type (Required)" },
+        "amount": { "type": "Float!", "description": "Amount (Required)" },
+        "currency": { "type": "String!", "description": "Currency (Required)" },
+        "cardType": { "type": "String" },
+        "paymentMethod": { "type": "String!" },
+        "externalTransactionCode": { "type": "String" },
+        "externalTransactionId": { "type": "String" },
+        "attributes": { "type": "[AttributeInput]" }
+      }
+    },
+
+    "AttributeInput": {
+      "kind": "INPUT_OBJECT",
+      "description": "Input for attribute",
+      "fields": {
+        "name": { "type": "String!", "description": "Attribute name (Required)" },
+        "value": { "type": "String!", "description": "Attribute value (Required)" },
+        "type": { "type": "String", "description": "Attribute type" }
+      }
+    },
+
+    "UpsertInventoryPositionInput": {
+      "kind": "INPUT_OBJECT",
+      "description": "Input for upserting inventory position",
+      "fields": {
+        "ref": { "type": "String!", "description": "Position reference (Required)" },
+        "productRef": { "type": "String!", "description": "Product reference (Required)" },
+        "locationRef": { "type": "String!", "description": "Location reference (Required)" },
+        "qty": { "type": "Int!", "description": "Quantity (Required)" },
+        "status": { "type": "String", "description": "Status (e.g., AVAILABLE, RESERVED)" },
+        "type": { "type": "String", "description": "Position type" }
+      }
+    },
+
+    "UpdateInventoryPositionInput": {
+      "kind": "INPUT_OBJECT",
+      "description": "Input for updating inventory position (use batch API for better performance)",
+      "fields": {
+        "ref": { "type": "String!", "description": "Position reference" },
+        "productRef": { "type": "String", "description": "Product reference" },
+        "locationRef": { "type": "String", "description": "Location reference" },
+        "qty": { "type": "Int", "description": "Quantity adjustment" },
+        "status": { "type": "String", "description": "Status" }
+      }
+    },
+
+    "BatchInput": {
+      "kind": "INPUT_OBJECT",
+      "description": "Input for batch submission (Batch API - INVENTORY_POSITION only)",
+      "fields": {
+        "action": { "type": "BatchAction!", "description": "Batch action (UPSERT only)" },
+        "entityType": { "type": "EntityType!", "description": "Entity type (INVENTORY_POSITION only)" },
+        "retailerId": { "type": "ID!", "description": "Retailer ID (Required)" },
+        "entities": { "type": "[InventoryPositionInput]!", "description": "Entities to process (Required)" }
+      }
+    },
+
+    "InventoryPositionInput": {
+      "kind": "INPUT_OBJECT",
+      "description": "Input for inventory position in batch",
+      "fields": {
+        "ref": { "type": "String!", "description": "Position reference (Required)" },
+        "productRef": { "type": "String!", "description": "Product reference (Required)" },
+        "locationRef": { "type": "String!", "description": "Location reference (Required)" },
+        "qty": { "type": "Int!", "description": "Quantity (Required)" },
+        "status": { "type": "String", "description": "Status" }
+      }
+    },
+
+    "CreateJobInput": {
+      "kind": "INPUT_OBJECT",
+      "description": "Input for creating a job",
+      "fields": {
+        "name": { "type": "String!", "description": "Job name (Required)" },
+        "retailerId": { "type": "ID!", "description": "Retailer ID (Required)" },
+        "metadata": { "type": "JSON", "description": "Job metadata" }
+      }
+    },
+
+    "CreateCustomerInput": {
+      "kind": "INPUT_OBJECT",
+      "description": "Input for creating a customer",
+      "fields": {
+        "ref": { "type": "String", "description": "Customer reference" },
+        "email": { "type": "String", "description": "Email address" },
+        "firstName": { "type": "String", "description": "First name" },
+        "lastName": { "type": "String", "description": "Last name" }
+      }
+    },
+
+    "DateTimeRange": {
+      "kind": "INPUT_OBJECT",
+      "description": "Date time range filter",
+      "fields": {
+        "from": { "type": "DateTime", "description": "Start date" },
+        "to": { "type": "DateTime", "description": "End date" }
+      }
+    }
+  },
+
+  "enums": {
+    "OrderType": {
+      "kind": "ENUM",
+      "description": "Order type enumeration",
+      "values": ["STANDARD", "HD", "CC", "SALES"]
+    },
+
+    "EntityType": {
+      "kind": "ENUM",
+      "description": "Entity type for batch operations (Batch API limitation)",
+      "values": ["INVENTORY_POSITION"],
+      "note": "Batch API ONLY supports INVENTORY_POSITION. For other entities (ORDER, PRODUCT, LOCATION), use GraphQL mutations directly."
+    },
+
+    "BatchAction": {
+      "kind": "ENUM",
+      "description": "Batch action type",
+      "values": ["UPSERT"],
+      "note": "Batch API ONLY supports UPSERT action"
+    },
+
+    "JobStatus": {
+      "kind": "ENUM",
+      "description": "Job status enumeration",
+      "values": ["PENDING", "RUNNING", "COMPLETED", "FAILED", "COMPLETED_WITH_ERRORS"]
+    },
+
+    "BatchStatus": {
+      "kind": "ENUM",
+      "description": "Batch status enumeration",
+      "values": ["PENDING", "PROCESSING", "COMPLETED", "FAILED"]
+    }
+  },
+
+  "connections": {
+    "InventoryPositionConnection": {
+      "kind": "OBJECT",
+      "description": "Paginated inventory positions",
+      "fields": {
+        "edges": { "type": "[InventoryPositionEdge]!", "description": "Array of edges" },
+        "pageInfo": { "type": "PageInfo!", "description": "Pagination info" }
+      }
+    },
+
+    "InventoryPositionEdge": {
+      "kind": "OBJECT",
+      "description": "Edge for inventory position",
+      "fields": {
+        "cursor": { "type": "String!", "description": "Cursor for this edge" },
+        "node": { "type": "InventoryPosition!", "description": "The inventory position" }
+      }
+    },
+
+    "ProductConnection": {
+      "kind": "OBJECT",
+      "description": "Paginated products",
+      "fields": {
+        "edges": { "type": "[ProductEdge]!" },
+        "pageInfo": { "type": "PageInfo!" }
+      }
+    },
+
+    "ProductEdge": {
+      "kind": "OBJECT",
+      "fields": {
+        "cursor": { "type": "String!" },
+        "node": { "type": "Product!" }
+      }
+    },
+
+    "OrderConnection": {
+      "kind": "OBJECT",
+      "description": "Paginated orders",
+      "fields": {
+        "edges": { "type": "[OrderEdge]!" },
+        "pageInfo": { "type": "PageInfo!" }
+      }
+    },
+
+    "OrderEdge": {
+      "kind": "OBJECT",
+      "fields": {
+        "cursor": { "type": "String!" },
+        "node": { "type": "Order!" }
+      }
+    },
+
+    "OrderItemConnection": {
+      "kind": "OBJECT",
+      "description": "Paginated order items",
+      "fields": {
+        "edges": { "type": "[OrderItemEdge]!" }
+      }
+    },
+
+    "OrderItemEdge": {
+      "kind": "OBJECT",
+      "fields": {
+        "node": { "type": "OrderItem!" }
+      }
+    },
+
+    "LocationConnection": {
+      "kind": "OBJECT",
+      "fields": {
+        "edges": { "type": "[LocationEdge]!" },
+        "pageInfo": { "type": "PageInfo!" }
+      }
+    },
+
+    "LocationEdge": {
+      "kind": "OBJECT",
+      "fields": {
+        "cursor": { "type": "String!" },
+        "node": { "type": "Location!" }
+      }
+    },
+
+    "CustomerConnection": {
+      "kind": "OBJECT",
+      "fields": {
+        "edges": { "type": "[CustomerEdge]!" },
+        "pageInfo": { "type": "PageInfo!" }
+      }
+    },
+
+    "CustomerEdge": {
+      "kind": "OBJECT",
+      "fields": {
+        "cursor": { "type": "String!" },
+        "node": { "type": "Customer!" }
+      }
+    },
+
+    "CategoryConnection": {
+      "kind": "OBJECT",
+      "fields": {
+        "edges": { "type": "[CategoryEdge]!" }
+      }
+    },
+
+    "CategoryEdge": {
+      "kind": "OBJECT",
+      "fields": {
+        "node": { "type": "Category!" }
+      }
+    },
+
+    "FulfilmentConnection": {
+      "kind": "OBJECT",
+      "fields": {
+        "edges": { "type": "[FulfilmentEdge]!" }
+      }
+    },
+
+    "FulfilmentEdge": {
+      "kind": "OBJECT",
+      "fields": {
+        "node": { "type": "Fulfilment!" }
+      }
+    },
+
+    "FulfilmentItemConnection": {
+      "kind": "OBJECT",
+      "fields": {
+        "edges": { "type": "[FulfilmentItemEdge]!" }
+      }
+    },
+
+    "FulfilmentItemEdge": {
+      "kind": "OBJECT",
+      "fields": {
+        "node": { "type": "FulfilmentItem!" }
+      }
+    },
+
+    "QuantityConnection": {
+      "kind": "OBJECT",
+      "fields": {
+        "edges": { "type": "[QuantityEdge]!" }
+      }
+    },
+
+    "QuantityEdge": {
+      "kind": "OBJECT",
+      "fields": {
+        "node": { "type": "Quantity!" }
+      }
+    },
+
+    "PageInfo": {
+      "kind": "OBJECT",
+      "description": "Pagination information - IMPORTANT: Fluent does NOT return startCursor/endCursor (deviation from Relay spec)",
+      "fields": {
+        "hasNextPage": { "type": "Boolean!", "description": "Whether more records exist (Required)" },
+        "hasPreviousPage": { "type": "Boolean!", "description": "Whether previous records exist (Required)" }
+      },
+      "notAvailableInFluent": {
+        "startCursor": "NOT AVAILABLE - Use edges[0].cursor instead",
+        "endCursor": "NOT AVAILABLE - Use edges[edges.length-1].cursor instead"
+      },
+      "usageNote": "Unlike full Relay spec, Fluent Commerce does NOT return startCursor/endCursor in pageInfo. To get the cursor for the next page, use the cursor from the last edge: edges[edges.length-1].cursor"
+    }
+  },
+
+  "scalars": {
+    "DateTime": {
+      "kind": "SCALAR",
+      "description": "ISO8601 date-time string (e.g., '2025-01-14T10:30:00Z')"
+    },
+    "JSON": {
+      "kind": "SCALAR",
+      "description": "Arbitrary JSON value"
+    }
+  },
+
+  "validationNotes": {
+    "batchAPI": {
+      "limitation": "The Batch API ONLY supports INVENTORY_POSITION entity type with UPSERT action. For ORDER, PRODUCT, LOCATION, or other entities, use GraphQL mutations directly (e.g., createOrder, updateProduct).",
+      "requiredFields": ["retailerId", "action", "entityType", "entities"],
+      "example": "See docs/guides/ingestion.md for complete Batch API usage"
+    },
+    "pagination": {
+      "cursorFields": "All connection types provide `edges[].cursor` and `pageInfo.endCursor` for pagination. Use `endCursor` as the `after` parameter for next page.",
+      "example": "See docs/guides/auto-pagination/ for auto-pagination implementation"
+    },
+    "mutations": {
+      "createOrder": "Requires all fields marked with '!' in CreateOrderInput. See connectors/versori-sfcc-connector/mappings/sfcc-to-fluent-order-mapping.json for complete example.",
+      "upsertInventoryPosition": "Can be used for single position updates. For bulk updates, use Batch API.",
+      "validation": "Run 'npx @fluentcommerce/fc-connect-sdk validate-schema --mapping your-mapping.json --schema this-file.json' to validate your mappings"
+    }
+  },
+
+  "exampleQueries": {
+    "inventoryExtraction": {
+      "description": "Extract inventory positions with product and location details",
+      "query": "query ExtractInventory($after: String, $first: Int!) {\n  inventoryPositions(after: $after, first: $first) {\n    pageInfo {\n      hasNextPage\n      endCursor\n    }\n    edges {\n      cursor\n      node {\n        id\n        ref\n        productRef\n        locationRef\n        qty\n        status\n        createdOn\n        updatedOn\n        product {\n          ref\n          name\n          gtin\n          catalogue {\n            ref\n            name\n          }\n        }\n        location {\n          ref\n          name\n          type\n        }\n      }\n    }\n  }\n}",
+      "variables": {
+        "first": 100,
+        "after": null
+      }
+    },
+
+    "orderDetails": {
+      "description": "Get order details with items and fulfilments",
+      "query": "query GetOrderDetails($ref: String!) {\n  order(ref: $ref) {\n    id\n    ref\n    type\n    status\n    totalPrice\n    totalTaxPrice\n    currency\n    customer {\n      ref\n      email\n      firstName\n      lastName\n    }\n    items {\n      edges {\n        node {\n          ref\n          productRef\n          quantity\n          price\n          totalPrice\n        }\n      }\n    }\n    fulfilments {\n      edges {\n        node {\n          ref\n          status\n          deliveryType\n        }\n      }\n    }\n  }\n}",
+      "variables": {
+        "ref": "ORD-2025-001"
+      }
+    }
+  }
+}