Saltar al contenido principal

Tutorial: Crear un producto con variantes

En este tutorial crearás un producto con múltiples variantes (talla, color) via API.

1. Crear el producto base​

curl -X POST https://app.omnibuy.net/api/v1/catalog/products \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Tenant-ID: $TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Polo Clásico",
    "slug": "polo-clasico",
    "short_description": "Polo 100% algodón",
    "price": 4900,
    "currency": "PEN",
    "status": "active",
    "vendor": "Mi Marca"
  }'

Guarda el id del producto devuelto: lo usarás en los siguientes pasos.

2. Agregar opciones​

PRODUCT_ID="<id-del-paso-1>"

# Opción: Talla
curl -X POST https://app.omnibuy.net/api/v1/catalog/products/$PRODUCT_ID/options \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Tenant-ID: $TENANT" \
  -H "Content-Type: application/json" \
  -d '{"name": "Talla", "values": ["S", "M", "L", "XL"]}'

3. Generar variantes automáticamente​

curl -X POST https://app.omnibuy.net/api/v1/catalog/products/$PRODUCT_ID/variants/generate \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Tenant-ID: $TENANT"

OmniBuy genera una variante por cada combinación de opciones.

4. Actualizar precios por variante​

VARIANT_ID="<id-variante>"

curl -X PATCH https://app.omnibuy.net/api/v1/catalog/products/$PRODUCT_ID/variants/$VARIANT_ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Tenant-ID: $TENANT" \
  -H "Content-Type: application/json" \
  -d '{"price": 5500}'

5. Verificar en el storefront​

El producto ya está disponible en https://<tenant>.omnibuy.net/products/polo-clasico.