Pakketlabels maken met FileMaker en de DHL API
Let op! Dit voorbeeld is een concept dat niet gegarandeerd precies zo werkt als afgebeeld. Het artikel wordt niet regelmatig bijgewerkt en kan daarom verouderd zijn wat betreft softwareversies.
We bieden geen ondersteuning voor onze gepubliceerde voorbeelden.
De verbinding van FileMaker met de DHL REST API maakt het mogelijk pakketetiketten voor verzending automatisch aan te maken. In deze stapsgewijze handleiding leert u hoe u FileMaker zo programmeert dat uw FileMaker-oplossing communiceert met de DHL REST API om pakketlabels aan te vragen en te downloaden.
De DHL API kan worden gebruikt om een groot aantal verzend- en traceerprocessen te automatiseren. Naast het aanmaken van pakketlabels (verzendlabels), kunnen gebruikers ook tracking automatiseren om de status van hun pakketten in realtime te volgen. Met de API kunnen ook retouretiketten worden aangemaakt om retourzendingen voor klanten te vereenvoudigen. Verder kunnen belangrijke verzenddocumenten zoals douaneaangiften voor internationale zendingen direct worden aangemaakt en geïntegreerd in het verzendproces. Daarnaast kunnen zendingen voorrang krijgen of bepaalde verzendopties zoals rembours of verzekering worden toegevoegd. De DHL API biedt dus een allesomvattende oplossing om het volledige verzendproces te optimaliseren en volledig te integreren in bestaande systemen zoals FileMaker. In deze handleiding laten we u zien hoe u pakketlabels kunt maken met de API.
Vier FileMaker ERP-platforms met CRM en merchandise management voor geoptimaliseerde bedrijfsprocessen.
Informatie aanvragen
Vereisten
- Een DHL-klantenaccount met toegang tot de DHL Business Customer API.
- De toegangsgegevens voor de DHL REST API, d.w.z. API-sleutel, gebruikersnaam en wachtwoord.
- FileMaker Pro versie 16 of hoger, omdat deze versies de vereiste HTTP-verzoeken ondersteunen.
1. een DHL business klantaccount en API-toegang instellen
Voordat u de DHL API in FileMaker kunt integreren, hebt u toegang tot de DHL API nodig:
- Ga naar de DHL Developer Portal pagina: DHL Portaal voor Ontwikkelaars.
- Registreer je met je zakelijke klantenaccount.
- Vraag de API-toegangsgegevens op (API-sleutel, gebruikersnaam, wachtwoord).
- Controleer uw toegang en activeer de "DHL Shipping API" service.
2. eerste stappen met de DHL API
De DHL API maakt gebruik van HTTP-verzoeken om gegevens te verzenden en te ontvangen. De belangrijkste functies voor het maken van een pakketlabel zijn
- AuthenticatieBasisverificatie met gebruikersnaam en wachtwoord.
- Een label maken (pakketlabel)Verzend de verzendgegevens en ontvang het label als PDF.
- Het label ophalenHet rendement is in binair PDF-formaat, dat kan worden opgeslagen en gebruikt in een containerveld in FileMaker.
3. FileMaker-scripts voor toegang tot de DHL API
FileMaker gebruikt de opdracht Invoegen vanaf URL in combinatie met cURL opties om HTTP verzoeken naar de API te sturen en antwoorden te ontvangen.
3.1 Verificatie voorbereiden
DHL gebruikt basisverificatie. In FileMaker wordt dit bereikt door de gebruikersnaam en het wachtwoord in Base64-formaat op te geven. Hieronder vindt u een voorbeeld van hoe u de verificatie kunt voorbereiden:
Base64Encode("Gebruikersnaam:Wachtwoord")
In FileMaker kun je deze tekenreeks rechtstreeks in de Invoegen vanaf URL-commando met de bijbehorende cURL-opties.
3.2 Verzendnotities aanmaken
De API heeft bepaalde informatie nodig, zoals het adres van de afzender, het adres van de ontvanger, het gewicht, de verzendmethode, enz. Hieronder staat een eenvoudig voorbeeld van een verzoek aan de DHL API om een label aan te maken.
Script: Etiket pakket maken
- Open het venster met de scriptwerkruimte in FileMaker.
- Maak een nieuw script, bijvoorbeeld "Maak pakketlabel".
- Voeg de volgende variabelen toe om de verzendgegevens op te slaan:
Stel variabele [ $url; waarde: "https://cig.dhl.de/services/production/rest/sendungsverfolgung/v2/paketmarken" ]
Variabele instellen [$auth; Waarde: "Base64Encode(gebruikersnaam:wachtwoord)" ]
Variabele instellen [$payload; Waarde: "{'Versie': '2.0', 'VerzendDetails': {...} }" ]
# Voeg hier de verzendgegevens in JSON-indeling in
Voorbeeld van het JSON-verzoek (payload) dat u naar DHL stuurt:
{
"Versie": "2.0",
"ShipmentOrder": [
{
"sequenceNumber": "1",
"Verzending": {
"Verzender": {
"Naam": "Uw bedrijf",
"Adres": {
"StreetName": "Straat",
"BuildingNumber": "1",
"PostalCode": "12345",
"Stad": "town",
"CountryCode": "DE"
}
},
"Ontvanger": {
"naam": "ontvanger",
"Adres": {
"StreetName": "Straat van de ontvanger",
"BuildingNumber": "10",
"PostalCode": "54321",
"Stad": "ontvangende stad",
"CountryCode": "DE"
}
},
"ShipmentDetails": {
"ProductCode": "V01PAK", # Verzendmethode (bijv. nationaal pakket)
"GewichtInKG": "2.5", # Gewicht van het pakket
"CustomerReference": "123456", Referentienummer #
"ShipmentDate": "2023-09-01"
}
},
"LabelResponseType": "URL".
}
]
}
Gebruik de Invoegen vanaf URL-commando om de aanvraag naar DHL te sturen en het label aan te maken:
Invoegen vanuit URL [ Selectie ; Doel: $response ; URL: $url ; cURL opties:
"-X POST --header \"Autorisatie: Basis " & $auth & "\"" &
"--header \"Content-Type: application/json"" &
"--data " & $payload ]
3.3 Label downloaden en opslaan
Het gemaakte label wordt door de API teruggestuurd in de vorm van een PDF-bestand. U kunt het opslaan in een FileMaker-containerveld.
- Voeg een containerveld in uw FileMaker database in om het PDF-bestand op te slaan.
- Wijzig je script zodat het PDF-bestand in dit containerveld wordt gedownload:
Invoegen vanuit URL [ Selectie ; Doel: Tabel::Container veld ; URL: "antwoord-PDF-URL" ]
Het respons-PDF-URL veld wordt door de DHL API geretourneerd nadat het label succesvol is aangemaakt en bevat de URL waar de PDF gedownload kan worden.
FileMaker spoedcursus
Snel en effectief FileMaker
leren in 20 hoofdstukken.
Gratis deelname
4. JSON payload maken met FileMaker
Hieronder staat een FileMaker-script dat laat zien hoe u de JSON payload kunt opbouwen met gegevens uit FileMaker-velden. In dit voorbeeld gaan we ervan uit dat de velden in uw FileMaker database informatie bevatten over de afzender, ontvanger en verzendgegevens en noemen we uw tabel "Table" met de bijbehorende veldnamen, die u dienovereenkomstig moet aanpassen in uw FileMaker oplossing. De JSON-structuur komt overeen met de structuur die u naar de DHL API kunt sturen.
Voorbeeldscript in FileMaker:
# Variabelen instellen voor JSON-structuur
Variabele instellen [ $jsonSender; Waarde: JSONSetElement ( "{}" ;
[ "Naam" ; Tabel::AfzenderBedrijf ; JSONString ] ;
[ "Address.StreetName" ; Table::SenderStreet ; JSONString ] ;
[ "Address.BuildingNumber" ; Table::SenderHouseNumber ; JSONString ] ;
[ "Address.PostalCode" ; Table::SenderPLZ ; JSONString ] ;
[ "Address.City" ; Table::SenderCity ; JSONString ] ;
[ "Address.CountryCode" ; Table::SenderCountry ; JSONString ]
)]
Variabele instellen [$json-ontvanger; Waarde: JSONSetElement ( "{}" ;
[ "Naam" ; Table::RecipientName ; JSONString ] ;
[ "Address.StreetName" ; Table::RecipientStreet ; JSONString ] ;
[ "Address.BuildingNumber" ; Table::RecipientHouseNumber ; JSONString ] ;
[ "Address.PostalCode" ; Table::RecipientPLZ ; JSONString ] ;
[ "Address.City" ; Table::RecipientCity ; JSONString ] ;
[ "Address.CountryCode" ; Table::RecipientCountry ; JSONString ]
)]
Variabele instellen [$json VerzendingDetails; Waarde: JSONSetElement ( "{}" ;
[ "ProductCode" ; Table::ProductCode ; JSONString ] ;
[ "GewichtInKG" ; Tabel::Verzendgewicht ; JSONNummer ] ;
[ "CustomerReference" ; Table::ReferenceNumber ; JSONString ] ;
[ "ShipmentDate" ; Table::ShipmentDate ; JSONString ]
)]
# Structuur van het volledige JSON-document
Variabele instellen [$payload; Waarde: JSONSetElement ( "{}" ;
[Versie" ; "2.0" ; JSONString ] ;
[ "ShipmentOrder[0].sequenceNumber" ; "1" ; JSONString ] ;
[ "ShipmentOrder[0].Shipment.Shipper" ; $jsonSender ; JSONObject ] ;
[ "ShipmentOrder[0].Shipment.Receiver" ; $jsonEmpfänger ; JSONObject ] ;
[ "ShipmentOrder[0].Shipment.ShipmentDetails" ; $jsonVersanddetails ; JSONObject ] ;
["ShipmentOrder[0].LabelResponseType" ;"URL" ; JSONString ]
)]
De gegenereerde JSON payload wordt opgeslagen in de variabele $lading die u kunt gebruiken als de definitie van de variabele $payload in het script Package label maken hierboven.
Aanpasbare FileMaker ERP met interfaces voor goederenbeheer en logistiek.
Meer informatie Veelgestelde vragen over FileMaker en de DHL API
- Wat is de DHL-interface en hoe kan deze worden geïntegreerd met FileMaker?
- Met de interface van DHL kunnen pakketgegevens automatisch naar DHL worden verzonden en kunnen pakketlabels en traceergegevens worden opgehaald. In FileMaker kunt u deze interface gebruiken om verzendprocessen te automatiseren en pakketlabels rechtstreeks vanuit uw database te genereren.
- Wat zijn de voordelen van de integratie van de DHL-interface in FileMaker?
- Dankzij de integratie kunt u tijd besparen en fouten vermijden, omdat de verzendgegevens rechtstreeks van de FileMaker-database naar DHL worden overgedragen. U kunt ook automatisch pakketlabels genereren en het traceren van zendingen in uw systeem integreren, wat het verzendproces efficiënter maakt.
- Welke informatie heb ik nodig om de DHL-interface in FileMaker te gebruiken?
- U hebt de toegangsgegevens voor de DHL API nodig (klantnummer, gebruikersnaam, wachtwoord), evenals de eindpunten van de DHL API. Deze informatie wordt door DHL verstrekt nadat u zich heeft geregistreerd voor toegang tot de interface.
- Hoe genereer ik pakketlabels via de DHL-interface in FileMaker?
- Zodra u de verzendgegevens, zoals het adres van de ontvanger, het gewicht en de verzendmethode, in FileMaker hebt ingevoerd, kunt u deze informatie via een API-script naar de interface van DHL sturen. In ruil daarvoor ontvangt u een pakketnummer en een afdrukbaar etiket dat u in FileMaker kunt opslaan of rechtstreeks kunt afdrukken.
- Kan ik het traceren van zendingen integreren in FileMaker?
- Ja, met de interface van DHL kunt u het trackingnummer ophalen en opslaan in FileMaker. U kunt de API gebruiken om de huidige status van een pakket in realtime op te vragen en deze informatie rechtstreeks in uw database weer te geven.
- Is de DHL-interface in FileMaker alleen geschikt voor nationale zendingen?
- Nee, de interface van DHL ondersteunt zowel nationale als internationale zendingen. U kunt verschillende parameters naar de DHL API in FileMaker sturen, afhankelijk van de verzendbestemming en het type verzending, om etiketten en verzendgegevens voor verschillende landen te genereren.
- Hoe veilig is het gebruik van de DHL API met FileMaker?
- De communicatie met de DHL API verloopt via HTTPS, wat een veilige gegevensoverdracht garandeert. In FileMaker moet u ervoor zorgen dat gevoelige gegevens, zoals API-toegangsgegevens en klantgegevens, worden opgeslagen en beschermd in versleutelde velden.
- Kan ik geautomatiseerde processen maken voor de DHL-interface in FileMaker?
- Ja, u kunt in FileMaker scripts maken om automatisch verzendgegevens naar DHL te sturen, pakketlabels op te halen en regelmatig de zending te volgen. Deze processen kunnen ook op geplande basis worden uitgevoerd om het verzendproces volledig te automatiseren.
- Welke eisen stelt DHL aan de integratie van de interface in FileMaker?
- DHL eist dat de API correct wordt geïmplementeerd, inclusief naleving van de API-specificaties die in de DHL API-documentatie worden beschreven. U moet er ook voor zorgen dat uw applicatie wordt vrijgegeven voor productief gebruik nadat DHL de implementatie heeft gecontroleerd.
- Wat moet ik doen als er een probleem optreedt bij het gebruik van de DHL-interface in FileMaker?
- Als er problemen optreden bij de communicatie met de DHL API, moet u eerst de antwoorden op de API-verzoeken in FileMaker controleren. De foutcodes en berichten van DHL geven vaak gedetailleerde informatie over het probleem. Als de problemen aanhouden, kunt u de ondersteuning van DHL of de technische documentatie van de API raadplegen om het probleem op te lossen.
Samenvatting
Door FileMaker te koppelen aan de DHL REST API kunt u het aanmaken van pakketlabels efficiënt automatiseren. Hieronder vindt u een overzicht van de belangrijkste stappen:
- API-toegangsgegevens aanvragen en configureren.
- Scripts maken in FileMaker om verzendgegevens naar DHL te sturen.
- PDF-labels ontvangen en opslaan.
- Integreer foutafhandeling om API-reacties te controleren.
Met deze opzet kunt u het verzendproces volledig in FileMaker integreren en pakketetiketten rechtstreeks vanuit uw database maken.
