Antes de contratar una empresa de integración API en Dubái

Hay tres presupuestos sobre la mesa. Cada empresa de integración tiene un portafolio de webs de viajes, cada una promete «conectar una API de vuelos a su web», y la más barata puede empezar la semana que viene. Usted dirige una agencia en Deira con seis empleados y una cartera corporativa estable, y está cansado de copiar tarifas de la extranet de un proveedor a mensajes de WhatsApp. Elegir la empresa de integración API en Dubái que parece más competente da la sensación de ser toda la decisión.
Es más o menos un tercio. Lo que decide si la web vende no está en ninguno de los tres presupuestos, porque no es código. Es con quién firmó el proveedor, a nombre de quién se emiten los billetes, dónde está el dinero entre la reserva y la emisión, y quién gestiona el reembolso cuando un cliente cancela. Un integrador puede conectar todo eso. No puede ser ninguna de esas piezas por usted.
Este texto está escrito para el dueño que firmará el contrato de trabajo, no para el desarrollador que lo leerá.
Lo que una empresa de integración API en Dubái puede entregar y lo que no
Una empresa de integración escribe el código entre la API de un proveedor y su web: el buscador, la llamada que pide disponibilidad, la comprobación de precio antes del pago, la solicitud de reserva, las pantallas que muestran el resultado y, si el alcance lo dice, las llamadas de cancelación y reembolso. Las buenas también resuelven la parte aburrida que importa: reintentos cuando un proveedor no responde a tiempo, registros que permiten rastrear una reserva fallida, un entorno de pruebas que se comporta como producción.
Lo que no puede darle es todo lo que hay al otro lado de ese código. Antes de escribir una línea, la agencia necesita:
- una cuenta con el proveedor a nombre de la propia agencia, con el acceso a la API concedido a esa cuenta;
- capacidad de emisión, ya sea acreditación propia o un consolidador que emita en su nombre;
- un acuerdo económico con ese proveedor: un depósito, una línea de crédito o pagos con tarjeta trasladados;
- alguien que haga el trabajo posterior a la emisión (anulaciones, reembolsos, reemisiones, cambios de horario), por API o, si no, a mano.
Un integrador que se ofrece a «arreglar la parte del proveedor» normalmente le está ofreciendo prestarle la suya. Como atajo para un prototipo puede ser razonable. Para un negocio significa que su web de reservas funciona sobre una relación que no es suya y que no podrá llevarse.
El encargo: siete líneas para el contrato
La mayoría de los conflictos con un integrador nacen de una frase que nadie escribió. Ponga estas en el documento que firma, con palabras sencillas, y pida cada respuesta por escrito.
- A nombre de quién están la cuenta del proveedor y las claves API. De la agencia. Las claves son credenciales: viven en su gestor de contraseñas, y al integrador se le da acceso, no la propiedad.
- Quién aloja la web y quién tiene el dominio. El dominio está registrado a nombre de la agencia. La cuenta de alojamiento es de la agencia, o el contrato dice exactamente cómo se transfiere.
- Qué operaciones entran en el alcance. Enumérelas por su nombre: buscar, cotizar, reservar, emitir, cancelar, reembolsar, cambiar. Lo que no esté en la lista seguirá siendo un correo al departamento del proveedor durante toda la vida de la web. Reembolsos y cambios son los que más se olvidan, porque son los que una demo nunca enseña.
- Quién la mantiene cuando el proveedor cambia su API. Los proveedores retiran versiones y renombran campos. Un desarrollo a precio cerrado sin cláusula de mantenimiento termina el día que cambia la primera versión.
- Qué significa la entrega. Código fuente en un repositorio propiedad de la agencia, todas las credenciales y un documento que permita a otro desarrollador continuar el trabajo. «Le mandamos un zip» no es una entrega.
- Cómo se demuestra la puesta en marcha. Una reserva de prueba de la búsqueda al billete en el entorno de pruebas del proveedor, cancelación incluida, antes de que nadie cobre la tarjeta de un cliente real.
- Qué pasa con los datos de los clientes. Nombres de pasajeros, datos de pasaporte y referencias de pago: dónde se guardan, quién puede leerlos y cómo se borran.
Ninguna de estas líneas exige formación técnica. Todas salen más baratas acordadas antes del desarrollo que negociadas después.
Tres formas de llevar el contenido del proveedor a su web
Contratar a un integrador contra la API de un proveedor es una vía. Conviene verla junto a las otras dos antes de que un presupuesto elija por usted.
| Vía | Quién tiene la relación con el proveedor | Quién mantiene la conexión | Qué sigue construyendo la agencia | Cuánto cuesta irse |
|---|---|---|---|---|
| El integrador conecta su web a la API de un proveedor | La agencia, si el encargo lo dice; si no, a menudo el integrador | El integrador con contrato de mantenimiento, o nadie | Administración, márgenes, fichas de clientes, informes, pagos, pantallas de servicio | Poco si el código y las claves son suyos; rehacerlo todo si no |
| El integrador conecta su web a la API de una plataforma | La plataforma tiene los contratos con proveedores; la agencia, su cuenta en la plataforma | La plataforma en el lado del proveedor; el integrador en el suyo | Su web y lo que la API de la plataforma no cubra | Reescribir su parte contra otra API |
| Tienda white-label ya conectada | La plataforma, a través de la cuenta de la agencia | La plataforma | Contenidos, decisiones de precio, sus propios clientes | Mover el dominio y la lista de clientes a otro proveedor |
La fila que merece discusión es la primera. Da el mayor control y le carga a usted con lo máximo: cada cambio del proveedor, cada servicio nuevo y cada operación que la primera versión dejó fuera se convierte en otro proyecto con otro presupuesto.
Cómo poner un buscador en una web que ya tiene se discute en añadir búsqueda de vuelos a una web existente, y qué API poner detrás en qué hay detrás de un proveedor de API de reservas de vuelos. Esta pieza trata del contrato que rodea el trabajo.
Dónde encaja esta plataforma
La plataforma que hay detrás de este blog ofrece API de vuelos y hoteles. El acceso empieza con una conversación y no con una clave autoservicio, porque las primeras preguntas son las de arriba (qué servicios, qué mercado, cómo se mueve el dinero) y no qué endpoint llamar. Los servicios se activan por cuenta, y cada cuenta tiene su propio panel de administración con sus reservas, clientes, márgenes e informes, así que la columna «sigue construyendo» de la segunda fila es más corta de lo que parece.
Si una empresa de integración va a construir su lado, tenga esa conversación antes de aceptar un presupuesto, para que el alcance describa la API a la que realmente se conectará. La página de las API de viajes es donde empieza.
Lo que le cuesta un encargo flojo
La web sale a producción. La búsqueda funciona, los precios parecen correctos y la primera reserva llega un jueves por la noche. No se puede emitir a su nombre, porque la cuenta del proveedor es del integrador y emite bajo su acuerdo. La tarjeta del cliente ya está cobrada. Ahora tiene una reserva que no puede ni emitir ni reembolsar desde su propia web.
O funciona durante un año. Luego el proveedor pasa a una nueva versión de la API, las reservas se detienen y el integrador, cuyo contrato a precio cerrado terminó en la entrega, presupuesta un proyecto nuevo. Usted lo paga, porque los únicos que entienden el código son los que presupuestan.
O el integrador simplemente está ocupado con otros clientes. Un cliente necesita corregir un nombre en un billete, la operación de cambio nunca estuvo en el alcance, y dos de sus empleados pasan la tarde escribiendo correos al departamento del proveedor. Justo el trabajo que la web debía quitarles.
Cada uno de estos casos es una frase que faltaba en el encargo. El código estaba bien todas las veces.