Saltar al contenido principal
PUT
Update product

📌 Endpoint

PUT /stores/{storeId}/products/{productId} Actualiza los datos de un producto existente.

🔐 Autenticación

  • Ruta privada.
  • Requiere header Authorization con tu API key y plan activo.

🧾 Parámetros de ruta


🧍 Body (JSON)

Todos los campos son opcionales (enviar null mantiene el valor actual del campo), pero deben respetar las reglas siguientes cuando se envíen:
  • name (3-32)
  • image (string de hasta 512 caracteres; enviar "" elimina la imagen, mientras que null la deja sin cambios)
  • description (12-256)
  • categoryIds (array de IDs de categorías de la tienda)
  • delivery (DIGITAL o PHYSICAL)
  • price (0.5 a 9999)
  • stock (entero -1 a 9999, -1 ilimitado)
  • disabled (true o false)
  • position (entero mayor o igual a 1)
  • metadata (objeto)

✅ Ejemplo de petición


Snippet estándar (cURL)

Use el ejemplo cURL de la sección Ejemplo de petición anterior como snippet oficial.

📦 Respuesta exitosa (200)


⚠️ Posibles errores

  • 400 INVALID_DATA → body, parámetros o elemento de categoryIds inválido
  • 400 INVALID_DATA_NAME_MIN → name con menos de 3 caracteres
  • 400 INVALID_DATA_NAME_MAX → name con más de 32 caracteres
  • 400 INVALID_DATA_IMAGE → image con más de 512 caracteres
  • 400 INVALID_DATA_DESCRIPTION_MIN → description con menos de 12 caracteres
  • 400 INVALID_DATA_DESCRIPTION_MAX → description con más de 256 caracteres
  • 400 INVALID_DATA_DELIVERY → delivery distinto de DIGITAL o PHYSICAL
  • 400 INVALID_DATA_PRICE → price fuera del intervalo 0.5 a 9999
  • 400 INVALID_DATA_STOCK → stock fuera del intervalo -1 a 9999
  • 400 INVALID_DATA_POSITION → position menor que 1
  • 400 CATEGORY_NOT_FOUND → una o más categorías en categoryIds no encontradas en la tienda
  • 400 NAME_ALREADY_EXISTS → nombre ya utilizado
  • 401 API_KEY_NOT_PROVIDED → header Authorization no enviado (o TOKEN_NOT_PROVIDED vía Bearer)
  • 401 INVALID_API_KEY → API Key inválida (o INVALID_TOKEN / TOKEN_EXPIRED / SESSION_NOT_FOUND / SESSION_EXPIRED / UNAUTHENTICATED vía Bearer)
  • 403 USER_DISABLED → usuario desactivado o eliminado
  • 403 NO_ACTIVE_SUBSCRIPTION → plan inactivo o expirado (o PENDING_2FA vía Bearer)
  • 404 STORE_NOT_FOUND → tienda no encontrada
  • 404 PRODUCT_NOT_FOUND → producto no encontrado
  • 429 RATE_LIMIT_EXCEEDED → límite de solicitudes por minuto excedido
  • 500 INTERNAL_SERVER_ERROR → error interno
  • 503 SERVICE_UNAVAILABLE → servicio o base de datos no disponible

Autorizaciones

Authorization
string
header
predeterminado:YOUR_API_KEY_HERE
requerido

Parámetros de ruta

storeId
string
requerido
Required string length: 1 - 50
productId
string
requerido
Required string length: 1 - 50

Cuerpo

application/json

Product fields to update.

name
string
Required string length: 3 - 32
image
string | null
Maximum string length: 512
description
string
Required string length: 12 - 256
categoryIds
string[]
Required string length: 1 - 50
delivery
enum<string>
Opciones disponibles:
DIGITAL,
PHYSICAL
price
number
Rango requerido: 0.5 <= x <= 9999
stock
integer
Rango requerido: -1 <= x <= 9999
position
integer
Rango requerido: x >= 1
metadata
object
disabled
boolean

Respuesta

Update product.

code
string
requerido
Ejemplo:

"SUCCESS"

product
object
requerido

Store product.