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.)
Paso uno: recopilar datos sobre el tiempo de congelación por SKU
Una biblioteca de SKU es tan buena como las horas que se le dedican. Las normas y los manuales de códigos de productos marcan el inicio de un ciclo; el número que se ingrese en el sistema de gestión de almacenes (WMS) debe provenir de tiempo medido hasta alcanzar la temperatura en tu producto, en tu cuarto. Las cajas de control QFM incluyen un puerto auxiliar para sonda de producto precisamente para esto: una sonda con cable colocada en el palé transmite la temperatura del producto al tablero de control junto con la temperatura del aire de la unidad, de modo que cada ciclo de perfilado genera una curva de congelación completa y un recuento de horas bien fundamentado.
Realización de una prueba de perfilado con la sonda auxiliar QFM
| Paso | Qué hacer | Por qué es importante |
|---|---|---|
| 1. Verifica la sonda | Revisa cada sonda en un baño de hielo (hielo molido y agua, revolvidos): debe indicar 32 °F con una precisión de un grado antes de su primera prueba y después de cualquier golpe o de que se haya doblado el vástago. Etiqueta y retira las sondas que no cumplan con los requisitos. | Una sonda que marca dos grados de altura considera que el palé está listo dos grados antes en cada prueba que realiza. |
| 2. Elige el palé y la caja | Utiliza un palé de producción normal de la SKU, embalado tal como se va a procesar. Instala el el caso más lento: nivel intermedio, centro de la superficie de apoyo, más alejado de la trayectoria del aire. Anota el nivel y la posición en el registro de la prueba y etiqueta tanto la caja como la paleta como «paleta de prueba». | El tiempo de almacenamiento debe abarcar hasta que la última posición del palé alcance la temperatura deseada, no el promedio. Tanto las calculadoras como la regla del WMS parten de ese supuesto. |
| 3. Coloca la sonda | Inserta la sonda a través de la carcasa en el centro térmico del producto (el centro de la pieza o bolsa más pesada, nunca entre bolsas). Pase el cable de la sonda a través del envoltorio, conéctelo al cable de extensión fijado en esa posición y mantenga el cable alejado de la entrada del ventilador y de la trayectoria de la carretilla elevadora. | Los espacios de aire y la colocación entre bolsas dan lecturas de temperatura más bajas al principio y subestiman las horas. La sonda es la referencia objetiva en la que se basa toda la biblioteca. |
| 4. Inicia el ciclo | Coloca el palé, verifica que el sello esté intacto e inicia el ciclo como de costumbre. Revisa el tablero de control: la curva de la sonda debe subir desde la temperatura ambiente hasta la temperatura del producto a los pocos minutos de insertarla. Si la curva se queda estancada en 185 °F, significa que la sonda no está conectada. | Un sellado defectuoso o la falta de una lectura de la sonda invalida la ejecución. Detéctalo en los primeros diez minutos, no al final. |
| 5. Déjalo en paz | No muevas, vuelvas a envolver ni detengas el palé hasta que la sonda indique 0 °F (o la temperatura final requerida para el producto). Si por motivos de producción es necesario retirar el producto antes de tiempo, anota la temperatura del producto en el momento de la retirada y marca la prueba como incompleta. | Una prueba interrumpida no puede determinar el tiempo de congelación, y una sonda mal colocada lee el producto equivocado. |
| 6. Anota el resultado | Registra el SKU, la etiqueta del palé, la posición de la caja, el inicio del ciclo, el momento en que la sonda pasó por 0 °F, el temperatura del aire en la zona durante el proceso, la calidad del sellado y, en las unidades AutoSense, cuando la propia unidad indique que el palé está listo. Guarda la curva de congelación desde el tablero de control. | Las horas no significan nada sin la temperatura del aire a la que se midieron. Tanto el campo de temperatura ambiente de las calculadoras como el de la biblioteca se basan en ese dato. |
| 7. Recupera la sonda | Desconéctela por el conector (nunca tire del cable), lleve la paleta al muelle de carga, abra la caja del instrumento por el sello y retire la sonda tirando de ella en línea recta. Si se ha congelado dentro del producto, caliente el vástago con una mano enguantada en lugar de forzarla. Desinfecte, inspeccione y vuelva a verificar cualquier sonda que haya sido sometida a esfuerzo. | Si el vástago está doblado, el sensor se rompe, y si la bolsa interna está perforada, el producto se pone en espera de control de calidad. |
¿Cuántas pruebas equivalen a una hora de biblioteca?
El tiempo de congelación varía de un palé a otro en unas pocas horas para el mismo SKU, dependiendo principalmente del peso de la caja, la temperatura inicial y el aire de la zona. Toma en cuenta estas cifras al analizar los datos:
| Pruebas por SKU o familia | Lo que te dan |
|---|---|
| 1 prueba | Un primer número con el que iniciar el ciclo y una verificación de que cumple con la norma. No es una hora de biblioteca. |
| 3 a 5 pruebas | Un promedio de trabajo y una idea general de la variación; lo suficiente para agrupar las SKU en familias que se comportan de manera similar. |
| Alrededor de 20 pruebas | Un margen de error de aproximadamente ±2 horas y un nivel de confianza de aproximadamente 90% de que 9 de cada 10 paletas se completarán dentro de la hora que hayas establecido, siempre y cuando no se haya omitido ninguna de las pruebas. |
| 30 a 60 pruebas | El nivel para comprometer a una familia de gran volumen en un ciclo agresivo: confianza de 95% en un rango de 90 a 95% de paletas. |
Cuenta paletas completas, no sondas; tres sondas en una paleta equivalen a una prueba. Agrupa las SKU con el mismo peso de producto, empaque y caja en una familia y crea el perfil de esa familia. Realice el perfil en la sala donde se ejecutará la referencia, y vuelva a realizar la prueba cuando cambie un paquete o se reajuste la sala a una temperatura diferente. Un margen de una hora sobre el palé más lento medido es un seguro económico; un margen de diez horas en cada unidad es un temporizador estático con otro nombre.
AutoSense y la sonda forman un conjunto, no son alternativas. En las QFM equipadas con AutoSense, la unidad indica que cada palé está listo a partir de su propio sistema de detección, por lo que los operadores no necesitan una sonda para procesar el producto. La sonda es la forma en que tú demostrar las horas de la biblioteca para un SKU y comparar las lecturas de AutoSense con una lectura por cable; registrar ambas en cada ciclo perfilado. Una vez verificado un SKU, se registran las horas, quién las verificó y la fecha en la Biblioteca de SKU, y a partir de ese momento el WMS envía el número de artículo y la unidad ejecuta ese ciclo.
QuickFreeze puede suministrar sondas y cables de extensión, verificarlos contigo y asociar los ciclos de perfilado a su SKU en el SKU Profiling Hub, de modo que cada curva medida se archive junto con el artículo al que pertenece. Las horas medidas y el aire de la zona en la que se tomaron se ingresan directamente en el rendimiento y dimensionamiento calculadoras, en las que la casilla de selección «Integración con la API del WMS» muestra el valor de las horas por SKU en comparación con un temporizador estático.
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.
