Chuyển tới nội dung chính

Tạo sản phẩm mới

API này giúp bạn tạo một sản phẩm mới trong hệ thống. Bạn cần cung cấp các thông tin cần thiết về sản phẩm như tên, giá, mô tả, danh mục, v.v.

Endpoint​

🔗Endpoint Staging
POST https://staging.manage-api.miniap.vn/api/external/v1/products
🔗Endpoint Production
POST https://manage-api.miniap.vn/api/external/v1/products

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

{
    "name": "Tên sản phẩm",
    "description": "Tên sản phẩm",
    "price": 20000,
    "originPrice": 15000,
    "category": "685ba1be4792d338d2ec3cbe",
    "status": "active",
    "stock_quantity": 12000,
    "vat": 5,
    "images": [
        "https://dmcl0k8mc5oht.cloudfront.net/64204a17a5a97a86f12e1f0a/e888246f-2647-42f1-9d89-53eacdb7bf64.webp"
    ],
    "skus": [
        {
            "name": "Xanh / S",
            "price": 20000,
            "originPrice": 15000,
            "stock_quantity": 0,
            "sku": "Sku04",
            "barcode": "51515hahah",
            "variantOptionIds": [
                "option-1749727727271",
                "option-1749727740208"
            ]
        },
        {
            "name": "Xanh / L",
            "price": 20000,
            "originPrice": 15000,
            "stock_quantity": 0,
            "sku": "Sku03",
            "barcode": "152525h",
            "variantOptionIds": [
                "option-1749727727271",
                "option-1749727746449"
            ]
        },
        {
            "name": "Do / S",
            "price": 20000,
            "originPrice": 15000,
            "stock_quantity": 16,
            "sku": "Sku02",
            "barcode": "152522",
            "variantOptionIds": [
                "option-1749727729878",
                "option-1749727740208"
            ]
        },
        {
            "name": "Do / L",
            "price": 20000,
            "originPrice": 15000,
            "stock_quantity": 10,
            "sku": "Sku01",
            "barcode": "1262636",
            "variantOptionIds": [
                "option-1749727729878",
                "option-1749727746449"
            ]
        }
    ],
    "itemSku": "Sku",
    "barcode": "12344",
    "variants": [
        {
            "id": "variant-1749727723707",
            "name": "Mau sac",
            "options": [
                {
                    "id": "option-1749727727271",
                    "value": "Xanh"
                },
                {
                    "id": "option-1749727729878",
                    "value": "Do"
                }
            ]
        },
        {
            "id": "variant-1749727733307",
            "name": "Kich thuoc",
            "options": [
                {
                    "id": "option-1749727740208",
                    "value": "S"
                },
                {
                    "id": "option-1749727746449",
                    "value": "L"
                }
            ]
        }
    ]
}

Phản hồi (Response)​

{
    "success": true,
    "message": "Success",
    "data": {
        "type": "product",
        "name": "Tên sản phẩm",
        "description": "Tên sản phẩm",
        "images": [
            "https://dmcl0k8mc5oht.cloudfront.net/64204a17a5a97a86f12e1f0a/e888246f-2647-42f1-9d89-53eacdb7bf64.webp"
        ],
        "subItemsGroupIds": [],
        "price": 20000,
        "originPrice": 15000,
        "configs": [],
        "hashtags": [],
        "itemSku": "Sku",
        "barcode": "12344",
        "shopId": "64204a17a5a97a86f12e1f0a",
        "collectionIDs": [],
        "status": "active",
        "totalRating": 0,
        "totalReview": 0,
        "stock_quantity": 12000,
        "sortOrder": 0,
        "isNullSortOrder": false,
        "platform": "mini_app",
        "brandProductIds": [],
        "fakeReviewIds": [],
        "vat": 5,
        "_id": "68c93dba802d36826bc45c9c",
        "createdAt": "2025-09-16T10:36:42.809Z",
        "updatedAt": "2025-09-16T10:36:42.809Z",
        "__v": 0,
        "skus": [
            {
                "name": "Xanh / S",
                "price": 20000,
                "originPrice": 15000,
                "stock_quantity": 0,
                "sku": "Sku04",
                "barcode": "51515hahah",
                "variantOptionIds": [
                    "option-1749727727271",
                    "option-1749727740208"
                ]
            },
            {
                "name": "Xanh / L",
                "price": 20000,
                "originPrice": 15000,
                "stock_quantity": 0,
                "sku": "Sku03",
                "barcode": "152525h",
                "variantOptionIds": [
                    "option-1749727727271",
                    "option-1749727746449"
                ]
            },
            {
                "name": "Do / S",
                "price": 20000,
                "originPrice": 15000,
                "stock_quantity": 16,
                "sku": "Sku02",
                "barcode": "152522",
                "variantOptionIds": [
                    "option-1749727729878",
                    "option-1749727740208"
                ]
            },
            {
                "name": "Do / L",
                "price": 20000,
                "originPrice": 15000,
                "stock_quantity": 10,
                "sku": "Sku01",
                "barcode": "1262636",
                "variantOptionIds": [
                    "option-1749727729878",
                    "option-1749727746449"
                ]
            }
        ],
        "variants": [
            {
                "id": "variant-1749727723707",
                "name": "Mau sac",
                "options": [
                    {
                        "id": "option-1749727727271",
                        "value": "Xanh"
                    },
                    {
                        "id": "option-1749727729878",
                        "value": "Do"
                    }
                ]
            },
            {
                "id": "variant-1749727733307",
                "name": "Kich thuoc",
                "options": [
                    {
                        "id": "option-1749727740208",
                        "value": "S"
                    },
                    {
                        "id": "option-1749727746449",
                        "value": "L"
                    }
                ]
            }
        ],
        "id": "68c93dba802d36826bc45c9c"
    }
}