WooCommerce Siparişleri Dışa Aktarma: Excel ve CSV'ye Almanın 5 Yolu
Tüm yazılar

WooCommerce Siparişleri Dışa Aktarma: Excel ve CSV'ye Almanın 5 Yolu

Efyuar Ekibi 12 dk okuma

Muhasebeye ay sonu listesi göndermek, kargo firmasına toplu adres vermek ya da satışları Excel'de analiz etmek istediğinizde ilk ihtiyaç aynıdır: siparişleri mağazadan dışarı almak. WooCommerce ürünler için hazır bir CSV dışa aktarma ekranı sunar, ancak Siparişler ekranında benzer bir düğme yoktur. Bu yüzden birçok mağaza sahibi nereden başlayacağını bilemez.

Bu rehberde beş yöntemi, hangisinin hangi iş için uygun olduğunu ve Türkiye'deki mağazaların en sık yaşadığı bozuk karakter ve telefon numarası sorunlarının çözümünü anlatıyoruz.

Kısa cevap: Hangi yöntemi seçmeli?

  • Sadece tarih, tutar, ürün ve müşteri adı yetiyorsa: Eklenti kurmadan Analiz → Siparişler ekranındaki İndir bağlantısını kullanın.
  • Telefon, adres ve e-posta da gerekiyorsa: Ücretsiz bir dışa aktarma eklentisi kurun ya da aşağıdaki hazır kodu ekleyin.
  • Liste düzenli olarak başka bir sisteme gidecekse: REST API ile otomatik bir entegrasyon kurun.
YöntemTelefon, adresOtomatikZorluk
AnalyticsYokHayırKolay
EklentiVarGenelde ücretliKolay
Hazır kodVarHayırOrta
REST APIVarEvetGeliştirici
WP-CLIJSON olarakCron ileTeknik

1. Eklentisiz yöntem: WooCommerce Analytics

WooCommerce'in kendi rapor ekranı, sipariş listesini CSV olarak verir:

  1. WordPress panelinde Analiz → Siparişler sayfasını açın.
  2. Sağ üstten tarih aralığını seçin.
  3. Gerekirse gelişmiş filtrelerle durum, ürün veya kupona göre daraltın.
  4. Tablonun sağ üstündeki İndir bağlantısına tıklayın.

Sonuçlar tek ekrana sığıyorsa dosya hemen iner. Daha uzun listeler arka planda hazırlanır ve dışa aktarmayı başlatan kullanıcıya e-postayla bağlantı gelir. Bu bağlantı bir hafta geçerlidir.

Dosyada tarih, sipariş numarası, ciro, durum, müşteri adı, müşteri türü, ürünler, satılan adet, kupon, net satış, kaynak ve ödeme yöntemi bulunur. Telefon, e-posta ve adres yoktur. Kargo veya müşteri iletişimi için bu yöntem yetmez.

Analytics'te iki noktaya da dikkat edin:

  • Bekleyen ödeme, iptal ve başarısız siparişler varsayılan olarak rapora girmez. Bu ayar Analiz → Ayarlar ekranından değişir.
  • İade edilen bir sipariş iki satır oluşturur: biri sipariş tarihinde, diğeri iade tarihinde. Satırları sayarak sipariş adedi bulmaya çalışırsanız sonuç yanlış çıkar.

Eski siparişler raporda görünmüyorsa Analiz → Ayarlar → Geçmiş verileri içe aktar adımını çalıştırın.

2. Eklenti ile dışa aktarma

Sütunları kendiniz seçmek, telefon ve adres almak ya da Excel biçiminde dosya indirmek istiyorsanız en hızlı yol budur. WordPress.org verilerine göre Kasım 2026 itibarıyla öne çıkan seçenekler şunlar:

  • Advanced Order Export For WooCommerce: 100.000'den fazla aktif kurulumu var ve Ekim 2026'da güncellendi. Ücretsiz sürümde sütun seçme, sütunları yeniden adlandırma, ürün veya müşteriye göre gruplama ile Excel, CSV, XML, JSON, PDF ve HTML çıktısı sunuyor. Zamanlanmış dışa aktarma ve durum değişince otomatik gönderim Pro sürümde.
  • Order Export & Order Import for WooCommerce: 50.000'den fazla aktif kurulumu var. Siparişleri başka bir WooCommerce mağazasına taşırken dışa ve içe aktarmayı birlikte yapması avantajlı.
  • WP All Export: 100.000'den fazla aktif kurulumu var. Özel alanları sürükle bırakla eşlemeye uygun; WooCommerce sipariş desteği için kullandığınız sürümün kapsamını kontrol edin.
  • Customer / Order / Coupon Export: WooCommerce mağazasından satılan ücretli bir eklentidir; müşteri ve kupon verilerini de kapsar.

Advanced Order Export ile temel kullanım şöyledir:

  1. Eklentiyi kurun ve WooCommerce → Export Orders ekranını açın.
  2. Tarih aralığını ve sipariş durumlarını seçin.
  3. Sürükle bırak alanından istediğiniz sütunları ekleyin.
  4. Dosya biçimini seçin ve dışa aktarın.

Hangi eklentiyi seçerseniz seçin, kurmadan önce sipariş altyapınız HPOS ise eklentinin HPOS uyumlu olduğunu kontrol edin. Bu ayarı WooCommerce → Ayarlar → Gelişmiş → Özellikler ekranında görebilirsiniz. Büyük mağazalarda yalnızca sipariş listesi için eklenti eklemek istemiyorsanız sonraki yöntem daha hafiftir.

3. Eklentisiz hazır kod ile Excel uyumlu CSV

Aşağıdaki kod, WooCommerce menüsüne Sipariş Dışa Aktar adlı bir sayfa ekler. Tarih aralığı seçip Türkçe Excel'de düzgün açılan bir CSV indirirsiniz.

  • WooCommerce'in resmî sipariş fonksiyonlarını kullandığı için HPOS açık veya kapalı mağazalarda çalışacak şekilde yazılmıştır.
  • Siparişleri 200'erli gruplar hâlinde okuyarak belleği zorlamaz.
  • Sadece manage_woocommerce yetkisi olan kullanıcılar çalıştırabilir.
  • Dosyayı UTF-8 BOM ile yazar, sütunları noktalı virgülle ayırır ve tutarları virgüllü ondalıkla verir.
  • Eşittir veya artı gibi karakterle başlayan müşteri verilerinin Excel'de formül olarak çalışmasını engeller.
add_action( 'admin_menu', function () {
    add_submenu_page(
        'woocommerce',
        'Sipariş Dışa Aktar',
        'Sipariş Dışa Aktar',
        'manage_woocommerce',
        'efyuar-siparis-disa-aktar',
        'efyuar_siparis_formu'
    );
} );

function efyuar_siparis_formu() {
    echo '<div class="wrap"><h1>Sipariş Dışa Aktar</h1>';
    echo '<form method="post" action="' . esc_url( admin_url( 'admin-post.php' ) ) . '">';
    echo '<input type="hidden" name="action" value="efyuar_siparis_csv">';
    wp_nonce_field( 'efyuar_siparis_csv' );
    echo '<p><label>Başlangıç <input type="date" name="baslangic" required></label></p>';
    echo '<p><label>Bitiş <input type="date" name="bitis" required></label></p>';
    submit_button( 'CSV indir' );
    echo '</form></div>';
}

function efyuar_csv_hucre( $deger ) {
    $deger = (string) $deger;
    $riskli = array( '=', '+', '-', '@', "\t", "\r" );

    return in_array( mb_substr( $deger, 0, 1 ), $riskli, true ) ? "'" . $deger : $deger;
}

function efyuar_csv_tutar( $tutar ) {
    return number_format( (float) $tutar, 2, ',', '' );
}

function efyuar_csv_satir( $cikti, $satir ) {
    fputcsv( $cikti, array_map( 'efyuar_csv_hucre', $satir ), ';', '"', '\\' );
}

add_action( 'admin_post_efyuar_siparis_csv', function () {
    if ( ! current_user_can( 'manage_woocommerce' ) ) {
        wp_die( 'Bu işlem için yetkiniz yok.', '', array( 'response' => 403 ) );
    }

    check_admin_referer( 'efyuar_siparis_csv' );

    $baslangic = sanitize_text_field( wp_unslash( $_POST['baslangic'] ?? '' ) );
    $bitis     = sanitize_text_field( wp_unslash( $_POST['bitis'] ?? '' ) );
    $bicim     = '/^\d{4}-\d{2}-\d{2}$/';

    if ( ! preg_match( $bicim, $baslangic ) || ! preg_match( $bicim, $bitis ) || $baslangic > $bitis ) {
        wp_die( 'Tarih aralığı geçersiz.' );
    }

    wc_set_time_limit( 0 );
    nocache_headers();
    header( 'Content-Type: text/csv; charset=UTF-8' );
    header( 'Content-Disposition: attachment; filename="siparisler-' . $baslangic . '-' . $bitis . '.csv"' );

    $cikti = fopen( 'php://output', 'w' );
    fwrite( $cikti, "\xEF\xBB\xBF" );

    efyuar_csv_satir( $cikti, array(
        'Sipariş No', 'Tarih', 'Durum', 'Ad Soyad', 'Telefon', 'E-posta', 'İl', 'İlçe', 'Adres',
        'Ürünler', 'Kargo', 'İndirim', 'KDV', 'Toplam', 'İade', 'Ödeme Yöntemi',
    ) );

    $iller = WC()->countries->get_states( 'TR' );
    $sayfa = 1;

    do {
        $sonuc = wc_get_orders( array(
            'type'         => 'shop_order',
            'status'       => array( 'wc-processing', 'wc-on-hold', 'wc-completed', 'wc-refunded' ),
            'date_created' => $baslangic . '...' . $bitis,
            'orderby'      => 'date',
            'order'        => 'ASC',
            'limit'        => 200,
            'paged'        => $sayfa,
            'paginate'     => true,
        ) );

        foreach ( $sonuc->orders as $siparis ) {
            $urunler = array();

            foreach ( $siparis->get_items() as $kalem ) {
                $urun      = $kalem->get_product();
                $stok_kodu = $urun ? $urun->get_sku() : '';
                $urunler[] = $kalem->get_quantity() . ' x ' . $kalem->get_name() . ( $stok_kodu ? ' (' . $stok_kodu . ')' : '' );
            }

            $il_kodu = $siparis->get_billing_state();

            efyuar_csv_satir( $cikti, array(
                $siparis->get_order_number(),
                $siparis->get_date_created()->date( 'd.m.Y H:i' ),
                wc_get_order_status_name( $siparis->get_status() ),
                $siparis->get_billing_first_name() . ' ' . $siparis->get_billing_last_name(),
                $siparis->get_billing_phone(),
                $siparis->get_billing_email(),
                $iller[ $il_kodu ] ?? $il_kodu,
                $siparis->get_billing_city(),
                trim( $siparis->get_billing_address_1() . ' ' . $siparis->get_billing_address_2() ),
                implode( ' | ', $urunler ),
                efyuar_csv_tutar( $siparis->get_shipping_total() ),
                efyuar_csv_tutar( $siparis->get_total_discount() ),
                efyuar_csv_tutar( $siparis->get_total_tax() ),
                efyuar_csv_tutar( $siparis->get_total() ),
                efyuar_csv_tutar( $siparis->get_total_refunded() ),
                $siparis->get_payment_method_title(),
            ) );
        }

        flush();
        $sayfa++;
    } while ( $sayfa <= $sonuc->max_num_pages );

    fclose( $cikti );
    exit;
} );

Kodu alt temanızın functions.php dosyasına ya da Code Snippets eklentisine ekleyin ve öncesinde yedek alın. Durum listesini status satırından, sütunları da iki efyuar_csv_satir çağrısından değiştirebilirsiniz. Başlık ve veri satırlarındaki sütun sırası aynı kalmalıdır. Tarih aralığı, sitenizin saat dilimine göre başlangıç ve bitiş günlerini de kapsar.

Eski rehberlerde sık görülen get_posts veya doğrudan wp_posts tablosuna giden sorgulardan kaçının. HPOS açık mağazalarda sipariş verisi ayrı tablolarda tutulduğu için bu sorgular boş veya eksik sonuç verebilir.

4. REST API ile otomatik aktarım

Siparişler düzenli olarak muhasebe programına, depo sistemine veya CRM'e gidecekse dosya indirip yüklemek yerine API kullanın. WooCommerce → Ayarlar → Gelişmiş → REST API ekranından yalnızca okuma yetkili bir anahtar oluşturun.

curl -G "https://www.siteniz.com/wp-json/wc/v3/orders" \
  -u "ck_anahtariniz:cs_gizli_anahtariniz" \
  -d "after=2026-10-01T00:00:00" \
  -d "before=2026-11-01T00:00:00" \
  -d "status=processing,completed" \
  -d "per_page=100" \
  -d "page=1"

Bir sayfada en fazla 100 sipariş gelir. Toplam sayfa sayısı yanıtın X-WP-TotalPages başlığındadır; bu değere ulaşana kadar page değerini artırın. Yanıt JSON biçimindedir ve fatura, teslimat, ürün kalemleri gibi tüm alanları içerir.

Sürekli çalışan bir entegrasyonda yalnızca değişen siparişleri çekmek için modified_after parametresi kullanışlıdır. Böylece her seferinde tüm geçmiş yeniden okunmaz. Anahtarları kod deposuna veya herkesin görebildiği belgelere yazmayın.

5. WP-CLI ile sunucudan dışa aktarma

Sunucuya SSH erişiminiz varsa WP-CLI, tarayıcı zaman aşımına takılmadan çalışır. Komutu sayfa sayfa tekrarlayabilir ya da cron ile zamanlayabilirsiniz:

wp wc shop_order list --user=1 --status=completed --per_page=100 --page=1 \
  --after=2026-10-01T00:00:00 --before=2026-11-01T00:00:00 \
  --fields=id,status,date_created,total,payment_method_title \
  --format=csv > siparisler-1.csv

--user değeri, sipariş okuma yetkisi olan bir kullanıcının kimliği olmalıdır. Fatura ve ürün alanları iç içe veri olduğundan CSV'de JSON metni olarak görünür. Bu nedenle bu yöntem, adres listesinden çok özet verilere ve yedekleme akışlarına uygundur.

Excel'de Türkçe karakter ve telefon sorunu

CSV dosyasını çift tıklayarak açtığınızda “ÅŸ” gibi bozuk harfler, tek sütuna sıkışmış veriler veya başındaki sıfırı kaybolmuş telefon numaraları görebilirsiniz. Üçünün de çözümü aynı ekrandır:

  1. Boş bir Excel çalışma kitabı açın.
  2. Veri → Metinden/CSV'den yolunu izleyip dosyayı seçin.
  3. Dosya Kaynağı olarak 65001: Unicode (UTF-8) seçin.
  4. Sınırlayıcı olarak dosyanıza göre virgül veya noktalı virgül seçin.
  5. Verileri Dönüştür düğmesine basın; telefon, sipariş numarası ve posta kodu sütunlarının türünü Metin yapın.
  6. Kapat ve Yükle ile sayfaya aktarın.

Artı ile başlayan telefon numaralarının başında tek tırnak görürseniz bu, formül korumasından kaynaklanır; Excel'de Bul ve Değiştir ile kaldırabilirsiniz.

Tutarlar yazı gibi sola yaslanıyorsa ondalık ayracı uyuşmuyordur. Aynı ekranda sütunu Yerel Ayarı Kullanarak dönüştürüp doğru bölgeyi seçebilirsiniz. Dosyayı düzenledikten sonra CSV olarak kaydederseniz Excel'in telefon numaralarını yeniden sayıya çevirebileceğini unutmayın; çalışma dosyanızı .xlsx olarak saklayın.

Toplamlar neden tutmuyor?

Dışa aktardığınız liste ile WooCommerce raporu arasında fark görürseniz en sık nedenler şunlardır:

  • Durum farkı: Bir liste beklemedeki veya iptal edilen siparişleri içeriyor, diğeri içermiyor olabilir.
  • Net satış ve toplam farkı: Net satış kargo ve vergiyi içermez; sipariş toplamı içerir.
  • İadeler: Sipariş toplamı iade düşülmeden görünebilir. Yukarıdaki kodda iade tutarı bu yüzden ayrı sütundadır.
  • Tarih farkı: Site saat dilimi yanlışsa ayın ilk ve son siparişleri yanlış aya düşer. Ayarlar → Genel → Saat dilimi değerini İstanbul olarak kontrol edin. API kullanırken UTC ile çalışıp çalışmadığınızı da netleştirin.

Muhasebeye göndermeden önce birkaç siparişi panelle karşılaştırın. Kesin kayıt olarak fatura verilerinizi esas alın; sipariş dışa aktarması bunun yerine geçmez.

KVKK ve dosya güvenliği

Bir sipariş listesi ad, telefon, e-posta ve açık adres içerir; yani kişisel veri dosyasıdır. 6698 sayılı Kanun, veri sorumlusundan bu verileri korumak için gerekli teknik ve idari tedbirleri almasını bekler. Pratikte şunları yapın:

  • Sadece işe yarayan sütunları aktarın. Muhasebeye kargo adresi, kargo firmasına sipariş tutarı gerekmiyorsa eklemeyin.
  • Dosyayı herkese açık bağlantıyla veya şifresiz e-posta ekiyle paylaşmayın.
  • İş bitince indirilenler klasöründeki kopyaları silin.
  • manage_woocommerce yetkisini yalnızca gerçekten ihtiyacı olan kişilere verin.
  • Dosyaları sitenin herkese açık klasörlerine kaydetmeyin. Eklenti kullanıyorsanız oluşturulan dosyaların nereye yazıldığını kontrol edin.

Excel'de açılan dosyalardaki formül riski de gerçektir. Müşterinin ad alanına yazdığı = ile başlayan bir ifade, korumasız bir dosyada formül olarak çalışabilir. WooCommerce'in kendi CSV aktarımı da bu nedenle böyle değerlerin başına tek tırnak ekler.

Sık karşılaşılan sorunlar

Dışa aktarma yarıda kesiliyor veya boş sayfa veriyor

Sunucu zaman aşımı veya bellek sınırına takılıyordur. Tarih aralığını küçültün, eklentinin toplu işleme ayarını kullanın ya da WP-CLI'ye geçin. PHP hata kaydı kesin nedeni gösterir.

Analytics e-postası gelmiyor

Önce gereksiz klasörünü kontrol edin. Mağazanız e-posta göndermekte zorlanıyorsa bir SMTP eklentisi gerekir. Arka plan işleri için WooCommerce → Durum → Zamanlanmış Eylemler ekranında bekleyen veya başarısız görevlere bakın.

Bazı siparişler listede yok

Durum filtresini ve tarih aralığını kontrol edin. Analytics'te eski siparişler için geçmiş veri aktarımını çalıştırın.

Özel alanlar dosyaya gelmiyor

T.C. kimlik veya vergi numarası gibi ödeme sayfasına eklenen alanlar sipariş meta verisi olarak tutulur. Eklentide özel alan olarak seçilebilir, kodda ise $siparis->get_meta( 'alan_anahtari' ) ile okunabilir. T.C. kimlik numarası gibi hassas alanları yalnızca gerçekten gerekiyorsa aktarın.

Sık sorulan sorular

WooCommerce siparişleri eklentisiz dışa aktarılabilir mi?

Evet. Analiz → Siparişler ekranından özet CSV alabilirsiniz. Telefon ve adres gibi alanlar için bu rehberdeki kod yeterlidir.

Doğrudan .xlsx dosyası alabilir miyim?

Analytics ve hazır kod CSV üretir. Doğrudan Excel dosyası için Advanced Order Export gibi bir eklenti kullanabilir ya da CSV'yi Excel'de açıp .xlsx olarak kaydedebilirsiniz.

Her ürün için ayrı satır alabilir miyim?

Evet. Bu görünüm depo ve toplama listeleri için kullanışlıdır. Eklentilerde ürüne göre gruplama seçeneğiyle yapılır. Yukarıdaki kod ise ürünleri tek hücrede toplar; her kalem için satır üretecek şekilde uyarlanabilir.

Otomatik olarak muhasebeye gönderebilir miyim?

Evet. Zamanlanmış gönderim destekleyen bir eklenti veya REST API entegrasyonuyla mümkündür. Muhasebe programınızın kendi WooCommerce bağlantısı varsa önce onu değerlendirin.

Dışa aktarma sonrası siparişleri geri yükleyebilir miyim?

CSV dosyası tek başına site yedeği değildir. Taşıma için içe aktarma desteği olan bir eklenti gerekir; yedek için ise veritabanının tam kopyasını alın.

Sipariş akışınızı otomatikleştirin

Her ay elle dosya indiriyorsanız asıl ihtiyacınız büyük olasılıkla bir entegrasyondur. Yazılım geliştirme hizmetimizde WooCommerce mağazalarını muhasebe, kargo ve depo sistemlerine bağlıyor, gerektiğinde işletmeye özel CRM kuruyoruz. Mağazanızın Google tarafını güçlendirmek için WooCommerce SEO rehberimize, sitenizi sorunsuz tutmak için web sitesi bakımı yazımıza göz atabilirsiniz.

Bilgiler Kasım 2026 itibarıyla WooCommerce belgeleri, kaynak kodu ve WordPress.org eklenti verileriyle kontrol edilmiştir. Kod eklemeden önce yedek alın ve önce test ortamında deneyin. KVKK bölümü bilgilendirme amaçlıdır, hukuki görüş niteliği taşımaz.

Bu konuda bir projeniz mi var?

Birkaç cümleyle anlatın, size özel yol haritasını birlikte çıkaralım.

Teklif formu