Directorio de integraciones
Integración de la API de Amadeus: el conector de vuelos, paso a paso
El módulo Amadeus conecta la búsqueda de vuelos de PHPTRAVELS con Amadeus Enterprise. Registra una app, pega tres credenciales en el admin, prueba en modo desarrollo y pasa a producción cuando Amadeus apruebe tu cuenta.
- Conector del plan Enterprise
- OAuth2 client credentials
- Desarrollo y producción
- Guía de configuración publicada
Configuración del conector
De la app de Amadeus a resultados de vuelos en vivo en cinco pasos
El conector es un módulo listo para usar, así que una configuración estándar no requiere escribir código. Tú aportas tu cuenta de Amadeus y tus condiciones comerciales, y el módulo gestiona la autenticación, la búsqueda de vuelos y la creación de pedidos dentro del módulo de vuelos de PHPTRAVELS.
- Empieza con el plan Enterprise, que incluye el módulo Amadeus
- Regístrate en Amadeus for Developers y crea una app con Flight Offers Search y Flight Create Orders
- Introduce grant type, client ID y client secret en Módulos del admin, con Dev mode activado
- Busca vuelos en tu sitio y comprueba el logo de Amadeus bajo el botón Reservar ahora
- Solicita las claves de producción, sustituye las de sandbox y cambia Dev mode a producción
- Dev mode
- Desarrollo
- Endpoint
- travel.api.amadeus.com/v2/
- c1 · grant_type
- client_credentials
- c2 · client_id
- ••••••••••7Kq2
- c3 · client_secret
- ••••••••••
Qué hace el conector
Ofertas de Amadeus en tu búsqueda, pedidos en tu admin
Dos APIs de Amadeus impulsan el módulo: una devuelve ofertas de vuelos a tu página de resultados y la otra crea la reserva cuando el viajero paga.
- APILondres a Nueva York · DirectoTurista · 8 h 05 min · 1 maleta facturada486 US$por adulto
- v2Londres a Nueva York · 1 escalaTurista · 11 h 20 min vía Dublín · 1 maleta facturada412 US$por adulto
- Londres a Nueva York · DirectoBusiness · 7 h 55 min · 2 maletas facturadas2140 US$por adulto
Flight Offers Search y Flight Create Orders
Offers Search llena tus resultados; Create Orders convierte la oferta elegida en una reserva. Activa ambas en tu app de Amadeus para buscar y reservar.
Autenticación OAuth2
El módulo solicita tokens de acceso con el grant client_credentials, usando el client ID y el secret que introduces en el admin.
Modos de desarrollo y producción
Un solo ajuste, Dev mode, decide si las peticiones usan tus claves sandbox o tus claves de producción aprobadas.
Endpoint Enterprise
El módulo se basa en travel.api.amadeus.com/v2/. Algunas regiones usan otro endpoint, así que confirma el tuyo antes de introducir las claves.
Origen visible en cada resultado
Un logo de Amadeus bajo el botón Reservar ahora indica qué tarifas vienen de Amadeus, para comprobar la conexión de un vistazo.
Causas de error conocidas
La mayoría de los fallos son credenciales incorrectas, un modo que no coincide con las claves o un servicio de API inactivo en el panel de Amadeus.
Flujo de peticiones
Qué ocurre en cada búsqueda en Amadeus
La misma secuencia se ejecuta en desarrollo y en producción; solo cambian las claves y el ajuste Dev mode.
Autenticar
Tu client ID y tu secret se intercambian por un token de acceso.
Buscar
Flight Offers Search devuelve tarifas para la ruta, las fechas y los pasajeros.
Mostrar
Las ofertas aparecen con tu margen, junto a los resultados de otros proveedores conectados.
Pedir
Flight Create Orders reserva la oferta elegida con los datos del viajero.
Registrar
La reserva se guarda en tu admin y la confirmación se envía por email.
Dónde encaja Amadeus
Tu cuenta de Amadeus, otras APIs de vuelos y desarrollo a medida
El módulo Amadeus es uno de varios conectores de vuelos, y cada uno funciona con sus propias credenciales en la misma búsqueda.
Tu cuenta Amadeus Enterprise
Amadeus emite las claves de producción tras revisar tu caso de uso, el registro de tu empresa y tu web, y tú aceptas sus condiciones comerciales.
Otros conectores de vuelos
Añade Duffel, Kiwi u otros proveedores de vuelos desde el directorio de integraciones y compara sus tarifas en una sola lista.
Otros endpoints y APIs
Un endpoint regional de Amadeus o una API que el módulo aún no usa se puede añadir como desarrollo a medida.
Proveedores de vuelos que puedes conectar:
Seeru
Amadeus
Duffel
Google Flights
Kayak
Kiwi
Mystifly
PKfare
Sabre
TBO Holidays
Travelport
Back office
Gestiona las reservas de Amadeus desde el mismo admin
Con las claves introducidas, las tarifas de Amadeus siguen las reglas que ya usas para cualquier otro proveedor de vuelos.
Márgenes de vuelos
Añade márgenes fijos o porcentuales para que las tarifas de Amadeus muestren tu precio de venta.
Lista de reservas
Las reservas de Amadeus aparecen con datos del viajero y estado en la pantalla de reservas de vuelos.
Agentes B2B
Los agentes buscan y reservan tarifas de Amadeus en el portal de agentes con sus propias tarifas.
Pagos
Los viajeros pagan con las pasarelas que hayas activado, o los agentes desde su monedero.
Claves en tu servidor
Las credenciales se guardan en tu propio admin autoalojado, no en una plataforma compartida.
Tickets de soporte
Abre un ticket en app.phptravels.com si una conexión o una reserva necesita nuestra ayuda.
Comparar
Programar contra Amadeus por tu cuenta vs el módulo de PHPTRAVELS
Ambos usan la misma cuenta de Amadeus. La diferencia es cuánto escribe y mantiene tu equipo a su alrededor.
| Tarea | Integración directa de la API | PHPTRAVELS |
|---|---|---|
| Autenticación | Integración directa de la APIPeticiones y renovación de tokens escritas por tus desarrolladores | PHPTRAVELSGestionada por el módulo desde tres campos del admin |
| Resultados de búsqueda | Integración directa de la APIDatos de ofertas mapeados a tu propia página de resultados | PHPTRAVELSOfertas mostradas en la búsqueda de vuelos existente |
| Reserva | Integración directa de la APIFormularios de viajeros y llamadas de pedido creados desde cero | PHPTRAVELSCreate Orders conectado al checkout y al pago |
| Pruebas y producción | Integración directa de la APIConfiguración separada para cada entorno | PHPTRAVELSUn solo interruptor Dev mode |
| Márgenes y reservas | Integración directa de la APIUn back office por diseñar y construir | PHPTRAVELSIncluido en el admin de vuelos |
| Pasos de configuración | Integración directa de la APIEscritos y actualizados por tu equipo | PHPTRAVELSGuía publicada en docs.phptravels.com |
Casos de uso
Quién activa el módulo Amadeus
Agencias de viajes online
Búsqueda pública de vuelos con contenido de Amadeus, con tu margen y tu checkout.
Redes de agentes B2B
Los subagentes reservan tarifas de Amadeus en tu portal con tus tarifas.
Empresas de gestión de viajes
Los gestores corporativos buscan tarifas de Amadeus en una plataforma que tú alojas y controlas.
Por qué PHPTRAVELS
Un conector que puedes leer, modificar y alojar
Código fuente incluido
Autoalojado con licencia comercial, para que tus desarrolladores amplíen el módulo Amadeus.
Configuración documentada
Cada paso, campo y causa de error está explicado en docs.phptravels.com.
24 idiomas
Muestra tarifas de Amadeus en los idiomas de tus mercados, incluidos los de derecha a izquierda.
B2C y B2B
Una instalación para tu web pública y tu portal de agentes.
Preguntas frecuentes
Preguntas sobre el conector Amadeus
Lo que preguntan los equipos al configurar el módulo Amadeus.
Habla con ventasEs un módulo de vuelos listo para usar. Creas una app en Amadeus for Developers, introduces sus credenciales en el admin y las ofertas de Amadeus aparecen en tu búsqueda de vuelos, con reservas creadas mediante Flight Create Orders.
El módulo Amadeus está disponible con el plan Enterprise, un pago único de $9999 indicado en la página de precios. Tu cuenta de Amadeus y sus condiciones comerciales son aparte y se acuerdan con Amadeus.
Un grant type client_credentials, un client ID y un client secret. Amadeus emite claves sandbox al crear una app y claves de producción tras aprobar tu solicitud de producción.
El módulo usa travel.api.amadeus.com/v2/. Algunas regiones tienen otro endpoint o parámetros, así que revisa tu cuenta primero; otros endpoints se pueden añadir como desarrollo a medida.
Ambas cosas, según las APIs activadas en tu app de Amadeus. Flight Offers Search da los resultados y Flight Create Orders debe estar activada para las reservas.
El conector documentado es para vuelos. Amadeus también figura como proveedor de alojamiento, pero su guía de configuración aún no está publicada, así que consulta a nuestro equipo el alcance para hoteles.
Sigue explorando
Más sobre la plataforma
- Integración API de AmadeusVuelos, hoteles y coches de Amadeus en tu portal
- Integración de la API de DuffelOfertas y pedidos de vuelos Duffel en tu web de reservas
- Integración API de KiwiBúsqueda y reserva de vuelos Kiwi.com Tequila
- VuelosEmisión GDS y NDC
- Precios
- Todas las integracionesLa lista completa y actualizada