UPS bağlama
UPS hesabını API ile bağlama — Client ID/Secret alma, hesap numarası, servis kodu ve etiket biçimi.
Bu sayfada
UPS ile kendi sözleşmeniz varsa gönderilerinizi panelden açabilirsiniz. UPS özellikle yurt dışı gönderilerde yaygın kullanılır; ücretler doğrudan UPS hesabınıza faturalanır.
Bağlamak için gerekenler
UPS, API erişimini eski "Access Key" yöntemiyle DEĞİL OAuth ile veriyor (eski anahtarlar 2024'te tamamen kapatıldı). Yapmanız gereken:
- developer.ups.com adresine UPS hesabınızla (ups.com kullanıcınız) giriş yapın.
- Apps > Add Apps ile bir uygulama oluşturun ve UPS hesap numaranızı uygulamaya ekleyin.
- Uygulamanın Client ID ve Client Secret değerlerini kopyalayın.
- Panelde Entegrasyonlar > UPS > Bağla ekranına Client ID, Client Secret ve 6 haneli UPS hesap numaranızı girin.
- Gönderici adresinizi (adres, şehir, posta kodu, telefon) doldurun — etikete basılır.
UPS hesap numaranız (Shipper Number) sözleşmenizde yazar; gönderi ücretleri bu hesaba işler.
Bilinmesi gerekenler
- Servis kodu. Boş bırakırsanız yurt içinde 11 (UPS Standard), yurt dışında 65 (UPS Saver) kullanılır. UPS sözleşmenizdeki hatlar farklıysa doğru kodu UPS temsilcinizden öğrenip kanal ayarındaki Servis kodu alanına yazın; yanlış kodda UPS'in kendi hata mesajı ekranda aynen görünür.
- Etiket GIF gelir, PDF değil. Normal yazıcıdan basılır. Termal etiket yazıcınız
varsa kanal ayarındaki Etiket biçimi alanına
ZPLyazın. - Uluslararası gönderide alıcı telefonu ve posta kodu zorunludur. Eksikse panel gönderiyi açmadan söyler.
- İlçe alanı yoktur. UPS adresi il + adres satırlarıyla işler; ilçe bilgisi adres satırına eklenir.
- İptal. "Gönderiyi iptal et" düğmesi UPS'in Void servisini çağırır; iptal penceresi UPS sözleşmenize göre değişebilir.
- Takip. Saatlik takip taraması UPS hareketlerini Türkçe açıklamalarıyla panele işler; UPS 120 günden eski gönderilerin takip verisini silmektedir.
Anlık hareket bildirimi (isteğe bağlı)
UPS gönderi hareketlerini panele anında bildirebilir. Bu kurulumun bir adımı UPS'te sizde kalıyor: UPS, bildirim adresinin API üzerinden tanımlanmasına izin vermiyor.
- developer.ups.com > Senkronia için oluşturduğunuz uygulama > Manage Webhook Credentials bölümünü açın.
- Panelin Entegrasyonlar > UPS > Yönet ekranında gösterdiği adresi buraya yapıştırın.
Gönderi oluştururken panel, takip numarasını UPS'in bildirim listesine kendisi ekler.
Bu adımı yapmasanız da takip aksamaz: panel açık gönderileri saatlik taramayla zaten günceller. Bildirim yalnızca hareketlerin daha çabuk görünmesini sağlar.
Test ortamı
UPS'in test ortamında (CIE) denemek isterseniz kanal ayarındaki Test ortamı alanına
1 yazın. Testte açılan gönderiler gerçek kargo doğurmaz.
İlgili yazılar
Aradığınızı bulamadınız mı?
Panelinizden Destek bölümüne talep açarsanız ekibimiz aynı gün içinde dönüş yapar. Henüz üye değilseniz sağ alttaki sohbet kutusundan yazabilir ya da [email protected] adresine e-posta gönderebilirsiniz.
Son güncelleme: 2026-08-18