Sipariş nesnesindeki önemli alanlar
| Alan | Açıklama |
|---|---|
| id | Sipariş numarası (veritabanı kimliği) |
| number | Görünen sipariş numarası, salt okunur |
| status | Sipariş durumu |
| date_created, date_modified | Oluşturulma ve son değişiklik, site saat diliminde |
| date_paid | Ödeme tarihi, salt okunur |
| total | Genel toplam, metin |
| prices_include_tax | Fiyatlar ödemede vergi dahil miydi |
| billing, shipping | Fatura ve teslimat adresi |
| payment_method_title | Ödeme yöntemi adı |
| line_items | Satılan kalemler |
| shipping_lines | Kargo yöntemi satırları; method_title ve method_id |
| refunds | Siparişteki iadeler: id, reason, total |
| customer_note | Müşterinin ödeme sırasında yazdığı not |
id ile number çoğu sitede aynıdır, ama sipariş numarası eklentisi kullanan sitelerde farklı olabilir. API çağrılarında id, müşteriye gösterirken number kullanın.
Kalem alanları
| Alan | Açıklama |
|---|---|
| product_id | Ürün numarası |
| variation_id | Varyasyon numarası; varyasyon değilse 0 |
| quantity | Adet |
| sku | Ürünün SKU’su, salt okunur |
| global_unique_id | GTIN; boşsa boş metin, ürün silinmişse null |
| price | Birim fiyat, salt okunur |
| subtotal ve total | İndirim öncesi ve sonrası satır toplamı |
| parent_name | Varyasyonsa ana ürünün adı |
Stok düşümü için en güvenilir eşleştirme alanı variation_id ve product_id’dir. Yalnız SKU’ya bakmak, SKU’su boş varyasyonlarda yanlış ürünü etkileyebilir.
Filtreler
| Parametre | Ne yapar |
|---|---|
| after, before | Oluşturulma tarihine göre süzer, ISO 8601 |
| modified_after, modified_before | Son değişiklik tarihine göre süzer |
| dates_are_gmt | Tarihleri GMT olarak yorumlar |
| status | Bir ya da birden çok durum; varsayılan any |
| customer | Belirli müşterinin siparişleri |
| product | Belirli ürünü içeren siparişler |
| created_via | checkout, store-api gibi kaynaklar |
| orderby, order | date, modified, id gibi alanlara göre sıralama |
| per_page, page | Sayfalama; per_page en fazla 100 |
Değişen siparişleri yakalamak
Yalnız after ile yeni siparişleri çekmek, eski bir siparişin sonradan iptal edilmesini kaçırabilir. Durum değişikliklerini yakalamak için modified_after ile son okumadan beri değişen siparişleri de isteyin.
- Yeni siparişler: after = son okuma zamanı
- Durumu değişenler: modified_after = son okuma zamanı
- Güvenlik payı: pencereyi birkaç dakika geriden başlatıp tekrar edenleri numarayla ayıklayın
Webhook kullanıyorsanız order.updated olayı da bu değişikliği haber verir; ayrıntılar webhook kurulumu sayfasında.
Türkiye adreslerinde il alanı
Belgeye göre state alanı il, eyalet ya da bölgenin ISO kodunu ya da adını taşır. Türkçe sitelerde il çoğunlukla TR34 gibi bir ISO 3166-2 koduyla gelir; sayı plaka numarasıdır. city alanına ise müşteriler çoğu zaman ilçeyi yazar. Faturada il ve ilçeyi doğru göstermek için kodu il adına çevirin.
Sık sorulanlar
WooCommerce siparişleri API ile nasıl çekilir?
GET /wp-json/wc/v3/orders adresini per_page=100 ve after gibi tarih filtreleriyle çağırıp sayfaları gezersiniz.
Sadece belirli durumdaki siparişleri nasıl alırım?
status parametresine bir ya da birden çok durum yazın, ör. processing. Varsayılan any olduğu için parametre olmadan tüm durumlar gelir.
Sonradan iptal edilen eski siparişleri nasıl yakalarım?
modified_after filtresiyle son okumadan beri değişen siparişleri isteyin ya da order.updated webhook’unu kullanın.
Sipariş numarası ile id neden farklı?
number alanı görünen numaradır; sipariş numarası eklentileri bunu değiştirebilir. API isteklerinde her zaman id kullanılır.
Kaynaklar
İlgili WooCommerce API konuları
Son güncelleme: 27.10.2026 · WooCommerce API rehberinin tamamı