Aramex entegrasyonu:
kendi sözleşmenizle, siparişten etikete.

Aramex entegrasyonu nedir, hangi satıcının işine yarar?

Aramex entegrasyonu, bir siparişin Aramex sisteminde gönderi kaydına dönüşmesini, Aramex'in verdiği gönderi numarasının (AWB) siparişe takip numarası olarak yazılmasını ve bu numaranın satış kanalına gitmesini sağlayan bağlantıdır. Yox İş Ortağım bu bağlantıyı Aramex'in müşterilerine sunduğu Shipping Services API üzerinden kurar; hesap da gönderi fiyatı da sizin Aramex sözleşmenize aittir.

Aramex, 1982'de Amman ve New York ofisleriyle kurulmuş, 2005'ten beri Dubai Finans Piyasası'nda işlem gören bir lojistik şirketidir. Türkçe sitesine göre 65'ten fazla ülkede 600'ü aşkın ofis ve 17.000'den fazla çalışanla hizmet veriyor; Temmuz 2025'te ADQ çoğunluk hissedarı oldu. Şirketin 2025 yılı sonuç açıklamasında gelire en çok katkı veren bölgeler Körfez İşbirliği Konseyi (GCC) ülkeleri ile MENAT bölgesi olarak geçiyor. Türkiye sitesindeki Yurt Dışı Ekspres hizmeti ise 30 kilogramın altındaki koli ve belgeler için tanımlanmış.

Aramex'i yurt içi kargonun yerine değil, yurt dışı için ikinci bir hesap olarak düşünün. Bağlantı en çok şu satıcılara zaman kazandırır:

• Etsy, eBay veya Amazon'da yurt dışına satan ve gönderiyi kendi kargo hesabıyla organize eden üreticiler
• Kendi sitesinden Suudi Arabistan, Birleşik Arap Emirlikleri, Katar veya Kuveyt'e sipariş alan markalar
• Yurt içinde bir firma, yurt dışında Aramex kullandığı için takip numarasını iki ayrı ekrandan kopyalayan ekipler
• Her siparişte içerik tanımını ve koli ölçüsünü yeniden yazan satıcılar

Aramex'te hangi hesapla başlamalısınız: Klasik mi, İşletme mi?

API bağlantısı için gereken hesap numarası ve PIN, Aramex'le sözleşme yapan müşterilere verilir; bu yüzden ilk karar hesap türüdür. Aramex Türkiye'nin “Paketlerimiz” sayfası ve sık sorulan soruları iki seçeneği şöyle ayırıyor:

Satıcı olarak her hafta gönderi yapacaksanız İşletme hesabı daha doğru başlangıçtır. Aramex'in e-ticaret ve KOBİ sayfası bu hesapta ön ödeme ve minimum faturalama istenmediğini, size özel bir hesap yöneticisi atandığını belirtiyor. Tarife sözleşmenize göre değiştiği için burada fiyat rakamı vermiyoruz.

Aramex'in kendi e-ticaret portalı ile API bağlantısı arasındaki fark

Aramex, Türkiye sitesinde WooCommerce (WordPress), Magento ve Shopify mağazalarına kurulan bir sipariş karşılama portalı da sunuyor; PrestaShop, OpenCart, Zid ve Salla sonraki platformlar olarak listeleniyor. Bu portal için de Aramex kurumsal hesabı şart ve Aramex bu entegrasyon için ücret almadığını yazıyor. Listede pazaryeri adı yer almıyor. Siparişleriniz birden çok pazaryerinden ve siteden geliyorsa Aramex bilgilerini sipariş panelinize bir kez bağlamak, gönderiyi siparişin geldiği kanaldan bağımsız olarak aynı akışta açmanızı sağlar.

Aramex entegrasyonu için gereken API bilgileri ve anlamları

Aramex'in Shipping Services API kılavuzu her isteği iki katmanda doğrular: aramex.com kaydında kullandığınız e-posta ve şifre isteği yetkilendirir, Aramex'in verdiği hesap numarası ve PIN ise gönderinin hangi müşteriye ait olduğunu doğrular. Panelin Kargo bölümündeki alanların kılavuzdaki karşılıkları şöyle:

Test ortamı ile canlı ortam neden karıştırılmamalı?

Kılavuz test istekleri için ws.dev.aramex.net, canlı istekler için ws.aramex.net adresini tanımlar; test sitesine bağlanmak için ayrıca Aramex'in güvenlik sertifikasının kurulmasını ister. Test için verilen deneme bilgileri gerçek gönderi oluşturmaz, panele canlı hesabınızın numarası ve PIN'i girilmelidir. Bağlantı testi ERR01 ya da ERR02 hatası döndürürse ilk bakılacak yer bu ayrımdır.

Hesap numarası, PIN ve Entity kodunu kimden istemelisiniz?

Hesap numarası sözleşmenizde yer alır. PIN ve Entity kodu sözleşmede yoksa hesap yöneticinizden “Shipping Services API için account number, account PIN ve account entity” bilgilerini yazılı olarak isteyin; bu terimler talebin doğru ekibe gitmesini kolaylaştırır.

Aramex gönderi kaydında zorunlu alanlar: ürün türü, ödeme tipi, ağırlık

Aramex, gönderi kaydı açılırken adresi, ödeme yöntemini ve ölçüleri ayrıntılı bir doğrulamadan geçirir; hata varsa sorunun hangi alanda olduğunu yanıtta söyler. Kılavuza göre her gönderide içerik tanımı (Description of Goods) ve menşe ülke zorunludur. Ürün grubu uluslararası ekspres için EXP, yurt içi için DOM'dur; uluslararası ürün türleri şunlardır:

E-ticaret siparişleri belge dışı olduğu için gümrüğe tabi türlerden biriyle gider ve bu türlerde gümrük değeri girilmeden kayıt açılmaz. Hesabınızda hangi türlerin tanımlı olduğunu Aramex temsilcinizden öğrenin.

Gönderi ücretini kim öder: P, C ve 3 ödeme tipleri

P (Prepaid) taşıma ücretinin göndericiden, C (Collect) alıcıdan, 3 (Third Party) üçüncü bir taraftan alınacağını gösterir; üçüncü tarafta faturalanacak tarafın Aramex hesap numarası da girilir. Satıcı gönderilerinde genellikle P kullanılır; ücret sizin hesabınıza yazılır.

Ağırlık, ölçü ve koli sayısı kuralları

• Ölçülerden biri girilirse uzunluk, genişlik, yükseklik ve birim (CM ya da M) alanlarının hepsi doldurulmalıdır.
• Ölçü girildiğinde ücrete esas ağırlık gerçek ağırlıkla karşılaştırılır ve büyük olan esas alınır.
• Bir gönderideki koli sayısı sıfırdan büyük olmalı, kılavuzdaki üst sınır 100'dür.
• Gönderiye proforma fatura ya da gümrükleme formu gibi belgeler eklenebilir; tek dosya 2 MB'ı geçemez.

Kolinin hacim ağırlığını göndermeden önce desi hesaplama aracıyla kontrol edebilirsiniz; uluslararası gönderide uygulanan bölen sözleşmenizde yazar.

Yox İş Ortağım'da Aramex gönderisi adım adım nasıl oluşur?

Aramex bağlantısı Yox İş Ortağım'da pilot aşamasındadır: kurulumu sizinle birlikte yapıyor, ilk gönderinizi birlikte doğruluyoruz. Kurulum tamamlandıktan sonra bir yurt dışı siparişi şu yolu izler:

1. Aramex bilgilerinizi panelin Kargo bölümüne girer ve “Bağlantıyı test et” ile doğrularsınız.
2. Siparişlerin hangi kargo hesabıyla gideceğini seçersiniz; Aramex'i birincil kargo yapabilir ya da siparişin gideceği firmayı kendiniz belirleyebilirsiniz.
3. Sipariş hazır olduğunda alıcı adı, adresi, telefonu, koli bilgileri, içerik tanımı ve menşe ülkeyle Aramex tarafında gönderi oluşturulur.
4. Aramex'in döndürdüğü gönderi numarası siparişe takip numarası olarak yazılır; bilgileri elle kopyalamazsınız.
5. Aramex etiketi döndürdüğünde etiket panelden basılır, koli etiketlenip teslim edilir.
6. Takip numarası ve kargo firması siparişin geldiği pazaryerine ya da sitenize iletilir.
7. Gönderinin durumu Aramex üzerinden sorgulanır; kargoya verildi, yolda ve teslim edildi gibi durumlar siparişe yansır.

Aramex kılavuzuna göre etiket PDF indirme bağlantısı ya da yanıtın içinde dosya akışı olarak gelir; şablon bir rapor kimliğiyle seçilir. Kurye çağırma ve teslim alma randevusu Aramex API'sinde ayrı bir işlemdir ve panel bunu yapmaz; kurye talebini Aramex'in kendi kanallarından açarsınız. Gönderinin taşınması ve gönderi ücreti Aramex ile aranızdaki sözleşmeye tabidir.

Aramex ile mikro ihracat: Ticaret Bakanlığı kuralları ve gümrük belgeleri

Türkiye'den hızlı kargoyla gönderilen eşyanın beyanı, Ticaret Bakanlığı'nın 2022/9 sayılı Genelgesine göre Basitleştirilmiş Gümrük Beyannamesi (BGB) ile yapılır; uygulamada mikro ihracat ya da ETGB diye bilinen yol budur. Gümrükler Genel Müdürlüğü'nün yükümlü beyan kılavuzuna göre bu beyannameyi Bakanlıktan dolaylı temsil yetkisi almış operatörler düzenler. Ekim 2026 itibarıyla geçerli temel kurallar:

Aramex yurt dışı gönderide hangi belgeleri ister?

Aramex'in gümrük sorularına verdiği yanıta göre her uluslararası gönderide gönderi numarası (airwaybill), eksiksiz adres ve varış ülkesi istiyorsa posta kodu bulunmalı; bunlara göndericinin kimlik fotokopisi, gönderi faturası ve varsa paket listesi eklenir. Bazı ülkeler alıcının kimlik fotokopisini, KYC bilgisini veya menşe şahadetnamesini de ister. Aramex, belgeleri eksiksiz sağlama sorumluluğunun göndericide olduğunu açıkça yazıyor.

Varış ülkesindeki vergi ve yasaklı ürünler

Varış ülkesindeki gümrük vergisi ülkeden ülkeye değişir; Aramex'in Free Domicile (FRDM) hizmetinde bu masrafların bir kısmını ya da tamamını gönderici üstlenir. Aramex yasaklı ve kısıtlı ürünleri hiçbir adrese taşımaz ve bazı ülkelerin ek kısıtlamaları vardır; ürününüzün durumunu temsilcinizden kontrol edin.

Pazaryeri ve site siparişlerinde Aramex takip numarası nasıl kullanılır?

Aramex'in sipariş akışındaki asıl katkısı, gönderiyi kendiniz organize ettiğiniz yurt dışı siparişlerde görülür. Bu kanallarda takip numarasını siparişe girmek satıcının işidir; numara geç girilirse sipariş kanalda gönderilmemiş görünür. Etsy'nin geliştirici dokümanındaki kargo firması listesinde Aramex, “aramex” değeriyle ve takip güncellemesi alan firmalar arasında yer alır. Etsy entegrasyonu kullanan bir satıcı için Aramex numarası panelden kanala iletilir.

• eBay ve Amazon siparişlerinde Aramex'in kanalın kargo firması listesinde hangi adla tanımlandığı ve takip numarasının hangi sipariş durumunda kabul edildiği o kanalın kuralına bağlıdır.
• Shopify gibi kendi sitenizden gelen siparişlerde takip numarası ve kargo firması sitenizdeki sipariş kaydına iletilir.
• Yurt içi pazaryerleri kargo firmalarını kendi anlaşmalı kargo kurallarıyla belirler; Aramex'i bu kanallarda kullanmadan önce kanalın kendi sözleşmenizle gönderime izin verip vermediğini kontrol edin.

Aynı müşteriye aynı gün birden çok sipariş gidiyorsa mikro ihracatta bu gönderilerin tek bütün sayıldığını unutmayın; sınıra yakın değerlerde siparişleri ayrı kolilere bölmek beyan kuralını değiştirmez. Yurt dışında Aramex'in yanında DHL Express gibi ikinci bir ekspres hesabı da bağlayabilirsiniz; bu durumda paketinizdeki iki kargo firması hakkı kullanılır ve her siparişin hangi hesapla gideceğine siz karar verirsiniz.

Aramex entegrasyonu hangi Yox İş Ortağım paketinde var?

Aramex bağlantısı Büyüme paketinden itibaren kullanılır; Başlangıç paketinde kargo entegrasyonu bulunmaz ve takip numarası elle girilir. Aramex, paketinizdeki kargo firması haklarından birini kullanır. Yox kargo firması değildir, kargo bedeli almaz ve anlaşmalı fiyat vermez; gönderi ücretini Aramex ile yaptığınız sözleşme belirler.

Etsy, eBay ve Amazon gibi yurt dışı kanallar Başlangıç paketinin kanal listesinde yer almaz; yurt dışına satıp Aramex kullanacaksanız en az Büyüme paketi gerekir. Yurt içi için bir kargo firması, yurt dışı için Aramex bağlayacaksanız iki firmayı kapsayan Profesyonel paket uygun düşer. Yıllık ödemede %20 indirim uygulanır ve paketler 3 gün ücretsiz denenebilir. Ayrıntılar paket karşılaştırmasında; panelde tanımlı 80 satış kanalı (48'i hazır), 57 kargo ve lojistik firması ve 51 muhasebe, e-Fatura ve ERP programı entegrasyon sayfamızda listelenir.

Aramex bağlantısında sık görülen hatalar ve canlıya geçiş kontrol listesi

Aramex hata yanıtları sorunun yerini kodla bildirir. Sık karşılaşılabilecek kodlar ve kılavuzdaki tanımlarına göre çözümleri:

Canlıya almadan önce kontrol listesi

• Panelde test değil canlı hesap numarası ve PIN var mı, bağlantı testi başarılı mı?
• Gönderici unvanı ve adresi Aramex sözleşmenizdekiyle aynı mı?
• Ürün kartlarında ağırlık ve koli ölçüsü dolu mu, ölçü birimi doğru mu?
• Her ürün için gümrükte anlaşılacak açık bir içerik tanımı var mı? “Ürün” ya da “hediye” yerine “pamuklu tişört” gibi somut tanım kullanın.
• Fatura tutarı ile gümrük değeri aynı mı? Kargo ücreti mikro ihracat kıymetine girmez.
• Ürününüz Aramex'in yasaklı ve kısıtlı ürünler listesinde ya da varış ülkesinin kısıtlamaları arasında mı?
• İlk gönderide etiket, takip numarası ve kanala giden bildirim birlikte kontrol edildi mi?

Hesabınızın API'ye hazır olduğundan emin değilseniz önce hesap yöneticinizle API bilgilerini netleştirin. Sorularınız için iletişim sayfamızdan bize ulaşabilirsiniz; ön görüşmede Aramex hesabınızı ve sipariş kanallarınızı birlikte değerlendiririz.