Cập nhật thông tin sản phẩm

API này giúp bạn cập nhật thông tin của một sản phẩm đã tồn tại trong hệ thống, dựa trên product-id được cung cấp trong URL. Bạn chỉ cần truyền các trường muốn thay đổi trong request body — các trường không truyền sẽ được giữ nguyên giá trị hiện tại.

---

Endpoint

🔗Endpoint Staging

PATCH https://staging-manage.api.miniai.vn/api/external/v1/products/{product-id}

Example

https://staging-manage.api.miniai.vn/api/external/v1/products/68c93dba802d36826bc45c9c

🔗Endpoint Production

PATCH https://manage-api.miniap.vn/api/external/v1/products/{product-id}

Tham số đường dẫn (Path Params)

Tham số	Kiểu dữ liệu	Yêu cầu	Mô tả
product-id	string	Bắt buộc	ID của sản phẩm cần cập nhật

Dữ liệu yêu cầu (Request Body)

Request Body

{
    "shopId": "64204a17a5a97a86f12e1f0a",
    "name": "Tên sản phẩm (đã cập nhật)",
    "slug": "ten-san-pham-da-cap-nhat",
    "aliasName": "Tên gợi nhớ nội bộ",
    "description": "Mô tả sản phẩm mới",
    "price": 25000,
    "originPrice": 20000,
    "categoryId": "685ba1be4792d338d2ec3cbe",
    "status": "active",
    "vat": 5,
    "images": [
        "https://dmcl0k8mc5oht.cloudfront.net/64204a17a5a97a86f12e1f0a/e888246f-2647-42f1-9d89-53eacdb7bf64.webp"
    ],
    "itemSku": "Sku",
    "barcode": "12344"
}

Trường	Kiểu dữ liệu	Yêu cầu	Mô tả
shopId	string	Bắt buộc	ID của shop sở hữu sản phẩm
name	string	Tùy chọn	Tên sản phẩm
slug	string	Tùy chọn	Đường dẫn thân thiện (SEO) của sản phẩm
aliasName	string	Tùy chọn	Tên gợi nhớ nội bộ
description	string	Tùy chọn	Mô tả sản phẩm
price	number	Tùy chọn	Giá bán
originPrice	number	Tùy chọn	Giá gốc
categoryId	string	Tùy chọn	ID danh mục sản phẩm
status	string	Tùy chọn	Trạng thái sản phẩm: active hoặc inactive
vat	number	Tùy chọn	Thuế VAT (%)
images	array<string>	Tùy chọn	Danh sách URL hình ảnh sản phẩm
itemSku	string	Tùy chọn	Mã SKU chung của sản phẩm
barcode	string	Tùy chọn	Mã vạch sản phẩm

Ghi chú

• Chỉ shopId là bắt buộc, các trường còn lại đều tùy chọn — chỉ gửi trường nào bạn muốn thay đổi.
• Nếu không truyền slug, hoặc sản phẩm hiện chưa có slug, hệ thống sẽ tự động sinh slug mới dựa trên name.
• API này chỉ dùng để cập nhật thông tin chung của sản phẩm. Việc cập nhật biến thể (SKU/variants) cần sử dụng API riêng cho biến thể sản phẩm.

Phản hồi (Response)

Response

{
    "success": true,
    "message": "success",
    "data": {
        "_id": "68c93dba802d36826bc45c9c",
        "type": "product",
        "name": "Tên sản phẩm (đã cập nhật)",
        "description": "Mô tả sản phẩm mới",
        "search": "ten san pham da cap nhat sku 12344",
        "images": [
            "https://dmcl0k8mc5oht.cloudfront.net/64204a17a5a97a86f12e1f0a/e888246f-2647-42f1-9d89-53eacdb7bf64.webp"
        ],
        "subItemsGroupIds": [],
        "price": 25000,
        "originPrice": 20000,
        "configs": [],
        "tags": "",
        "hashtags": [],
        "canBook": false,
        "shopId": "64204a17a5a97a86f12e1f0a",
        "collectionIDs": [],
        "status": "active",
        "totalRating": 0,
        "totalReview": 0,
        "reservedQuantity": 0,
        "totalQuantity": 0,
        "isNullSortOrder": true,
        "isCustomerInquiry": false,
        "platform": "mini_app",
        "brandProductIds": [],
        "fakeReviewIds": [],
        "comboItems": [],
        "createdAt": "2025-09-16T10:36:42.809Z",
        "updatedAt": "2025-09-16T11:02:10.221Z",
        "__v": 0,
        "customPriceId": null,
        "slug": "ten-san-pham-da-cap-nhat",
        "updatedBy": "64204a17a5a97a86f12e1f0a",
        "virtualSold": 0,
        "aliasName": "Tên gợi nhớ nội bộ",
        "barcode": "12344",
        "categoryId": "685ba1be4792d338d2ec3cbe",
        "itemSku": "Sku",
        "vat": 5,
        "id": "68c93dba802d36826bc45c9c"
    }
}