EasyCargo API mini serimizin son bölümüne hoş geldiniz! Bugün adım adım planlama sürecine odaklanacağız. Size, API’nin lojistik süreçlerini kullanıcı hesabı ayarlarından, yükleme alanlarının tayin edilmesine ve rapor oluşturmaya nasıl kolaylaştırdığını göstereceğiz. Kısacası EasyCargo API yardımıyla süreçlerinizi nasıl optimum hale getirebileceğinizi öğrenmek istiyorsanız, doğru yere geldiniz!

Başlamadan önce bu serinin önceki bölümlerini okumanızı tavsiye ederiz:

• Teorik API kılavuzu – bilmeniz gereken tüm temel bilgiler ve terimler
• Pratik API istekleri ve test kılavuzu – API istemcisi nasıl ayarlanır, ReqBin vasıtasıyla nasıl test yapılır

Bu temel bilgileri öğrendiyseniz devam edebiliriz!

Kademe kademe yükleme planlama sürecine odaklanacağız.

Aşağıdaki API isteklerini kullanmak için istek başlığına bir kimlik doğrulama belirteci eklemeniz gerekecektir. Ayrıntılı kimlik doğrulama adımlarını önceki makalemizde bulabilirsiniz. Kimlik doğrulama belirteci almak için API anahtarınızın kullanıcı hesabınızla eşleşmiş olmalıdır. Anahtar için destek ekibimizle irtibat kurun. Kimlik doğrulama belirteçleri sadece 1,5 saat geçerlidir. Bu sürenin dolmasından sonra geçerliliklerini yitirirler ve artık kullanmazsınız.

Kullanıcı erişimi ayarları

Kargo planlama sürecindeki ilk ve en önemli adımlardan biri, örneğin depo çalışanları için kullanıcı hesabı oluşturmaktır. Spesifik izinlere sahip yeni bir kullanıcı oluşturmak için /api/v1/users adresini kullanın. Aşağıdaki API isteğinde göreceğiniz gibi, yeni kullanıcı hakkında bazı bilgiler vermek şarttır. Doğru şekilde yapıldığında, yeni kullanıcı derhal EasyCargo uygulamasında Kullanıcılar sekmesi altında görüntülenir.

Aşağıdaki kodda /api/v1/users adresine hesabını oluşturduğunuz kullanıcının ayrıntılarını içeren bir istek görüyorsunuz. İsim, soyadı, hesaba giriş yapılan e-posta adresi ve kullanıcı türünü girmek gereklidir. Kullanıcı türü Yönetici (istek gövdesinde 1 rakamı ile temsil edilir) veya Sıradan Kullanıcı (2 rakamı ile temsil edilir) olabilir.

API istek şablonunun tamamına bakın: https://reqbin.com/duacb1ye

Kargo alanlarının tanımlanması

Yükleme yapmaya başlamadan önce nereye yükleme yapılacağını belirlemeniz gereklidir. /api/v1/cargospaces adresi, çeşitli konteyner türleri tanımlamayı mümkün kılar. Her alan, boy, en, yükseklik ve azami kargo bilgilerini içermelidir. Şimdilik sadece konteynerler desteklenmektedir, ancak başka seçenekler üzerinde çalışıyoruz. Konteyner, tanımlandıktan sonra EasyCargo arayüzünde görüntülenir, böylelikle her şeyi doğru yaptığınızı teyit etmiş olursunuz. Bu şekilde oluşturduğunuz konteyneri hemen kargo planlama için kullanmaya başlayabilirsiniz.

Aşağıdaki kodda /api/v1/cargospaces adresine oluşturmak istediğiniz konteynerin ayrıntılarını içeren bir istek göndereceğiz. İsim, en, boy, uzunluk ve azami ağırlığı girin. Ardından, ölçüm sistemini (metrik için 1 ve emperyal için 2) ve kargo alanı türünü seçin. Bu veri, konteyneri temsil eden 1 olarak ön seçimlidir.

API istek şablonunun tamamına bakın: https://reqbin.com/8ieqp8ey

Kargo öğelerinin yönetimi

Kargo alanlarını belirledikten sonra, münferit öğeleri ekleme vakti gelmiştir. /api/v1/shipment-inputs adresi vasıtasıyla her öğenin ebatlarını, ağırlığını ve kısıtlamalarını belirtin. Peşinden, yüklenen tüm öğeleri ve özelliklerini görüntüleyen EasyCargo arayüzü vasıtasıyla kargonun başarılı bir şekilde oluşturulduğunu görsel olarak onaylayabilirsiniz.

Aşağıdaki kodda, tek bir türden 82 adet öğe içeren yeni bir kargoyu

/api/v1/shipment-inputs adresi yardımıyla oluşturuyoruz. İstek gövdesinde kargo ismini, ölçüm sistemini ve öğeyi belirtiyoruz. Öğelerin ebatları ve kısıtlamaları tanımlanabilir. Bu örnekte, öğeleri, buzdolaplarını göndermek istediğimiz şehir olan Berlin adındaki bir öncelik grubunun içerisinde oluşturuyoruz. Serbestçe döndürmeye ve istiflemeye izin vereceğiz. Güncel olarak maalesef API üzerinden öğelerin rengini değiştirmek ya da kutularda ilgili öğenin adının gösterilip gösterilmeyeceğini belirlemek mümkün değildir.

API istek şablonunun tamamına bakın: https://reqbin.com/ozixloob

Optimum kargo planı oluşturma

Kargo detaylarını ayarladıktan sonra, kargo planını oluşturmaya geçebiliriz. EasyCargo sistemi, eşit yük dağılımı, yükleme sırası ve sevkiyat gereksinimlerini göz önünde bulundurarak kargonun en verimli yerleşim şeklini otomatik olarak hesaplar. API henüz optimizasyonu kendi başına yapamasa da, EasyCargo uygulamasında Yükle (Load) butonuna tıklamanız yeterlidir ve sistem sizin için her şeyi hesaplayacaktır! Optimizasyonu yaptıktan sonra kargoyu manuel olarak düzenleme imkânınız vardır. Böylelikle nihai plan tüm spesifik taleplerinizi yerine getirecektir.

Kargo planı raporu oluşturma

Kargo tamamlandığında, yükün yerleşimi ve 3D görselleştirme içeren ayrıntılı bir rapor oluşturabilirsiniz. /api/v1/shipment-reports/{id} adresi meslektaşlarınız ve ortaklarınızla kolay paylaşım için PDF formatında bir rapor sunar. Bakalım kargo planı nasıl görünüyor?

Aşağıdaki kodda, kargo ayrıntılarının /api/v1/shipment-report/{id} adresi vasıtasıyla nasıl elde edildiğini görebilirsiniz. Önce /api/v1/shipments adresine GET isteği gönderilerek rapor ID kodu alınır. Gelen cevaptan bu ID kodu alınarak bir sonraki isteğin URL adresine eklenir (/api/v1/shipment-report/{id}). Cevap, yazdırılmaya hazır PDF formatında aşağıdaki resimde gördüğünüz tüm ayrıntıları içerir.

API istek şablonunun tamamına bakın: https://reqbin.com/ust8mrq2

Paylaşım ve İşbirliği

Kargo planını ekibiniz veya ortaklarınızla mı paylaşmak istiyorsunuz? /api/v1/shipments adresi, interaktif 3D görselleştirme dahil, kargo hakkında tüm bilgileri sunar. EasyCargo’da kargonun linkini açın ve öğelerin nihai konumunu inceleyin.

Aşağıdaki kodda, daha önce oluşturduğunuz kargonun ayrıntılarına /api/v1/shipments/{id} adresi vasıtasıyla nasıl ulaşıldığını görebilirsiniz. Sevkiyat ID kodunu istiyorsanız, önce /api/v1/shipments adresine GET isteği gönderin. Kargo ID’yi öğrendikten sonra, kargo detaylarını almak için /api/v1/shipments/{id} adresine bir GET isteği gönderin; bunlara herkese açık link, rapor linki ve aşağıda belirtilen diğer bilgiler bulunur.

API istek şablonunun tamamına bakın: https://reqbin.com/y5p3zysj

EasyCargo API, iyi tasarlanmış arayüzlerin karmaşık lojistik operasyonlarını nasıl hızlandırabileceğinin bir örneğidir. Otomasyon ve akıllı algoritmalar aracılığıyla yüklemenin verimli bir şekilde planlanmasını ve yönetilmesini sağlar. Kolay entegrasyon sayesinde API’yi lojistik süreçlerinizi optimize etmek ve daha kolay planlama için kapsamlı raporlar elde etmek amacıyla kullanabilirsiniz. İster yeni başlıyor olun ister deneyimli bir geliştirici olun, API arayüzleriyle entegrasyon olanakları geniştir. EasyCargo’nun firmanıza entegrasyonu hakkında kişisel danışmanlık için bizimle iletişime geçin. Birlikte sizin için en iyi çözümü bulacağız!