Skip to main content

Modulo de Reservas

image.png

El m贸dulo de Reservas devuelve las reservas asociadas a cada cliente, filtradas por su identificador o por estados de reservas y fechas 

馃挕 Nota:
Actualmente, las consultas devuelven únicamente las reservas del cliente titular.
Si desea incluir pasajeros no titulares, consulte con el equipo t茅cnico de Airvi si esta opcióopci贸n estáest谩 habilitada en su instancia.

Consultar reservas por ID de cliente

Ruta:

GET {BASE_URL}/api/public_api/clients/{id}/reservations

ParáPar谩metros disponibles:

ParáPar谩metro DescripcióDescripci贸n
assignment_date_from, assignment_date_to Fecha de asignacióasignaci贸n del viaje.
trip_date_from, trip_date_to Fecha del viaje.
skip, take Control de paginaciópaginaci贸n.

Pasos:

  1. Reemplace {id} por el ID del cliente.

  2. Escriba las fechas en formato YYYY-MM-DD.

  3. EnvíEnv铆e la peticiópetici贸n.

  4. Verifique que el resultado sea 200 OK.

  5. Si no hay registros, el sistema devolverádevolver谩 un arreglo vacívac铆o en data.items.


Consultar reservas

FuncióFunci贸n:
Devuelve un listado paginado de reservaciones que puede ser filtrado segúseg煤n diferentes criterios operativos.

Ruta:

GET {BASE_URL}/api/public/reservations

DescripcióDescripci贸n general:
Esta funciófunci贸n retorna una lista de reservaciones aplicando los siguientes filtros opcionales:

  • Rango de fechas del viaje: trip_date_from, trip_date_to

  • Rango de fechas de asignacióasignaci贸n: assignation_date_from, assignation_date_to

  • Estado de la reserva: confirmado, borrador, cancelado

  • Estado del pago: pagado, impagado, abonado

Datos incluidos por cada reserva:

  • Identificadores de la reserva (ID y UUID)

  • Moneda y valores financieros (total a pagar, monto pendiente, abonado)

  • Fecha de asignacióasignaci贸n

  • InformacióInformaci贸n del viaje (nombre, fecha, estado)

  • Estado actual de la reserva y del pago

Comportamiento de la respuesta:

  • Los resultados se devuelven paginados mediante los parápar谩metros skip y take.

  • El listado se ordena automáautom谩ticamente por la fecha del viaje en orden descendente.

  • Si ocurre un error durante la consulta, la API retorna un mensaje con estado INTERNAL_ERROR e incluye el campo trace_id para seguimiento t茅cnico.