Cupons
Atualizar Cupom
Aprenda a atualizar cupons usando o endpoint PUT /stores//coupons/.
PUT
Update coupon
📌 Endpoint
PUT /stores/{storeId}/coupons/{couponId}
Atualiza parcialmente um cupom existente.
🔐 Autenticação
- Rota privada.
- Requer header
Authorizationcom sua API key e plano ativo.
🧾 Parâmetros de rota
🧍 Body (JSON)
Envie pelo menos um campo:code(3-32)discount(1-100)position(inteiro maior ou igual a 1)useLimit(inteiro -1 a 9999; enviarnullredefine para-1)rules(array de regras de uso, ex.:[{"type": "SINGLE_USE_PER_CUSTOMER"}]; enviarnullou[]limpa as regras)expiredAt(data futura em formatoRFC3339/date-time, ounull)productIds(array de IDs; enviarnulllimpa as associações)categoryIds(array de IDs; enviarnulllimpa as associações)
✅ Exemplo de requisição
Snippet padrao (cURL)
Use o exemplo cURL da secao Exemplo de requisicao acima como snippet oficial.📦 Resposta de sucesso (200)
⚠️ Possíveis erros
400 INVALID_DATA→ body inválido400 INVALID_DATA_CODE→codefora de 3 a 32 caracteres400 INVALID_DATA_DISCOUNT→discountfora de 1 a 100400 INVALID_DATA_POSITION→positionmenor que 1400 INVALID_DATA_USE_LIMIT→useLimitfora de -1 a 9999400 INVALID_DATA_RULES→rulesinválido ou regra malformada400 INVALID_DATA_EXPIRED_AT→expiredAtinválido ou não está no futuro400 RELATION_NOT_FOUND→ produto/categoria inválido401 API_KEY_NOT_PROVIDED→ headerAuthorizationnão enviado401 INVALID_API_KEY→ API key inválida401 UNAUTHENTICATED→ usuário não autenticado403 USER_DISABLED→ usuário desativado403 NO_ACTIVE_SUBSCRIPTION→ sem plano ativo404 STORE_NOT_FOUND→ loja não encontrada404 COUPON_NOT_FOUND→ cupom não encontrado409 COUPON_ALREADY_EXISTS→ código duplicado429 RATE_LIMIT_EXCEEDED→ limite de requisições por minuto excedido500 INTERNAL_SERVER_ERROR→ erro interno503 SERVICE_UNAVAILABLE→ serviço indisponível
Parâmetros de caminho
Corpo
application/json
Coupon fields to update.