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

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:

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:

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