🇬🇪 QuickShipper: OAuth istemcisi ve Gürcistan'daki kuryeleri seçme
QuickShipper, Gürcistan'da kendi filosunu ve bağlı yerel hizmetleri bir araya getiren teslimat platformudur. Tek kartla müşteri sipariş oluştururken her birinin fiyatı ve süresi belirtilen birkaç kurye seçeneği görür.
Nereden ayarlanır? Yönetim paneli → “Gönderiler” → “Teslimat hizmetleri” düğmesi (veya şube kartı → WEB → “Teslimat hizmetleri”).
Gerekenler#
- Test ortamı için test.quickshipper.ge test hesabının kullanıcı adı ve parolası; herkes kayıt olabilir, anahtar gerekmez.
- Canlı ortam için Delivery API OAuth istemcisi: Client ID ve Client secret; hizmet tarafından talep üzerine verilir, panelden kendiniz oluşturamazsınız.
- Kuryenin siparişleri alacağı noktanın adresi, şehri, koordinatları ve telefonu.
Test ortamı: test hesabı#
- test.quickshipper.ge üzerinde kayıt olun.
- Kuryeleri bağlayın: Parameters → Integration → Activation of courier services. Deneme için “Add your own delivery type” düğmesi yeterlidir; ad ve fiyatla kendi teslimat türünüzü oluşturur. Bağlı kurye yoksa tarife görünmez.
- Bu hesabın kullanıcı adı ve parolasını hizmet kartına girin; Client ID'yi boş bırakın. QuickShipper'ın test Delivery API istemcisi ortaktır ve belgelerinde yayımlanmıştır.
Canlı ortam: hizmetten anahtar alma#
- qshpr.com üzerinde işletme hesabı açın.
- info@qshpr.com adresine “İnternet mağazası entegrasyonu için Delivery API erişimi rica ediyorum” yazıp hesabın e-posta adresini belirtin.
- Hizmet Client ID ve Client secret'ı, bazen kullanıcı adıyla giriş için kullanıcı adı ve parolayı da gönderir; entegrasyonun kabul kontrolünü yapar.
Hizmet kartına girilecek bilgiler#
| Alan | Girilecek bilgi |
|---|---|
| Hesabın kullanıcı adı ve parolası | Test ortamında test.quickshipper.ge bilgileri yeterlidir; canlı ortamda yalnızca hizmet kullanıcı adıyla erişim verdiyse |
| Client ID | Yalnızca canlı ortam için: hizmetin e-postasındaki OAuth istemci kimliği |
| Client secret | Yalnızca canlı ortam için: e-postadaki istemci sırrı |
| Ortam | Hizmetin kabulünden önce “Test ortamı”, sonra “Canlı” |
| Gönderici adresi ve şehri | Kuryenin paketleri alacağı yer |
| Gönderici koordinatları | Alım noktasının enlem ve boylamı, örneğin 41.7151, 44.8271; QuickShipper fiyatı mesafeye göre hesaplar |
| Gönderici adı ve telefonu | Kuryenin iletişim kuracağı kişi; telefon +995… biçiminde |
| Sağlayıcıları sınırla | İsteğe bağlı: virgülle ayrılmış QuickShipper sağlayıcı numaraları; boşsa bağlı sağlayıcıların tümü |
Kontrol#
- “Kaydet” düğmesine basın.
- “Bağlantıyı test et” düğmesine basın; kartın altında sağlayıcı tarifeleri görünür. “Simülasyon modu” yazısı, anahtarların bağlanmadığını ve tarifelerin örnek olduğunu belirtir.
- “QuickShipper'ı etkinleştir” seçeneğini işaretleyin.
Test ve canlı ortam#
- Anahtarsız kart örnek tarifeleri gösterir.
- “Test ortamı” QuickShipper test sunucusunun gerçek yanıtlarını kullanır. Müşteri bu tarifeleri görmez, siparişten gönderi belgesi oluşturulmaz; test siparişini kimse taşımaz.
- “Canlı” ortamı, hizmet entegrasyonun kabul kontrolünden geçtiğini onaylayınca açın. Bu andan itibaren QuickShipper tarifeleri müşterinin sipariş ekranında görünür ve sipariş kartından gönderi belgesi oluşturulur.
Sık karşılaşılan sorunlar#
- E-postaya yanıt gelmedi — tekrar yazın veya QuickShipper desteğini arayın; API erişimi elle verilir.
- “Bağlantıyı test et” kimlik doğrulama hatası veriyor — anahtarların verildiği ortamın seçili olduğunu kontrol edin. Test hesabı canlı ortamda, canlı anahtarlar test ortamında çalışmaz.
invalid_grant — Invalid password, hesap parolasının yanlış olduğunu belirtir. - Tarife yok — QuickShipper hesabına kurye bağlanmamış (“Activation of courier services”), alım noktasının koordinatları girilmemiş veya müşteri adresi sağlayıcıların bölgesi dışında olabilir.
- Test ortamında gönderi belgesi yazdırılmıyor — QuickShipper test sunucusunun gönderi belgesi oluşturucusu şu anda çalışmıyor; buna rağmen sipariş oluşturulur.
Bağlantılar#
- Hizmetin sitesi: https://qshpr.com/
- API belgeleri (Swagger): https://delivery-test.quickshipper.ge/swagger/