Invozon × Amazon Türkiye

Amazon Türkiye (amazon.com.tr), Amazon'un Türkiye'de 2018'de açılan ve 2024 sonrası agresif yatırımlarla büyüyen pazaryeridir. Trendyol ve Hepsiburada'ya kıyasla daha düşük müşteri trafiği vardır, ancak ortalama sepet tutarı, premium markalara yakınlığı ve Prime üyelerinin satın alma sıklığı onu yüksek değerli kategoriler için cazip kılar. Amazon ekosistemi diğer Türk pazaryerlerinden teknik olarak köklü biçimde farklıdır: tüm entegrasyon SP-API (Selling Partner API) ve LWA (Login with Amazon) tabanlıdır, OAuth 2.0 token akışı, IAM rol delegasyonu ve marketplace ID kavramı gibi AWS-vari kalıplar zorunludur.

Invozon'un Amazon TR konektörü, bu AWS-ağırlıklı kurulum yükünü tamamen ortadan kaldırır. Bir kez Konsol'dan Amazon hesabınıza yetki verdikten sonra Invozon LWA refresh token rotasyonunu, AWS Signature v4 imzalamayı, marketplace seçimini (A33AVAJ2PDY3EV = Amazon TR) ve SP-API'nin parça parça dağıtık modülünü (Listings, Orders, Reports, Catalog, Feeds, FBA Inventory, Merchant Fulfillment, Shipping vb.) tek bir Invozon API yüzeyinde toplar. Aşağıda en sık ihtiyaç duyulan akışları, JSON örnekleriyle bulacaksınız.

Bu rehber Amazon TR mağazanızı Invozon'a bağlamak, ana akışları işletmek ve FBM / FBA, ASIN eşleme, Brand Registry, Buy Box gibi Amazon-özgü kavramları doğru kurmak için hazırlandı.

Bağlantı kurma

Amazon TR entegrasyonu için Seller Central hesabınızdan Invozon'a SP-API yetkisi vermeniz gerekir. Trendyol'da olduğu gibi tek bir "API anahtarı yapıştır" akışı değildir; OAuth tabanlı yetki devri vardır.

sellercentral.amazon.com.tr üzerinden satıcı hesabınıza giriş yapın.
Üst menüden Apps & Services → Manage Your Apps sayfasına gidin.
Authorize new developer butonuna basın.
Developer Name kısmına Invozon yazın, Developer ID için Invozon Konsolu'nun Settings → Marketplaces → Amazon TR ekranında size verilen 16 haneli kimliği girin (amzn-dev-xxxxxxxxxxx).
Sözleşmeyi onayladığınızda Amazon size bir MWS Auth Token ve bir LWA Refresh Token üretecektir. Bu iki değer otomatik olarak Invozon'a aktarılır; manuel kopyalamanıza gerek yoktur, redirect URL üzerinden yetki devri tamamlanır.
Brand Registry'e kayıtlı bir markanız varsa Account Info → Brand Settings üzerinden markayı onaylanmış olarak işaretleyin; aksi halde A+ içerik, marka koruma ve sponsorlu ürün reklamlarına erişiminiz olmaz.

Invozon Konsolu'nda Settings → Marketplaces → Amazon TR → Connect with Amazon butonuna basın; standart OAuth redirect ile Seller Central'a yönlendirilir, yetki onayından sonra geri dönersiniz.

# Bağlantıyı doğrulayan ping çağrısı
curl https://api.invozon.com/v1/marketplaces/amazon-tr/account \
  -H "Authorization: Bearer $INVOZON_TOKEN"

{
  "status": "connected",
  "selling_partner_id": "A2XXXXXXXXXXXX",
  "marketplace_id": "A33AVAJ2PDY3EV",
  "marketplace_name": "Amazon.com.tr",
  "store_name": "Örnek Satıcı",
  "brand_registry": ["INVOZON"],
  "refresh_token_expires_at": null,
  "checked_at": "2026-06-02T08:14:22Z"
}

Amazon TR marketplace kimliği her zaman A33AVAJ2PDY3EV'tir; çoklu marketplace satışı yapıyorsanız (örn. Amazon DE) Invozon'da ayrı bağlantı kurmanız gerekir.

Endpoint referansı

Invozon'un Amazon TR uç noktaları /v1/marketplaces/amazon-tr/ öneki altındadır. SP-API'nin asenkron Feed/Report mantığı Invozon tarafında "request_id" → "polling" desenine soyutlanmıştır; SDK kullanıyorsanız callbacks/webhook olarak alabilirsiniz.

Ürün listeleme

Amazon'da ürün açma iki ayrı senaryoda yürür: (a) Amazon kataloğunda zaten var olan bir ürün için satış teklifi (offer) ekleme, (b) Amazon kataloğunda olmayan bir ürün için yeni listing yaratma. Yeni listing yaratmak ASIN/EAN/GTIN gerektirir ve Brand Registry için marka onayı şarttır.

# Mevcut ASIN'e offer ekleme
curl -X POST https://api.invozon.com/v1/marketplaces/amazon-tr/listings \
  -H "Authorization: Bearer $INVOZON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "seller_sku": "INV-KETTLE-001",
        "asin": "B09XYZ12AB",
        "condition": "new_new",
        "price": 599.90,
        "currency": "TRY",
        "quantity": 30,
        "fulfillment": "FBM",
        "handling_time_days": 2
      }
    ]
  }'

Yeni ürün açma (Brand Registry markası için):

curl -X POST https://api.invozon.com/v1/marketplaces/amazon-tr/listings \
  -H "Authorization: Bearer $INVOZON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "seller_sku": "INV-BTSPK-001",
        "product_type": "PORTABLE_SPEAKER",
        "external_product_id": "8690000234567",
        "external_product_id_type": "EAN",
        "title": "Invozon Mini Bluetooth Hoparlör 5W, 10 saat pil",
        "brand": "Invozon",
        "manufacturer": "Invozon Elektronik A.Ş.",
        "bullet_points": [
          "10 saat aralıksız müzik dinleme süresi",
          "IPX5 sertifikalı su geçirmez gövde",
          "Bluetooth 5.3, 10 metre kapsama",
          "Type-C hızlı şarj, 2 saatte tam dolum"
        ],
        "description": "Taşınabilir bluetooth hoparlör. Plaj, kamp ve günlük kullanım için.",
        "price": 449.90,
        "quantity": 50,
        "fulfillment": "FBM",
        "package_weight_kg": 0.42,
        "images": [
          { "role": "main",       "url": "https://cdn.example.com/btspk-001-main.jpg" },
          { "role": "swatch_1",   "url": "https://cdn.example.com/btspk-001-side.jpg" },
          { "role": "lifestyle_1","url": "https://cdn.example.com/btspk-001-beach.jpg" }
        ]
      }
    ]
  }'

Yanıt:

{
  "submission_id": "amzn-sub-f51a0f3c",
  "accepted_count": 1,
  "rejected_count": 0,
  "status_url": "/v1/marketplaces/amazon-tr/submissions/amzn-sub-f51a0f3c"
}

Submission durumunu sorgulayın:

curl https://api.invozon.com/v1/marketplaces/amazon-tr/submissions/amzn-sub-f51a0f3c \
  -H "Authorization: Bearer $INVOZON_TOKEN"

{
  "submission_id": "amzn-sub-f51a0f3c",
  "status": "ACCEPTED",
  "items": [
    {
      "seller_sku": "INV-BTSPK-001",
      "status": "VALID",
      "asin": "B0AB12XY34",
      "warnings": [],
      "errors": []
    }
  ]
}

Yeni ürün için ASIN ataması 1-6 saat içinde tamamlanır. Amazon kataloğunda benzer bir ürün varsa Amazon otomatik olarak sizin ürününüzü o ASIN'e bağlar; bu durumda Invozon yanıtında merged_with_existing_asin: true flag'i görünür.

Stok güncelleme

Amazon SP-API stok güncellemesini Listings Items API veya Feeds API üzerinden yapar. Invozon küçük partileri Listings Items üzerinden anlık, büyük partileri Feeds üzerinden batch gönderir; siz hep aynı uç noktayı çağırırsınız.

curl -X POST https://api.invozon.com/v1/marketplaces/amazon-tr/inventory \
  -H "Authorization: Bearer $INVOZON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "seller_sku": "INV-BTSPK-001", "quantity": 38, "price": 429.90 },
      { "seller_sku": "INV-KETTLE-001","quantity": 0,  "price": 599.90 }
    ]
  }'

{
  "submission_id": "amzn-feed-3f1a4c4e",
  "queued": 2
}

Amazon stok feed'leri kataloğa 5-30 dakika içinde yansır; flash sale durumlarında bu gecikme dönüşüm kaybına neden olabilir. Hızlı güncelleme için Invozon priority: "realtime" opsiyonu Listings Items API'sini doğrudan kullanır ve 30 saniye altında yansıma sağlar (kotanız bunu kaldırırsa).

Sipariş alma

Amazon siparişleri Orders API üzerinden çekilir.

curl "https://api.invozon.com/v1/marketplaces/amazon-tr/orders?status=Unshipped&start=2026-06-01T00:00:00Z&end=2026-06-02T00:00:00Z" \
  -H "Authorization: Bearer $INVOZON_TOKEN"

{
  "orders": [
    {
      "amazon_order_id": "402-5839124-1029384",
      "purchase_date": "2026-06-01T18:42:11Z",
      "order_status": "Unshipped",
      "fulfillment_channel": "MFN",
      "sales_channel": "Amazon.com.tr",
      "buyer": {
        "name": "Mehmet S.",
        "email": "[email protected]"
      },
      "shipping_address": {
        "name": "Mehmet S.",
        "address_line_1": "Levent Mah. Sülün Sok. No: 12 D: 4",
        "city": "Istanbul",
        "state_or_region": "Istanbul",
        "postal_code": "34330",
        "country_code": "TR",
        "phone": "+90-5xx-xxx-xxxx"
      },
      "order_total": { "amount": 449.90, "currency_code": "TRY" },
      "is_prime": false,
      "is_business_order": false,
      "items": [
        {
          "order_item_id": "12345678901234",
          "seller_sku": "INV-BTSPK-001",
          "asin": "B0AB12XY34",
          "title": "Invozon Mini Bluetooth Hoparlör 5W, 10 saat pil",
          "quantity_ordered": 1,
          "item_price": { "amount": 449.90, "currency_code": "TRY" }
        }
      ]
    }
  ]
}

Amazon, müşteri e-postasını maskelenmiş olarak verir; bu adresten gelen e-postalar Amazon Buyer-Seller Messaging sistemine düşer ve müşteriye iletilir.

Sipariş statüsü güncelleme

Amazon'da sipariş durumu doğrudan güncellenmez; bunun yerine kargo (shipment) bildirimi gönderirsiniz ve Amazon kalemleri otomatik Shipped durumuna geçirir.

curl -X POST https://api.invozon.com/v1/marketplaces/amazon-tr/orders/402-5839124-1029384/shipment \
  -H "Authorization: Bearer $INVOZON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "order_item_id": "12345678901234", "quantity": 1 }
    ],
    "carrier_code": "ARAS",
    "tracking_number": "ARS123456789",
    "shipping_method": "Standard",
    "ship_date": "2026-06-02T10:00:00Z"
  }'

Siparişi iptal etmek:

curl -X POST https://api.invozon.com/v1/marketplaces/amazon-tr/orders/402-5839124-1029384/cancel \
  -H "Authorization: Bearer $INVOZON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "NoInventory" }'

Amazon iptal nedenleri sınırlıdır: NoInventory, ShippingAddressUndeliverable, CustomerExchange, BuyerCanceled, GeneralAdjustment, CarrierCreditDecision, RiskAssessmentInformationNotValid, CarrierCoverageFailure. Geçerli olmayan sebepler 400 ile reddedilir.

Kargo etiketi üretme (Merchant Fulfilled Network)

FBM (Merchant Fulfilled) siparişlerinde Amazon'un Merchant Fulfillment servisi üzerinden indirimli kargo etiketi alabilirsiniz. Bu özellikle Amazon'un kendi anlaşmalı tarifelerini kullanmak isteyen satıcılar için cazip.

curl -X POST https://api.invozon.com/v1/marketplaces/amazon-tr/orders/402-5839124-1029384/label \
  -H "Authorization: Bearer $INVOZON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ship_from": {
      "name": "Invozon Depo",
      "address_line_1": "Cendere Yolu No: 1",
      "city": "Istanbul",
      "postal_code": "34396",
      "country_code": "TR"
    },
    "package_dimensions": {
      "length_cm": 22, "width_cm": 14, "height_cm": 9, "weight_kg": 0.45
    },
    "shipping_service_id": "AMZN_TR_PRG_PRIORITY"
  }'

{
  "label_format": "PDF",
  "label_url": "https://invozon-cdn.example.com/labels/amzn-402-5839124.pdf",
  "tracking_number": "TBA303929382938",
  "carrier_name": "Amazon Lojistik",
  "cost": { "amount": 24.50, "currency_code": "TRY" }
}

İade akışı

Amazon iadeleri "Return Authorization" mantığı ile yürür; çoğu iade müşteri tarafından otomatik onaylanır, satıcı sadece refund'u tamamlar.

curl "https://api.invozon.com/v1/marketplaces/amazon-tr/returns?start=2026-05-25T00:00:00Z&end=2026-06-02T00:00:00Z" \
  -H "Authorization: Bearer $INVOZON_TOKEN"

{
  "returns": [
    {
      "return_request_id": "RT-AMZN-77231",
      "amazon_order_id": "402-5839124-1029384",
      "order_item_id": "12345678901234",
      "asin": "B0AB12XY34",
      "seller_sku": "INV-BTSPK-001",
      "reason": "DEFECTIVE",
      "customer_comments": "Şarj olmuyor.",
      "status": "Authorized",
      "request_date": "2026-06-02T06:12:55Z",
      "amazon_provides_return_label": true
    }
  ]
}

Refund'u tetiklemek:

curl -X POST https://api.invozon.com/v1/marketplaces/amazon-tr/returns/RT-AMZN-77231/refund \
  -H "Authorization: Bearer $INVOZON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "refund_amount": 449.90,
    "refund_shipping": true,
    "reason": "DefectiveProduct"
  }'

FBA envanter takibi

FBA (Fulfilled by Amazon) kullanıyorsanız Amazon depolarındaki stok seviyenizi sorgulayabilirsiniz.

curl https://api.invozon.com/v1/marketplaces/amazon-tr/fba/inventory?seller_skus=INV-BTSPK-001,INV-KETTLE-001 \
  -H "Authorization: Bearer $INVOZON_TOKEN"

{
  "inventory": [
    {
      "seller_sku": "INV-BTSPK-001",
      "fnsku": "X001ABCDEF",
      "asin": "B0AB12XY34",
      "fulfillable_quantity": 124,
      "inbound_working": 0,
      "inbound_shipped": 30,
      "inbound_receiving": 0,
      "reserved_quantity": 8,
      "researching_quantity": 0,
      "unfulfillable_quantity": 2
    }
  ]
}

Buy Box ve fiyat rekabeti

Amazon TR'de Buy Box (satın al kutusu) satıcı puanı, fiyat ve teslimat hızına göre algoritmik olarak atanır. Invozon, sizin ürünleriniz için anlık Buy Box durumunu izlemenize izin verir.

curl "https://api.invozon.com/v1/marketplaces/amazon-tr/pricing/competition?seller_skus=INV-BTSPK-001" \
  -H "Authorization: Bearer $INVOZON_TOKEN"

{
  "items": [
    {
      "seller_sku": "INV-BTSPK-001",
      "asin": "B0AB12XY34",
      "buy_box_winner": "INVOZON",
      "your_price": 429.90,
      "lowest_price_new": 429.90,
      "lowest_price_used": 359.00,
      "competitor_count": 3
    }
  ]
}

Pazaryeri-spesifik notlar

ASIN eşleme ve katalog tekilliği. Amazon her ürünü ASIN ile tek bir kataloğa bağlar; aynı ürünü iki kez yaratmak teknik olarak engellenir. Yeni listing açarken Amazon, başlığa + EAN/GTIN'e bakarak otomatik eşleme yapar ve mevcut ASIN'i kullanır. Brand Registry markanız olmadan başkasının ASIN'ine offer eklemek serbestse de, başkasının markasıyla "yeni listing" açmaya çalıştığınızda Brand Owner'dan otomatik şikâyet gelir.

FBM vs FBA. FBM (Merchant Fulfilled Network) siparişleri siz gönderirsiniz; FBA (Fulfillment by Amazon) ise ürünleri önceden Amazon deposuna yollar ve siparişleri Amazon yönetir. Amazon TR'de FBA 2024'te aktif edildi ama henüz bütün kategorilerde değil; özellikle elektronik, ev/yaşam ve kişisel bakım kategorileri açıktır. FBA siparişleri için kargo, müşteri hizmetleri ve iade Amazon tarafından yönetilir; bu yüzden Buy Box kazanma şansı dramatik biçimde yüksektir.

Buy Box mekanizması. Buy Box, ürün sayfasında varsayılan satıcının belirlendiği algoritmadır. Aynı ASIN'i satan birkaç satıcıdan biri Buy Box'ı kazanır; satışların %85'i Buy Box satıcısına gider. Buy Box kazanmak için en az 4.5+ satıcı puanı, hızlı kargo, rekabetçi fiyat ve düşük iptal oranı gerekir. FBA satıcıları FBM'e göre Buy Box'ı kazanma konusunda doğal avantajlıdır.

Brand Registry zorunluluğu. Kendi markanızı satıyorsanız Amazon Brand Registry'e kayıt olmanız neredeyse zorunludur. Aksi halde başka satıcılar sizin ürün sayfanıza "piggyback" yapıp ucuza satabilir, A+ içerik (zengin marka sayfaları), Sponsored Brands reklamı ve marka koruma araçlarına erişiminiz olmaz. Türk markaları için Brand Registry başvurusu Türk Patent Enstitüsü tescil numarasıyla yapılır.

SP-API rate limit ve token economy. SP-API her uç nokta için kendi rate-limit token'ına sahiptir; örneğin Listings Items 5/s burst, 5/s sustained iken Reports yalnızca 0.0222/s'tir. Invozon bu token bütçelerini sizin için izler ve kuyrukları yönetir; doğrudan SP-API çağırsaydınız 429 QuotaExceeded hatalarını sürekli görürdünüz.

Marketplace ID. Amazon TR'nin marketplace ID'si A33AVAJ2PDY3EV. EU bölgesindeki diğer marketplaces (DE: A1PA6795UKMFR9, UK: A1F83G8C2ARO7P, FR: A13V1IB3VIYZZH) için ayrı yetki ve ayrı Invozon bağlantısı gerekir.

Sıkı içerik politikası. Amazon TR ürün başlığı, açıklama ve görselleri için Amazon'un global "Restricted Products" ve "Listing Quality" politikalarına tabi tutulur. Başlığa fiyat, kampanya, emoji yazılamaz; görsellerde watermark, ek metin, çoklu açı kolajı yasaktır. İhlal eden listing'ler 24 saat içinde "suppressed" duruma düşer.

Sınırlamalar

SP-API rate-limit'leri agresiftir; özellikle Reports ve Feeds uç noktalarında dakikada birkaç istek ile sınırlanırsınız.
Yeni satıcılar için ASIN yaratma izni ilk 90 gün sınırlıdır; başlangıçta sadece mevcut ASIN'lere offer ekleyebilirsiniz.
Brand Registry başvurusu Amazon tarafında 2-6 hafta sürer; bu süre boyunca A+ content yapılamaz.
FBA Amazon TR'de bütün kategorilerde aktif değil; gıda, sıvı kozmetik, tehlikeli madde gibi kategoriler kapalıdır.
Amazon TR sandbox vardır ama uç noktaların hepsi sandbox'ta erişilebilir değil; özellikle Pricing ve Buy Box endpoint'leri sadece production'da çalışır.
Müşteri telefon numarası ve gerçek e-postası verilmez; iletişim sadece Buyer-Seller Messaging üzerinden mümkündür.
LWA refresh token'ı 6 ay kullanılmadığında geçersiz olur; Invozon haftalık otomatik refresh ile bunu yönetir, ama uzun atıl hesaplarda yeniden yetkilendirme gerekebilir.
Buy Box kazanmak öngörülemez ve birden fazla faktöre bağlıdır; pure fiyat düşürmek her zaman çözüm değildir.

Sık Sorulan Sorular

LWA refresh token'ım expire oldu, ne yapmalıyım? Invozon Konsolu'ndaki Amazon TR bağlantısı "Reauthorize Required" durumuna geçer; orada Reconnect butonuna basıp Seller Central yetki ekranından tekrar onay vermeniz yeterlidir. SKU haritalamanız ve geçmiş veriniz korunur.

ASIN'im "suppressed" duruma düştü, neden? En sık nedenler: başlıkta yasaklı karakterler (emoji, fiyat bilgisi), ana görselin beyaz arka plan kuralına uymaması, ürün varyantlarında eksik öznitelik veya marka politikası ihlali. Amazon Seller Central'da Manage Inventory → Suppressed Listings sayfasında nedeni görebilirsiniz.

FBA için ürünlerimi Amazon deposuna nasıl yollarım? Invozon POST /v1/marketplaces/amazon-tr/fba/shipments uç noktası ile inbound shipment yaratabilir, palet/karton bilgilerini girip Amazon'un atadığı depoyu öğrenebilirsiniz. FBA inbound akışı kargolama, etiketleme ve kabul olmak üzere 3-7 iş günü sürer.

Buy Box'ı kaybediyorum, ne yapabilirim? Önce pricing/competition uç noktasıyla rakipleri inceleyin. Çoğu zaman sizden 0.5-1 TL daha düşük fiyat veren rakipler Buy Box'ı alır. Ama yalnız fiyat değil, handling time, satıcı puanı ve fulfillment kanalı (FBA üstün) belirleyicidir. Sürdürülebilir çözüm: yüksek satışı olan SKU'lar için FBA'ya geçmek.

Müşteriye nasıl ulaşabilirim? Amazon'un Buyer-Seller Messaging API'si üzerinden. Invozon POST /v1/marketplaces/amazon-tr/messaging/{order_id} ile maskelenmiş e-posta adresine mesaj iletebilirsiniz. Telefon ile iletişim yasaktır.

Sandbox kullanılabilir mi? Evet, SP-API sandbox modu vardır ama yalnızca belirli endpoint'lerin "static" yanıtlarını döner. Invozon environment: "sandbox" ayarı ile sandbox'a yönlendirir; gerçek dünya testleri için production'da küçük SKU'larla denemek daha güvenilirdir.

Amazon DE, UK, FR'de de satıyorum, tek bağlantı yeter mi? Hayır. Her marketplace bölgesi (EU, NA, FE) ayrı LWA yetkisi ister. Aynı satıcı hesabıyla EU içindeki tüm marketplace'leri tek yetki ile aktif edebilirsiniz, ama Invozon'da yine marketplace_id başına ayrı konfigürasyon yapmanız gerekir.

Resmî dokümantasyon: https://developer-docs.amazon.com/sp-api/