Roles in the Selling Partner API

AmazonSPAPI

# 销售伙伴API中的角色

# 什么是角色?

角色是Selling Partner APIs用来确定开发者或应用程序是否可以访问某个操作或资源的机制。作为一个开发者,你必须申请一个特定的角色并获得资格,否则你将无法访问该角色下的操作和资源组。角色保护对个人身份信息(PII)和其他敏感数据的访问,并限制数据访问,以确保开发人员只访问应用程序所需的数据。这有助于确保客户信任亚马逊,信任采用销售伙伴API的销售伙伴服务企业。

# 角色定义

在下表中,Restricted表示该角色需要敏感信息,可能包括个人身份信息(PII)。您将被要求提供有关您对数据的使用和安全控制的额外信息。

# 常见的问题

# 我如何申请和获得角色资格?

您可以通过填写您的开发人员档案来申请和获得销售伙伴API角色的资格。所要求的具体信息取决于您是否是已存在的亚马逊市场网络服务(MWS)开发人员,以及您之前是否已注册。

一旦您的资料被提交,亚马逊将评估所提供的信息,并批准或拒绝您的请求。如果被拒绝,你可以解决拒绝的原因,然后重新提交你的资料。

# 我如何为我的申请选择角色?

当你在应用程序客户端创建页面上创建你的销售伙伴API应用程序时,你可以从那些在你的开发者资料中被请求和批准的角色中选择。如果你需要的角色没有了,你必须更新你的开发者简介中的角色以包括它,然后重新提交你的简介供亚马逊评估。一旦获得批准,添加的角色将可以为你的应用程序选择。

**注意:**如果你有一个已发布的混合SP-API应用程序,你必须在重新授权之前重新列出你的应用程序。

# 我如何确定要申请哪些角色?

查看本文件中的角色描述以了解每个角色的目的,并查看每个角色所管辖的资源和操作的例子。对于每个角色,使用所提供的链接导航到文档,该文档提供了一个完整的操作列表和需要该角色的feed、报告和通知类型。

# 当我调用一个我没有所需角色的操作时会发生什么?

对请求的响应将有一个HTTP状态代码403和响应体中的错误信息。

角色 描述
Brand Analytics 访问包含卖家和供应商在亚马逊上表现的信息的报告,以及洞察客户如何在亚马逊上找到和购买销售伙伴产品的消费者行为报告。 需要此角色分配的操作实例。
  • Selling Partner API for Reports的createReport操作,当用于请求GET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT报告。该报告按搜索关键词和部门返回市场上点击率最高的ASINs数据。
  • Selling Partner API for Reports的createReport操作,当用于请求GET_PROMOTION_PERFORMANCE_REPORT报告。该报告返回促销活动的数据,以帮助供应商和卖家优化其促销活动并调整其广告策略。
  • 请参阅Brand Analytics,以获得需要此角色的操作和馈送、报告和通知类型的完整列表。

    Product Listing 创建和管理产品列表。 一般用于产品目录相关的报告和反馈,以及操作。 需要此角色分配的操作实例。
      销售伙伴API的目录项目的getCatalogItem操作,该操作返回有关指示的项目及其属性的信息。
    • 用于报告的销售伙伴API的创建报告操作,当用于请求GET_MERCHANT_LISTINGS_INACTIVE_DATA报告。该报告返回详细的非活动列表。
    • 用于产品费用的销售伙伴API的getMyFeesEstimateForSKU操作,该操作返回指定项目的估计费用。
    请参阅产品列表,以获取需要此角色的操作和馈送、报告和通知类型的完整列表。

    Pricing 确定清单价格并自动进行产品定价。 一般用于定价相关的报告、反馈和操作。 需要此角色分配的操作实例。

    • 当用于提交RFQ_UPLOAD_FEED feeds时,销售伙伴API的createFeed操作。这使您可以根据企业客户的要求上传数量折扣。
    • 销售伙伴定价API的getPricing操作,可返回卖方报价列表的定价信息。
    • 销售伙伴报告API的createReport操作,当用于请求GET_MERCHANT_CANCELLED_LISTINGS_DATA报告。该报告返回已取消的列表。
    请参阅定价,以获得需要此角色的操作和馈送、报告和通知类型的完整列表。

    Amazon Fulfillment 发货到亚马逊,亚马逊直接发货给客户(亚马逊履行(FBA),亚马逊履行网络(AFN))。 一般用于FBA销售报告,订单跟踪报告,以及与订单履行有关的操作。 需要这个角色分配的操作的例子。
  • Selling Partner API for Reports的createReport操作,当用于请求GET_FBA_ESTIMATED_FBA_FEES_TXT_DATA报告。该报告包含估计的亚马逊销售和履行费用。
  • 当用于订阅FBA_OUTBOUND_SHIPMENT_STATUS通知时,Selling Partner API for Notifications的getSubscription操作。每当我们为卖家创建或取消FBA货物时,就会发送这些通知。
  • Fulfillment Inbound的Selling Partner API的getLabels操作,返回包装/货盘标签。
  • 销售伙伴API的createFeed操作,用于提交POST_FBA_INBOUND_CARTON_CONTENTS饲料。这让您在向亚马逊的履约网络运送库存时提交纸箱内容信息。 请参阅Amazon Fulfillment,以获得需要此角色的操作和馈送、报告和通知类型的完整列表。

  • Buyer Communication Manage messaging to and from Amazon buyers. Generally used for messaging to Amazon buyers using the Selling Partner API for Messaging. Examples of operations that require this role assignment:
    • The getMessagingActionsForOrder operation of the Selling Partner API for Messaging, which returns a list of message types available for a specified order.
    • The createConfirmOrderDetails operation of the Selling Partner API for Messaging, which sends a message to ask a buyer an order-related question prior to shipping.
    • The createConfirmDeliveryDetails operation of the Selling Partner API for Messaging, which sends a message to a buyer to arrange a deliver or confirm contact information for making a delivery.
    See Buyer Communication for a complete list of the operations and the feed, report, and notification types that require this role.

    Buyer Solicitation 征求亚马逊买家的反馈意见。 一般用于使用Selling Partner API for Solicitations征求亚马逊买家的反馈意见。 需要此角色分配的操作实例。

    • Selling Partner API for Solicitations的getSolicitationActionsForOrder操作,该操作返回一个订单可用的招标类型的列表。
    • 创建ProductReviewAndSellerFeedbackSolicitation操作,该操作向买方发送征求意见,要求为订单提供反馈和产品评论。
    请参阅买方邀约,以获取需要此角色的操作和反馈、报告和通知类型的完整列表。

    Selling Partner Insights 查看关于亚马逊销售伙伴账户和业绩的信息。 一般用于用于返回卖家洞察力的报告和操作。 需要此角色分配的操作的例子。
      Selling Partner API for Reports的createReport操作,当用于请求GET_V1_SELLER_PERFORMANCE_REPORT报告。该报告包含来自卖方中心仪表板的个别性能指标。
    • 卖家销售伙伴API的getMarketplaceParticipations操作,它返回卖家可以销售的市场列表,以及关于卖家参与这些市场的信息。
    请参阅销售伙伴洞察力,以获得需要此角色的操作和馈送、报告和通知类型的完整列表。

    Finance and Accounting 制作会计和财务报表。 一般用于创建会计和财务报表。 需要此角色分配的业务实例。

    • 报告的销售伙伴API的getReports操作,当用于返回创建的GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE报告的列表。
    • 用于通知的销售伙伴 API 的 getSubscription 操作,当用于返回有关订阅 FEE_PROMOTION 通知类型的信息时。
    请参阅财务和会计,以获取需要此角色的操作以及馈送、报告和通知类型的完整列表。

    Inventory and Order Tracking 分析和管理库存。 一般用于FBA销售报告、订单跟踪报告,以及与订单、供应商订单、销售订单指标和库存管理有关的操作。需要这个角色的操作并不使用运送订单所需的PII。相反,跟踪订单发货以管理库存/制造/采购的应用程序需要这个角色。 需要这个角色分配的操作的例子。
      Selling Partner API for Reports的createReport操作,当用于请求GET_MERCHANT_LISTINGS_DATA报告。该报告会返回详细的活动房源。
    • Selling Partner API for Feeds的createFeed操作,当用于提交POST_FLAT_FILE_FULFILLMENT_DATA feed。这可以让您向亚马逊提交订单履行信息。
    • 销售合作伙伴API的getOrderMetrics操作,它可以返回汇总的订单指标。
    请参阅库存和订单跟踪,以获得需要此角色的操作和馈送、报告和通知类型的完整列表。

    Direct-to-Consumer Shipping (Restricted) 使用客户选择的承运人,包括亚马逊,将订单直接运送给客户。需要这个角色的操作使用PII来实现运输。 一般用于订单报告、订单跟踪报告、EasyShip,以及与运送在亚马逊上的订单有关的操作。 需要此角色分配的操作实例。

    • 商家履约的销售伙伴API的getShipment操作,该操作返回指定货件的货件信息。
    • 用于订单的销售伙伴API的getOrders操作,它根据指定的标准返回订单列表和订单信息。
    • 用于报告的销售伙伴API的创建报告操作,当用于请求GET_FLAT_FILE_ ORDER_REPORT_DATA_SHIPPING报告。
    • Selling Partner API for Feeds的createFeed操作,当用于提交POST_ORDER_FULFILLMENT_DATA馈送。该馈送允许您的系统用订单履行信息更新亚马逊的系统。
    请参阅Direct-to-Consumer Shipping (Restricted),以获得需要此角色的操作和feed、报告和通知类型的完整列表。

    Tax Invoicing (Restricted) 生成税务发票以遵守税务法规。需要这个角色的操作需要PII来实现税务发票的生成。 一般用于税务报告和订单报告,以及返回订单信息的操作。 需要此角色分配的操作的例子。

    • 报告的销售伙伴API的createReport操作,当用于请求GET_AMAZON_FULFILLED_SHIPMENTS_INVOICING报告。该报告返回详细的订单/货物/项目信息。
    • 订单销售伙伴API的getOrderAddress操作,返回订单的发货地址。
    • 订单销售伙伴API的getOrderBuyerInfo操作,返回订单的买方信息。
    • 用于报告的销售伙伴API的createReport操作,当用于请求GET_EASYSHIP_DOCUMENTS报告。该报告包含Easy Ship订单的发票、运输标签和保修文件。
    请参阅税务发票(受限),以获得需要此角色的操作和馈送、报告和通知类型的完整列表。
    Tax Remittance (Restricted) 计算和汇出销售税。需要这个角色的操作可以使用PII来计算销售税。 一般用于FBA销售报告和订单报告以及返回订单信息的操作。 需要此角色分配的操作的例子。

    • 报告的销售伙伴API的createReport操作,当用于请求GET_AMAZON_FULFILLED_SHIPMENTS_REMITTANCE报告。该报告返回详细的订单/货物/项目信息。
    • 销售伙伴订单API的getOrderItems操作,返回订单的详细订单项目信息。
    • 用于订单的销售伙伴API的getOrders操作,它返回一个时间框架和标准范围的订单项目信息列表。
    请参阅税务汇款(受限),以获得需要此角色的操作和馈送、报告和通知类型的完整列表。