Una integración no termina cuando la primera prueba devuelve datos. Termina cuando el flujo aguanta errores, cambios y volumen. El cliente suele ver solo la conexión; tú sabes que detrás hay autenticación, límites de peticiones, formatos y una dependencia permanente de terceros. Presupuestar eso es lo que separa un trabajo rentable de una factura que no cubre ni el soporte.
Alcance y dependencias que no controlas
Define qué sistemas se conectan, en qué dirección viajan los datos y con qué frecuencia. Una integración puntual no es lo mismo que una sincronización cada cinco minutos. Especifica qué campos se envían, qué pasa cuando falta uno y quién es responsable de que el dato de origen sea correcto.
- Sistemas de origen y destino, con sus versiones.
- Dirección y frecuencia de la sincronización.
- Campos obligatorios y reglas de transformación.
- Límites de peticiones y coste por uso del proveedor.
Deja claro que no respondes de la disponibilidad de una API ajena. Si el proveedor cambia su documentación o retira un endpoint, eso es un cambio de alcance o una incidencia de mantenimiento, no un defecto de tu trabajo. Ponlo por escrito antes de firmar.
Cómo presupuestar la integración
Separa el trabajo en tres bloques con precio propio: análisis y pruebas de acceso, construcción del flujo y puesta en marcha con datos reales. Cada bloque puede facturarse al terminar. La prueba de acceso es crítica: si no tienes credenciales o el entorno de pruebas no existe, el proyecto aún no ha empezado y el calendario no debe correr.
Cobra aparte la gestión de errores y el registro de actividad. Un flujo que falla sin dejar rastro es imposible de mantener. Esa parte no luce en la propuesta, pero es la que evita llamadas de emergencia y horas no facturadas cuando algo se rompe de madrugada.
- Acceso a entornos y credenciales como requisito previo.
- Construcción con casos de prueba acordados.
- Registro de errores y avisos al responsable.
- Documentación de campos y flujos entregada al cierre.
La API del proveedor no es tuya y puede cambiar sin avisarte. El contrato debe decir quién paga la adaptación cuando eso ocurra.
IVA y facturación del trabajo técnico
La integración es un servicio y tributa al 21 % de IVA con carácter general. Si el cliente es una empresa española, repercutirás el impuesto y él lo deducirá. Si facturas a otro país, revisa las reglas de localización y conserva la documentación del cliente. Los consumos de API que revendas, si los hay, van en una línea aparte con su propio importe.
Describe la factura por entregables: análisis, conectores, pruebas, puesta en marcha. Un concepto genérico de "desarrollo" no permite al cliente deducir con criterio ni a ti justificar el trabajo si hay una revisión. Y no mezcles la cuota de mantenimiento con la implantación: son servicios distintos y deben verse separados. Si revendes consumos de API, ponlos en una línea propia con su importe y su IVA.
Mantenimiento: la integración nunca está terminada
Las APIs cambian. Un campo pasa a ser obligatorio, un endpoint se deprecia, el proveedor limita las peticiones. Si no hay contrato de soporte, cada cambio es una conversación incómoda sobre quién paga. Vende una cuota de vigilancia y actualización, con un compromiso de respuesta y un límite de horas.
Incluye monitorización y avisos. Detectar un fallo antes que el cliente vale más que cualquier cláusula. Y define qué se considera incidencia: una caída del proveedor no es lo mismo que un cambio de reglas de negocio del cliente.
Documenta cada conector y sus credenciales. Cuando alguien del equipo se va, un flujo sin documentación se convierte en una caja negra que nadie se atreve a tocar. La entrega ordenada también reduce el tiempo de tu propio soporte y te permite cobrar por mejoras en lugar de por arqueología.
- Monitorización con aviso al responsable.
- Horario de soporte y tiempo de respuesta.
- Horas incluidas y precio de las adicionales.
- Revisión de versiones de las APIs conectadas.
Preguntas frecuentes
¿Quién responde si la API del proveedor falla?
El proveedor responde de su servicio; tú, de tu integración. El contrato debe separar ambos planos y prever cómo se avisa y qué se hace mientras dure la caída.
¿Puedo cobrar la integración por horas?
Solo si el alcance es incierto y el cliente acepta ese riesgo. Con alcance definido, el precio cerrado protege a las dos partes.
¿La integración incluye soporte para siempre?
No. La garantía cubre los errores de lo entregado durante un plazo corto. Los cambios y la vigilancia continua van en la cuota de mantenimiento.