Cupones disponibles

Consultar los cupones disponibles

GET /api/v1/ecommerce/coupons/availables

Pide el token del cliente. No recibe parámetros.

curl https://<dominio-de-la-empresa>/api/v1/ecommerce/coupons/availables \
  -H "Authorization: Bearer <token-del-cliente>" \
  -H "Accept: application/json"

Respuesta

{
  "success": true,
  "message": "Información procesada de forma correcta",
  "data": [
    {
      "code": "BIENVENIDA10",
      "description": "10% en tu primera compra",
      "discount_amount": 10.0,
      "discount_type": "PORCENTAJE",
      "due_date": "2026-12-31",
      "used": false,
      "conditions": "Válido en toda la tienda"
    }
  ]
}

Campo	Qué es
discount_type	PORCENTAJE o MONTO_FIJO
used	Si el cliente ya usó este cupón en un pedido

Qué cupones aparecen

Solo los activos y vigentes (dentro de su fecha de inicio y vencimiento). Además:

• Un cupón reservado a ciertos clientes solo aparece si el cliente está en la lista de ese cupón.
• Un cupón reservado a ciertos productos aparece igual: esta ruta no recibe el carrito, así que no se puede saber si el cliente tiene esos productos. Al intentar usarlo, calcular el descuento de un cupón confirma si el carrito califica.

Que un cupón aparezca aquí no garantiza que se pueda aplicar: el importe mínimo o máximo, o que sea de un solo uso, se comprueban al calcular el descuento.

Si algo sale mal

HTTP	code	Cuándo	Qué hacer
401	SESSION_EXPIRED	No se envió el token	Añade la cabecera Authorization
401	TOKEN_INVALID	El token no es válido	Pide al cliente que vuelva a iniciar sesión
403	NOT_A_STORE_USER	El token no es de un cliente de la tienda	Usa el token de un cliente
429	RATE_LIMITED	Se superó el límite de peticiones	Guarda la lista en caché
500	INTERNAL_ERROR	Fallo del servidor	Reporta la reference