# Product Management

> Product CRUD, batch operations, image and attribute management, variants, filtering and sorting. Use when creating, updating, deleting, or listing products in a Teleshop store.

- Skill: `agents-store/product-management` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agents-store/product-management`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agents-store/product-management/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: agents-store (https://skillmd.com/u/agents-store)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/agents-store/product-management

---


# Product Management

This skill covers all product operations in a Teleshop store — creating, reading, updating, deleting products individually or in batches, managing product images and attributes.

## Available Tools

| Tool | Description |
|------|-------------|
| `list_products` | List products with pagination, search, and filters |
| `get_product` | Get single product details by ID |
| `create_product` | Create a new product |
| `batch_create_products` | Create multiple products at once |
| `update_product` | Update an existing product |
| `delete_product` | Delete a product |
| `batch_delete_products` | Delete multiple products at once |
| `update_product_images` | Update product images by image IDs |
| `update_product_attributes` | Update product attributes (color, size, etc.) |

## Listing Products

### List with Filters
```
Tool: list_products
Input: {
  "search": "iPhone",
  "page": 1,
  "limit": 20,
  "sortBy": "createdAt",
  "sortOrder": "DESC",
  "category": "Electronics",
  "sellStatus": "available",
  "isActive": true
}
```

**Filter Parameters:**

| Parameter | Type | Values | Description |
|-----------|------|--------|-------------|
| search | string | any | Search by product title |
| page | number | 1+ | Page number |
| limit | number | 1-100 | Items per page |
| sortBy | string | id, title, price, quantity, createdAt, updatedAt, category | Sort field |
| sortOrder | string | ASC, DESC | Sort direction |
| category | string | any | Filter by category name |
| visibility | string | catalog, parent | Product visibility type |
| sellStatus | string | available, unavailable, preorder | Product sell status |
| stockControl | boolean | true/false | Filter by stock control enabled |
| isActive | boolean | true/false | Filter active/inactive products |
| lonely | boolean | true/false | Filter products without variants |

**Response:** `{ items: ProductDto[], meta: { currentPage, itemCount, itemsPerPage, totalItems, totalPages } }`

## Getting a Single Product

```
Tool: get_product
Input: {"id": 123}

Returns full ProductDto with: id, sku, title, description, price, discountPrice,
sellStatus, visibility, quantity, stockControl, isActive, categoryId,
images[], attributes[], priceRules[], variants info.
```

## Creating Products

### Create Single Product
```
Tool: create_product
Input: {
  "sku": "SKU-001",
  "title": "iPhone 15 Pro",
  "description": "Latest iPhone with titanium design",
  "price": 999.99,
  "discountPrice": 899.99,
  "quantity": 50,
  "categoryId": 1,
  "sellStatus": "available",
  "visibility": "catalog",
  "stockControl": true,
  "isActive": true
}
```

**Required fields:** sku, title, description, price, quantity

**Optional fields:**

| Field | Type | Description |
|-------|------|-------------|
| discountPrice | number | Discounted price (must be < price) |
| visibility | string | "catalog" (default) or "parent" |
| sellStatus | string | "available", "unavailable", "preorder" |
| categoryId | number | Category ID to assign |
| stockControl | boolean | Enable stock tracking |
| enableFormatTitle | boolean | Auto-format title |
| isActive | boolean | Active in store |
| rawAttributes | array | Attributes as [name, value, type] tuples |
| imageIds | array | Image IDs to attach |
| variantIds | array | Variant product IDs |
| isHaveVariants | boolean | Mark as parent with variants |

### Create with Attributes (rawAttributes format)
```
Tool: create_product
Input: {
  "sku": "TSHIRT-RED-XL",
  "title": "Red T-Shirt XL",
  "description": "Cotton t-shirt",
  "price": 29.99,
  "quantity": 100,
  "rawAttributes": [
    ["Color", "Red", "color"],
    ["Size", "XL", "text"],
    ["Material", "Cotton", "text"]
  ]
}
```

### Batch Create Products
```
Tool: batch_create_products
Input: {
  "products": [
    { "sku": "SKU-001", "title": "Product 1", "description": "...", "price": 10, "quantity": 5 },
    { "sku": "SKU-002", "title": "Product 2", "description": "...", "price": 20, "quantity": 10 }
  ]
}

Response: { createdIds: string[], count: number }
```

## Updating Products

### Update Product Fields
```
Tool: update_product
Input: {
  "id": 123,
  "title": "iPhone 15 Pro Max",
  "price": 1099.99,
  "discountPrice": 999.99,
  "quantity": 200,
  "sellStatus": "available"
}
```
All fields are optional — only send what you want to change.

### Update Product Images
```
Tool: update_product_images
Input: {
  "id": 123,
  "imageIds": [1, 2, 3]
}
```
Replaces all current images with the provided image IDs.

### Update Product Attributes
```
Tool: update_product_attributes
Input: {
  "id": 123,
  "attributes": [
    { "field": "Color", "value": "#FF0000", "type": "color", "colorName": "Red" },
    { "field": "Size", "value": "XL", "type": "text" },
    { "field": "Material", "value": "Cotton", "type": "text" }
  ]
}
```

**Attribute types:**
- `text` — plain text value
- `color` — hex color value with optional colorName
- `select` — value from predefined list

## Deleting Products

### Delete Single Product
```
Tool: delete_product
Input: {"id": 123}
```

### Batch Delete Products
```
Tool: batch_delete_products
Input: {"productIds": [1, 2, 3, 4, 5]}
```

## Common Workflows

### Add Product with Category and Attributes
```
1. list_categories() -> Find or create target category
2. create_product(sku, title, description, price, quantity, categoryId, rawAttributes) -> Create product
3. update_product_images(id, imageIds) -> Attach images if needed
```

### Bulk Price Update
```
1. list_products(category="Sale Items") -> Get products to update
2. For each product: update_product(id, price, discountPrice) -> Update prices
```

### Product Variant Setup
```
1. create_product(visibility="parent", isHaveVariants=true) -> Create parent
2. batch_create_products(products with variantIds) -> Create variants
3. update_product(parentId, variantIds=[...]) -> Link variants to parent
```

## Enums Reference

**sellStatus:** `available` | `unavailable` | `preorder`
**visibility:** `catalog` (visible in store) | `parent` (variant parent, not directly visible)
**sortBy:** `id` | `title` | `price` | `quantity` | `createdAt` | `updatedAt` | `category`

## Best Practices

1. **Always set SKU** — SKU must be unique across the store
2. **Enable stockControl** for physical goods to prevent overselling
3. **Use batch operations** for bulk imports (more efficient than individual creates)
4. **Set discountPrice < price** — the API will reject if discount >= regular price
5. **Use rawAttributes** on create, **update_product_attributes** for updates
6. **Check category exists** before assigning categoryId