=== Yurtiçi Kargo Entegrasyonu ===
Contributors: wpentegrasyon
Tags: woocommerce, yurtici, kargo, sms, shipping, turkey
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WooCommerce siparişleri için Yurtiçi Kargo SOAP entegrasyonu ve SMS bildirimleri. WP Entegrasyon SaaS API'sine bağlanır.

== Description ==

Yurtiçi Kargo Entegrasyonu eklentisi, WooCommerce mağazanızı **WP Entegrasyon SaaS** platformuna bağlar. SOAP karmaşıklığıyla uğraşmadan kargo gönderisi oluşturabilir, takip numarası alabilir ve müşterilerinize otomatik SMS bildirimi gönderebilirsiniz.

= Özellikler =

* WooCommerce sipariş "tamamlandı" durumunda otomatik kargo oluşturma
* Sipariş listesinde takip numarası kolonu
* Sipariş detayında kargo durumu sorgulama
* Müşteriye otomatik SMS bildirimi (idempotency korumalı — aynı SMS iki kez gönderilmez)
* Düşük SMS bakiyesi uyarısı (admin notice)
* Tüm istekler metadata olarak loglanır (mesaj içeriği veya API anahtarı asla loglanmaz)
* HPOS (High-Performance Order Storage) uyumlu

= Gerekenler =

* WooCommerce 7.0+
* PHP 7.4+
* WordPress 6.0+
* WP Entegrasyon SaaS API anahtarı (https://wpentegrasyon.com adresinden)
* Yurtiçi Kargo entegrasyon hesabı (wsUserName/wsPassword)

== Installation ==

1. Eklentiyi WordPress yöneticisinden yükleyin veya `/wp-content/plugins/yurtici-kargo-entegrasyonu/` klasörüne yükleyin.
2. WordPress yönetiminden eklentiyi etkinleştirin.
3. **WooCommerce → Yurtiçi Kargo** sayfasına gidin.
4. SaaS API anahtarınızı, Yurtiçi Kargo kimlik bilgilerinizi girin.
5. "Bağlantıyı test et" düğmesiyle yapılandırmayı doğrulayın.
6. SMS bildirimini ve şablonunu ihtiyacınıza göre özelleştirin.

== Frequently Asked Questions ==

= API anahtarımı nereden alabilirim? =

https://panel.wpentegrasyon.com adresinden hesap oluşturup panelde "API Anahtarları" sayfasından üretebilirsiniz. Anahtarın `relay:yurtici`, `notify:send` ve `balance:read` izinlerine sahip olması gerekir.

= SMS gönderimi nasıl ücretlendiriliyor? =

Pay-as-you-go: 1 segment = 1.20 TL. GSM-7 alfabesi (Türkçe karakter içermeyen) mesajlar 160 karaktere kadar tek segmenttir. Türkçe karakterler içeren mesajlar UCS-2 olarak kodlanır ve 70 karakterde bir segment kullanır.

= Aynı sipariş için iki kez SMS gönderilir mi? =

Hayır. Eklenti her gönderim için sipariş kimliği + hedef durum + şablon hash'inden türetilen bir `idempotencyKey` üretir. Aynı anahtar 24 saat içinde tekrar kullanılırsa SaaS sunucu çoğaltmayı engeller.

= Eklenti raw SOAP istekleri yapıyor mu? =

Hayır. Tüm SOAP karmaşıklığı SaaS tarafında çözülür. Eklenti yalnızca JSON HTTPS istekleri yapar.

= Verilerim nerede saklanıyor? =

* WordPress içinde: API anahtarı (wp_options'da), Yurtiçi kimlik bilgileri (wp_options'da), istek metadata logları (yke_request_log tablosu).
* SaaS tarafında: SMS metadata (maskelenmiş telefon, segment sayısı, durum), proxy log metadata. Mesaj içeriği veya raw SOAP body **asla** saklanmaz.

== Screenshots ==

1. Ayarlar sayfası — API anahtarı ve Yurtiçi kimlik bilgileri
2. Sipariş listesinde takip numarası kolonu
3. Sipariş detayında "Kargo durumunu sorgula" düğmesi
4. SMS bakiyesi düşükse admin notice

== Changelog ==

= 1.0.0 =
* İlk sürüm
* WooCommerce sipariş tamamlandı kancası → otomatik kargo oluşturma
* SMS bildirim altyapısı (idempotency korumalı)
* HPOS uyumluluğu
* Admin notice — düşük bakiye / yapılandırma eksik

== Upgrade Notice ==

= 1.0.0 =
İlk sürüm.
