Variantes da opção
Os campos de uma variante de opção e como funcionam os modificadores de preço, peso e pontos de recompensa.
As variantes de opção oferecem escolhas diferentes ao cliente quando ele seleciona uma opção de produto. Por exemplo, uma opção "Size" pode ter as variantes "Small", "Medium" e "Large". Esta página explica os campos de uma variante e como os modificadores funcionam.
Variantes de opção do produto
Campos da variante de opção
Informações básicas
| Campo | Valores | Descrição |
|---|---|---|
variant_id | integer | Um identificador único da variante de opção. |
option_id | integer | O ID da opção à qual a variante está associada. |
variant_name | string | O nome da variante como é exibido aos clientes (por exemplo, "Small", "Red", "Cotton"). |
position | integer | A posição da variante entre as demais. Quanto menor o número, mais acima a variante aparece na lista de variantes do painel de administração. |
Modificadores de preço
| Campo | Valores | Descrição |
|---|---|---|
modifier | float | O modificador de preço da variante. Este valor ajusta o preço base do produto quando a variante é escolhida. |
modifier_type | string | O tipo do modificador de preço: A absoluto (altera o preço do produto por um valor fixo na moeda principal da loja), P percentual (altera o preço do produto por uma certa porcentagem). |
Modificadores de peso
| Campo | Valores | Descrição |
|---|---|---|
weight_modifier | float | O modificador de peso da variante. Este valor ajusta o peso base do produto quando a variante é escolhida. |
weight_modifier_type | string | O tipo do modificador de peso: A absoluto (altera o peso do produto por um valor fixo nas unidades de peso da loja), P percentual (altera o peso do produto por uma certa porcentagem). |
Pontos de recompensa (recurso de módulo adicional)
| Campo | Valores | Descrição |
|---|---|---|
point_modifier | float | O modificador de pontos de recompensa da variante. Este valor ajusta os pontos de recompensa do produto quando a variante é escolhida. |
point_modifier_type | string | O tipo do modificador de pontos de recompensa: A absoluto (altera o número de pontos por um valor fixo), P percentual (altera o número de pontos por uma certa porcentagem). |
Elementos visuais
| Campo | Valores | Descrição |
|---|---|---|
image_pair | object | As informações sobre a imagem associada à variante. É útil para representar visualmente opções como cores ou estampas. |
Exemplo de objetos de variante de opção
json
{
"16": {
"variant_id": "16",
"option_id": "42",
"variant_name": "Small",
"position": "10",
"modifier": "0.00",
"modifier_type": "A",
"weight_modifier": "0.00",
"weight_modifier_type": "A"
},
"17": {
"variant_id": "17",
"option_id": "42",
"variant_name": "Medium",
"position": "20",
"modifier": "0.00",
"modifier_type": "A",
"weight_modifier": "0.00",
"weight_modifier_type": "A"
},
"18": {
"variant_id": "18",
"option_id": "42",
"variant_name": "Large",
"position": "30",
"modifier": "0.00",
"modifier_type": "A",
"weight_modifier": "0.50",
"weight_modifier_type": "A"
},
"19": {
"variant_id": "19",
"option_id": "42",
"variant_name": "X-Large",
"position": "40",
"modifier": "2.50",
"modifier_type": "A",
"weight_modifier": "1.00",
"weight_modifier_type": "A",
"point_modifier": "5.00",
"point_modifier_type": "A"
}
}Trabalhando com modificadores de variante
Os modificadores ajustam o preço, o peso ou os pontos de recompensa de um produto conforme a variante escolhida.
Modificadores absolutos
Com um modificador absoluto (modifier_type="A"), o valor informado é somado ao valor base do produto:
text
// Base product price: $25.00
// Variant with modifier: "5.00" and modifier_type: "A"
Final price = $25.00 + $5.00 = $30.00Modificadores percentuais
Com um modificador percentual (modifier_type="P"), a porcentagem informada é aplicada ao valor base do produto:
text
// Base product price: $25.00
// Variant with modifier: "10.00" and modifier_type: "P"
Final price = $25.00 + ($25.00 * 10%) = $25.00 + $2.50 = $27.50