文档中心 > Miravia Open Platform

Miravia - Custom product variant

更新时间:2023/01/06 访问次数:375

1. Description

When you create a product that requires variants and variant options that are not existing in the system categories, you can custom variants to create products. This tutorial guides you to the use of custom variants.

2. The flow of API calls

  • GetProductItem
  • CreateProduct
  • UpdateProduct
  • RemoveSKU

2.1 GetProductItem

PATH: /product/item/get

2.1.1 Request Parameters

No change

2.1.2 Response Parameters

2.1.2.1 Explain

Level1

Level2

Level3

Level4

Description

data

variation

Variation1

name

Sales attribute names, such as color family, size, etc.Form a ref relationship with "color_family" in the sku below.

hasImage

Sales attribute image settings, Only Variation1 Can set hasImage to true

customize

Whether to customize sales attributes

options

List of sales attribute value names

Variation2

name

hasImage

customize

options



Variation3

name

Very few cases will set this property. This attribute is not available for most categories




hasImage





customize





options




Variation4

name

Very few cases will set this property. This attribute is not available for most categories




hasImage





customize





options


2.1.2.2 DEMO

CASE1

Custom sales attributes (1) + Standard sales attributes (1) + SKU pictures

{
  "data": {
    "created_time": "1626242071000",
    "updated_time": "1626763060000",
    "images": [
      "https://sg-live-02.slatic.net/p/0ef9e15ad696adfc43333c646eec2ec4.jpg"
    ],
    "skus": [
      {
        "Status": "active",
        "quantity": 1,
        "Images": [
          "https://sg-live-02.slatic.net/p/42447e6aea05ea21f49f4f608b20b656.jpg"
        ],
        "SellerSku": "1884392091-1626242071365-0",
        "ShopSku": "1884392091_SGAMZ-10044238042",
        "Url": "https://www.lazada.sg/-i1884392091-s10044238042.html",
        "multiWarehouseInventories": [
          {
            "occupyQuantity": 0,
            "quantity": 1,
            "totalQuantity": 1,
            "withholdQuantity": 0,
            "warehouseCode": "dropshipping",
            "sellableQuantity": 1
          }
        ],
        "package_width": "1.00",
        "color_family": "Maroon",
        "package_height": "1.00",
        "fblWarehouseInventories": [],
        "special_price": 0.0,
        "price": 1000.0,
        "package_length": "1.00",
        "EditableQuantity": 1,
        "package_weight": "1",
        "Available": 1,
        "SkuId": 10044238042,
        "CustomProp1": "CustomOption1"
      },
      {
        "Status": "active",
        "quantity": 1,
        "Images": [
          "https://sg-live-02.slatic.net/p/0ef9e15ad696adfc43333c646eec2ec4.jpg"
        ],
        "SellerSku": "1884392091-1626242071365-1",
        "ShopSku": "1884392091_SGAMZ-10044238043",
        "Url": "https://www.lazada.sg/-i1884392091-s10044238043.html",
        "multiWarehouseInventories": [
          {
            "occupyQuantity": 0,
            "quantity": 1,
            "totalQuantity": 1,
            "withholdQuantity": 0,
            "warehouseCode": "dropshipping",
            "sellableQuantity": 1
          }
        ],
        "package_width": "1.00",
        "color_family": "Maroon",
        "package_height": "1.00",
        "fblWarehouseInventories": [],
        "special_price": 0.0,
        "price": 1000.0,
        "package_length": "1.00",
        "EditableQuantity": 1,
        "package_weight": "1",
        "Available": 1,
        "SkuId": 10044238043,
        "CustomProp1": "CustomOption2"
      }
    ],
    "item_id": 1884392091,
    "primary_category": 6583,
    "attributes": {
      "name": "Test Api Self Define Attributes By Boyan 0714001",
      "description": "<p style=\"margin: 0;\"><span style=\"font-family: none;\"></span></p>",
      "brand": "No Brand",
      "source": "asc",
      "delivery_option_sof": "0"
    },
    "variation": {
      "Variation1": {
        "name": "CustomProp1",
        "label": "CustomProp1",
        "hasImage": true,
        "customize": true,
        "options": [
          "CustomOption2",
          "CustomOption1"
        ]
      },
      "Variation2": {
        "name": "Color Family",
        "label": "color_family",
        "hasImage": false,
        "customize": false,
        "options": [
          "Maroon"
        ]
      }
    }
  },
  "code": "0",
  "request_id": "0be6f58116276233235264430"
}


CASE2

All standard sales attributes (2)

{
  "data": {
    "created_time": "1626764445000",
    "updated_time": "1626869157000",
    "images": [
      "https://sg-live.slatic.net/p/42447e6aea05ea21f49f4f608b20b656.jpg"
    ],
    "skus": [
      {
        "Status": "active",
        "quantity": 1,
        "Images": [],
        "SellerSku": "1901875545-1626764445757-0",
        "ShopSku": "1901875545_SGAMZ-10164106501",
        "Url": "https://www.lazada.sg/-i1901875545-s10164106501.html",
        "multiWarehouseInventories": [
          {
            "occupyQuantity": 0,
            "quantity": 1,
            "totalQuantity": 1,
            "withholdQuantity": 0,
            "warehouseCode": "dropshipping",
            "sellableQuantity": 1
          }
        ],
        "package_width": "1.00",
        "color_family": "Red",
        "package_height": "1.00",
        "size": "34",
        "fblWarehouseInventories": [],
        "special_price": 0.0,
        "price": 1000.0,
        "package_length": "1.00",
        "EditableQuantity": 1,
        "package_weight": "1",
        "Available": 1,
        "SkuId": 10164106501
      },
      {
        "Status": "active",
        "quantity": 2,
        "Images": [],
        "SellerSku": "1901875545-1626764445757-2",
        "ShopSku": "1901875545_SGAMZ-10164106503",
        "Url": "https://www.lazada.sg/-i1901875545-s10164106503.html",
        "multiWarehouseInventories": [
          {
            "occupyQuantity": 0,
            "quantity": 2,
            "totalQuantity": 2,
            "withholdQuantity": 0,
            "warehouseCode": "dropshipping",
            "sellableQuantity": 2
          }
        ],
        "package_width": "1.00",
        "color_family": "Blue",
        "package_height": "1.00",
        "size": "34",
        "fblWarehouseInventories": [],
        "special_price": 0.0,
        "price": 1000.0,
        "package_length": "1.00",
        "EditableQuantity": 2,
        "package_weight": "1",
        "Available": 2,
        "SkuId": 10164106503
      },
      {
        "Status": "active",
        "quantity": 1,
        "Images": [],
        "SellerSku": "1901875545-1626764445757-1",
        "ShopSku": "1901875545_SGAMZ-10164106502",
        "Url": "https://www.lazada.sg/-i1901875545-s10164106502.html",
        "multiWarehouseInventories": [
          {
            "occupyQuantity": 0,
            "quantity": 1,
            "totalQuantity": 1,
            "withholdQuantity": 0,
            "warehouseCode": "dropshipping",
            "sellableQuantity": 1
          }
        ],
        "package_width": "1.00",
        "color_family": "Red",
        "package_height": "1.00",
        "size": "38",
        "fblWarehouseInventories": [],
        "special_price": 0.0,
        "price": 1000.0,
        "package_length": "1.00",
        "EditableQuantity": 1,
        "package_weight": "1",
        "Available": 1,
        "SkuId": 10164106502
      },
      {
        "Status": "active",
        "quantity": 1,
        "Images": [],
        "SellerSku": "1901875545-1626764445757-3",
        "ShopSku": "1901875545_SGAMZ-10164106504",
        "Url": "https://www.lazada.sg/-i1901875545-s10164106504.html",
        "multiWarehouseInventories": [
          {
            "occupyQuantity": 0,
            "quantity": 1,
            "totalQuantity": 1,
            "withholdQuantity": 0,
            "warehouseCode": "dropshipping",
            "sellableQuantity": 1
          }
        ],
        "package_width": "1.00",
        "color_family": "Blue",
        "package_height": "1.00",
        "size": "38",
        "fblWarehouseInventories": [],
        "special_price": 0.0,
        "price": 1000.0,
        "package_length": "1.00",
        "EditableQuantity": 1,
        "package_weight": "1",
        "Available": 1,
        "SkuId": 10164106504
      }
    ],
    "item_id": 1901875545,
    "primary_category": 6583,
    "attributes": {
      "name": "Test API Self Define Attributes By Boyan 002",
      "description": "<p style=\"margin: 0;\"><span style=\"font-family: none;\"></span></p>",
      "brand": "No Brand",
      "source": "asc",
      "del


2.2 CreateProduct

PATH: /product/create


2.2.1 Request Parameters

2.2.1.1 Explain

Level1

Level2

Level3

Level4

Description

data

variation

Variation1

name

Sales attribute names, such as color family, size, etc.Form a ref relationship with "color_family" in the sku below.

hasImage

Sales attribute image settings, Only Variation1 Can set hasImage to true

customize

Whether to customize sales attributes

options

List of sales attribute value names

Variation2

name

hasImage

customize

options



Variation3

name

Very few cases will set this property. This attribute is not available for most categories




hasImage





customize





options




Variation4

name

Very few cases will set this property. This attribute is not available for most categories




hasImage





customize





options


skus

Variation1-name

Variation1-options[i]

Reference the name and option of the variation declaration as the sales attribute and sales attribute valueThe name field of Variation1/Variation2/Variation3/Variation4

An option element of Variation1/Variation2Variation3/Variation4


2.2.1.2 Error

Error Code

Error Message

VARIATION_CATEGORY_PROHIBITION

The category is banned from using variation function.

REMOVE_SKU_PROHIBITION

The seller is prohibited from using the remove SKU function.

VARIATION_SELLER_PROHIBITION

The seller is prohibited from using the variation function.

VARIATION_EMPTY

The Variation is Empty

VARIATION_SIZE_LIMIT

The Variations Size Exceeds Maximum Size Limit, The Size Limit is: 20.

VARIATION_CONTENT_EMPTY

The Variation Content is Empty, The Variation Node is: VariationX

VARIATION_NAME_EMPTY

The Variation Name is Empty, The Variation Node is: VariationX

VARIATION_IMAGE_MUST_SET_VARIATION1

Only Variation1 Can set hasImage to true, The Variation Node is: VariationX

VARIATION_NAME_DUPLICATE

The Variation Name Is Duplicate, The Variation Node is: VariationX, The Duplicate Name is: nameX

VARIATION_NAME_LENGTH_LIMIT

The Variation Name's Content Exceeds Maximum Length Limit, The Variation Node is: VariationX, The Length Limit is: 15, The Name is: nameX

VARIATION_OPTIONS_EMPTY

The Variation Options Is Empty, The Variation Node is: VariationX

OPTIONS_SIZE_LIMIT

The Variation Options Exceeds Maximum Size Limit, The Variation Node is: VariationX, The Size Limit is: 20, The Name is: nameX

VARIATION_OPTION_EMPTY

The Variation Option Is Empty, The Variation Node is: VariationX

VARIATION_OPTION_LENGTH_LIMIT

The Variation Name's Content Exceeds Maximum Length Limit, The Variation Node is: VariationX, The Length Limit is: 20, The Option is: optionX;

VARIATION_OPTION_DUPLICATE

The Variation Option Is Duplicate, The Variation Node is: VariationX, The Duplicate Option is: optionX, optionX

VARIATION_IMAGE_SETTING_ERROR

There is No HasImage Set In The VariationX, But Images Are Found In The SKU: " + sellerSKU

SKU_VARIATION_OPTION_NOT_EXIST

The SKU Variation Option is Not Exist, The SellerSKU is:SellerSkuX, The SKU Variation Name is: nameX, The SKU Variation Option is: optionX

SKU_VARIATION_NAME_MISSING

The SKU Variation Name is Missing, The SellerSKU is:is:SellerSkuX, The Missing SKU Variation Name is: nameX

SKU_VARIATION_IMAGES_MISSING

The Variation set hasImage true, But The SKU Not Found Images. The SellerSKU is: SellerSkuX, The Variation Name is: nameX

VARIATION_CATEGORY_SIZE_IMAGE

When size is passed in as a standard category attribute, it is not allowed to set hasImage true.

VARIATION_CATEGORY_ATTRIBUTE_INVALID

This attribute nameX is not found in the category attribute library.


2.2.1.3 DEMO

CASE1

Create products with standard sales attributes

{
    "Request": {
        "Product": {
            "PrimaryCategory": "10002019",
            "Images": {
                "Image": [
                    "https://test.jpg",
                    "https://test1.jpg"
                ]
            },
            "variation": {
                "variation1": {
                    "name": "color_family",
                    "hasImage": true,
                    "customize": false,
                    "options": {
                        "option": [
                            "test"
                        ]
                    }
                }
            },
            "Attributes": {
                "name": "test product",
                "description": "test description",
                "brand": "No Brand",
                "model": "test",
                "warranty_type": "Local seller warranty",
                "warranty": "1 Month",
                "short_description": "test short description",
                "Hazmat": "None",
                "material": "Leather",
                "laptop_size": "11 - 12 inches",
                "delivery_option_sof": "No"
            },
            "Skus": {
                "Sku": [
                    {
                        "SellerSku": "chase test 8",
                        "quantity": "3",
                        "price": "35",
                        "color_family": "test",
                        "ean_code": "456",
                        "package_height": "10",
                        "package_length": "10",
                        "package_width": "10",
                        "package_weight": "0.5",
                        "package_content": "laptop bag",
                        "Images": {
                            "Image": [
                                "https://test.jpg"
                            ]
                        }
                    }
                ]
            }
        }
    }
}


CASE2

Standard sales attributes (1) + custom sales attributes (1)

{
    "Request": {
        "Product": {
            "PrimaryCategory": "10002019",
            "Images": {
                "Image": [
                    "https://test1.jpg",
                    "https://test2.jpg"
                ]
            },
            "variation": {
                "variation1": {
                    "name": "color_family",
                    "hasImage": true,
                    "customize": false,
                    "options": {
                        "option": [
                            "test"
                        ]
                    }
                },
                "variation2": {
                    "name": "test prop",
                    "hasImage": false,
                    "customize": true,
                    "options": {
                        "option": [
                            "test custom"
                        ]
                    }
                }
            },
            "Attributes": {
                "name": "test product",
                "description": "test description",
                "brand": "No Brand",
                "model": "test",
                "warranty_type": "Local seller warranty",
                "warranty": "1 Month",
                "short_description": "test short description",
                "Hazmat": "None",
                "material": "Leather",
                "laptop_size": "11 - 12 inches",
                "delivery_option_sof": "No"
            },
            "Skus": {
                "Sku": [
                    {
                        "SellerSku": "chase test 81",
                        "quantity": "3",
                        "price": "35",
                        "color_family": "test",
                        "test prop": "test custom",
                        "package_height": "10",
                        "ean_code": "456",
                        "package_length": "10",
                        "package_width": "10",
                        "package_weight": "0.5",
                        "package_content": "laptop bag",
                        "Images": {
                            "Image": [
                                "https://test.jpg"
                            ]
                        }
                    }
                ]
            }
        }
    }
}


2.2.2 Response Parameters

No change



2.3 UpdateProduct

PATH: /product/update


2.3.1 Request Parameters

2.3.1.1 Explain

Level1

Level2

Level3

Level4

Description

data

variation

Variation1

name

Sales attribute names, such as color family, size, etc.Form a ref relationship with "color_family" in the sku below.

hasImage

Sales attribute image settings, Only Variation1 Can set hasImage to true

customize

Whether to customize sales attributes

options

List of sales attribute value names

Variation2

name

hasImage

customize

options



Variation3

name

Very few cases will set this property. This attribute is not available for most categories




hasImage





customize





options




Variation4

name

Very few cases will set this property. This attribute is not available for most categories




hasImage





customize





options


skus

Variation1-name

Variation1-options[i]

Reference the name and option of the variation declaration as the sales attribute and sales attribute valueThe name field of Variation1/Variation2/Variation3/Variation4

An option element of Variation1/Variation2Variation3/Variation4

2.3.1.2 Error

Error Code

Error Message

VARIATION_CATEGORY_PROHIBITION

The category is banned from using variation function.

REMOVE_SKU_PROHIBITION

The seller is prohibited from using the remove SKU function.

VARIATION_SELLER_PROHIBITION

The seller is prohibited from using the variation function.

VARIATION_EMPTY

The Variation is Empty

VARIATION_SIZE_LIMIT

The Variations Size Exceeds Maximum Size Limit, The Size Limit is: 20.

VARIATION_CONTENT_EMPTY

The Variation Content is Empty, The Variation Node is: VariationX

VARIATION_NAME_EMPTY

The Variation Name is Empty, The Variation Node is: VariationX

VARIATION_IMAGE_MUST_SET_VARIATION1

Only Variation1 Can set hasImage to true, The Variation Node is: VariationX

VARIATION_NAME_DUPLICATE

The Variation Name Is Duplicate, The Variation Node is: VariationX, The Duplicate Name is: nameX

VARIATION_NAME_LENGTH_LIMIT

The Variation Name's Content Exceeds Maximum Length Limit, The Variation Node is: VariationX, The Length Limit is: 15, The Name is: nameX

VARIATION_OPTIONS_EMPTY

The Variation Options Is Empty, The Variation Node is: VariationX

OPTIONS_SIZE_LIMIT

The Variation Options Exceeds Maximum Size Limit, The Variation Node is: VariationX, The Size Limit is: 20, The Name is: nameX

VARIATION_OPTION_EMPTY

The Variation Option Is Empty, The Variation Node is: VariationX

VARIATION_OPTION_LENGTH_LIMIT

The Variation Name's Content Exceeds Maximum Length Limit, The Variation Node is: VariationX, The Length Limit is: 20, The Option is: optionX;

VARIATION_OPTION_DUPLICATE

The Variation Option Is Duplicate, The Variation Node is: VariationX, The Duplicate Option is: optionX, optionX

VARIATION_IMAGE_SETTING_ERROR

There is No HasImage Set In The VariationX, But Images Are Found In The SKU: " + sellerSKU

SKU_VARIATION_OPTION_NOT_EXIST

The SKU Variation Option is Not Exist, The SellerSKU is:SellerSkuX, The SKU Variation Name is: nameX, The SKU Variation Option is: optionX

SKU_VARIATION_NAME_MISSING

The SKU Variation Name is Missing, The SellerSKU is:is:SellerSkuX, The Missing SKU Variation Name is: nameX

SKU_VARIATION_IMAGES_MISSING

The Variation set hasImage true, But The SKU Not Found Images. The SellerSKU is: SellerSkuX, The Variation Name is: nameX

VARIATION_CATEGORY_SIZE_IMAGE

When size is passed in as a standard category attribute, it is not allowed to set hasImage true.

VARIATION_CATEGORY_ATTRIBUTE_INVALID

This attribute nameX is not found in the category attribute library.


2.3.1.3 DEMO

CASE1
{
    "Request": {
        "Product": {
            "ItemId": "2378974109",
            "AssociatedSku": "chase test 8",
            "Attributes":"",
            "Skus": {
                "Sku": [
                    {
                        "SellerSku": "chase test 888",
                        "quantity": "3",
                        "price": "35",
                        "color_family": "blue",
                        "package_height": "10",
                        "package_length": "10",
                        "package_width": "10",
                        "package_weight": "0.5",
                        "package_content": "laptop bag"
                    }
                ]
            }
        }
    }
}

CASE2

No declaration of Variation + modification of standard sales attribute value + no SKU picture, Red -> Green

{
    "Request": {
        "Product": {
            "ItemId": "2378974109",
            "Attributes": "",
            "Skus": {
                "Sku": [
                    {
                        "SellerSku": "chase test 888",
                        "quantity": "3",
                        "price": "35",
                        "color_family": "green",
                        "package_height": "10",
                        "package_length": "10",
                        "package_width": "10",
                        "package_weight": "0.5",
                        "package_content": "laptop bag"
                    }
                ]
            }
        }
    }
}


CASE3

Declare Variation + Add custom sales attributes + No SKU image

{
    "Request": {
        "Product": {
            "ItemId": "2378974109",
            "Attributes": "",
            "variation": {
                "variation1": {
                    "name": "color_family",
                    "hasImage": false,
                    "customize": false,
                    "options": {
                        "option": ["red"]
                    }
                },
                "variation2": {
                    "name": "customProp1",
                    "hasImage": false,
                    "customize": true,
                    "options": {
                        "option": ["customOption1"]
                    }
                }
            },
            "Skus": {
                "Sku": [
                    {
                        "SellerSku": "2375082215-1655963945400-0",
                        "quantity": "3",
                        "price": "35",
                        "customProp1": "customOption1",
                        "color_family": "red",
                        "package_height": "10",
                        "package_length": "10",
                        "package_width": "10",
                        "package_weight": "0.5",
                        "package_content": "laptop bag"
                    }
                ]
            }
        }
    }
}


2.3.2 Response Parameters

No change


2.4 RemoveSKU

PATH: /product/sku/remove


2.4.1 Request Parameters

2.4.1.1 Explain

Level1

Level2

Level3

Level4

Description

ItemId

Product ID that needs to be deleted

data

variation

Variation1

name

Sales attributes that need to be deleted

Variation2

name

Sales attributes that need to be deleted



Variation3

name

Sales attributes that need to be deleted



Variation4

name

Sales attributes that need to be deleted



SellerSku


Sellersku that need to be deleted


2.4.1.2 DEMO

CASE1

Delete SKU

{
    "Request":{
        "Product":{
            "ItemId": "1355777714856298",
            "Skus":{
                "Sku":{
                    "SellerSku": "1355777714856298-1658391245934-2"
                }
            }
        }
    }
}

CASE2

Delete standard sales attributes

{
    "Request":{
        "Product":{
            "ItemId": "1355777714856298",
            "variation": {
                "variation1":{
                    "name":"color_family"
                }
            }
        }
    }
}

CASE3

Delete custom sales attributes

{
    "Request":{
        "Product":{
            "ItemId": "1355777714856298",
            "variation": {
                "variation1":{
                    "name":"test"
                }
            }
        }
    }
}


CASE4

Delete sales attributes & delete SKU

{
    "Request":{
        "Product":{
            "ItemId": "1355777714856298",
            "variation": {
                "variation1":{
                    "name":"test"
                }
            },
            "Skus":{
                "Sku":{
                    "SellerSku": "1355777714856298-1658454931908-1"
                }
            }
        }
    }
}


3. FAQ

Q: Whether the name field of variation distinguishes language

A: Languages are not distinguished, and the number of characters does not exceed 15



Q: How to judge the hierarchical relationship of each variation

A: Look at the attribute name, there can be up to 4 variations, and the field name is variation1-variation4, with 1 being the top level, sorted down in order



Q: I see the hasImage field in the variation, what does this mean?

A: This indicates whether the current sales attribute can set the picture, only variation1 can this be true



Q: When using the updateProduct API to add a variation, can the existing SKU not update this variation?

For example, there is an existing size sales attribute, I want to add the color_fmaily attribute, but the existing product did not add the color_fmaily attribute when updating

A: No, an error will be reported. After the sales attribute is added, all SKUs under the product must be set to the corresponding value of the sales attribute



Q: When I call RemoveSku to delete a variation, can I not delete the SKU under the variation?

A: Yes, but there are conditions. For example, there are two variations under product A, variation1: color_fmaily and variation2: size, and there are two SKUs A and B. The attributes are as follows

A: color_fmaily=red

size=s

B: color_fmaily=blue

size=s

Simply, if you only delete color_fmaily, an error will be reported, because when only size is left, there is a problem of duplication of sales attributes, which is not allowed



Q: What should I do if I want to eliminate one of the options under variation?

A: Call "RemoveSku" to delete the corresponding SKU, or use "updateproduct" to replace the "variation" of this SKU with other options



Q: When creating a product for the first time, I can declare multiple variations and corresponding options, but only enter one SKU?

For example: I declared "color_fmaily": "red", "blue" and "size": "S", "M", "L", but only created one SKU and set "red" and "S", Will other options remain?

A: It will not be retained because only options and variations written to the SKU will be persisted, and other values that do not appear in the SKU will disappear



Q: Can I delete a variation directly?

A: In removesku, just fill in the name of the variation to be deleted



Q: If the red option has three SKUs, what operations are required for the corresponding SKUs when deleting red?

A: You need to fill in the corresponding SKU when deleting the red option



Q: Following the question, after the red option is deleted, I want to add the red option and the corresponding SKU again, do I need to declare red in vairation again?

A: Need



Q: Support multiple SKU deactivation under one item. Will some sku deactivate successfully and some unsuccessfully?

A: If multiple SKUs are deactivated under one item, they will either be deactivated successfully, or all of them will be unsuccessful, and will not be partially unsuccessful.



Q: How do we determine which categories support several variant attributes?

A: Currently all online categories are supported, but in the future, the allowed category information will be released in advance and placed in the get category interface



Q: The types of variants supported by different types of items are different. Some only support one, some two, and four. We want to know which categories support several

A: Currently available Variations, "CreateProdcut" has 2 and "UpdateProduct" has 4, that is, ordinary (current) new products should not be passed into Varition3, Varition4. Explain again in this regard, because the category is not configured with mandatory mandatory restrictions, but subsequent categories will have legal mandatory mandatory restrictions. At this time, you need to verify all mandatory mandatory attributes, and new ones may appear. When sending goods, you also need to pass in the parameters Variation3 and Variation4. For this type of category current information, it is planned to be forwarded to the category information acquisition interface, which has not been provided yet, but the category configuration data at the current stage is Does not affect the use of



Q: In the hasImage field of variation, the input parameter description writes that there can only be at most one attribute setting wall chart, but the verification rule says that only variation1 can set the wall chart. What is the rule?

A: In the latter case, only variation1 can set the flipchart



Q: According to the logic discussed today, the updateproduct interface supports adding variables. When a commodity is created, there are two variables and SKUs corresponding to the two variables. When updating, only one variable is added without updating the SKU. Will an error be reported?

A: An error may be reported. When adding a variation, that is, adding a sales attribute dimension (such as color family), all SKUs under this commodity must set the attribute value corresponding to the sales attribute, such as "red" and "black"



Q1: When calling the removesku interface, there will be a check that after deleting the sales attribute and SKU, there are duplicate sales attributes in the remaining SKUs. This means that if a commodity has two attributes: color and size, after deleting one attribute color, you need to delete all SKUs using the color attribute together, right?

A1: This error reporting is not the logic you described. The real logic is that, for example, there are two sales attribute colors and sizes under a commodity. There are two sales attribute values under the color: red and black, and there is only one size: S. if the color needs to be deleted in the parameters and all the SKUs to be deleted are not transmitted (for example, no SKUs to be deleted are transmitted), At this time, two SKUs are s and have no other sales attributes. At this time, this error code will be returned. The positive understanding of this logic is: if you need to delete the sales attributes, you need to delete the corresponding SKUs to ensure that the sales attributes among the remaining SKUs can be combined, but not in the example

Q2: According to this logic, assuming your example, on the other hand, delete the size and leave the color, is it supported?

A2: On the contrary, it is OK to satisfy that the sales attribute combination of SKU is right



Q: For example, the sales attribute and color of the goods have three options: red, black and white, size, s and L. if I want to delete a white option in the future, I must delete only white s and white l SKU? Then Miravia will default that I delete the white option?

A: You don't have to delete white, you can also replace it with other colors. If you replace them, the white option is deleted



Q: If a product has 2 skus: Red/S, Green/S; Red/M, Green/M, but the user wants to edit into 3 SKUs: Red/S; Yellow/S; Green/S, correct What is the order of interface calling?

A: ① Delete Red/M, Green/M from removeSKU A: ① delete red / M and green / m in removesku ② add SKU: Yellow / s in update interface. Note: declare yellow / s in vairation



Q: How do I delete a color attribute directly—— In the example scenario, we have created 9 SKUs. After directly deleting the color attribute, how do you deal with these 9 SKUs? After I delete the color attribute directly, there are only three SKUs (s, m, l) left

A: If you delete variation, you need to put the corresponding deleted SKU into the transfer parameter. That is, after deleting the color, if the SKUs to be deleted are not transmitted, the S / M / l cannot form the remaining 9 SKUs, and the seller's intention cannot be recognized at the commodity background: which 3 to keep and which 6 to delete. After deleting the SKUs to be deleted, the attributes of the remaining SKUs do not need ISV update. During the deletion process, the program logic will automatically retain the remaining attribute values. The removesku interface is expected to solve all scenarios that need to delete sales attributes (variables), delete sales attribute values (options), and delete SKUs



Q: I use the removesku API to delete variation and SKU in a request and prompt me that the attribute is duplicate. Why?

A:

1. When deleting, please ensure that the variation combination of the deleted variant is not duplicate

2. Please confirm whether the XML format is wrong. For example, one layer less < sellersku > or < SKU > is written in the < SKUs > tag

FAQ

关于此文档暂时还没有FAQ
返回
顶部