Amazon Türkiye Seller API: Satıcılar İçin Entegrasyon Rehberi

Amazon SP-API Nedir, MWS'den Farkı Ne?

Amazon 2022 itibarıyla eski Marketplace Web Service (MWS) API'yi resmi olarak kapattı. Tüm yeni entegrasyonlar Selling Partner API (SP-API) üzerinden yapılmalıdır. SP-API, REST mimarisi ve modern OAuth 2.0 (LWA) kimlik doğrulaması kullanır.

• MWS: SOAP tabanlı, karmaşık imzalama — artık kullanılamaz
• SP-API: RESTful, JSON, LWA OAuth 2.0 — güncel ve zorunlu
• Rol tabanlı erişim: her API modülü ayrı izin gerektirir
• Sandbox: her modül için ayrı test ortamı mevcut
• Rate limiting: her endpoint için bağımsız token bucket sistemi

Temel SP-API Modülleri

Amazon SP-API, her iş sürecine özel modüler API'lerden oluşur. En çok kullanılan modüller şunlardır:

• Orders API — sipariş listesi, sipariş detayı, sipariş öğeleri
• Listings Items API — ürün oluşturma, güncelleme, silme
• Catalog Items API — Amazon ürün kataloğunda arama ve detay
• FBA Inventory API — FBA stok seviyeleri ve yerleşim bilgisi
• Fulfillment Outbound API — Amazon kargo ile sipariş gönderme
• Reports API — satış, stok ve performans raporlarının toplu çekimi
• Notifications API — gerçek zamanlı sipariş ve fiyat bildirimleri (webhook benzeri)

LWA OAuth 2.0 Kurulumu

SP-API, 'Login with Amazon' (LWA) OAuth 2.0 protokolünü kullanır. Uygulama kaydı ve satıcı yetkilendirmesi için Amazon Developer Central üzerinden işlem yapılır.

• 1. sellercentral.amazon.com.tr → 'Uygulamalar ve Hizmetler' → 'Uygulamaları Geliştir'
• 2. IAM ARN oluşturun (AWS hesabı zorunlu) ve Developer Central'a ekleyin
• 3. Uygulama oluşturduktan sonra Client ID ve Client Secret alın
• 4. Authorization Code Grant ile satıcı izni alın → Refresh Token üretin
• 5. Refresh Token ile Access Token alın (1 saatte sona erer, otomatik yenileme zorunlu)
• 6. Her API çağrısında 'x-amz-access-token' header'ı ekleyin

Amazon Türkiye Özel Notlar

Amazon.com.tr (marketplace ID: A33AVAJ2PDY3EV), Amazon'un genel SP-API altyapısını kullanır ancak Türkiye'ye özgü bazı durumlar söz konusudur.

• FBA Türkiye: Amazon fulfillment merkezi İstanbul Çerkezköy'de — FBA entegrasyonu mümkün
• Dil: Listing içerikleri Türkçe olmalı; A+ içerik Türkiye'de destekleniyor
• Komisyon: kategoriye göre %8–15, FBA kullanılırsa kargo + depolama ücreti eklenir
• VAT: Türkiye KDV kuralları geçerli; B2B satışlar için vergi numarası zorunlu
• Brand Registry: kendi markanız varsa marka tescili ile A+ içerik ve Sponsored Brand reklamları açılır

Entegrasyon Süreci

Solman Digital tarafından gerçekleştirilen Amazon SP-API projelerinde standart zaman çizelgesi şu şekildedir:

• Gün 1–2: Developer Central başvurusu, IAM kurulumu, LWA OAuth testi
• Gün 3–5: Orders API — sipariş çekme, durum güncelleme, Notifications API webhook kurulumu
• Gün 6–8: Listings API — ürün oluşturma, güncelleme; Catalog API ile ASIN eşleştirme
• Gün 9–10: FBA Inventory API veya kendi kargo entegrasyonu
• Gün 11–12: Reports API ile satış/performans dashboard'u
• Gün 13–15: Stres testi, rate limit yönetimi, monitoring ve dokümantasyon

Sık Sorulan Sorular