category-management

# Category Management This skill covers category operations — creating category hierarchies, listing, updating, and deleting categories individually or in batches. ## Available Tools | Tool | Description | |------|-------------| | `list_categories` | List categories with search and sorting | | `get_category` | Get single category details | | `create_category` | Create a new category | | `batch_create_categories` | Create multiple categories at once | | `update_category` | Update an existing category | | `delete_category` | Delete a category | | `batch_delete_categories` | Delete multiple categories at once | ## Listing Categories ``` Tool: list_categories Input: { "search": "Electronics", "sortBy": "position", "sortOrder": "ASC" } ``` **Parameters:** | Parameter | Type | Values | Description | |-----------|------|--------|-------------| | search | string | any | Search by category title | | sortBy | string | id, title, createdAt, updatedAt, position | Sort field | | sortOrder | string | ASC, DESC | Sort direction | **Response:** `{ items: CategoryDto[], meta: PaginationMetaDto }` **CategoryDto fields:** id, title, parentId, categoryNumber, position, orderBy, shopId, createdAt, updatedAt, image, parent ## Getting a Category ``` Tool: get_category Input: {"id": 5} Returns category with parent info and image. ``` ## Creating Categories ### Create Simple Category ``` Tool: create_category Input: { "title": "Electronics" } ``` ### Create Subcategory ``` Tool: create_category Input: { "title": "Smartphones", "parentId": 5, "orderBy": "popular" } ``` **Fields:** | Field | Type | Required | Description | |-------|------|----------|-------------| | title | string | YES | Category name | | orderBy | string | no | Default product sort: cheap, expensive, novelty, popular | | parentId | number | no | Parent category ID (for subcategories) | | imageId | number | no | Image ID for category thumbnail | ### Batch Create Categories ``` Tool: batch_create_categories Input: { "categories": [ { "title": "Clothing" }, { "title": "T-Shirts", "parentId": 10 }, { "title": "Jeans", "parentId": 10 }, { "title": "Shoes" } ] } ``` ## Updating Categories ``` Tool: update_category Input: { "id": 5, "title": "Consumer Electronics", "orderBy": "novelty" } ``` All fields are optional — only send what you want to change. ## Deleting Categories ### Delete Single Category ``` Tool: delete_category Input: {"id": 5} ``` Note: Default categories cannot be deleted. Products in deleted categories may need reassignment. ### Batch Delete Categories ``` Tool: batch_delete_categories Input: {"categoryIds": [10, 11, 12]} ``` ## Product Ordering in Categories The `orderBy` field controls how products are sorted by default within a category: | Value | Description | |-------|-------------| | `cheap` | Cheapest first (price ASC) | | `expensive` | Most expensive first (price DESC) | | `novelty` | Newest first (createdAt DESC) | | `popular` | Most popular first | ## Common Workflows ### Build Category Hierarchy ``` 1. create_category(title="Clothing") -> Get parent ID 2. create_category(title="Men", parentId=parentId) -> Subcategory 3. create_category(title="Women", parentId=parentId) -> Subcategory 4. create_category(title="T-Shirts", parentId=menId) -> Sub-subcategory ``` ### Reorganize Categories ``` 1. list_categories() -> View current structure 2. update_category(id, parentId=newParentId) -> Move to new parent 3. update_category(id, title="New Name") -> Rename ``` ### Clean Up Empty Categories ``` 1. list_categories() -> Get all categories 2. For each: list_products(category=title) -> Check if empty 3. batch_delete_categories(categoryIds=[empty ones]) -> Remove empties ``` ## Best Practices 1. **Plan hierarchy first** before creating categories 2. **Use batch_create_categories** for initial store setup 3. **Set orderBy** based on category type (novelty for new arrivals, cheap for budget categories) 4. **Use parentId** to create up to 3 levels of nesting 5. **Don't delete categories with products** — reassign products first