FileMaker ve DHL API ile koli etiketleri oluşturma
FileMaker'ın DHL REST API'ye bağlanması, gönderi için koli etiketlerinin otomatik olarak oluşturulmasını sağlar. Bu adım adım kılavuzda, FileMaker çözümünüzün DHL REST API ile iletişim kurarak koli etiketlerini talep etmesi ve indirmesi için FileMaker'ı nasıl programlayacağınızı öğreneceksiniz.
DHL API, çok çeşitli gönderi ve takip süreçlerini otomatikleştirmek için kullanılabilir. Kullanıcılar, koli etiketleri (gönderi etiketleri) oluşturmanın yanı sıra kolilerinin durumunu gerçek zamanlı olarak izlemek için takibi de otomatikleştirebilir. API ayrıca müşteriler için iadeleri basitleştirmek amacıyla iade etiketlerinin oluşturulmasını da sağlar. Ayrıca, uluslararası gönderiler için gümrük beyannameleri gibi önemli gönderi belgeleri doğrudan oluşturulabilir ve gönderi sürecine entegre edilebilir. Ayrıca gönderilere öncelik verilebilir veya teslimatta nakit ödeme ya da sigorta gibi belirli gönderi seçenekleri eklenebilir. DHL API böylece tüm gönderi sürecini optimize etmek ve FileMaker gibi mevcut sistemlere tamamen entegre etmek için kapsamlı bir çözüm sunar. Bu kılavuzda, API ile koli etiketlerinin nasıl oluşturulacağını göstereceğiz.
Optimize edilmiş işletme süreçleri için CRM ve ürün yönetimine sahip dört FileMaker ERP platformu.
Bilgi talep edin
Ön Koşullar
- DHL Business Customer API'sine erişimi olan bir DHL ticari müşteri hesabı.
- DHL REST API için erişim verileri, yani API anahtarı, kullanıcı adı ve parola.
- FileMaker Pro sürüm 16 veya üstü, çünkü bu sürümler gerekli HTTP isteklerini yerel olarak destekler.
1. DHL business müşteri hesabı ve API erişimi ayarlama
DHL API'yi FileMaker'a entegre edebilmeniz için önce DHL API'ye erişmeniz gerekir:
- DHL Geliştirici Portalı sayfasına gidin: DHL Geliştirici Portalı.
- Ticari müşteri hesabınızla kaydolun.
- API erişim verilerini (API anahtarı, kullanıcı adı, parola) isteyin.
- Erişiminizi doğrulayın ve "DHL Shipping API" hizmetini etkinleştirin.
2. DHL API ile ilk adımlar
DHL API, veri göndermek ve almak için HTTP isteklerini kullanır. Koli etiketi oluşturmak için en önemli işlevler şunlardır
- Kimlik DoğrulamaKullanıcı adı ve parola ile temel kimlik doğrulama.
- Etiket oluşturma (parsel etiketi)Sevkiyat verilerini gönderin ve etiketi PDF olarak alın.
- Etiketi geri almaDönüş, FileMaker'da bir konteyner alanına kaydedilebilen ve kullanılabilen ikili PDF formatındadır.
3. DHL API'sine erişmek için FileMaker komut dosyaları
FileMaker şu komutu kullanır URL'den ekle API'ye HTTP istekleri göndermek ve yanıtları almak için cURL seçenekleriyle birlikte.
3.1 Kimlik doğrulamayı hazırlayın
DHL temel kimlik doğrulama kullanır. FileMaker'da bu, Base64 biçiminde kullanıcı adı ve parola sağlanarak gerçekleştirilir. Aşağıda kimlik doğrulamayı nasıl hazırlayabileceğinize dair bir örnek bulacaksınız:
Base64Encode("Kullanıcı Adı:Şifre")
FileMaker'da bu dizeyi doğrudan URL'den ekle-komutunu ilgili cURL seçenekleriyle birlikte kullanın.
3.2 Sevk notları oluşturma
API; gönderen adresi, alıcı adresi, ağırlık, gönderi yöntemi vb. gibi belirli bilgileri gerektirir. Aşağıda, bir etiket oluşturmak için DHL API'sine yapılan basit bir istek örneği verilmiştir.
Komut Dosyası: Koli etiketi oluşturun
- FileMaker'da kod çalışma alanı penceresini açın.
- Yeni bir komut dosyası oluşturun, örneğin "Parsel etiketi oluştur".
- Gönderim verilerini kaydetmek için aşağıdaki değişkenleri ekleyin:
Değişkeni ayarla [ $url; değer: "https://cig.dhl.de/services/production/rest/sendungsverfolgung/v2/paketmarken" ]
Değişken ayarla [ $auth; Değer: "Base64Encode(kullanıcı adı:şifre)" ]
Değişken ayarla [ $payload; Değer: "{ 'Version': '2.0', 'shipmentDetails': {...} }" ]
# Gönderi verilerini JSON biçiminde buraya ekleyin
DHL'e gönderdiğiniz JSON isteği (yük) örneği:
{
"Sürüm": "2.0",
"ShipmentOrder": [
{
"sequenceNumber": "1",
"Gönderi": {
"Gönderici": {
"İsim": "Şirketiniz",
"Adres": {
"SokakAdı": "Sokak",
"BinaNumarası": "1",
"Posta Kodu": "12345",
"Şehir": "kasaba",
"CountryCode": "DE"
}
},
"Alıcı": {
"isim": "alıcı",
"Adres": {
"SokakAdı": "Alıcı sokağı",
"BinaNumarası": "10",
"Posta Kodu": "54321",
"Şehir": "alıcı şehir",
"CountryCode": "DE"
}
},
"ShipmentDetails": {
"ProductCode": "V01PAK", # Nakliye yöntemi (örn. ulusal paket)
"WeightInKG": "2.5", # Paketin ağırlığı
"CustomerReference": "123456", # Referans numarası
"ShipmentDate": "2023-09-01"
}
},
"LabelResponseType": "URL"
}
]
}
Kullanın URL'den ekletalebi DHL'e göndermek ve etiketi oluşturmak için -komutu:
URL'den ekle [ Seçim ; Hedef: $response ; URL: $url ; cURL seçenekleri:
"-X POST --header \"Authorisation: Basic " & $auth & "\"" &
"--header \"Content-Type: application/json\"" &
"--data " & $payload ]
3.3 Etiketi indirin ve kaydedin
Oluşturulan etiket API tarafından bir PDF dosyası şeklinde döndürülür. Bunu bir FileMaker konteyner alanına kaydedebilirsiniz.
- PDF dosyasını kaydetmek için FileMaker veritabanınıza bir konteyner alanı ekleyin.
- PDF dosyası bu konteyner alanına indirilecek şekilde kodunuzu değiştirin:
URL'den ekle [ Seçim ; Hedef: Tablo::Konteyner alanı ; URL: "response-PDF-URL" ]
response-PDF-URL alanı, etiket başarıyla oluşturulduktan sonra DHL API tarafından döndürülür ve PDF'nin indirilebileceği URL'yi içerir.
FileMaker Crash Kursu
Hızlı ve etkili FileMaker
20 bölümde öğrenme.
Ücretsiz katılın
4. FileMaker ile JSON yükü oluşturun
Aşağıda, FileMaker alanlarından gelen verilerle JSON yükünü nasıl oluşturabileceğinizi gösteren bir FileMaker komut dosyası bulunmaktadır. Bu örnekte, FileMaker veritabanınızdaki alanların gönderen, alıcı ve gönderi ayrıntıları hakkında bilgiler içerdiğini varsayıyoruz ve FileMaker çözümünüzde buna göre uyarlamanız gereken ilgili alan adlarıyla tablonuzu "Table" olarak adlandırıyoruz. JSON yapısı, DHL API'ye gönderebileceğiniz yapıya karşılık gelir.
FileMaker'da örnek komut dosyası:
# JSON yapısı için değişkenleri ayarlama
Değişken ayarla [ $jsonSender; Değer: JSONSetElement ( "{}" ;
[ "İsim" ; 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 ]
)]
Değişken ayarla [ $jsonReceiver; Değer: 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 ]
)]
Değişken ayarla [ $jsonShippingDetails; Değer: JSONSetElement ( "{}" ;
[ "ProductCode" ; Table::ProductCode ; JSONString ] ;
[ "WeightInKG" ; Table::Shipping weight ; JSONNumber ] ;
[ "CustomerReference" ; Table::ReferenceNumber ; JSONString ] ;
[ "ShipmentDate" ; Table::ShipmentDate ; JSONString ]
)]
# Tüm JSON belgesinin yapısı
Değişken ayarla [ $payload; Değer: JSONSetElement ( "{}" ;
[ "Sürüm" ; "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 ]
)]
Oluşturulan JSON yükü değişkene kaydedilir $payload Bunu yukarıdaki Paket etiketi oluştur komut dosyasında $payload değişkeninin tanımı olarak kullanabilirsiniz.
Ürün yönetimi ve lojistik arayüzleri ile özelleştirilebilir FileMaker ERP.
Daha fazla bilgi FileMaker ve DHL API hakkında sık sorulan sorular
- DHL arayüzü nedir ve FileMaker ile nasıl entegre edilebilir?
- DHL arayüzü, koli verilerinin DHL'e otomatik olarak gönderilmesini ve koli etiketleri ile gönderi takip verilerinin alınmasını sağlar. FileMaker'da, gönderi süreçlerini otomatikleştirmek ve doğrudan veritabanınızdan koli etiketleri oluşturmak için bu arayüzü kullanabilirsiniz.
- DHL arayüzünü FileMaker'a entegre etmenin avantajları nelerdir?
- Entegrasyon, gönderi verileri doğrudan FileMaker veritabanından DHL'e aktarıldığı için zamandan tasarruf etmenizi ve hataları önlemenizi sağlar. Ayrıca koli etiketlerini otomatik olarak oluşturabilir ve gönderi takibini sisteminize entegre ederek gönderi sürecinde verimliliği artırabilirsiniz.
- FileMaker'da DHL arayüzünü kullanmak için hangi bilgilere ihtiyacım var?
- DHL API için erişim verilerine (müşteri numarası, kullanıcı adı, şifre) ve DHL API'nin uç noktalarına ihtiyacınız vardır. Bu bilgiler, arayüze erişim için kaydolduktan sonra DHL tarafından sağlanır.
- FileMaker'da DHL arayüzü aracılığıyla koli etiketlerini nasıl oluşturabilirim?
- FileMaker'da alıcı adresi, ağırlık ve gönderi yöntemi gibi gönderi verilerini girdikten sonra, bu bilgileri bir API komut dosyası aracılığıyla DHL arayüzüne gönderebilirsiniz. Karşılığında, FileMaker'a kaydedilebilen veya doğrudan yazdırılabilen bir koli numarası ve yazdırılabilir bir etiket alırsınız.
- Gönderi takibini FileMaker'a entegre edebilir miyim?
- Evet, DHL arayüzü ile takip numarasını alabilir ve FileMaker'a kaydedebilirsiniz. Bir paketin mevcut durumunu gerçek zamanlı olarak sorgulamak ve bu bilgileri doğrudan veritabanınızda görüntülemek için API'yi kullanabilirsiniz.
- FileMaker'daki DHL arayüzü yalnızca ulusal gönderiler için mi uygun?
- Hayır, DHL arayüzü hem ulusal hem de uluslararası gönderileri destekler. Gönderi hedefine ve gönderi türüne bağlı olarak, farklı ülkeler için etiket ve gönderi bilgileri oluşturmak amacıyla FileMaker'daki DHL API'sine çeşitli parametreler aktarabilirsiniz.
- DHL API'nin FileMaker ile kullanımı ne kadar güvenli?
- DHL API ile iletişim, güvenli veri aktarımı sağlayan HTTPS üzerinden gerçekleşir. FileMaker'da API erişim verileri ve müşteri bilgileri gibi hassas verilerin şifrelenmiş alanlarda saklandığından ve korunduğundan emin olmalısınız.
- FileMaker'da DHL arayüzü için otomatik süreçler oluşturabilir miyim?
- Evet, FileMaker'da gönderi verilerini DHL'e otomatik olarak gönderen, koli etiketlerini alan ve gönderi takibini düzenli olarak güncelleyen komut dosyaları oluşturabilirsiniz. Bu işlemler, gönderi sürecinin tam otomasyonunu sağlamak için zamanlanmış olarak da çalıştırılabilir.
- DHL'in FileMaker'da arayüz entegrasyonu için ne gibi gereksinimleri var?
- DHL, DHL API belgelerinde açıklanan API özellikleriyle uyumluluk da dahil olmak üzere API'nin doğru şekilde uygulanmasını gerektirir. Ayrıca DHL uygulamayı kontrol ettikten sonra uygulamanızın verimli kullanım için yayınlandığından emin olmalısınız.
- FileMaker'da DHL arayüzünü kullanırken bir sorun oluşursa ne yapmalıyım?
- DHL API ile iletişim kurarken sorun oluşursa, öncelikle FileMaker'daki API isteklerine verilen yanıtları kontrol etmelisiniz. DHL'den gelen hata kodları ve mesajlar genellikle sorun hakkında ayrıntılı bilgi sağlar. Sorunlar devam ederse, sorunu çözmek için DHL desteğine veya API'nin teknik belgelerine başvurabilirsiniz.
Özet
FileMaker'ı DHL REST API'sine bağlayarak koli etiketlerinin oluşturulmasını verimli bir şekilde otomatikleştirebilirsiniz. En önemli adımlar aşağıda özetlenmiştir:
- API erişim verilerini talep edin ve yapılandırın.
- DHL'e gönderi verilerini göndermek için FileMaker'da komut dosyaları oluşturun.
- PDF etiketleri alın ve kaydedin.
- API yanıtlarını izlemek için hata işlemeyi entegre edin.
Bu kurulum, gönderi sürecini FileMaker'a tamamen entegre etmenize ve doğrudan veritabanınızdan koli etiketleri oluşturmanıza olanak tanır.
