Geliver API

Giriş #

Geliver API nedir? #

Hızlı ve zahmetsiz bir şekilde, birden fazla kargo firmasına entegrasyon yapabildiğiniz API’dir. Geliver kargo entegrasyon api’si ile;

  • Kargo firmalarından fiyat teklifi alabilir
  • En hızlı, en ucuz veya en uygun teklif kırılımlarını görebilir
  • Teklifi satın alıp, etiketi bastırabilirsiniz.

Yapı #

Geliver API, Open API Specification’una uygun Restful şekilde tasarlanmıştır. Temelde, Gönderi yaratma ve etiket satın alma işlevlerine ek olarak gönderici adresi yönetimi, kargo sağlayıcı hesabı yönetimi, şirket (organizasyon) hesapları yönetimi ve izinleri içerir.

Authentication #

Authentication (kullanıcı belirtme) ve authorization (yetkilendirme), her istekteki Authorization header’ından alınır. Buraya paneldeki API Tokenları bölümünden alacağınız token’ı önünde Bearer yazacak şekilde ekleyin.

Örnek # 

Authorization: Bearer cb611162-541f-4fb3-a353-586e2013fb31

Döküman hakkında #

Bu döküman, Geliver API’sini nasıl çağıracağınızı örneklerle açıklayarak, parametre bilgilerini ve hata kodlarını verir. Tüm isteklere ve detaylı çağrı şekillerini API Referans dökümanında bulabilirsiniz.

Detaylı API Referans dökümanına buraya tıklayarak ulaşabilirsiniz.

Nasıl çalıştırılır? #

Kargo barkodu oluşturmak için 2 yol bulunmakta.

Gönderi oluşturma ve teklif seçerek kabul etme #

1- Gönderi oluşturma isteğini kullanarak gönderici ve alıcı adresleriyle gönderi oluşturmalısınız. Kargo boyutları ve ağırlığını da belirtebilirsiniz. Bu istek ile birlikte kargo firmalarından teklifleri de alacaksınız. Eğer gönderi boyutlarını ve ağırlını daha sonra değiştirmek isterseniz Gönderi günceleme yapabilirsiniz.

2- Teklifi kabul etme ile bir önceki Gönderi oluşturma isteği ile oluşturulan gönderi için verilen tekliflerden birisini kabul edip kargo barkodu ve etiketi oluşturabilirsiniz.

Belirli bir kargo firmasından etiketi tek seferde alma #

Eğer hangi kargo firmasından barkod alacağınızı biliyorsanız teklif istemeden tek seferde ilgili kargo firmasından etiketinizi satın alabilirsiniz. Seçtiğiniz kargo firmasından etiketi tek seferde alma bölümüne bakın.

Ekstra ayarlar #

Bu aşamalar opsiyoneldir, işinizi kolaylaştırmak için kullanabilirsiniz.

  • Sistemi kullanmadan adresleri (gönderici ve alıcı) kayıt edebilirsiniz. Böylece adreslere göre filtrelemeleri kolayca yapabilirsiniz. Adres oluşturma adımı ile yapabilirsiniz.

  • Parsel şablonları oluşturursanız, her gönderi oluşturma isteğinde paket boyutu ve/veya ağırlığı girmeniz gerekmez.

  • Kargo hesabınızı eklerseniz, kendi kargo anlaşmanız üzerinden fiyat tekliflerini de alabilirsiniz.