Aller au contenu

Fonctionnement des bons de travail API

Si votre organisation planifie ses travaux dans un autre logiciel (par exemple Agvance), une connexion API envoie ces bons de travail à Mixmate, pour que personne n'ait à les saisir de nouveau. Cet article présente l'ensemble du processus, du moment où la commande quitte votre logiciel jusqu'à ce que l'opérateur la mélange sur la tablette.

Avant de commencer :

  • La connexion est configurée dans Intersect par un administrateur, et nécessite le palier Premium.

  • L'importation se fait dans l'appli Web (app.mixmate.com). L'appli tablette n'importe pas les bons de travail API; elle les reçoit une fois qu'ils sont importés.


  1. Votre logiciel envoie la commande. Elle attend sur la connexion jusqu'à ce que quelqu'un l'importe.

  2. Vous synchronisez l'API dans l'appli Web. Mixmate récupère les commandes en attente et tente d'importer chacune d'elles.

  3. Les commandes complètes s'importent automatiquement. Leurs produits sont associés à ceux que vous avez déjà, et les nouveaux sont créés.

  4. Les commandes incomplètes sont mises en attente dans la boîte de réception API jusqu'à ce que quelqu'un remplisse ce qui manque.

  5. La tablette reçoit les commandes importées lors de sa prochaine synchronisation avec le nuage.


Les nouvelles commandes ne s'importent pas d'elles-mêmes : quelqu'un doit synchroniser l'API. Faites-le chaque fois que de nouvelles commandes ont été envoyées, par exemple en début de journée.

  1. Dans l'appli Web, ouvrez l'onglet Admin.

  2. Repérez la carte Bons de travail non importés. Elle affiche deux nombres :

    • Le premier nombre : les commandes mises en attente pour vérification au cours de cette session (voir l'étape 3).

    • Disponibles pour importation : les commandes en attente sur vos connexions, y compris les commandes mises en attente qui n'ont pas encore été résolues.

    Dans une fenêtre de navigateur étroite, les nombres sont masqués; élargissez la fenêtre pour les voir.

  3. Cliquez sur Synchroniser l'API sur la carte. La fenêtre Synchronisation de l'API s'ouvre et affiche sa progression :

    • Récupération des bons de travail API à importer : Mixmate récupère les commandes en attente. Le nombre augmente à mesure qu'elles arrivent.

    • Importation des bons de travail API : chaque commande est vérifiée et importée, avec une barre de progression.

    • Terminé : tout a été traité. Le bouton Fermer devient accessible.

La fenêtre Synchronisation de l'API pendant la récupération des bons de travail à importer
La fenêtre Synchronisation de l'API une fois l'importation terminée, avec le bouton Fermer accessible

Astuce : Gardez l'onglet ouvert jusqu'à ce que la fenêtre indique Terminé. Fermer le navigateur en cours de route laisse les commandes restantes en attente; synchronisez simplement de nouveau.


Pour chaque commande, Mixmate examine d'abord ses produits, puis le bon de travail.

Produits

  • Les produits que vous avez déjà sont utilisés. Un produit correspond s'il s'agit du même produit déjà envoyé par l'API, s'il a les mêmes identifiants externes, ou s'il porte le même nom. Si le produit correspondant est archivé, il est restauré.

  • Les nouveaux produits sont créés, pourvu que l'API ait envoyé tout ce dont Mixmate a besoin pour eux (par exemple la densité d'un produit sec).

  • Les produits existants conservent vos détails, sauf si Mettre à jour les produits API à l'importation est activé dans les Paramètres de groupe. Activez cette option si c'est dans votre autre logiciel que vous tenez votre liste de produits.

Le bon de travail

  • Une commande complète s'importe immédiatement, sans vérification.

  • Une commande dont vous avez déjà le numéro de bon de travail est ignorée. Elle n'est pas importée de nouveau, et les changements qui y sont apportés ne sont pas appliqués. Pour modifier une commande déjà importée, modifiez-la dans Mixmate.

Tout ce qui ne peut pas être importé en raison de renseignements manquants est mis en attente pour vérification.


Une commande est mise en attente lorsque Mixmate a besoin de quelque chose que l'API n'a pas envoyé. Raisons courantes :

  • Il manque des détails à un nouveau produit, comme sa densité, son taux de densité ou sa taille de contenant.

  • Il manque la taille du bon de travail, comme la superficie en acres à couvrir pour une commande basée sur un taux, ou ses taux d'application.

Cliquez sur la carte Bons de travail non importés pour ouvrir la boîte de réception API. Elle répertorie chaque commande mise en attente avec la connexion dont elle provient.

La boîte de réception API répertoriant deux bons de travail API non importés provenant d'Agvance

Cliquez sur une commande pour la corriger et l'approuver. Importer manuellement des bons de travail API explique la marche à suivre étape par étape.

Vous n'avez pas besoin d'une commande? Cliquez sur la corbeille à côté de celle-ci, puis sur Supprimer. Elle est retirée de la boîte de réception et de la connexion, et n'est pas importée.

La fenêtre Confirmer la suppression pour un bon de travail API qui n'a pas encore été approuvé

Commandes mises en attente et rechargement de la page : La boîte de réception API est remplie par Synchroniser l'API. Si vous rechargez l'appli Web ou vous reconnectez, la boîte de réception est vide au départ, mais les commandes mises en attente sont toujours comptées sous Disponibles pour importation. Cliquez de nouveau sur Synchroniser l'API et elles reviennent dans la boîte de réception.


Les commandes importées sont enregistrées immédiatement dans votre compte infonuagique. Chaque tablette les reçoit lors de sa prochaine synchronisation avec le nuage. À partir de là, ce sont des bons de travail ordinaires : choisissez-en un dans la Configuration du mélange et mélangez-le comme d'habitude.


  • Je ne vois pas la carte Bons de travail non importés. Elle se trouve uniquement dans l'appli Web, pas sur la tablette. Si vous êtes dans l'appli Web, votre organisation a besoin du palier Premium et d'une connexion API configurée dans Intersect.

  • Disponibles pour importation affiche des commandes, mais la boîte de réception est vide. Cliquez sur Synchroniser l'API. Les commandes qui s'importent vont directement dans vos bons de travail; les autres apparaissent dans la boîte de réception.

  • Une commande que j'ai envoyée n'est pas dans Mixmate. Synchronisez l'API. Si elle n'y est toujours pas, vérifiez si un bon de travail portant le même numéro existe déjà : si c'est le cas, la nouvelle commande a été ignorée.

  • La tablette n'a pas la commande. Assurez-vous qu'elle est importée (elle se trouve dans les bons de travail de l'appli Web, et non dans la boîte de réception API). Synchronisez ensuite la tablette avec le nuage.

  • Les détails d'un produit reviennent sans cesse à leur ancienne valeur. Mettre à jour les produits API à l'importation est activé, donc chaque importation met à jour le produit à partir de votre autre logiciel. Modifiez le produit dans ce logiciel, ou désactivez le paramètre.