{ "info": { "name": "Catalog Domain", "description": "Unified collection for all Catalog Domain API endpoints", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "Products & Sales", "item": [ { "name": "Catalog Products", "item": [ { "name": "Get All Catalog Products", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/catalog-products?page=1&per_page=15", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "catalog-products" ], "query": [ { "key": "page", "value": "1" }, { "key": "per_page", "value": "15" }, { "key": "search", "value": "", "disabled": true }, { "key": "status", "value": "", "disabled": true }, { "key": "product_type", "value": "", "disabled": true } ] }, "description": "Get all catalog products with pagination.\n\nPermission: `catalog-sales-products.view`" }, "response": [ ] }, { "name": "Get Catalog Products Statistics", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/catalog-products/statistics", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "catalog-products", "statistics" ] }, "description": "Get catalog products statistics.\n\nPermission: `catalog-sales-products.view`" }, "response": [ ] }, { "name": "Get Create Form Data", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/catalog-products/create", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "catalog-products", "create" ] }, "description": "Get form data needed for creating a new catalog product (e.g., next code).\n\nPermission: `catalog-sales-products.get-code`" }, "response": [ ] }, { "name": "Get Single Catalog Product", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/catalog-products/{{product_id}}", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "catalog-products", "{{product_id}}" ] }, "description": "Get a single catalog product by ID.\n\nPermission: `catalog-sales-products.view`" }, "response": [ ] }, { "name": "Create Catalog Product", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"title\": {\n \"en\": \"Test Product\",\n \"ar\": \"منتج تجريبي\"\n },\n \"description\": \"Product description\",\n \"catalog_item_id\": 1,\n \"product_type\": \"physical\",\n \"sku\": \"SKU-001\",\n \"quality_grade\": \"oem\",\n \"brand\": \"Brand Name\",\n \"manufacturer\": \"Manufacturer Name\",\n \"origin_country\": \"US\",\n \"certification\": \"ISO 9001\",\n \"warranty_terms\": \"1 year warranty\",\n \"is_preferred\": true,\n \"status\": true,\n \"track_stock\": true,\n \"initial_stock_level\": 100,\n \"min_qty\": 10,\n \"barcode\": \"1234567890\",\n \"barcode_type\": \"barcode\",\n \"is_taxable\": true,\n \"tax_id\": null,\n \"is_returnable\": true,\n \"prices\": [\n {\n \"unit_id\": 1,\n \"purchasing_price\": 50.00,\n \"selling_price\": 75.00,\n \"min_selling_price\": 60.00,\n \"is_main_price\": true,\n \"currency\": \"SAR\"\n }\n ],\n \"tags\": \"electronics,gadgets\",\n \"notes\": \"Internal notes\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/catalog-products", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "catalog-products" ] }, "description": "Create a new catalog product.\n\nPermission: `catalog-sales-products.create`\n\n**Required Fields:**\n- `title.en` - English title (required)\n- `catalog_item_id` - Category item ID (required)\n- `product_type` - physical | digital | spare_part (required)\n- `sku` - Stock Keeping Unit (required)\n- `quality_grade` - oem | compatible | aftermarket | refurbished (required)\n- `prices` - At least one price entry (required)\n\n**Optional Fields:**\n- `title.ar` - Arabic title\n- `description` - Product description\n- `brand` - Brand name\n- `manufacturer` - Manufacturer name\n- `origin_country` - Country of origin\n- `certification` - Certification info\n- `warranty_terms` - Warranty terms\n- `is_preferred` - Preferred product flag\n- `status` - Active status\n- `track_stock` - Track inventory\n- `initial_stock_level` - Initial stock\n- `min_qty` - Minimum quantity\n- `barcode` - Product barcode\n- `tax_id` - Tax ID\n- `is_taxable` - Taxable flag\n- `is_returnable` - Returnable flag" }, "response": [ ] }, { "name": "Update Catalog Product", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"title\": {\n \"en\": \"Updated Product Name\",\n \"ar\": \"اسم المنتج المحدث\"\n },\n \"description\": \"Updated description\",\n \"brand\": \"Updated Brand\",\n \"status\": true,\n \"prices\": [\n {\n \"unit_id\": 1,\n \"purchasing_price\": 55.00,\n \"selling_price\": 80.00,\n \"min_selling_price\": 65.00,\n \"is_main_price\": true,\n \"currency\": \"SAR\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/catalog-products/{{product_id}}", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "catalog-products", "{{product_id}}" ] }, "description": "Update an existing catalog product.\n\nPermission: `catalog-sales-products.edit`\n\nAll fields are optional for update. Only include fields you want to change." }, "response": [ ] }, { "name": "Delete Catalog Product", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/catalog-products/{{product_id}}", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "catalog-products", "{{product_id}}" ] }, "description": "Delete a catalog product (soft delete).\n\nPermission: `catalog-sales-products.delete`" }, "response": [ ] } ], "description": "Catalog Products CRUD operations.\n\nBase: `/api/v1/catalog/catalog-products`" }, { "name": "Products (Legacy)", "item": [ { "name": "Get All Products", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/products?page=1&per_page=15", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "products" ], "query": [ { "key": "page", "value": "1" }, { "key": "per_page", "value": "15" } ] }, "description": "Get all products with pagination.\n\nPermission: `catalog.products.view`" }, "response": [ ] }, { "name": "Create Product", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"catalog_item_id\": 1,\n \"parent_id\": null,\n \"canonical_name\": {\n \"en\": \"Product Name\",\n \"ar\": \"اسم المنتج\"\n },\n \"description\": {\n \"en\": \"Product description\",\n \"ar\": \"وصف المنتج\"\n },\n \"brand\": \"Brand\",\n \"manufacturer\": \"Manufacturer\",\n \"product_type\": \"physical\",\n \"status\": \"active\",\n \"variants\": [\n {\n \"sku\": \"SKU-001\",\n \"barcode\": \"123456789\",\n \"origin_country\": \"US\",\n \"quality_grade\": \"oem\",\n \"is_preferred\": true,\n \"attribute_options\": [1, 2],\n \"prices\": [\n {\n \"price_type_id\": 1,\n \"price\": 100.00,\n \"currency\": \"SAR\"\n }\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/products", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "products" ] }, "description": "Create a new product with variants.\n\nPermission: `catalog.products.create`\n\n**Validation Notes:**\n- `parent_id` validates against `sales_products` table\n- `variants.*.sku` must be unique in `sales_products` table" }, "response": [ ] }, { "name": "Get Single Product", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/products/{{product_id}}", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "products", "{{product_id}}" ] }, "description": "Get a single product by ID.\n\nPermission: `catalog.products.view`" }, "response": [ ] }, { "name": "Update Product", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"canonical_name\": {\n \"en\": \"Updated Product Name\",\n \"ar\": \"اسم المنتج المحدث\"\n },\n \"description\": {\n \"en\": \"Updated description\",\n \"ar\": \"وصف محدث\"\n },\n \"status\": \"active\",\n \"variants\": [\n {\n \"id\": 1,\n \"sku\": \"SKU-001-UPDATED\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/products/{{product_id}}", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "products", "{{product_id}}" ] }, "description": "Update an existing product.\n\nPermission: `catalog.products.edit`\n\n**Validation Notes:**\n- `parent_id` validates against `sales_products` table\n- `variants.*.id` validates against `sales_products` table" }, "response": [ ] }, { "name": "Delete Product", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/products/{{product_id}}", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "products", "{{product_id}}" ] }, "description": "Soft delete a product.\n\nPermission: `catalog.products.delete`" }, "response": [ ] }, { "name": "Force Delete Product", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/products/{{product_id}}/force-delete", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "products", "{{product_id}}", "force-delete" ] }, "description": "Permanently delete a product.\n\nPermission: `catalog.products.delete`" }, "response": [ ] }, { "name": "Restore Product", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/products/{{product_id}}/restore", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "products", "{{product_id}}", "restore" ] }, "description": "Restore a soft-deleted product.\n\nPermission: `catalog.products.restore`" }, "response": [ ] }, { "name": "Bulk Delete Products", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [1, 2, 3]\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/products/bulk-delete", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "products", "bulk-delete" ] }, "description": "Bulk delete multiple products.\n\nPermission: `catalog.products.bulk-delete`" }, "response": [ ] }, { "name": "Bulk Restore Products", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [1, 2, 3]\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/products/bulk-restore", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "products", "bulk-restore" ] }, "description": "Bulk restore multiple soft-deleted products.\n\nPermission: `catalog.products.restore`" }, "response": [ ] } ], "description": "Products CRUD operations (Legacy endpoints).\n\nBase: `/api/v1/catalog/products`" }, { "name": "Product Variants", "item": [ { "name": "Get All Variants", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/product-variants?page=1&per_page=15", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "product-variants" ], "query": [ { "key": "page", "value": "1" }, { "key": "per_page", "value": "15" } ] }, "description": "Get all product variants with pagination.\n\nPermission: `catalog.products.view`" }, "response": [ ] }, { "name": "Create Variant", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"product_id\": 1,\n \"variant_group_id\": null,\n \"sku\": \"VAR-SKU-001\",\n \"barcode\": \"123456789\",\n \"origin_country\": \"US\",\n \"quality_grade\": \"oem\",\n \"manufacturer_location\": \"California\",\n \"certification\": \"ISO 9001\",\n \"warranty_terms\": \"1 year\",\n \"is_preferred\": true,\n \"notes\": \"Variant notes\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/product-variants", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "product-variants" ] }, "description": "Create a new product variant.\n\nPermission: `catalog.products.create`\n\n**Validation Notes:**\n- `product_id` validates against `catalog_items` table\n- `variant_group_id` validates against `catalog_product_variant_groups` table\n- `sku` must be unique in `sales_products` table" }, "response": [ ] }, { "name": "Get Single Variant", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/product-variants/{{product_id}}", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "product-variants", "{{product_id}}" ] }, "description": "Get a single product variant by ID.\n\nPermission: `catalog.products.view`" }, "response": [ ] }, { "name": "Update Variant", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"sku\": \"VAR-SKU-001-UPDATED\",\n \"barcode\": \"987654321\",\n \"quality_grade\": \"compatible\",\n \"is_preferred\": false\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/product-variants/{{product_id}}", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "product-variants", "{{product_id}}" ] }, "description": "Update an existing product variant.\n\nPermission: `catalog.products.edit`\n\n**Validation Notes:**\n- `sku` must be unique in `sales_products` table (excluding current variant)" }, "response": [ ] }, { "name": "Delete Variant", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/product-variants/{{product_id}}", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "product-variants", "{{product_id}}" ] }, "description": "Delete a product variant.\n\nPermission: `catalog.products.delete`" }, "response": [ ] }, { "name": "Restore Variant", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/product-variants/{{product_id}}/restore", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "product-variants", "{{product_id}}", "restore" ] }, "description": "Restore a deleted product variant.\n\nPermission: `catalog.products.restore`" }, "response": [ ] }, { "name": "Get Variants by Product", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/product-variants/product/{{product_id}}", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "product-variants", "product", "{{product_id}}" ] }, "description": "Get all variants for a specific product.\n\nPermission: `catalog.products.view`" }, "response": [ ] } ], "description": "Product Variants CRUD operations.\n\nBase: `/api/v1/catalog/product-variants`\n\n**Note:** After product unification, variants now use `CatalogProduct` from `sales_products` table." }, { "name": "Product Aliases", "item": [ { "name": "Get All Aliases", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/product-aliases?page=1&per_page=15", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "product-aliases" ], "query": [ { "key": "page", "value": "1" }, { "key": "per_page", "value": "15" } ] }, "description": "Get all product aliases with pagination.\n\nPermission: `catalog.products.view`" }, "response": [ ] }, { "name": "Create Alias", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"product_id\": 1,\n \"alias_name\": \"Alternative Product Name\",\n \"alias_type\": \"common_name\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/product-aliases", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "product-aliases" ] }, "description": "Create a new product alias.\n\nPermission: `catalog.products.create`\n\n**Validation Notes:**\n- `product_id` validates against `sales_products` table" }, "response": [ ] }, { "name": "Get Single Alias", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/product-aliases/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "product-aliases", "1" ] }, "description": "Get a single product alias by ID.\n\nPermission: `catalog.products.view`" }, "response": [ ] }, { "name": "Update Alias", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"alias_name\": \"Updated Alias Name\",\n \"alias_type\": \"brand_name\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/product-aliases/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "product-aliases", "1" ] }, "description": "Update an existing product alias.\n\nPermission: `catalog.products.edit`\n\n**Validation Notes:**\n- `product_id` validates against `sales_products` table" }, "response": [ ] }, { "name": "Delete Alias", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/product-aliases/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "product-aliases", "1" ] }, "description": "Delete a product alias.\n\nPermission: `catalog.products.delete`" }, "response": [ ] }, { "name": "Restore Alias", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/product-aliases/1/restore", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "product-aliases", "1", "restore" ] }, "description": "Restore a deleted product alias.\n\nPermission: `catalog.products.restore`" }, "response": [ ] } ], "description": "Product Aliases CRUD operations.\n\nBase: `/api/v1/catalog/product-aliases`" }, { "name": "Product Bundles", "item": [ { "name": "Get All Bundles", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/bundles?page=1&per_page=15", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles" ], "query": [ { "key": "page", "value": "1" }, { "key": "per_page", "value": "15" } ] }, "description": "Get all product bundles with pagination." }, "response": [ ] }, { "name": "Get Available Bundles", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/bundles/available", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "available" ] }, "description": "Get available bundles for customers (active and valid)." }, "response": [ ] }, { "name": "Create Bundle", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"name\": {\n \"en\": \"Summer Bundle\",\n \"ar\": \"حزمة الصيف\"\n },\n \"description\": {\n \"en\": \"Special summer discount bundle\",\n \"ar\": \"حزمة خصم صيفية خاصة\"\n },\n \"bundle_type\": \"fixed\",\n \"status\": \"active\",\n \"discount_type\": \"percentage\",\n \"discount_value\": 15,\n \"min_quantity\": 1,\n \"max_quantity\": 10,\n \"valid_from\": \"2024-06-01\",\n \"valid_until\": \"2024-08-31\",\n \"items\": [\n {\n \"product_id\": 1,\n \"quantity\": 2,\n \"is_required\": true\n },\n {\n \"product_id\": 2,\n \"quantity\": 1,\n \"is_required\": false,\n \"min_quantity\": 1,\n \"max_quantity\": 3\n }\n ],\n \"rules\": [\n {\n \"name\": \"Quantity Discount\",\n \"rule_type\": \"discount\",\n \"condition_field\": \"quantity\",\n \"condition_operator\": \"\u003e=\",\n \"condition_value\": \"5\",\n \"action_type\": \"percentage_discount\",\n \"action_value\": 5,\n \"priority\": 1,\n \"is_active\": true\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/bundles", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles" ] }, "description": "Create a new product bundle.\n\n**Validation Notes:**\n- `items.*.product_id` validates against `sales_products` table" }, "response": [ ] }, { "name": "Get Single Bundle", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/bundles/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "1" ] }, "description": "Get a single bundle with items and rules." }, "response": [ ] }, { "name": "Get Bundle Pricing", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/bundles/1/pricing?quantity=5", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "1", "pricing" ], "query": [ { "key": "quantity", "value": "5" } ] }, "description": "Calculate bundle pricing with discounts and rules." }, "response": [ ] }, { "name": "Get Bundle Stats", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/bundles/1/stats", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "1", "stats" ] }, "description": "Get bundle statistics (items count, pricing, etc.)." }, "response": [ ] }, { "name": "Validate Bundle", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"product_id\": 1,\n \"quantity\": 2\n },\n {\n \"product_id\": 2,\n \"quantity\": 1\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/bundles/1/validate", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "1", "validate" ] }, "description": "Validate bundle items for purchase." }, "response": [ ] }, { "name": "Update Bundle", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"name\": {\n \"en\": \"Updated Bundle Name\"\n },\n \"discount_value\": 20,\n \"status\": \"active\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/bundles/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "1" ] }, "description": "Update an existing bundle.\n\n**Validation Notes:**\n- `items.*.product_id` validates against `sales_products` table" }, "response": [ ] }, { "name": "Delete Bundle", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/bundles/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "1" ] }, "description": "Delete a bundle." }, "response": [ ] }, { "name": "Restore Bundle", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/bundles/1/restore", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "1", "restore" ] }, "description": "Restore a deleted bundle." }, "response": [ ] }, { "name": "Duplicate Bundle", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/bundles/1/duplicate", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "1", "duplicate" ] }, "description": "Duplicate an existing bundle." }, "response": [ ] } ], "description": "Product Bundles CRUD operations.\n\nBase: `/api/v1/catalog/bundles`" }, { "name": "Inventory", "item": [ { "name": "Get All Inventory", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory?page=1&per_page=15", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory" ], "query": [ { "key": "page", "value": "1" }, { "key": "per_page", "value": "15" } ] }, "description": "Get all inventory records with pagination.\n\nPermission: `catalog.inventory.view`" }, "response": [ ] }, { "name": "Create Inventory", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"sales_product_id\": 1,\n \"warehouse_id\": 1,\n \"inventory_type_id\": 1,\n \"quantity\": 100,\n \"min_stock_level\": 10,\n \"max_stock_level\": 500\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/inventory", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory" ] }, "description": "Create a new inventory record.\n\nPermission: `catalog.inventory.create`\n\n**BREAKING CHANGE:**\n- Field renamed from `product_variant_id` to `sales_product_id`\n- Validates against `sales_products` table" }, "response": [ ] }, { "name": "Get Single Inventory", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "1" ] }, "description": "Get a single inventory record.\n\nPermission: `catalog.inventory.view`" }, "response": [ ] }, { "name": "Update Inventory", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"quantity\": 150,\n \"min_stock_level\": 15,\n \"max_stock_level\": 600\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/inventory/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "1" ] }, "description": "Update an inventory record.\n\nPermission: `catalog.inventory.edit`\n\n**BREAKING CHANGE:**\n- Field renamed from `product_variant_id` to `sales_product_id`" }, "response": [ ] }, { "name": "Delete Inventory", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "1" ] }, "description": "Delete an inventory record.\n\nPermission: `catalog.inventory.delete`" }, "response": [ ] }, { "name": "Adjust Inventory", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"adjustment\": 50,\n \"reason\": \"stock_adjustment\",\n \"notes\": \"Manual stock adjustment\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/inventory/1/adjust", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "1", "adjust" ] }, "description": "Adjust inventory quantity (positive or negative).\n\nPermission: `catalog.inventory.edit`" }, "response": [ ] }, { "name": "Get Low Stock", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory/low-stock", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "low-stock" ] }, "description": "Get inventory items below minimum stock level.\n\nPermission: `catalog.inventory.view`" }, "response": [ ] }, { "name": "Get Inventory by Warehouse", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory/warehouse/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "warehouse", "1" ] }, "description": "Get all inventory for a specific warehouse.\n\nPermission: `catalog.inventory.view`" }, "response": [ ] }, { "name": "Get Inventory by Sales Product", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory/sales-product/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "sales-product", "1" ] }, "description": "Get all inventory for a specific sales product.\n\nPermission: `catalog.inventory.view`" }, "response": [ ] } ], "description": "Inventory CRUD operations.\n\nBase: `/api/v1/catalog/inventory`\n\n**BREAKING CHANGES:**\n- Request field renamed: `product_variant_id` → `sales_product_id`\n- Response field renamed: `product_variant_id` → `sales_product_id`\n- Response relation renamed: `product_variant` → `sales_product`" }, { "name": "Client Pricing", "item": [ { "name": "Get Client Pricing", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/products/{{product_id}}/client-pricing", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "products", "{{product_id}}", "client-pricing" ] }, "description": "Get client pricing for a product.\n\nPermission: `catalog.products.pricing`" }, "response": [ ] }, { "name": "Create Client Pricing", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"product_id\": 1,\n \"client_id\": 1,\n \"client_site_id\": null,\n \"unit_id\": 1,\n \"price\": 100.00,\n \"discount_type\": \"percentage\",\n \"discount_value\": 10,\n \"valid_from\": \"2024-01-01\",\n \"valid_to\": \"2024-12-31\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/products/{{product_id}}/client-pricing", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "products", "{{product_id}}", "client-pricing" ] }, "description": "Create client-specific pricing.\n\nPermission: `catalog.products.pricing`\n\n**Validation Notes:**\n- `product_id` validates against `sales_products` table" }, "response": [ ] } ], "description": "Client-specific pricing for products.\n\nBase: `/api/v1/catalog/products/{product}/client-pricing`" }, { "name": "Supplier Pricing", "item": [ { "name": "Get Supplier Pricing", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/products/{{product_id}}/supplier-pricing", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "products", "{{product_id}}", "supplier-pricing" ] }, "description": "Get supplier pricing for a product.\n\nPermission: `catalog.products.pricing`" }, "response": [ ] }, { "name": "Create Supplier Pricing", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"product_id\": 1,\n \"supplier_id\": 1,\n \"driver_id\": null,\n \"unit_id\": 1,\n \"price\": 75.00,\n \"min_order_quantity\": 10,\n \"lead_time_days\": 7,\n \"valid_from\": \"2024-01-01\",\n \"valid_to\": \"2024-12-31\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{BASE_URL}}/catalog/products/{{product_id}}/supplier-pricing", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "products", "{{product_id}}", "supplier-pricing" ] }, "description": "Create supplier-specific pricing.\n\nPermission: `catalog.products.pricing`\n\n**Validation Notes:**\n- `product_id` validates against `sales_products` table" }, "response": [ ] } ], "description": "Supplier-specific pricing for products.\n\nBase: `/api/v1/catalog/products/{product}/supplier-pricing`" } ] }, { "name": "Product Bundles", "item": { "value": [ { "name": "List Bundles", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/bundles?per_page=15&search=&type=fixed", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles" ], "query": [ { "key": "per_page", "value": "15" }, { "key": "search", "value": "" }, { "key": "type", "value": "fixed", "description": "'fixed', 'configurable', 'volume_discount'" } ] }, "description": "Get paginated list of all bundles with optional filtering" }, "response": [ ] }, { "name": "Get Available Bundles", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/bundles/available?per_page=15", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "available" ], "query": [ { "key": "per_page", "value": "15" } ] }, "description": "Get active and valid bundles (customer-facing)" }, "response": [ ] }, { "name": "Create Bundle", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"name\": {\n \"en\": \"Office Starter Pack\",\n \"ar\": \"مجموعة المكتب الأساسية\"\n },\n \"description\": {\n \"en\": \"Complete office setup with desk, chair, and accessories\",\n \"ar\": \"مجموعة المكتب الكاملة مع مكتب وكرسي والملحقات\"\n },\n \"bundle_type\": \"fixed\", // 'fixed', 'configurable', 'volume_discount'\n \"status\": \"active\",\n \"discount_type\": \"percentage\", // 'percentage', 'fixed'\n \"discount_value\": 15,\n \"min_quantity\": 1,\n \"max_quantity\": 100,\n \"valid_from\": \"2025-01-01T00:00:00Z\",\n \"valid_until\": \"2025-12-31T23:59:59Z\",\n \"metadata\": {\n \"category\": \"office\",\n \"target_audience\": \"corporate\"\n },\n \"items\": [\n {\n \"product_id\": 1,\n \"quantity\": 1,\n \"min_quantity\": 1,\n \"max_quantity\": 5,\n \"is_required\": true,\n \"sort_order\": 1\n },\n {\n \"product_id\": 2,\n \"quantity\": 2,\n \"min_quantity\": 1,\n \"max_quantity\": 10,\n \"is_required\": true,\n \"sort_order\": 2\n },\n {\n \"product_id\": 3,\n \"quantity\": 1,\n \"min_quantity\": 1,\n \"max_quantity\": 5,\n \"is_required\": false,\n \"sort_order\": 3\n }\n ],\n \"rules\": [\n {\n \"name\": \"Volume Discount\",\n \"rule_type\": \"discount\",\n \"condition_field\": \"quantity\",\n \"condition_operator\": \"greater_or_equal\",\n \"condition_value\": \"5\",\n \"action_type\": \"percentage_discount\",\n \"action_value\": 10,\n \"priority\": 1,\n \"is_active\": true\n },\n {\n \"name\": \"Bulk Order Discount\",\n \"rule_type\": \"discount\",\n \"condition_field\": \"quantity\",\n \"condition_operator\": \"greater_or_equal\",\n \"condition_value\": \"10\",\n \"action_type\": \"percentage_discount\",\n \"action_value\": 20,\n \"priority\": 2,\n \"is_active\": true\n }\n ]\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/bundles", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles" ] }, "description": "Create a new product bundle with items and pricing rules" }, "response": [ ] }, { "name": "Get Bundle Details", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/bundles/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "1" ] }, "description": "Get complete bundle details with items and rules" }, "response": [ ] }, { "name": "Calculate Bundle Pricing", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/bundles/1/pricing?quantity=5", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "1", "pricing" ], "query": [ { "key": "quantity", "value": "5" } ] }, "description": "Calculate final price with all discounts and rules applied" }, "response": [ ] }, { "name": "Get Bundle Statistics", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/bundles/1/stats", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "1", "stats" ] }, "description": "Get bundle statistics (items count, pricing breakdown, rules)" }, "response": [ ] }, { "name": "Validate Bundle for Purchase", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"product_id\": 1,\n \"quantity\": 1\n },\n {\n \"product_id\": 2,\n \"quantity\": 2\n },\n {\n \"product_id\": 3,\n \"quantity\": 1\n }\n ]\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/bundles/1/validate", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "1", "validate" ] }, "description": "Validate bundle items and quantities before purchase" }, "response": [ ] }, { "name": "Update Bundle", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"name\": {\n \"en\": \"Office Deluxe Pack\",\n \"ar\": \"مجموعة المكتب الفاخرة\"\n },\n \"description\": {\n \"en\": \"Premium office setup with desk, premium chair, and accessories\",\n \"ar\": \"مجموعة المكتب الفاخرة مع مكتب وكرسي فاخر والملحقات\"\n },\n \"bundle_type\": \"configurable\", // 'fixed', 'configurable', 'volume_discount'\n \"status\": \"active\",\n \"discount_type\": \"percentage\", // 'percentage', 'fixed'\n \"discount_value\": 20,\n \"min_quantity\": 1,\n \"max_quantity\": 50,\n \"valid_from\": \"2025-02-01T00:00:00Z\",\n \"valid_until\": \"2025-12-31T23:59:59Z\",\n \"items\": [\n {\n \"product_id\": 1,\n \"quantity\": 1,\n \"min_quantity\": 1,\n \"max_quantity\": 5,\n \"is_required\": true,\n \"sort_order\": 1\n },\n {\n \"product_id\": 2,\n \"quantity\": 2,\n \"min_quantity\": 1,\n \"max_quantity\": 10,\n \"is_required\": true,\n \"sort_order\": 2\n }\n ],\n \"rules\": [\n {\n \"name\": \"Bulk Discount\",\n \"rule_type\": \"discount\",\n \"condition_field\": \"quantity\",\n \"condition_operator\": \"greater_or_equal\",\n \"condition_value\": \"5\",\n \"action_type\": \"percentage_discount\",\n \"action_value\": 15,\n \"priority\": 1,\n \"is_active\": true\n }\n ]\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/bundles/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "1" ] }, "description": "Update an existing bundle with new items and rules" }, "response": [ ] }, { "name": "Delete Bundle", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/bundles/5", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "5" ] }, "description": "Delete a bundle and all its items and rules" }, "response": [ ] }, { "name": "Restore Bundle", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "{{BASE_URL}}/catalog/bundles/1/restore", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "1", "restore" ] }, "description": "Restore a soft-deleted bundle and recover all its data" }, "response": [ ] }, { "name": "Duplicate Bundle", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "{{BASE_URL}}/catalog/bundles/1/duplicate", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "bundles", "1", "duplicate" ] }, "description": "Create a copy of an existing bundle with all its items and rules. The new bundle will have '(Copy)' appended to its name" }, "response": [ ] } ], "Count": 11 } }, { "name": "Categories", "item": { "value": [ { "name": "List Categories", "event": [ { "listen": "test", "script": { "exec": [ "pm.test('Status code is 200', function() {", " pm.response.to.have.status(200);", "});", "", "pm.test('Response has pagination info', function() {", " var jsonData = pm.response.json();", " pm.expect(jsonData.pagination).to.exist;", " pm.expect(jsonData.pagination.total).to.exist;", " pm.expect(jsonData.pagination.per_page).to.exist;", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/categories?page=1&per_page=15&sort_by=created_at&order=desc", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "categories" ], "query": [ { "key": "page", "value": "1", "description": "Page number for pagination (default: 1)" }, { "key": "per_page", "value": "15", "description": "Items per page (default: 15, max: 100)" }, { "key": "sort_by", "value": "created_at", "description": "Field to sort by: name, code, slug, created_at" }, { "key": "order", "value": "desc", "description": "Sort order: asc or desc" }, { "key": "search", "value": "", "description": "Search in name, code, slug fields", "disabled": true }, { "key": "is_active", "value": "true", "description": "Filter by active status (true/false)", "disabled": true }, { "key": "parent_id", "value": "", "description": "Filter by parent category ID", "disabled": true } ] }, "description": "**Endpoint:** GET /\n**Route Name:** catalog-categories.index\n**Permission:** view-category\n**Status:** 200 OK\n\n**Description:** Retrieve all categories with pagination, filtering, and sorting support.\n\n**Query Parameters:**\n- page: Page number (default: 1)\n- per_page: Items per page (default: 15, max: 100)\n- sort_by: Sort field (name, code, slug, created_at)\n- order: Sort order (asc, desc)\n- search: Search text\n- is_active: Filter by active status\n- parent_id: Filter by parent category\n\n**Response (200):**\n```json\n{\n \"success\": true,\n \"message\": \"Categories retrieved successfully\",\n \"data\": [...],\n \"pagination\": {\n \"total\": 10,\n \"per_page\": 15,\n \"current_page\": 1,\n \"last_page\": 1\n }\n}\n```" }, "response": [ ] }, { "name": "Get Category Tree", "event": [ { "listen": "test", "script": { "exec": [ "pm.test('Status code is 200', function() {", " pm.response.to.have.status(200);", "});", "", "pm.test('Response has hierarchical structure', function() {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data).to.be.an('array');", " pm.expect(jsonData.success).to.equal(true);", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/categories/tree", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "categories", "tree" ] }, "description": "**Endpoint:** GET /tree\n**Route Name:** catalog-categories.tree\n**Permission:** view-category\n**Status:** 200 OK\n\n**Description:** Retrieve all categories in hierarchical tree structure with parent-child relationships.\n\n**Response (200):**\n```json\n{\n \"success\": true,\n \"message\": \"Category tree retrieved successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": { \"en\": \"Electronics\", \"ar\": \"الإلكترونيات\" },\n \"slug\": \"electronics\",\n \"code\": \"ELEC-001\",\n \"children\": [\n {\n \"id\": 2,\n \"name\": { \"en\": \"Computers\" },\n \"children\": []\n }\n ]\n }\n ]\n}\n```" }, "response": [ ] }, { "name": "Get Single Category", "event": [ { "listen": "test", "script": { "exec": [ "pm.test('Status code is 200', function() {", " pm.response.to.have.status(200);", "});", "", "pm.test('Response has category data', function() {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data).to.exist;", " pm.expect(jsonData.data.id).to.exist;", " pm.expect(jsonData.data.name).to.exist;", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/categories/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "categories", "1" ] }, "description": "**Endpoint:** GET /{id}\n**Route Name:** catalog-categories.show\n**Permission:** view-category\n**Status:** 200 OK / 404 Not Found\n\n**Description:** Retrieve detailed information for a single category by ID.\n\n**URL Parameters:**\n- id (integer, required): Category ID\n\n**Response (200):**\n```json\n{\n \"success\": true,\n \"message\": \"Category retrieved successfully\",\n \"data\": {\n \"id\": 1,\n \"name\": { \"en\": \"Electronics\", \"ar\": \"الإلكترونيات\" },\n \"slug\": \"electronics\",\n \"code\": \"ELEC-001\",\n \"parent_id\": null,\n \"description\": { \"en\": \"Electronic devices\" },\n \"meta\": { \"icon\": \"laptop\" },\n \"is_active\": true,\n \"created_by\": 1,\n \"created_at\": \"2025-12-19T10:30:00Z\"\n }\n}\n```" }, "response": [ ] }, { "name": "Get Category Children", "event": [ { "listen": "test", "script": { "exec": [ "pm.test('Status code is 200', function() {", " pm.response.to.have.status(200);", "});", "", "pm.test('Response is array', function() {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data).to.be.an('array');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/categories/1/children?sort_by=name&order=asc", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "categories", "1", "children" ], "query": [ { "key": "sort_by", "value": "name", "description": "Sort by: name, code, created_at" }, { "key": "order", "value": "asc", "description": "Sort order: asc or desc" } ] }, "description": "**Endpoint:** GET /{id}/children\n**Route Name:** catalog-categories.children\n**Permission:** view-category\n**Status:** 200 OK\n\n**Description:** Retrieve all subcategories (direct children) of a specific category.\n\n**URL Parameters:**\n- id (integer, required): Parent category ID\n\n**Query Parameters:**\n- sort_by: Sort field (name, code, created_at)\n- order: Sort order (asc, desc)\n\n**Response (200):**\n```json\n{\n \"success\": true,\n \"message\": \"Category children retrieved successfully\",\n \"data\": [\n {\n \"id\": 2,\n \"name\": { \"en\": \"Computers\", \"ar\": \"الحواسيب\" },\n \"slug\": \"computers\",\n \"code\": \"COMP-001\",\n \"parent_id\": 1,\n \"is_active\": true,\n \"created_at\": \"2025-12-19T10:35:00Z\"\n }\n ]\n}\n```" }, "response": [ ] }, { "name": "Create Category", "event": [ { "listen": "test", "script": { "exec": [ "pm.test('Status code is 201', function() {", " pm.response.to.have.status(201);", "});", "", "pm.test('Response has created category data', function() {", " var jsonData = pm.response.json();", " pm.expect(jsonData.success).to.equal(true);", " pm.expect(jsonData.data.id).to.exist;", "});" ], "type": "text/javascript", "packages": { }, "requests": { } } } ], "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"name\": {\n \"en\": \"Electronics\",\n \"ar\": \"الإلكترونيات\",\n \"tr\": \"Elektronik\",\n \"ur\": \"الیکٹرانکس\"\n },\n \"slug\": \"electronics3252\",\n \"code\": \"ELEC-001\",\n \"parent_id\": null,\n \"description\": {\n \"en\": \"Electronic devices and gadgets\",\n \"ar\": \"الأجهزة والأدوات الإلكترونية\",\n \"tr\": \"Elektronik cihazlar ve aksesuarlar\",\n \"ur\": \"الیکٹرانک ڈیوائسز اور سازو سامان\"\n },\n \"meta\": {\n \"icon\": \"laptop\",\n \"color\": \"#FF5722\",\n \"order\": 1\n },\n \"is_active\": true\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/categories", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "categories" ] }, "description": "**Endpoint:** POST /\n**Route Name:** catalog-categories.store\n**Permission:** create-category\n**Status:** 201 Created / 400 Bad Request / 403 Forbidden\n\n**Description:** Create a new category with multilingual support.\n\n**Request Body Fields:**\n- name (object, required): Multilingual names {en, ar, tr, ur}\n- slug (string, required): URL-friendly name (unique)\n- code (string, required): Category code (unique)\n- parent_id (integer, optional): Parent category ID for hierarchy\n- description (object, optional): Multilingual descriptions\n- meta (object, optional): Custom metadata (JSON)\n- is_active (boolean, optional): Active status (default: true)\n\n**Response (201):**\n```json\n{\n \"success\": true,\n \"message\": \"Category created successfully\",\n \"data\": {\n \"id\": 1,\n \"name\": { \"en\": \"Electronics\" },\n \"slug\": \"electronics\",\n \"code\": \"ELEC-001\",\n \"is_active\": true,\n \"created_by\": 1,\n \"created_at\": \"2025-12-19T10:30:00Z\"\n }\n}\n```" }, "response": [ ] }, { "name": "Update Category", "event": [ { "listen": "test", "script": { "exec": [ "pm.test('Status code is 200', function() {", " pm.response.to.have.status(200);", "});", "", "pm.test('Response indicates success', function() {", " var jsonData = pm.response.json();", " pm.expect(jsonData.success).to.equal(true);", "});" ], "type": "text/javascript" } } ], "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"name\": {\n \"en\": \"Electronic Devices\",\n \"ar\": \"أجهزة إلكترونية\",\n \"tr\": \"Elektronik Cihazlar\",\n \"ur\": \"الیکٹرانک ڈیوائسز\"\n },\n \"slug\": \"electronic-devices\",\n \"code\": \"ELEC-002\",\n \"description\": {\n \"en\": \"All types of electronic devices and gadgets\",\n \"ar\": \"جميع أنواع الأجهزة الإلكترونية والملحقات\"\n },\n \"meta\": {\n \"icon\": \"devices\",\n \"color\": \"#2196F3\",\n \"order\": 1\n },\n \"is_active\": true\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/categories/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "categories", "1" ] }, "description": "**Endpoint:** PUT /{id}\n**Route Name:** catalog-categories.update\n**Permission:** update-category\n**Status:** 200 OK / 404 Not Found / 403 Forbidden\n\n**Description:** Update an existing category's details.\n\n**URL Parameters:**\n- id (integer, required): Category ID\n\n**Request Body:** Same fields as Create (all optional)\n\n**Response (200):**\n```json\n{\n \"success\": true,\n \"message\": \"Category updated successfully\",\n \"data\": {\n \"id\": 1,\n \"name\": { \"en\": \"Electronic Devices\" },\n \"slug\": \"electronic-devices\",\n \"code\": \"ELEC-002\",\n \"updated_at\": \"2025-12-19T11:00:00Z\"\n }\n}\n```" }, "response": [ ] }, { "name": "Delete Category", "event": [ { "listen": "test", "script": { "exec": [ "pm.test('Status code is 200', function() {", " pm.response.to.have.status(200);", "});", "", "pm.test('Response indicates deletion', function() {", " var jsonData = pm.response.json();", " pm.expect(jsonData.success).to.equal(true);", "});" ], "type": "text/javascript" } } ], "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/categories/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "categories", "1" ] }, "description": "**Endpoint:** DELETE /{id}\n**Route Name:** catalog-categories.destroy\n**Permission:** delete-category\n**Status:** 200 OK / 404 Not Found / 403 Forbidden\n\n**Description:** Soft delete a category (can be restored). Does NOT permanently delete data.\n\n**URL Parameters:**\n- id (integer, required): Category ID\n\n**Response (200):**\n```json\n{\n \"success\": true,\n \"message\": \"Category deleted successfully\"\n}\n```" }, "response": [ ] }, { "name": "Restore Deleted Category", "event": [ { "listen": "test", "script": { "exec": [ "pm.test('Status code is 200', function() {", " pm.response.to.have.status(200);", "});", "", "pm.test('Response indicates restoration', function() {", " var jsonData = pm.response.json();", " pm.expect(jsonData.success).to.equal(true);", "});" ], "type": "text/javascript" } } ], "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/categories/1/restore", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "categories", "1", "restore" ] }, "description": "**Endpoint:** POST /{id}/restore\n**Route Name:** catalog-categories.restore\n**Permission:** restore-category\n**Status:** 200 OK / 404 Not Found / 403 Forbidden\n\n**Description:** Restore a previously soft-deleted category.\n\n**URL Parameters:**\n- id (integer, required): Category ID (must be deleted)\n\n**Response (200):**\n```json\n{\n \"success\": true,\n \"message\": \"Category restored successfully\",\n \"data\": {\n \"id\": 1,\n \"name\": { \"en\": \"Electronics\" },\n \"slug\": \"electronics\",\n \"is_active\": true,\n \"updated_at\": \"2025-12-19T11:15:00Z\"\n }\n}\n```" }, "response": [ ] }, { "name": "Bulk Delete Categories", "event": [ { "listen": "test", "script": { "exec": [ "pm.test('Status code is 200', function() {", " pm.response.to.have.status(200);", "});", "", "pm.test('Response has deletion info', function() {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data.deleted_count).to.exist;", " pm.expect(jsonData.data.ids).to.be.an('array');", "});" ], "type": "text/javascript" } } ], "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [1, 2, 3]\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/categories/bulk/delete", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "categories", "bulk", "delete" ] }, "description": "**Endpoint:** POST /bulk/delete\n**Route Name:** catalog-categories.bulk-delete\n**Permission:** delete-category\n**Status:** 200 OK / 400 Bad Request / 403 Forbidden\n\n**Description:** Soft delete multiple categories at once. Does NOT permanently delete data.\n\n**Request Body:**\n```json\n{\n \"ids\": [1, 2, 3]\n}\n```\n\n**Request Body Fields:**\n- ids (array, required): Array of category IDs (min: 1, max: 100)\n\n**Response (200):**\n```json\n{\n \"success\": true,\n \"message\": \"Categories deleted successfully\",\n \"data\": {\n \"deleted_count\": 3,\n \"ids\": [1, 2, 3]\n }\n}\n```" }, "response": [ ] } ], "Count": 9 } }, { "name": "Inventory", "item": { "value": [ { "name": "Warehouses", "item": [ { "name": "List Warehouses", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/warehouses?per_page=15", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "warehouses" ], "query": [ { "key": "per_page", "value": "15" }, { "key": "search", "value": "", "disabled": true } ] } }, "response": [ ] }, { "name": "Get Warehouse", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/warehouses/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "warehouses", "1" ] } }, "response": [ ] }, { "name": "Create Warehouse", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"code\": \"WH-001335252\",\n \"name\": \"Main Warehouseefefef\",\n \"location\": \"123 Storage Lane\",\n \"is_active\": true\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/warehouses", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "warehouses" ] } }, "response": [ ] }, { "name": "Update Warehouse", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"code\": \"WH-001335252\",\n \"name\": \"Main Warehouseefefef\",\n \"location\": \"123 Storage Lane\",\n \"is_active\": true\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/warehouses/3", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "warehouses", "3" ] } }, "response": [ ] }, { "name": "Delete Warehouse", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/warehouses/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "warehouses", "1" ] } }, "response": [ ] }, { "name": "Restore Warehouse", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/warehouses/1/restore", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "warehouses", "1", "restore" ] } }, "response": [ ] }, { "name": "Active Warehouses List", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/warehouses/active/list", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "warehouses", "active", "list" ] } }, "response": [ ] }, { "name": "Search Warehouses", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/warehouses/search?q=Main&per_page=15", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "warehouses", "search" ], "query": [ { "key": "q", "value": "Main" }, { "key": "per_page", "value": "15" } ] } }, "response": [ ] }, { "name": "Bulk Delete Warehouses", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [1, 2, 3]\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/warehouses/bulk/delete", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "warehouses", "bulk", "delete" ] } }, "response": [ ] } ], "description": "Warehouse management endpoints" }, { "name": "Inventory", "item": [ { "name": "List Inventory", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory?per_page=15", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory" ], "query": [ { "key": "per_page", "value": "15" }, { "key": "warehouse_id", "value": "", "disabled": true }, { "key": "variant_id", "value": "", "disabled": true } ] } }, "response": [ ] }, { "name": "Get Inventory Record", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "1" ] } }, "response": [ ] }, { "name": "Create Inventory Record", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"product_variant_id\": 5,\n \"warehouse_id\": 1,\n \"inventory_type_id\": 1,\n \"quantity\": \"250.750\"\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/inventory", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory" ] } }, "response": [ ] }, { "name": "Update Inventory Record", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"product_variant_id\": 5,\n \"warehouse_id\": 2,\n \"inventory_type_id\": 1,\n \"quantity\": \"250\"\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/inventory/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "1" ] } }, "response": [ ] }, { "name": "Delete Inventory Record", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "1" ] } }, "response": [ ] }, { "name": "Restore Inventory Record", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory/1/restore", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "1", "restore" ] } }, "response": [ ] }, { "name": "Get Inventory by Warehouse", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory/warehouse/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "warehouse", "1" ] } }, "response": [ ] }, { "name": "Get Inventory by Variant", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory/variant/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "variant", "1" ] } }, "response": [ ] }, { "name": "Low Stock Items", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory/low-stock?threshold=20", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "low-stock" ], "query": [ { "key": "threshold", "value": "20" } ] } }, "response": [ ] }, { "name": "Adjust Inventory Quantity", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"quantity\": 5\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/inventory/1/adjust", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "1", "adjust" ] } }, "response": [ ] }, { "name": "Bulk Delete Inventory", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [1, 2, 3]\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/inventory/bulk/delete", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory", "bulk", "delete" ] } }, "response": [ ] } ], "description": "Inventory records management endpoints" }, { "name": "Transactions", "item": [ { "name": "List Transactions", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/transactions?per_page=15", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "transactions" ], "query": [ { "key": "per_page", "value": "15" }, { "key": "type", "value": "", "disabled": true }, { "key": "warehouse_id", "value": "", "disabled": true } ] } }, "response": [ ] }, { "name": "Get Transaction", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/transactions/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "transactions", "1" ] } }, "response": [ ] }, { "name": "Create Transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"inventory_id\": 1,\n \"warehouse_id\": 1,\n \"inventory_type_id\": 1,\n \"transaction_type\": \"purchase\",\n \"quantity\": \"100.500\",\n \"reference_type\": \"purchase_order\",\n \"reference_id\": \"PO-2025-001\",\n \"notes\": \"Stock received from supplier ABC\"\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/transactions", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "transactions" ] } }, "response": [ ] }, { "name": "Update Transaction", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"inventory_id\": 1,\n \"warehouse_id\": 1,\n \"inventory_type_id\": 1,\n \"transaction_type\": \"purchase\",\n \"quantity\": \"600\",\n \"reference_type\": \"purchase_order\",\n \"reference_id\": \"PO-2025-001\",\n \"notes\": \"Stock received from supplier ABC\"\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/transactions/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "transactions", "1" ] } }, "response": [ ] }, { "name": "Delete Transaction", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/transactions/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "transactions", "1" ] } }, "response": [ ] }, { "name": "Restore Transaction", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/transactions/1/restore", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "transactions", "1", "restore" ] } }, "response": [ ] }, { "name": "Transactions by Type", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/transactions/by-type/purchase", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "transactions", "by-type", "purchase" ] } }, "response": [ ] }, { "name": "Transactions by Warehouse", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/transactions/warehouse/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "transactions", "warehouse", "1" ] } }, "response": [ ] }, { "name": "Transactions by Date Range", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/transactions/date-range?start_date=2025-01-01&end_date=2025-12-31", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "transactions", "date-range" ], "query": [ { "key": "start_date", "value": "2025-01-01" }, { "key": "end_date", "value": "2025-12-31" } ] } }, "response": [ ] }, { "name": "Bulk Delete Transactions", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [1, 2]\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/transactions/bulk/delete", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "transactions", "bulk", "delete" ] } }, "response": [ ] } ], "description": "Transaction management endpoints" } ], "Count": 3 } }, { "name": "Materials", "item": { "value": [ { "name": "List All Materials", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/materials?per_page=15&search=&unit_id=1&is_active=true", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "materials" ], "query": [ { "key": "per_page", "value": "15", "description": "Number of items per page (default: 15)" }, { "key": "search", "value": "", "description": "Search by material name or code" }, { "key": "unit_id", "value": "1", "description": "Filter by unit ID" }, { "key": "is_active", "value": "true", "description": "Filter by active status (true/false)" } ] }, "description": "Get all materials with pagination and filtering. Supports search by name/code, unit filtering, and active status filtering." }, "response": [ ] }, { "name": "Get Single Material", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/materials/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "materials", "1" ] }, "description": "Retrieve a single material by ID" }, "response": [ ] }, { "name": "Create Material", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Steel A36323\",\n \"code\": \"MAT-00132\",\n \"description\": \"High strength structural steel suitable for construction and manufacturing\",\n \"unit_id\": 1,\n \"is_active\": true\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/materials", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "materials" ] }, "description": "Create a new material with name, code, description, unit, and active status" }, "response": [ ] }, { "name": "Update Material", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Updated Steel A36 Grade\",\n \"description\": \"Updated description for high strength structural steel\",\n \"unit_id\": 1,\n \"is_active\": true\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/materials/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "materials", "1" ] }, "description": "Update an existing material. All fields are optional." }, "response": [ ] }, { "name": "Delete Material", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/materials/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "materials", "1" ] }, "description": "Soft delete a material" }, "response": [ ] }, { "name": "Restore Material", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/materials/1/restore", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "materials", "1", "restore" ] }, "description": "Restore a soft-deleted material" }, "response": [ ] }, { "name": "Get Active Materials", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/materials/active/list?per_page=50", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "materials", "active", "list" ], "query": [ { "key": "per_page", "value": "50", "description": "Number of active materials per page (default: 50)" } ] }, "description": "Get all active materials with pagination" }, "response": [ ] }, { "name": "Bulk Delete Materials", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [10, 11]\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/materials/bulk/delete", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "materials", "bulk", "delete" ] }, "description": "Bulk delete multiple materials by their IDs" }, "response": [ ] } ], "Count": 8 } }, { "name": "Services", "item": { "value": [ { "name": "Services", "item": [ { "name": "List All Services", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/services?per_page=15&search=&category=maintenance&is_active=true", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "services" ], "query": [ { "key": "per_page", "value": "15", "description": "Number of items per page (default: 15)" }, { "key": "search", "value": "", "description": "Search by service name" }, { "key": "category", "value": "maintenance", "description": "Filter by service type: maintenance, installation, inspection, consultation, training, emergency" }, { "key": "is_active", "value": "true", "description": "Filter by active status" } ] }, "description": "Get all services with pagination and filtering. Search parameter is built into index for seamless filtering." }, "response": [ ] }, { "name": "Get Single Service", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/services/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "services", "1" ] }, "description": "Retrieve a single service by ID" }, "response": [ ] }, { "name": "Create Service", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"catalog_item_id\": 1,\n \"name\": {\n \"en\": \"Premium Maintenance Service\",\n \"ar\": \"خدمة الصيانة المميزة\"\n },\n \"description\": {\n \"en\": \"Comprehensive maintenance service covering all equipment checks and repairs\",\n \"ar\": \"خدمة صيانة شاملة تغطي جميع فحوصات المعدات والإصلاحات\"\n },\n \"service_type\": \"maintenance\",\n \"billing_method\": \"hourly\",\n \"estimated_duration_minutes\": 120,\n \"requires_visit\": true,\n \"is_contract_based\": false\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/services", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "services" ] }, "description": "Create a new service.\n\nService type values: maintenance, installation, inspection, consultation, training, emergency\n\nBilling method values: fixed, hourly, daily, per_visit, per_unit" }, "response": [ ] }, { "name": "Update Service", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"catalog_item_id\": 1,\n \"name\": {\n \"en\": \"Premium Maintenance Service\",\n \"ar\": \"خدمة الصيانة المميزة\"\n },\n \"description\": {\n \"en\": \"Comprehensive maintenance service covering all equipment checks and repairs\",\n \"ar\": \"خدمة صيانة شاملة تغطي جميع فحوصات المعدات والإصلاحات\"\n },\n \"service_type\": \"maintenance\",\n \"billing_method\": \"hourly\",\n \"estimated_duration_minutes\": 150,\n \"requires_visit\": true,\n \"is_contract_based\": true\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/services/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "services", "1" ] }, "description": "Update an existing service. All fields are optional." }, "response": [ ] }, { "name": "Delete Service", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/services/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "services", "1" ] }, "description": "Soft delete a service" }, "response": [ ] }, { "name": "Restore Service", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/services/1/restore", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "services", "1", "restore" ] }, "description": "Restore a soft-deleted service" }, "response": [ ] } ], "description": "Services CRUD operations" }, { "name": "Service Prices", "item": [ { "name": "List All Service Prices", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/services/prices?per_page=15", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "services", "prices" ], "query": [ { "key": "per_page", "value": "15", "description": "Number of items per page" } ] }, "description": "Get all service prices across all services with pagination" }, "response": [ ] }, { "name": "Get Prices By Service", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/services/1/prices", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "services", "1", "prices" ] }, "description": "Get all prices for a specific service" }, "response": [ ] }, { "name": "Get Active Prices By Service", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/services/1/prices/active", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "services", "1", "prices", "active" ] }, "description": "Get currently active prices for a specific service (based on valid_from and valid_to dates)" }, "response": [ ] }, { "name": "Get Single Price", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/services/1/prices/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "services", "1", "prices", "1" ] }, "description": "Retrieve a single service price by ID" }, "response": [ ] }, { "name": "Create Service Price", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"service_id\": 1,\n \"price\": 150.00,\n \"currency\": \"USD\",\n \"valid_from\": \"2025-01-01\",\n \"valid_to\": \"2025-12-31\"\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/services/1/prices", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "services", "1", "prices" ] }, "description": "Create a new price for a service. Currency should be 3-character ISO code (USD, EUR, AED, etc.)" }, "response": [ ] }, { "name": "Update Service Price", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "body": { "mode": "raw", "raw": "{\n \"price\": 150.00,\n \"currency\": \"USD\",\n \"valid_from\": \"2025-01-01\",\n \"valid_to\": \"2025-12-29\"\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/services/1/prices/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "services", "1", "prices", "1" ] }, "description": "Update an existing service price. All fields are optional." }, "response": [ ] }, { "name": "Delete Service Price", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/services/1/prices/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "services", "1", "prices", "1" ] }, "description": "Soft delete a service price" }, "response": [ ] }, { "name": "Restore Service Price", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}" } ], "url": { "raw": "{{BASE_URL}}/catalog/services/1/prices/1/restore", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "services", "1", "prices", "1", "restore" ] }, "description": "Restore a soft-deleted service price" }, "response": [ ] } ], "description": "Service pricing management" } ], "Count": 2 } }, { "name": "Units", "item": { "value": [ { "name": "Units", "item": [ { "name": "List Units", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/units?page=1&per_page=15", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "units" ], "query": [ { "key": "page", "value": "1" }, { "key": "per_page", "value": "15" }, { "key": "unit_category_id", "value": "", "disabled": true }, { "key": "is_base", "value": "", "disabled": true }, { "key": "search", "value": "", "disabled": true } ] }, "description": "Retrieve all units with pagination and optional filtering by unit_category_id, is_base, or search by code/name/symbol" }, "response": [ ] }, { "name": "Create Unit", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"unit_category_id\": 1,\r\n \"code\": \"kg2\",\r\n \"name\": \"Kilogram2222\",\r\n \"symbol\": \"kg\",\r\n \"is_base\": true\r\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/units", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "units" ] }, "description": "Create a new unit" }, "response": [ ] }, { "name": "Get Unit", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/units/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "units", "1" ] }, "description": "Retrieve a specific unit" }, "response": [ ] }, { "name": "Update Unit", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"unit_category_id\": 1,\r\n \"code\": \"kg2update\",\r\n \"name\": \"Kilogram (Updated)\",\r\n \"symbol\": \"KGGG\",\r\n \"is_base\": true\r\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/units/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "units", "1" ] }, "description": "Update an existing unit" }, "response": [ ] }, { "name": "Delete Unit", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/units/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "units", "1" ] }, "description": "Delete (soft-delete) a unit" }, "response": [ ] } ], "description": "Unit management endpoints (5 endpoints)" }, { "name": "Unit Categories", "item": [ { "name": "List Unit Categories", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/unit-categories?page=1&per_page=15", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "unit-categories" ], "query": [ { "key": "page", "value": "1" }, { "key": "per_page", "value": "15" }, { "key": "search", "value": "", "disabled": true } ] }, "description": "Retrieve all unit categories with pagination and optional search by code or name" }, "response": [ ] }, { "name": "Create Unit Category", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"code\": \"weightaaaa\",\r\n \"name\": \"Weight Unitsaaaa\"\r\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/unit-categories", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "unit-categories" ] }, "description": "Create a new unit category" }, "response": [ ] }, { "name": "Get Unit Category", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/unit-categories/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "unit-categories", "1" ] }, "description": "Retrieve a specific unit category" }, "response": [ ] }, { "name": "Update Unit Category", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"name\": \"Weight Units (Updated)\"\r\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/unit-categories/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "unit-categories", "1" ] }, "description": "Update an existing unit category" }, "response": [ ] }, { "name": "Delete Unit Category", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/unit-categories/3", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "unit-categories", "3" ] }, "description": "Delete (soft-delete) a unit category" }, "response": [ ] } ], "description": "Unit category management endpoints (5 endpoints)" }, { "name": "Unit Conversions", "item": [ { "name": "List Unit Conversions", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/unit-conversions?page=1&per_page=15", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "unit-conversions" ], "query": [ { "key": "page", "value": "1" }, { "key": "per_page", "value": "15" }, { "key": "from_unit_id", "value": "", "disabled": true }, { "key": "to_unit_id", "value": "", "disabled": true } ] }, "description": "Retrieve all unit conversions with pagination and optional filtering by from_unit_id or to_unit_id" }, "response": [ ] }, { "name": "Create Unit Conversion", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"from_unit_id\": 1,\r\n \"to_unit_id\": 2,\r\n \"multiplier\": 1000.000000\r\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/unit-conversions", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "unit-conversions" ] }, "description": "Create a new unit conversion" }, "response": [ ] }, { "name": "Get Unit Conversion", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/unit-conversions/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "unit-conversions", "1" ] }, "description": "Retrieve a specific unit conversion" }, "response": [ ] }, { "name": "Update Unit Conversion", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"from_unit_id\": 1,\r\n \"to_unit_id\": 2,\r\n \"multiplier\": 1000.000000\r\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/unit-conversions/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "unit-conversions", "1" ] }, "description": "Update an existing unit conversion" }, "response": [ ] }, { "name": "Delete Unit Conversion", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/unit-conversions/2", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "unit-conversions", "2" ] }, "description": "Delete (soft-delete) a unit conversion" }, "response": [ ] } ], "description": "Unit conversion management endpoints (5 endpoints)" } ], "Count": 3 } }, { "name": "Inventory Types", "item": { "value": [ { "name": "InventoryTypes", "item": [ { "name": "List All InventoryTypes", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory-types?per_page=15&search=", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory-types" ], "query": [ { "key": "per_page", "value": "15", "description": "Items per page" }, { "key": "search", "value": "", "description": "Search by code or name" } ] }, "description": "Get all inventory types with pagination and search support" }, "response": [ { "name": "200 Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Authorization", "value": "Bearer token", "type": "text" } ], "url": { "raw": "http://localhost:8000/api/v1/catalog/inventory-types?per_page=15", "protocol": "http", "host": [ "localhost" ], "port": "8000", "path": [ "api", "v1", "catalog", "inventory-types" ], "query": [ { "key": "per_page", "value": "15" } ] } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": 1,\n \"code\": \"STOCK\",\n \"name\": \"Available Stock\",\n \"affects_availability\": true,\n \"inventory_count\": 150,\n \"transaction_count\": 45,\n \"created_at\": \"2025-12-24T10:00:00Z\",\n \"updated_at\": \"2025-12-24T10:00:00Z\",\n \"deleted_at\": null\n },\n {\n \"id\": 2,\n \"code\": \"DAMAGED\",\n \"name\": \"Damaged Items\",\n \"affects_availability\": false,\n \"inventory_count\": 25,\n \"transaction_count\": 12,\n \"created_at\": \"2025-12-24T10:05:00Z\",\n \"updated_at\": \"2025-12-24T10:05:00Z\",\n \"deleted_at\": null\n }\n ],\n \"meta\": {\n \"current_page\": 1,\n \"per_page\": 15,\n \"total\": 2\n }\n}" } ] }, { "name": "Get Single InventoryType", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory-types/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory-types", "1" ] }, "description": "Get a single inventory type by ID" }, "response": [ { "name": "200 Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Authorization", "value": "Bearer token", "type": "text" } ], "url": { "raw": "http://localhost:8000/api/v1/catalog/inventory-types/1", "protocol": "http", "host": [ "localhost" ], "port": "8000", "path": [ "api", "v1", "catalog", "inventory-types", "1" ] } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": 1,\n \"code\": \"STOCK\",\n \"name\": \"Available Stock\",\n \"affects_availability\": true,\n \"inventory_count\": 150,\n \"transaction_count\": 45,\n \"created_at\": \"2025-12-24T10:00:00Z\",\n \"updated_at\": \"2025-12-24T10:00:00Z\",\n \"deleted_at\": null\n }\n}" } ] }, { "name": "Create InventoryType", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"code\": \"RESERVED\",\n \"name\": \"Reserved Stock\",\n \"affects_availability\": false\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/inventory-types", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory-types" ] }, "description": "Create a new inventory type\n\nRequired fields:\n- code (string, max:50, unique)\n- name (string, max:255)\n\nOptional fields:\n- affects_availability (boolean, default: true)" }, "response": [ { "name": "201 Created", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Authorization", "value": "Bearer token", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"code\": \"RESERVED\",\n \"name\": \"Reserved Stock\",\n \"affects_availability\": false\n}" }, "url": { "raw": "http://localhost:8000/api/v1/catalog/inventory-types", "protocol": "http", "host": [ "localhost" ], "port": "8000", "path": [ "api", "v1", "catalog", "inventory-types" ] } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": 3,\n \"code\": \"RESERVED\",\n \"name\": \"Reserved Stock\",\n \"affects_availability\": false,\n \"inventory_count\": 0,\n \"transaction_count\": 0,\n \"created_at\": \"2025-12-24T10:10:00Z\",\n \"updated_at\": \"2025-12-24T10:10:00Z\",\n \"deleted_at\": null\n }\n}" }, { "name": "422 Validation Error", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Authorization", "value": "Bearer token", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"code\": \"STOCK\",\n \"name\": \"Duplicate Code\"\n}" }, "url": { "raw": "http://localhost:8000/api/v1/catalog/inventory-types", "protocol": "http", "host": [ "localhost" ], "port": "8000", "path": [ "api", "v1", "catalog", "inventory-types" ] } }, "status": "Unprocessable Entity", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"The code field must be unique.\",\n \"errors\": {\n \"code\": [\n \"The code field must be unique.\"\n ]\n }\n}" } ] }, { "name": "Update InventoryType", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"code\": \"STOCK\",\n \"name\": \"Available Stock (Updated)\",\n \"affects_availability\": true\n}" }, "url": { "raw": "{{BASE_URL}}/catalog/inventory-types/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory-types", "1" ] }, "description": "Update an existing inventory type\n\nAll fields are optional during update:\n- code (string, max:50, unique except self)\n- name (string, max:255)\n- affects_availability (boolean)" }, "response": [ { "name": "200 Success", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Authorization", "value": "Bearer token", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"code\": \"STOCK\",\n \"name\": \"Available Stock (Updated)\",\n \"affects_availability\": true\n}" }, "url": { "raw": "http://localhost:8000/api/v1/catalog/inventory-types/1", "protocol": "http", "host": [ "localhost" ], "port": "8000", "path": [ "api", "v1", "catalog", "inventory-types", "1" ] } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": 1,\n \"code\": \"STOCK\",\n \"name\": \"Available Stock (Updated)\",\n \"affects_availability\": true,\n \"inventory_count\": 150,\n \"transaction_count\": 45,\n \"created_at\": \"2025-12-24T10:00:00Z\",\n \"updated_at\": \"2025-12-24T10:15:00Z\",\n \"deleted_at\": null\n }\n}" } ] }, { "name": "Delete InventoryType", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory-types/1", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory-types", "1" ] }, "description": "Delete (soft delete) an inventory type\n\nNote: This performs a soft delete, the record remains in the database with a deleted_at timestamp" }, "response": [ { "name": "200 Success", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Authorization", "value": "Bearer token", "type": "text" } ], "url": { "raw": "http://localhost:8000/api/v1/catalog/inventory-types/1", "protocol": "http", "host": [ "localhost" ], "port": "8000", "path": [ "api", "v1", "catalog", "inventory-types", "1" ] } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": null,\n \"message\": \"catalog.inventory_types.deleted\"\n}" } ] }, { "name": "Restore InventoryType", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Authorization", "value": "Bearer {{TOKEN}}", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog/inventory-types/1/restore", "host": [ "{{BASE_URL}}" ], "path": [ "catalog", "inventory-types", "1", "restore" ] }, "description": "Restore a soft-deleted inventory type\n\nNote: Requires the deleted_at timestamp to be set (must have been previously deleted)" }, "response": [ { "name": "200 Success", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Authorization", "value": "Bearer token", "type": "text" } ], "url": { "raw": "http://localhost:8000/api/v1/catalog/inventory-types/1/restore", "protocol": "http", "host": [ "localhost" ], "port": "8000", "path": [ "api", "v1", "catalog", "inventory-types", "1", "restore" ] } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": 1,\n \"code\": \"STOCK\",\n \"name\": \"Available Stock\",\n \"affects_availability\": true,\n \"inventory_count\": 150,\n \"transaction_count\": 45,\n \"created_at\": \"2025-12-24T10:00:00Z\",\n \"updated_at\": \"2025-12-24T10:15:00Z\",\n \"deleted_at\": null\n }\n}" } ] } ] }, { "name": "Setup", "item": [ { "name": "Login (Get Token)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"email\": \"super_admin@example.com\",\n \"password\": \"password\"\n}" }, "url": { "raw": "{{BASE_URL}}/auth/login", "host": [ "{{BASE_URL}}" ], "path": [ "auth", "login" ] }, "description": "Login to get authentication token\n\nUse the returned token in the auth_token variable" }, "response": [ { "name": "200 Success", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"email\": \"super_admin@example.com\",\n \"password\": \"password\"\n}" }, "url": { "raw": "http://localhost:8000/api/v1/auth/login", "protocol": "http", "host": [ "localhost" ], "port": "8000", "path": [ "api", "v1", "auth", "login" ] } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"token\": \"1|abc123def456ghi789jkl...\",\n \"user\": {\n \"id\": 1,\n \"name\": \"Super Admin\",\n \"email\": \"super_admin@example.com\"\n }\n }\n}" } ] } ] } ], "Count": 2 } } ], "variable": [ { "key": "BASE_URL", "value": "http://localhost/api/v1", "type": "string" }, { "key": "product_id", "value": "1", "type": "string" } ] }