Guide d’intégration de monday.com pour l’ordonnancement de la production avec SkyPlanner APS

monday.com expose une unique GraphQL API à l’adresse POST https://api.monday.com/v2. Une version paraît chaque trimestre ; l’en-tête API-Version permet de fixer celle à utiliser. Les dépréciations sont annoncées au moins six mois à l’avance. (Gestion des versions de l’API)

Voici les objets utilisés par une intégration d’ordonnancement :

• Boards et groups, souvent utilisés pour organiser les étapes ou les semaines.
• Items et subitems. Un élément représente généralement une commande ou une opération, et les sous-éléments contiennent les opérations.
• Valeurs des colonnes : Status, Date, Timeline, Numbers, People, Dependency, Time Tracking, Connect Boards et Mirror.
• Webhooks pour les événements de modification.

La lecture utilise items_page au sein d’un tableau ou d’un groupe. Par défaut, une page contient 25 éléments et « the maximum is 500. » (cette valeur constitue le maximum). La lecture se poursuit avec next_items_page, et « each cursor will expire 60 minutes after the first request. » (chaque curseur expire à l’issue de ce délai, calculé à partir de la première requête). Utilisez query_params pour ne lire que les commandes ouvertes. (items_page)

L’écriture utilise create_item, create_subitem, change_column_value et change_multiple_column_values. Cette dernière fonction met à jour plusieurs colonnes d’un même élément en un seul appel : c’est ce qu’il faut pour renvoyer les données du planning.

Pour les chargements volumineux, les versions de l’API à partir de 2026-07 proposent ingest_items et backfill_items. Vous téléversez un fichier CSV vers une URL présignée, puis interrogez périodiquement l’état du traitement. (Import en masse)

Créez un abonnement avec create_webhook(board_id, url, event, config). Voici les événements nécessaires à une intégration d’ordonnancement :

• create_item et create_subitem pour les nouvelles commandes et opérations.
• change_column_value ou change_specific_column_value pour les changements de date d’échéance, de quantité ou de priorité.
• change_status_column_value pour les changements de statut effectués par les utilisateurs.
• item_archived, item_deleted et item_moved_to_specific_group pour les commandes annulées ou terminées.

À la création du webhook, l’URL de réception doit répondre à un jeton de vérification. En cas d’échec de livraison, les envois sont retentés selon la règle « retry once a minute for 30 minutes, » (une nouvelle tentative par minute pendant cette durée), puis cessent. L’intégration effectue donc aussi des lectures périodiques avec items_page pour rapprocher les données, en filtrant les éléments récemment mis à jour. (Webhooks)

Dans l’autre sens, SkyPlanner envoie des webhooks lorsque l’état ou le planning change. Le service d’intégration les reçoit et inscrit les nouvelles dates dans monday.com : le retour des données est donc déclenché par les événements.

1. Chargement initial des données de base. Lisez les produits, les matières et les commandes ouvertes avec items_page. Créez les postes de travail, les horaires d’équipe et les contraintes dans SkyPlanner, ou importez-les depuis Excel. Décidez dès le départ si les opérations seront représentées par des sous-éléments ou gérées dans un tableau lié.

2. Synchronisation des commandes. Les webhooks du tableau de production envoient les éléments nouveaux et modifiés à SkyPlanner sous forme de commandes. Si vous suivez les commandes fournisseurs dans un tableau, SkyPlanner considère les matières commandées comme disponibles à la date de livraison et met à jour le stock lorsque la commande fournisseur passe au statut Delivered.

3. Retour des données du planning. Pour chaque commande placée ou déplacée par le moteur, l’intégration appelle change_multiple_column_values. Elle inscrit les dates de début et de fin prévues dans la colonne Timeline et renseigne la colonne du poste de travail. Un seul appel par élément permet de limiter le nombre de requêtes.

4. Avancement en atelier. Les opérateurs enregistrent leur travail avec Mobile Confirmations, Production Timer ou Quick Log Mode. Les relevés de temps maintiennent le planning à jour, et le libellé Status correspondant est renvoyé au tableau. L’équipe commerciale peut ainsi suivre l’avancement sans avoir à le demander.

5. Responsabilité des données et gestion des conflits. Consignez ces règles avant la mise en production :

Les modifications manuelles de la colonne Timeline sont la principale source de conflits. Convenez que seul SkyPlanner peut écrire dans cette colonne, ou traitez toute modification manuelle comme une demande et laissez SkyPlanner recalculer le planning. Autopilot recalcule automatiquement le planning lorsque la production change.

• Chaque compte représente les commandes différemment. Un tableau par client, des opérations sous forme d’éléments ou de sous-éléments, des machines dans des colonnes People ou Status. Établissez les correspondances à partir des identifiants de colonnes propres à chaque compte, jamais à partir des titres de colonnes.
• Limites des forfaits. Free, Basic et Standard autorisent 1 000 appels API par jour, Pro 10 000 et Enterprise 25 000. Utilisez les webhooks pour les modifications et regroupez les réécritures avec change_multiple_column_values. (limites de débit)
• Le nombre de tableaux connectés est limité. Basic autorise une connexion à un tableau et Standard cinq, ce qui limite les tableaux d’opérations ou de produits pouvant être liés. (limites de Connect Boards)
• Fixez la version de l’API. Les versions évoluent chaque trimestre. Avant la version 2026-04, les tableaux à plusieurs niveaux étaient exclus de la requête par défaut sur les tableaux.
• Expiration des curseurs. Un curseur items_page reste valide pendant 60 minutes. Les traitements de rapprochement longs doivent pouvoir redémarrer proprement.
• Limites des webhooks. L’URL ne doit pas dépasser 255 caractères et les nouvelles tentatives cessent après 30 minutes. Le service récepteur doit être idempotent.
• Unités et durées. Les colonnes Numbers ne précisent aucune unité. Convenez avant le premier import si les durées sont exprimées en minutes ou en heures.