Bienvenus dans la dernière partie de notre mini-série sur les API EasyCargo ! Aujourd’hui, nous allons parler du processus de planification du chargement étape par étape. Nous vous montrerons à quel point l’interface API simplifie les opérations logistiques : depuis la configuration du compte utilisateur, jusqu’à la génération des rapports d’impression en passant par la définition de l’espace de chargement. Donc si vous voulez d’apprendre à optimiser vos processus à l’aide des API EasyCargo, ici vous êtes au bon endroit !

Avant de s’y mettre, il est conseillé de se familiariser avec deux premières parties de notre mini-série, à savoir :

• Guide théorique de l’API – tous les fondamentaux que vous devriez connaitre
• Guide pratique de l’API avec requêtes et tests – comment configurer un client API et tester les points de terminaison à l’aide de ReqBin

Si vous maitrisez ces fondamentaux, il est temps d’aller plus loin !

Processus de planification de chargement étape par étape

Pour utiliser les requêtes API suivantes, il faudra inclure un token d’authentification dans l’en-tête de votre requête. Vous trouverez des procédures d’authentification détaillées dans notre article précédent. Pour obtenir un token d’authentification, vous devez disposer d’une clé API associée à votre compte utilisateur. Veuillez contacter notre équipe d’assistance pour demander une clé API. Attention : les tokens d’authentification ne sont valables que pendant une heure et demie. Ce délai échu, ils expirent et ne sont plus fonctionnels.

Configuration de l’accès des utilisateurs

La première étape, et l’une des plus cruciales, de notre processus de planification du chargement consiste à créer un compte, par exemple pour le personnel de l’entrepôt. A l’aide du point de terminaison /api/v1/users, vous pouvez créer de nouveaux comptes utilisateurs avec des autorisations spécifiques. Comme vous pouvez le voir plus bas dans une requête API, vous devrez fournir certains éléments concernant l’utilisateur. Si le compte est créé avec succès, le nouvel utilisateur apparaît immédiatement dans l’application EasyCargo dans l’onglet Utilisateurs.

Le code ci-dessous montre une requête au point de terminaison /api/v1/users avec un corps contenant des détails sur un utilisateur pour lequel nous voulons créer un compte. Il est nécessaire d’indiquer un prénom, un nom, une adresse électronique pour la connexion et un type d’utilisateur. Le type de l’utilisateur peut être soit un administrateur (représenté par un 1 dans le corps de la requête), soit un Utilisateur standard (représenté par un 2).

Voir l’exemple complet de la requête API : https://reqbin.com/duacb1ye

Définition d’un espace de chargement

Avant de commencer votre planification du chargement, il est essentiel de définir l’espace de chargement. Le point de terminaison /api/v1/cargospaces vous permet de définir les différents types de containers. Pour chaque espace de chargement, il faut indiquer la longueur, la largeur, la hauteur et la capacité de charge maximale. Actuellement, nous acceptons seulement les containers, mais d’autres types d’espaces sont en préparation pour les prochaines mises à jour ! Une fois défini, le container apparaît dans l’interface EasyCargo, en tant que le signe de la création réussie. Le container ainsi créé est prêt pour une utilisation immédiate dans votre planification du chargement.

Le code ci-dessous montre une requête au point de terminaison /api/v1/cargospaces avec un corps indiquant des détails sur le container que nous souhaitons de créer. Il faut indiquer le nom, la largeur, la hauteur, la longueur et le poids de chargement maximal. Indiquer ensuite l’unité de mesure utilisée (1 pour l’unité métrique et 2 pour l’unité impériale) et le type d’espace de chargement. Celui-ci est fixé à 1, ce qui représente un container.

See the full template of the API request: https://reqbin.com/8ieqp8ey

Gestion des articles à charger

Une fois les espaces de chargement définis, il est temps d’ajouter les articles. A l’aide du point de terminaison /api/v1/shipment-inputs, vous pouvez spécifier à la fois les dimensions, le poids ainsi que les contraintes de chargement de chaque article à charger. L’interface EasyCargo fournit une confirmation visuelle de la création réussie de l’envoi, en affichant tous les articles et leurs spécifications.

Dans le code ci-dessous, nous allons créer une nouvelle expédition avec 82 articles du même type en utilisant le point de terminaison /api/v1/shipment-inputs. Dans le corps de la requête, nous allons indiquer le nom de l’envoi, l’unité de mesure et les articles. Pour les articles, nous pouvons spécifier les dimensions et les restrictions. Dans cet exemple, nous créons les articles dans un groupe prioritaire appelé Berlin, car c’est là que nous voulons livrer nos réfrigérateurs. Nous autoriserons les rotations et l’empilage des articles. Dans un souci d’exhaustivité, nous tenons à préciser qu’il n’est actuellement pas possible de changer la couleur de l’article ou de contrôler l’affichage ou non de l’étiquette par l’intermédiaire de l’API.

Voir l’exemple complet de la requête API : https://reqbin.com/ozixloob

Création du plan de chargement optimal

Tous les détails du chargement établis, nous pouvons procéder à l’optimisation de notre plan de chargement. Le logiciel EasyCargo calcule automatiquement la meilleure disposition du chargement compte tenu la répartition du poids, l’ordre de chargement et les exigences lors de la livraison. Bien que l’API ne sache pas encore déclencher ce processus d’optimisation automatiquement, il suffit de cliquer sur le bouton Charger dans l’application EasyCargo et le système effectue le calcul pour vous ! L’optimisation initiale terminée, vous avez la possibilité de faire des ajustements manuels. Le plan final répondra ainsi à toutes vos exigences spécifiques.

Création des rapports d’impression du chargement

Une fois le plan de chargement finalisé, vous pourrez générer un rapport détaillé avec disposition des articles et la visualisation en 3D. Le point de terminaison /api/v1/shipment-reports/{id} permet de créer le rapport en format PDF pour faciliter le partage avec vos collègues ou partenaires. Pour plus de détails, consultez le rapport d’impression !

Le code ci-dessous montre comment récupérer toutes les informations du chargement à l’aide du point de terminaison /api/v1/shipment-report/{id}. Tout d’abord, nous devons obtenir l’identifiant ID du rapport en envoyant une requête GET à /api/v1/shipments. On récupère ensuite l’identifiant du rapport dans cette réponse et on l’inclue dans le URL de votre prochaine requête (/api/v1/shipment-report/{id}). La réponse contiendra tous les détails que vous voyez dans l’image ci-dessous dans le rapport PDF imprimable.

Voir l’exemple complet de la requête API : https://reqbin.com/ust8mrq2

Partage et collaboration

Avez-vous besoin de partager le plan de chargement avec votre équipe ou vos partenaires ? Le point de terminaison /api/v1/shipments vous fournira toutes les informations sur le chargement, y compris la visualisation interactive en 3D. Accédez à l’URL public du chargement dans EasyCargo et consultez la disposition définitive des articles du chargement.

Dans le code ci-dessous, nous allons récupérer tous les détails de notre chargement précédemment créé en utilisant le point de terminaison /api/v1/shipments/{id}. Si vous voulez récupérer l’identifiant ID de l’expédition, il faut d’abord envoyer une requête GET à /api/v1/shipments. Une fois que vous avez identifié l’identifiant ID de votre envoi, envoyez une requête GET à /api/v1/shipments/{id} pour récupérer tous les détails du chargement, y compris l’URL public du rapport d’impression et d’autres informations indiquées ci-en bas.

Voir l’exemple complet de la requête API : https://reqbin.com/y5p3zysj

L’API EasyCargo illustre comment des interfaces bien conçues peuvent rationaliser des opérations logistiques complexes. Il permet de planifier et gérer efficacement votre chargement à l’aide de l’automatisation et des algorithmes intelligents. Grâce à la facilité de l’intégration, vous pourrez utiliser l’API pour optimiser tous vos processus logistiques et obtenir les rapports synoptiques pour faciliter la planification. Que vous soyez débutant en matière d’API ou développeur expérimenté, les possibilités d’intégration sont nombreuses. Contactez-nous pour avoir une discussion personnalisée sur une mise en place de EasyCargo dans votre entreprise. Ensemble, nous trouverons la meilleure solution pour vous !