Connector & API Management

Connector & API Management es el centro de integración de Nashua 360: el plano de control único a través del cual la suite se comunica con todos los sistemas de su entorno. Gobierna el ciclo de vida completo de una integración, desde las credenciales y los endpoints que definen una conexión, pasando por las reglas de transformación que reconcilian los datos externos con el modelo propio de la suite, hasta la programación, la supervisión y la gestión de errores que mantienen el flujo de datos de forma fiable. Mientras otros módulos producen y consumen datos de negocio, este módulo rige la manera en que esos datos cruzan la frontera entre Nashua 360 y el mundo exterior.

Se ubica dentro de System Administration como el borde de la suite orientado hacia el exterior. Cada punto de contacto externo se registra, se acredita y se observa aquí: API REST, SOAP y GraphQL, servidores de Model Context Protocol, correo saliente y entrante, plataformas de contenidos, sistemas de clientes e identidad, socios de intercambio electrónico de datos y canales bancarios. Al concentrar esta responsabilidad en un solo lugar, el módulo ofrece a los administradores un inventario completo y auditable de la superficie de integración de la organización, en lugar de una dispersión de conexiones punto a punto ocultas en funcionalidades individuales.

Qué hace el módulo

El módulo gestiona el conjunto completo de conexiones externas de las que depende una empresa moderna. Proporciona un control total del ciclo de vida de los conectores de API que abarcan REST, SOAP y GraphQL, cada uno con su propio esquema de autenticación, endpoints base, cabeceras, política de reintentos y límites de frecuencia. Configura los servidores de Model Context Protocol que exponen herramientas y recursos a la capa de IA de la suite, y contiene la configuración de correo saliente y entrante, tanto SMTP para el envío como IMAP para la recuperación, que transporta notificaciones, informes y tráfico de campañas.

Más allá de los conectores individuales, opera el movimiento de datos a gran volumen. Los pipelines de ETL y ELT extraen de los sistemas de origen, aplican reglas de transformación declarativas y cargan en la suite, o bien depositan primero los datos en bruto y los transforman en destino cuando el almacén de destino se adapta mejor a esa tarea. Ejecuta el intercambio electrónico de datos con socios comerciales, mantiene conectores con plataformas de contenidos como WordPress, Sitecore, Adobe AEM, Drupal y Umbraco, e integra sistemas de clientes e identidad. La sincronización programada, la detección de deltas, las colas de errores dead-letter y la reejecución completan el panorama, de modo que las conexiones no solo se definen, sino que se operan de forma continua y observable.

El dominio y el modelo de datos

En el centro del dominio se sitúa la idea de conexión: una relación duradera y con nombre con un sistema externo. Una conexión reúne todo lo necesario para alcanzar ese sistema y confiar en él, sus endpoints, su material de autenticación y sus ajustes de comportamiento, mantenidos como configuración estructurada y tipados según la clase de sistema que representan, ya sea una API, una plataforma de contenidos, un proveedor de identidad, un servidor de correo o un canal bancario. Los secretos pertenecientes a una conexión se mantienen separados de la configuración ordinaria y cifrados en reposo, de forma que las credenciales nunca viajan junto a los campos descriptivos que los administradores editan de manera habitual.

Una conexión adquiere sentido mediante un pipeline, la definición de cómo se mueven los datos a través de ella: qué recurso se lee o se escribe, en qué dirección, con qué programación y bajo qué mapeo. Un pipeline hace referencia a una o varias reglas de transformación, la lógica declarativa que reformula los registros externos al vocabulario propio de la suite y a la inversa, resolviendo nombres de campo, formatos, listas de códigos y unidades. Cada vez que un pipeline se ejecuta produce un registro de ejecución que captura qué se intentó, qué tuvo éxito y qué no, y cualquier registro que no pueda procesarse se aparta en una cola de errores conservando todo su contexto para su inspección, corrección y reejecución. En conjunto, estos conceptos permiten al administrador razonar sobre las integraciones en términos de negocio: qué está conectado, qué fluye, cómo se traduce y qué ocurrió en la última ejecución.

Connector & APIManagementAPI connectorsMCP serversCMS platformsIdentity providersEmail serverEDI & banking
Connector & API Management is the single control plane through which Nashua 360 reaches every external system.

Flujos de trabajo principales

Registrar una conexión es el primer flujo de trabajo. El administrador selecciona el tipo de sistema, aporta sus endpoints y credenciales, elige un esquema de autenticación y valida la conexión con una prueba en vivo que confirma la accesibilidad y la autorización antes de guardarla. A partir de ahí, construir un pipeline vincula esa conexión a un movimiento de datos concreto: elegir el recurso, la dirección, el mapeo y la programación, y a continuación ejecutarlo en seco contra una muestra para confirmar que la transformación produce la forma esperada.

Una vez en producción, los pipelines se ejecutan según su programación o bajo demanda. Cada ejecución se supervisa en tiempo real, con el rendimiento, la latencia y las tasas de éxito reflejados en el hub. Cuando los registros no superan la validación o un sistema posterior los rechaza, se acumulan en la cola de errores, donde un operador puede examinar la carga problemática, ajustar un mapeo o los datos de origen y reejecutar los registros afectados sin volver a lanzar todo el lote. Rotar una credencial, revisar una regla de transformación o pausar la alimentación de un socio son operaciones de primer nivel, y cada una de ellas queda registrada, de modo que el estado de cualquier integración en cualquier momento pasado puede reconstruirse.

Profundidad funcional que importa

La cobertura de autenticación del módulo es deliberadamente amplia, porque la integración falla con más frecuencia en la frontera de confianza. Gestiona API keys, tokens bearer, credenciales HTTP básicas y el conjunto completo de concesiones de OAuth 2.0, incluidas las client credentials para llamadas de servicio a servicio y los flujos de authorization code para el acceso delegado, con renovación automática de tokens y gestión de la caducidad. Para la federación de identidad configura SAML 2.0 con identificadores de entidad, endpoints de inicio de sesión y single logout, formatos de identificador de nombre y certificados de firma X.509; OpenID Connect y OAuth 2.0 genérico con discovery, scopes y gestión de redirecciones; y el enlace de directorio mediante LDAP y Active Directory con nombres distinguidos base, filtros de usuario y de grupo y TLS. El aprovisionamiento just-in-time y la vinculación de cuentas traducen un inicio de sesión federado en un usuario gobernado dentro de la suite, y el logout federado cierra la sesión de forma limpia en el proveedor.

La profundidad en el movimiento de datos es igual de cuidada. Los conectores de contenidos hablan el contrato nativo de cada plataforma, la API REST de WordPress, los servicios de item y GraphQL de Sitecore, la content fragment API de Adobe AEM, JSON:API de Drupal y la delivery API de Umbraco, cada uno con su idioma de autenticación correcto. La conectividad bancaria cubre los canales PSD2, EBICS y SWIFT, recuperando extractos e impulsando el parseo hacia el estándar CAMT.053, de modo que la reconciliación aguas arriba reciba transacciones limpias y estructuradas. El intercambio electrónico de datos aplica formatos de documento estándar y sobres específicos de cada socio. En todo momento, las reglas de transformación imponen la coerción de tipos de datos, la traducción de listas de códigos, la normalización de divisas y unidades y la validación referencial, y los controles de reintento, back-off y dead-letter garantizan que una interrupción transitoria se degrade de forma controlada en lugar de perder datos.

Cómo encaja en la suite Nashua 360

Connector & API Management es el borde de toda la plataforma, y casi todos los demás módulos alcanzan el mundo exterior a través de él. Trabaja de forma más estrecha con System Administration, del que forma parte, apoyándose en el modelo de roles y permisos de la suite para que solo los administradores autorizados puedan ver o modificar una conexión y sus secretos. Entrega las definiciones de servidores de Model Context Protocol a AI Management, que rige cómo los AI Workers de la suite descubren y utilizan herramientas externas. Suministra a Content Management los conectores en vivo que publican y extraen de plataformas de contenidos externas, y entrega datos de extractos estructurados a Accounting & Control, donde el parser CAMT.053 y las rutinas de reconciliación consumen las alimentaciones bancarias que este módulo programa.

Las integraciones de clientes e identidad alimentan las capas de CRM y de acceso de la suite, de manera que los contactos, las cuentas y los usuarios autenticados se originan en sistemas de registro y se mantienen sincronizados con ellos. La configuración de correo sustenta los servicios de notificación e informes en los que muchos módulos confían para llegar a las personas. Como cada conexión se registra de forma centralizada, el resto de la suite consume las integraciones por referencia en lugar de incrustar credenciales propias, lo que mantiene toda la superficie externa de la organización inventariada, con permisos y observable desde un solo lugar.

Cómo operan los AI Workers en su interior

Los AI Workers son operadores de primer nivel en este módulo, no meros espectadores. Un administrador puede preguntar, en lenguaje natural, qué conectores fallaron durante la noche, cómo ha evolucionado un pipeline concreto o qué alimentación de socio va con retraso, y el Worker responde directamente a partir de los registros de ejecución y del estado de las colas. Los Workers ejecutan acciones dentro de los permisos que se les han concedido: disparar una sincronización, reejecutar un lote de registros fallidos tras corregir un mapeo, rotar una credencial según una programación o pausar una conexión con comportamiento anómalo.

Vigilan de forma continua las anomalías y las excepciones, señalando un pico en la profundidad de la cola de errores, una caída repentina del rendimiento, un token de autenticación próximo a caducar o un socio cuya cadencia de entrega se ha ralentizado, y las plantean como alertas antes de que una persona lo advertiría. Cuando una carga externa llega con una forma desconocida, un Worker extrae y estructura sus campos y propone un mapeo de transformación, convirtiendo una tarea de inspección en una de revisión. Los Workers ofrecen apoyo a la decisión explicando por qué se rechazaron ciertos registros y recomendando el cambio de regla correctivo. Cuando la gobernanza lo exige, un Worker participa como nodo de aprobación o revisión en los propios flujos de trabajo del módulo, validando una nueva conexión a un sistema sensible o un cambio en un pipeline de producción antes de que surta efecto, con su criterio registrado en la misma pista de auditoría que cualquier acción humana.