Aras Kargo entegrasyonu için Aras'tan XML servis erişimi almanız ve gelen bilgileri Pixa'ya
girmeniz gerekir.
Gereken bilgiler
Bilgi | Nereden gelir | Pixa'daki alan |
Kullanıcı adı | Aras'ın XML servisleri için verdiği kullanıcı | Kullanıcı Adı |
Şifre | Aynı kullanıcının şifresi | Şifre |
Müşteri kodu | Aras müşteri numaranız | Müşteri Kodu |
Takip kullanıcı adı ve şifresi | Aras'ın ayrıca verdiği sorgulama kullanıcısı | Takip alanları |
Aras'tan servis erişimi alma
Aras Kargo web portalına giriş yapın.
Entegrasyon / XML servisleri başvurusunu yapın ve size tanımlanacak kullanıcı bilgilerini isteyin.
Başvuruda hangi servisleri kullanacağınızı belirtin. Pixa için gerekli olanlar:
Gönderi oluşturma
Gönderi iptali
Statü Sorgulama
Son barkod alma (Zebra etiket çıktısı kullanacaksanız)
Statü Sorgulama ve son barkod alma servisleri ayrıca yetkilendirilir. Bu yetkiler verilmezse
entegrasyon kurulmuş görünür ve bağlantı testi bile geçer, ancak kargo takibi ve etiket çıktısı
çalışmaz. Başvuru sırasında bu iki servisi açıkça isteyin.
İki ayrı kullanıcı bilgisi
Aras, gönderi işlemleri ile kargo takip sorgulaması için farklı kullanıcı bilgileri verebilir.
Alan | Hangi işlemler |
Kullanıcı Adı / Şifre | Gönderi oluşturma, iptal, etiket alma |
Takip kullanıcı adı / Takip şifresi | Kargo durumu sorgulama (kargoya verildi, teslim edildi) |
Takip alanlarını boş bırakırsanız Pixa ana kullanıcı bilgilerinizi kullanmayı dener.
Aras size takip için ayrı bir kullanıcı verdiyse mutlaka takip alanlarına girin. Ana kullanıcı
bilgilerinizi takip için kullanmayın ve takip bilgileriyle ana alanları doldurmayın. En sık
karşılaşılan durum şudur: gönderi açma çalışır, ama kargo durumları hiç güncellenmez — bu, takip
alanlarının boş bırakılmasından kaynaklanır.
Kurulum adımları
Pixa'da Market sayfasını açın, Aras Kargo kartında Kur'a tıklayın.
Kullanıcı Adı, Şifre ve Müşteri Kodu alanlarını doldurun.
Aras size ayrı takip bilgisi verdiyse takip alanlarını da doldurun.
Entegrasyonu Aktif yapın ve kaydedin.
Bağlantıyı Test Et ile bağlantıyı doğrulayın.
Bilgileri kopyalarken başına veya sonuna boşluk gelmemesine dikkat edin.
Bağlantı testi neyi doğrular
Test, Aras'tan gönderici adres listenizin okunabildiğini kontrol eder. Yani yalnızca gönderi
işlemleri için kullandığınız kullanıcı bilgilerini doğrular.
Bağlantı testi geçse bile kargo takibi çalışmayabilir. Test, takip kullanıcı bilgilerinizi
denemez. Test başarılı olduğu hâlde kargo durumları güncellenmiyorsa ilk bakılacak yer takip
kullanıcı adı ve şifresidir.
Test başarısız olursa sırayla kontrol edin:
Kullanıcı adı ve şifre doğru mu, yer değiştirmiş olabilir mi?
Aras tarafında XML servis erişiminiz aktif mi?
Entegrasyon Aktif mi?
Ne yapar, ne yapmaz
Kabiliyet | Durum |
✅ | |
✅ | |
✅ Günde bir kez | |
✅ | |
✅ | |
Zebra etiket çıktısı | ✅ İlgili ayar açıksa |
Kargo hareket dökümü | 🔴 Yok |
Çok parçalı gönderi | ⚠️ Panelden tetiklenmesi sınırlıdır |
Kurulumdan sonra ne çalışmaya başlar
İşlem | Sıklık |
Kargoya verilen siparişlerin güncellenmesi | Saatte iki kez |
Teslim edilen siparişlerin güncellenmesi | Günde bir kez, akşam |
Kargo iptallerinin iletilmesi | 15 dakikada bir |
Teslim bilgisi günde yalnızca bir kez alınır. Akşam geç saatte teslim edilen bir sipariş, ertesi
günkü güncellemeye kadar Pixa'da "kargoda" görünmeye devam eder.
Gönderici adresi
Birden fazla gönderici adresiniz varsa Gönderici adresi numarası alanına Aras'ın size verdiği
adres numarasını yazabilirsiniz. Boş bırakırsanız Aras adresi kendisi eşleştirir.
Farklı satış kanalları için farklı gönderici adresi kullanmak isterseniz bu alan kanal bazında da
tanımlanabilir; kurulumunu destek ekibiyle birlikte yapın.
Test ortamı
Aras Kargo test işlemlerini aktif et ayarı açıkken gönderiler Aras'ın test ortamına gider ve
gerçek kargo oluşmaz. Canlıya geçerken bu ayarı kapatmayı unutmayın.
Sık karşılaşılan durumlar
Bağlantı testi başarısız. Kullanıcı adı ve şifreyi kontrol edin; Aras tarafında XML servis
erişiminizin aktif olduğundan emin olun.
Gönderi açılıyor ama kargo durumları hiç güncellenmiyor. Takip kullanıcı adı ve şifresi eksik
veya yanlıştır. Aras'tan Statü Sorgulama yetkisi aldığınızdan da emin olun.
Etiket çıktısı alamıyorum. Aras'ta "son barkod alma" servisine yetki verilmiş olması gerekir.
Kullanıcı bilgilerimi değiştirdim, her şey durdu. Kullanıcı adı ve şifre aynı anda
değiştirildiğinde yanlış girilirse tüm kargo işlemleri durur. Değişiklik sonrası mutlaka bağlantı
testi yapın.