Bağlantı: WooCommerce REST API
API anahtarını oluşturmak
WooCommerce mağazaları dış sistemlerle REST API üzerinden konuşur. Bağlantı için WordPress yönetim panelinizde WooCommerce ayarlarının gelişmiş bölümünden bir API anahtarı oluşturursunuz. Anahtara verilecek yetkiyi kurulumda ekip size söyler. Oluşan anahtar bilgilerini earsivfaturaportal panelinde WooCommerce kanalına girersiniz; sistem mağazanıza ulaşıp bağlantıyı doğrular.
Anahtarı oluşturan kullanıcının mağazada yönetici yetkisine sahip olması gerekir. Anahtar bilgilerini e-postayla ya da mesajla dolaştırmak yerine doğrudan portala girmeniz daha güvenlidir; bilgiler portalda şifreli saklanır.
Doğrulama sorunları
Doğrulama başarısız olursa anlaşılır bir hata mesajı görürsünüz. WooCommerce'te bağlantıyı engelleyen şey bazen sunucu tarafındadır: güvenlik eklentileri, güvenlik duvarı kuralları ya da barındırma ayarları dışarıdan gelen API isteklerini engelleyebilir. Böyle bir durumda hata mesajı ve kurulum desteğiyle sorunun nerede olduğunu birlikte bulursunuz. Gerekirse barındırma firmanızdan ya da sitenizi kuran ekipten destek istemeniz gerekebilir.
Sipariş durumları ve faturalama anı
WooCommerce'te bir sipariş farklı durumlardan geçer: ödeme bekleyen, işleme alınan, tamamlanan, iptal edilen gibi. Hangi durumda faturanın kesileceği, ödeme yöntemlerinize göre önem kazanır. Kapıda ödeme ya da havale gibi yöntemlerde sipariş, ödeme gelmeden oluşabilir. Ödemesi tamamlanmamış ve iptal ihtimali olan siparişlerin faturalanması, sonradan iptal ve iade işlemi doğurabilir.
Bu yüzden otomatik kesimi açmadan önce:
- Mağazanızda hangi ödeme yöntemlerinin açık olduğunu listeleyin.
- Her yöntemde siparişin hangi durumda oluştuğunu not edin.
- Faturalamanın hangi anda yapılması gerektiğini kurulumda ekiple ve mali müşavirinizle birlikte netleştirin.
- İlk faturaları deneme ortamında kontrol edin.
Kararsız kaldığınız dönemde otomatik kesimi kapalı tutabilirsiniz; siparişler listede bekler ve siz seçerek ya da toplu olarak faturalarsınız. Ayrıntılar otomatik fatura kesme rehberinde.
Sipariş portala geldikten sonra
WooCommerce siparişi portaldaki sipariş listesine düştüğünde diğer kanallardaki siparişlerle aynı kurallar geçerlidir:
- Sipariş tutarı kontrol edilir; doğrulanamazsa fatura kesilmez, sipariş onaya bırakılır.
- Belge türü alıcıya göre belirlenir; vergi numarası olan alıcının kayıt durumu sorgulanır, bireysel alıcıya e-Arşiv Fatura kesilir.
- Faturaya serideki sıradaki numara verilir, ardından fatura GİB'e gönderilir.
- Müşteri faturayı siparişte yazdığı e-posta adresinden alır; WooCommerce tarafında fatura linki için bir alan kullanılabiliyorsa link de siparişe eklenir.
Bir siparişe yalnızca bir fatura kesilir. WooCommerce'te bir sipariş güncellendiğinde ya da durum değiştirdiğinde aynı sipariş için ikinci fatura oluşmaz. Aynı müşterinin kısa aralıklarla verdiği siparişleri tek faturada birleştirebilir, faturalanan siparişler için depoya toplama listesi verebilirsiniz. İptal edilen ya da iade gelen siparişler iptal/iade ekranında toplanır; gerekirse fatura editöründe iade faturası düzenlersiniz.
Ödeme sayfası ve eklentiler
Kurumsal müşteri bilgileri
WooCommerce'in standart ödeme sayfasında vergi numarası ve vergi dairesi alanı bulunmaz; bu alanlar genellikle bir eklenti ya da tema özelleştirmesiyle eklenir. Bu alanlar hangi yöntemle eklendiyse, bilginin siparişe nasıl kaydedildiği önemlidir; kurulumda bu bilgilerin faturaya aktarılması birlikte kontrol edilir. Vergi numarası ulaştığında kayıt durumu sorgulanır; e-Fatura mükellefi şirkete e-Fatura, diğerlerine e-Arşiv Fatura kesilir.
TC kimlik numarası
Bireysel müşteriden TC kimlik numarası istemiyorsanız e-Arşiv faturada 11111111111 kullanılabilir. TC kimlik numarası topluyorsanız bunun da siparişe nasıl kaydedildiğini kurulumda belirtin.
Diğer eklentiler
Kargo, kampanya, paket ürün ve abonelik eklentileri sipariş verisinin yapısını değiştirebilir. Örneğin paket ürünlerde sipariş kalemleri beklediğinizden farklı görünebilir. Mağazanızda bu tür eklentiler varsa ilk faturalarda bu siparişlere özellikle bakın ve eklenti listenizi kurulum görüşmesinde paylaşın.
Vergi ayarları
WooCommerce'te vergi hesaplaması ayarlardan açılıp kapatılır; fiyatlar vergi dahil ya da hariç girilebilir ve ürünlere farklı vergi sınıfları atanabilir. Faturadaki tutarın doğru çıkması için bu ayarların ürünlerin gerçek KDV oranlarıyla örtüşmesi gerekir.
Sipariş tutarı doğrulanamazsa fatura kesilmez, onaya bırakılır; böyle bir durumda ilk bakılacak yer vergi ayarlarıdır. Vergi hesaplaması kapalıysa ve fiyatlarınızı KDV dahil düşünerek giriyorsanız bunu kurulumda mutlaka belirtin.
Hizmet ve dijital ürün satanlar için
WooCommerce ile dijital ürün ya da hizmet satıyorsanız gönderim ve taşıyıcı bilgisi fiziksel ürünlerdeki gibi oluşmaz. Bu siparişlerin faturasında internet satışına ait hangi bilgilerin yer alacağını mali müşavirinizle netleştirin. Danışmanlık ya da eğitim gibi hizmetlerde bazı müşteriler sipariş öncesinde teklif ister; portalda teklifi hazırlayıp linkle gönderebilir, onay gelince faturalayabilirsiniz.
Hosting, alan adı ya da yazılım hizmeti satıyorsanız WHMCS ve WiseCP için ayrı hazır bağlantılar da vardır. Tüm liste entegrasyonlar sayfasında; yükümlülüklerin genel çerçevesi ise e-ticaret sitesi için e-Arşiv rehberinde.
WooCommerce bağlantısı için sonraki adım
İletişim sayfasından mağazanızın adresini, kullandığınız ödeme yöntemlerini ve önemli eklentileri paylaşın. Kurulumda API anahtarı birlikte oluşturulur ve doğrulanır, ilk faturalar deneme ortamında kontrol edilir. Sitenizi bir ajans ya da serbest çalışan bir geliştirici yönetiyorsa onu da görüşmeye davet edin; sunucu ve eklenti tarafındaki soruların cevabı çoğu zaman onlardadır. Shopify ile karşılaştırma yapıyorsanız Shopify fatura entegrasyonu, diğer altyapılar ve Özel Entegrasyon için e-ticaret faturalama sayfasına bakabilirsiniz.