ParkFlow.io es un gestor de canales para aparcamientos de aeropuerto que conecta múltiples fuentes de reservas (OTAs, brókers, sitios web, agregadores) con operadores de aparcamiento. ParkFlow funciona principalmente con un modelo basado en extracción (pull), obteniendo periódicamente reservas de sistemas externos integrados.
ParkFlow.io es una plataforma centralizada (gestor de canales) que conecta a operadores de aparcamiento en aeropuertos con diversos canales de venta como agencias de viajes online (OTAs), agregadores, brókers y sitios B2C. Actúa como un sistema middleware, simplificando la gestión de reservas para aparcamientos mediante la sincronización de reservas, actualizaciones y cancelaciones de múltiples fuentes en una interfaz unificada. ParkFlow se basa principalmente en un modelo de integración pull, donde obtiene periódicamente datos de reservas de las APIs de los socios.
Esta guía está dirigida a proveedores de servicios externos (p. ej., OTAs, brókers, marketplaces) que deseen integrarse con ParkFlow y suministrar sus reservas a través de una API.
ParkFlow ejecuta tareas programadas que extraen reservas nuevas o actualizadas de la API de cada socio. Estas tareas se ejecutan típicamente:
- Cada 2–10 minutos en producción
- Cada 15–30 minutos en modo de prueba
Esto ayuda a garantizar que el operador del aparcamiento tenga información actualizada sobre las llegadas próximas y los requisitos del servicio.
- Obtención de nuevas reservas confirmadas
- Detección de actualizaciones de vuelo o datos del cliente
- Captura de cancelaciones
- Gestión de cambios de última hora próximos al momento de llegada
Si el propietario de un aparcamiento tiene múltiples ofertas (p. ej., diferentes aparcamientos o productos) en el sistema externo, ParkFlow establecerá una integración independiente para cada oferta con el fin de garantizar una asignación, disponibilidad y sincronización de precios precisas.
Para integrarse sin problemas, los socios externos deben exponer una API REST pública que admita lo siguiente:
ParkFlow admite múltiples esquemas:
- Bearer Token: Authorization: Bearer <token>- Basic Auth: usuario:contraseña codificado en base64
- API Key: Enviada en el encabezado (preferido) o como parámetro de consulta
Nota: Las credenciales se almacenan y gestionan de forma segura dentro de la plataforma de ParkFlow.
ParkFlow requiere únicamente un endpoint obligatorio:
GET /bookings – Este endpoint debe devolver una lista de todas las reservas que hayan sido creadas, actualizadas o canceladas desde un momento determinado. ParkFlow lo utiliza para sincronizar datos de manera fiable desde el sistema externo.
El objeto de reserva debe contener la siguiente información:
- Las fechas de llegada y salida deben estar en la zona horaria local
- Las fechas de creación y actualización deben estar en UTC-0
- Precio, importe prepagado y moneda
- Estado de la reserva
- Número de vehículos y matrículas
- Número de referencia
Endpoints opcionales:
- Bloqueo de Disponibilidad
Permite a ParkFlow informar al sistema externo cuando un producto de aparcamiento específico deja de estar disponible en determinadas fechas.
Ejemplo:
POST /parkings/{id}/locks
Body: { "date": "2025-07-15", "reason": "full" }
- Notificación de Estado de Reserva
Permite a ParkFlow notificar al sistema externo sobre cancelaciones de reservas o no-shows iniciados por el aparcamiento.
Ejemplo:
POST /bookings/{id}/cancel
Body: { "reason": "no_show" }
- Actualizaciones de Precios
Permite a ParkFlow enviar datos de precios estacionales o base para ofertas de aparcamiento específicas.
Ejemplo:
POST /parkings/{id}/pricing
Body: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }
- Garantice respuestas precisas y oportunas
- Evite almacenar en caché datos desactualizados
- Permita que ParkFlow configure la frecuencia de extracción
- Admita paginación para grandes volúmenes de reservas
- Proporcione un entorno de sandbox/pruebas con datos de prueba
- Todos los endpoints deben usar HTTPS
- Utilice métodos de autenticación seguros (se prefiere basado en token)
- Limite el acceso mediante lista blanca de IPs si es posible
- Evite almacenar datos sensibles de clientes más allá de lo estrictamente necesario