How can we help?

Makaleleri buradan arayın veya aşağıdaki kategorilere göz atın.

Browse by topic

Find guides, tutorials, and answers organised by category.

Popular articles

What other people are reading right now.

WooCommerce Eklentisi

Sipariş Durumları Güncellenmiyor 'Gönderim Hazır' Durumunda Kaldı Ne Yapmalıyım ?

Cloudflare Tarafından İsteklerin Engellemesi Hakkında Bazı durumlarda sunucunuz güvenlik duvarı , saldırı koruma sistemleri veya bot filtreleme nedeniyle belirli IP adreslerinden gelen istekleri engelleyebilir. Bu sorunu çözmek için Kargo Entegratör'ün IP adresini Cloudflareda whitelist (güvenilir IP listesi) bölümüne eklemeniz gerekir. Kargo Entegratör IP adresleri IPv6 : 2a01:4f9:c012:ed4b::1 IPv4 : 37.27.30.151 Cloudflare İsteklerin Engellemesi Hakkında Cloudflare’ın IP adresinizi bot kontrolüne sokması, genellikle güvenlik ayarlarından kaynaklanır. Bu sorunu çözmek için aşağıdaki adımları izleyebilirsiniz: 1. IP Adresinizi Beyaz Listeye Ekleyin: - Cloudflare’da oturum açın. - İlgili alan adını seçin. - Security > Security Rules sekmesine gidin. - Create Rule altında Custom Rules bölümüne gidin. - Kargo Entegratörün IPV4 ve IPV6 ip adreslerini beyaz listeye ekleyin. Bunu yaparak, bizden gelen adresinden gelen tüm isteklerin engellenmemesini sağlayabilirsiniz. Bu adımları uyguladıktan sonra Cloudflare tarafından engellenip engellenmediğimizi durum değişikliğinde test edebilirsiniz.

Kargo Firmaları Entegrasyon Yapılandırmaları

Aras Kargo Entegrasyonu Nasıl Yapılır ?

youtube.com/watch?v=pHZEWcZguHQ&embeds_referring_euri=https%3A%2F%2Fyardim.gurmehub.com%2F&source_ve_path=MjM4NTE Önemli Not: Aras Kargo ile gönderi göndermek için öncelikle kargo firması ile iletişime geçerek API bilgisi alınmalıdır alınan API bilgileri ile aşağıdaki adımlar tamamlanmalıdır. 1-) Kayıt esnasında service metod “GetQueryJSON ” seçilmelidir. Canlı ortam bilgileri esasweb.araskargo.com.tr adresinde yer alan Entegrasyon Üyelikleri sayfasından üye olunarak oluşturulmaktadır. 2-) Gerekli bilgileri edindiğinizde Kargo Entegratör panelinize girip sol tarafta bulunan "Ayarlara" tıklayıp, "Kargo Hesapları" alanına sonrasında "Entegrasyon Ekle" butonuna tıklıyoruz. 3-) Açılan sayfada "Aras Kargo" ekle ikonuna tıklıyoruz. 4-) Aras Kargo panelinden edindiğiniz bilgileri ilgili alanlara giriyoruz. 5-) Kaydet butonuna tıkladıktan sonra Aras Kargo Entegrasyonumuz tamamlanmış oluyor. Sık Sorunlar Sorular 1.Bağlantı testi başarılı ancak gönderi oluşturulamıyor Bu durum genellikle API kullanıcısının yetki kısıtlamasından kaynaklanmaktadır. Size verilen kullanıcı bilgileri yalnızca "kargo izleme" yetkisine sahip olabilir. Şubenizle veya entegrasyonekibi@araskargo.com.tr adresiyle iletişime geçerek, gönderi oluşturma yetkisine sahip "SetOrder" kullanıcı bilgilerini talep etmelisiniz. 2.SetOrder bilgileri ile bağlantı testi başarısız Öncelikle uygulamaya girdiğiniz bilgilerin Esasweb panelindeki bilgilerle birebir aynı olduğunu kontrol ediniz. Bilgiler doğru olmasına rağmen hata devam ediyorsa, kullanıcı adınızın “%, &” gibi özel karakterler içerip içermediğini kontrol ediniz. Eğer bu karakterler mevcutsa, şubenizden özel karakter içermeyen yeni bir kullanıcı adı talep ediniz. 3.Gönderici Hesap Adresi Değeri Birden fazla çıkış noktanız (depo vb.) varsa, şubenin gönderinin hangi adresten yapılacağını ayırt edebilmesi için kullanılan bir bilgidir. Bu alanın doldurulması zorunlu değildir. 4.Konfigürasyon Kodu Bu bilgi şubeden temin edilmeli ve yalnızca iade gönderileri oluşturulacaksa gereklidir. İade süreçleri haricinde bu alanın doldurulması zorunlu değildir.

Kargo Firmaları Entegrasyon Yapılandırmaları

Yurtiçi Kargo Entegrasyonu Nasıl Yapılır?

Yurtiçi Kargo Entegrasyonu Videolu Rehber https://www.youtube.com/watch?v=42RqPQ0r1JY 1-) API Bilgilerinin Alınması Yurtiçi Kargo ile anlaşmanızdan sonra tarafınıza bir mail gönderilecektir. Bu bilgileri çalıştığınız kargo şubesinden e-posta yoluyla sizin tarafınıza gönderilecektir. Gönderici,Alıcı ve İade için ayrı tanımlamalar gönderilecek olup bir örneği aşağıda mevcuttur. 2-) Entegrasyon Bilgilerini Kargo Entegratöre Tanımlanması Gerekli bilgileri edindiğinizde Kargo Entegratör panelinize girip sol tarafta bulunan “Ayarlara” tıklayıp, “Kargo Hesapları” alanına sonrasında “Entegrasyon Ekle” butonuna tıklıyoruz. Açılan sayfada “Yurtiçi Kargo” ekle ikonuna tıklıyoruz. Yurtiçi Kargo'dan edindiğiniz bilgileri ilgili alanlara giriyoruz. Kaydet butonuna tıkladıktan sonra Yurtiçi Kargo Entegrasyonumuz tamamlanmış oluyor. Sık Sorunlar Sorular Cari Kodu Şube personelinin firmanıza ait anlaşmayı sistemde daha hızlı bulmasını sağlayan koddur. Bu alanın doldurulması zorunlu değildir. İade Özel Alan Bilgisi / FieldName Yurtiçi Kargo üzerinden iade barkodu oluşturmak istiyorsanız bu alanın doldurulması zorunludur. Bu bilgiyi şubenizden ‘FieldName’ olarak talep edebilirsiniz. Talep Kodu Şubenin gönderim tipini (kargo/dosya vb.) ayırt etmesini ve barkod okuma süreçlerini kolaylaştıran koddur. Bu alanın doldurulması zorunlu değildir. Desi Gönderim Yetkisi Anlaşmanız kapsamında gönderilerinizde desi bilgisini API üzerinden iletmeniz gerekiyorsa bu seçeneği aktif ediniz. Aktif edildiğinde, desi bilgisi siparişle birlikte kargo firmasına otomatik olarak iletilecektir.

Kargo Firmaları Entegrasyon Yapılandırmaları

Sürat Kargo Entegrasyonu Nasıl Yapılır?

https://www.youtube.com/watch?v=1tvJ3C4jmBU 1-) Sürat Kargo ve Kargo Entegratör'ü entegre etmek için öncelikle Sürat Kargo panelinize giriş yapın (https://ekargo.suratkargo.com.tr/) ardından sağ üst tarafta bulunan hesabım menüsü altından profilinizi görüntüleyin. 2-) Müşteri Bilgileriniz kısmından "Kodu" yazan alan mağaza kodunuzdur. bu bilgiyi kopyalayarak Kargo Entegratör tarafındaki gerekli alana yapıştırabilirsiniz. 3-) Hemen ardından "Entegrasyon Şifre Değişikli" kısmından "Kargo Gönderim Şifre Değişikliği" ve "Kargo Sorgulama Şifre Değişikliği" alanlarını değiştirin Kargo Gönderim Şifre Değişikliği kısmındaki eski şifreniz genel olarak varsayılan olarak **"123456"'**dır bu eski şifreyi kullanarak yeni bir şifre oluşturabilirsiniz. Aynı şekilde kargo sorgulama şifre değişikliği kısmında da yeni bir şifre oluşturabilirsiniz. Ayrıca tercihinize göre iki şifreyi aynı yapabilirsiniz. 4-) Ardından bu bilgileri Kargo Entegratör üzerinden gerekli alanlara doldurabilirsiniz. Mağaza No = Müşteri Kodu Mağaza Şifre : Kargo Gönderim Şifre Değişikliği Web Şifre : Kargo Sorgulama Şifre Değişikliği

Kargo Firmaları Entegrasyon Yapılandırmaları

DHL Kargo Entegrasyonu Nasıl Yapılır ?

https://www.youtube.com/watch?v=NNOLwO_Fsmk API Bilgilerinin alınması 1-) https://www.dhlexpresscommerce.com/ adresine giriş yaptığınız kullanıcı adı ve şifre ile kargo hesabınızı ekleyebilirsiniz. Öncesinde servis kullanım iznini kargo anlaşmasını sağladığınız şube ile görüşerek yetkilendirmeniz gerekiyor. Kargo Hesabı Nasıl Eklenir ? 2-)Gerekli bilgileri edindiğinizde Kargo Entegratör panelinize girip sol tarafta bulunan “Ayarlara” tıklayıp, “Kargo Hesapları” alanına sonrasında “Entegrasyon Ekle” butonuna tıklıyoruz. 3-) DHL Kargo paneline giriş yaparken kullandığınız bilgileri ilgili alanlara giriyoruz. 4-) Kaydet butonuna tıkladıktan sonra DHL Kargo Entegrasyonumuz tamamlanmış oluyor. Not: Platformunuz üzerinden (Shopify, Wordpress) uygulama ayarlarını senkronize etmeyi unutmayın! Sık Sorunlar Sorular Kullanıcı Adı / Şifre Hatası Bu hatayı, DHL eCommerce Online Şube giriş bilgileriniz değiştirildiğinde almaya başlarsınız. DHL eCommerce, güvenlik nedeniyle belirli aralıklarla şifre değişikliği talep edebilmektedir. Lütfen öncelikle DHL eCommerce Online Şube’ye giriş yaparak şifrenizi güncelleyiniz. Ardından güncel kullanıcı adı ve şifre bilgilerinizi entegrasyon ekranında ilgili alanlara girerek kaydediniz. DHL (MNG Kargo) Entegrasyonunda Şifre Güncelleme Gereksinimini Kaldırma (API Kullanıcısı Yöntemi) DHL Online Şube altyapısı, güvenlik politikaları nedeniyle ana kullanıcı şifrelerinin 6 ayda bir değiştirilmesini zorunlu tutmaktadır. Bu durum entegrasyonun kopmasına neden olabilir. Şifre değişiminden etkilenmemek ve entegrasyonun kesintisiz çalışmasını sağlamak için aşağıdaki adımları izleyerek bir alt kullanıcı (API hesabı) tanımlayabilirsiniz: 1. Alt Kullanıcı Oluşturma - DHL Online Şube paneline firmanızın ana müşteri numarası ve şifresi ile giriş yapın. - Menüden Ayarlar – Tanımlamalar sekmesine ilerleyin. - Bu bölümde, entegrasyonda kullanılmak üzere bir e-posta adresi tanımlayarak yeni bir hesap açın. 2. Yetkilendirme Ayarları - Kullanıcı oluşturma ekranındaki yetki listesinde; sipariş oluşturma (order create), gönderi güncelleme, silme ve takip işlemlerinin sağlıklı yapılabilmesi için tüm yetki kutucuklarını(olumsuzlar hariç) işaretleyin. - Yetkilerin tam verilmesi, API bağlantısında "yetki hatası" alınmasını engeller. 3. Entegrasyon Bilgilerinin Güncellenmesi - Tanımladığınız e-posta adresine sistem tarafından otomatik bir şifre gönderilecektir. - KargoEntegratör panelindeki DHL ayarlarınıza gidin. - Kullanıcı adı kısmına yeni oluşturduğunuz e-posta adresini, şifre kısmına ise e-postanıza gelen şifreyi yazarak kaydedin. Neden Bu Yöntemi Kullanmalısınız? Bu yöntemle oluşturulan e-posta tabanlı alt kullanıcı hesaplarında, ana hesaplarda olduğu gibi 6 ayda bir zorunlu şifre değişimi istenmemektedir. Böylece şifre yenileme işlemlerini takip etmenize gerek kalmadan entegrasyonunuzu stabil bir şekilde kullanmaya devam edebilirsiniz.

🖥️ Geliştiriciler İçin

Oluşturulan Barkodların 3. Parti Yazılımlar ile Paylaşılması (WooCommerce)

Üçüncü parti servislerin barkod verilerine erişebilmesini sağlamak amacıyla sistemimize yeni bir hook eklenmiştir. do_action( $this->prefix . '_shippment_status_update_' . $shipment_data['status'], $shipment_data, $order ); Bu hook, gönderi (shipment) durumu güncellendiğinde çalışır ve güncellenen gönderi verilerini ($shipment_data) ve ilgili sipariş nesnesini ($order) üçüncü parti entegrasyonlara aktarır. Kullanım Örneği Örneğin, bir barkod oluşturduğunuzda ve bu barkodu siparişe belirli bir veri formatında kaydetmek istediğinizde, aşağıdaki gibi bir işlem gerçekleştirebilirsiniz: add_action('gcargo_shippment_status_update_non_processed', function($shipment_data, $order) { add_post_meta($order->get_id(), 'gl_shipment_package_barcodes', $shipment_data['barcode']); }, 10, 2); Bu örnekte: - gcargo_shippment_status_update_non_processed hook’una abone olunmaktadır. - Gönderi verisinden ($shipment_data['barcode']) barkod alınmakta ve siparişe ($order) 'gl_shipment_package_barcodes' alanı olarak kaydedilmektedir. Faydaları - Üçüncü parti servisler kolayca barkod verisine erişebilir. - Barkod bilgisi, siparişle ilişkilendirilerek süreçler daha verimli yönetilebilir. - Esnek yapı sayesinde farklı gönderi durumlarına özel işlemler yapılabilir. Bizim Hesap için Barkod Paylaşımı BİZİM Hesap gibi 3. parti yazılımlar, oluşturulan barkodlara gl_shipment_package_barcodes alanı üzerinden erişebilir. Gönderi durumu güncellendiğinde çalışan do_action hook’u sayesinde bu barkod bilgisi siparişe kaydedilir. add_action('gcargo_shippment_status_update_non_processed', function($shipment_data, $order) { add_post_meta($order->get_id(), 'gl_shipment_package_barcodes', $shipment_data['barcode']); add_post_meta($order->get_id(), 'gl_tracking_link', $shipment_data['tracking_link']); add_post_meta($order->get_id(), 'gl_tracking_number', $shipment_data['tracking_number']); }, 10, 2); Bu sayede BİZİM Hesap, siparişten gl_shipment_package_barcodes alanını okuyarak barkoda erişebilir.