Vytváření štítků na balíky pomocí aplikace FileMaker a rozhraní DHL API
Propojení aplikace FileMaker s rozhraním REST API společnosti DHL umožňuje automatizované vytváření štítků na balíky pro přepravu. V tomto průvodci se krok za krokem dozvíte, jak naprogramovat FileMaker tak, aby vaše řešení FileMaker komunikovalo s rozhraním DHL REST API a mohlo požadovat a stahovat štítky na balíky.
Rozhraní API společnosti DHL lze použít k automatizaci celé řady procesů přepravy a sledování. Kromě vytváření štítků na zásilky (přepravních štítků) mohou uživatelé také automatizovat sledování a sledovat tak stav svých zásilek v reálném čase. Rozhraní API rovněž umožňuje vytvářet štítky pro vracení zásilek, které zákazníkům zjednodušují jejich vracení. Kromě toho lze přímo vytvářet důležité přepravní dokumenty, jako jsou celní prohlášení pro mezinárodní zásilky, a integrovat je do procesu přepravy. Kromě toho lze zásilky upřednostnit nebo přidat určité možnosti přepravy, jako je dobírka nebo pojištění. DHL API tak nabízí komplexní řešení pro optimalizaci celého procesu přepravy a jeho plnou integraci do stávajících systémů, jako je například FileMaker. V tomto průvodci vám ukážeme, jak pomocí rozhraní API vytvářet štítky na balíky.
Čtyři platformy FileMaker ERP s CRM a správou zboží pro optimalizaci provozních procesů.
Vyžádat si informace
Předpoklady
- Účet firemního zákazníka DHL s přístupem k rozhraní API pro firemní zákazníky DHL.
- Přístupové údaje pro rozhraní DHL REST API, tj. klíč API, uživatelské jméno a heslo.
- FileMaker Pro verze 16 nebo vyšší, protože tyto verze nativně podporují požadované požadavky HTTP.
1. zřízení účtu firemního zákazníka DHL a přístupu k rozhraní API
Před integrací rozhraní DHL API do aplikace FileMaker potřebujete přístup k rozhraní DHL API:
- Přejděte na stránku portálu DHL Developer Portal: Portál pro vývojáře DHL.
- Zaregistrujte se pomocí účtu firemního zákazníka.
- Vyžádání přístupových údajů API (klíč API, uživatelské jméno, heslo).
- Ověřte svůj přístup a aktivujte službu "DHL Shipping API".
2. první kroky s rozhraním DHL API
Rozhraní DHL API používá k odesílání a přijímání dat požadavky HTTP. Nejdůležitějšími funkcemi pro vytvoření štítku zásilky jsou
- OvěřováníZákladní ověření pomocí uživatelského jména a hesla.
- Vytvoření štítku (štítek parcely)Odeslání údajů o odeslání a přijetí štítku ve formátu PDF.
- Získání štítkuNávratová zpráva je v binárním formátu PDF, který lze uložit a použít v kontejnerovém poli v aplikaci FileMaker.
3. Skripty FileMakeru pro přístup k rozhraní DHL API
FileMaker používá příkaz Vložení z adresy URL v kombinaci s možnostmi cURL k odesílání požadavků HTTP na rozhraní API a přijímání odpovědí.
3.1 Příprava ověřování
Společnost DHL používá základní ověřování. Ve FileMakeru se toho dosáhne zadáním uživatelského jména a hesla ve formátu Base64. Níže naleznete příklad, jak lze ověření připravit:
Base64Encode("Uživatelské jméno:Heslo")
V aplikaci FileMaker můžete tento řetězec zadat přímo do pole Vložení z adresy URL-příkaz s odpovídajícími možnostmi cURL.
3.2 Vytvoření poznámek k expedici
API vyžaduje určité informace, jako je adresa odesílatele, adresa příjemce, hmotnost, způsob dopravy atd. Níže je uveden jednoduchý příklad požadavku na rozhraní DHL API pro vytvoření štítku.
Scénář: Vytvoření štítku na zásilku
- Otevřete okno pracovní plochy skriptu v aplikaci FileMaker.
- Vytvořte nový skript, např. "Vytvořit štítek parcely".
- Přidejte následující proměnné pro uložení dat odeslání:
Nastavit proměnnou [ $url; hodnota: "https://cig.dhl.de/services/production/rest/sendungsverfolgung/v2/paketmarken" ]
Nastavení proměnné [ $auth; Hodnota: "Base64Encode(uživatelské jméno:heslo)" ]
Nastavení proměnné [ $payload; Hodnota: "{ 'Version': '2.0', 'shipmentDetails': {...} }" ]
# Zde vložte přepravní údaje ve formátu JSON
Příklad požadavku JSON (payload), který se odesílá společnosti DHL:
{
"Verze": "2.0",
"ShipmentOrder": [
{
"sequenceNumber": "1",
"Shipment": {
"Shipper": {
"Název": "Vaše společnost",
"Adresa": {
"StreetName": "Street",
"BuildingNumber": "1",
"PostalCode": "12345",
"Město": "town",
"CountryCode": "DE"
}
},
"Receiver": {
"jméno": "příjemce",
"Adresa": {
"StreetName": "Ulice příjemce",
"BuildingNumber": "10",
"PostalCode": "54321",
"Město": "město příjemce",
"CountryCode": "DE"
}
},
"ShipmentDetails": {
"ProductCode": "V01PAK", # Způsob dopravy (např. vnitrostátní zásilka)
"WeightInKG": "2.5", # Hmotnost balení
"CustomerReference": "123456", # Referenční číslo
"ShipmentDate": "2023-09-01"
}
},
"LabelResponseType": "URL"
}
]
}
Použijte Vložení z adresy URL-příkaz pro odeslání požadavku společnosti DHL a vytvoření štítku:
Vložit z adresy URL [ Výběr ; Cíl: $response ; Adresa URL: $url ; cURL options:
"-X POST --header \"Authorisation: Basic " & $auth & "\"" &
"--header \"Content-Type: application/json\" &
"--data " & $payload ]
3.3 Stažení a uložení štítku
Vytvořený štítek je rozhraním API vrácen ve formě souboru PDF. Můžete jej uložit do pole kontejneru FileMaker.
- Vložte do databáze FileMakeru pole kontejneru pro uložení souboru PDF.
- Změňte skript tak, aby se soubor PDF stahoval do tohoto pole kontejneru:
Vložit z adresy URL [ Výběr ; Cíl: Pole Table::Container ; Adresa URL: "response-PDF-URL" ]
Pole response-PDF-URL je vráceno rozhraním DHL API po úspěšném vytvoření štítku a obsahuje adresu URL, na které lze stáhnout soubor PDF.
Rychlokurz FileMakeru
Rychlý a efektivní FileMaker
učení ve 20 kapitolách.
Zúčastněte se zdarma
4. vytvoření užitečného zatížení JSON pomocí aplikace FileMaker
Níže je uveden skript FileMakeru, který ukazuje, jak lze sestavit užitečné zatížení JSON s daty z polí FileMakeru. V tomto příkladu předpokládáme, že pole ve vaší databázi FileMaker obsahují informace o odesílateli, příjemci a údaje o přepravě, a tabulku nazveme "Table" s odpovídajícími názvy polí, které musíte ve svém řešení FileMaker odpovídajícím způsobem upravit. Struktura JSON odpovídá struktuře, kterou můžete odeslat do rozhraní DHL API.
Příklad skriptu v aplikaci FileMaker:
# Nastavení proměnných pro strukturu JSON
Nastavení proměnné [ $jsonSender; Hodnota: JSONSetElement ("{}" ;
[ "Name" ; Table::SenderCompany ; 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 ]
)]
Nastavení proměnné [ $jsonReceiver; Hodnota: JSONSetElement ("{}" ;
[ "Name" ; 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 ]
)]
Nastavení proměnné [ $jsonShippingDetails; Hodnota: JSONSetElement ("{}" ;
[ "ProductCode" ; Table::ProductCode ; JSONString ] ;
[ "WeightInKG" ; Table::Shipping weight ; JSONNumber ] ;
[ "CustomerReference" ; Table::ReferenceNumber ; JSONString ] ;
[ "ShipmentDate" ; Table::ShipmentDate ; JSONString ]
)]
# Struktura celého dokumentu JSON
Nastavení proměnné [ $payload; Hodnota: JSONSetElement ("{}" ;
[ "Version" ; "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 ]
)]
Vygenerované užitečné zatížení JSON se uloží do proměnné $payload kterou můžete použít jako definici proměnné $payload ve výše uvedeném skriptu Vytvořit štítek balíčku.
Přizpůsobitelný systém FileMaker ERP s rozhraními pro správu zboží a logistiku.
Více informací Často kladené otázky o FileMakeru a rozhraní DHL API
- Co je to rozhraní DHL a jak jej lze integrovat do aplikace FileMaker?
- Rozhraní DHL umožňuje automatizované odesílání dat o zásilkách do společnosti DHL a načítání štítků na zásilky a údajů o sledování zásilek. V aplikaci FileMaker můžete toto rozhraní použít k automatizaci procesů odesílání zásilek a generování balíkových štítků přímo z databáze.
- Jaké jsou výhody integrace rozhraní DHL do aplikace FileMaker?
- Integrace umožňuje ušetřit čas a vyhnout se chybám, protože přepravní údaje se přenášejí přímo z databáze FileMakeru do společnosti DHL. Můžete také automaticky generovat štítky na zásilky a integrovat do systému sledování zásilek, což zvyšuje efektivitu procesu přepravy.
- Jaké informace potřebuji k použití rozhraní DHL v aplikaci FileMaker?
- Potřebujete přístupové údaje k rozhraní DHL API (číslo zákazníka, uživatelské jméno, heslo) a koncové body rozhraní DHL API. Tyto informace vám poskytne společnost DHL po registraci pro přístup k rozhraní.
- Jak vygeneruji štítky na balíky prostřednictvím rozhraní DHL v aplikaci FileMaker?
- Po zadání přepravních údajů, jako je adresa příjemce, hmotnost a způsob přepravy, do aplikace FileMaker můžete tyto informace odeslat do rozhraní DHL prostřednictvím skriptu API. Na oplátku obdržíte číslo zásilky a štítek k vytištění, který lze uložit v aplikaci FileMaker nebo přímo vytisknout.
- Lze integrovat sledování zásilek do aplikace FileMaker?
- Ano, pomocí rozhraní DHL můžete získat sledovací číslo a uložit je do aplikace FileMaker. Pomocí rozhraní API se můžete dotazovat na aktuální stav zásilky v reálném čase a zobrazit tyto informace přímo v databázi.
- Je rozhraní DHL v aplikaci FileMaker vhodné pouze pro vnitrostátní zásilky?
- Ne, rozhraní DHL podporuje vnitrostátní i mezinárodní zásilky. V závislosti na cíli a typu přepravy můžete do rozhraní DHL API v aplikaci FileMaker přenést různé parametry, abyste mohli generovat štítky a informace o přepravě pro různé země.
- Jak bezpečné je použití rozhraní API DHL ve FileMakeru?
- Komunikace s rozhraním API DHL probíhá prostřednictvím protokolu HTTPS, který zajišťuje bezpečný přenos dat. V aplikaci FileMaker byste měli zajistit, aby citlivé údaje, jako jsou přístupové údaje k rozhraní API a informace o zákaznících, byly uloženy a chráněny v šifrovaných polích.
- Mohu v aplikaci FileMaker vytvořit automatizované procesy pro rozhraní DHL?
- Ano, v aplikaci FileMaker můžete vytvořit skripty, které automaticky odesílají přepravní údaje společnosti DHL, načítají štítky s balíky a pravidelně aktualizují sledování zásilek. Tyto procesy lze také spouštět podle plánu a umožnit tak úplnou automatizaci procesu odesílání.
- Jaké požadavky má společnost DHL na integraci rozhraní v aplikaci FileMaker?
- Společnost DHL vyžaduje, aby bylo rozhraní API správně implementováno, včetně souladu se specifikacemi rozhraní API popsanými v dokumentaci rozhraní API společnosti DHL. Musíte také zajistit, aby vaše aplikace byla uvolněna k produktivnímu používání poté, co společnost DHL zkontroluje implementaci.
- Co mám dělat, když se při používání rozhraní DHL v aplikaci FileMaker vyskytne problém?
- Pokud se při komunikaci s rozhraním API společnosti DHL vyskytnou problémy, měli byste nejprve zkontrolovat odpovědi na požadavky rozhraní API v aplikaci FileMaker. Chybové kódy a zprávy od DHL často poskytují podrobné informace o problému. Pokud potíže přetrvávají, můžete se při řešení problému obrátit na podporu DHL nebo na technickou dokumentaci rozhraní API.
Souhrn
Připojením aplikace FileMaker k rozhraní REST API společnosti DHL můžete efektivně automatizovat vytváření štítků na balíky. Níže jsou shrnuty nejdůležitější kroky:
- Vyžádání a konfigurace přístupových údajů API.
- Vytvoření skriptů v aplikaci FileMaker pro odesílání přepravních dat společnosti DHL.
- Přijímání a ukládání štítků PDF.
- Integrace zpracování chyb pro sledování odpovědí rozhraní API.
Toto nastavení umožňuje plně integrovat proces přepravy do aplikace FileMaker a vytvářet štítky na balíky přímo z databáze.
