Detalhes de uma Reserva

Antes e depois de uma reserva ser confirmada, podemos consultar os detalhes da reserva.

Esse método é muito importante, pois retorna os dados do QRCode e as informações de validação dos ingressos.

Como exemplo, iremos utilizar a reserva criada no tutorial abaixo:

Criando uma Reserva

Nesta reserva, temos o Código #54.

{
  "Reserva": {
    "Codigo": 54,
    "DataExpiracao": "2025-01-01 00:00:00",
  }
}

Para obter os detalhes completos da reserva e de seus ingressos, é necessário realizar um GET para:

/reservas/{CodigoReserva}/

Que, neste exemplo, fica:

/reservas/54/

O retorno será um HttpCode 200, retornando os dados da reserva e dos ingressos:

{
  "Reserva": {
    "Codigo": 54,
    "DataCadastro": "2025-01-01 00:00:00",
    "DataExpiracao": "2025-01-01 00:00:00",
  },
  "Status": {
    "Codigo": 9,
    "Nome": "Expirado"
  },
  "Ingressos": [
    {
      "Evento": {
        "Codigo": 27,
        "Nome": "testeevento1"
      },
      "Apresentacao": {
        "Codigo": 37,
        "Nome": "31/12/2025 - 00:00"
      },
      "Setor": {
        "Codigo": 36,
        "Nome": "PLATEIA LIVRE",
        "Grupo": ""
      },
      "Ingresso": {
        "Codigo": 109,
        "DataCadastro": "2025-01-01 00:00:00",
        "Nome": "",
        "ValorTotal": 0
      },
      "Cadeira": {
        "Codigo": 0,
        "Nome": ""
      },
      "Status": "Pendente",
      "QRCode": {
        "Codigo": "",
        "Link": ""
      },
      "Portaria": {
        "Status": "Pendente",
        "Data": "",
        "Usuario": ""
      }
    },
    {
      "Evento": {
        "Codigo": 27,
        "Nome": "testeevento1"
      },
      "Apresentacao": {
        "Codigo": 37,
        "Nome": "31/12/2025 - 00:00"
      },
      "Setor": {
        "Codigo": 36,
        "Nome": "PLATEIA LIVRE",
        "Grupo": ""
      },
      "Ingresso": {
        "Codigo": 110,
        "DataCadastro": "2025-01-01 00:00:00",
        "Nome": "",
        "ValorTotal": 0
      },
      "Cadeira": {
        "Codigo": 0,
        "Nome": ""
      },
      "Status": "ReservadaLiberada",
      "QRCode": {
        "Codigo": "",
        "Link": ""
      },
      "Portaria": {
        "Status": "Pendente",
        "Data": "",
        "Usuario": ""
      }
    }
  ]
}

⏳ Data de Expiração da Reserva

É muito importante ficar atento à expiração da reserva, que é retornada em "DataExpiracao":

{
  "Reserva": {
    "DataExpiracao": "2025-01-01 00:00:00",
  }
}

Essa data de expiração é atualizada conforme novos ingressos são adicionados à reserva.

Após a data de expiração, a reserva é totalmente cancelada.

⚡ Status da Reserva

Na propriedade "Status", será retornado o status da reserva no momento da consulta:

{
  "Codigo": 5,
  "Nome": "Confirmado"
}

Você pode consultar todos os status na Referência Estática:

Referência Estática

🔲 QRCode

Quando a reserva é confirmada, a propriedade "QRCode" retorna o ID do ingresso e o link do QRCode:

{
  "Codigo": "NSE112ETV",
  "Link": "https://www.tickler.com.br/Assets/QRCode/ac414b3a9fa66e75aebdcceb79000a_1761768730.png"
}

O "Código" e a imagem do QRCode devem ser incluídos no ingresso que será entregue aos clientes.

Como no exemplo abaixo:

Na portaria, o porteiro pode fazer a leitura do ingresso tanto pelo ID quanto pelo QRCode.

🚪 Portaria

A propriedade "Portaria" retorna o status e as informações relacionadas à leitura deste ingresso na portaria:

{
  "Status": "Pendente",
  "Data": "",
  "Usuario": ""
}

Você pode consultar todos os status na Referência Estática:

Referência Estática

Quando o ingresso for lido na portaria, esses dados serão atualizados, indicando quando foi validado e quem realizou a validação:

{
  "Status": "Validado",
  "Data": "2025-01-01 00:00:00",
  "Usuario": "Luiz Carlos"
}