WooCommerce entegrasyonu: sitendeki siparişe e-Arşiv fatura

WooCommerce ile Uygun Muhasebe arasında ne eşitlenir?

Uygun Muhasebe WordPress sitene WooCommerce'in kendi REST API'siyle bağlanır. Siteye eklenti kurmazsın, webhook (web kancası) da açmazsın: Uygun Muhasebe siparişleri siteden kendisi ister. Hangi bilginin hangi yöne gittiği:

15 dakikalık sipariş çekimi ve gece stok gönderimi, mağaza ayarındaki "Siparişleri kendiliğinden çek" açıkken çalışır; taslak da "Her yeni siparişe fatura taslağı aç" açıkken açılır. İkisi de varsayılan olarak açık.

Pazaryerlerinde de satıyorsan aynı stok bütün mağazalarına gider; bir mağazadan gelen sipariş, faturası onaylanana dek hepsine gönderilen stoktan düşülür. Bağlanabilen pazaryerleri pazaryeri entegrasyonu sayfasında.

WooCommerce siparişinden faturaya

Yalnız ödemesi alınmış siparişler gelir: durumu Hazırlanıyor (processing) ya da Tamamlandı (completed) olanlar. Ödeme bekliyor (pending) ve Beklemede (on-hold) siparişler gelmez. Havale bekleyen siparişin parasını görüp durumunu Hazırlanıyor yaptığında gelir; ödenmeden iptal olan ya da kartı reddedilen sipariş hiç alınmaz. Bir kargo eklentisinin kendi durumuna geçen sipariş, WooCommerce'te ödeme tarihi kayıtlıysa gelir.

Mağazayı bağladığında son 14 günün ödenmiş siparişleri de gelir. Bunların faturasını önceden başka yerde kestiysen taslağını silersin; silinen taslağın siparişi stoktan düşülmez.

27.09.2026 tarihli bir sipariş düşün: ürünler 1.200,00 TL, kargo 89,90 TL, havale ödemesine 60,00 TL indirim. Taslak faturada:

• Kupon indirimi ürün satırlarına zaten yansımış gelir.
• Havale indirimi gibi eksi ek ücret ürün satırlarına tutarlarıyla orantılı dağıtılır: ürünler toplam 1.140,00 TL olur.
• Kargo ve ek ücretler ayrı satır olur: 89,90 TL kargo satırı.
• Fatura toplamı ödenen tutarla aynıdır: 1.229,90 TL. Tutmazsa taslak uyarılı kalır, toplu onaylanmaz.

Sen e-Fatura kullanıcısıysan Uygun Muhasebe alıcının vergi ya da T.C. kimlik numarasını GİB'in e-Fatura kayıtlı kullanıcı listesinde sorgular: alıcı kayıtlıysa e-Fatura, değilse e-Arşiv fatura kesilir. Numarası gelmeyen bireysel alıcıya e-Arşiv kesilir. İnternetten satanların e-Fatura'ya geçiş sınırı e-Fatura zorunluluğu yazısında.

WooCommerce'in standart ödeme sayfasında T.C. kimlik ya da vergi numarası alanı yok. Bu alanı bir eklentiyle veya özel alanla ekliyorsan Uygun Muhasebe onu siparişin ek bilgilerinde adından tanır ("tc", "vergi no", "tax number" gibi); vergi dairesi ve "bireysel / kurumsal" seçimi de okunur. Kontrol hanesi tutmayan numara alınmaz, çünkü yanlış numarayla kesilen fatura başka birine gider; bkz. VKN ve TCKN. Şirket kutusuna yazılan "-", "Yok", "Bireysel" gibi değerler şirket adı sayılmaz. Sipariş şirket adına gelir ama geçerli vergi numarası gelmezse taslak uyarılı kalır; carinin vergi bilgilerini doldurup onaylarsın. Fatura adresi Türkiye dışındaki sipariş de uyarılı kalır; ihracat faturası gerekip gerekmediğini mali müşavirine sor.

e-Arşiv faturanın internet satışı bilgileri mağaza ayarından ve siparişten dolar: site adresin, ödeme şekli (kart, havale/EFT ya da kapıda ödeme), ödeme tarihi (havale günler sonra ödendiyse o gün), gönderim tarihi olarak fatura tarihi ve kargo yönteminin adı bir kargo firmasıysa taşıyıcı. e-Arşiv fatura gönderilince müşterinin e-postasına görüntüleme bağlantısıyla iletilir; bu ayar e-Belge ayarlarında, varsayılan olarak açık. Trendyol gibi pazaryerlerinde fatura siparişe eklenir (Trendyol örneği); kendi sitende böyle bir adım yok. Ayrıntılar e-Arşiv fatura programı sayfasında.

KDV: WooCommerce vergi ayarın faturayı nasıl etkiler?

WooCommerce'te vergi hesabı WooCommerce > Ayarlar > Genel'deki "Vergi oranlarını ve hesaplamalarını etkinleştir" ile açılır; fiyatların vergi dahil mi hariç mi girildiği Vergi sekmesindeki "Vergiyle girilmiş fiyatlar" ayarıdır (WooCommerce vergi ayarları). Uygun Muhasebe oranı buna göre okur:

• Vergi açıksa: her satırın oranı siparişin vergi satırlarından alınır ve %1, %10 ya da %20'den hangisine denk geliyorsa o yazılır. Vergi sınıflarına Türkiye oranlarını doğru tanımladıysan satırlar doğru oranla gelir.
• Sıfır oranlı ürün: sitede o vergi sınıfı için %0 oran satırı tanımlıysa %0 gelir; oran satırı hiç yoksa satır vergisiz sayılır ve aşağıdaki "vergi kapalı" kuralı uygulanır. %0'lı satırı olan fatura e-Belge'de "İstisna" tipi ve KDV muafiyet sebebi seçilmeden gönderilmez; hangi sebebin geçerli olduğunu mali müşavirine sor.
• Vergi kapalıysa: sitedeki fiyat KDV dahil sayılır, oran Uygun Muhasebe'deki ürün kartından alınır. Ürün eşleşmemişse satıra %20 yazılır ve taslak toplu onaylanmaz; KDV'siz satış yanlışlıkla %20 kesilmesin diye oranı sen kontrol edersin.
• Kargo ve ek ücret: vergi bilgisi gelmeyen kargo satırı %20 sayılır; farklıysa taslakta düzelt.

Stok ve fiyat gönderirken dikkat

Ürünler SKU ile eşleşir: WooCommerce'teki SKU, Uygun Muhasebe'deki stok kodudur. SKU olarak barkod ya da ISBN kullanıyorsan ürün barkoduyla da eşleşir. SKU'su boş ürün siparişte "#152" ya da varyasyonsa "#152/153" gibi site numarasıyla gelir ve Ürün eşleştirme listesine düşer; bir kez eşleştirince stok ve fiyat bu numarayla gider.

• Gönderilen stok, Uygun Muhasebe'deki stoktan faturası henüz onaylanmamış siparişler düşülerek bulunur. Sitede elle değiştirdiğin stok, sonraki gönderimde Uygun Muhasebe'deki rakamla değişir; stoğu tek yerden yönet.
• Sitede stok yönetimi kapalıysa stok yazılmaz: WooCommerce > Ayarlar > Ürünler > Stok bölümünde "Stok yönetimini etkinleştir"i işaretle. Stok gönderilen üründe stok takibi kendiliğinden açılır.
• Fiyat normal fiyata yazılır; sitede girdiğin indirimli fiyat olduğu gibi kalır. Varyasyonlu üründe fiyat her varyasyona ayrı gider.
• Sitede vergi açık ve fiyatlar KDV hariç giriliyorsa fiyat KDV'siz, diğer durumlarda KDV dahil gider: kartta 1.000,00 TL + %20 KDV olan ürün siteye 1.000,00 TL ya da 1.200,00 TL olarak yazılır.
• Stok ve fiyat her gece kendiliğinden, istediğinde de Stok ve fiyat güncelleme sayfasından gider; sitede zaten aynı olan ürün yeniden yazılmaz.
• Uygun Muhasebe'de hiç stok kaydı yokken stok gönderimi açılmaz; açılsaydı sitedeki bütün ürünler 0'a inerdi.

Ürün kartların yoksa Pazaryeri > Mağazalar'daki "Siteden ürünleri al" ile sitede yayındaki ürünleri aktarırsın: her varyasyon ayrı kart olur. KDV oranı, sitede vergi açıksa ürünün vergi sınıfından, değilse seçtiğin orandan gelir; sitedeki stok açılış stoğu, kategori de ürün kategorisi olabilir. Gruplu ve dış bağlantılı ürünler alınmaz; aktarım yanlış olduysa geri alırsın. Depo, sayım ve stok hareketleri için stok takip programı sayfasına bak.

İptal, iade ve kargo

• Sipariş iptal edilir, iade edilir ya da başarısız olursa onaylanmamış fatura taslağı silinir. Fatura onaylandıysa siparişte uyarı görünür; faturayı iptal eder ya da iade kaydı açarsın.
• WooCommerce'te siparişin bir kısmını geri ödediğinde sipariş sürer, iade tutarı ayrıca gelir. Taslakta "Siparişte 250,00 TL iade var" gibi bir uyarı çıkar, iade edilen ürünü faturadan düşersin. Fatura onaylıysa faturada "Müşteri iade etti" ile iade kaydı açarsın; bkz. iade faturası nasıl kesilir.
• WooCommerce 5.8'den eski bir sürümdeysen siparişler oluşturma tarihine göre alınır, sonradan iptal ya da iade edilen sipariş görünmeyebilir; WooCommerce'i güncelle.
• Kargo takip numarası WooCommerce'ten gelmez, Uygun Muhasebe de siteye yazmaz. Seçtiğin siparişlerin kargo etiketini Uygun Muhasebe'den 10x10 cm termal ya da A4'e altı etiket olarak basarsın.

Kendi siten: anahtar, güvenlik ve sunucu

• Eklenti gerekmez; Uygun Muhasebe'nin kendi API anahtarı (tzk_ ile başlayan) da gerekmez. WooCommerce'te oluşturduğun ck_ ile başlayan tüketici anahtarı ve cs_ ile başlayan tüketici gizli anahtarı yeter (WooCommerce REST API belgesi).
• Yalnız sipariş alacaksan İzinler'de Oku yeter; stok ve fiyat göndereceksen Oku/Yaz seç. Anahtarı Yönetici ya da Mağaza yöneticisi rolündeki kullanıcıyla oluştur: fiyat gönderilirken sitenin vergi ayarı da okunur. Yalnız Oku izinli anahtarla stok gönderimini açarsan bağlantı testi hemen uyarır.
• Site https ile açılmalı; anahtarlar şifresiz (http) bağlantıda gönderilmez.
• WordPress bir klasöre kuruluysa adresi klasörüyle yaz (https://siten.com/magaza). www'lu adrese yönlendirme ve adresin sonuna yazılmış /shop gibi sayfa yolları kendiliğinden düzeltilir.
• Cloudflare, Wordfence ya da sunucunun güvenlik duvarı isteği engellerse Uygun Muhasebe hangisinin engellediğini söyler; sunucumuzun IP adresini izin listesine eklersin.
• Sunucun Authorization başlığını iletmiyorsa anahtarlar şifreli bağlantıda sorgu parametresiyle gönderilir. WooCommerce kalıcı bağlantıların "Düz" dışında bir ayarda olmasını ister; "Düz" seçiliyse Uygun Muhasebe WordPress'in ?rest_route= yolunu dener ve bağlantı testinde bunu söyler. WooCommerce 11.1'den eski sürümler bu yolda anahtarı tanımaz: o zaman "Yazı adı"nı seç ya da WooCommerce'i güncelle.
• Aynı site iki kez bağlanamaz; bağlansaydı her sipariş iki kez faturalanırdı.

Hem kendi sitenden hem pazaryerlerinden satıyorsan e-ticaret satıcıları sayfası işini bütün olarak anlatıyor.

WooCommerce bağlantısı adım adım

1. 1

   WordPress paneline gir

   Sitenin WordPress yönetim paneline Yönetici ya da Mağaza yöneticisi rolündeki hesabınla gir.

2. 2

   REST API anahtarı oluştur

   WooCommerce > Ayarlar > Gelişmiş > REST API'de Anahtar ekle'ye bas; Açıklama'ya Uygun Muhasebe yaz, Kullanıcı olarak kendini seç, İzinler'de Oku/Yaz seçip API anahtarı oluştur'a bas. Yalnız sipariş alacaksan Oku izni yeter.

3. 3

   Anahtarları kopyala

   Çıkan tüketici anahtarını (ck_...) ve tüketici gizli anahtarını (cs_...) kopyala; gizli anahtar yalnız bir kez görünür.

4. 4

   Uygun Muhasebe'de mağazayı bağla

   Pazaryeri > Mağazalar > Mağaza bağla'da WooCommerce'i seç; sitenin ana adresini https ile yaz (WordPress klasördeyse klasörüyle), iki anahtarı yapıştırıp kaydet.

5. 5

   Bağlantıyı dene, ürünleri al

   Bağlantıyı dene ile son 24 saatte kaç sipariş göründüğüne bak. Ürün kartın yoksa Siteden ürünleri al ile ürünleri aktar; stok ve fiyat gönderimini stoğu girdikten sonra aç.

Pazaryeri ve platform adları ile logoları sahiplerinin markasıdır. Pazaryerinin kuralları değişebilir; güncel koşullar için satıcı panelindeki duyurulara bak.