{"id":425,"date":"2026-06-17T17:50:43","date_gmt":"2026-06-17T17:50:43","guid":{"rendered":"https:\/\/2026.quickfreeze.com\/?page_id=425"},"modified":"2026-06-17T17:50:43","modified_gmt":"2026-06-17T17:50:43","slug":"qfm-api","status":"publish","type":"page","link":"https:\/\/quickfreeze.com\/es\/qfm-api\/","title":{"rendered":"Gu\u00eda de la API de QFM"},"content":{"rendered":"<style>\n.qfm-api-guide{--qf-ink:#1f2d3d;--qf-blue:#0b3d59;--qf-accent:#1f7ac0;--qf-muted:#62788a;\n  font-family:-apple-system,BlinkMacSystemFont,\"Segoe UI\",Roboto,Helvetica,Arial,sans-serif;\n  color:var(--qf-ink);max-width:920px;margin:0 auto;padding:8px 4px 48px;line-height:1.55;font-size:16px;}\n.qfm-api-guide *{box-sizing:border-box;}\n.qfm-api-guide h1{font-size:30px;color:var(--qf-blue);margin:0 0 6px;line-height:1.2;}\n.qfm-api-guide .qf-lede{font-size:17px;color:var(--qf-muted);margin:0 0 26px;}\n.qfm-api-guide h2{font-size:22px;color:var(--qf-blue);margin:34px 0 10px;padding-bottom:6px;border-bottom:2px solid #e3e9ef;}\n.qfm-api-guide h3{font-size:17px;color:var(--qf-blue);margin:22px 0 8px;}\n.qfm-api-guide p{margin:0 0 12px;}\n.qfm-api-guide a{color:var(--qf-accent);}\n.qfm-api-guide code{font-family:\"SFMono-Regular\",Consolas,\"Liberation Mono\",monospace;font-size:.9em;\n  background:#eef4f9;color:#0b3d59;padding:1px 6px;border-radius:4px;}\n.qfm-api-guide pre{background:#0b2233;color:#d7f0ff;padding:14px 16px;border-radius:8px;overflow-x:auto;\n  font-size:13.5px;line-height:1.5;margin:10px 0 16px;white-space:pre;}\n.qfm-api-guide pre code{background:none;color:inherit;padding:0;}\n.qfm-api-guide table{border-collapse:collapse;width:100%;margin:10px 0 16px;font-size:14.5px;}\n.qfm-api-guide th,.qfm-api-guide td{text-align:left;padding:8px 10px;border-bottom:1px solid #e8eef3;vertical-align:top;}\n.qfm-api-guide th{color:var(--qf-muted);font-weight:600;background:#fafcfe;}\n.qfm-api-guide .qf-conn{display:grid;grid-template-columns:130px 1fr;gap:2px 14px;background:#fbfdff;\n  border:1px solid #e3e9ef;border-radius:10px;padding:16px 18px;margin:8px 0 8px;}\n.qfm-api-guide .qf-conn dt{color:var(--qf-muted);font-size:13px;text-transform:uppercase;letter-spacing:.03em;padding-top:7px;}\n.qfm-api-guide .qf-conn dd{margin:0;padding:4px 0;font-size:15px;}\n.qfm-api-guide .qf-pill{display:inline-block;background:#e3f6ea;color:#1d7a44;border-radius:999px;padding:2px 10px;font-size:13px;font-weight:600;}\n.qfm-api-guide .qf-pill.warn{background:#fff3e0;color:#b3640a;}\n.qfm-api-guide .qf-note{background:#fff8ec;border:1px solid #f3e2c0;border-radius:8px;\n  padding:12px 14px;font-size:14.5px;color:#6b5a36;margin:14px 0;}\n.qfm-api-guide .qf-card{border:1px solid #e3e9ef;border-radius:10px;padding:18px 20px;margin:18px 0;background:#fbfdff;}\n.qfm-api-guide .qf-req{color:#a12626;font-weight:600;}\n.qfm-api-guide ul{margin:0 0 14px;padding-left:22px;}\n.qfm-api-guide li{margin:4px 0;}\n@media(max-width:560px){.qfm-api-guide .qf-conn{grid-template-columns:1fr;}.qfm-api-guide .qf-conn dt{padding-top:10px;}}\n<\/style>\n<div class=\"qfm-api-guide\">\n\n<h1>API de QuickFreeze QFM<\/h1>\n<p class=\"qf-lede\">Consulta el estado en tiempo real y controla tus unidades QFM desde tu sistema de gesti\u00f3n de almac\u00e9n (WMS) o tu sistema de automatizaci\u00f3n de edificios:\nconfigura los tiempos de ciclo, registra el contenido del pal\u00e9, pon en pausa y reanuda el funcionamiento de los ventiladores.<\/p>\n\n<p>Tu software se refiere a cada unidad por su <strong>N\u00famero de serie de QFM<\/strong> (impreso en la unidad)\nm\u00e1s el <strong>ubicaci\u00f3n del estante<\/strong> que tengas registrado para ello. Todo pasa por un \u00fanico punto de conexi\u00f3n seguro,\nlimitado a las unidades de tu propia instalaci\u00f3n. El n\u00famero de serie es permanente: cuando se\nreemplaza una caja de control, la API asocia el n\u00famero de serie a la caja que est\u00e9 instalada en ese momento, por lo que un cambio no requiere\nninguna modificaci\u00f3n de tu parte.<\/p>\n\n<h2>Conexi\u00f3n<\/h2>\n<dl class=\"qf-conn\">\n  <dt>Punto final<\/dt><dd><code>https:\/\/qfreeze.com\/wp-json\/qf\/v1\/qfm<\/code><br><span style=\"color:#62788a;font-size:13px;\">la misma direcci\u00f3n para todos los clientes \u2014 tu clave la limita a tus unidades<\/span><\/dd>\n  <dt>Encabezado de autenticaci\u00f3n<\/dt><dd><code>X-QF-API-Key: {tu-clave-de-API}<\/code> \u2014 emitido por cada instalaci\u00f3n; se requiere TLS 1.2 o superior<\/dd>\n  <dt>M\u00e9todos<\/dt><dd>HTTP <strong>OBTENER<\/strong> (par\u00e1metros de consulta) o <strong>PUBLICAR<\/strong> (Cuerpo JSON)<\/dd>\n  <dt>Respuestas<\/dt><dd>Devuelve el n\u00famero de lecturas <span class=\"qf-pill\">200<\/span> con el estado actual de la unidad; los comandos devuelven <span class=\"qf-pill\">202<\/span> aceptado. Cada error es un JSON con una versi\u00f3n estable <code>error<\/code> c\u00f3digo: si falta una clave o est\u00e1 incorrecta, se devuelve <strong>401<\/strong>.<\/dd>\n  <dt>Agente de usuario<\/dt><dd>Por favor, env\u00ede un agente identificador, por ejemplo:. <code>TuEmpresa-WMS\/1.0<\/code>. Nuestro sistema bloquea algunas firmas conocidas de clientes automatizados; si alguna vez recibes un c\u00f3digo de error HTML 403 en lugar de JSON, av\u00edsanos y autorizaremos tu cliente.<\/dd>\n<\/dl>\n\n<h2>1. Identificaci\u00f3n de una unidad<\/h2>\n<p>Cada solicitud conlleva <strong>dos<\/strong> identificadores, y ambos deben coincidir con nuestros registros:<\/p>\n<table>\n<tr><th>Par\u00e1metro<\/th><th>Ejemplo<\/th><th>Notas<\/th><\/tr>\n<tr><td><code>QFM_SERIAL<\/code><\/td><td><code>QFM-12107<\/code><\/td><td>Est\u00e1 impreso en la unidad. Permanente: no se borra al cambiar la caja de control.<\/td><\/tr>\n<tr><td><code>UBICACI\u00d3N_DEL_RACK<\/code><\/td><td><code>2X-001B<\/code><\/td><td>La posici\u00f3n en el rack que hemos registrado para ese QFM.<\/td><\/tr>\n<tr><td><code>WAREHOUSE_ID<\/code><\/td><td><code>DC-EAST<\/code><\/td><td>Opcional. Tu propio c\u00f3digo de sitio o de almac\u00e9n, que se devuelve sin cambios: se trata de una etiqueta para sistemas con m\u00faltiples sitios, no de un permiso.<\/td><\/tr>\n<\/table>\n<p>Si el n\u00famero de serie existe pero el rack no coincide, la solicitud es <strong>rechazado<\/strong> y la respuesta\nte indica qu\u00e9 rack tenemos registrado (<code>409 discrepancia de rack<\/code>). Una asignaci\u00f3n desactualizada o mal ingresada en el\nWMS nunca nos har\u00e1 actuar sobre la unidad equivocada. Un n\u00famero de serie que pertenece a otro cliente devuelve\n<code>403<\/code>, incluso con un soporte adecuado.<\/p>\n\n<h2>2. Interrogar una unidad (leer el \u00faltimo valor)<\/h2>\n<p><code>COMANDO=poll<\/code> Es el valor predeterminado y se puede omitir. La consulta es de solo lectura y no puede afectar al equipo.<\/p>\n<pre><code>curl -H \"X-QF-API-Key: {tu-clave-de-API}\" -H \"User-Agent: YourCompany-WMS\/1.0\" \\\n  \"https:\/\/qfreeze.com\/wp-json\/qf\/v1\/qfm?QFM_SERIAL=QFM-12107&amp;RACK_LOCATION=2X-001B&amp;COMMAND=poll\"\n\n\u2192 200 {\"ok\":true,\"QFM_SERIAL\":\"QFM-12107\",\"RACK_LOCATION\":\"2X-001B\",\n       \"controlBox\":\"F8B3B74E6E7C\",\"ts\":1786143610000,\"state\":\"READY\",\n \"airtF\":3.4,\"airtC\":-15,89,\"deltap\":0,01,\n \"remaining\":172 800,\"active\":true,\"SKU\":\"I1-123456\"}<\/code><\/pre>\n<table>\n<tr><th>Campo<\/th><th>Significado<\/th><\/tr>\n<tr><td><code>ok<\/code><\/td><td><code>verdadero<\/code> en el \u00e9xito. Siempre presente.<\/td><\/tr>\n<tr><td><code>UBICACI\u00d3N_DEL_RACK<\/code><\/td><td>El estante <em>nosotros<\/em> que tenemos en nuestros archivos para esa unidad.<\/td><\/tr>\n<tr><td><code>controlBox<\/code><\/td><td>La caja de control ya est\u00e1 instalada. Aunque no la veas, menci\u00f3nala cuando reportes un problema.<\/td><\/tr>\n<tr><td><code>ts<\/code><\/td><td>Hora de la lectura, milisegundos de \u00e9poca UTC. Verif\u00edcalo siempre: una unidad fuera de l\u00ednea devuelve sus \u00faltimos valores conocidos con una marca de tiempo anterior.<\/td><\/tr>\n<tr><td><code>estado<\/code><\/td><td>Estado actual de la unidad, p. ej.:. <code>LISTO<\/code>, <code>CORRER<\/code>, <code>COMPLETO<\/code>, <code>PAUSA<\/code>, <code>SELLADO DEFECTUOSO<\/code>.<\/td><\/tr>\n<tr><td><code>airtF<\/code> \/ <code>airtC<\/code><\/td><td>Temperatura del aire en ambas escalas. Las unidades se miden en grados Celsius \u2014 leer <code>airtF<\/code> Si trabajas en grados Fahrenheit, no des por sentado que un valor sin etiquetar est\u00e1 en \u00b0F.<\/td><\/tr>\n<tr><td><code>deltap<\/code><\/td><td>Presi\u00f3n diferencial a trav\u00e9s de la unidad (calidad del sellado).<\/td><\/tr>\n<tr><td><code>restante<\/code><\/td><td>Segundos que quedan en el ciclo actual; <code>0<\/code> cuando no est\u00e1 en funcionamiento.<\/td><\/tr>\n<tr><td><code>activo<\/code><\/td><td>Si la unidad est\u00e1 funcionando en este momento.<\/td><\/tr>\n<tr><td><code>SKU<\/code><\/td><td>C\u00f3digo de art\u00edculo impreso en el ciclo en curso (siempre una cadena). Vac\u00edo cuando no hay ning\u00fan ciclo en ejecuci\u00f3n; la unidad lo borra al finalizar el ciclo.<\/td><\/tr>\n<\/table>\n\n<h2>3. Comandos<\/h2>\n<p>Hay tres comandos disponibles: <code>set_cycle<\/code>, <code>pausa<\/code> y <code>curr\u00edculum<\/code>.\nLos comandos son <strong>as\u00edncrono<\/strong>: validamos y autorizamos la solicitud, devolvemos\n<span class=\"qf-pill\">202<\/span>, y luego lo aplicamos a la unidad un momento despu\u00e9s. Todo aquello sobre lo que no podamos actuar es\nrechazado de inmediato con un <code>4xx<\/code> y un <code>error<\/code> c\u00f3digo: nunca devolvemos un c\u00f3digo 202 para un\ncomando que, en silencio, no har\u00eda nada. Para confirmar que el cambio lleg\u00f3 a la unidad, compru\u00e9balo posteriormente.<\/p>\n\n<h3>Configurar la duraci\u00f3n del ciclo y los detalles del ciclo \u2014 <code>set_cycle<\/code><\/h3>\n<table>\n<tr><th>Par\u00e1metro<\/th><th>Notas<\/th><\/tr>\n<tr><td><code>INCUBACI\u00d3N<\/code><\/td><td>Tiempo de ejecuci\u00f3n en <strong>horas<\/strong>, entero o fraccionario (<code>48<\/code>, <code>12.5<\/code>). Persiste hasta que se modifique; si la unidad est\u00e1 fuera de l\u00ednea, entra en vigor en su pr\u00f3ximo registro.<\/td><\/tr>\n<tr><td><code>N\u00daMERO DE ART\u00cdCULO<\/code> (o <code>SKU<\/code>)<\/td><td>Tu c\u00f3digo de art\u00edculo. Est\u00e1 estampado en la unidad correspondiente a este ciclo y te permite consultar el tiempo de funcionamiento en tu biblioteca de SKU (a continuaci\u00f3n).<\/td><\/tr>\n<tr><td><code>PALLET_TAG<\/code>, <code>PO<\/code><\/td><td>Pal\u00e9 \/ LP \/ LPN y orden de compra, registrados en el ciclo para la generaci\u00f3n de informes.<\/td><\/tr>\n<\/table>\n<p>Env\u00eda cualquier combinaci\u00f3n \u2014al menos una\u2014. Solo <code>PO<\/code>? Est\u00e1 bien. \u00bfLos detalles del pal\u00e9 en un ciclo que\nya est\u00e1 en ejecuci\u00f3n, sin alterar su tiempo de ejecuci\u00f3n? Est\u00e1 bien. Si env\u00edas cualquiera de estos campos sin un\n<code>COMANDO<\/code>, lo consideramos como <code>set_cycle<\/code>.<\/p>\n<pre><code>curl -H \"X-QF-API-Key: {tu-clave-API}\" -H \"User-Agent: YourCompany-WMS\/1.0\" \\\n  \"https:\/\/qfreeze.com\/wp-json\/qf\/v1\/qfm?QFM_SERIAL=QFM-12107&amp;RACK_LOCATION=2X-001B\\\n&amp;COMMAND=set_cycle&amp;INCUBATION=48&amp;ITEM_NUMBER=I1-123456&amp;PALLET_TAG=LP-4471&amp;PO=PO12345\"\n\n\u2192 202 {\"ok\":true,\"accepted\":true,\"QFM_SERIAL\":\"QFM-12107\",\"RACK_LOCATION\":\"2X-001B\",\n       \"controlBox\":\"F8B3B74E6E7C\",\"COMMAND\":\"set_cycle\",\n \"applied\":{\"cycleTimeHours\":48,\"SKU\":\"I1-123456\",\"PALLET_TAG\":\"LP-4471\",\"PO\":\"PO12345\"},\n \"cycleTimeChanged\":true}<\/code><\/pre>\n<p><code>aplicado<\/code> enumera exactamente las medidas que tomamos y <code>cycleTimeChanged<\/code> indica si el\ntiempo de ejecuci\u00f3n ha cambiado; nunca tienes que darlo por sentado. Un <code>INCUBACI\u00d3N<\/code> No podemos descartar toda la\nllamada; no nos limitaremos a aplicar silenciosamente solo los metadatos.<\/p>\n\n<h3>Tiempo de ciclo a partir de la SKU<\/h3>\n<p>Que el c\u00f3digo del art\u00edculo determine el tiempo de ejecuci\u00f3n, en lugar de enviar <code>INCUBACI\u00d3N<\/code> cada llamada:\n<code>&amp;COMMAND=set_cycle&amp;ITEM_NUMBER=I1-123456<\/code>. La biblioteca se arma a partir de tus llamadas: la\nprimera llamada que incluye un c\u00f3digo de art\u00edculo <em>con<\/em> un expl\u00edcito <code>INCUBACI\u00d3N<\/code> nos ense\u00f1a que\nel tiempo de ejecuci\u00f3n del elemento, y las llamadas posteriores pueden enviar solo el c\u00f3digo. Se registra un nuevo elemento sin horas, pero\nel tiempo de ejecuci\u00f3n permanece sin cambios; la respuesta lo indica con <code>cycleTimeChanged:false<\/code> y un\n<code>advertencia<\/code>. Un expl\u00edcito <code>INCUBACI\u00d3N<\/code> siempre gana.<\/p>\n<p>La respuesta informa lo que la biblioteca averigu\u00f3. Tres solicitudes del mismo art\u00edculo, en orden:<\/p>\n<pre><code># 1. Primera vez que vemos el I1-123456, con horas: la biblioteca registra 36 h para este art\u00edculo\n&amp;COMMAND=set_cycle&amp;INCUBATION=36&amp;ITEM_NUMBER=I1-123456&amp;PALLET_TAG=LP-4471\n\n\u2192 202 {\"ok\":true,\"accepted\":true,\"QFM_SERIAL\":\"QFM-12107\",\"RACK_LOCATION\":\"2X-001B\",\n       \"controlBox\":\"F8B3B74E6E7C\",\"COMMAND\":\"set_cycle\",\n \"applied\":{\"cycleTimeHours\":36,\"SKU\":\"I1-123456\",\"PALLET_TAG\":\"LP-4471\"},\n \"cycleTimeChanged\":true,\"skuRegistered\":true,\"skuHoursRecorded\":36}\n\n# 2. Mismo art\u00edculo, horas diferentes: se reemplaza el tiempo de funcionamiento almacenado y la respuesta indica de d\u00f3nde\n&amp;COMMAND=set_cycle&amp;INCUBATION=48&amp;ITEM_NUMBER=I1-123456&amp;PALLET_TAG=LP-4472\n\n\u2192 202 {\"ok\":true,\"accepted\":true,\"QFM_SERIAL\":\"QFM-12107\",\"RACK_LOCATION\":\"2X-001B\",\n       \"controlBox\":\"F8B3B74E6E7C\",\"COMMAND\":\"set_cycle\",\n \"applied\":{\"cycleTimeHours\":48,\"SKU\":\"I1-123456\",\"PALLET_TAG\":\"LP-4472\"},\n \"cycleTimeChanged\":true,\"skuHoursRecorded\":48,\"skuHoursChanged\":{\"from\":36,\"to\":48}}\n\n# 3. Solo el c\u00f3digo de art\u00edculo: se aplica el valor de 48 h registrado\n&amp;COMMAND=set_cycle&amp;ITEM_NUMBER=I1-123456&amp;PALLET_TAG=LP-4473\n\n\u2192 202 {\"ok\":true,\"accepted\":true,\"QFM_SERIAL\":\"QFM-12107\",\"RACK_LOCATION\":\"2X-001B\",\n       \"controlBox\":\"F8B3B74E6E7C\",\"COMMAND\":\"set_cycle\",\n \"applied\":{\"cycleTimeHours\":48,\"SKU\":\"I1-123456\",\"PALLET_TAG\":\"LP-4473\"},\n \"cycleTimeChanged\":true}<\/code><\/pre>\n<p><code>skuHoursChanged<\/code> es un objeto con dos miembros de tipo \u00abhora decimal\u00bb: <code>de<\/code>, el tiempo de ejecuci\u00f3n\nque figuraba en el expediente, y <code>a<\/code>, el tiempo de ejecuci\u00f3n que lo sustituy\u00f3 (siempre igual a\n<code>tiempo de ciclo aplicado en horas<\/code>). Solo aparece en una llamada que se envi\u00f3 <code>INCUBACI\u00d3N<\/code> junto con un\nc\u00f3digo de art\u00edculo que ya ten\u00eda un <em>diferente<\/em> tiempo de ejecuci\u00f3n seg\u00fan el archivo. Volver a enviar las mismas horas no cambia nada,\nas\u00ed que tampoco <code>skuHorasRegistradas<\/code> ni <code>skuHoursChanged<\/code> aparece. Las horas completas se env\u00edan como\nn\u00fameros enteros sin formato (<code>36<\/code>, no <code>36.0<\/code>); las horas fraccionarias conservan sus decimales (<code>12.5<\/code>).\nDimensiona ambos elementos como <code>DECIMAL(5,2)<\/code>.<\/p>\n\n<h3>Detener \/ reanudar los ventiladores<\/h3>\n<p><code>pausa<\/code> apaga los ventiladores y <strong>congela el temporizador del ciclo en su posici\u00f3n actual<\/strong>; <code>curr\u00edculum<\/code>\ncontin\u00faa exactamente de donde se hab\u00eda quedado. <code>DURACI\u00d3N<\/code> (minutos, opcional) es un mecanismo de\nreanudaci\u00f3n autom\u00e1tica por inactividad: si tu sistema nunca env\u00eda <code>curr\u00edculum<\/code>, la unidad se reinicia autom\u00e1ticamente. Recomendamos enviarla\ncada vez que haya una pausa.<\/p>\n<pre><code>curl -H \"X-QF-API-Key: {tu-clave-de-API}\" \\\n  \"https:\/\/qfreeze.com\/wp-json\/qf\/v1\/qfm?QFM_SERIAL=QFM-12107&amp;RACK_LOCATION=2X-001B&amp;COMMAND=pause&amp;DURATION=30\"\n\ncurl -H \"X-QF-API-Key: {tu-clave-de-API}\" \\\n  \"https:\/\/qfreeze.com\/wp-json\/qf\/v1\/qfm?QFM_SERIAL=QFM-12107&amp;RACK_LOCATION=2X-001B&amp;COMMAND=resume\"<\/code><\/pre>\n<div class=\"qf-note\">La pausa solo se mantiene en una unidad que realmente est\u00e9 ejecutando un ciclo. Un QFM inactivo vuelve\npor s\u00ed mismo a <code>LISTO<\/code> un momento despu\u00e9s de haberlo puesto en pausa \u2014 eso significa que la unidad est\u00e1 funcionando correctamente, no que se trate de un\ncomando fallido. Verifica <code>estado<\/code> y <code>activo<\/code> En primer lugar, si es relevante para tu flujo de trabajo.<\/div>\n\n<h3>Repetir un comando<\/h3>\n<p>Los tres comandos se pueden volver a enviar sin problema \u2014 <code>set_cycle<\/code> establece un valor en lugar de sumar\nuno, y <code>pausa<\/code>\/<code>curr\u00edculum<\/code> Establecer un estado. El reenv\u00edo tras un tiempo de espera no se acumular\u00e1.<\/p>\n\n<h2>4. Respuestas de error<\/h2>\n<p>Alerta sobre el <code>error<\/code> c\u00f3digo, no el texto del mensaje: los mensajes pueden modificarse, pero los c\u00f3digos no cambiar\u00e1n.<\/p>\n<pre><code>{\"ok\":false,\"error\":\"rack_mismatch\",\n \"message\":\"RACK_LOCATION no coincide con el rack registrado para QFM-12107. No se procesar\u00e1 una unidad que podr\u00eda ser incorrecta.\",\n \"expectedRackLocation\":\"2X-001B\"}<\/code><\/pre>\n<table>\n<tr><th>HTTP<\/th><th><code>error<\/code><\/th><th>Significado<\/th><th>Qu\u00e9 hacer<\/th><\/tr>\n<tr><td>400<\/td><td><code>n\u00famero de serie faltante<\/code> \/ <code>ubicaci\u00f3n_del_rack_faltante<\/code><\/td><td>Falta un identificador obligatorio<\/td><td>Corrige la solicitud<\/td><\/tr>\n<tr><td>400<\/td><td><code>comando_incorrecto<\/code><\/td><td>No reconocido <code>COMANDO<\/code><\/td><td>Corrige la solicitud<\/td><\/tr>\n<tr><td>400<\/td><td><code>nada_que_configurar<\/code><\/td><td><code>set_cycle<\/code> sin nada que aplicar<\/td><td>Env\u00eda al menos un campo<\/td><\/tr>\n<tr><td>400<\/td><td><code>poll_is_read_only<\/code><\/td><td><code>COMANDO=poll<\/code> enviado con campos que escribir\u00edan<\/td><td>Omitir <code>COMANDO<\/code>, o usa <code>set_cycle<\/code><\/td><\/tr>\n<tr><td>400<\/td><td><code>tiempo_de_ciclo_defectuoso<\/code><\/td><td><code>INCUBACI\u00d3N<\/code> No es un n\u00famero comprendido entre 0,17 y 168 horas<\/td><td>Corrige el valor \u2014 no se aplic\u00f3 nada<\/td><\/tr>\n<tr><td>400<\/td><td><code>campo_demasiado_largo<\/code><\/td><td>Un campo de la solicitud excede su l\u00edmite (secci\u00f3n 5); <code>campo<\/code> y <code>maxLength<\/code> di cu\u00e1l<\/td><td>Acortar el valor<\/td><\/tr>\n<tr><td>401<\/td><td><code>no autorizado<\/code><\/td><td>Clave de API faltante o incorrecta<\/td><td>Revisa el encabezado; alerta<\/td><\/tr>\n<tr><td>403<\/td><td><code>no_autorizado<\/code><\/td><td>Esa unidad no figura en tu cuenta<\/td><td>Revisa el n\u00famero de serie; alerta<\/td><\/tr>\n<tr><td>404<\/td><td><code>n\u00famero de serie desconocido<\/code><\/td><td>No hay QFM con ese n\u00famero de serie<\/td><td>Error tipogr\u00e1fico o unidad fuera de servicio; alerta<\/td><\/tr>\n<tr><td>409<\/td><td><code>rack_mismatch<\/code><\/td><td>El n\u00famero de serie es el tuyo, pero el rack no coincide<\/td><td><strong>Alerta.<\/strong> Tu mapa est\u00e1 desactualizado \u2014 <code>ubicaci\u00f3n prevista del rack<\/code> te dice cu\u00e1l es la nuestra<\/td><\/tr>\n<tr><td>409<\/td><td><code>ambiguous_serial<\/code><\/td><td>El n\u00famero de serie coincide con m\u00e1s de una unidad<\/td><td>Cont\u00e1ctanos \u2014 un problema con los datos por nuestra parte<\/td><\/tr>\n<tr><td>502<\/td><td><code>error_de_origen<\/code><\/td><td>No pudimos llegar a la plataforma de monitoreo<\/td><td>Volver a intentarlo con retrasos; alertar si la situaci\u00f3n persiste<\/td><\/tr>\n<\/table>\n<p style=\"font-size:14px;color:#62788a;\">Reintentos: se pueden reintentar sin problema los comandos \u00abpoll\u00bb y todos los dem\u00e1s. Usa un retroceso exponencial para el c\u00f3digo 502; no reintentes los c\u00f3digos 4xx, ya que no se resolver\u00e1n sin modificar la solicitud.<\/p>\n\n<h2>5. Tama\u00f1os y tipos de campos<\/h2>\n<p>Define el tama\u00f1o de las columnas de tu base de datos seg\u00fan esta tabla. Estas son reglas fijas: el valor que devolvamos nunca\nsuperar\u00e1 su l\u00edmite, y cualquier valor solicitado que exceda dicho l\u00edmite ser\u00e1 rechazado con <code>400 campo_demasiado_largo<\/code>\nen lugar de truncadas. Cada respuesta est\u00e1 en formato JSON; las cadenas est\u00e1n en UTF-8, los n\u00fameros son n\u00fameros JSON sin formato\n(sin separadores de miles, con punto decimal), los valores booleanos son <code>verdadero<\/code>\/<code>falso<\/code>.<\/p>\n\n<h3>Campos de la solicitud<\/h3>\n<table>\n<tr><th>Campo<\/th><th>Tipo<\/th><th>L\u00edmite<\/th><\/tr>\n<tr><td><code>QFM_SERIAL<\/code><\/td><td>cadena<\/td><td>32 caracteres<\/td><\/tr>\n<tr><td><code>UBICACI\u00d3N_DEL_RACK<\/code><\/td><td>cadena<\/td><td>32 caracteres<\/td><\/tr>\n<tr><td><code>COMANDO<\/code><\/td><td>cadena<\/td><td>uno de <code>encuesta<\/code>, <code>set_cycle<\/code>, <code>pausa<\/code>, <code>curr\u00edculum<\/code> (m\u00e1ximo 9 caracteres)<\/td><\/tr>\n<tr><td><code>N\u00daMERO DE ART\u00cdCULO<\/code> \/ <code>SKU<\/code><\/td><td>cadena<\/td><td>64 caracteres<\/td><\/tr>\n<tr><td><code>PALLET_TAG<\/code>, <code>PO<\/code><\/td><td>cadena<\/td><td>64 caracteres cada uno<\/td><\/tr>\n<tr><td><code>WAREHOUSE_ID<\/code><\/td><td>cadena<\/td><td>64 caracteres<\/td><\/tr>\n<tr><td><code>INCUBACI\u00d3N<\/code><\/td><td>horas decimales<\/td><td>De 0,17 a 168 (de 10 minutos a 7 d\u00edas)<\/td><\/tr>\n<tr><td><code>DURACI\u00d3N<\/code><\/td><td>minutos enteros<\/td><td>\u2014<\/td><\/tr>\n<\/table>\n\n<h3>Respuestas a la encuesta (200)<\/h3>\n<table>\n<tr><th>Campo<\/th><th>Tipo<\/th><th>Tama\u00f1o \/ rango<\/th><th>Notas<\/th><\/tr>\n<tr><td><code>ok<\/code><\/td><td>booleano<\/td><td>\u2014<\/td><td>Siempre presente. <code>verdadero<\/code> por cada respuesta correcta.<\/td><\/tr>\n<tr><td><code>QFM_SERIAL<\/code><\/td><td>cadena<\/td><td>\u2264 32<\/td><td>Tu eco.<\/td><\/tr>\n<tr><td><code>UBICACI\u00d3N_DEL_RACK<\/code><\/td><td>cadena<\/td><td>\u2264 32<\/td><td>El estante que tenemos registrado.<\/td><\/tr>\n<tr><td><code>controlBox<\/code><\/td><td>cadena<\/td><td>\u2264 32<\/td><td>Hoy, un identificador hexadecimal de 12 caracteres.<\/td><\/tr>\n<tr><td><code>ts<\/code><\/td><td>entero<\/td><td>13 d\u00edgitos<\/td><td>Milenos de segundos desde el inicio de la era UTC: utilice un entero de 64 bits.<\/td><\/tr>\n<tr><td><code>WAREHOUSE_ID<\/code><\/td><td>cadena<\/td><td>\u2264 64<\/td><td>Solo cuando lo enviaste.<\/td><\/tr>\n<tr><td><code>estado<\/code><\/td><td>cadena<\/td><td>\u2264 14<\/td><td>Uno de <code>INICIO<\/code>, <code>LISTO<\/code>, <code>PRUEBA DE ESTANQUEIDAD<\/code>, <code>SELLADO DEFECTUOSO<\/code>, <code>CORRER<\/code>, <code>PAUSA<\/code>, <code>COMPLETO<\/code>, <code>FALLO DEL MOTOR<\/code>, <code>FALLO DEL SENSOR<\/code>, <code>EXPLOSI\u00d3N<\/code>.<\/td><\/tr>\n<tr><td><code>deltap<\/code><\/td><td>decimal<\/td><td>2 decimales, con signo<\/td><td>Pascals. Normalmente de 0 a unos 300; puede descender ligeramente a valores negativos. <code>DECIMAL(8,2)<\/code> abarca todo lo que el sensor puede reportar.<\/td><\/tr>\n<tr><td><code>restante<\/code><\/td><td>entero<\/td><td>De 0 a 604 800<\/td><td>Segundos completos, nunca fraccionarios (m\u00e1ximo 7 d\u00edas).<\/td><\/tr>\n<tr><td><code>airtC<\/code><\/td><td>decimal<\/td><td>2 decimales, de \u221255,00 a 125,00<\/td><td><code>DECIMAL(5,2)<\/code>.<\/td><\/tr>\n<tr><td><code>airtF<\/code><\/td><td>decimal<\/td><td>1 cifra decimal, de \u221267,0 a 257,0<\/td><td><code>DECIMAL(4,1)<\/code>.<\/td><\/tr>\n<tr><td><code>activo<\/code><\/td><td>booleano<\/td><td>\u2014<\/td><td><\/td><\/tr>\n<tr><td><code>SKU<\/code><\/td><td>cadena<\/td><td>\u2264 64<\/td><td>Lo que sea que hayas enviado como <code>N\u00daMERO DE ART\u00cdCULO<\/code>; vac\u00edo cuando no hay ning\u00fan ciclo en ejecuci\u00f3n.<\/td><\/tr>\n<\/table>\n<div class=\"qf-note\">Considera cada lectura como opcional. <code>airtC<\/code>\/<code>airtF<\/code>, <code>deltap<\/code>, <code>estado<\/code>\ny <code>SKU<\/code> son <strong>omitido<\/strong> cuando la unidad nunca haya reportado ese valor o el sensor\nque lo controla est\u00e9 fallando: analiza por clave, no por posici\u00f3n, y permite valores nulos en tu tabla.<\/div>\n\n<h3>Respuesta al comando (202)<\/h3>\n<table>\n<tr><th>Campo<\/th><th>Tipo<\/th><th>Tama\u00f1o \/ rango<\/th><th>Notas<\/th><\/tr>\n<tr><td><code>ok<\/code><\/td><td>booleano<\/td><td>\u2014<\/td><td>La solicitud se realiz\u00f3 con \u00e9xito. Verifica esto primero en cada respuesta.<\/td><\/tr>\n<tr><td><code>aceptado<\/code><\/td><td>booleano<\/td><td>\u2014<\/td><td>La orden fue autorizada y transmitida a la unidad. Solo se responder\u00e1 a las \u00f3rdenes que se den en el momento. Las \u00f3rdenes son asincr\u00f3nicas, por lo que <code>aceptado<\/code> significa <em>en la fila<\/em>, no <em>aplicado<\/em> \u2014 encuesta para confirmar. No ver\u00e1s <code>ok:true<\/code> con <code>aceptado:false<\/code>.<\/td><\/tr>\n<tr><td><code>QFM_SERIAL<\/code>, <code>UBICACI\u00d3N_DEL_RACK<\/code>, <code>controlBox<\/code>, <code>WAREHOUSE_ID<\/code><\/td><td>cadena<\/td><td>como se indic\u00f3 anteriormente<\/td><td><\/td><\/tr>\n<tr><td><code>COMANDO<\/code><\/td><td>cadena<\/td><td>\u2264 9<\/td><td>El comando que se ejecut\u00f3.<\/td><\/tr>\n<tr><td><code>tiempo de ciclo aplicado en horas<\/code><\/td><td>decimal<\/td><td>De 0,17 a 168<\/td><td>Solo cuando se configur\u00f3 el tiempo de ejecuci\u00f3n.<\/td><\/tr>\n<tr><td><code>applied.SKU<\/code>, <code>applied.PALLET_TAG<\/code>, <code>applied.PO<\/code><\/td><td>cadena<\/td><td>\u2264 64 cada uno<\/td><td>Reflejo de lo que enviaste; cada uno est\u00e1 presente solo si se envi\u00f3.<\/td><\/tr>\n<tr><td><code>cycleTimeChanged<\/code>, <code>skuRegistrado<\/code><\/td><td>booleano<\/td><td>\u2014<\/td><td><code>skuRegistrado<\/code> solo cuando se registraba un nuevo art\u00edculo.<\/td><\/tr>\n<tr><td><code>skuHorasRegistradas<\/code><\/td><td>decimal<\/td><td>De 0,17 a 168<\/td><td>Solo cuando la biblioteca de elementos haya aprendido un tiempo de ejecuci\u00f3n.<\/td><\/tr>\n<tr><td><code>skuHoursChanged<\/code><\/td><td>objeto<\/td><td><code>de<\/code>, <code>a<\/code> horas decimales<\/td><td>Solo cuando se sustituy\u00f3 un tiempo de ejecuci\u00f3n almacenado.<\/td><\/tr>\n<tr><td><code>advertencia<\/code><\/td><td>cadena<\/td><td>\u2264 255<\/td><td>Solo cuando est\u00e1 presente. A t\u00edtulo informativo; el comando se acept\u00f3 de todos modos.<\/td><\/tr>\n<\/table>\n\n<h3>Respuesta de error (4xx \/ 5xx)<\/h3>\n<table>\n<tr><th>Campo<\/th><th>Tipo<\/th><th>Tama\u00f1o<\/th><th>Notas<\/th><\/tr>\n<tr><td><code>ok<\/code><\/td><td>booleano<\/td><td>\u2014<\/td><td>Siempre <code>falso<\/code>.<\/td><\/tr>\n<tr><td><code>error<\/code><\/td><td>cadena<\/td><td>\u2264 32<\/td><td>C\u00f3digo estable en min\u00fasculas (secci\u00f3n 4). Alerta sobre esto.<\/td><\/tr>\n<tr><td><code>mensaje<\/code><\/td><td>cadena<\/td><td>\u2264 255<\/td><td>Legible para los humanos; puede reformularse.<\/td><\/tr>\n<tr><td><code>ubicaci\u00f3n prevista del rack<\/code><\/td><td>cadena<\/td><td>\u2264 32<\/td><td>Con <code>rack_mismatch<\/code> solo.<\/td><\/tr>\n<tr><td><code>campo<\/code>, <code>maxLength<\/code><\/td><td>cadena, entero<\/td><td>\u2264 16, \u2014<\/td><td>Con <code>campo_demasiado_largo<\/code> solo.<\/td><\/tr>\n<tr><td><code>campos ignorados<\/code><\/td><td>matriz de cadenas<\/td><td>\u2264 5 nombres<\/td><td>Con <code>poll_is_read_only<\/code> solo.<\/td><\/tr>\n<tr><td><code>estado de la etapa anterior<\/code><\/td><td>entero<\/td><td>3 d\u00edgitos<\/td><td>Con algunos <code>error_de_origen<\/code> respuestas.<\/td><\/tr>\n<\/table>\n\n<h2>Identidad y seguridad<\/h2>\n<ul>\n<li>Cada instalaci\u00f3n se autentica con su propia clave de API y est\u00e1 autorizada a <strong>solo sus propias unidades<\/strong>.<\/li>\n<li><code>UBICACI\u00d3N_DEL_RACK<\/code> debe coincidir con la ubicaci\u00f3n asociada a ese <code>QFM_SERIAL<\/code> o se rechaza la solicitud; esto evita que se ajuste la unidad incorrecta.<\/li>\n<li>Las unidades se identifican mediante <strong>Serie QFM<\/strong>, que se mantiene estable incluso cuando se cambian las cajas de control; <code>controlBox<\/code> En cada respuesta se indica qu\u00e9 casilla se seleccion\u00f3.<\/li>\n<li>No incluyas tu clave de API en cadenas de correo electr\u00f3nico ni en archivos compartidos. QuickFreeze podr\u00eda limitar la frecuencia de los vol\u00famenes excesivos de solicitudes.<\/li>\n<\/ul>\n\n<div class=\"qf-card\">\n<h3 style=\"margin-top:0;\">Primeros pasos<\/h3>\n<p>QuickFreeze te proporciona tu clave de API y el <code>QFM_SERIAL \u2194 UBICACI\u00d3N_EN_RACK<\/code> mapa para tus unidades.\nUna buena primera opci\u00f3n es realizar una consulta con una unidad activa y, luego, indicar una ubicaci\u00f3n de rack deliberadamente incorrecta para ver\n<code>409 discrepancia de rack<\/code> Vuelve. Si quieres, m\u00e1ndanos tu lista de SKU con los tiempos de ciclo.\n<code>N\u00daMERO DE ART\u00cdCULO<\/code> solo para establecer los tiempos de ejecuci\u00f3n desde el primer d\u00eda.<\/p>\n<p style=\"margin-bottom:0;\">Para solicitar acceso, comun\u00edquese con su representante de QuickFreeze.<\/p>\n<\/div>\n\n<\/div>","protected":false},"excerpt":{"rendered":"","protected":false},"author":0,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_kadence_starter_templates_imported_post":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","footnotes":""},"class_list":["post-425","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/quickfreeze.com\/es\/wp-json\/wp\/v2\/pages\/425","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/quickfreeze.com\/es\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/quickfreeze.com\/es\/wp-json\/wp\/v2\/types\/page"}],"replies":[{"embeddable":true,"href":"https:\/\/quickfreeze.com\/es\/wp-json\/wp\/v2\/comments?post=425"}],"version-history":[{"count":1,"href":"https:\/\/quickfreeze.com\/es\/wp-json\/wp\/v2\/pages\/425\/revisions"}],"predecessor-version":[{"id":426,"href":"https:\/\/quickfreeze.com\/es\/wp-json\/wp\/v2\/pages\/425\/revisions\/426"}],"wp:attachment":[{"href":"https:\/\/quickfreeze.com\/es\/wp-json\/wp\/v2\/media?parent=425"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}