Kargo Entegrasyonları
ikas üzerinden kargo süreçlerinizi hızlı ve güvenli bir şekilde yönetmek için çeşitli entegrasyon seçenekleri mevcuttur. Bu makalede, Türkiye içi gönderimler, e-ihracat gönderimleri ve üçüncü parti entegrasyonlar hakkında bilmeniz gereken temel noktaları bulabilirsiniz.
ikas'ta hem Türkiye içi hem de e-ihracat için yurtdışına kargo gönderimi yapabileceğiniz çeşitli entegrasyonlar bulunmaktadır. Bu entegrasyonlara Uygulamalar > Uygulama Mağazası üzerinden erişebilir ve eklemek istediğiniz entegrasyonu seçip Uygulama Kur butonuna tıklayarak kurulumu sağlayabilirsiniz.
Bu Sayfada
Bu entegrasyonlar ikas’ın kendi kargo anlaşmaları değildir. Eğer siz bu firmalarla anlaşmalıysanız veya anlaşmayı düşünüyorsanız, anlaşma sonrasında bu entegrasyonları kendi kargo anlaşmalarınız ile kullanabilirsiniz.
Eğer ikas’ın anlaşmalı kargolarını kullanmak istiyorsanız, ikas Kargo Anlaşmaları makalesine göz atabilirsiniz.
Türkiye için Kargo Entegrasyonları
Türkiye içindeki gönderimleriniz için DHL eCommerce, Yurtiçi Kargo ve UPS Kargo entegrasyonlarımız mevcuttur.
Bu entegrasyonlar sayesinde kargo süreçlerinizi panel üzerinden hızlı ve güvenli bir şekilde yönetebilir, siparişlerinizi kolayca takip edebilir ve sipariş statülerinin otomatik olarak güncellenmesini sağlayabilirsiniz.
Aşağıdaki başlıklardan ilgili kargo firması entegrasyonuna giderek detaylı bilgilere ulaşabilirsiniz:
DHL eCommerce
DHL uygulamasını kurduktan sonra DHL eCommerce uygulamasının içerisinde bulunan Kullanıcı Adı ve Şifre alanlarına, DHL online portalına giriş yaptığınız kullanıcı adı ve şifreyi girmeniz gerekir.
Kullanıcı Adı ve Şifre alanının altında üç seçenek bulunur:
- Kapıda ödeme siparişler kargo tarafından teslim edildiğinde, otomatik olarak Ödeme Alındı olarak işaretlensin: Kapıda ödeme anlaşmanız varsa, kapıda ödeme siparişleri teslim edildiğinde Ödeme Bekleniyor durumu otomatik olarak Ödeme Alındı olur.
- Sadece kapıda ödeme siparişlere kod oluştur: DHL’i sadece kapıda ödeme siparişler için kullanmak istiyorsanız bu seçeneği aktif edin.
- DHL eCommerce üzerinden SMS göndermek istiyorum: Eğer anlaşmanız SMS’i kapsıyorsa, kargo statüleri müşterilere SMS olarak iletilebilir.
Entegrasyonu sağlayabilmek için alttaki alandan Satış Kanalları için Siparişleri Gönderme Koşulu seçilmelidir. Satış Kanalları alanında tüm satış kanalları görünür, Admin sekmesi manuel siparişleri temsil eder.
-
Tüm Siparişleri Gönder: Sipariş Kargoya Hazır durumuna geldiğinde, otomatik olarak kargo barkodu oluşturulur.
-
Sadece Kargo Bilgisi Olmayan Siparişleri Gönder: İlgili siparişte kargo bilgisi yoksa barkod oluşturulur. Örneğin birden fazla kargo firması kullanıyorsanız ve diğer kargo firmasında Otomatik Paketle açık olmasına rağmen barkod oluşmamışsa, sistem bu siparişe barkod oluşturur.
-
Siparişleri Gönderme: Bu kargo kuralı kapsamında otomatik bir işlem yapılmaz. Barkod manuel olarak alınabilir.
-
Tüm Siparişleri Gönder ve Otomatik Paketle: Sipariş oluşturulduğunda, sipariş statüsü otomatik olarak Kargoya Hazır statüsüne geçer ve otomatik olarak barkod oluşur.
Bu adımlar tamamlandıktan sonra Giriş butonuna tıklayarak entegrasyon aktif hale getirilir.
Eğer Gönderme Koşulu olarak otomatik barkod oluşturan bir seçenek seçmediyseniz veya bazı siparişlerde manuel barkod almanız gerekiyorsa, entegrasyon aktif olduktan sonra manuel barkod almak istediğiniz siparişin içerisinde "Gönderildi Olarak İşaretle" butonunun sağındaki "..." butonundan DHL eCommerce ile Paketle ve Gönder butonuna tıklayarak barkodu manuel olarak oluşturabilirsiniz.
Yurtiçi Kargo
Yurtiçi Kargo entegrasyonunun sağlanabilmesi için ilk olarak Yurtiçi Kargo’nun entegrasyon biriminden API kullanıcı adı ve şifresi talep etmeniz gerekir.
Yurtiçi Kargo, API bilgisi talep ettiğinizde bazen statik IP adresi isteyebilir. Bu durumda aşağıdaki IP adreslerini paylaşmanız gerekir:
-
3.64.142.93
-
18.193.18.125
-
3.64.196.203
-
52.58.103.140
-
3.120.253.252
-
78.187.230.139
Talep sonrası Yurtiçi Kargo size Web Servis API Kullanıcı Bilgileri dosyasını iletir. Bu dosya içerisinde birden fazla ödeme tipi için (ör. GÖ (Normal), AÖ (Normal)) farklı kullanıcı adı ve şifre bilgileri bulunur. Entegrasyon için dosyada yer alan GÖ (Normal) tipine ait Web Servis API Kullanıcı Adı ve Web Servis API Kullanıcı Şifre bilgilerini, ikas panelinde Yurtiçi Kargo uygulamasındaki Kullanıcı Adı ve Şifre alanına girmeniz gerekir.
Kullanıcı Adı ve Şifre alanının altında üç seçenek bulunur:
- Kapıda ödeme siparişler kargo tarafından teslim edildiğinde, otomatik olarak Ödeme Alındı olarak işaretlensin: Kapıda ödeme anlaşmanız varsa, kapıda ödeme siparişleri teslim edildiğinde Ödeme Bekleniyor durumu otomatik olarak Ödeme Alındı olur.
- Sadece kapıda ödeme siparişlere kod oluştur: DHL’i sadece kapıda ödeme siparişler için kullanmak istiyorsanız bu seçeneği aktif edin.
Entegrasyonu sağlayabilmek için alttaki alandan Satış Kanalları için Siparişleri Gönderme Koşulu seçilmelidir. Satış Kanalları alanında tüm satış kanalları görünür, Admin sekmesi manuel siparişleri temsil eder.
-
Tüm Siparişleri Gönder: Sipariş Kargoya Hazır durumuna geldiğinde, otomatik olarak kargo barkodu oluşturulur.
-
Sadece Kargo Bilgisi Olmayan Siparişleri Gönder: İlgili siparişte kargo bilgisi yoksa barkod oluşturulur. Örneğin birden fazla kargo firması kullanıyorsanız ve diğer kargo firmasında Otomatik Paketle açık olmasına rağmen barkod oluşmamışsa, sistem bu siparişe barkod oluşturur.
-
Siparişleri Gönderme: Bu kargo kuralı kapsamında otomatik bir işlem yapılmaz. Barkod manuel olarak alınabilir.
-
Tüm Siparişleri Gönder ve Otomatik Paketle: Sipariş oluşturulduğunda, sipariş statüsü otomatik olarak Kargoya Hazır statüsüne geçer ve otomatik olarak barkod oluşur.
Bu adımlar tamamlandıktan sonra Giriş butonuna tıklayarak entegrasyon aktif hale getirilir.
Eğer Gönderme Koşulu olarak otomatik barkod oluşturan bir seçenek seçmediyseniz veya bazı siparişlerde manuel barkod almanız gerekiyorsa, entegrasyon aktif olduktan sonra manuel barkod almak istediğiniz siparişin içerisinde "Gönderildi Olarak İşaretle" butonunun sağındaki "..." butonundan YK ile Paketle ve Gönder butonuna tıklayarak barkodu manuel olarak oluşturabilirsiniz.
UPS Kargo
UPS Kargo entegrasyonu için önce UPS’ten API Entegrasyon Bilgileri talep etmeniz gerekir. Bilgiler geldikten sonra ikas’taki UPS Kargo uygulamasında ilgili Müşteri Numarası, Kullanıcı Adı ve Şifre alanlarını doldurun.
Bu alanın altında bulunan;
Kapıda ödeme siparişler kargo tarafından teslim edildiğinde, otomatik olarak Ödeme Alındı olarak işaretlensin: Kapıda ödeme anlaşmanız varsa, kapıda ödeme siparişleri teslim edildiğinde Ödeme Bekleniyor durumu otomatik olarak Ödeme Alındı olur.
Satış Kanalları kısmından hangi satış kanalları için UPS kullanılacağını seçin.
UPS entegrasyonunda kargo barkodu yalnızca sipariş “Kargoya Hazır” statüsüne alındığında otomatik oluşur.
UPS Kargo entegrasyonu sadece Türkiye içi gönderimler için kullanılmaktadır. Yurt dışına gönderim yapılamaz.
E-İhracat için Kargo Entegrasyonları
Yurt dışına gönderim yapmak isteyen mağazalar için ikas’ta Navlungo ve Shipentegra entegrasyonları bulunmaktadır.
Aşağıdaki başlıklardan ilgili kargo firması entegrasyonuna giderek detaylı bilgilere ulaşabilirsiniz:
Navlungo
Navlungo entegrasyonunu kullanabilmek için öncelikle Navlungo üzerinden bir hesap oluşturmanız gerekir. Hesap oluşturduktan sonra ikas’taki Navlungo uygulamasında “Navlungo Hesabımı Bağla” butonuna tıklayın. Açılan pencerede Navlungo hesabınıza giriş yaptıysanız, entegrasyon otomatik olarak sağlanır ve hesabınız ikas’a bağlanır.
Entegrasyon öncesinde, Navlungo panelinizde “Adreslerim > Gönderim Adreslerim” alanından “Yeni Adres Ekle” butonuna tıklayarak gönderim adresinizi tanımlamanız gerekir.
Ardından adres bilgilerinizi Navlungo panelinize ekleyin.
Navlungo panelinizde adres bilgilerinizi ekledikten sonra ikas'ta bulunan Navlungo uygulamasına gidin.
Navlungo uygulaması içerisinde iki bölüm bulunur:
-
Temel Bilgiler:
-
Satış Kanalları alanından kullanılacak satış kanalı seçilir.
-
Adres Tipi alanında, Navlungo panelinde adres oluştururken “Şahıs Bilgileri” ile ilerlediyseniz Bireysel, “Şirket Bilgileri” ile ilerlediyseniz Kurumsal seçmeniz gerekir.
-
Eğer Navlungo’da gönderim adresinizi “Fatura adresim olarak kullan” seçtiyseniz, ikas’ta Navlungo uygulamasındaki “Mağaza adresi ile fatura adresi aynı olsun” butonunu aktif bırakabilirsiniz. Eğer farklı bir fatura adresi kullandıysanız, bu butonu pasif hale getirerek Navlungo panelinde yazdığınız adresi fatura adresi olarak bire bir eklemeniz gerekir.
-
-
Mağaza Adresi:
-
Bu kısma, Navlungo panelinize eklediğiniz gönderim adresi bilgisini satır satır, bire bir aynı olacak şekilde girmeniz gerekir.
-
Bir siparişi Navlungo ile göndermek için, ikas panelinde Siparişler alanına gidin. İlgili siparişin detay sayfasında sağ üstte bulunan “...” butonuna tıklayın ve “Navlungo ile Gönder” seçeneğini seçin. Bu işlemle birlikte Navlungo üzerinden farklı fiyat tekliflerini görebilir ve siparişinizi Navlungo aracılığıyla gönderebilirsiniz.
Shipentegra
Shipentegra entegrasyonunu kullanabilmek için öncelikle bir Shipentegra hesabı açmanız gerekir.
Hesap açtıktan sonra, Shipentegra panelinde sol menüden Entegrasyonlar alanına gidin. Ardından “ShipEntegra for Developers API ile Bağlan” butonuna tıklayın.
Bu işlemden sonra size API Key ve API Secret bilgileri verilecektir.
API Key ve API Secret bilgilerinize ulaştıktan sonra ikas panelinizde bulunan Shipentegra uygulamasında,
- Client ID alanına Shipentegra’dan aldığınız API Key bilgisini,
- Client Secret alanına ise API Secret bilgisini yazmanız gerekir.
Uygulamada bu alanların altında ayrıca IOSS (IM ile başlayan 12 haneli kod), HMRC (GB ile başlayan 9 haneli kod) ve Almanya Ambalaj Kanunu (Verpackungsgesetz) ile ilgili bilgi alanları bulunur. Bu bilgiler ilk entegrasyon sırasında zorunlu değildir; ancak daha sonra Shipentegra’dan talep ederek bu alanlarla ilgili bilgi alabilir ve kodları talep ederek ilgili alanlara ekleyebilirsiniz.
Son olarak, altta bulunan Sale Channels alanından Shipentegra’yı kullanmak istediğiniz satış kanallarını seçip Save butonuna tıklayarak kaydedebilirsiniz.
Bir siparişi Shipentegra ile göndermek için, ikas panelinde Siparişler alanına gidin. İlgili siparişin detay sayfasında “Gönderildi Olarak İşaretle” butonunun yanındaki “...” menüsünden “Shipentegra ile Gönder” seçeneğine tıklayın. Bu işlemle birlikte Shipentegra üzerinden farklı fiyat tekliflerini görebilir ve siparişinizi Shipentegra aracılığıyla gönderebilirsiniz.
Üçüncü Parti Entegrasyonlar
ikas’ın API’leri açık olduğundan, dilerseniz kendi sistemleriniz üzerinden ikas ile özel kargo entegrasyonları geliştirebilirsiniz.
-
ikas’ın güncel API dökümanına ikas.dev adresinden ulaşabilirsiniz.
Buna ek olarak, Sentos gibi üçüncü parti entegrasyonlar üzerinden ikas’ta bulunmayan farklı kargo firmalarıyla da entegrasyon sağlanabilmektedir.
Yani ister üçüncü parti çözümler üzerinden hazır entegrasyonları kullanabilir, ister kendi ekibinizle API aracılığıyla ihtiyacınıza özel kargo entegrasyonları geliştirebilirsiniz.