Ana SayfaBelgelerKod ÖrnekleriAPI BaşvurusuDuyurularModellerSürüm NotlarıSSSGitHubVideolar
Geliştirici MerkeziAPI DurumuDestek
Belgeler
Geliştirici MerkeziAPI DurumuDestek

Satış Ortağı API'sindeki Roller

Satış Ortağı API'sinde rolleri nasıl kullanacağınızı öğrenin.

Rol nedir?

Rol, bir geliştiricinin veya uygulamanın bir işleme ya da kaynağa erişimi olup olmadığını belirlemek için Satış Ortağı API'leri tarafından kullanılan mekanizmadır. Geliştirici olarak belirli bir rolü istemeniz ve bu role uygun olmanız gerekir. Aksi takdirde, ilgili rolün altında gruplandırılmış işlemlere ve kaynaklara erişemezsiniz. Roller, kimliği tanımlayabilecek bilgilere (PII) ve diğer hassas verilere erişimi korur. Ayrıca, geliştiricilerin yalnızca bir uygulama için gerekli verilere erişmesini sağlamak için veri erişimini sınırlandırır. Bu da müşterilerin Amazon'a ve Satış Ortağı API'lerini kullanan Satış Ortağı Hizmetleri işletmelerine güvenmelerini sağlar.

Rol tanımları

Aşağıdaki tabloda bulunan Kısıtlı ifadesi, rol için kimliği tanımlayabilecek bilgiler (PII) içerebilecek hassas bilgiler gerektiği anlamına gelir. Verileri kullanımınız ve güvenlik denetimleriniz hakkında ek bilgi sağlamanız istenir.

Rol Açıklama
Marka Analizleri Satıcı ve tedarikçilerin Amazon'daki performansına ilişkin bilgi içeren raporlara ve müşterilerin, Amazon'da bir satış ortağının ürünlerini nasıl bulup satın aldığına dair fikir veren tüketici davranışı raporlarına erişin. Bu rolün atanması gereken örnek işlemler:
  • createReport Raporlar için Satış Ortağı API'sinin işletilmesi, talep etmek için kullanıldığında GET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT rapor. Bu rapor, bir pazar yeri için arama anahtar kelimesine ve departmanına göre en çok tıklanan ASIN'lere ilişkin verileri döndürür.
  • createReport Raporlar için Satış Ortağı API'sinin işletilmesi, talep etmek için kullanıldığında GET_PROMOTION_PERFORMANCE_REPORT rapor. Bu rapor, satıcıların ve satıcıların promosyonlarını optimize etmelerine ve reklam stratejilerini ayarlamalarına yardımcı olmak için promosyon kampanyalarından veri döndürür.
Bu rolün gerekli olduğu işlemlerin yanı sıra akış, rapor ve bildirim türlerinin tam listesi için Marka Analizi bölümüne bakın.

Ürün Liste Kaydı Ürün liste kayıtları oluşturup yönetin. Genelde ürün kataloğu ile ilgili raporlar, akışlar ve işlemler için kullanılır. Bu rolün atanması gereken örnek işlemler:
  • getCatalogItem Belirtilen öğe ve nitelikleri hakkında bilgi döndüren Katalog Öğeleri için Satış Ortağı API'sinin çalışması.
  • createReport Raporlar için Satış Ortağı API'sinin işletilmesi, talep etmek için kullanıldığında GET_MERCHANT_LISTINGS_INACTIVE_DATA rapor. Bu rapor ayrıntılı etkin olmayan listeleri döndürür.
  • getMyFeesEstimateForSKU Belirtilen öğe için tahmini ücretleri döndüren Ürün Ücretleri için Satış Ortağı API'sinin işletilmesi.
Bu rolün gerekli olduğu işlemlerin yanı sıra akış, rapor ve bildirim türlerinin tam listesi için Ürün Liste Kaydı bölümüne bakın.

Fiyatlandırma Liste fiyatlarını belirleyin ve ürün fiyatlandırmasını otomatik hale getirin. Genelde fiyatlandırmayla ilgili raporlar, akışlar ve işlemler için kullanılır. Bu rolün atanması gereken örnek işlemler:
  • createFeed Bir göndermek için kullanıldığında Feed'ler için Satış Ortağı API'sinin işletilmesi RFQ_UPLOAD_FEED beslemek. Bu, kurumsal müşterilerden gelen taleplere yanıt olarak miktar indirimleri yüklemenizi sağlar.
  • getPricing Satıcının teklif listeleri için fiyatlandırma bilgilerini döndüren Fiyatlandırma Satış Ortağı API'sinin işletilmesi.
  • createReport Raporlar için Satış Ortağı API'sinin işletilmesi, talep etmek için kullanıldığında GET_MERCHANT_CANCELLED_LISTINGS_DATA rapor. Bu rapor iptal edilen listeleri döndürür.
Bu rolün gerekli olduğu işlemlerin yanı sıra akış, rapor ve bildirim türlerinin tam listesi için Fiyatlandırma bölümüne bakın.

Amazon Lojistik Amazon'a gönderdiğinizde Amazon da doğrudan müşterilere gönderim yapar (Amazon Lojistik (FBA), Amazon Lojistik Ağı (AFN)). Genelde FBA (Amazon Lojistik) Satış Raporları, Sipariş Takip Raporları ve sipariş gönderimi ilgili işlemler için kullanılır. Bu rolün atanması gereken örnek işlemler:
  • createReport Raporlar için Satış Ortağı API'sinin işletilmesi, talep etmek için kullanıldığında GET_FBA_ESTIMATED_FBA_FEES_TXT_DATA rapor. Bu rapor tahmini Amazon Satış ve Gönderim Ücretlerini içerir.
  • getSubscription Abone olmak için kullanıldığında Bildirimler için Satış Ortağı API'sinin çalışması FBA_OUTBOUND_SHIPMENT_STATUS bildirimler. Bu bildirimler, bir satıcı için bir FBA gönderisi oluşturduğumuzda veya iptal ettiğimizde gönderilir.
  • getLabels Paket/palet etiketlerini döndüren Gönderim Gelen Satış Ortağı API'sinin çalışması.
  • createFeed Bir göndermek için kullanıldığında Feed'ler için Satış Ortağı API'sinin işletilmesi POST_FBA_INBOUND_CARTON_CONTENTS beslemek. Bu, envanteri Amazon'un gönderim ağına gönderirken karton içeriği bilgilerini göndermenize olanak tanır.
Bu rolün gerekli olduğu işlemlerin yanı sıra akış, rapor ve bildirim türlerinin tam listesi için Amazon Lojistik bölümüne bakın.

Alıcı İletişimi Amazon alıcılarına giden ve alıcılardan gelen mesajları yönetin. Genelde Mesajlaşma için Satış Ortağı API'sini kullanarak Amazon alıcılarına mesaj göndermek için kullanılır. Bu rolün atanması gereken örnek işlemler:
  • getMessagingActionsForOrder Belirli bir sipariş için kullanılabilen ileti türlerinin bir listesini döndüren Mesajlaşma için Satış Ortağı API'sinin çalışması.
  • createConfirmOrderDetails Göndermeden önce alıcıya siparişle ilgili bir soru sormak için bir mesaj gönderen Mesajlaşma için Satış Ortağı API'sinin çalışması.
  • createConfirmDeliveryDetails Mesajlaşma için Satış Ortağı API'sinin çalışması, bir teslimatı ayarlamak veya teslimat yapmak için iletişim bilgilerini onaylamak için bir alıcıya mesaj gönderir.
Bu rolün gerekli olduğu işlemlerin yanı sıra akış, rapor ve bildirim türlerinin tam listesi için Alıcı İletişimi bölümüne bakın.

Alıcı İsteği Amazon alıcılarından geri bildirim isteyin. Genelde İstekler için Satış Ortağı API'sini kullanarak Amazon alıcılarından geri bildirim istemek için kullanılır. Bu rolün atanması gereken örnek işlemler:
  • getSolicitationActionsForOrder Bir sipariş için kullanılabilen talep türlerinin bir listesini döndüren Talep için Satış Ortağı API'sinin işletilmesi.
  • createProductReviewAndSellerFeedbackSolicitation bir alıcıya geri bildirim ve bir sipariş için ürün incelemesi isteyen bir talep gönderen işlem.
Bu rolün gerekli olduğu işlemlerin yanı sıra akış, rapor ve bildirim türlerinin tam listesi için Alıcı İsteği bölümüne bakın.

Satış Ortağı İçgörüleri Amazon Satış Ortağı hesabı ve performansı ile ilgili bilgileri görüntüleyin. Genelde satıcı içgörülerini döndürmek için kullanılan raporlar ve işlemlerde kullanılır. Bu rolün atanması gereken örnek işlemler:
  • createReport Raporlar için Satış Ortağı API'sinin işletilmesi, talep etmek için kullanıldığında GET_V1_SELLER_PERFORMANCE_REPORT rapor. Bu rapor, Satıcı Merkezi kontrol panelinden bireysel performans ölçümlerini içerir.
  • getMarketplaceParticipations Satıcıların satış yapabileceği pazar yerlerinin listesini ve satıcının bu pazarlara katılımıyla ilgili bilgileri döndüren Satıcılar için Satış Ortağı API'sinin işletilmesi.
Bu rolün gerekli olduğu işlemlerin yanı sıra akış, rapor ve bildirim türlerinin tam listesi için Satış Ortağı İçgörüleri bölümüne bakın.

Finans ve Muhasebe Muhasebe tabloları ve mali tablolar oluşturun. Genelde muhasebe tabloları ve mali tablolar oluşturmak için kullanılır. Bu rolün atanması gereken örnek işlemler:
  • getReports Raporlar için Satış Ortağı API'sinin çalışması, bir liste döndürmek için kullanıldığında GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE Raporlar oluşturuldu.
  • getSubscription Aboneliklerle ilgili bilgileri iade etmek için kullanıldığında Bildirimler için Satış Ortağı API'sinin çalışması FEE_PROMOTION bildirim türü.
Bu rolün gerekli olduğu işlemlerin yanı sıra akış, rapor ve bildirim türlerinin tam listesi için Finans ve Muhasebe bölümüne bakın.

Envanter ve Sipariş Takibi Envanteri analiz edip yönetin. Genelde FBA (Amazon Lojistik) Satış Raporları, Sipariş Takip Raporları ve siparişler, tedarikçi siparişleri, satış sipariş metrikleri ve envanter yönetimi ile ilgili işlemlerde kullanılır. Bu rolün gerekli olduğu işlemler, bir siparişi göndermek için gereken PII'yi kullanmaz. Bunun yerine bu rol, envanter/üretim/satın alma işlemlerini yönetmek için sipariş gönderimlerini takip eden uygulamalarda gereklidir. Bu rolün atanması gereken örnek işlemler:
  • createReport Raporlar için Satış Ortağı API'sinin işletilmesi, talep etmek için kullanıldığında GET_MERCHANT_LISTINGS_DATA rapor. Bu rapor ayrıntılı aktif listeleri döndürür.
  • createFeed Bir göndermek için kullanıldığında Feed'ler için Satış Ortağı API'sinin çalışması POST_FLAT_FILE_FULFILLMENT_DATA beslemek. Bu, sipariş gönderme bilgilerini Amazon'a göndermenizi sağlar.
  • getOrderMetrics Toplu sipariş metriklerini döndüren Satış Ortağı API'sinin çalışması.
Bu rolün gerekli olduğu işlemlerin yanı sıra akış, rapor ve bildirim türlerinin tam listesi için Envanter ve Sipariş Takibi bölümüne bakın.

Amazon Depolama ve Dağıtım Analyze and manage Amazon Warehousing and Distribution shipments and inventory. Generally used for interacting with AWD inventory information and shipment details using the Selling Partner API for Amazon Warehousing and Distribution. Examples of operations that require this role assignment:
  • listInventory AWD'deki ürünler için envanter düzeylerini ve durumlarını döndüren Amazon Depolama ve Dağıtım için Satış Ortağı API'sinin işletilmesi.
  • getInboundShipment mutabakat için durum ve alınan miktarlar gibi sevkiyatla ilgili ayrıntıları iade eden işlem.
Bakınız Amazon Depolama ve Dağıtım bu rolü gerektiren işlemlerin ve feed, rapor ve bildirim türlerinin tam listesi için.
Satıcı Merkezi'ndeki Bildirimler Send targeted notifications to sellers within Seller Central. Using the App Integrations API v2024-04-01, you can send notifications that inform the seller about their business or to encourage the seller to take action on your website. Examples of operations that require this role assignment:
  • createNotification Operasyon, satıcılara işleriyle ilgili bilgileri içeren bir bildirim oluşturur ve gönderir.
  • deleteNotifications işlem daha önce bir satıcıya gönderilen bir bildirimi siler.
Bu rolü gerektiren işlemlerin tam listesi için bkz. Satıcı Merkezi rolündeki bildirimler.
Ödeme Başlatma Hizmeti Sağlayıcısı Satıcının para yatırma yöntemine bir ödemenin başlatılmasına ve bir sipariş için geri ödeme (ayarlama) yapılmasına izin verir. Satıcının ödeme yöntemlerini görüntülemek için Ödeme Başlatma Hizmeti Sağlayıcısı (PISP) rolünü kullanabilirsiniz.
Bu rolü gerektiren işlemlerin ve feed, rapor ve bildirim türlerinin tam listesi için bkz. Ödeme Başlatma Hizmeti Sağlayıcısı.
Üçüncü taraf sağlayıcı geliştirici kaydı hakkında bilgi için bkz. Üçüncü Taraf Sağlayıcı Kaydı.
Hesap Bilgileri Servis Sağlayıcısı Satıcının işletmesi ve satıcı hesabının etkin olduğu pazar yerleri hakkında bilgiler de dahil olmak üzere Amazon Satış Ortağı hesabı hakkında bilgi sağlar. Satıcının ödeme yöntemlerini ve finansal olaylarını görüntülemek için Hesap Bilgileri Hizmet Sağlayıcısı (AISP) rolünü kullanabilirsiniz.
Bu rolü gerektiren işlemlerin ve feed, rapor ve bildirim türlerinin tam listesi için bkz. Hesap Bilgileri Servis Sağlayıcısı.
Üçüncü taraf sağlayıcı geliştirici kaydı hakkında bilgi için bkz. Üçüncü Taraf Sağlayıcı Kaydı.
Doğrudan Tüketiciye Gönderim (Kısıtlı) Amazon da dahil olmak üzere tercih ettikleri taşıyıcı firmayı kullanarak siparişleri doğrudan müşterilere gönderin. Bu rolün gerekli olduğu işlemler, kargo gönderebilmek için PII kullanır. Genelde Sipariş Raporları, Sipariş Takip Raporları, Kolay Gönderim ve Amazon'a verilen kargo siparişleriyle ilgili işlemlerde kullanılır. Bu rolün atanması gereken örnek işlemler:
  • getShipment Belirli bir gönderi için gönderi bilgilerini iade eden Satıcı Gönderimi için Satış Ortağı API'sinin işletilmesi.
  • getOrders Siparişler için Satış Ortağı API'sinin çalışması, belirtilen kriterlere göre siparişlerin ve sipariş bilgilerinin bir listesini döndürür.
  • createReport Raporlar için Satış Ortağı API'sinin işletilmesi, talep etmek için kullanıldığında GET_FLAT_FILE_ ORDER_REPORT_DATA_SHIPPING rapor.
  • createFeed Feed'ler için Satış Ortağı API'sinin işletilmesi, göndermek için kullanıldığında POST_ORDER_FULFILLMENT_DATA beslemek. Bu besleme, sisteminizin Amazon'un sistemini sipariş yerine getirme bilgileriyle güncellemesine olanak tanır.
Bu rolün gerekli olduğu işlemlerin yanı sıra akış, rapor ve bildirim türlerinin tam listesi için Doğrudan Tüketiciye Gönderim (Kısıtlı) bölümüne bakın.

Vergi Faturalandırması (Kısıtlı) Vergi düzenlemelerine uymak için vergi faturaları oluşturun. Bu rolün gerekli olduğu işlemlerde vergi faturası oluşturulabilmesi için PII gerekir. Genelde Vergi Raporları ve Sipariş Raporlarının yanı sıra siparişlerle ilgili bilgi döndüren işlemlerde kullanılır. Bu rolün atanması gereken örnek işlemler:
  • createReport Raporlar için Satış Ortağı API'sinin işletilmesi, talep etmek için kullanıldığında GET_AMAZON_FULFILLED_SHIPMENTS_INVOICING rapor. Bu rapor ayrıntılı sipariş/gönderim/ürün bilgilerini döndürür.
  • getOrderAddress Siparişlerin gönderim adresini döndüren Siparişler için Satış Ortağı API'sinin işletilmesi.
  • getOrderBuyerInfo Bir sipariş için alıcı bilgilerini döndüren Siparişler için Satış Ortağı API'sinin işletilmesi.
  • createReport Raporlar için Satış Ortağı API'sinin işletilmesi, talep etmek için kullanıldığında GET_EASYSHIP_DOCUMENTS rapor. Bu rapor, Easy Ship siparişinin faturasını, kargo etiketini ve garanti belgelerini içerir.
Bu rolün gerekli olduğu işlemlerin yanı sıra akış, rapor ve bildirim türlerinin tam listesi için Vergi Faturalandırması (Kısıtlı) bölümüne bakın.
Vergi Havalesi (Kısıtlı) Calculate and remit sales taxes. Operations that require this role might use PII to calculate sales taxes. Generally used for FBA Sales Reports and Order Reports and operations that return information about orders. Examples of operations that require this role assignment:
  • createReport Raporlar için Satış Ortağı API'sinin işletilmesi, talep etmek için kullanıldığında GET_AMAZON_FULFILLED_SHIPMENTS_REMITTANCE rapor. Bu rapor ayrıntılı sipariş/gönderim/ürün bilgilerini döndürür.
  • getOrderItems Bir sipariş için ayrıntılı sipariş öğesi bilgilerini döndüren Siparişler için Satış Ortağı API'sinin çalışması.
  • getOrders Siparişler için Satış Ortağı API'sinin çalışması, bir zaman dilimi ve bir dizi kriter için sipariş öğesi bilgilerinin bir listesini döndürür.
Bu rolün gerekli olduğu işlemlerin yanı sıra akış, rapor ve bildirim türlerinin tam listesi için Vergi Havalesi (Kısıtlı) bölümüne göz atın.
Profesyonel Hizmetler (Kısıtlanmış) Provides add-on services such as Room of Choice Delivery, Assembly and Installation to Amazon buyers. Generally used to provide add-on services to Amazon buyers using the Selling Partner API for Services. Examples of operations that require this role assignment:
  • getServiceJobs Belirtilen filtre sorgusu için hizmet işi ayrıntılarının bir listesini döndüren Hizmetler için Satış Ortağı API'sinin çalışması.
  • addAppointmentForServiceJobByServiceJobId belirtilen hizmet işi tanımlayıcısı tarafından belirtilen servis işine randevu ekleyen işlem.
Bakınız Profesyonel Hizmetler bu rolü gerektiren işlemlerin ve feed, rapor ve bildirim türlerinin tam listesi için.

Sık Sorulan Sorular

Bir rol için nasıl istekte bulunur ve bu role hak kazanırım?

Geliştirici Profilinizi doldurarak Satış Ortağı API rollerini talep eder ve bunlara hak kazanırsınız. Talep edilen özel bilgiler, daha önce kayıt olup olmadığınıza bağlıdır.

Profiliniz gönderildikten sonra Amazon, sağlanan bilgileri değerlendirip isteğinizi onaylar veya reddeder. İsteğiniz reddedilirse bunun nedenini ele alabilir ve ardından profilinizi yeniden gönderebilirsiniz.

Uygulamam için rolleri nasıl seçerim?

Uygulama istemcisi oluşturma sayfasında Satış Ortağı API'si uygulamanızı oluşturduğunuzda geliştirici profilinizde istenen ve onaylanan roller arasından seçim yapabilirsiniz. İhtiyacınız olan rol burada yoksa geliştirici profilinizdeki rolleri, bu rolü içerecek şekilde güncellemeniz ve sonrasında da profilinizi Amazon'un değerlendirmesi için yeniden göndermeniz gerekir. Eklenen rol onaylandıktan sonra uygulamanızda seçilebilir.

Not: Yayınlanmış bir hibrit SP-API uygulamanız varsa yeniden yetkilendirmeden önce uygulamanızı yeniden listelemeniz gerekir.

Hangi rollerin isteneceğini nasıl belirlerim?

Bu belgedeki rol açıklamalarını inceleyerek her rolün amacını anlayabilir ve bu rollerin yönettiği kaynaklar ile işlemlerin örneklerini görebilirsiniz. Her rol için sağlanan bağlantıyı kullanarak rolün gerekli olduğu işlemlerin yanı sıra akış, rapor ve bildirim türlerinin tam listesini sağlayan belgelere gidebilirsiniz.

Gerekli rollere sahip olmadığım bir işlemi çağırırsam ne olur?

İsteğe verilen yanıtta 403 HTTP durum kodu, yanıt gövdesinde de hata bilgileri yer alır.

Uygulamam yayınlandıktan sonra nasıl yeni rol eklerim?

Uygulamanız yayınlandıktan sonra yeni bir rol eklemek için aşağıdaki adımları uygulayın:

  1. Geliştirici profilinize gidin ve eklenecek rolü gönderin.
  2. Geliştirici profiliniz onaylandıktan sonra uygulama yapılandırmanıza giderek uygulamanıza yeni onaylanan rolü uygulayın. Değişiklikleri kaydedin ve uygulamayı yeniden listeleyin.
  3. Uygulama onaylandıktan sonra yeni yetkilendirmeler alarak yeni rolün sağlayacağı API işlemleri, raporlar, akışlar ve bildirimlere erişim sağlayacak yeni bir yenileme kodu oluşturun.

Bu sayfa size yardımcı oldu mu?