Ekstra Bilgiler

Konular #

Alıcı adresi oluşturma

Alıcı adreslerini önceden oluşturursanız, tekrar girmenize gerek kalmaz ve belirli bir adrese yapılan gönderileri listeleyebilirsiniz. Aşağıda örnek alıcı adresi oluşturma isteği ve cevabını görebilirsiniz. Gönderici adresi arasındaki fark isRecipientAdress alanının doldurulması.

Örnek İstek #

Gönderi fiyat sorgulaması

Gönderi Fiyat Sorgulaması #

Gönderi oluşturmadan kargo firması bazında fiyatları çekebileceğiniz sorgudur.

Gönderi takibi

Gönderi Takibi #

Gönderi (Shipment) içindeki trackingStatus alanı, gönderinin son durumunu verir. Her kargo firması trackingNumber ve trackingUrl’yi hemen iletmeyeceği için (Şubeye teslimde alınabiliyor) Webbook kullanırsanız biz size her aşamada sorgu atarız ve oradan trackingUrl ve trackingNumber’ı alabilirsiniz.

Gönderi çoğaltma

Gönderi çoğaltma #

Daha önce oluşturduğunuz gönderinin aynısından oluşturmak için gönderi id’sini adres kısmına koyup boş bir POST isteği atmanız yeterlidir.

Örnek İstek #

Gönderi'yi iptal etmek

Gönderi iptali #

Bir gönderiyi iptal etmek için gönderi id’si ile birlikte DELETE isteği atın.

Örnek İstek #

Gönderici adresi oluşturma

Gönderi oluşturmak için gönderici adresi oluşturmanız gerekiyor. Aşağıda örnek adres oluşturma isteği ve cevabını görebilirsiniz.

Örnek İstek #

Kargo hesabı oluşturma

Kargo hesabı oluşturma #

Kendi kargo anlaşmanızdan da teklifleri almak için sisteme kullanıcı ve hesaplarınızı tanımlayabilirsiniz.

İstek #

Kargo şablonu oluşturma

Şablon oluşturma #

Kargo şablonu oluşturarak sürekli kullandığınız paket boyutlarını tek seferlik tanımlayarak kullanabilirsiniz.

İstek #

Webhook ile gönderi takibi

Webhook ile Gönderi Takibi #

Gönderi durumu değiştiğinde Geliver sizin sisteminizi çağırabilir, böylece sürekli istek yapmanıza (pull) gerek kalmaz. https://app.geliver.io/webhooks adresinde sizi çağıracağımız URL’yi eklemeniz gerekiyor.

Webhook Testi #

Webhook’unuzu test etmek için test: true ile gönderi oluşturup GELIVER_STANDART olanı kabul edin. Daha sonra Geliver gönderi sayfasında gönderiyi her açtığınızda (Sayfayı yenileyebilirsiniz) kargonun durumu bir sonraki aşamaya geçecektir. Geliver gönderi sayfasını kullanmak yerine dilerseniz shipment’a GET isteği de yapabilirsiniz durum güncellemesi için.

İade gönderisi oluşturma

İade gönderisi oluşturma #

İade gönderisi oluşturmak için gönderi id’sini adres kısmına koyup aşağıdaki gibi bir POST isteği atmanız yeterlidir.

Örnek İstek #

Sağlayıcı servis kodları
Sağlayıcı servis kodları # Kargo firmalarının herbir hizmeti için kullanabileceğiniz kodlar Kod Açıklama SURAT_STANDART Sürat kargo standart gönderi. YURTICI_STANDART Yurtiçi kargo standart gönderi. PTT_STANDART PTT kargo standart gönderi. PTT_KAPIDA_ODEME PTT kargo kapıda ödeme gönderisi. SENDEO_STANDART Sendeo standart gönderi. MNG_STANDART MNG Kargo standart gönderi. GELIVER_STANDART Test gönderisi oluştururken kullanılır.