Amazon Türkiye entegrasyonu, Amazon.com.tr'deki satıcı hesabınızın ürün, stok, fiyat, sipariş ve rapor işlemlerini Amazon'un Selling Partner API'si (SP-API) ile yazılımdan yönetmektir. SP-API REST yapısındadır ve Türkiye, Avrupa bölgesi uç noktasından hizmet alır.
İlgili içerikler: Pazaryeri entegrasyonu rehberi · Trendyol entegrasyonu · Hepsiburada entegrasyonu
Türkiye İçin Temel Bilgiler
| Bilgi | Değer |
|---|---|
| Pazaryeri kimliği (Marketplace ID) | A33AVAJ2PDY3EV |
| Uç nokta | https://sellingpartnerapi-eu.amazon.com |
| AWS bölgesi | eu-west-1 |
| Token adresi | https://api.amazon.com/auth/o2/token |
Satıcı hesabı için Amazon Türkiye'nin istediği belgeler arasında kimlik, vergi levhası, şirket türüne göre ticaret sicil gazetesi veya oda kayıt belgesi ve işletme adına güncel banka dökümü ya da kredi kartı ekstresi bulunuyor.
Geliştirici Kaydı ve Uygulama
- Geliştirici profili: Seller Central'da Apps and Services, Develop Apps menüsünden (Solution Provider Portal'a geçilmişse Settings, Developer Profile) iletişim bilgileri doldurulur, veri erişimi için "Private Developer" seçilir, roller, kullanım senaryoları ve güvenlik kontrolleri girilir, sözleşmeler kabul edilir.
- İnceleme: Amazon bir destek kaydı açar; ek bilgi istenirse 5 gün içinde yanıt verilmezse kayıt kapanır.
- Uygulama: Develop Apps ekranında "Add new app client" ile oluşturulur. Bunu yalnızca hesabın birincil kullanıcısı yapabilir.
- Refresh token: Kendi hesabınız için uygulamanın yanındaki "Authorize app" düğmesiyle alınır. Uygulama taslak durumdayken bile yetkilendirilebilir.
Kimlik Doğrulama
curl -X POST https://api.amazon.com/auth/o2/token \
-d grant_type=refresh_token \
-d refresh_token=REFRESH_TOKEN \
-d client_id=CLIENT_ID \
-d client_secret=CLIENT_SECRET- Access token 3600 saniye (1 saat) geçerlidir.
- Her istekte
x-amz-access-token,x-amz-dateveuser-agentbaşlıkları gönderilir. - 2 Ekim 2023'ten beri AWS IAM rolü ve SigV4 imzası gerekmiyor; Login with Amazon tokenı yeterli.
- Bildirim hedefleri gibi satıcıya bağlı olmayan işlemlerde
client_credentialsakışı ve ilgili scope kullanılır.
Roller
SP-API'de 18 rol var; uygulamanız yalnızca onaylanmış rollerin işlemlerini çağırabilir, aksi halde 403 alır. Sık kullanılanlar: Product Listing, Inventory and Order Tracking, Pricing, Amazon Fulfillment, Finance and Accounting. Alıcı adresi ve vergi bilgisi gibi kişisel veriler içeren roller (ör. Direct-to-Consumer Shipping, Tax Invoicing) kısıtlıdır ve ayrı onay gerektirir. Yeni rol onaylandıktan sonra uygulamaya eklenip yeniden yetkilendirme yapılmalıdır.
Ana API'ler
| API | Ne işe yarar |
|---|---|
| Listings Items | Ürün listeleme oluşturma, güncelleme, silme ve sorgulama (tekil) |
| Product Type Definitions | Ürün tipinin zorunlu özelliklerini JSON Schema olarak verir |
| Feeds | Toplu yükleme; ürünler için JSON_LISTINGS_FEED. XML ve düz dosya listeleme feed'leri kullanımdan kaldırıldı |
| Orders | Sipariş eşitleme; güncel sürüm 2026-01-01, v0 kullanımdan kaldırıldı |
| Reports | Rapor oluşturma, indirme ve zamanlama |
| Notifications | Sorgulama yerine olay aboneliği; hedef Amazon SQS veya EventBridge |
Kişisel Veriler ve Restricted Data Token
Sipariş adresi ve alıcı bilgisi gibi kısıtlı verileri döndüren işlemler (ör. sipariş ve sipariş adresi uçları, bazı rapor belgeleri) normal token yerine Restricted Data Token (RDT) ister. RDT, Tokens API ile buyerInfo, shippingAddress gibi veri öğeleri belirtilerek alınır.
Türkiye'ye Özel Noktalar
Amazon Türkiye'nin API sayfasından bağlantı verilen Türkçe belgelere göre fatura UPLOAD_VAT_INVOICE feed'iyle gönderiliyor, Kolay Gönderi etiketleri feed üzerinden alınıyor ve siparişler Orders 2026-01-01 sürümüyle çekiliyor.
Sık Sorulan Sorular
IAM rolü ve SigV4 imzası hâlâ gerekli mi?
Hayır. 2 Ekim 2023'ten beri Login with Amazon tokenı yeterli.
Refresh token nasıl alınır?
Kendi hesabınız için Develop Apps ekranındaki "Authorize app" düğmesiyle; yalnızca birincil kullanıcı yapabilir.
Alıcı adresini neden göremiyorum?
Adres kısıtlı veridir; ilgili kısıtlı rol onayı ve Restricted Data Token gerekir.
Marka adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen kuruluşlarla bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.