Guía de integración de monday.com para programar la producción con SkyPlanner APS

monday.com ofrece una GraphQL API en POST https://api.monday.com/v2. Se publica una versión cada trimestre y puedes fijar la versión mediante la cabecera API-Version. Se anuncia con al menos seis meses de antelación qué funciones quedarán obsoletas. (Versionado de la API)

Estos son los objetos que utiliza una integración para programar la producción:

• Boards y groups, que suelen organizarse por etapas o semanas.
• Items y subitems. Un elemento suele representar un pedido o una tarea, y los subelementos contienen las operaciones.
• Valores de columna: Status, Date, Timeline, Numbers, People, Dependency, Time Tracking, Connect Boards y Mirror.
• Webhooks para los eventos de cambio.

Para las lecturas se utiliza items_page dentro de un tablero o grupo. La página predeterminada contiene 25 elementos y «the maximum is 500.» (ese es el máximo de elementos por página). La lectura continúa con next_items_page, y «each cursor will expire 60 minutes after the first request.» (cada cursor caduca una vez transcurrido ese plazo desde la primera solicitud). Filtra con query_params para leer solo los pedidos abiertos. (items_page)

Para las escrituras se utilizan create_item, create_subitem, change_column_value y change_multiple_column_values. Esta última función actualiza varias columnas de un elemento en una sola llamada, justo lo que se necesita para devolver la programación a monday.com.

Para cargas de gran volumen, la versión 2026-07 de la API y las posteriores incorporan ingest_items y backfill_items. Se sube un CSV a una URL prefirmada y se consulta periódicamente el estado del proceso. (Importación masiva)

Crea una suscripción con create_webhook(board_id, url, event, config). Una integración para programar la producción necesita estos eventos:

• create_item y create_subitem para nuevos pedidos y operaciones.
• change_column_value o change_specific_column_value para cambios en la fecha de entrega, la cantidad o la prioridad.
• change_status_column_value para cambios de estado realizados por los usuarios.
• item_archived, item_deleted y item_moved_to_specific_group para pedidos cancelados o completados.

Al crear el webhook, la URL receptora debe responder a un token de verificación. Si una entrega falla, se aplica la regla «retry once a minute for 30 minutes,» (reintentar una vez por minuto durante ese plazo); después, cesan los intentos. Por eso, la integración también realiza una lectura periódica de conciliación con items_page y un filtro de elementos actualizados recientemente. (Webhooks)

En el sentido contrario, SkyPlanner envía webhooks cuando cambia el estado o la programación. El servicio de integración los recibe y escribe las nuevas fechas en monday.com, de modo que la escritura de retorno se activa por eventos.

1. Carga inicial de datos maestros. Lee los productos, los materiales y los pedidos abiertos con items_page. Crea las estaciones de trabajo, los turnos y las restricciones en SkyPlanner, o impórtalos desde Excel. Decide desde el principio si las operaciones se guardarán como subelementos o en un tablero vinculado.

2. Sincronización de pedidos. Los webhooks del tablero de producción envían a SkyPlanner los elementos nuevos y modificados como pedidos. Si haces el seguimiento de los pedidos de compra en un tablero, SkyPlanner considera que el material pedido está disponible en la fecha de entrega y actualiza las existencias cuando el pedido de compra se marca como Entregado.

3. Escritura de la programación en monday.com. Por cada pedido que el motor haya programado o desplazado, la integración llama a change_multiple_column_values. Escribe el inicio y el fin programados en la columna Timeline y rellena la columna de la estación de trabajo. Una llamada por elemento mantiene bajo el número de solicitudes.

4. Avance en planta. Los operarios registran el trabajo con Mobile Confirmations, Production Timer o Quick Log Mode. Los registros de tiempo mantienen la programación al día y la etiqueta Status correspondiente se devuelve al tablero, de modo que el equipo comercial puede ver el avance sin tener que preguntar.

5. Responsabilidad sobre los datos y resolución de conflictos. Deja estas reglas por escrito antes de la entrada en producción:

La principal fuente de conflictos son las modificaciones manuales de la columna Timeline. Acuerda que solo SkyPlanner escriba en esa columna, o trata cada modificación manual como una solicitud y deja que SkyPlanner reprograme. Autopilot reprograma automáticamente cuando cambia la producción.

• Cada cuenta organiza los pedidos de forma distinta. Un tablero por cliente, operaciones como elementos o subelementos, máquinas en columnas de People o Status. Establece la correspondencia mediante los ID de columna de cada cuenta, nunca por el título de la columna.
• Límites de los planes. Free, Basic y Standard permiten 1.000 llamadas a la API al día; Pro, 10.000, y Enterprise, 25.000. Utiliza webhooks para los cambios y agrupa las actualizaciones en monday.com con change_multiple_column_values. (límites de llamadas)
• La conexión entre tableros tiene límites. Basic permite una conexión entre tableros y Standard, cinco, lo que limita los tableros de operaciones o productos que se pueden vincular. (límites de Connect Boards)
• Fija la versión de la API. Las versiones cambian cada trimestre. Antes de la versión 2026-04, la consulta predeterminada de tableros excluía los tableros multinivel.
• Caducidad del cursor. Un cursor de items_page dura 60 minutos. Los procesos de conciliación largos deben poder reiniciarse sin errores.
• Límites de los webhooks. La URL puede tener como máximo 255 caracteres y los reintentos cesan a los 30 minutos. El receptor debe ser idempotente.
• Unidades y duraciones. Las columnas de Numbers no incluyen ninguna unidad. Acuerda si las duraciones se expresan en minutos o en horas antes de la primera importación.