Conectividad e interoperabilidad
Integración con servicios de terceros y organismos públicos
01 · Aplicación interna
- Petición en el modelo interno
- Cola de envíos pendientes
02 · Adaptador del tercero
- Traducción al formato del servicio
- Control de cuota y reintentos
- Detección de respuestas desconocidas
03 · Credenciales
- Almacén de secretos y certificados de la empresa
- Aviso previo a cada caducidad
04 · Servicio externo y evidencias
- API del proveedor u organismo
- Acuse o justificante conservado
El problema
Por qué hay que decidirlo bien
Una integración con un tercero puede estar perfecta el día de la entrega y fallar tres meses después sin que nadie haya tocado el código: caduca un certificado, el proveedor retira la versión antigua de su API, cambia un campo obligatorio o empieza a cobrar por encima de cierta cuota. Si la lógica de negocio llama directamente al servicio externo desde muchos puntos, cada cambio obliga a buscar y corregir en todas partes. El reto es que esos cambios se detecten pronto, se corrijan en un solo lugar y, mientras tanto, la empresa pueda seguir trabajando.
Escenarios
Situaciones en las que se plantea
Ejemplos de lo que se podría diseñar. No describen proyectos realizados.
01
Varios transportistas con APIs distintas
La aplicación interna pide «crear envío» y «consultar estado» siempre igual. Un adaptador por transportista traduce a su formato, gestiona su autenticación y sus límites de uso, y cambiar de transportista o añadir uno nuevo no afecta al resto del sistema.
02
Presentación ante un servicio electrónico de la administración
Cuando un organismo ofrece un servicio web documentado, la integración prepara el envío, lo firma con el certificado de la empresa custodiado en un almacén seguro y guarda el acuse. La tramitación y su contenido siguen siendo responsabilidad de la empresa.
03
Pasarela de pago y conciliación bancaria
Los cobros se inician contra la pasarela y su resultado llega por aviso automático; una consulta diaria a la entidad o la descarga de extractos permite conciliar. Si un aviso se pierde, la conciliación lo detecta antes del cierre contable.
04
Marketplace que anuncia una versión nueva de su API
El proveedor comunica la retirada de una versión con fecha. Como solo el adaptador conoce su formato, el cambio se desarrolla y prueba en su entorno de pruebas sin tocar la lógica de pedidos, y se activa antes del plazo.
05
Proveedor caído en plena jornada
El servicio de un tercero deja de responder. Las peticiones se acumulan en una cola, la aplicación muestra el estado pendiente en lugar de un error genérico y, si la caída se prolonga, existe un procedimiento manual acordado para no detener la operación.
Decisiones técnicas
Qué hay que decidir y con qué criterio
01
Autenticación y custodia de credenciales
Claves de API, flujos OAuth, certificados de cliente o certificados electrónicos de la empresa se guardan en un almacén de secretos, nunca en el código. Se registra quién los usa y se avisa con antelación de cada caducidad.
02
Adaptador por servicio externo
Cada tercero queda detrás de un componente propio que traduce su modelo al interno y concentra su autenticación, sus errores y sus particularidades. La lógica de negocio no sabe con qué proveedor está hablando.
03
Cuotas, costes y condiciones de uso
Se revisan los límites de llamadas, el coste por uso, los términos que restringen almacenar o redistribuir datos y los niveles de servicio que el proveedor ofrece realmente. Esas condiciones contractuales condicionan el diseño tanto como la API.
04
Detección de cambios en la API
Pruebas automáticas contra el entorno de pruebas del tercero, alertas cuando aparecen campos o errores desconocidos y suscripción a sus avisos de cambios. Así una ruptura se descubre en horas y no por la queja de un cliente.
05
Modo degradado
Para cada servicio externo se decide qué hace el sistema si no responde: encolar y reintentar, usar el último dato conocido, ofrecer una alternativa manual o bloquear la operación. La respuesta depende del impacto en el negocio.
06
Justificantes y evidencias
Se conservan los acuses, números de registro o respuestas del tercero que acrediten qué se envió y cuándo, con una política de retención acordada con la empresa y, en su caso, con su asesoría.
Riesgos y límites
Lo que conviene tener presente
- No disponemos de acceso propio a sistemas de las administraciones: la integración usa los servicios que cada organismo publique y las credenciales que la empresa obtenga en su nombre.
- El tercero puede cambiar su API, sus condiciones o sus precios con más o menos preaviso; ese riesgo se reduce con el diseño, pero no se elimina.
- Los niveles de servicio del proveedor limitan los del sistema: si el tercero no se compromete a una disponibilidad, la integración tampoco puede ofrecerla.
- Enviar datos personales a un tercero requiere la base jurídica y los contratos que correspondan, que debe valorar el responsable del tratamiento.
Preguntas frecuentes
¿Podéis conectar nuestro sistema con cualquier administración?
Podemos integrar los servicios que un organismo publique con documentación técnica y condiciones de acceso. El alta, los certificados y las autorizaciones los obtiene la empresa. Si el organismo no ofrece una vía automatizada, la integración no puede inventarla.
¿Qué pasa si el proveedor cambia su API sin avisar?
Las alertas sobre errores y respuestas desconocidas lo detectan pronto, y como el cambio afecta solo a su adaptador, la corrección es acotada. Mientras tanto, las operaciones quedan en cola o pasan al modo degradado que se haya definido.
¿Dónde se guarda el certificado electrónico de la empresa?
En un almacén de secretos o un dispositivo seguro con acceso restringido al proceso que lo necesita, nunca en el código ni en equipos personales. Se acuerda con la empresa quién puede renovarlo y cómo se registra cada uso.
Sectores, capacidades y lecturas relacionadas
Sectores donde se plantea
Capacidades relacionadas
- Integración de sistemasConexiones entre aplicaciones que mueven datos con reglas claras, detectan errores y permiten saber qué versión de cada dato es la buena.
- Automatización documentalLectura de facturas, albaranes, contratos y expedientes con extracción asistida, reglas de contraste y revisión de lo dudoso.
- Seguridad de aplicacionesControles de seguridad pensados desde el diseño de cada aplicación: amenazas identificadas, secretos protegidos, dependencias vigiladas y pruebas en el ciclo de desarrollo.
Cuéntanos con qué proveedores u organismos necesitas intercambiar datos
Ninguna modalidad está disponible por defecto en todos los proyectos: se elige tras evaluar requisitos, sistemas existentes y riesgos.
Sin compromiso de aceptación: estudiamos cada caso antes de proponer nada. Cómo tratamos la información que compartes.