NEO Middleware: un API gateway configurable para sus integraciones
NEO Middleware es la capa de integración de la plataforma NEO: un API gateway configurable donde cada integración se registra en un panel administrativo, en lugar de código a medida. Conecta módulos NEO y sistemas externos — ERP, SAP, LIMS — validando, transformando y enrutando cada solicitud, con API keys, programación y un registro de auditoría completo.
NEO Middleware se sitúa entre los sistemas que lo llaman y los backends privados que responden. En lugar de escribir y desplegar un nuevo servicio para cada integración, usted registra un endpoint: una ruta y un método públicos asignados a una URL de destino del backend. Añadir o cambiar una integración es un cambio de configuración, no de código.
Cada llamada recorre el mismo pipeline: autenticar → validar → transformar → enrutar al backend → registrar. En el camino puede validar solicitud y respuesta contra un JSON Schema, remodelar payloads entre formatos, ingerir un archivo, repartir una solicitud entre varios backends y registrar el resultado — de modo que la integración es observable y gobernada desde la primera solicitud.
Lo que NEO Middleware aporta a sus integraciones
Un pipeline para cada solicitud
Las llamadas directas, las reejecuciones programadas y las fallas reprocesadas recorren las mismas etapas, así que el comportamiento es consistente sin importar cómo llegue una solicitud.
- API key + scopesVerificada contra los scopes y la lista permitida del endpoint
- JSON SchemaSolicitud y respuesta verificadas antes de reenviar
- JSONata / HandlebarsRemodela el payload entre formatos
- Reenvío (proxy)Al backend, protegido por circuit breaker
- Registro de la solicitudEstado, latencia y resultado registrados
Registre y gestione endpoints
Cada endpoint asigna una ruta y método públicos a una URL de destino del backend. Apúntelo a una URL completa o a un base path compartido y enrute dinámicamente a distintos backends por regla de negocio cuando lo necesite — todo desde un único catálogo.
Valide solicitudes y respuestas
Asocie un JSON Schema a un endpoint y el gateway verifica el payload antes de que llegue al backend, devolviendo un error preciso cuando falta un campo o está malformado — así los datos incorrectos se detienen en la puerta, no en el fondo de un sistema downstream.
Transforme payloads entre sistemas
Remodele una solicitud o respuesta con JSONata o Handlebars — renombre campos, reestructure objetos, enriquezca desde una consulta o convierta un CSV cargado en JSON. Dos sistemas que esperan formatos distintos se conectan sin reescribir ninguno.
Traiga datos con plugins de entrada
Algunas integraciones empiezan del otro lado. Un plugin de entrada puede obtener un archivo por FTP o SFTP, vigilar una carpeta, consultar deltas en un ERP o recibir un webhook de un socio — y luego alimentar lo que recoge en el mismo pipeline de validar, transformar y reenviar, de modo que las fuentes basadas en archivo y en evento se tratan igual que una llamada directa.
Defina las URLs de backend una vez
Registre una URL base de backend bajo una clave y refiérala como placeholder en endpoints y transforms. Cuando un backend cambia de lugar o de versión, usted edita un único base path en lugar de cada endpoint que apunta a él.
Controle el acceso con API keys
Emita API keys que llevan scopes y, cuando quiera un control más estricto, una lista explícita de los endpoints que pueden llamar. Las keys se pueden rotar y desactivar, así que el acceso se concede de forma deliberada y se revoca limpiamente.
Automatice llamadas por programación
Asocie una expresión CRON a un endpoint y el gateway ejecuta todo su pipeline en esa cadencia — ideal para importaciones y sincronizaciones recurrentes. Cada programación registra la hora y el estado de la última ejecución, para que una falla silenciosa no pase inadvertida.
Vea cada llamada que hace el gateway
El registro de solicitudes lista cada llamada con su endpoint, API key, estado, latencia y mensaje de error, filtrable por key, endpoint, estado y rango de fechas. Cuando algo falla, encuentra la llamada fallida y la reprocesa — hasta tres intentos — sin que el sistema de origen reenvíe nada.
Un historial de cambios auditable
Cada cambio de configuración — en un endpoint, key, transform, schema o base path — se escribe en un registro de auditoría con el antes y el después, el usuario responsable y la hora. En un entorno regulado, esa es la evidencia de que su capa de integración está bajo control.
Seguridad y gobernanza integradas
NEO Middleware en la plataforma NEO
NEO Middleware es donde la plataforma NEO se encuentra con el resto de sus sistemas. En lugar de que cada módulo lleve sus propias integraciones, todos pasan por un único gateway gobernado: NEO FLOW, NEO EBR y NEO TASK intercambian datos con su ERP, LIMS y APIs de socios mediante endpoints definidos aquí.
Como cada llamada se valida, transforma, registra y audita en un solo lugar, la propia capa de integración pasa a formar parte de su cumplimiento digital — trazable y bajo control, en lugar de un conjunto de scripts que nadie puede explicar por completo.
Para quién es NEO Middleware
- Un lugar para cada conexiónRegistre, cambie y retire integraciones desde un único panel, con base paths para definir una URL de backend una vez y reutilizarla en todas partes.
- Sincronizaciones automáticas y fiablesPrograme importaciones y sincronizaciones recurrentes, sígalas en los logs y reprocese una llamada fallida sin pedir al sistema de origen que la reenvíe.
- Una capa de integración trazableCada cambio de configuración queda registrado en un registro de auditoría con el antes y el después, apoyando la trazabilidad que un entorno regulado espera.
Preguntas frecuentes
¿Necesito escribir código para añadir una integración?+
No. Una integración es un endpoint que se configura en el panel — una ruta y método públicos asignados a una URL de backend. La validación es un JSON Schema, y las transformaciones de payload se escriben de forma declarativa con JSONata o Handlebars, así que la mayoría de las integraciones son configuración, no un nuevo despliegue.
¿Cómo se autentican los llamadores y los administradores?+
Los llamadores al gateway público presentan una API key que debe tener los scopes que el endpoint exige y respetar cualquier lista de endpoints permitidos de la key. Los administradores inician sesión en el panel con contraseña más un código de un solo uso por e-mail, o mediante inicio de sesión Microsoft/Google, y su acceso se limita por rol.
¿NEO Middleware puede conectarse a sistemas fuera de NEO?+
Sí. Cualquier backend HTTP puede ser destino — ERP, SAP, LIMS o una API de un socio. Los base paths y los transforms adaptan URLs y formatos, un plugin FTP de entrada puede obtener un archivo antes de la llamada, y un endpoint puede aceptar la carga de un archivo y pasarlo por un pipeline CSV/JSON antes de reenviar.
¿Está atado a la suite NEO?+
Es la capa de integración de la plataforma NEO, pero funciona como un gateway de propósito general. Se usa habitualmente para conectar módulos NEO como NEO FLOW, NEO EBR y NEO TASK al ERP, LIMS y otros sistemas de la empresa, sin incrustar esas integraciones en cada módulo.
En una demostración registraremos un endpoint, validaremos y transformaremos un payload y lo enrutaremos a un backend — usando una integración cercana a su realidad, para que vea con qué rapidez una nueva conexión entra en servicio.