Intégrations et API

Quelles intégrations OptiRoutes propose-t-il ?

Charger les commandes depuis un fichier, un FTP ou un SFTP

L’intégration la plus simple, c’est le fichier que votre système exporte déjà. Sur l’écran des livraisons, Charger les livraisons lit un fichier Excel ou CSV ; vous associez une fois pour toutes chaque champ du système — adresse, nom du client, numéro de commande, quantité, etc. — au nom de votre colonne, et chaque fichier suivant se charge de la même façon. Pour un fichier TXT à largeur fixe, vous indiquez des positions de caractères au lieu de noms de colonnes. Des lignes peuvent être ignorées grâce à un mot-repère dans les remarques, un second mot-repère peut remplacer l’adresse, et vous décidez si un numéro de commande existant est mis à jour ou ajouté comme nouvelle commande.

Pour supprimer toute intervention manuelle, choisissez un mode de chargement automatique dans les paramètres :

• Le serveur de fichiers OptiRoutes — votre système dépose le fichier du jour, nommé d’après la date, dans le dossier de votre entreprise sur le serveur FTP ou sur le serveur SFTP chiffré.
• Votre propre serveur FTP — OptiRoutes s’y connecte avec l’utilisateur que vous lui fournissez et charge le fichier nommé à la date du jour, ou le fichier le plus récemment mis à jour.
• Import et export automatiques — les commandes se chargent d’elles-mêmes et les tournées sont aussi planifiées, sans aucun clic.
• L’API de fichiers — votre logiciel importe le fichier de commandes en HTTPS, comme décrit ci-dessous.

Sur l’écran des clients, un fichier Excel ou CSV comportant numéro de client, nom, adresse, temps d’arrêt et heures d’ouverture et de fermeture crée ou met à jour les clients et leurs plages horaires.

L’API de fichiers : commandes entrantes, POD et rapports sortants

Chaque entreprise dans OptiRoutes dispose de son propre dossier privé de fichiers : les commandes qu’elle charge, les bons de livraison signés avec leurs photos et signatures, les exports de tournées et les rapports de fin de journée. L’API de fichiers permet à vos systèmes de lire et d’écrire directement dans ce dossier en HTTPS, sans serveur FTP intermédiaire. Le responsable de l’entreprise bascule entre FTP et API dans Paramètres → API et fichiers et y crée les clés — aucune demande au support n’est nécessaire, et les nouvelles entreprises démarrent directement sur l’API.

Les appels couvrent la vérification de la clé, le listage d’un dossier, le téléchargement, l’import (jusqu’à 50 Mo par fichier) et la suppression des fichiers que vous avez importés, le listage des fichiers POD d’une journée par commande et par type, et le téléchargement de tous les fichiers POD d’une journée en un seul ZIP. Le guide comprend des exemples de code en Python, C# et Node.js, ainsi qu’un script PowerShell qui synchronise un dossier de votre serveur avec le dossier de l’entreprise — une équipe habituée au FTP peut ainsi continuer à travailler de la même façon. Consultez le guide de l’API de fichiers.

Comment les clés API sont-elles sécurisées ?

• Moindre privilège — chaque clé ne reçoit que les autorisations nécessaires : POD signées uniquement, lecture de tous les fichiers, ou import de commandes et de fichiers dans inbox.
• Adresses autorisées — une clé peut être limitée aux adresses IP fixes de votre serveur.
• Expiration et rotation — une clé peut expirer après un nombre de jours donné ; créez une nouvelle clé, basculez, puis révoquez l’ancienne, sans interruption de service.
• Révocation immédiate — une clé révoquée cesse de fonctionner en moins de 30 secondes.
• Audit — chaque appel est journalisé avec l’heure, l’adresse, le fichier et la réponse, et présenté au responsable.
• Stockage sécurisé — OptiRoutes ne conserve qu’une empreinte SHA-256 de chaque clé ; les connexions se font en HTTPS avec TLS 1.2 ou supérieur, et une clé n’accède qu’au dossier de sa propre entreprise.

Limites : 300 requêtes par minute et par clé, 50 Mo par fichier, 20 clés actives par entreprise, et jusqu’à 5 000 entrées par listage de dossier.

L’API de rapports et d’envoi

Pour les outils de reporting et les connecteurs ERP, une API distincte, à l’adresse api-users.optiroutes.com, met à disposition les données de votre entreprise sous forme de rapports et accepte des données entrantes. Une seule adresse et un seul jeton, délivré par OptiRoutes pour votre entreprise, couvrent tous les appels. La page de documentation vous permet de coller votre jeton pour voir quels rapports vous sont ouverts et la correspondance des colonnes de votre compte : consulter la documentation de l’API.

Deux appels d’envoi fonctionnent dans l’autre sens : l’envoi de commandes écrit le fichier de commandes du jour et lance le chargement automatique, et l’envoi des chauffeurs, lignes et véhicules remplace l’ensemble de la flotte, comme un fichier de flotte. La liste de chauffeurs envoyée valant flotte complète, envoyez toujours tous les chauffeurs, et pas seulement les modifications.

Export des tournées et webhooks

L’export des tournées écrit les tournées cochées en CSV, XLSX, XML, JSON ou TXT à largeur fixe. Une table de colonnes détermine quels champs sortent et sous quel intitulé, des colonnes d’origine de votre fichier de commandes peuvent être ajoutées, et avec la gestion des articles, un second fichier liste chaque article. Les exports peuvent aller vers votre ordinateur, votre serveur FTP ou le dossier de l’entreprise, et en JSON l’export peut aussi être envoyé à une adresse web ; en cas d’échec de l’envoi, le système réessaie une fois.

Pour chaque livraison au fil de l’eau, renseignez l’adresse des rapports de livraison dans les paramètres de l’application chauffeur : chaque déclaration de livraison des chauffeurs y est aussi envoyée, de sorte que l’un de vos autres systèmes se met à jour de lui-même.

E-mail, paiements, cartes et messagerie

• E-mail — les bons de livraison signés partent de votre propre compte Gmail avec un mot de passe d’application Google ; les rapports, comme le rapport de palettes de fin de journée, vont à votre e-mail de rapports ; les clients payants reçoivent des reçus et les chauffeurs des confirmations de dépôt depuis la caisse.
• Paiements — les recharges se paient sur une page de paiement Stripe sécurisée, avec en option une carte enregistrée pour la recharge automatique.
• Adresses et cartes — les adresses sont choisies parmi les suggestions de Google et vérifiées sur la carte avant la planification.
• Navigation — l’application chauffeur transmet chaque arrêt à Waze, ou à Plans sur iPhone, par adresse ou par coordonnées exactes.
• SMS et WhatsApp — messages d’arrivée et liens de suivi aux clients, alertes aux responsables, lignes aux sous-traitants, et images des tournées aux chauffeurs sur WhatsApp.

Questions fréquentes