Integración de WMS y API
Sin integración, cada sistema QFM opera con un temporizador ajustado para la SKU más lenta; con ella, cada palé tiene su propio tiempo de ciclo, lo que se traduce en aumentos documentados en el rendimiento de entre 25 y 301 TP3T.
¿Por qué integrar?
Los tiempos de ciclo dinámicos por SKU son el factor operativo más importante en una sala de QFM.
De fábrica, una QFM inicia un ciclo con un temporizador genérico configurado para la SKU más lenta del edificio; luego ajusta el tiempo de finalización según las condiciones reales (calidad del sellado, temperatura, pausas). Esto es seguro, pero conservador: el producto de congelación rápida queda terminado, ocupando una posición en la línea de congelación que ya no necesita. Los ajustes de tiempo de ciclo en el campo, según los operadores, varían entre De 25 a 72 horas — Un solo temporizador para el peor de los casos deja sin aprovechar la mayor parte de ese margen. Al conectar el WMS, se resuelve el problema: la SKU escaneada establece el ciclo, y el WMS detecta el momento en que cada palé está listo.
| Mejora | Ganancia documentada |
|---|---|
| El momento de la reubicación por sí solo: retirar los palés cuando realmente estén listos, en lugar de hacerlo según el plazo previsto para el peor de los casos | ~15% de rendimiento |
| Integración total: tiempos de ciclo por SKU + elegibilidad para reubicación + gestión integral de la ocupación | 25–30%: rendimiento total (para una capacidad de refrigeración dada) |
El patrón del lado del WMS es deliberadamente sencillo: agregar un Tiempo de permanencia en congelación atributo del maestro de artículos; cuando se escanea un palé en una posición de congelación conocida, su estado pasa a Recibido → Congelado (con una pausa temporal), y cuando el ciclo se completa, se convierte en Elegible para reubicación. El palé permanece en su posición hasta que un palé recién llegado necesite ese espacio —las órdenes de reubicación se toman de la lista de productos elegibles—, lo que mantiene el congelador a plena capacidad en lugar de medio vacío entre una oleada y otra. Los tiempos de permanencia típicos oscilan entre 16 y 30 horas, por lo que los palés de rotación rápida se mueven rápido en lugar de esperar al producto más lento del almacén.
Mecánica de la integración
Un punto de conexión seguro y una clave API por instalación: configura ciclos, pausa o reanuda, y consulta el estado, ya sea por unidad o por zona.
Tu sistema de gestión de almacenes (WMS) o sistema de automatización de edificios se comunica con QFM a través de un único punto de conexión HTTPS asignado por instalación, autenticado con tu propia X-QF-API-Key encabezado. Para dirigirse a las unidades, se utiliza Serie QFM (validado con respecto a la ubicación en el rack como medida de seguridad, para que no puedas ajustar la unidad equivocada) o zonas completas según su ID de zona — limitado únicamente a tus propias unidades y zonas.
GET o POST https://qfmonitoring.com/api/v1/integrations/http/{tu-clave-de-enrutamiento}
A COMANDO El parámetro selecciona la acción (por defecto es set_cycle):
| Comando | Para qué sirve |
|---|---|
set_cycle |
Establecer el tiempo de ejecución cuando se escanea un palé — pasar INCUBACIÓN (horas completas) o un NÚMERO DE ARTÍCULO y deja que la biblioteca SKU establezca el horario. PALLET_TAG y PO se repiten al finalizar. |
pausa / currículum |
Detener o reiniciar los ventiladores. Una opción DURACIÓN (minutos) es un temporizador de inactividad que se reanuda automáticamente si no se realiza una acción para reanudarlo. |
encuesta |
Consulta el estado actual, la temperatura del plenum, el ΔP, la calidad del sellado y las horas restantes. |
| en masa (POST) | Envía un array JSON para realizar acciones en varias unidades en una sola llamada; cada elemento se autoriza individualmente. |
| zona | Dirigirse a un ZONA ID para consultar un valor agregado (temperatura promedio del plenum, recuentos de «listo», «en funcionamiento» y «fuera de línea», sellado correcto %) o para pausar/reanudar cada unidad de la zona. |
Cada llamada de unidad conlleva QFM_SERIAL y UBICACIÓN_DEL_RACK; a encuesta devuelve el valor actual de la unidad estado, una de las siguientes opciones:
| ESTADO | Significado |
|---|---|
LISTO |
Listo para un palé |
SEAL_TEST |
El ciclo ha comenzado, se está realizando la prueba de sellado (hasta 5 minutos) |
CORRER |
Prueba de sellado superada, ciclo en marcha |
SELLADO DEFECTUOSO |
Funcionó durante 5 minutos sin lograr un sellado adecuado |
PAUSA |
Pausado por los controles o el programa: el ventilador y el temporizador se detuvieron |
COMPLETO |
El ciclo ha finalizado, pero el palé sigue ahí |
BLOW_OUT |
Fuga tras la finalización de la operación, tras la retirada del palé |
ARRANQUE |
Inicialización: aproximadamente 2 minutos después de encender el dispositivo |
FALLO DEL MOTOR |
Falla del motor del ventilador — condición de servicio |
FALLO DEL SENSOR |
Fallo del LIDAR o del sensor de temperatura — condición de servicio |
No es necesario realizar una consulta: la finalización del ciclo también se puede notificar de forma proactiva — QFMonitoring envía un mensaje de “ciclo completado” al WMS, además de las notificaciones por SMS o correo electrónico, el estado en el tablero y el LED de la unidad. La mayoría de las integraciones utilizan la notificación proactiva para el flujo de trabajo y la consulta para la conciliación.
Problema de diseño: precisión de la correspondencia entre serie y ubicación. La integración depende de la precisión de la correspondencia entre QFM_SERIAL y RACK_LOCATION: una correspondencia incorrecta implica configurar los tiempos de ciclo en la unidad equivocada. QuickFreeze proporciona la correspondencia en una hoja de cálculo, y los metadatos de cada unidad (ubicación en el rack, orden del circuito) se asignan en el campo mediante el formulario con código QR que se encuentra en el costado de la unidad. Valida antes de la puesta en marcha: la verificación comprobada consiste en activar las unidades una por una según el código de ubicación y confirmar que la unidad física responda.
Esta es la descripción general. El referencia completa — ejemplos de solicitud/respuesta para copiar y pegar para cada comando, las llamadas masivas y de zona, las cargas útiles de las llamadas de retorno y los motivos de rechazo — se encuentran en el Guía de la API de QuickFreeze QFM →. Tu clave de enrutamiento, tu clave de API, la correspondencia entre números de serie y ubicaciones, los identificadores de zona y un entorno de prueba se generan durante la configuración de la integración.
Bibliotecas de SKU
La base de datos de tiempos de permanencia que permite que funcionen los ciclos por SKU.
El panel de control de QFM mantiene un Biblioteca de SKU — prellenada a partir de las SKU que se encuentran realmente en tus recintos — donde cada artículo incluye sus horas de permanencia, el cliente y la descripción. Al combinarse con una integración con el sistema de gestión de almacén (WMS), la biblioteca ajusta automáticamente los tiempos de ejecución de QFM según la SKU escaneada en la unidad, sin que el operador tenga que gestionar los tiempos. Los valores de tiempo de permanencia provienen de tres fuentes, en orden creciente de confiabilidad: el estándar existente del cliente, el manual de códigos de productos de almacenamiento y los estudios de tiempo in situ del producto real. Comience con lo que tiene; los datos de ciclos registrados refinan las cifras a partir de la primera semana de operación. (Para conocer los factores que determinan las horas en sí —porcentaje de solución, peso de la caja, temperatura ambiente—, consulte Sección 1 y el Calculadora de carga térmica.)
Condiciones de proceso y comerciales
Cuatro pasos, aproximadamente un mes de tiempo calendario y un costo presupuestario de cero.
| Fase | ¿Qué pasa? | Duración |
|---|---|---|
| 1. Llamada para definir el alcance | Flujo de trabajo definido de principio a fin (diagrama de carriles): qué escaneos activan qué llamadas, quién notifica a quién | 1 llamada |
| 2. Compilación paralela | QuickFreeze configura el punto final de integración y la asignación; su equipo de TI se encarga de desarrollar la parte del WMS | Simultáneo |
| 3. Integración con Sandbox | Pruebas conjuntas en un entorno de pruebas antes de modificar cualquier unidad de producción | ~3–4 semanas |
| 4. Puesta en marcha | Validación de la asignación, notificaciones push confirmadas, transición a producción |
Costo: Actualmente, QuickFreeze no cobra por las integraciones; la cifra presupuestaria es $0.00 — con una salvedad: el derecho a limitar la tasa de solicitudes si el volumen de estas se vuelve excesivo. No hay cargo por llamada ni suscripción vinculada a la API en sí.
Documentos y lecturas relacionadas
Los requisitos previos de la red, las especificaciones de la unidad y el tablero en tiempo real.
Requisitos de red
La integración requiere que las unidades estén conectadas: el firewall y los requisitos de DHCP son lo primero que necesita todo QFM.
Ficha técnica de QFM
La unidad en sí: sus dimensiones, su instalación y los componentes a los que se refieren tus números de serie.
Panel de control de ejemplo
La capa de monitoreo con la que funciona tu integración: la biblioteca de SKU, los estados de las unidades y las notificaciones.
Preguntas frecuentes sobre la integración
Preguntas de desarrolladores de WMS y EDI sobre integraciones reales.
¿La API es REST y utiliza los verbos POST y PUT?
El contrato de integración es una llamada HTTP GET con parámetros de URL a través de SSL, autenticada mediante un encabezado específico para cada cliente; el servidor responde con un código 200 si la operación se realiza con éxito. Se ha diseñado deliberadamente para ser minimalista: dos llamadas (establecer el tiempo de ciclo y consultar el estado) cubren el flujo de trabajo estándar. Cualquier requisito que vaya más allá del contrato estándar se define en la llamada de definición del alcance.
¿Hay un entorno de pruebas antes de trabajar con las unidades de producción?
Sí, la integración en el entorno de pruebas es una fase formal de cada implementación, que suele durar entre 3 y 4 semanas, y la puesta en marcha no se lleva a cabo hasta que se aprueben las pruebas conjuntas y la validación de la correspondencia.
¿Se puede enviar la información de finalización directamente a nuestro WMS en lugar de que nosotros la consultemos?
Sí. Cuando finaliza un ciclo, QFMonitoring puede enviar un mensaje de «ciclo completado» al WMS, junto con la notificación por SMS o correo electrónico, la actualización del tablero y el cambio en el LED de la unidad. Consulta el punto final de estado para la conciliación, en lugar de utilizarlo como señal principal.
¿Cuánto cuesta la integración?
El número de presupuesto es $0.00 — Actualmente, QuickFreeze no cobra por las integraciones. El único derecho reservado es la limitación de la tasa de solicitudes en caso de que el volumen de solicitudes sea excesivo, algo que un WMS bien programado nunca alcanzará, ya que se realiza aproximadamente una llamada por evento de palé.
¿Cómo podemos confiar en la correspondencia entre el número de serie y la ubicación?
QuickFreeze proporciona la correspondencia entre el número de serie QFM y la ubicación en el estante en forma de hoja de cálculo, y los metadatos de ubicación de cada unidad se configuran en el campo mediante el formulario con código QR que se encuentra en la unidad. Verifícalo antes de la puesta en marcha controlando las unidades individualmente por código de ubicación y confirmando físicamente que responda la unidad correcta; una asignación errónea es el único modo de falla que congela silenciosamente el palé equivocado en el reloj equivocado.
Programa una llamada para definir el alcance de la integración
Una llamada define el flujo de trabajo; a partir de ahí, tu equipo y el nuestro trabajan en paralelo.