Wagen 0
DHL Paketlabels mit FileMaker erstellen
Menü
Paketlabels erstellen mit FileMaker und der DHL API
Die Anbindung von FileMaker an die DHL REST API ermöglicht die automatisierte Erstellung von Paketmarken für den Versand. In dieser Anleitung erfahren Sie Schritt für Schritt, wie Sie FileMaker so programmieren, dass Ihre FileMaker-Lösung mit der DHL REST API kommuniziert, um Paketmarken anzufordern und herunterzuladen.
Mit der DHL-API lässt sich eine Vielzahl von Prozessen rund um den Versand und die Sendungsverfolgung automatisieren. Neben der Erstellung von Paketmarken (Versandlabeln) können Nutzer auch Sendungsverfolgungen (Tracking) automatisieren, um den Status ihrer Pakete in Echtzeit zu überwachen. Die API ermöglicht außerdem das Erstellen von Retouren-Labeln, um den Rückversand für Kunden zu vereinfachen. Weiterhin können wichtige Versanddokumente wie Zolldeklarationen für internationale Sendungen direkt erstellt und in den Versandprozess integriert werden. Zusätzlich können Sendungen priorisiert oder bestimmte Versandoptionen wie Nachnahme oder Versicherung hinzugefügt werden. Die DHL-API bietet somit eine umfassende Lösung, um den gesamten Versandprozess zu optimieren und vollständig in bestehende Systeme wie FileMaker zu integrieren. In dieser Anleitung zeigen wir Ihnen, wie Sie Paketlabels mit der API erstellen können.
Vier FileMaker ERP-Plattformen mit CRM und Warenwirtschaft für optimale Betriebsprozesse.
Alle Kauflizenzen
Voraussetzungen
- Ein DHL-Geschäftskundenkonto mit Zugang zur DHL Geschäftskunden API.
- Die Zugangsdaten für die DHL REST API, d.h. API-Key, Benutzername, und Passwort.
- FileMaker Pro ab Version 16 oder höher, da diese Versionen die benötigten HTTP-Requests nativ unterstützen.
1. DHL Geschäftskundenkonto und API-Zugang einrichten
Bevor Sie die DHL API in FileMaker integrieren können, benötigen Sie einen Zugang zur DHL API:
- Gehen Sie auf die DHL Developer Portal-Seite: DHL Developer Portal.
- Registrieren Sie sich mit Ihrem Geschäftskundenkonto.
- Fordern Sie die API-Zugangsdaten an (API-Key, Benutzername, Passwort).
- Verifizieren Sie Ihren Zugang und aktivieren Sie den Service „DHL Versenden API“.
2. Erste Schritte mit der DHL API
Die DHL API verwendet HTTP-Anfragen, um Daten zu senden und zu empfangen. Die wichtigsten Funktionen zur Erstellung eines Paketlabels sind:
- Authentifizierung: Basis-Authentifizierung mit Benutzername und Passwort.
- Erstellen eines Labels (Paketmarke): Senden der Versanddaten und Empfangen des Labels als PDF.
- Abrufen des Labels: Die Rückgabe erfolgt als binäres PDF-Format, das in FileMaker in einem Containerfeld gespeichert und verwendet werden kann.
3. FileMaker-Skripte für den Zugriff auf die DHL API
FileMaker nutzt den Befehl Aus URL einfügen in Kombination mit cURL-Optionen, um HTTP-Anfragen an die API zu senden und Antworten zu empfangen.
3.1. Authentifizierung vorbereiten
DHL verwendet die Basic Authentication. In FileMaker wird dies durch die Bereitstellung von Benutzername und Passwort im Base64-Format erreicht. Im folgenden finden Sie ein Beispiel, wie Sie die Authentifizierung vorbereiten können:
Base64Encode("Benutzername:Passwort")
In FileMaker können Sie diesen String direkt in den Aus URL einfügen-Befehl mit den entsprechenden cURL-Optionen integrieren.
3.2. Versandscheine erstellen
Die API erfordert bestimmte Angaben wie Absenderadresse, Empfängeradresse, Gewicht, Versandart usw. Im folgenden ein einfaches Beispiel für eine Anfrage an die DHL API zur Erstellung eines Labels.
Skript: Paketmarke erstellen
- Öffnen Sie das Skript-Workspace-Fenster in FileMaker.
- Erstellen Sie ein neues Skript, z.B. „Paketmarke erstellen“.
- Fügen Sie folgende Variablen hinzu, um die Versanddaten zu speichern:
Variable setzen [ $url; Wert: "https://cig.dhl.de/services/production/rest/sendungsverfolgung/v2/paketmarken" ]
Variable setzen [ $auth; Wert: "Base64Encode(Benutzername:Passwort)" ]
Variable setzen [ $payload; Wert: "{ 'Version': '2.0', 'shipmentDetails': {...} }" ]
# Hier die Versanddaten im JSON-Format einfügen
Beispiel für den JSON-Request (Payload), den Sie an DHL senden:
{
"Version": "2.0",
"ShipmentOrder": [
{
"sequenceNumber": "1",
"Shipment": {
"Shipper": {
"Name": "Dein Unternehmen",
"Address": {
"StreetName": "Straße",
"BuildingNumber": "1",
"PostalCode": "12345",
"City": "Stadt",
"CountryCode": "DE"
}
},
"Receiver": {
"Name": "Empfänger",
"Address": {
"StreetName": "Empfängerstraße",
"BuildingNumber": "10",
"PostalCode": "54321",
"City": "Empfängerstadt",
"CountryCode": "DE"
}
},
"ShipmentDetails": {
"ProductCode": "V01PAK", # Versandart (z.B. Paket national)
"WeightInKG": "2.5", # Gewicht des Pakets
"CustomerReference": "123456", # Referenznummer
"ShipmentDate": "2023-09-01"
}
},
"LabelResponseType": "URL"
}
]
}
Verwenden Sie den Aus URL einfügen-Befehl, um die Anfrage an DHL zu senden und das Label zu erstellen:
Aus URL einfügen [ Auswahl ; Ziel: $response ; URL: $url ; cURL-Optionen:
"-X POST --header \"Authorization: Basic " & $auth & "\"" &
"--header \"Content-Type: application/json\"" &
"--data " & $payload ]
3.3. Label herunterladen und speichern
Das erstellte Label wird von der API in Form einer PDF-Datei zurückgegeben. Sie können es in einem FileMaker Container-Feld speichern.
- Fügen Sie ein Container-Feld in deine FileMaker-Datenbank ein, um die PDF-Datei zu speichern.
- Ändern Sie Ihr Skript so, dass die PDF-Datei in dieses Container-Feld heruntergeladen wird:
Aus URL einfügen [ Auswahl ; Ziel: Tabelle::Containerfeld ; URL: "response-PDF-URL" ]
Das Feld response-PDF-URL wird von der DHL API nach erfolgreicher Erstellung des Labels zurückgegeben und enthält die URL, unter der das PDF heruntergeladen werden kann.
FileMaker Crashkurs
Schnell und effektiv FileMaker
lernen in 20 Kapiteln.
Kostenlos teilnehmen
4. JSON Payload mit FileMaker erstellen
Im folgenden finden Sie ein FileMaker-Skript, das zeigt, wie Sie den JSON-Payload mit Daten aus FileMaker-Feldern aufbauen können. In diesem Beispiel gehen wir davon aus, dass die Felder in Ihrer FileMaker-Datenbank Informationen zum Absender, Empfänger und Versanddetails enthalten und nennen Ihre Tabelle hier beispielhaft „Table“ mit entsprechenden Feldnamen, was Sie in Ihrer FileMaker-Lösung entsprechend anpassen müssen. Die JSON-Struktur entspricht der, die Sie an die DHL-API senden können.
Beispiel-Skript in FileMaker:
# Variablen für JSON-Aufbau setzen
Variable setzen [ $jsonAbsender; Wert: JSONSetElement ( "{}" ;
[ "Name" ; Table::AbsenderFirma ; JSONString ] ;
[ "Address.StreetName" ; Table::AbsenderStraße ; JSONString ] ;
[ "Address.BuildingNumber" ; Table::AbsenderHausnummer ; JSONString ] ;
[ "Address.PostalCode" ; Table::AbsenderPLZ ; JSONString ] ;
[ "Address.City" ; Table::AbsenderStadt ; JSONString ] ;
[ "Address.CountryCode" ; Table::AbsenderLand ; JSONString ]
)]
Variable setzen [ $jsonEmpfänger; Wert: JSONSetElement ( "{}" ;
[ "Name" ; Table::EmpfängerName ; JSONString ] ;
[ "Address.StreetName" ; Table::EmpfängerStraße ; JSONString ] ;
[ "Address.BuildingNumber" ; Table::EmpfängerHausnummer ; JSONString ] ;
[ "Address.PostalCode" ; Table::EmpfängerPLZ ; JSONString ] ;
[ "Address.City" ; Table::EmpfängerStadt ; JSONString ] ;
[ "Address.CountryCode" ; Table::EmpfängerLand ; JSONString ]
)]
Variable setzen [ $jsonVersanddetails; Wert: JSONSetElement ( "{}" ;
[ "ProductCode" ; Table::Produktcode ; JSONString ] ;
[ "WeightInKG" ; Table::Versandgewicht ; JSONNumber ] ;
[ "CustomerReference" ; Table::Referenznummer ; JSONString ] ;
[ "ShipmentDate" ; Table::Versanddatum ; JSONString ]
)]
# Aufbau des gesamten JSON-Dokuments
Variable setzen [ $payload; Wert: JSONSetElement ( "{}" ;
[ "Version" ; "2.0" ; JSONString ] ;
[ "ShipmentOrder[0].sequenceNumber" ; "1" ; JSONString ] ;
[ "ShipmentOrder[0].Shipment.Shipper" ; $jsonAbsender ; JSONObject ] ;
[ "ShipmentOrder[0].Shipment.Receiver" ; $jsonEmpfänger ; JSONObject ] ;
[ "ShipmentOrder[0].Shipment.ShipmentDetails" ; $jsonVersanddetails ; JSONObject ] ;
[ "ShipmentOrder[0].LabelResponseType" ; "URL" ; JSONString ]
)]
Der erzeugte JSON-Payload wird in die Variable $payload geschrieben, die Sie im oberen Script Paketmarke erstellen als Definition der Variable $payload nutzen können.
Anpassbares FileMaker ERP mit Warenwirtschaft und Logistik-Schnittstellen.
Mehr Informationen Häufig gestellte Fragen zu FileMaker und der DHL-API
- Was ist die DHL-Schnittstelle und wie kann sie mit FileMaker integriert werden?
- Die DHL-Schnittstelle ermöglicht den automatisierten Versand von Paketdaten an DHL und den Abruf von Paketlabels und Sendungsverfolgungsdaten. In FileMaker können Sie diese Schnittstelle nutzen, um Versandprozesse zu automatisieren und Paketlabels direkt aus Ihrer Datenbank zu generieren.
- Welche Vorteile bietet die Integration der DHL-Schnittstelle in FileMaker?
- Durch die Integration können Sie Zeit sparen und Fehler vermeiden, da Versanddaten direkt aus der FileMaker-Datenbank an DHL übermittelt werden. Zudem können Sie Paketlabels automatisch generieren und die Sendungsverfolgung in Ihrem System integrieren, was die Effizienz im Versandprozess erhöht.
- Welche Informationen benötige ich, um die DHL-Schnittstelle in FileMaker zu verwenden?
- Sie benötigen Zugangsdaten für die DHL-API (Kundennummer, Benutzername, Passwort) sowie die Endpunkte der DHL-API. Diese Informationen werden von DHL bereitgestellt, nachdem Sie sich für den Zugang zur Schnittstelle registriert haben.
- Wie generiere ich Paketlabels über die DHL-Schnittstelle in FileMaker?
- Nachdem Sie die Versanddaten wie Empfängeradresse, Gewicht und Versandart in FileMaker erfasst haben, können Sie über ein API-Skript diese Informationen an die DHL-Schnittstelle senden. Im Gegenzug erhalten Sie eine Paketnummer und ein druckfähiges Label, das in FileMaker gespeichert oder direkt ausgedruckt werden kann.
- Kann ich die Sendungsverfolgung in FileMaker einbinden?
- Ja, mit der DHL-Schnittstelle können Sie die Sendungsverfolgungsnummer abrufen und in FileMaker speichern. Sie können die API nutzen, um den aktuellen Status eines Pakets in Echtzeit abzufragen und diese Informationen direkt in Ihrer Datenbank anzuzeigen.
- Ist die DHL-Schnittstelle in FileMaker nur für nationale Sendungen geeignet?
- Nein, die DHL-Schnittstelle unterstützt sowohl nationale als auch internationale Sendungen. Sie können in FileMaker je nach Versandziel und Versandart verschiedene Parameter an die DHL-API übergeben, um Labels und Versandinformationen für unterschiedliche Länder zu generieren.
- Wie sicher ist die Verwendung der DHL-API mit FileMaker?
- Die Kommunikation mit der DHL-API erfolgt über HTTPS, was eine sichere Datenübertragung gewährleistet. In FileMaker sollten Sie sicherstellen, dass sensible Daten wie API-Zugangsdaten und Kundeninformationen in verschlüsselten Feldern gespeichert und geschützt sind.
- Kann ich in FileMaker automatisierte Prozesse für die DHL-Schnittstelle erstellen?
- Ja, Sie können Skripte in FileMaker erstellen, die automatisch Versanddaten an DHL senden, Paketlabels abrufen und die Sendungsverfolgung regelmäßig aktualisieren. Diese Prozesse lassen sich auch zeitgesteuert ausführen, um eine vollständige Automatisierung der Versandabwicklung zu ermöglichen.
- Welche Anforderungen stellt DHL an die Integration der Schnittstelle in FileMaker?
- DHL verlangt, dass die API korrekt implementiert wird, einschließlich der Einhaltung der API-Spezifikationen, die in der DHL-API-Dokumentation beschrieben sind. Zudem müssen Sie sicherstellen, dass Ihre Anwendung für den produktiven Einsatz freigegeben ist, nachdem DHL die Implementierung geprüft hat.
- Was mache ich, wenn ein Problem bei der Nutzung der DHL-Schnittstelle in FileMaker auftritt?
- Wenn Probleme bei der Kommunikation mit der DHL-API auftreten, sollten Sie zuerst die Rückmeldungen der API-Anfragen in FileMaker überprüfen. Die Fehlercodes und Nachrichten von DHL geben oft detaillierte Hinweise auf das Problem. Bei fortbestehenden Schwierigkeiten können Sie den DHL-Support oder die technische Dokumentation der API zur Problemlösung konsultieren.
Zusammenfassung
Mit der Anbindung von FileMaker an die DHL REST API können Sie die Erzeugung von Paketmarken effizient automatisieren. Im folgenden die wichtigsten Schritte zusammengefasst:
- API-Zugangsdaten anfordern und konfigurieren.
- Skripte in FileMaker erstellen, um Versanddaten an DHL zu senden.
- PDF-Labels empfangen und speichern.
- Fehlerbehandlung integrieren, um API-Antworten zu überwachen.
Dieses Setup erlaubt Ihnen, den Versandprozess vollständig in FileMaker zu integrieren und Paketmarken direkt aus Ihrer Datenbank heraus zu erstellen.
Menü
Diese Seite teilen:
ERP-Software so flexibel wie Ihr Unternehmen.
Wir beraten Sie gern.
Anpassbare ERP-Software für Mac, Windows und iOS.
