Add Product Variants

This endpoint creates child variants for a given product by defining choices for its attributes. If the product in question is a stand-alone product (neither a parent nor having any children), this operation will transform it into a parent product.

Steps to Create Variants:

Create Product Attributes: Begin by creating product attributes for the store using the Create Attribute endpoint.

Define Attribute Choices: Next, define choices for these attributes. For example, for a size attribute, choices might include 'small', 'medium', 'large', etc.

Choice Objects in Different Languages: Each choice is an object that accepts values in multiple languages. Currently, English and Arabic are supported.

Submit Attributes and Choices: This endpoint accepts an array of attributes and their respective choices.

Variant Generation: Variants are then created using the cartesian product of these attribute values, resulting in all possible combinations.

🔑Scopes

products.read_write - Products Read & Write

Request

Path Params

Header Params

Body Params application/json

Example

{
    "name2": "string",
    "id": "string",
    "name": {
        "ar": "حذاء رياضي (عمالة منصفة)",
        "en": "Sneakers (Fair Trade)"
    },
    "variants": [
        {
            "id": "49ef6116-f094-56ec-7aha-es6sf771f829",
            "is_deleted": false,
            "sku": "Z.987654.1234567890",
            "price": 1400,
            "sale_price": 1200,
            "images": [
                "image1.jpg",
                "image2.jpg"
            ],
            "quantity": 70,
            "is_infinite": false,
            "weight": {
                "value": 1.2,
                "unit": "kg"
            },
            "stocks": [
                null
            ],
            "attributes": [
                {
                    "slug": "color",
                    "value": {
                        "ar": "أبيض",
                        "en": "White"
                    }
                }
            ]
        }
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zid.sa/v1/products//options/' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxMTciLCJqdGkiOiJhMTg5ZTg3MmYxMzhkMWVhYjU5MjVkMDkyMGE5NmI0YjliNjg0Y2E2ZTdmM2M2MjljZWYxNmQ4NDJjMmJlYmVhMjI4YTdmMTA0ZWQ4NWE5NCIsImlhdCI6MTY3OTU3Njk5OS41NjY4NzcsIm5iZiI6MTY3OTU3Njk5OS41NjY4OCwiZXhwIjoxNzExMTk5Mzk5LjQ4NjE1Mywic3ViIjoiMTgyNDc1Iiwic2NvcGVzIjpbInRoaXJkLXBhcnRpZXMtYXBpcyJdfQ.i07ef09nVNXGZF-g-QXpNoS2vlFQK_zntAqAMS4Az2XD2EyMLhxLZZRL-QlR11zUPqMmXjMAl_4ooKa3M3zkfZQ6Ga6qStvamk8RnC_39VUx0lfN2A4k65ERZpqwrMy6-t3dE99zay3aicIdNvbgi0zeuMSE5Tn99u-2AtSRa8ffbfAcYPPXacHrhdmlYzdiZS_x_skovFEow1E-nDjdL1WHqO92XdZ7RfNLkiYFTjZlZmM_UruvioaR3q6TXJbqRK_ZrziivezL8ohIQ2SBosUp58I29rlKzvlw_R2j0rKKYZbdxYDaxAHOISmOFKAlO66k7dNevAHI3s4uGIjoGA6ZXHknccWPLLLiaAQ0r64HV8GowW5dg2rhZNurJGDTnLlBQ6F-ql42ptHzSAfzzi576CEoN3gMVpgXcbntUY3reETkFsTBPUjeSuMpANMioXAA0GRp3Ut-84fTnrWxqsCW1WVUIx33HvmfCGPXIdkaCCWoA6G6KXo04MtFbKXQmXkK9esQWI-rqdVnMD3zSR3g3yFHZSL1U-mZeNja03706Rav1ordsRNOtRwtLuoRRbk9KasbUpEwqq4Ao9lqZZwRIjdEw-pQtnUT8V53fhmuuRIefCLFO7eGEtGUnh9o6Uh_pgi6AB6uSlnN9GEMGgI1alqvMmTjxvC-HHt0V-Y' \
--header 'X-Manager-Token: eyJpdiI6Imh3L2dGbmJmRnVCOUY4WW5WQ2s3RFE9PSIsInZhbHVlIjoiZklpRnJyVGV1OWcrZUJBNk44bVp5SjZzSS92V3czcTJjbnJ2dFYvenZ3SFBtWHNSMFU3ZEMzZ0ZJNnpucVE4Ui9rNFdicUduOGpKUlg1VXdGOFFIaVUzZjZyUUZybWx3R0tNY3orUmxoUUUxQ29wSkEyVDZTVnVYb2dlUXJSVzBYVkdESjBpS0xiN05Hbndzc2wzV2N0YitGM1NEdkk4ckZZOTZsTFdEL1ZQRlJJTE5FQmttZng2elpwL1RCeXFRdUd1U3JTc0FHV1kySS80RFJaWlIyZ3gwM2FsQVRFbkt3VWtFOUQyKzdGOD0iLCJtYWMiOiJmZDQ0YzM4ODE0OWQxOWRhYWU0NDhhYmIzYzQ1MDAxMDAzODZjZGM3ZGM4NGJhMGNkMDEyYWZlM2UzYjAxMTI4IiwidGFnIjoiIn0=' \
--header 'Store-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name2": "string",
    "id": "string",
    "name": {
        "ar": "حذاء رياضي (عمالة منصفة)",
        "en": "Sneakers (Fair Trade)"
    },
    "variants": [
        {
            "id": "49ef6116-f094-56ec-7aha-es6sf771f829",
            "is_deleted": false,
            "sku": "Z.987654.1234567890",
            "price": 1400,
            "sale_price": 1200,
            "images": [
                "image1.jpg",
                "image2.jpg"
            ],
            "quantity": 70,
            "is_infinite": false,
            "weight": {
                "value": 1.2,
                "unit": "kg"
            },
            "stocks": [
                null
            ],
            "attributes": [
                {
                    "slug": "color",
                    "value": {
                        "ar": "أبيض",
                        "en": "White"
                    }
                }
            ]
        }
    ]
}'

Add Product Variants

Steps to Create Variants:#

Request

Request samples

Responses

Steps to Create Variants: