Skip to content

Update Variant

Request

Actualiza una variante (ProductVariantCombination) de forma parcial.

Actualización parcial

Este endpoint permite actualizar solo los campos enviados sin afectar otros atributos de la variante, otras variantes del producto, ni el producto padre.

Ideal para integraciones POS que necesitan actualizar precio o stock de una variante específica sin reenviar el producto completo.

Ejemplo: Actualizar solo el precio

{ "variant": { "price": 150.00 } }

Ejemplo: Actualizar precio y stock

{ "variant": { "price": 150.00, "quantity": 25 } }

Ejemplo: Actualizar múltiples atributos

{ "variant": { "price": 200.00, "wholesale_price": 150.00, "quantity": 100, "sku": "NEW-SKU-001", "selling_without_stock": true } } parameters:

  • name: web_id in: path required: true description: El web_id de la variante a actualizar schema: type: string example: "x0wsCBTIMI"
Security
api-key
Bodyapplication/json
variantobject

Solo envía los campos que deseas actualizar

curl -i -X PATCH \
  'https://mercately.shop/api/v1/variants/{web_id}' \
  -H 'Content-Type: application/json' \
  -H 'api-key: YOUR_API_KEY_HERE' \
  -d '{
    "variant": {
      "price": 150,
      "wholesale_price": 120,
      "quantity": 50,
      "sku": "VAR-SM-001",
      "selling_without_stock": false,
      "variant_url": "https://example.com/product?variant=123",
      "image": "string"
    }
  }'

Responses

OK

Bodyapplication/json
object
Response
{ "message": "Variante actualizada con éxito", "variant": { "web_id": "x0wsCBTIMI", "name": "SM/Azul", "price": "150.0", "wholesale_price": "120.0", "sku": "VAR-SM-001", "quantity": 50, "variant_option_web_ids": [ … ], "image": "https://dc2p3rqc7bvrd.cloudfront.net/uploads/1/product_variant_combination/x0wsCBTIMI/image.webp", "variant_url": "https://example.com/product?variant=123" } }