WooCommerce için Cari Ön Muhasebe Entegrasyonu

Açıklama

WooCommerce için Cari.com.tr Entegrasyonu eklentisi, WooCommerce mağazanızdaki siparişleri Cari.com.tr muhasebe sistemine otomatik olarak aktarmanıza olanak tanır.

Dış hizmetler

Bu eklenti, WooCommerce verilerinizi Cari.com.tr muhasebe sistemiyle senkronize etmek için Cari.com.tr API’sini kullanır.

Fatura oluşturmak ve müşteri kayıtlarını güncellemek için https://sistem.cari.com.tr/api uç noktasına bağlanır.
Bir sipariş, yapılandırılmış sipariş durumuna (örn. Tamamlandı) ulaştığında veya manuel olarak senkronize edildiğinde, eklenti aşağıdaki verileri Cari.com.tr API’sine güvenli bir şekilde gönderir:
* Sipariş Ayrıntıları: Fatura ön eki, sipariş alt toplamı, vergi tutarları ve genel toplam.
* Müşteri Verileri: Fatura adı, şirket adı, adres, telefon, e-posta ve Vergi/Kimlik numaraları.
* Ürün Verileri: Satır öğeleri, miktarlar, alt toplam fiyatları ve vergi oranları.

Bu harici hizmet, eklentinin temel işlevselliği için gereklidir. Bu hizmet, Cari.com.tr tarafından sağlanmaktadır. Bu eklentiyi kullanarak, Hizmet Şartları ve Gizlilik Politikası’nı kabul etmiş olursunuz.

Özellikler

• Otomatik Senkronizasyon: Siparişler belirli durumlara ulaştığında Cari.com.tr’ye otomatik olarak aktarılır.
• Manuel Aktarım: Tek tek veya toplu siparişleri manuel olarak senkronize edin.
• Özelleştirilebilir Fatura Biçimi: Kendi fatura ön ekinizi tanımlayın.
• Müşteri Yönetimi: Müşteri bilgilerini otomatik olarak senkronize edin.
• Ayrıntılı Günlük Kaydı: Tüm API isteklerini ve yanıtlarını günlüğe kaydeder.
• Hata Yönetimi: Aktarım hatalarını takip edin ve yönetin.
• Modern UI: Şık ve kullanıcı dostu yönetim paneli.
• HPOS Uyumlu: WooCommerce Yüksek Performanslı Sipariş Depolama için tam destek.
• Türkçe Dil Desteği: Tamamen yerelleştirilmiştir (onaylandıktan sonra, translate.wordpress.org üzerinden).

Nasıl Çalışır?

1. Eklentiyi yükleyin ve etkinleştirin.
2. Cari.com.tr > Ayarlar sayfasına gidin ve firma kodunuzu girin.
3. Bağlantıyı kontrol edin.
4. Otomatik senkronizasyonu tetiklemesi gereken sipariş durumlarını seçin.
5. Siparişleriniz otomatik olarak senkronize edilmeye başlayacak!

Gereksinimler

• WordPress 5.8 veya üstü
• WooCommerce 5.0 veya üstü
• PHP 7.4 veya üstü
• Etkin bir Cari.com.tr hesabı
• Cari.com.tr şirket kodu

Destek

Sorularınız veya sorunlarınız için:
* Destek Forumu: https://wordpress.org/support/plugin/cari-com-tr-integration-woocommerce/
* Kılavuz: https://cari.com.tr/

Ek Bilgiler

Güvenlik

Bu eklenti aşağıdaki güvenlik önlemlerini içerir:
* Nonce doğrulaması
* Kullanıcı yetki kontrolleri
* SQL enjeksiyonuna karşı koruma
* XSS’ye karşı koruma
* Veri temizleme ve doğrulama

Performans

• Veritabanı sorgularının en aza indirilmesi
• Optimize edilmiş API istekleri
• Asenkron işleme desteği
• HPOS ile elde edilen performans artışları

Uyumluluk

• WordPress çoklu site desteği
• WPML ile uyumlu
• PHP 8.x ile uyumlu
• WooCommerce HPOS (Yüksek Performanslı Sipariş Depolama) ile uyumlu
• WooCommerce 8.x+ ile uyumlu

Geliştirici Notları

Eklenti, kancalar ve filtreler içerir:

Filtreler:
* caricomtr_invoice_data – Fatura verilerini özelleştir
* caricomtr_customer_data – Müşteri verilerini özelleştir
* caricomtr_invoice_serie – Fatura ön ekini özelleştir
* caricomtr_invoice_number – Fatura sıra numarasını özelleştir
* caricomtr_logs_retention_days – Günlük saklama süresini değiştir
* caricomtr_remove_data_on_uninstall – Kaldırma sırasında verileri sil

İşlemler:
* caricomtr_before_sync – Senkronizasyon öncesi
* caricomtr_after_sync – Senkronizasyon sonrası
* caricomtr_sync_error – Senkronizasyon hatası durumunda
* caricomtr_cleanup_logs – Günlük temizleme görevi

Kullanım örneği:

add_filter('caricomtr_invoice_data', function($data, $order) {
    $data['fatura']['seri_no'] = 'CUSTOM';
    return $data;
}, 10, 2);