WooCommerce Eklentisi

WooCommerce ilk Kurulum / API Anahtarı Edinme

Kargo Entegratör eklentimizi ücretsiz bir şekilde WordPress eklenti mağazasında “Kargo Entegratör” olarak aratarak ya da ürün linki üzerinden indirebilirsiniz. API Anahtarını Edinin Kargo Entegratör eklentimizi WooCommerce mağazanıza kurduktan sonra app.kargoentegrator.com adresinden API Anahtarını edinmeniz gerekmektedir. app.kargoentegrator.com kaydınızı tamamladıktan sonra Ayarlar > Satış Kanalları / API sayfası üzerinden API Anahtarınızı Kopyalayabilirsiniz. API Anahtarınızı kopyaladıktan sonra eklentinin Ayarlar > Bağlantılar sayfası üzerinden kopyaladığınız API anahtarını girin ve ayarlarınızı kaydedin. Artık kargo firmaları ile entegre olabilir ve WooCommerce mağazanız üzerinden kargo gönderimleri sağlayabilirsiniz.

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.

FedEx Ship Manager ve REST API Entegrasyon Rehberi

Başlangıç Bilgisi: WooCommerce Entegrasyonu WooCommerce siparişlerinizi FedEx Ship Manager ekranınıza entegre edebilirsiniz. Bunun için gönderi hazırlama e-ticaret panelini ziyaret etmeniz önerilir. 1. Adım: Developer Portal Girişi FedEx REST API entegrasyonu için öncelikle https://www.google.com/search?q=developer.fedex.com adresine giderek kullanıcı adınız ve şifrenizle "Oturum Aç" butonuna tıklayın. 2. Adım: Projelerim Menüsü ve Kuruluş Oluşturma Sol menüden "Projelerim" sekmesine tıklayın ve yeni bir yapı kurmak için "KURULUŞ OLUŞTUR" butonuna basın. 3. Adım: API İhtiyacı ve Firma Bilgileri API erişimine neden ihtiyaç duyduğunuzu belirten seçeneği seçin ve şirketinizin resmi adı ile web sitesi bilgilerini doldurun. 4. Adım: Proje Oluşturma Seçeneği Kuruluş ayarlarınızı tamamladıktan sonra ana panelde yer alan "Bir API projesi oluştur" butonunu kullanarak teknik kurulumu başlatın. 5. Adım: Proje İsimlendirme Projenize sistemde tanınması için bir isim verin (Örn: FedEx Test Projesi) ve kullanım amacınızı tekrar teyit edin. 6. Adım: API Servislerinin Seçimi Entegrasyonda kullanacağınız "Ship API", "Track API" ve "Postal Code Validation API" gibi gerekli servisleri işaretleyerek ilerleyin. 7. Adım: Lisans Sözleşmesi Onayı FedEx Developer Portal Lisans Sözleşmesi'ni ve kullanım koşullarını kabul ettiğinizi belirten kutucukları işaretleyip "KABUL EDİYORUM" butonuna tıklayın. 8. Adım: Ülke ve Bildirim Ayarları Test hesabı atanabilmesi için ülke olarak "Türkiye"yi seçin ve e-posta bildirim tercihlerinizi yaparak "OLUŞTUR" butonuna basın. 9. Adım: Test Anahtarlarını (Sandbox) Edinme Sistem tarafından oluşturulan "API Anahtarı" ve "Gizli Anahtar" (Secret Key) bilgilerini test ortamında kullanmak üzere kaydedin. 10. Adım: Üretim (Canlı) Ortamına Geçiş Canlı API anahtarlarını almak için proje genel bakış ekranında "Üretim Anahtarı" sekmesine geçin ve "Hesap Ekle" butonuna tıklayın. 11. Adım: 9 Haneli Hesap Numarası Girişi Şirketinize ait 9 haneli FedEx hesap numarasını ve sistemde kayıtlı olan resmi fatura adres bilgilerinizi eksiksiz girin. 12. Adım: Yetki Beyanı Bu projeyi şirketiniz adına oluşturmaya ve yönetmeye yetkili olduğunuzu beyan eden onay kutucuğunu işaretleyin. 13. Adım: EULA Sözleşmesi Onayı Canlı ortam kullanımı için hazırlanan Son Kullanıcı Lisans Sözleşmesi'ni (EULA) gözden geçirin ve onaylayarak hesabı projenize dahil edin. 14. Adım: Hesabın Projeye Atanması Eklediğiniz canlı hesabı proje listesinden seçerek "Devam Et" butonuna basın ve yapılandırmayı ilerletin. 15. Adım: Canlı API Anahtarlarını Kaydetme Canlı (Production) ortamda gönderi oluşturmanızı sağlayacak olan asıl API Key ve Secret Key değerlerini kopyalayarak güvenli bir yere not edin. 16. Adım: Sertifikasyon ve Aktivasyon Tamamlama Bazı servislerin canlıda aktif olması için gereken sertifikasyon sürecini başlatmak üzere "Go to API Certification" butonuna tıklayarak işlemi bitirin.

cURL error 28: Connection timed out after 10001 milliseconds Hatası ve Çözümü

Bu hata, WooCommerce sitenizin barındığı sunucunun, Kargo Entegratör sunucularına belirlenen süre (10 saniye) içerisinde bağlanamadığını ifade eder. Teknik olarak sunucular arası iletişim bir engel nedeniyle kurulamamaktadır. Muhtemel Nedenler Güvenlik Duvarı (Firewall) Engeli: Sunucunuzun güvenlik ayarları Kargo Entegratör IP adresini "tehdit" olarak algılayıp bloklamış olabilir. Sunucu Kaynak Yetersizliği: CPU veya RAM limitlerinin dolması nedeniyle sunucu dış bağlantı isteğini başlatamıyor olabilir. DNS veya Ağ Gecikmeleri: Sunucu tarafındaki anlık ağ dalgalanmaları. Çözüm Önerileri 1. IP Adresini Beyaz Listeye (Whitelist) Ekleme En yaygın çözüm yolu budur. Sitenizin sunucusuna Kargo Entegratör'den gelen isteklere izin vermesi gerektiğini söylemelisiniz. Adım 1: Hosting sağlayıcınıza veya sistem yöneticinize bir destek bileti (ticket) açın. Adım 2: Şu mesajı iletin: "Kargo Entegrasyon servisimizin çalışabilmesi için 37.27.30.151 IP adresinin sunucu güvenlik duvarında (Firewall)gibi güvenlik katmanlarında beyaz listeye (whitelist) eklenmesini rica ederiz." 2. Sunucu Performans Kontrolü IP tanımlamasına rağmen sorun sürüyorsa sunucu yükünü kontrol edin: Sunucunuzun CPU ve RAM kullanımının %90'ın üzerinde olup olmadığını kontrol edin. WordPress tarafında çok fazla ağır eklenti kullanılıyorsa, bu durum cURL isteklerini yavaşlatabilir. 3. Zaman Aşımı Limitini Artırma (Opsiyonel) Eğer sunucunuz yanıt vermekte sadece "biraz" geç kalıyorsa, PHP max_execution_time değerinin çok düşük olmadığından emin olun (Önerilen: 60 veya 90). Bu hata doğrudan Kargo Entegratör ile ilgili değil, sitenizin barındığı sunucu ortamının dış dünyaya ulaşamaması ya da yavaş ulaşması ile ilgilidir. Sorunun kalıcı çözümü için hosting firmanızın destek ekibiyle koordineli ilerlemeniz önerilir.

Cloudflare ve Sunucu Güvenlik Duvarı Kaynaklı 403 Hatalarının Çözümü

Kargo Entegratör'ün WooCommerce sitelerine gönderdiği kargo bilgisi güncellemeleri veya API istekleri bazen 403 Forbidden hatasına düşebilir. Bu durum genellikle Cloudflare üzerindeki özel güvenlik kuralları veya sunucu tarafındaki bot koruma sistemlerinden kaynaklanır. 1. Cloudflare Güvenlik Kurallarının Yapılandırılması (WAF) Eğer sitede yurtdışı kaynaklı botları engellemek için özel kurallar (Custom Rules) tanımlıysa, Kargo Entegratör servisinden gelen istekler bu filtreye takılabilir. Çözüm: Güvenlik kuralını, güvenilir servisleri ve belirli URL yapılarını dışarıda tutacak (bypass) şekilde güncelleyin. - İstisna Tanımlanacak Alanlar: - Known Bots: Açık (On) konuma getirilmelidir. - URI Path: /gcargo içeren veya kargo API uç noktası olan yollar kuraldan muaf tutulmalıdır. - Örnek Expression: (ip.src.country ne "TR" and not cf.client.bot and not http.request.uri contains "gcargo") 2. User-Agent Eksikliği ve Header Transform Rule Bazı sunucu güvenlik yazılımları (örneğin Imunify360), gelen HTTP isteklerinde User-Agent bilgisi boş olduğunda isteği otomatik olarak reddeder (403 hatası) veya sonsuz döngüye (loop) sokar. Kargo servislerinden gelen bazı webhook veya cron isteklerinde bu başlık boş olabilir. Çözüm: Cloudflare üzerinde bir "HTTP Request Header Transform Rule" oluşturarak, belirli isteklere yapay bir User-Agent tanımlanmalıdır. - Kural Mantığı: Eğer istek URL'si kargo servisiyle ilgili anahtar kelimeleri (gcargo, wc-api vb.) içeriyorsa, bu isteğe sabit bir tarayıcı kimliği atayın. - Yapılandırma: - Field: User-Agent - Value: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 (veya benzeri güncel bir string). Özet Sonuç Bu iki adım uygulandığında; 1. Cloudflare yurtdışı bot korumasına takılan servis istekleri "istisna" kapsamına alınır. 2. Sunucu tarafında "boş User-Agent" nedeniyle oluşan engellemeler, Cloudflare üzerinden başlık manipülasyonu yapılarak aşılır.