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 her bir 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. HEPSIJET_STANDART hepsiJET Kargo standart gönderi. GELIVER_STANDART Test gönderisi oluştururken kullanılır.