v2.global_product.init_tier_variation

Only for China mainland sellers and Korean sellers. If you only define color, it is one tier, if you define color and size, it is two tier. Support two tier structures at most. This API can change no tier to one tier, no tier to two tier, one tier to two tier, two tier to one tier, one tier to no tier, two tier to no tier. Please create variants after an interval of 5 seconds after creating an item, as there may be a delay.

Overview

Request parameters

Response parameters

Common parameters

Request samples

Payload

{
	"global_model": [
		{
			"original_price": 12.34,
			"seller_stock": [
				{
					"location_id": "CNZ",
					"stock": 100
				}
			],
			"global_model_sku": "sku",
			"tier_index": [
				0,
				1
			],
			"weight": 1.1,
			"dimension": {
				"package_height": 11,
				"package_length": 11,
				"package_width": 11
			},
			"pre_order": {
				"days_to_ship": 2
			}
		}
	],
	"global_item_id": 22001469,
	"standardise_tier_variation": [
		{
			"variation_id": 0,
			"variation_name": "-",
			"variation_group_id": 0,
			"variation_option_list": [
				{
					"variation_option_id": 0,
					"variation_option_name": "-",
					"image_id": "-"
				}
			]
		}
	]
}

Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://partner.shopeemobile.com/api/v2/global_product/init_tier_variation?access_token=access_token&merchant_id=merchant_id&partner_id=partner_id&sign=sign&timestamp=timestamp")
.header("Content-Type","application/json")
.body("{
   \"global_item_id\": 22001469,
   \"global_model\": [
      {
         \"dimension\": {
            \"package_height\": 11,
            \"package_length\": 11,
            \"package_width\": 11
         },
         \"global_model_sku\": \"sku\",
         \"original_price\": 12.34,
         \"pre_order\": {
            \"days_to_ship\": 2
         },
         \"seller_stock\": [
            {
               \"location_id\": \"CNZ\",
               \"stock\": 100
            }
         ],
         \"tier_index\": [
            0,
            1
         ],
         \"weight\": 1.1
      }
   ],
   \"standardise_tier_variation\": [
      {
         \"variation_group_id\": 0,
         \"variation_id\": 0,
         \"variation_name\": \"-\",
         \"variation_option_list\": [
            {
               \"image_id\": \"-\",
               \"variation_option_id\": 0,
               \"variation_option_name\": \"-\"
            }
         ]
      }
   ],
   \"tier_variation\": [
      {
         \"name\": \"tier 1\",
         \"option_list\": [
            {
               \"image\": {
                  \"image_id\": \"c54265d475b85e00ffb2404585e32b6f\"
               },
               \"option\": \"opt\"
            }
         ]
      }
   ]
}")
.asString();

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/global_product/init_tier_variation?access_token=access_token&merchant_id=merchant_id&partner_id=partner_id&sign=sign&timestamp=timestamp',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => '{
    "global_item_id": 22001469,
    "global_model": [
        {
            "dimension": {
                "package_height": 11,
                "package_length": 11,
                "package_width": 11
            },
            "global_model_sku": "sku",
            "original_price": 12.34,
            "pre_order": {
                "days_to_ship": 2
            },
            "seller_stock": [
                {
                    "location_id": "CNZ",
                    "stock": 100
                }
            ],
            "tier_index": [
                0,
                1
            ],
            "weight": 1.1
        }
    ],
    "standardise_tier_variation": [
        {
            "variation_group_id": 0,
            "variation_id": 0,
            "variation_name": "-",
            "variation_option_list": [
                {
                    "image_id": "-",
                    "variation_option_id": 0,
                    "variation_option_name": "-"
                }
            ]
        }
    ],
    "tier_variation": [
        {
            "name": "tier 1",
            "option_list": [
                {
                    "image": {
                        "image_id": "c54265d475b85e00ffb2404585e32b6f"
                    },
                    "option": "opt"
                }
            ]
        }
    ]
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

cURL

curl --location --request POST 'https://partner.shopeemobile.com/api/v2/global_product/init_tier_variation?access_token=access_token&merchant_id=merchant_id&partner_id=partner_id&sign=sign&timestamp=timestamp' \
--header 'Content-Type: application/json' \
--data-raw '{
   "global_item_id": 22001469,
   "global_model": [
      {
         "dimension": {
            "package_height": 11,
            "package_length": 11,
            "package_width": 11
         },
         "global_model_sku": "sku",
         "original_price": 12.34,
         "pre_order": {
            "days_to_ship": 2
         },
         "seller_stock": [
            {
               "location_id": "CNZ",
               "stock": 100
            }
         ],
         "tier_index": [
            0,
            1
         ],
         "weight": 1.1
      }
   ],
   "standardise_tier_variation": [
      {
         "variation_group_id": 0,
         "variation_id": 0,
         "variation_name": "-",
         "variation_option_list": [
            {
               "image_id": "-",
               "variation_option_id": 0,
               "variation_option_name": "-"
            }
         ]
      }
   ],
   "tier_variation": [
      {
         "name": "tier 1",
         "option_list": [
            {
               "image": {
                  "image_id": "c54265d475b85e00ffb2404585e32b6f"
               },
               "option": "opt"
            }
         ]
      }
   ]
}'

Python

import requests
import json

url = "https://partner.shopeemobile.com/api/v2/global_product/init_tier_variation?access_token=access_token&merchant_id=merchant_id&partner_id=partner_id&sign=sign&timestamp=timestamp"

payload=json.dumps({
  "global_item_id": 22001469,
  "global_model": [
    {
      "dimension": {
        "package_height": 11,
        "package_length": 11,
        "package_width": 11
      },
      "global_model_sku": "sku",
      "original_price": 12.34,
      "pre_order": {
        "days_to_ship": 2
      },
      "seller_stock": [
        {
          "location_id": "CNZ",
          "stock": 100
        }
      ],
      "tier_index": [
        0,
        1
      ],
      "weight": 1.1
    }
  ],
  "standardise_tier_variation": [
    {
      "variation_group_id": 0,
      "variation_id": 0,
      "variation_name": "-",
      "variation_option_list": [
        {
          "image_id": "-",
          "variation_option_id": 0,
          "variation_option_name": "-"
        }
      ]
    }
  ],
  "tier_variation": [
    {
      "name": "tier 1",
      "option_list": [
        {
          "image": {
            "image_id": "c54265d475b85e00ffb2404585e32b6f"
          },
          "option": "opt"
        }
      ]
    }
  ]
})
headers = {
  'Content-Type': 'application/json'
}
response = requests.RPCRequest("POST",url,headers=headers, data=payload, allow_redirects=False)

print(response.text)

Response sample

JSON

{
    "error": "",
    "message": "",
    "warning": "",
    "request_id": "98eae35efff24dd0974c21a847127184"
}

Error example

JSON

{
    "error": "product.error_param",
    "message": "The level of tier-variation not change.",
    "request_id": "6f4dd65712b4239949d4fa01f79ab352"
}

Errors

Common errors

Update log