Créer des étiquettes de colis avec FileMaker et l'API DHL
La connexion de FileMaker à l'API DHL REST permet la création automatisée d'étiquettes de colis pour l'expédition. Ce guide vous explique, étape par étape, comment programmer FileMaker pour que votre solution FileMaker communique avec l'API DHL REST afin de demander et de télécharger des étiquettes de colis.
L'API DHL permet d'automatiser un grand nombre de processus liés à l'expédition et au suivi des colis. Outre la création d'étiquettes de colis (étiquettes d'expédition), les utilisateurs peuvent également automatiser le suivi des envois (tracking) afin de surveiller l'état de leurs colis en temps réel. L'API permet également de créer des étiquettes de retour afin de simplifier les retours pour les clients. En outre, des documents d'expédition importants tels que les déclarations de douane pour les envois internationaux peuvent être créés directement et intégrés dans le processus d'expédition. De plus, il est possible de donner la priorité aux envois ou d'ajouter certaines options d'expédition comme le contre-remboursement ou l'assurance. L'API DHL offre donc une solution complète permettant d'optimiser l'ensemble du processus d'expédition et de l'intégrer entièrement dans des systèmes existants tels que FileMaker. Dans ce guide, nous vous montrons comment créer des étiquettes de colis avec l'API.
Quatre plateformes ERP FileMaker avec CRM et gestion des marchandises pour des processus opérationnels optimaux.
Demander des informations
Conditions préalables
- Un compte DHL pour les entreprises avec accès à l'API DHL pour les entreprises.
- Les données d'accès à l'API DHL REST, c'est-à-dire la clé API, le nom d'utilisateur, et le mot de passe.
- FileMaker Pro à partir de la version 16 ou plus récente, car ces versions prennent en charge de manière native les requêtes HTTP requises.
1. créer un compte professionnel DHL et un accès à l'API
Avant de pouvoir intégrer l'API DHL dans FileMaker, vous devez disposer d'un accès à l'API DHL :
- Rendez-vous sur la page DHL Developer Portal : Portail des développeurs DHL.
- Inscrivez-vous avec votre compte professionnel.
- Demandez les données d'accès à l'API (clé API, nom d'utilisateur, mot de passe).
- Vérifiez votre accès et activez le service "DHL Expédition API".
2. premiers pas avec l'API DHL
L'API DHL utilise des requêtes HTTP pour envoyer et recevoir des données. Les principales fonctions permettant de créer une étiquette de colis sont les suivantes :
- Authentification: Authentification de base avec nom d'utilisateur et mot de passe.
- Création d'une étiquette (marque de colis)Envoi des données d'expédition et réception de l'étiquette au format PDF.
- Récupération du label: le retour se fait au format PDF binaire, qui peut être enregistré et utilisé dans FileMaker dans une rubrique Conteneur.
3. scripts FileMaker pour l'accès à l'API DHL
FileMaker utilise la commande Insérer à partir de l'URL en combinaison avec les options cURL, pour envoyer des requêtes HTTP à l'API et recevoir des réponses.
3.1 Préparer l'authentification
DHL utilise l'authentification de base. Dans FileMaker, cela se fait en fournissant le nom d'utilisateur et le mot de passe au format Base64. Vous trouverez ci-dessous un exemple de préparation de l'authentification :
Base64Encode("Nom d'utilisateur:Mot de passe")
Dans FileMaker, vous pouvez insérer cette chaîne directement dans le Insérer à partir de l'URL-avec les options cURL correspondantes.
3.2. créer des bordereaux d'expédition
L'API requiert certaines informations telles que l'adresse de l'expéditeur, l'adresse du destinataire, le poids, le mode d'expédition, etc. Voici un exemple simple de demande à l'API DHL pour la création d'une étiquette.
Script de création d'un message : Créer une étiquette de colis
- Ouvrez la fenêtre de l'espace de travail des scripts dans FileMaker.
- Créez un nouveau script, par exemple "Créer un repère de colis".
- Ajoutez les variables suivantes pour enregistrer les données d'envoi :
Définir la variable [ $url ; valeur : "https://cig.dhl.de/services/production/rest/sendungsverfolgung/v2/paketmarken" ]
Définir une variable [ $auth ; Valeur: "Base64Encode(Nom d'utilisateur:Mot de passe)" ]
Définir une variable [ $payload ; Valeur: "{ 'Version' : '2.0', 'shipmentDetails' : {...} }" ]
# Insérer ici les données d'expédition au format JSON
Exemple de requête JSON (Payload) que vous envoyez à DHL :
{
"Version" : "2.0",
"ShipmentOrder" : [
{
"sequenceNumber" : "1",
"Shipment" : {
"Shipper" : {
"Nom" : "Votre entreprise",
"Address" : {
"StreetName" : "rue",
"BuildingNumber" : "1",
"PostalCode" : "12345",
"City" : "ville",
"CountryCode" : "DE" (code pays)
}
},
"Récepteur" : {
"Nom" : "Destinataire",
"Address" : {
"StreetName" : "rue destinataire",
"BuildingNumber" : "10",
"PostalCode" : "54321",
"City" : "ville destinataire",
"CountryCode" : "DE" (code pays)
}
},
"ShipmentDetails" : {
"ProductCode" : "V01PAK", # Mode d'expédition (par ex. colis national)
"WeightInKG" : "2.5", # Poids du colis
"CustomerReference" : "123456", # Numéro de référence
"ShipmentDate" : "2023-09-01"
}
},
"LabelResponseType" : "URL"
}
]
}
Utilisez le Insérer à partir de l'URL-Pour cela, il suffit de cliquer sur la commande "Envoyer" pour envoyer la demande à DHL et créer l'étiquette :
Insérer depuis URL [ Sélection ; Cible : $response ; URL : $url ; options cURL :
"-X POST --header \"Authorization : Basic " & $auth & "\"" &
"--header \"Content-Type : application/json\"" &
"--data " & $payload ]
3.3. télécharger et enregistrer l'étiquette
L'étiquette créée est renvoyée par l'API sous la forme d'un fichier PDF. Vous pouvez l'enregistrer dans une rubrique Conteneur FileMaker.
- Insérez une rubrique Conteneur dans votre base de données FileMaker pour enregistrer le fichier PDF.
- Modifiez votre script de manière à ce que le fichier PDF soit téléchargé dans ce champ de conteneur :
Insérer à partir de l'URL [ Sélection ; Cible : Table::Champ Conteneur ; URL : "response-PDF-URL" ]
Le champ response-PDF-URL est renvoyé par l'API DHL après la création réussie du label et contient l'URL où le PDF peut être téléchargé.
Cours accéléré FileMaker
FileMaker rapide et efficace
apprendre en 20 chapitres.
Participer gratuitement
4. créer une charge utile JSON avec FileMaker
Vous trouverez ci-dessous un script FileMaker qui montre comment construire le chargement JSON avec les données des rubriques FileMaker. Dans cet exemple, nous partons du principe que les rubriques de votre base de données FileMaker contiennent des informations sur l'expéditeur, le destinataire et les détails de l'envoi et nous appelons ici votre table "Table" à titre d'exemple avec les noms de rubriques correspondants, ce que vous devez adapter en conséquence dans votre solution FileMaker. La structure JSON correspond à celle que vous pouvez envoyer à l'API DHL.
Exemple de script dans FileMaker :
# Définir des variables pour la structure JSON
Définir la variable [ $jsonExpéditeur ; Valeur : JSONSetElement ( "{}" ;
[ "Nom" ; Table::SociétéExpéditeur ; JSONString ] ;
["Address.StreetName" ; Table::RueExpéditeur ; JSONString ] ;
["Address.BuildingNumber" ; Table::NuméroDeMaisonExpéditeur ; JSONString ] ;
["Address.PostalCode" ; Table::CodePosteExpéditeur ; JSONString ] ;
["Address.City" ; Table::VilleExpéditeur ; JSONString ] ;
["Address.CountryCode" ; Table::PaysExpéditeur ; JSONString ]
)]
Définir une variable [ $jsonRécepteur ; Valeur: JSONSetElement ( "{}" ;
[ "Nom" ; Table::NomDestinataire ; JSONString ] ;
["Address.StreetName" ; Table::RueDestinataire ; JSONString ] ;
["Address.BuildingNumber" ; Table::NuméroDeBâtimentDestinataire ; JSONString ] ;
["Address.PostalCode" ; Table::CodePosteDestinataire ; JSONString ] ;
["Address.City" ; Table::VilleDestinataire ; JSONString ] ;
["Address.CountryCode" ; Table::PaysDestinataire ; JSONString ]
)]
Définir une variable [ $jsonDétails de l'envoi ; Valeur: JSONSetElement ( "{}" ;
["ProductCode" ; Table::Code produit ; JSONString ] ;
["WeightInKG" ; Table::Poids d'expédition ; JSONNumber ] ;
["CustomerReference" ; Table::Numéro de référence ; JSONString ] ;
["ShipmentDate" ; Table::Date d'expédition ; JSONString ]
)]
# Structure de l'ensemble du document JSON
Définir une variable [ $payload ; Valeur: JSONSetElement ( "{}" ;
["Version" ; "2.0" ; JSONString ] ;
["ShipmentOrder[0].sequenceNumber" ; "1" ; JSONString ] ;
[ "ShipmentOrder[0].Shipment.Shipper" ; $jsonExpéditeur ; JSONObject ] ;
[ "ShipmentOrder[0].Shipment.Receiver" ; $jsonReceiver ; JSONObject ] ;
[ "ShipmentOrder[0].Shipment.ShipmentDetails" ; $jsonDétailsExpédition ; JSONObject ] ;
["ShipmentOrder[0].LabelResponseType" ; "URL" ; JSONString ]
)]
La charge utile JSON générée est transférée dans la variable $payload que vous pouvez utiliser dans le script supérieur Créer un repère de paquet comme définition de la variable $payload.
FileMaker ERP personnalisable avec gestion des marchandises et interfaces logistiques.
Plus d'informations Foire aux questions sur FileMaker et l'API DHL
- Qu'est-ce que l'interface DHL et comment l'intégrer à FileMaker ?
- L'interface DHL permet d'automatiser l'envoi de données relatives aux colis à DHL et de récupérer les étiquettes de colis et les données de suivi des envois. Dans FileMaker, vous pouvez utiliser cette interface pour automatiser les processus d'expédition et générer des étiquettes de colis directement à partir de votre base de données.
- Quels sont les avantages de l'intégration de l'interface DHL dans FileMaker ?
- L'intégration vous permet de gagner du temps et d'éviter les erreurs, car les données d'expédition sont directement transmises à DHL à partir de la base de données FileMaker. De plus, vous pouvez générer automatiquement des étiquettes de colis et intégrer le suivi des envois dans votre système, ce qui augmente l'efficacité du processus d'expédition.
- De quelles informations ai-je besoin pour utiliser l'interface DHL dans FileMaker ?
- Vous avez besoin des données d'accès à l'API DHL (numéro de client, nom d'utilisateur, mot de passe) ainsi que des points de terminaison de l'API DHL. Ces informations sont fournies par DHL après que vous vous soyez enregistré pour accéder à l'interface.
- Comment puis-je générer des étiquettes de colis via l'interface DHL dans FileMaker ?
- Après avoir saisi dans FileMaker les données d'expédition telles que l'adresse du destinataire, le poids et le mode d'expédition, vous pouvez envoyer ces informations à l'interface DHL via un script API. En retour, vous recevez un numéro de colis et une étiquette imprimable qui peut être enregistrée dans FileMaker ou imprimée directement.
- Puis-je intégrer le suivi des envois dans FileMaker ?
- Oui, l'interface DHL vous permet de récupérer le numéro de suivi et de l'enregistrer dans FileMaker. Vous pouvez utiliser l'API pour consulter le statut actuel d'un colis en temps réel et afficher ces informations directement dans votre base de données.
- L'interface DHL dans FileMaker est-elle uniquement adaptée aux envois nationaux ?
- Non, l'interface DHL prend en charge les envois nationaux et internationaux. Dans FileMaker, vous pouvez transmettre différents paramètres à l'API DHL, en fonction de la destination et du type d'envoi, afin de générer des étiquettes et des informations d'expédition pour différents pays.
- Quel est le niveau de sécurité de l'utilisation de l'API DHL avec FileMaker ?
- La communication avec l'API DHL se fait via HTTPS, ce qui garantit un transfert de données sécurisé. Dans FileMaker, vous devez vous assurer que les données sensibles, telles que les données d'accès à l'API et les informations sur les clients, sont stockées et protégées dans des rubriques cryptées.
- Puis-je créer des processus automatisés dans FileMaker pour l'interface DHL ?
- Oui, vous pouvez créer des scripts dans FileMaker qui envoient automatiquement les données d'expédition à DHL, récupèrent les étiquettes des colis et mettent régulièrement à jour le suivi des envois. Il est également possible de programmer l'exécution de ces processus afin d'automatiser complètement le traitement des expéditions.
- Quelles sont les exigences de DHL en matière d'intégration de l'interface dans FileMaker ?
- DHL exige que l'API soit correctement mise en œuvre, notamment en respectant les spécifications de l'API décrites dans la documentation de l'API DHL. De plus, vous devez vous assurer que votre application est approuvée pour une utilisation productive après que DHL ait vérifié son implémentation.
- Que faire si je rencontre un problème lors de l'utilisation de l'interface DHL dans FileMaker ?
- Si vous rencontrez des problèmes de communication avec l'API DHL, vous devez d'abord vérifier les retours des requêtes API dans FileMaker. Les codes d'erreur et les messages de DHL donnent souvent des indications détaillées sur le problème. Si les difficultés persistent, vous pouvez consulter le support DHL ou la documentation technique de l'API pour résoudre le problème.
Résumé
En connectant FileMaker à l'API REST de DHL, vous pouvez automatiser efficacement la création d'étiquettes de colis. Les principales étapes sont résumées ci-dessous :
- Demander et configurer les données d'accès à l'API.
- Créer des scripts dans FileMaker pour envoyer les données d'expédition à DHL.
- Recevoir et enregistrer des étiquettes PDF.
- Intégrer la gestion des erreurs pour surveiller les réponses de l'API.
Cette configuration vous permet d'intégrer complètement le processus d'expédition dans FileMaker et de créer des étiquettes de colis directement à partir de votre base de données.
