REST filtreleri
| Parametre | Varsayılan | Açıklama |
|---|---|---|
| status | open | open, closed, cancelled ya da any; any arşivlenmişleri de getirir |
| created_at_min, created_at_max | - | Oluşturulma tarihine göre süzme, ISO 8601 |
| updated_at_min | - | Son güncellemeye göre süzme |
| since_id | - | Belirli numaradan sonraki siparişler |
| financial_status | any | Ödeme durumuna göre süzme |
| fulfillment_status | any | Gönderim durumuna göre süzme |
| limit | 50 | En fazla 250 |
| fields | - | Yalnız istenen alanlar |
Sonraki sayfalar Link başlığındaki page_info ile istenir ve bu isteklerde limit dışında parametre gönderilmez. Filtreleri yalnız ilk istekte verin.
Senkron için önemli sipariş alanları
| Alan | Açıklama |
|---|---|
| id | Sipariş numarası (API kimliği) |
| name | Görünen sipariş adı, ör. #1001 |
| order_number | Sayı olarak sipariş numarası |
| created_at | Oluşturulma zamanı |
| financial_status, fulfillment_status | Ödeme ve gönderim durumu |
| cancelled_at | İptal zamanı; iptal değilse null |
| total_price, currency | Toplam ve para birimi |
| line_items | Kalemler: variant_id, sku, quantity, price, title |
| shipping_address | Teslimat adresi |
| fulfillments | Gönderimler: tracking_number, tracking_company, tracking_url |
Stok düşümü için kalemdeki variant_id en güvenilir eşleştirme alanıdır; sku boş olabilir.
60 gün kuralı ve korumalı veri
Shopify belgesine göre Order kaynağından varsayılan olarak yalnız son 60 günün siparişlerine erişilir. Uygulamaya izin verilmişse read_orders ya da write_orders yanında read_all_orders eklenerek tüm geçmişe ulaşılır.
Sipariş kaynağı korumalı müşteri verisi içerir. Ad, adres, telefon ve e-posta alanlarına erişim uygulama türüne ve mağaza planına göre değişebilir. Fatura için bu alanlara ihtiyacınız varsa uygulamanın veri erişimini kontrol edin.
Yeni ve değişen siparişleri yakalamak
Stok senkronunda iki şeyi kaçırmamanız gerekir: yeni siparişler ve eski siparişlerin durum değişiklikleri.
| Yöntem | Neyi yakalar | Not |
|---|---|---|
| created_at_min | Belirli zamandan sonra oluşan siparişler | Sonradan iptal edilen eski siparişi kaçırır |
| updated_at_min | Belirli zamandan sonra değişen siparişler | İptal ve iadeleri de getirir |
| since_id | Belirli numaradan sonraki siparişler | Yalnız yeni siparişler için |
| orders/updated webhook’u | Değişiklik anında bildirim | Düzenli okumayla birlikte kullanın |
Okuma penceresini birkaç dakika geriden başlatın ve aynı siparişi numarasıyla tekilleştirin. Böylece iki okuma arasında oluşan siparişler kaybolmaz.
Sık hatalar
| Belirti | Neden | Çözüm |
|---|---|---|
| İptal edilen siparişler gelmiyor | status varsayılanı open | status=any gönderin |
| Yalnız 50 sipariş geliyor | limit gönderilmedi | limit=250 ve page_info kullanın |
| İkinci sayfa hata veriyor | page_info ile filtre gönderildi | Sonraki sayfalarda yalnız page_info ve limit |
| Eski siparişler yok | 60 gün sınırı | read_all_orders kapsamı |
| Sonradan iptal edilen sipariş kaçtı | Yalnız created_at_min kullanıldı | updated_at_min ile değişenleri de okuyun |
Sık sorulanlar
Shopify siparişleri API ile nasıl çekilir?
REST’te GET /admin/api/SURUM/orders.json?status=any&limit=250 ile başlayıp Link başlığındaki page_info ile sayfaları gezersiniz. GraphQL’de orders sorgusu kullanılır.
İptal edilen siparişler neden listede yok?
REST’te status parametresinin varsayılanı open’dır. Tüm siparişler için status=any gönderin.
Shopify’da 60 günden eski siparişleri nasıl alırım?
read_all_orders kapsamı gerekir. Bu kapsam olmadan Order kaynağı yalnız son 60 günü döndürür.
Kargo takip numarası nerede?
Siparişin fulfillments alanında: tracking_number, tracking_company ve tracking_url.
Kaynaklar
İlgili Shopify API konuları
Son güncelleme: 27.10.2026 · Shopify API rehberinin tamamı