Ana SayfaBelgelerKod ÖrnekleriAPI BaşvurusuDuyurularModellerSürüm NotlarıSSSGitHubVideolar
Geliştirici MerkeziAPI DurumuDestek
Belgeler
Geliştirici MerkeziAPI DurumuDestek
Aramak için yazmaya başlayın…

Satış Ortağı API Rolleri

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

Roller, Satış Ortağı API'sinin (SP-API) bir geliştiricinin veya uygulamanın bir işleme veya kaynağa erişimi olup olmadığını belirleyen mekanizmadır. Roller, kişisel olarak tanımlanabilir bilgilere (PII) ve diğer hassas verilere erişimi korur ve geliştiricilerin yalnızca uygulamalarının gerektirdiği verilere erişmesini sağlar.

Geliştirici olarak, rolün sağladığı işlemlere ve kaynaklara erişim elde etmek için belirli bir rol talep etmeli ve bu rolü hak kazanmalısınız. Her SP-API işlemi ve türü için hangi role ihtiyacınız olduğunu belirlemek için aşağıdaki konuları kullanın:

Rol tanımları

Aşağıdaki bölümlerde, Kısıtlanmış Rolün kişisel olarak tanımlanabilir bilgileri (PII) içerebilecek hassas bilgiler gerektirdiği anlamına gelir. Bu roller için veri kullanımınız ve güvenlik denetimleriniz hakkında ek bilgi sağlamanız gerekir.

Hesap Bilgileri Servis Sağlayıcısı

Hesap Bilgileri Hizmet Sağlayıcısı (AISP) rolü, satıcının işletmesi ve satıcı hesabının etkin olduğu pazar yerleri hakkındaki bilgiler dahil olmak üzere Amazon Satış Ortağı hesabıyla ilgili bilgilere erişim sağlar. Satıcı için ödeme yöntemlerini ve finansal olayları görüntülemek için bu rolü kullanabilirsiniz.

Bu rolü gerektiren işlem örnekleri için seçin.
  • getAccount operasyonu Satıcılar API v1, bir satıcı hesabı ve pazar yerleri hakkında bilgi alır.
  • getPaymentMethods işleyişi Transfer API'si v2024-06-01, satıcı için ödeme yöntemlerinin bir listesini döndürür.

Amazon Lojistik

Amazon Gönderim rolü Amazon gönderim işlemlerine ve Amazon Tarafından Gönderim (FBA) ve Amazon Gönderim Ağı (AFN) gibi gönderim hizmetlerine erişim sağlar. Bu rolü genellikle FBA satış raporları, sipariş izleme raporları ve sipariş yerine getirmeyle ilgili işlemler için kullanırsınız.

Bu rolü gerektiren işlem örnekleri için seçin.
  • createReport işleyişi Raporlar API v2021-06-30, talep ettiğiniz zaman FBA Ücret Önizlemesi rapor. Bu rapor, aktif tekliflerle satıcının FBA envanteri için tahmini Amazon satış ve gönderim ücretlerini içerir.
  • getSubscription işleyişi Bildirimler API v1, abone olduğunuzda FBA_OUTBOUND_SHIPMENT_STATUS bildirimler. Bu bildirimler, Amazon'un bir satıcı için Amazon Tarafından Gönderim gönderisi oluşturduğu veya iptal ettiğini gösterir.
  • listShipmentItems işleyişi Gönderim Gelen API v2024-03-20, bir gönderideki paketlerin bir listesini döndüren.
  • createFeed işleyişi API Beslemeleri v2021-06-30, gönderdiğinizde POST_FBA_INBOUND_CARTON_CONTENTS beslemek. Bu feed, envanteri Amazon'un gönderim ağına gönderirken karton içeriği bilgilerini göndermenize olanak tanır.

Amazon Depolama ve Dağıtım

Amazon Depolama ve Dağıtım (AWD) rolü, AWD sevkiyat ve envanter işlemlerine erişim sağlar. Genellikle bu rolü kullanırken kullanırsınız. Amazon Depolama ve Dağıtım API'si AWD envanter bilgileri ve sevkiyat detayları ile etkileşim kurmak için.

Bu rolü gerektiren işlem örnekleri için seçin.

Marka Analizleri

Marka Analizi rolü, müşterilerin Amazon'da ürünleri nasıl keşfettiğini ve satın aldığını gösteren satıcı ve satıcı performans ölçümleri ve tüketici davranışı içgörüleri gibi pazar analizi raporlarına erişim sağlar.

Bu rolü gerektiren işlem örnekleri için seçin.
  • createReport işleyişi Raporlar API v2021-06-30, talep ettiğiniz zaman 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'lerle ilgili verileri döndürür.
  • createReport işleyişi Rapor API'si v2021-06-30, talep ettiğiniz zaman 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.

Alıcı İletişimi

Alıcı İletişimi rolü, Amazon alıcılarına gelen ve alıcılardan gelen mesajları yöneten işlemlere erişim sağlar. Genellikle bu rolü kullanırken kullanırsınız. Mesajlaşma API'si Amazon alıcılarına mesaj göndermek için.

Bu rolü gerektiren işlem örnekleri için seçin.
  • getMessagingActionsForOrder operasyonu Mesajlaşma API'si v1, belirtilen bir sipariş için kullanılabilen ileti türlerinin bir listesini döndürür.
  • createConfirmOrderDetails işleyişi Mesajlaşma API'si v1, göndermeden önce bir alıcıya siparişle ilgili bir soru sormak için bir mesaj gönderir.
  • createConfirmDeliveryDetails işleyişi Mesajlaşma API'si v1, bir teslimat düzenlemek veya teslimat yapmak için iletişim bilgilerini onaylamak için bir alıcıya mesaj gönderir.

Alıcı İsteği

Alıcı Talep Etme rolü, alıcı geri bildirim talep işlemlerine erişim sağlar. Genellikle bu rolü kullanırken kullanırsınız Talep API'si Amazon alıcılarından geri bildirim istemek.

Bu rolü gerektiren işlem örnekleri için seçin.
  • getSolicitationActionsForOrder operasyonu Talep API'si v1, bir sipariş için kullanılabilen talep türlerinin bir listesini döndürür.
  • createProductReviewAndSellerFeedbackSolicitation operasyonu Talep API'si v1, bir alıcıya geri bildirim ve bir sipariş için ürün incelemesi isteyen bir talep gönderir.

Doğrudan Tüketiciye Nakliye (Kısıtlanmış)

Doğrudan Tüketiciye Nakliye (Kısıtlı) rolü, Amazon da dahil olmak üzere tercih ettikleri taşıyıcıları kullanarak müşterilere siparişleri doğrudan gönderen işlemlere erişim sağlar. Bu rolü gerektiren işlemler, gönderimi etkinleştirmek için PII kullanır. Bu rolü genellikle sipariş raporları, sipariş izleme raporları, EasyShip istemek ve Amazon'da verilen kargo siparişleriyle ilgili işlemler için kullanırsınız.

Bu rolü gerektiren işlem örnekleri için seçin.
  • getOrders işleyişi Siparişler API v0, belirttiğiniz ölçütlere göre siparişlerin ve sipariş bilgilerinin bir listesini döndürür.
  • createReport operasyonu Raporlar API v2021-06-30, talep ettiğiniz zaman GET_FLAT_FILE_ ORDER_REPORT_DATA_SHIPPING rapor.
  • createFeed işleyişi API Beslemeleri v2021-06-30, gönderdiğinizde POST_ORDER_FULFILLMENT_DATA beslemek. Bu besleme, sisteminizin Amazon'un sistemini sipariş yerine getirme bilgileriyle güncellemesine olanak tanır.

Finans ve Muhasebe

Finans ve Muhasebe rolü, muhasebe ve finansal tablolar oluşturan işlemlere erişim sağlar.

Bu rolü gerektiren işlem örnekleri için seçin.

Envanter ve Sipariş Takibi

Envanter ve Sipariş Takibi rolü, envanteri analiz eden ve yöneten işlemlere erişim sağlar. Bu rolü genellikle FBA satış raporlarını, sipariş izleme raporlarını ve siparişler, satıcı siparişleri, satış emri metrikleri ve envanter yönetimi ile ilgili işlemleri almak için kullanırsınız. Bu rolü gerektiren işlemler, bir siparişi göndermek için gerekli olan PII'yi kullanmaz. Aksine, bu rol uygulamalar içindir iz gönderiler.

Bu rolü gerektiren işlem örnekleri için seçin.
  • getOrderMetrics işleyişi Satış API'si v1, toplu sipariş metriklerini döndüren.
  • createReport operasyonu Raporlar API v2021-06-30, talep ettiğiniz zaman GET_MERCHANT_LISTINGS_DATA rapor. Bu rapor ayrıntılı aktif listeleri döndürür.
  • createFeed işleyişi API Beslemeleri v2021-06-30, gönderdiğinizde POST_FLAT_FILE_FULFILLMENT_DATA beslemek. Bu feed, sipariş gönderme bilgilerini Amazon'a göndermenizi sağlar.

Satıcı Merkezi'ndeki Bildirimler

Satıcı Merkezi'ndeki Bildirimler rolü, Satıcı Merkezi içindeki satıcılara hedeflenen bildirimler gönderen işlemlere erişim sağlar. Örneğin, kullanabilirsiniz Uygulama Entegrasyonları API'si satıcıyı işletmeleri hakkında bilgilendiren bildirimler göndermek veya satıcıyı web sitenizde harekete geçmeye teşvik etmek.

Bu rolü gerektiren işlem örnekleri için seçin.

Ödeme Başlatma Hizmeti Sağlayıcısı

Ödeme Başlatma Hizmeti Sağlayıcısı (PISP) rolü, satıcının para yatırma yöntemine yapılan ödemeyi başlatan işlemlere erişim ve bir sipariş için geri ödeme (ayarlama) yapılmasını sağlar.

Bu rolü gerektiren işlem örnekleri için seçin.

Fiyatlandırma

Fiyatlandırma rolü, liste fiyatlarını belirleyen ve ürün fiyatlandırmasını otomatikleştiren işlemlere erişim sağlar. Bu rolü genellikle fiyatlandırmayla ilgili raporlar, feed'ler ve işlemler için kullanırsınız.

Bu rolü gerektiren işlem örnekleri için seçin.
  • getPricing operasyonu Ürün Fiyatlandırma API v2022-05-01, satıcının teklif listeleri için fiyatlandırma bilgilerini döndüren.
  • createFeed operasyonu API Beslemeleri v2021-06-30, gönderdiğinizde RFQ_UPLOAD_FEED beslemek. Bu feed, kurumsal müşterilerden gelen taleplere yanıt olarak miktar indirimleri yüklemenizi sağlar.
  • createReport operasyonu Raporlar API v2021-06-30, talep ettiğiniz zaman GET_MERCHANT_CANCELLED_LISTINGS_DATA rapor. Bu rapor iptal edilen listeleri döndürür.

Ürün Liste Kaydı

Ürün Listesi rolü, ürün listelerini oluşturan ve yöneten işlemlere erişim sağlar. Bu rolü genellikle ürün kataloğuyla ilgili raporlar, feed'ler ve işlemler için kullanırsınız.

Bu rolü gerektiren işlem örnekleri için seçin.
  • getCatalogItem işleyişi Katalog Öğeleri API v2022-04-01, belirtilen öğe ve nitelikleri hakkında bilgi döndürür.
  • createReport operasyonu Raporlar API v2021-06-30, talep ettiğiniz zaman GET_MERCHANT_LISTINGS_INACTIVE_DATA rapor. Bu rapor ayrıntılı etkin olmayan listeleri döndürür.
  • getMyFeesEstimateForSKU işleyişi Ürün Ücretleri API v0, belirtilen öğe için tahmini ücretleri iade eder.

Profesyonel Hizmetler (Kısıtlanmış)

Profesyonel Hizmetler (Kısıtlı) rolü, Amazon alıcılarına montaj ve kurulum gibi eklenti hizmetleri sağlayan işlemlere erişim sağlar. Genellikle bu rolü kullanırken kullanırsınız. Hizmetler API v1.

Bu rolü gerektiren işlem örnekleri için seçin.
  • getServiceJobs işleyişi Hizmetler API v1, belirtilen filtre sorgusu için hizmet işi ayrıntılarının bir listesini döndürür.
  • addAppointmentForServiceJobByServiceJobId işleyişi Hizmetler API v1, belirtilen hizmet işi tanımlayıcısı tarafından belirtilen hizmet işine bir randevu ekler.

Satış Ortağı İçgörüleri

Satış Ortağı İçgörüleri rolü, satış ortağının hesabı ve performansı hakkında bilgi alan işlemlere erişim sağlar.

Bu rolü gerektiren işlem örnekleri için seçin.
  • getMarketplaceParticipations operasyonu Satıcılar API v1, bir satıcının satış yapabileceği pazar yerlerinin bir listesini ve satıcının bu pazarlara katılımıyla ilgili bilgileri döndürür.
  • createReport işleyişi Raporlar API v2021-06-30, talep ettiğiniz zaman GET_V1_SELLER_PERFORMANCE_REPORT rapor. Bu rapor, Satıcı Merkezi kontrol panelinden bireysel performans ölçümlerini içerir.

Vergi Faturalandırması (Kısıtlanmış)

Vergi Faturalandırması (Kısıtlanmış) rolü, vergi düzenlemelerine uymak için vergi faturaları oluşturan işlemlere erişim sağlar. Bu rolü gerektiren işlemler, vergi faturası oluşturmayı etkinleştirmek için PII gerektirir. Bu rolü genellikle vergi raporları, sipariş raporları ve siparişlerle ilgili bilgileri döndüren işlemler için kullanırsınız.

Bu rolü gerektiren işlem örnekleri için seçin.
  • getOrderBuyerInfo işleyişi Siparişler API v0, bir sipariş için alıcı bilgilerini iade eder.
  • createReport operasyonu Raporlar API v2021-06-30, talep ettiğiniz zaman GET_FLAT_FILE_VAT_INVOICE_DATA_REPORT rapor.
  • createReport operasyonu Raporlar API v2021-06-30, talep ettiğiniz zaman GET_EASYSHIP_DOCUMENTS rapor. Bu rapor, Easy Ship siparişinin faturasını, kargo etiketini ve garanti belgelerini içerir.

Vergi Havalesi (Kısıtlanmış)

Vergi Havalesi (Kısıtlanmış) rolü, satış vergilerini hesaplayan ve gönderen işlemlere erişim sağlar. Bu rolü gerektiren işlemler, satış vergilerini hesaplamak için PII kullanabilir. Bu rolü genellikle FBA satış raporları, sipariş raporları ve siparişlerle ilgili bilgileri döndüren işlemler için kullanırsınız.

Bu rolü gerektiren işlem örnekleri için seçin.
  • getOrderItems işleyişi Siparişler API v0, bir sipariş için ayrıntılı ürün bilgilerini döndüren.
  • getOrderAddress işleyişi Siparişler API v0, bir siparişin gönderim adresini iade eder.
  • createReport operasyonu Raporlar API v2021-06-30, talep ettiğiniz zaman GET_ORDER_REPORT_DATA_TAX rapor.

Updated 7 days ago

Bu sayfa size yardımcı oldu mu?