Cupons e Promoções

Cupons

Admin

GET    /api/admin/coupons
POST   /api/admin/coupons
PUT    /api/admin/coupons/{id}
DELETE /api/admin/coupons/{id}
PUT    /api/admin/coupons/status/{id}    # Ativar/desativar

Body (criar/atualizar):

{
  "code": "PROMO10",
  "discount": 10.00,
  "discount_type": "percent",
  "min_order_value": 50.00,
  "max_uses": 100,
  "expires_at": "2025-12-31",
  "active": true
}

Campos discount_type:

Valor	Descrição
percent	Desconto percentual
value	Desconto em reais

Client — Validar cupom

GET /api/client/coupons/{coupon}

Header X-Restaurant-Id obrigatório.

Resposta 200:

{
  "id": 3,
  "code": "PROMO10",
  "discount": 10,
  "discount_type": "percent",
  "valid": true
}

Erro (cupom inválido):

{
  "message": "Cupom inválido ou expirado",
  "internal_code": "COUPON_NOT_VALID",
  "status": 422
}

---

Promoções

Admin

GET    /api/admin/promotions
POST   /api/admin/promotions
PUT    /api/admin/promotions/{id}
DELETE /api/admin/promotions/{id}
PUT    /api/admin/promotions/status/{id}    # Ativar/desativar

Body:

{
  "name": "Combo do Dia",
  "discount": 15,
  "discount_type": "percent",
  "start_at": "2025-01-01",
  "end_at": "2025-01-31",
  "products": [10, 15, 20]
}

Produtos em promoção (Admin)

GET /api/admin/promotion/products

Client — Listar promoções ativas

GET /api/client/promotions