Miravia - Custom product variant

更新时间：2023/01/06 访问次数：722

1. Description
2. The flow of API calls
3. FAQ

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?

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

有用(0) 我要提问

Miravia Open Platform

Miravia - Custom product variant

1. Description

2. The flow of API calls

2.1 GetProductItem

2.1.1 Request Parameters

2.1.2 Response Parameters

2.1.2.1 Explain

2.1.2.2 DEMO

CASE1

CASE2

2.2 CreateProduct

2.2.1 Request Parameters

2.2.1.1 Explain

2.2.1.2 Error

2.2.1.3 DEMO

CASE1

CASE2

2.2.2 Response Parameters

2.3 UpdateProduct

2.3.1 Request Parameters

2.3.1.1 Explain

2.3.1.2 Error

2.3.1.3 DEMO

CASE1

CASE2

CASE3

2.3.2 Response Parameters

2.4 RemoveSKU

2.4.1 Request Parameters

2.4.1.1 Explain

2.4.1.2 DEMO

CASE1

CASE2

CASE3

CASE4

3. FAQ

FAQ

用户导航

用户反馈

用户反馈

用户反馈