API del almacén automático: conectar sin depender del proveedor

- La API es el contrato documentado por el que el ERP, el WMS o un cuadro de mando piden órdenes y reciben información del almacén automático; sin ella, cada integración depende del proveedor.
- Mínimos: crear y cancelar órdenes, consultar stock y estado de órdenes y equipos, y recibir eventos de movimientos y alarmas, con descripción formal, entorno de pruebas y versionado.
- Seguridad desde el diseño: credenciales por sistema, permisos por función y red segmentada; INCIBE gestionó 97.348 incidentes en 2024, 31.540 en empresas.
- La normativa empuja en la misma dirección: el Data Act aplica desde el 12 de septiembre de 2025 y el Reglamento de Ciberresiliencia exige notificaciones desde el 11 de septiembre de 2026.
Una instalación automática sin API es una caja negra. Funciona, pero solo su proveedor puede conectarla con otros sistemas. Cada cambio futuro, un nuevo ERP, un cuadro de mando, un transportista nuevo o un agente de IA, se convierte en un presupuesto y en una cola de espera.
La API (interfaz de programación de aplicaciones) es el contrato que dice qué puede pedir un sistema externo al almacén automático y qué información recibe a cambio: crear órdenes, consultar stock, conocer el estado de los equipos, recibir avisos. Si ese contrato está documentado, es estable y está en manos del cliente, la instalación se integra con lo que venga. Si no, el cliente queda atado.
El tema afecta a casi cualquier empresa. Según el INE, el 63,6% de las empresas españolas con conexión a Internet usaba software ERP en el primer trimestre de 2025, y el 44,3% pagaba servicios en la nube. Un almacén automático que no habla bien con esos sistemas pierde buena parte de su valor. En este artículo explicamos qué exigir, cómo comprobarlo y cómo protegerlo.
Qué es la API de un almacén automático y dónde se sitúa
En un almacén automático hay varias capas de software. El ERP gestiona pedidos, compras y facturación. El WMS gestiona ubicaciones, stock y tareas. Por debajo, el sistema de control de la instalación (WCS) traduce órdenes en movimientos de shuttles, elevadores y transportadores, y el PLC ejecuta esos movimientos con sus seguridades. El reparto de funciones entre estas capas lo explicamos en WMS WCS WES: qué decide cada sistema en un almacén automático y cómo repartirlos.
La API que interesa al cliente es la que expone el sistema de control o el WMS de la instalación hacia arriba: la puerta por la que el ERP, el cuadro de mando o cualquier aplicación nueva piden cosas al almacén. No es la comunicación interna entre WCS y PLC, que debe seguir cerrada y protegida.
Una buena API separa el qué del cómo. El ERP pide sacar 12 cajas de una referencia para un pedido; el almacén decide qué ubicación, qué shuttle y qué ruta. Así se puede cambiar el ERP sin tocar la automatización, y ampliar la automatización sin tocar el ERP.
Operaciones y eventos mínimos que debe ofrecer
Estas son las operaciones que deberían estar en cualquier API de almacén automático, documentadas y probadas:
- Crear, modificar y cancelar órdenes de entrada y de salida, con prioridad y fecha.
- Consultar stock por referencia, lote, caducidad y ubicación.
- Consultar el estado de una orden: pendiente, en curso, terminada, con error.
- Consultar el estado de los equipos: disponible, en avería, en mantenimiento.
- Gestionar datos maestros: referencias, dimensiones, pesos, tipos de unidad de carga.
- Lanzar y cerrar inventarios y recuentos.
Y estos son los eventos que el almacén debe enviar sin que nadie pregunte:
- Movimiento terminado, con unidad de carga, origen y destino.
- Orden completada o rechazada, con motivo.
- Alarma o avería de un equipo, y su resolución.
- Diferencia de inventario o unidad de carga rechazada en el control de entrada.
Los errores también forman parte del contrato. Para APIs HTTP existe un formato estándar, el RFC 9457, publicado en julio de 2023, que define detalles de problema legibles por máquina y sustituye al RFC 7807. Pedir que los errores sigan un formato así evita que cada integración tenga que adivinar qué ha fallado.
REST, mensajería, OPC UA o ficheros: cómo elegir
No hay un único protocolo correcto. Depende de qué sistema se conecta y para qué. Esta tabla resume los criterios que usamos:
| Mecanismo | Uso típico | Ventajas | Límites |
|---|---|---|---|
| API REST sobre HTTPS | ERP, WMS, aplicaciones de gestión | Estándar, fácil de probar y documentar | Para eventos hay que añadir webhooks o mensajería |
| Mensajería (colas o publicación/suscripción) | Eventos de movimientos y alarmas | Desacopla sistemas, no se pierden mensajes si uno cae | Requiere un intermediario y su mantenimiento |
| OPC UA | Supervisión de equipos, SCADA, datos de máquina | Modelo de información industrial y seguridad integrada | No pensado para lógica de pedidos |
| Ficheros o tablas compartidas | Sistemas antiguos sin otra opción | Sencillo de arrancar | Frágil, sin confirmaciones ni control de errores |
En la práctica, lo habitual es combinar: REST para órdenes y consultas, mensajería o webhooks para eventos, y OPC UA para la supervisión técnica, que explicamos en OPC UA: el idioma común de las máquinas y cómo exigirlo en tu instalación. Las tablas compartidas en base de datos solo como último recurso y con un plan para sustituirlas.
Ejemplo con supuestos: consultar cada pocos segundos o recibir eventos
Este es un ejemplo de cálculo con supuestos hipotéticos declarados, no un dato de cliente. Muestra por qué los eventos importan.
Supuestos:
- 50 órdenes abiertas de media durante 16 horas de operación al día.
- Sin eventos, el ERP consulta el estado de cada orden cada 5 segundos.
- El almacén hace 4.000 movimientos al día.
Paso 1. Consultas al día sin eventos = 50 órdenes × (16 × 3.600 / 5) = 50 × 11.520 = 576.000 consultas.
Paso 2. Mensajes al día con eventos = 1 evento por movimiento = 4.000 mensajes, más los de órdenes terminadas y alarmas.
Paso 3. Relación = 576.000 / 4.000 = 144 veces más tráfico con consultas periódicas.
Además, con consultas cada 5 segundos el ERP se entera de media 2,5 segundos tarde de cada cambio; con eventos, al momento. Multiplica eso por varios sistemas consultando a la vez y se entiende por qué una API sin eventos acaba saturando el servidor del almacén.
Un segundo cálculo útil es el de dependencia. Supongamos, solo para el ejemplo, tres integraciones nuevas en cinco años y que cada una cuesta H horas a quien la haga. Con API documentada y entorno de pruebas, las puede hacer cualquier integrador o tu equipo, y compites en precio y plazo. Sin API, todas pasan por el proveedor original. La fórmula del riesgo es simple: coste de dependencia = número de cambios futuros × (tarifa del proveedor único − tarifa de mercado) × H, más el tiempo de espera de cada cambio. Si quieres estimarlo con tus sistemas y planes reales, pide tu estudio gratuito y lo revisamos contigo.
Documentación, versionado y entorno de pruebas
Una API sin documentación es casi tan cerrada como no tener API. Lo que conviene exigir:
- Descripción formal y legible por máquina. El estándar de hecho para APIs HTTP es la especificación OpenAPI; la versión 3.2.1 se publicó el 10 de septiembre de 2026. Con ese fichero se generan clientes, pruebas y documentación sin escribir a mano.
- Documentación funcional: qué significa cada estado, qué pasa si se cancela una orden en curso, qué validaciones se hacen.
- Entorno de pruebas (sandbox) accesible para el cliente o su integrador, con datos ficticios y el mismo comportamiento que producción.
- Versionado explícito: los cambios incompatibles van en una versión nueva y la anterior se mantiene un periodo pactado.
- Registro de cambios publicado con cada actualización.
En nuestra experiencia, la documentación incompleta o desactualizada es uno de los problemas que más retrasan una integración. Por eso la documentación de la API debe ser un entregable del contrato, igual que los planos o el manual de mantenimiento, no un favor del proveedor.
¿Tu almacén automático podrá conectarse con lo que necesites dentro de cinco años?
Revisamos tu instalación o tu pliego, tus sistemas y tus planes para definir qué interfaz debes exigir y cómo integrarla sin depender de un único proveedor, en un estudio gratuito.
Habla con nuestra ingenieríaSeguridad: abrir la API sin abrir la planta
Abrir una API no significa exponer la instalación. Significa dar un acceso controlado, autenticado y registrado. El riesgo es real: INCIBE gestionó 97.348 incidentes de ciberseguridad en 2024, un 16,6% más que en 2023, y 31.540 afectaron a empresas.
Medidas mínimas:
- Cifrado de las comunicaciones y autenticación fuerte de cada sistema cliente, con credenciales propias y revocables.
- Permisos por función: el cuadro de mando solo lee; el ERP crea órdenes; nadie salvo mantenimiento cambia parámetros.
- Segmentación de red: la API vive en una zona intermedia; el PLC y la red de control no son accesibles desde la red de oficina.
- Límites de llamadas y registro de cada petición con su origen.
- Plan de actualizaciones de seguridad del software de la instalación.
Si la API la van a usar agentes de IA, el control es todavía más importante. OWASP describe el riesgo de exceso de agencia: funcionalidad, permisos y autonomía excesivos. Una API con permisos granulares es la mejor defensa: el agente solo puede hacer lo que su credencial permite. Lo desarrollamos en Agentes de IA en operaciones logísticas: del informe a la acción, con control. El marco general de ciberseguridad de planta lo tratamos en Ciberseguridad industrial: proteger la planta conectada con IEC 62443.
El marco europeo empuja hacia sistemas abiertos y seguros
Dos reglamentos europeos refuerzan lo que aquí defendemos.
El Reglamento de Datos (Data Act) es aplicable desde el 12 de septiembre de 2025, y los gastos por cambiar de proveedor de servicios de tratamiento de datos y por extraer los datos desaparecen a partir del 12 de enero de 2027. Si el software de tu almacén se contrata como servicio en la nube, esto te da argumentos para exigir portabilidad de datos y una salida ordenada.
El Reglamento de Ciberresiliencia entró en vigor el 10 de diciembre de 2024; sus obligaciones de notificación se aplican desde el 11 de septiembre de 2026 y las obligaciones principales desde el 11 de diciembre de 2027. Afecta a productos con elementos digitales, y el software de control y sus interfaces entran en esa conversación. Pregunta a tu proveedor cómo gestiona vulnerabilidades y actualizaciones.
La consecuencia práctica es clara: pedir una API documentada, segura y con datos exportables ya no es un capricho técnico, es alinearse con hacia dónde va la normativa.
Checklist: qué preguntar al proveedor sobre la API
Antes de firmar, conviene tener por escrito la respuesta a estas preguntas:
- ¿Qué operaciones y eventos ofrece la API? Pide la lista completa, no un resumen comercial.
- ¿Existe una descripción formal (por ejemplo, OpenAPI) que se entrega al cliente?
- ¿Hay entorno de pruebas accesible para mi equipo o mi integrador, sin coste por cada uso?
- ¿Cómo se versiona? ¿Cuánto tiempo se mantiene una versión antigua tras una actualización?
- ¿Puedo integrar otros sistemas sin pedir permiso ni pagar licencias adicionales por conexión?
- ¿Qué formato tienen los errores y qué códigos de estado se usan?
- ¿Cómo se autentica cada sistema cliente y cómo se revoca un acceso?
- ¿Cómo se exportan todos los datos (stock, histórico de movimientos, maestros) si cambio de proveedor de software?
- ¿Qué latencia y qué volumen de peticiones soporta? ¿Hay límites documentados?
- ¿Cómo notifica vulnerabilidades y entrega parches de seguridad?
La integración con el ERP en concreto, con sus fases y pruebas, la explicamos en Integración ERP almacén automático: mensajes, formatos, pruebas y quién responde de cada parte.
Cómo lo resolvemos en Shuttlia
En Shuttlia diseñamos las instalaciones para que el cliente no dependa de nosotros para conectarlas con nada. Nuestro método:
- Toma de datos de la operación: flujos, volúmenes y, desde el principio, el mapa de sistemas con los que tendrá que hablar el almacén.
- Layout y simulación: dimensionamos la instalación y validamos su capacidad antes de construir.
- Propuesta cerrada con rango de inversión, que incluye el alcance de la integración y la documentación de interfaces como entregable.
- Integración con sus sistemas: ERP, WMS, cuadros de mando y aplicaciones futuras, a través de interfaces documentadas y con red segmentada.
- Servicio posventa: soporte, mantenimiento y evolución de la instalación y sus integraciones.
Si ya tienes una instalación cerrada o estás preparando un pliego y quieres saber qué exigir en la interfaz, pide tu estudio gratuito y lo revisamos contigo.
Conclusión: la API es parte de la inversión
Una instalación automática dura muchos años. En ese tiempo cambiarán el ERP, los clientes, los transportistas y la forma de trabajar. La API es lo que permite que el almacén acompañe esos cambios sin rehacerse.
Exigirla documentada, versionada, con eventos, con entorno de pruebas y con seguridad desde el diseño cuesta poco en la fase de pliego. Hacerlo después, con la instalación ya en marcha, suele costar mucho más y depender de un solo proveedor.
¿Lo aplicamos a tu almacén?
Cuéntanos tus palés, referencias y picos. Te devolvemos sin coste el cuello de botella, la solución que encaja y un rango de inversión.
Pide tu estudio gratuitoPreguntas frecuentes
¿Qué es la API de un almacén automático?
Es la interfaz documentada a través de la cual otros sistemas, como el ERP, el WMS o un cuadro de mando, se comunican con el sistema de control del almacén. Permite crear órdenes de entrada y salida, consultar stock y estado de equipos y recibir eventos como movimientos terminados o alarmas. Si está bien hecha, separa lo que se pide de cómo lo ejecuta la automatización, y facilita cambiar o añadir sistemas sin tocar la instalación.
¿Es mejor una API REST o mensajería?
Ambas son válidas y suelen combinarse. REST sobre HTTPS es la opción natural para crear órdenes y hacer consultas desde el ERP o el WMS. Para eventos, como movimientos terminados o alarmas, la mensajería o los webhooks evitan que los sistemas pregunten cada pocos segundos y reducen mucho el tráfico. Lo importante no es el protocolo, sino que esté documentado, versionado y probado en un entorno de pruebas.
¿Es seguro abrir la API del almacén a otros sistemas?
Sí, si se hace bien. La API debe exigir autenticación fuerte de cada sistema, cifrar las comunicaciones, dar permisos por función y registrar cada petición. Además, debe estar en una zona de red intermedia, separada de la red de control y de los PLC. Abrir la API no significa dar acceso a la planta, sino ofrecer una puerta controlada a operaciones concretas, que se puede revocar en cualquier momento.
¿Puedo conectar un agente de IA a la API del almacén?
Sí, y es la forma correcta de hacerlo, mucho mejor que leer pantallas o exportaciones. Pero el agente debe tener su propia credencial con permisos mínimos: por ejemplo, consultar stock y estado de órdenes, y como mucho proponer órdenes que valida una persona. Nunca debe enviar órdenes directamente a los equipos ni saltarse el sistema de control. Una API con permisos granulares es la mejor protección frente a un agente con demasiada capacidad.
¿Qué hago si mi instalación actual no tiene API?
Primero, inventaria qué intercambios hay hoy: ficheros, tablas compartidas o integraciones a medida. Después, pregunta al proveedor si existe una interfaz documentada aunque no se haya entregado. Si no existe, se puede añadir una capa intermedia que exponga una API estable hacia fuera y hable con el sistema actual por dentro. Es un proyecto acotado y suele ser el primer paso antes de cambiar el ERP o añadir nuevas aplicaciones.
¿Qué debe incluir el pliego sobre la API?
Como mínimo: lista de operaciones y eventos, descripción formal legible por máquina, documentación funcional, entorno de pruebas para el cliente, política de versionado, formato de errores, mecanismo de autenticación, exportación completa de datos y gestión de vulnerabilidades. Todo ello como entregable contractual, con derecho del cliente a integrar otros sistemas sin licencias adicionales por conexión. Así la API forma parte de la recepción de la instalación y se prueba en la aceptación.
Fuentes
- INE: Encuesta sobre el uso de TIC y comercio electrónico en las empresas 2024-primer trimestre 2025
- INCIBE: Balance de ciberseguridad 2024
- Comisión Europea: Data Act explained
- Comisión Europea: Cyber Resilience Act
- OpenAPI Initiative: OpenAPI Specification v3.2
- IETF / RFC Editor: RFC 9457, Problem Details for HTTP APIs (julio 2023)
- OWASP: LLM06:2025 Excessive Agency

