Reemplazar opciones y variantes

PATCH

/api/products/{product_id}/variants

Define los ejes de variacion (options) y sus combinaciones (variants).

REEMPLAZO TOTAL: lo que no venga en el body se borra, con su stock. Para dejar el producto sin variantes, envia options y variants vacios junto con el stock que debe quedar.

Cada combinacion necesita un valor de CADA opcion declarada; las que no cuadren se descartan y se reportan en rejected_variants. Maximo 3 opciones. El precio de una variante es siempre de pago unico.

El stock del producto se recalcula como la suma de las combinaciones activas: enviar stock con variantes devuelve 409.

Las imagenes por valor de opcion no viajan en el body: se conservan las ya guardadas para cada par (opcion, valor) que siga existiendo. Un valor nuevo nace sin fotos y aparece en media_missing.

Con dry_run: true devuelve el mismo resumen sin escribir nada.

Solicitud

Parámetros de ruta

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200

application/json

Bodyapplication/json

🟠400

🟠404

🟠409

🟠403ForbiddenAccess

🟠429TooManyRequests

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://app.mgpanel.co/api/products/6a48365bffccd67bb88364de/variants' \
--header 'X-Account-Nick: {{ACCOUNT_NICK}}' \
--header 'Authorization: Bearer {{API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "options": [
        {
            "name": "Color",
            "values": [
                {
                    "value": "Rojo"
                },
                {
                    "value": "Azul"
                }
            ]
        }
    ],
    "variants": [
        {
            "option_values": [
                {
                    "name": "Color",
                    "value": "Rojo"
                }
            ],
            "sku": "CAM-ROJ",
            "stock": 5,
            "status": 1,
            "price": {
                "one_time": {
                    "price": 19.9,
                    "comparison_price": 24.9,
                    "exento": false
                }
            }
        },
        {
            "option_values": [
                {
                    "name": "Color",
                    "value": "Azul"
                }
            ],
            "sku": "CAM-AZU",
            "stock": 2,
            "status": 1,
            "price": {
                "one_time": {
                    "price": 19.9
                }
            }
        }
    ],
    "dry_run": false
}'

Ejemplo de Respuesta

200 - Éxito

{
    "success": true,
    "message": "Variantes actualizadas",
    "product_id": "6a48365bffccd67bb88364de",
    "options": [
        {
            "name": "Color",
            "values": [
                "Rojo",
                "Azul"
            ]
        }
    ],
    "variant_keys": [
        "Rojo",
        "Azul"
    ],
    "added_variants": [
        "Azul"
    ],
    "removed_variants": [
        "Verde"
    ],
    "has_variants": true,
    "stock": 7,
    "media_preserved": 2,
    "media_missing": [
        "Color:Azul"
    ]
}

Modificado en 2026-10-08 13:23:32

Listar plantillas de variantes

Alta/actualización masiva de clientes