Saltar al contenido principal
PUT
Update coupon

📌 Endpoint

PUT /stores/{storeId}/coupons/{couponId} Actualiza parcialmente un cupón existente.

🔐 Autenticación

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

🧾 Parámetros de ruta


🧍 Body (JSON)

Envíe al menos un campo:
  • code (3-32)
  • discount (1-100)
  • position (entero mayor o igual a 1)
  • useLimit (entero -1 a 9999; enviar null restablece a -1)
  • rules (array de reglas de uso, ej.: [{"type": "SINGLE_USE_PER_CUSTOMER"}]; enviar null o [] limpia las reglas)
  • expiredAt (fecha futura en formato RFC3339 / date-time, o null)
  • productIds (array de IDs; enviar null limpia las asociaciones)
  • categoryIds (array de IDs; enviar null limpia las asociaciones)

✅ Ejemplo de solicitud


Snippet estándar (cURL)

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

📦 Respuesta exitosa (200)


⚠️ Posibles errores

  • 400 INVALID_DATA → body inválido
  • 400 INVALID_DATA_CODE → code fuera de 3 a 32 caracteres
  • 400 INVALID_DATA_DISCOUNT → discount fuera de 1 a 100
  • 400 INVALID_DATA_POSITION → position menor que 1
  • 400 INVALID_DATA_USE_LIMIT → useLimit fuera de -1 a 9999
  • 400 INVALID_DATA_RULES → rules inválido o regla malformada
  • 400 INVALID_DATA_EXPIRED_AT → expiredAt inválido o no está en el futuro
  • 400 RELATION_NOT_FOUND → producto/categoría inválido
  • 401 API_KEY_NOT_PROVIDED → header Authorization no enviado
  • 401 INVALID_API_KEY → API key inválida
  • 401 UNAUTHENTICATED → usuario no autenticado
  • 403 USER_DISABLED → usuario deshabilitado
  • 403 NO_ACTIVE_SUBSCRIPTION → sin plan activo
  • 404 STORE_NOT_FOUND → tienda no encontrada
  • 404 COUPON_NOT_FOUND → cupón no encontrado
  • 409 COUPON_ALREADY_EXISTS → código duplicado
  • 429 RATE_LIMIT_EXCEEDED → límite de solicitudes por minuto excedido
  • 500 INTERNAL_SERVER_ERROR → error interno
  • 503 SERVICE_UNAVAILABLE → servicio no disponible

Autorizaciones

Authorization
string
header
predeterminado:YOUR_API_KEY_HERE
requerido

Parámetros de ruta

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

Cuerpo

application/json

Coupon fields to update.

code
string
Required string length: 3 - 32
discount
integer
Rango requerido: 1 <= x <= 100
position
integer
Rango requerido: x >= 1
useLimit
integer | null
Rango requerido: -1 <= x <= 9999
rules
object[] | null
Maximum array length: 32
expiredAt
string<date-time> | null
productIds
string[] | null
Required string length: 1 - 50
categoryIds
string[] | null
Required string length: 1 - 50

Respuesta

Update coupon.

code
string
requerido
Ejemplo:

"COUPON_UPDATED"

coupon
object
requerido

Store discount coupon.