Temel alanlar
| Alan | Açıklama |
|---|---|
| tracking_code | Kargo firmasının verdiği takip kodu |
| carrier_name | Etsy'nin tanıdığı firma kodu, ör. ptt-posta, ups, dhl, fedex |
| send_bcc | true ise bildirim satıcıya da gider |
| note_to_buyer | Alıcıya giden bildirime eklenecek not |
| ship_date | Gönderim tarihi; ISO 8601 UTC, ör. 2026-03-30T10:00:00Z |
Etsy'ye göre takip kodu ve firma gönderilmezse sipariş yalnız "kargolandı" olarak işaretlenir. Firma listede yoksa carrier_name için other kullanılabilir. ABD içi 10 doların üzerindeki siparişlerde ve Hindistan'a gönderimde iki alan zorunludur.
Önerilen ek bilgiler
Etsy daha hızlı takip güncellemesi ve doğru teslim tahmini için şu alanları önerir (Etsy: Fulfillment Tutorial):
- Paket: mail_class, weight ve weight_units, length, width, height ve dimension_units.
- Etiket: shipping_label_cost ve shipping_label_currency.
- Uluslararası gönderi: ship_from_country, ship_to_country, incoterm, duty_amount, duty_currency.
- Gümrük: customs_data dizisinde country_of_origin, declared_value ve HS_code.
ship_date biçimi hatalıysa Etsy tarihi hata vermeden yok sayar. Türkiye'den yurt dışına gönderim yapan satıcılar için gümrük alanları özellikle önemlidir.
Erişim kısıtı ve 403
Etsy, tercihli ortak programının uygulandığı bölgelerde bu ucu yalnız onaylı uygulamalara açar. Diğer uygulamalar, anahtar geçerli ve token'da transactions_w olsa bile 403 ve "Unauthorized" alır. Başvuruya göre şu uygulamalar yetkilidir:
| Uygulama | Erişim |
|---|---|
| Fulfillment ya da Print On Demand kategorisinde Commercial Access | Var |
| Satıcının kendi kişisel kullanım uygulaması | Var |
| Program bölgede başlamadan önce satıcının yetkilendirdiği uygulama | Var |
| Diğerleri | 403; Etsy desteğine başvurulur |
Bu hata kapsam, başlık ya da gövde değiştirilerek düzelmez.
Gönderimden sonra ne olur?
- Alıcıya kargo bildirimi e-postası gider; her başarılı istekte yeniden gönderilir.
- Etsy vergi, indirim ve kargo hesaplarını kesinleştirir; yanıt güncel receipt'i döndürür.
- Ödeme kaydı (payment) kargodan sonra oluşur; ödeme defterinde ise satış anında bir giriş görünür.
- Desteklenen firma ve servis sınıflarını GET /v3/application/shipping-carriers?origin_country_iso=TR ile görebilirsiniz.
- Etsy'ye göre her başarılı istek siparişe yeni bir gönderi kaydı (receipt shipment) ekler. Aynı kodu iki kez göndermemek için gönderdiğiniz kodları kendi tarafınızda işaretleyin.
Sık sorulanlar
Etsy'ye PTT kargo takip numarası nasıl girilir?
carrier_name olarak ptt-posta, tracking_code olarak PTT'nin verdiği kodu gönderin. Etsy belgesine göre PTT Posta için takip güncellemesi desteklenir.
createReceiptShipment neden 403 Unauthorized dönüyor?
Uç bazı bölgelerde yalnız Etsy'nin onayladığı uygulamalara açıktır. Kapsam doğru olsa bile onaysız uygulama 403 alır; Etsy desteğine başvurmanız gerekir.
Kargo firması listede yoksa ne yapmalı?
carrier_name için other gönderip takip kodunu yine ekleyebilirsiniz. Bu durumda Etsy takip güncellemelerini göstermeyebilir.
Takip bilgisi gönderince alıcıya e-posta gider mi?
Evet. Etsy her başarılı istekte alıcıya kargo bildirimi gönderir. send_bcc=true gönderirseniz aynı bildirim satıcıya da gider.
Kaynaklar
İlgili Etsy API konuları
Son güncelleme: 27.10.2026 · Etsy API rehberinin tamamı