efaturan
Etsy logosuPazar yeri entegrasyonu

Etsy e-Arşiv Fatura Entegrasyonu

Etsy mağazanızdan Türkiye'deki alıcılara yaptığınız satışlar panele gelir ve e-Arşiv Fatura olarak kesilir. Etsy satırlara KDV oranı yazmadığı için mağazada bir kez tek tip KDV oranı seçersiniz; yurt dışına giden siparişler ayrı tutulur.

Erken erişim talep etNasıl bağlanır?
Belge türleri
e-Arşiv Fatura (nihai tüketici)
Faturanın iletimi
PDF ve fatura linki
Siparişler
15 dakikada bir kontrol
Raflarda el yapımı seramik kaplar
Etsy siparişinin panelde faturalanmasını gösteren örnek görünüm: sipariş 3489127650, tutar ₺2.150,00, e-Arşiv Fatura.

Etsy ile otomatik faturalama

Etsy sipariş entegrasyonu nasıl çalışır?

  1. 01

    Ödenen siparişler gelir

    Ödemesi tamamlanmamış siparişler alınmaz. Ödenen ve gönderilen siparişler, Etsy'de son değiştikleri zamana göre çekilir.

  2. 02

    Fatura nihai tüketiciye

    Etsy alıcının vergi kimliğini paylaşmaz. Bu yüzden faturalar bireysel alıcı adına, nihai tüketici kimliğiyle e-Arşiv Fatura olarak düzenlenir.

  3. 03

    Kupon ve seçenekler korunur

    Mağaza kuponu satır indirimine dönüşür. Renk, beden gibi ürün seçenekleri faturada ürün adının yanına yazılır.

  4. 04

    Kargo ve hediye paketi

    Etsy'deki kargo ücreti faturaya eklenir, hediye paketi ücreti ayrı satırda yer alır. Varsayılan ayarda e-Arşiv faturaya web adresi olarak Etsy, ödeme şekli olarak ödeme aracısı yazılır.

Kurulum

Etsy API bağlantısı: uygulama, OAuth onayı ve jetonlar

  1. 1

    Etsy uygulaması açın

    etsy.com/developers/your-apps adresinde bir uygulama oluşturun. Uygulamanın Keystring (API Key) ve Shared Secret değerleri bu sayfadadır.

  2. 2

    Mağaza sahibinin onayını alın

    OAuth 2.0 (PKCE) akışıyla mağaza hesabından onay alın ve transactions_r ile shops_r izinlerini isteyin. Akışın sonunda Etsy bir Refresh Token verir.

  3. 3

    Bilgileri panele girin

    Mağaza Ayarları'nda Etsy'yi seçip Keystring, Shared Secret ve Refresh Token'ı girin. Access Token ve Mağaza ID boş kalabilir: erişim jetonu otomatik alınır, mağaza yetkili hesaptan bulunur.

  4. 4

    KDV oranını seçin

    Mağazanın Fatura ayarlarında "Tek tip KDV" alanından ürünlerinizin oranını belirleyin. Bu seçim yapılmadan Etsy siparişleri otomatik faturalanmaz.

Etsy bağlantısı için panelde istenen bilgiler: Uygulama Keystring (API Key), Shared Secret, Refresh Token, Access Token (isteğe bağlı), Mağaza ID (Shop ID).
Dizüstü bilgisayar, tablet ve akıllı telefon

Ayrıntılar

Etsy fatura kesme öncesi bilmeniz gerekenler

Etsy'nin API'si bazı bilgileri hiç vermez ya da Etsy onayına bağlar. Aşağıdaki durumlarda sipariş otomatik faturalanmaz ve nedeni sipariş satırında yazar.

  • KDV oranı gelmez. Fiyatlar KDV dahil kabul edilir ve Türkiye siparişleri tek tip KDV seçilene kadar bekler.
  • Yurt dışındaki alıcılara giden siparişler ihracat sayılır ve otomatik faturalanmaz.
  • Alıcı adresi bazı bölgelerde Etsy onayına bağlıdır. Etsy adresi paylaşmadıysa siparişin faturasını elle düzenlemeniz gerekir.
  • Kısmi iade yapılmış siparişler, tutarları kontrol edilsin diye bekletilir. Tamamen iade edilen siparişler faturalanmaz.
  • Refresh Token 90 gün geçerlidir. Her yenilemede Etsy yeni bir jeton verir ve bu jeton saklanır; mağaza düzenli eşitlendiği sürece yeniden onay gerekmez.
  • Faturadaki ürün kodu listelemenin SKU değeridir; SKU girilmemişse listeleme numarası yazılır.

Tek panel

Etsy faturalarınız diğer belgelerinizle aynı yerde

Entegrasyonlar

Diğer pazar yeri entegrasyonları

Tüm entegrasyonlar

Sık sorulan sorular

Etsy siparişleri ve faturaları hakkında sık sorulan sorular

Kurulumla ilgili ayrıntılar için bağlantı adımlarına bakabilirsiniz.

Etsy bağlantısı için hangi bilgiler gerekiyor?

Etsy uygulamanızın Keystring ve Shared Secret değerleri ile mağaza sahibinin OAuth onayıyla alınan Refresh Token. Mağaza ID ve Access Token isteğe bağlıdır.

Etsy siparişlerine neden e-Fatura değil e-Arşiv Fatura kesiliyor?

e-Fatura için alıcının VKN'sinin sorgulanması gerekir. Etsy alıcının vergi kimliğini paylaşmadığı için sorgu yapılamaz ve fatura nihai tüketiciye e-Arşiv Fatura olarak düzenlenir.

Tek tip KDV seçmezsem ne olur?

Siparişler çekilir ve listede görünür ama otomatik faturalanmaz; satırında Etsy'nin KDV oranı göndermediği yazar. Oranı seçtikten sonra çekilen siparişler bu oranla faturalanır.

Refresh Token süresi dolarsa ne yapmalıyım?

Eşitleme, Etsy yetkilendirmesinin geçersiz olduğunu bildirir. OAuth onayını yeniden alıp yeni Refresh Token'ı mağaza ayarına girmeniz yeterlidir.

Yurt dışına sattığım Etsy siparişleri faturalanır mı?

Otomatik faturalanmaz. Alıcı ülkesi Türkiye dışındaysa sipariş ihracat olarak işaretlenir ve listede nedeniyle birlikte görünür; ihracat faturasını ayrıca düzenlersiniz.

Etsy kuponları faturaya nasıl yansır?

Mağazanızın kuponu ilgili satıra indirim olarak yazılır. Etsy kuponu satır bazında vermediyse siparişteki toplam indirim, ürünlere tutarları oranında dağıtılır.

Fatura Etsy'ye yükleniyor mu?

Hayır. Etsy'nin API'sinde fatura yükleme işlemi yoktur. Faturayı mağaza ayarında açarak alıcının e-posta adresine NES e-posta servisiyle gönderebilir ya da herkese açık fatura linkini alıcıyla paylaşabilirsiniz.

Etsy siparişlerinizi faturalamaya başlayın

efaturan şu an davetle kullanılıyor. Erken erişim talebinizi bırakın; hesabınız açıldığında ilk faturaları NES test ortamında, belgeler GİB'e gitmeden birlikte kontrol edelim.
Erken erişim talep etGiriş yap