Resgatar um único produto

Em desenvolvimento

POST

/tickets/redeem/

Rota: /tickets/redeem/

Nome: Resgatar Item de Ticket
Descrição: Esta rota permite ao usuário ou operador resgatar um item específico de um ticket que já foi validado. Ao fornecer o ID do ticket e o ID do item a ser resgatado, o sistema registra o uso daquele produto/serviço individualmente, atualizando o status do item e, se aplicável, o status geral do ticket.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/tickets/redeem/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ticketId": "TICKET-789080",
    "itemId": 133289,
    "quantityToRedeem": 1
}'

Response Example

200 - Item resgatado

{
    "message": {
        "title": "Item Resgatado com Sucesso",
        "text": "O item selecionado do seu ticket foi resgatado com êxito.",
        "description": "O status do item foi atualizado para refletir seu uso. O status geral do ticket também foi ajustado conforme necessário."
    },
    "success": true,
    "status": 200,
    "data": {
        "ticketId": "TICKET-7890",
        "ticketOverallStatus": "partially_redeemed",
        "redeemedItem": {
            "id": 1332,
            "name": "Jantar romântico",
            "coverImage": "/image.jpg",
            "price": 23.321,
            "updatedAt": 334432,
            "status": {
                "totalQuantity": 3,
                "expiredQuantity": 1,
                "refundedQuantity": 0,
                "redeemedQuantity": 2,
                "validUntil": "2025-12-31T23:59:59Z"
            }
        },
        "remainingItemsToRedeem": 1
    }
}