İçindekiler

  1. Giriş

  2. Dolibarr'ı WooCommerce ile Neden Entegre Etmelisiniz?

  3. Dolibarr ve WooCommerce Mimarisinin Genel Görünümü

  4. 2025'te Entegrasyon Yöntemleri

  5. Doğru Konnektör veya Modülü Seçme

  6. DoliWoo Kullanımı: Resmi Bağlayıcı

  7. DoliWoo'ya Alternatifler

  8. Dolibarr'ı WooCommerce Entegrasyonuna Hazırlama

  9. WooCommerce'i Dolibarr Entegrasyonuna Hazırlama

  10. Dolibarr'da API'yi Kurma

  11. API İsteklerinin Doğrulanması

  12. Ürünleri Senkronize Etme

  13. Müşterileri Senkronize Etme

  14. Siparişleri ve Faturaları Senkronize Etme

  15. Stok ve Envanter Yönetimi

  16. Entegrasyonda Vergi (TVA) Hususları

  17. Varyasyonların ve Niteliklerin Ele Alınması

  18. Otomasyon İpuçları: Cron İşleri ve Senkronizasyon Tetikleyicileri

  19. Veri Eşleme ve Özel Alan İşleme

  20. Sık Karşılaşılan Sorunları Giderme

  21. Güvenlik ve Erişim Kontrolü

  22. Yüksek Hacimli Mağazalar için Performans Optimizasyonu

  23. Yedekleme ve Kurtarma Stratejileri

  24. Fransa ve AB'de Yasal Uyumluluk

  25. Bir Geliştiriciyi İşe Almayı Ne Zaman Düşünmelisiniz

  26. Sonuç: ERP ile eTicaretin Düzenlenmesi

1. Giriş

2025'te, e-ticaret platformları ve ERP sistemleri arasındaki kusursuz entegrasyon her zamankinden daha kritik. ERP olarak Dolibarr'ı ve çevrimiçi mağazaları için WooCommerce'i kullanan işletmeler için, iki sistem arasındaki boşluğu kapatmak zamandan tasarruf sağlayabilir, hataları azaltabilir ve operasyonların birleşik bir görünümünü sağlayabilir. Bu kılavuz, Dolibarr'ı gereksiz ayrıntılar olmadan, sadece eyleme dönüştürülebilir içgörülerle WooCommerce'e nasıl bağlayacağınızı gösterir.

2. Dolibarr'ı WooCommerce ile Neden Entegre Etmelisiniz?

Entegrasyon şunları sağlar:

  • Ürün kataloglarının otomatik senkronizasyonu

  • Mağaza ve depo arasında gerçek zamanlı stok güncellemeleri

  • Kusursuz siparişten faturaya iş akışları

  • Birleşik müşteri veritabanı

  • Doğru KDV ve muhasebe ihracatı

Entegrasyon olmadan, manuel veri girişi, tekrarlanan müşteriler, güncel olmayan envanter ve gecikmiş sipariş işleme gibi hataya açık döngüde sıkışıp kalırsınız.

3. Dolibarr ve WooCommerce Mimarisinin Genel Görünümü

Dolibarr PHP ile oluşturulmuş, modüler tasarıma sahip ve REST API'lerini destekleyen açık kaynaklı bir ERP/CRM platformudur.

WooCommerce PHP ve MySQL üzerine kurulu bir WordPress eklentisidir. REST API'lerini destekler ve standart WordPress kimlik doğrulamasını kullanır.

Her iki platform da API'ler, web kancaları veya üçüncü taraf ara yazılımları aracılığıyla iletişim kurabilir. Amaç, "aynı dili konuştuklarından" ve senkronize kaldıklarından emin olmaktır.

4. 2025'te Entegrasyon Yöntemleri

Dolibarr ve WooCommerce'i şu şekilde bağlayabilirsiniz:

  • Yerel bağlayıcılar (örneğin, DoliWoo)

  • Üçüncü taraf ara yazılım (Zapier, Make, Integromat)

  • API'leri kullanarak özel PHP betikleri veya eklentileri

  • iPaaS platformları (Hizmet Olarak Entegrasyon Platformu)

Çoğu durumda DoliWoo veya özel bir konektör en iyi performansı ve kontrolü sunar.

5. Doğru Konnektör veya Modülü Seçmek

Şu özelliklere sahip modülleri arayın:

  • Dolibarr 17+ ve WordPress 6.x ile uyumludur

  • Çift yönlü senkronizasyonu destekler

  • Ürünleri, siparişleri, stokları ve müşterileri yönetin

  • Günlükleri ve hata işlemeyi sağlayın

  • Aktif olarak sürdürülmektedir

Topluluk modüllerini kullanıyorsanız yorumları okuyun ve GitHub etkinliğini kontrol edin.

6. DoliWoo Kullanımı: Resmi Bağlayıcı

DoliWoo WooCommerce'i doğrudan Dolibarr'a bağlamak için tasarlanmış bir eklentidir. Özellikleri şunlardır:

  • Siparişleri müşteri siparişleri veya faturalar olarak Dolibarr'a senkronize etme

  • WooCommerce'den Dolibarr ürünleri oluşturma

  • Stok seviyelerinin her iki yönde senkronize edilmesi

  • Müşteri kayıtlarının otomatik güncellenmesi

Kurulum şunları içerir:

  1. WordPress'e DoliWoo eklentisini yükleme

  2. Dolibarr'da REST API'yi Etkinleştirme

  3. Dolibarr API kimlik bilgileri oluşturuluyor

  4. Alanları WooCommerce'den Dolibarr modüllerine eşleme

7. DoliWoo'ya Alternatifler

DoliWoo ihtiyaçlarınızı karşılamıyorsa şunları düşünün:

  • WooDolibarr Senkronizasyonu: Hafif, temel senkronizasyonu destekler

  • Zapier veya Make: Kodlama gerektirmeyen küçük otomasyonlar için idealdir

  • Özel PHP entegrasyonu: Tam kontrol ve esneklik için

Her seçeneğin performans, destek ve maliyet açısından avantajları ve dezavantajları vardır.

8. Dolibarr'ı WooCommerce Entegrasyonuna Hazırlama

Hazırlanışı adımları:

  • Dolibarr'ı en son kararlı sürüme güncelleyin

  • REST API modülünü etkinleştir

  • Sınırlı erişime sahip kullanıcı profili altında API anahtarları oluşturun

  • Yeni müşteriler için varsayılan üçüncü taraf ayarlarını tanımlayın

Ürün ve müşteri verilerinizin temiz ve tutarlı biçimde biçimlendirildiğinden emin olun.

9. WooCommerce'i Dolibarr Entegrasyonuna Hazırlama

WooCommerce tarafında:

  • Kalıcı bağlantıların etkinleştirildiğinden emin olun

  • HTTPS ve geçerli bir SSL sertifikası kullanın

  • Altında bir API anahtarı oluşturun WooCommerce > Ayarlar > Gelişmiş > REST API

  • Entegrasyon için Okuma/Yazma erişimini seçin

Dolibarr'a bağlanmadan önce WooCommerce API'nizi Postman veya curl ile test edin.

10. Dolibarr'da API'yi Kurma

Şu yöne rotayı ayarla Kullanıcılar ve Gruplar > API Anahtarları. Yeni bir anahtar oluşturun ve izinleri ayarlayın:

  • Ürünlere, Siparişlere, Üçüncü Taraflara, Faturalara, Stoklara Okuma/Yazma erişimi

  • Belirli bir IP'ye erişimi kısıtlayın veya belirteçleri güvenli bir şekilde kullanın

WooCommerce'den bağlanırken bu anahtarı kullanacaksınız.

11. API İsteklerinin Doğrulanması

Her iki sistem de token tabanlı veya temel kimlik doğrulamayı destekler. Güvenli uygulamalar şunları içerir:

  • Yalnızca HTTPS trafiği

  • Token son kullanma tarihi ve yenileme döngüleri

  • Her istek için erişim ve hataların günlüğe kaydedilmesi

12. Ürünleri Senkronize Etme

Ürün SKU'sunu benzersiz tanımlayıcı olarak ayarlayın. Şunlara karar verin:

  • Dolibarr ürünlerini WooCommerce'e taşıyor

  • WooCommerce, Dolibarr'da ürünler oluşturur

En iyi uygulama: Dairesel senkronizasyon sorunlarını önlemek için her veri türü için bir sistemi ana sistem olarak tanımlayın.

13. Müşterileri Senkronize Etme

Müşteriler şu şekilde eşleştirilebilir:

  • E-posta

  • Harici kimlik veya referans alanı

WooCommerce'den gelen yeni müşteriler, uygun KDV işleme ve bölgesel bilgilerle Dolibarr'da otomatik olarak oluşturulmalıdır.

14. Siparişleri ve Faturaları Senkronize Etme

İş akışınızı belirleyin:

  • WooCommerce siparişi bir Dolibarr müşteri siparişi oluşturur

  • Dolibarr, sipariş durumu değiştiğinde otomatik olarak bir fatura oluşturur

  • Fatura PDF'i WooCommerce'e veya müşteri e-postasına geri gönderilir

Bu adım, ERP'nizin tekliften teslimata kadar sipariş yaşam döngüsünü yönetmesini sağlar.

15. Stok ve Envanter Yönetimi

Stok seviyelerini yönetmek için Dolibarr'daki depo modülünü kullanın. Entegrasyon şunları yapabilir:

  • WooCommerce siparişi verildiğinde stoğu düşürün

  • Güncellenen stok sayımlarını her gece veya gerçek zamanlı olarak senkronize edin

Aşırı satıştan kaçınmak için stok senkronizasyon sıklığınızı dikkatli bir şekilde belirleyin.

16. Entegrasyonda Vergi (TVA) Hususları

WooCommerce vergi sınıflarını Dolibarr KDV oranlarına eşleyin. Şunlar için kurallar belirleyin:

  • Yurtiçi ve yurtdışı KDV

  • Fatura adresine göre KDV'nin otomatik hesaplanması

  • AB B2B müşterileri için muafiyetler

Verginin doğru uygulandığından emin olmak için birden fazla fatura senaryosunu test edin.

17. Varyasyonların ve Niteliklerin Ele Alınması

WooCommerce boyut, renk vb. için değişken ürünler kullanır. Bunları Dolibarr ürün varyantlarına eşleyin veya özel alanlar kullanın.

Bazı modüller özniteliklerin içe aktarılmasını destekler; diğerleri özel geliştirme gerektirir.

18. Otomasyon İpuçları: Cron İşleri ve Senkronizasyon Tetikleyicileri

Cron işlerini şu amaçlarla kullanın:

  • Siparişleri her 15 dakikada bir senkronize edin

  • Stok seviyelerini saatlik olarak güncelleyin

  • Oturum belirteçleri sona ererse her gece API'leri yeniden bağlayın

Canlı mağazaya uygulamadan önce otomasyonu aşamalı olarak test edin.

19. Veri Eşleme ve Özel Alan İşleme

Bazı işletmeler şu gibi özel alanlar kullanır:

  • Teslimat talimatları

  • Müşteri segmentasyonu

  • Sadakat kodları

Entegrasyonunuzun bu alanların geçirilmesini desteklediğinden emin olun veya uç noktaları bunları işleyecek şekilde özelleştirin.

20. Sık Karşılaşılan Sorunları Giderme

  • Siparişler senkronize olmuyor mu? API günlüklerini kontrol edin

  • Stok seviyeleri yanlış mı? Ürün kimliklerini ve eşleme kurallarını doğrulayın

  • Vergi uyumsuzlukları mı? WooCommerce ve Dolibarr bölgesel vergi ayarlarını kontrol edin

  • Zaman aşımı veya hata? Sunucu PHP sınırlarını ve API oran sınırlarını optimize edin

21. Güvenlik ve Erişim Kontrolü

Güvenlik açısından en iyi uygulamalar:

  • HTTPS kullanın

  • API anahtarlarını düzenli olarak döndürün

  • Erişim kapsamını role göre sınırla

  • Günlüğe kaydetmeyi etkinleştirin ve trafiği izleyin

Dolibarr örneğinizi diğer kritik görev arka uçlarında olduğu gibi koruyun.

22. Yüksek Hacimli Mağazalar için Performans Optimizasyonu

Yüksek işlem hacmine sahip mağazalar için:

  • Mümkün olduğunda API yanıtlarını önbelleğe alın

  • Toplu uç noktaları kullan (toplu senkronizasyon)

  • Senkronizasyon görevlerini arka plan çalışanlarına devredin

  • Dolibarr'da veritabanı sorgularını optimize edin

23. Yedekleme ve Kurtarma Stratejileri

Her zaman:

  • Dolibarr ve WooCommerce veritabanlarını günlük olarak yedekleyin

  • Yapılandırma betikleri için sürüm denetimini kullanın

  • Test geri alma prosedürleri üç ayda bir

Bu, senkronizasyon hataları veya sistem çökmeleri durumunda kesinti süresini en aza indirir.

24. Fransa ve AB'de Yasal Uyumluluk

Sisteminizin aşağıdakilerle uyumlu olduğundan emin olun:

  • Müşteri verileri için GDPR

  • Fransız TVA dolandırıcılık karşıtı düzenlemeleri

  • Kamu kurumlarıyla yapılan işlemlerde elektronik fatura zorunluluğu (Chorus Pro aracılığıyla)

Denetim amaçları doğrultusunda tüm API işlemlerinin açık kayıtlarını tutun.

25. Bir Geliştiriciyi İşe Almayı Ne Zaman Düşünmelisiniz?

Aşağıdaki durumlarda profesyonel birini çağırın:

  • Entegrasyon ihtiyaçlarınız karmaşıktır

  • Çoklu depo veya B2B kademeli fiyatlandırmaya ihtiyacınız var

  • Birden fazla WooCommerce mağazasıyla senkronize etmeyi planlıyorsunuz

  • Özel raporlama veya analiz entegrasyonuna ihtiyacınız var

26. Sonuç: ERP ile eTicaretin Düzenlenmesi

Dolibarr'ı 2025'te WooCommerce ile entegre etmek sadece mümkün değil, aynı zamanda akıllıca. Doğru bağlayıcı, temiz kurulum ve dikkatli planlama ile gereksiz işleri ortadan kaldırabilir, doğruluğu artırabilir ve ekibinize işinizin her parçası hakkında gerçek zamanlı içgörü sağlayabilirsiniz. İster yeni kurulan bir şirket olun ister ölçeklenen bir kuruluş, ERP'nizi ve e-ticaretinizi bağlamak, atlayamayacağınız bir oyun değiştiricidir.