Filtreler
| Parametre | Anlamı |
|---|---|
| min_created, max_created | Oluşturulma zaman aralığı, Unix saniye |
| min_last_modified, max_last_modified | Son değişiklik zaman aralığı |
| limit, offset | Sayfa boyutu (1–100, varsayılan 25) ve atlanan kayıt |
| sort_on, sort_order | created, updated ya da receipt_id; artan ya da azalan |
| was_paid, was_shipped, was_delivered, was_canceled | Ödeme, kargo, teslim ve iptal durumuna göre süzme |
Yeni siparişler için min_created, durum değişiklikleri için min_last_modified kullanmak daha az istekle daha güncel veri verir. Tek bir siparişi okumak için GET .../shops/{shop_id}/receipts/{receipt_id}, yalnız kalemleri almak için .../receipts/{receipt_id}/transactions ucu kullanılır.
Sipariş durumları
| status | Etsy'deki anlamı |
|---|---|
| paid | Ödendi, gönderime hazır |
| completed | Kargolandı ve tamamlandı sayıldı |
| payment processing | Ödeme bilgisi gönderildi, işlem sürüyor |
| open | Eski bir değer; Etsy ödemesi kullanılmayan dönemden kalma |
| canceled | İptal edildi |
| fully refunded, partially refunded | Tam ya da kısmi iade edildi |
status yanında is_paid ve is_shipped alanları da gelir. Canlı kullanımda completed durumunun sipariş verildikten saatler sonra görülebildiği gözlendi; bu durum teslimat onayı anlamına gelmez.
Sipariş kalemleri
Her receipt'in transactions dizisinde satılan ürünler bulunur. Stok düşümü için gereken alanlar şunlardır:
- listing_id ve product_id: satılan ilan ve envanterdeki ürün.
- sku: ürünün SKU'su; ilanda tanımlanmadıysa boş gelebilir.
- quantity: satılan adet.
- price ve shipping_cost: Money nesnesi; amount bölü divisor ile okunur.
- variations: alıcının seçtiği varyasyonlar ve kişiselleştirmeler.
Receipt düzeyinde grandtotal, subtotal, total_shipping_cost, total_tax_cost ve refunds alanları vardır. refunds dizisi iade tutarını, nedenini ve durumunu taşır.
Adres ve alıcı bilgisi
Etsy şemasına göre adres alanlarına (first_line, city, zip, country_iso, formatted_address) erişim bazı bölgelerde Etsy ile tercihli ortaklık durumuna bağlıdır. buyer_email alanı ise erişim verilmediyse boş döner; Commercial Access uygulamaları bu alanı ayrıca istemelidir. Kargo etiketi ya da fatura akışınız bu alanlara dayanıyorsa önce erişiminizi doğrulayın.
Sık sorulanlar
Etsy siparişleri API ile nasıl çekilir?
GET /v3/application/shops/{shop_id}/receipts ucunu transactions_r kapsamlı token ile çağırın. min_created ile tarih aralığı verip limit ve offset ile sayfa sayfa ilerleyin.
Etsy completed durumu teslim edildi mi demek?
Hayır. Etsy'ye göre completed, siparişin kargolanıp tamamlandı sayıldığı anlamına gelir. Teslim bilgisi için was_delivered filtresi ve kargo bilgisi kullanılır.
Etsy siparişinde alıcının adresi neden boş?
Adres alanlarına erişim bazı bölgelerde Etsy ile tercihli ortaklık durumuna bağlıdır. Uygulamanızın bu erişime sahip olup olmadığını kontrol edin.
Etsy webhook ile sipariş bildirimi alınabilir mi?
Evet, order.paid gibi olaylar için webhook aboneliği kurulabilir. Bildirim yalnız olay türünü ve receipt adresini taşır; ayrıntı için bu uç yine çağrılır.
Kaynaklar
İlgili Etsy API konuları
Son güncelleme: 27.10.2026 · Etsy API rehberinin tamamı