APIE-ticaret markaları, pazaryerleri ve 3PL’lerdeki geliştiriciler için

Satıcılar için bir kargo API’si.

Fiyatlar, gümrük belgeli etiketler, takip ve webhook’lar, adres doğrulama; hepsi sade REST uç noktaları olarak. UPS, FedEx, USPS ve DHL gönderilerini mağazanıza, pazaryeri araçlarınıza ya da depo sisteminize entegre edin.

API anahtarı alın API referansı ↗

kapsam: Fiyatlar · Etiketler · Takip · Adresler
kargo firmaları: UPS · FedEx · USPS · DHL
yapı: REST + JSON, webhook’lar

POST/rates

// örnek istek: fiyatları karşılaştır, ardından etiket satın al
const rates = await ex.rates.create({
  from:   { country: 'ES', city: 'Barcelona' },
  to:     { country: 'US', city: 'Atlanta', state: 'GA' },
  parcel: { weight_oz: 8, length_in: 10, width_in: 8, height_in: 3 },
})

// en ucuzunu satın al, gümrük belgeleri dahil
const label = await ex.labels.create({ rate: rates[0].id })

200kargo firmalarınızdan fiyatlar, en ucuzdan başlayarakörnek istek · kesin alanlar API referansında

nasıl konumlanır

Bir yanda sizin sisteminiz, diğer yanda kargo firmaları.

Kodunuz tek bir API ile konuşur. ExperShip her kargo firmasıyla ilgilenir, fiyatları ve etiketleri döndürür, gönderiler ilerledikçe takip güncellemelerini size iletir.

API’NİN YERİşema

neler geliştirebilirsiniz

Kodla gönderi için dört yapı taşı.

ExperShip web uygulamasındaki özelliklerin aynısı, API üzerinden. Birini kullanın ya da siparişten kapıya tüm akışı kurun.

fiyatlar

Çok kargo firmalı fiyatlar

Çıkış noktası, varış noktası ve koli bilgisini gönderin. Hesabınızdaki kargo firmalarının canlı fiyatları en ucuzdan başlayarak döner; böylece kodunuz ya da ödeme sayfanız doğru hizmeti seçebilir.

UPS, FedEx, USPS ve DHL’yi tek çağrıda karşılaştırın
ABD içi ve ABD’ye sınır ötesi gönderiler
Fiyata, teslim süresine ya da kendi kurallarınıza göre seçin

FİYATLAR Shopify #7323 → Philadelphiaörnek yanıt

#	Kargo firması	Hizmet	Not
0	FedEx	Home Delivery	zamanında, en ucuz
1	USPS	Ground Advantage	karşılaştırıldı
2	UPS	Ground	karşılaştırıldı
3	USPS	Priority Mail	karşılaştırıldı

rates[0], kurallarınızın seçtiği fiyattır

etiketler

Etiketler, sınır ötesi için gümrük belgeleriyle

Seçtiğiniz fiyatı yazdırılabilir bir etikete dönüştürün. ABD’ye giren koliler için gümrük belgeleri aynı adımda döner; hiçbir şeyi elle doldurmanız gerekmez.

Tek etiket ya da toplu olarak çok sayıda
Etiketle birlikte gümrük evrakı
Her kargo firması için aynı çağrı

Amazon siparişi · Barcelona → Atlantaörnek istek

// fiyatlar en ucuzdan sıralı döndü; rates[0] satın al
const label = await ex.labels.create({ rate: rates[0].id })

// sınır ötesi koli: etiket + gümrük formu
// UPS Worldwide Expedited · Barcelona, İspanya → Atlanta, GA

200etiket yazdırmaya hazır, gümrük belgeleri dahil

takip ve webhook’lar

Takip ve webhook’lar

Oluşturduğunuz her gönderi takip edilebilir. Durumunu istediğiniz zaman sorgulayın ya da bir webhook kaydedin; koli ilerledikçe durum güncellemeleri sırasıyla size gelsin.

Durum güncellemeleri sisteminize iletilir
Sipariş kayıtlarınız otomatik olarak güncel kalır
Alıcıları kendi yönteminizle bilgilendirin

Webhook’lar nasıl çalışır →

GÖNDERİ Shopify #7323 · FedEx Home Deliveryörnek

durum: Yolda
kargo firması: FedEx
varış: Philadelphia, PA
alıcı: bilgilendirildi

adres doğrulama

Adres doğrulama

Etiket satın almadan önce adresi kontrol edin. Bir yazım hatasını ödeme sayfasında ya da depoda yakalamak, geri dönen bir koliden ya da sonradan yapılan bir kargo düzeltmesinden daha ucuzdur.

Ödeme sırasında ya da yazdırmadan önce doğrulayın
Mümkünse düzeltilmiş adresi geri alın
Hatalı adresleri gönderilmeden durdurun

ADRES KONTROLÜörnek

girildiği gibi

1200 main st
philadelphia pa

doğrulandı

1200 Main St
Philadelphia, PA 19103

teslim edilebilir · etikete hazır

api referansı

Uç noktalara genel bakış.

API’nin neleri kapsadığını sade bir dille gösteren bir harita. Kesin yollar, alanlar ve yanıtlar tam API referansında yer alır.

UÇ NOKTALAR alana göretemsilî · spesifikasyon değildir

Alan	Gönderdiğiniz	Aldığınız	Örnek
Fiyatlar	Çıkış, varış ve koli boyutu ile ağırlığı	Bağlı kargo firmalarınızdan fiyatlar, en ucuzdan başlayarak	POST /rates
Etiketler	Seçtiğiniz fiyat	Yazdırılabilir bir etiket, sınır ötesi koliler için gümrük belgeleriyle	ex.labels.create(...)
Takip	Oluşturduğunuz bir gönderi	Güncel durumu ve geçmişi	referansa bakın
Webhook’lar	Sizin tarafınızda bir URL	Her gönderi ilerledikçe bu URL’ye iletilen durum güncellemeleri	referansa bakın
Adres doğrulama	Bir adres	Teslim edilebilir olup olmadığı, mümkünse düzeltilmiş hâliyle	referansa bakın

Tam referansı mı istiyorsunuz? Bir API anahtarı alın ya da bizden erişim isteyin.API anahtarı alın →Bizimle konuşun →

webhook’lar

Durum güncellemeleri size gelir.

Her kargo firmasını tek tek sorgulamak yerine ExperShip’e bir URL verin. Gönderi ilerledikçe durum güncellemeleri bu URL’ye sırasıyla iletilir; sipariş kayıtlarınız, panolarınız ve alıcı e-postalarınız güncel kalır.

Bir uç nokta kaydedin
Sunucunuzda JSON kabul eden bir URL.
Güncellemeleri sırasıyla alın
Her gönderinin durum değişiklikleri gerçekleştikleri sırayla gelir.
Sisteminizi güncelleyin
Durumu siparişe yazın, alıcıya e-posta tetikleyin ya da ekibiniz için bir sorunu işaretleyin.

DURUM GÜNCELLEMELERİ Shopify #7323örnek gönderi

01
Etiket oluşturulduFedEx Home Delivery
02
Kargo firması teslim aldıilk kargo taraması
03
Yoldaağ içinde ilerliyor
04
Dağıtıma çıktıPhiladelphia, PA
05
Teslim edildison durum

sade dilde etiketler · kesin durum adları API referansında

webhook işleyicinizörnek taslak

// sunucunuz: durum güncellemesini al, kaydet
app.post('/shipping-updates', async (req, res) => {
  const update = req.body
  await saveShipmentStatus(update)  // sizin kodunuz
  res.sendStatus(200)
})

rehberler

Kodla gönderi rehberleri.

Kargo API’leri, kargo firmaları ve gümrük üzerine, e-ticaret sistemleri geliştirenler için yazılmış pratik rehberler.

Buradan başlayın

Tüm yazılar →

Gönderiyi kendi sisteminize entegre edin.

Bir API anahtarı alın ve fiyatlar ile etiketlerle başlayın. Daha büyük bir entegrasyon mu planlıyorsunuz ya da ABD’ye sınır ötesi gönderi mi yapıyorsunuz? Önce bizimle konuşun.

API anahtarı alın Bizimle konuşun