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贸n est谩 habilitada en su instancia.

Consultar reservas por ID de cliente

Ruta:

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

Par谩metros disponibles:

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

Pasos:

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

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

  3. Env铆e la petici贸n.

  4. Verifique que el resultado sea 200 OK.

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


Consultar reservas

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

Ruta:

GET {BASE_URL}/api/public/reservations

Descripci贸n general:
Esta 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贸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贸n

  • 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谩metros skip y take.

  • El listado se ordena 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.