Intégration Onfleet n8nAutomatiser Onfleet avec n8n.

Ajoute un administrateur à l'organisation Onfleet et renvoie l'objet créé. Les administrateurs gèrent l'organisation, contrairement aux livreurs qui exécutent les tâches.

• Admin ID : l'identifiant de l'objet admin utilisé pour la recherche.
• Name et Email : le nom de l'administrateur et son adresse mail, au format name@email.com proposé par le champ.
• Read Only (Additional Fields) : si l'administrateur peut ou non effectuer des opérations d'écriture.

Supprime un administrateur de l'organisation. L'appel vise un seul compte et ne renvoie rien de réutilisable ensuite, donc place-le en fin de branche.

• Admin ID : l'identifiant de l'objet admin, pas le nom de la personne. Passe plutôt {{ $json.id }} depuis l'opération qui a retrouvé le compte qu'une valeur saisie à la main.

Liste les administrateurs de l'organisation, pour les auditer ou pour choisir qui prévenir.

• Admin ID : toujours marqué requis sur cette opération, alors qu'elle renvoie une liste. Remplis-le avant l'exécution, sinon le nœud s'arrête sur le champ vide.
• Return All : activé, n8n enchaîne toutes les pages d'administrateurs ; désactivé, Limit fixe le nombre maximal d'items renvoyés.

Modifie un administrateur existant. Seuls les champs ajoutés sont touchés, le reste du compte ne bouge pas.

• Admin ID : l'identifiant de l'objet admin utilisé pour la recherche.
• Name (Update Fields) et Phone : le nom et le numéro de téléphone de l'administrateur.
• Read Only (Update Fields) : si l'administrateur peut ou non effectuer des opérations d'écriture.

Insère des tâches dans un conteneur, la liste ordonnée des tâches rattachées à une organisation, une équipe ou un livreur.

• Container Type et Container ID : organizations, teams ou workers, puis l'identifiant de l'objet correspondant au conteneur choisi.
• Insert Type et Index : -1 pour ajouter à la fin, 0 pour ajouter au début, 1 pour insérer à un index précis, l'index indiquant la position d'insertion.
• Task IDs : les identifiants des tâches à utiliser.
• Consider Dependencies (Options) : inclure ou non la famille de dépendances de la tâche visée, tâches parentes et enfants, dans l'affectation résultante.

Lit un conteneur et renvoie les tâches qu'il contient, dans leur ordre d'exécution. Rien n'est modifié.

• Container Type : organizations, teams ou workers, selon la liste que tu veux consulter.
• Container ID : l'identifiant de l'objet correspondant au conteneur choisi, souvent {{ $json.id }} repris de l'opération livreur ou équipe juste avant.

Remplace intégralement les tâches d'un conteneur. Ce que tu envoies devient la liste complète : ce qui n'y figure pas sort du conteneur.

• Container ID : l'identifiant de l'objet correspondant au conteneur choisi.
• Task IDs : les tâches à utiliser, dans l'ordre où elles doivent être faites.
• Consider Dependencies (Options) : inclure ou non la famille de dépendances de la tâche visée, tâches parentes et enfants, dans l'affectation résultante.

Enregistre une adresse comme objet destination, sur lequel les tâches pourront pointer. Créée une fois, l'adresse reste cohérente d'une livraison à l'autre.

• Unparsed Address : indique si l'adresse est fournie en une seule chaîne non découpée, ce qui change la lecture des autres champs.
• Destination Address, Number, Street, City, Country : le détail de la voie, le numéro qui peut aussi contenir des lettres, le nom de la rue, la commune et le pays.
• Apartment (Additional Fields) et Address Notes : le numéro d'appartement ou toute précision utile, et les notes sur la destination.

Récupère une destination et renvoie le détail de l'adresse enregistrée.

• Destination ID : l'identifiant de l'objet destination, repris en général de la tâche qui le référence avec une expression du type {{ $json.destination }}.

Déclare un hub, le site physique d'où part une tournée, et renvoie l'objet créé. Un hub porte sa propre adresse et peut être rattaché à des équipes.

• Name : le nom qui identifie le hub.
• Destination : l'adresse du hub, ajoutée via le bloc Add Destination, avec Street, City, State et Country.
• Team Names or IDs (Additional Fields) : les équipes auxquelles ce hub est assigné, choisies dans la liste ou fournies en identifiants via une expression.

Renvoie les hubs déclarés dans l'organisation. Aucun identifiant n'est demandé ici, c'est donc le moyen le plus court d'avoir la vue complète de tes sites.

• Return All : activé, tous les hubs remontent page après page ; désactivé, Limit fixe le nombre maximal de hubs renvoyés.

Modifie un hub déjà créé, champ par champ. Ce que tu ne renseignes pas garde sa valeur actuelle.

• Hub ID : l'identifiant de l'objet hub utilisé pour la recherche.
• Name (Update Fields) : le nom qui identifie le hub, utile quand les dépôts sont renommés après une réorganisation.
• Destination (Update Fields) et Team Names or IDs : l'adresse via Add Destination, et les équipes rattachées au hub.

Renvoie le détail de l'organisation associée à la clé d'API. Rien à configurer : le credential dit déjà quelle organisation est lue.

Lit le détail d'une autre organisation avec laquelle tu es connecté dans Onfleet. La délégation, c'est la façon dont deux entreprises se partagent des livraisons, l'une envoyant le travail, l'autre l'exécutant.

• Organization ID : l'identifiant du délégataire utilisé pour la recherche.

Enregistre un client comme destinataire, l'objet qu'Onfleet rattache aux tâches et à qui il envoie les SMS.

• Recipient Name : le nom complet du destinataire.
• Recipient Phone : un numéro unique et valide au format du pays de l'organisation s'il n'y a pas de + en tête ; avec un +, le réglage de pays de l'organisation est ignoré.
• Skip Recipient SMS Notifications (Additional Fields) : si le destinataire a demandé à ne pas recevoir de SMS.

Retrouve un destinataire. La particularité, ici, c'est que tu choisis le critère de recherche, ce qui compte quand la seule information disponible est un numéro de téléphone.

• Get By : la variable utilisée pour la recherche, id, phone ou name.
• Recipient ID, Name ou Phone : la valeur correspondant au critère choisi juste au-dessus.

Corrige les données enregistrées d'un destinataire, qui s'appliquent ensuite à ses prochaines tâches.

• Recipient ID : l'identifiant de l'objet destinataire utilisé pour la recherche.
• Recipient Phone (Update Fields) : même règle qu'à la création, le + en tête décidant si le pays de l'organisation s'applique.
• Recipient Notes (Update Fields) : les notes générales du destinataire, qui ne doivent être ni propres à une tâche ni propres à une destination.

Duplique une tâche existante et renvoie la copie. Pratique quand une livraison doit se répéter avec la même adresse et le même destinataire.

• Task ID : l'identifiant de l'objet tâche utilisé pour la recherche.
• Complete After (Override Fields) et Complete Before : l'heure au plus tôt et l'heure au plus tard de réalisation, ce qu'on change presque toujours sur un clone.
• Include Dependencies (Override Fields), Include Barcodes et Include Metadata : ce qui est repris dans la copie.

Force la clôture d'une tâche déjà démarrée et enregistre si elle s'est bien passée. C'est la sortie de secours, pour les cas que l'application du livreur n'a pas clôturés.

• Task ID : l'identifiant de l'objet tâche utilisé pour la recherche.
• Complete as a Success : si la clôture est un succès ou non, ce qui sépare un colis livré d'une tentative ratée dans ton reporting.
• Notes (Additional Fields) : les notes de clôture.

C'est l'opération autour de laquelle se construit la majorité des workflows Onfleet. Elle crée la livraison ou l'enlèvement, avec sa destination, et renvoie l'objet tâche.

• Destination : l'adresse, ajoutée via le bloc Add Destination, avec au minimum Street, City et Country, ou une chaîne unique quand Unparsed Address est activé.
• Complete After (Additional Fields) et Complete Before : le créneau de livraison.
• Pick Up Task (Additional Fields) : s'il s'agit d'un enlèvement plutôt que d'une remise.
• Service Time (Additional Fields) : les minutes passées sur place à l'arrivée, prises en compte pour l'optimisation de tournée.

Efface une tâche d'Onfleet. Elle disparaît de la liste du livreur, ce qui réserve cette opération aux annulations, pas aux tentatives ratées.

• Task ID : l'identifiant de l'objet tâche, typiquement {{ $json.id }} transmis par le nœud qui a identifié la commande.

Récupère une tâche et son état actuel, la façon habituelle d'enrichir un événement avant d'agir dessus.

• Task ID : l'identifiant de l'objet tâche, souvent {{ $json.id }} directement issu du trigger.

Parcourt les tâches de l'organisation, filtrées par période et par état. C'est l'opération de reporting du nœud.

• Task ID : marqué requis même sur cette opération de liste, donne-lui une valeur avant de lancer le nœud.
• Return All : activé, toutes les tâches correspondantes remontent ; désactivé, Limit plafonne le nombre de tâches renvoyées.
• From (Filters) et To : le début et la fin de la plage, la fin valant l'heure actuelle par défaut.
• State (Filters) : 0 non affectée, 1 affectée, 2 active, 3 terminée, ou all.

Modifie une tâche qui existe déjà, sans la recréer. Seuls les champs de mise à jour renseignés sont appliqués.

• Task ID : l'identifiant de l'objet tâche utilisé pour la recherche.
• Notes (Update Fields) : les notes de la tâche, ce que le livreur lit sur son téléphone.
• Quantity (Update Fields) et Service Time : le nombre d'unités à déposer et les minutes passées sur place, tous deux utilisés pour l'optimisation de tournée.

Onfleet prend les tâches qui attendent dans le conteneur non assigné d'une équipe et les répartit entre les chauffeurs en service, en construisant les tournées au passage.

• Team ID : l'identifiant de l'équipe visée, souvent {{ $json.id }} repris du nœud précédent.
• Max Allowed Delay : le retard maximal toléré, en minutes, sur une tâche.
• Max Number Of Tasks Per Route : le nombre total de tâches autorisées sur une tournée, pour qu'un chauffeur n'hérite pas de toute la matinée.
• Service Time : la durée de service par défaut, en minutes, appliquée aux tâches qui n'ont pas la leur.

Une équipe apparaît dans l'organisation Onfleet avec ses chauffeurs et ses administrateurs déjà rattachés.

• Name : un nom unique pour l'équipe, pour ne jamais confondre deux dépôts.
• Worker Names or IDs : la liste des chauffeurs, choisis dans le menu déroulant ou passés par identifiants via une expression, la formule n8n qui va chercher une valeur dans l'item entrant.
• Administrator Names or IDs : les administrateurs qui pilotent l'équipe.
• Self Assignment : dans Additional Fields, autorise ou non les chauffeurs à prendre eux-mêmes les tâches non assignées de l'équipe.

L'équipe disparaît de l'organisation Onfleet. Autant réserver cette opération à un workflow qu'un humain déclenche volontairement, pas à une routine planifiée.

• Team ID : l'identifiant de l'équipe à supprimer, à conserver au moment de la création plutôt qu'à retrouver après coup.

Tu donnes un identifiant d'équipe, le nœud renvoie la fiche correspondante, exploitable par les nœuds suivants avec des expressions, les formules qui vont chercher une valeur dans l'item entrant.

• Team ID : l'identifiant de l'équipe, typiquement {{ $json.id }} issu d'un Get many teams.

Toutes les équipes de l'organisation reviennent sous forme de liste, un item par équipe.

• Return All : activé, n8n enchaîne les pages de l'API jusqu'à la dernière équipe ; désactivé, il s'arrête à Limit.
• Limit : le nombre maximal d'équipes renvoyées, pratique tant que le workflow est en test.

Les temps estimés des prochaines tâches d'une équipe reviennent, avec le chauffeur qu'Onfleet retiendrait pour la course.

• Team ID : l'équipe interrogée.
• Pick Up et Drop Off : dans Filters, les deux extrémités du trajet estimé.
• Restricted Vehicle Types : les types de véhicule à ignorer dans la requête, parmi CAR, MOTORCYCLE, BICYCLE et TRUCK.
• Service Time : le temps attendu sur place, en secondes, au point de retrait, au point de livraison, ou aux deux.

La fiche d'une équipe existante évolue. Ce que tu mets dans Update Fields est ce qui change, rien d'autre ne part.

• Team ID : l'équipe modifiée.
• Worker Names or IDs : la composition en chauffeurs après modification.
• Hub Name or ID : le hub de rattachement, choisi dans la liste ou passé par identifiant.
• Self Assignment : bascule la possibilité pour les chauffeurs de prendre seuls les tâches non assignées de l'équipe.

Un chauffeur obtient son compte Onfleet et rejoint une équipe dans le même mouvement, ce que demande la plupart des arrivées.

• Name : le nom du chauffeur.
• Phone : ses numéros de téléphone.
• Team Names or IDs : une ou plusieurs équipes dont il fait partie.
• Capacity : dans Additional Fields, le nombre maximal d'unités qu'il peut transporter, utilisé pour l'optimisation des tournées.

Le départ d'un chauffeur se traduit par une fiche qui quitte Onfleet. Une trace dans un canal interne évite que le dispatch cherche quelqu'un qui n'est plus là.

• Worker ID : l'identifiant du chauffeur, pas son nom affiché.

Un chauffeur, un item en retour. La collection Options décide de la quantité d'informations qui voyage avec.

• Worker ID : l'identifiant du chauffeur recherché.
• Analytics : activé, la réponse s'enrichit des événements de prise de service, de la distance parcourue en mètres et des analyses de temps.
• Fields to Return : la liste des champs à garder quand la fiche complète est de trop, par exemple onDuty, location ou activeTask.

La liste des chauffeurs se filtre par leur position du moment, ce qui répond à la question « qui est près de cette adresse ? ».

• Search by Location : ne garder que les chauffeurs présents dans une zone cible.
• Longitude et Latitude : le couple de coordonnées au centre de cette zone.
• Radius : dans Filters, le rayon en mètres de la zone sphérique fouillée. Par défaut 1000, avec un maximum de 10000.
• Return All : activé, tous les chauffeurs correspondants remontent ; désactivé, Limit plafonne la liste.

Demander le planning d'un chauffeur donne au workflow de quoi raisonner sur sa disponibilité avant d'engager quoi que ce soit.

• Worker ID : l'identifiant du chauffeur, récupéré d'un Get many workers ou stocké dans ta propre base.

Modifier une fiche chauffeur couvre le quotidien : une capacité revue, une correction de nom, un passage dans une autre équipe.

• Worker ID : le chauffeur modifié.
• Capacity : le nombre maximal d'unités qu'il peut transporter, pour l'optimisation des tournées.
• Display Name : le nom affiché à la place du vrai dans les SMS, sur les pages de suivi de livraison et vis-à-vis des organisations partenaires.
• Team Names or IDs : les équipes auxquelles il appartient après la modification.