Rôles dans l'API partenaire de vente

Découvrez comment utiliser les rôles dans l'API Selling Partner.

Qu'est-ce qu'un rôle ?

Un rôle est le mécanisme utilisé par les API partenaire de vente pour déterminer si un développeur ou une application a accès à une opération ou à une ressource. En tant que développeur, vous devez demander un rôle particulier et vous y qualifier, sinon vous ne pourrez pas accéder aux opérations et aux ressources regroupées sous ce rôle. Les rôles protègent l'accès aux informations personnelles identifiables (IPI) et à d'autres données sensibles, et limitent l'accès aux données pour garantir que les développeurs n'accèdent qu'aux données requises pour une application. Cela permet aux clients de faire confiance à Amazon et aux entreprises de services des partenaires de vente qui utilisent les API partenaire de vente.

Définitions des rôles

Dans le tableau suivant, Restreint signifie que le rôle nécessite des informations sensibles qui peuvent inclure des informations personnelles identifiables (IPI). Il vous sera demandé de fournir des informations supplémentaires concernant votre utilisation des données et vos contrôles de sécurité.

Rôle Description
Analyse de marque Accédez à des rapports contenant des informations sur les performances des vendeurs et des fournisseurs sur Amazon et à des rapports sur le comportement des consommateurs qui fournissent des informations sur la manière dont les clients trouvent et achètent les produits d'un partenaire de vente sur Amazon. Exemples d'opérations nécessitant l'attribution de ce rôle :
  • Le createReport fonctionnement de l'API Selling Partner pour les rapports, lorsqu'elle est utilisée pour demander le GET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT rapport. Ce rapport fournit des données sur les ASIN les plus cliqués par mot clé de recherche et par département pour une place de marché.
  • Le createReport fonctionnement de l'API Selling Partner pour les rapports, lorsqu'elle est utilisée pour demander GET_PROMOTION_PERFORMANCE_REPORT rapport. Ce rapport renvoie les données des campagnes de promotion afin d'aider les vendeurs à optimiser leurs promotions et à ajuster leurs stratégies publicitaires.
Consultez la section Analyse de marque pour obtenir une liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle.

Offre de produit Créez et gérez des offres de produits. Généralement utilisé pour les rapports, les flux et les opérations liés au catalogue de produits. Exemples d'opérations nécessitant l'attribution de ce rôle :
  • Le getCatalogItem fonctionnement de l'API Selling Partner pour les articles du catalogue, qui renvoie des informations sur l'article indiqué et ses attributs.
  • Le createReport fonctionnement de l'API Selling Partner pour les rapports, lorsqu'elle est utilisée pour demander GET_MERCHANT_LISTINGS_INACTIVE_DATA rapport. Ce rapport affiche des listes inactives détaillées.
  • Le getMyFeesEstimateForSKU fonctionnement de l'API Selling Partner pour les frais de produit, qui renvoie les frais estimés pour l'article indiqué.
Consultez la section Offre de produit pour obtenir une liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle.

Tarification Déterminez les prix catalogue et automatisez la tarification des produits. Généralement utilisé pour les rapports, les flux et les opérations liés à la tarification. Exemples d'opérations nécessitant l'attribution de ce rôle :
  • Le createFeed fonctionnement de l'API Selling Partner pour les flux lorsqu'elle est utilisée pour soumettre un RFQ_UPLOAD_FEED nourrir. Cela vous permet de télécharger des remises sur quantité en réponse aux demandes des clients professionnels.
  • Le getPricing fonctionnement de l'API Selling Partner pour la tarification, qui renvoie les informations de tarification pour les offres proposées par un vendeur.
  • Le createReport fonctionnement de l'API Selling Partner pour les rapports, lorsqu'elle est utilisée pour demander GET_MERCHANT_CANCELLED_LISTINGS_DATA rapport. Ce rapport renvoie les annonces annulées.
Consultez la section Tarification pour obtenir une liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle.

Distribution Amazon Expédiez à Amazon, puis Amazon expédie directement aux clients (Expédié par Amazon, Réseau Logistique Amazon (AFN)). Généralement utilisé pour les rapports de vente Expédié par Amazon, les rapports de suivi des commandes et les opérations liées à l'expédition des commandes. Exemples d'opérations nécessitant l'attribution de ce rôle :
  • Le createReport fonctionnement de l'API Selling Partner pour les rapports, lorsqu'elle est utilisée pour demander GET_FBA_ESTIMATED_FBA_FEES_TXT_DATA rapport. Ce rapport contient une estimation des frais de vente et d'expédition d'Amazon.
  • Le getSubscription fonctionnement de l'API Selling Partner pour les notifications lorsqu'elle est utilisée pour s'abonner à FBA_OUTBOUND_SHIPMENT_STATUS notifications. Ces notifications sont envoyées chaque fois que nous créons ou annulons une expédition FBA pour un vendeur.
  • Le getLabels fonctionnement de l'API Selling Partner pour Fulfillment Inbound, qui renvoie les étiquettes des colis/palettes.
  • Le createFeed fonctionnement de l'API Selling Partner pour les flux lorsqu'elle est utilisée pour soumettre un POST_FBA_INBOUND_CARTON_CONTENTS nourrir. Cela vous permet de fournir des informations sur le contenu du carton lorsque vous expédiez du stock au réseau de distribution d'Amazon.
Consultez la section Distribution Amazon pour obtenir une liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle.

Communication avec les acheteurs Gérez la messagerie à destination et en provenance des acheteurs Amazon. Généralement utilisé pour envoyer des messages aux acheteurs Amazon à l'aide de l'API partenaire de vente pour la messagerie. Exemples d'opérations nécessitant l'attribution de ce rôle :
  • Le getMessagingActionsForOrder fonctionnement de l'API Selling Partner pour la messagerie, qui renvoie une liste des types de messages disponibles pour une commande spécifiée.
  • Le createConfirmOrderDetails fonctionnement de l'API Selling Partner pour la messagerie, qui envoie un message pour poser à un acheteur une question relative à la commande avant l'expédition.
  • Le createConfirmDeliveryDetails fonctionnement de l'API Selling Partner pour la messagerie, qui envoie un message à un acheteur pour organiser une livraison ou confirmer ses coordonnées pour effectuer une livraison.
Consultez la section Communication avec les acheteurs pour obtenir une liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle.

Sollicitation des acheteurs Sollicitez les commentaires des acheteurs Amazon. Généralement utilisé pour solliciter des commentaires des acheteurs Amazon à l'aide de l'API partenaire de vente pour les sollicitations. Exemples d'opérations nécessitant l'attribution de ce rôle :
  • Le getSolicitationActionsForOrder fonctionnement de l'API Selling Partner pour les sollicitations, qui renvoie une liste des types de sollicitations disponibles pour une commande.
  • Le createProductReviewAndSellerFeedbackSolicitation opération, qui envoie une sollicitation à un acheteur pour lui demander des commentaires et une évaluation du produit pour une commande.
Consultez la section Sollicitation des acheteurs pour obtenir une liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle.

Perspectives pour les partenaires de vente Consultez les informations relatives au compte et aux performances d'un partenaire de vente Amazon. Généralement utilisé pour les rapports et les opérations visant à fournir des perspectives aux vendeurs. Exemples d'opérations nécessitant l'attribution de ce rôle :
  • Le createReport fonctionnement de l'API Selling Partner pour les rapports, lorsqu'elle est utilisée pour demander GET_V1_SELLER_PERFORMANCE_REPORT rapport. Ce rapport contient des mesures de performance individuelles issues du tableau de bord de Seller Central.
  • Le getMarketplaceParticipations fonctionnement de l'API Selling Partner pour les vendeurs, qui renvoie une liste des sites de vente sur lesquels un vendeur peut vendre, ainsi que des informations sur la participation du vendeur à ces sites de vente.
Consultez la section Perspectives pour les partenaires de vente pour obtenir une liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle.

Finances et comptabilité Générez des états comptables et financiers. Généralement utilisé pour créer des états comptables et financiers. Exemples d'opérations nécessitant l'attribution de ce rôle :
  • Le getReports fonctionnement de l'API Selling Partner pour les rapports, lorsqu'elle est utilisée pour renvoyer une liste des GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE rapports créés.
  • Le getSubscription fonctionnement de l'API Selling Partner pour les notifications, lorsqu'elle est utilisée pour renvoyer des informations sur les abonnements au FEE_PROMOTION type de notification.
Consultez la section Finances et comptabilité pour obtenir une liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle.

Suivi des stocks et des commandes Analysez et gérez les stocks. Généralement utilisé pour les rapports de vente Expédié par Amazon, les rapports de suivi des commandes et les opérations liées aux commandes, aux commandes aux fournisseurs, aux mesures des commandes client et à la gestion des stocks. Les opérations qui nécessitent ce rôle n'utilisent pas les informations d'identification personnelle requises pour expédier une commande. Ce rôle est plutôt requis pour les applications qui suivent les expéditions des commandes afin de gérer les stocks, la fabrication et les achats. Exemples d'opérations nécessitant l'attribution de ce rôle :
  • Le createReport fonctionnement de l'API Selling Partner pour les rapports, lorsqu'elle est utilisée pour demander le GET_MERCHANT_LISTINGS_DATA rapport. Ce rapport affiche des listes actives détaillées.
  • Le createFeed fonctionnement de l'API Selling Partner pour les flux lorsqu'elle est utilisée pour soumettre un POST_FLAT_FILE_FULFILLMENT_DATA nourrir. Cela vous permet de transmettre les informations relatives à l'exécution des commandes à Amazon.
  • Le getOrderMetrics fonctionnement de l'API Selling Partner for Sales, qui renvoie des statistiques de commande agrégées.
Consultez la section Suivi des stocks et des commandes pour obtenir une liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle.

Entreposage et distribution Amazon 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:
  • Le listInventory fonctionnement de l'API Selling Partner pour Amazon Warehousing and Distribution, qui renvoie les niveaux de stock et l'état des produits en AWD.
  • Le getInboundShipment opération, qui renvoie des informations sur l'expédition, telles que le statut et les quantités reçues, à des fins de rapprochement.
Reportez-vous à Entreposage et distribution Amazon pour obtenir une liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle.
Notifications dans Seller Central 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:
  • Le createNotification L'opération crée et envoie une notification aux vendeurs contenant des informations pertinentes pour leur activité.
  • Le deleteNotifications Cette opération supprime une notification qui a été précédemment envoyée à un vendeur.
Pour obtenir la liste complète des opérations qui nécessitent ce rôle, reportez-vous au Notifications dans le rôle de Seller Central.
Fournisseur de services d'initiation de paiement Permet d'initier un versement selon la méthode de dépôt du vendeur et d'émettre un remboursement (ajustement) pour une commande. Vous pouvez utiliser le rôle de fournisseur de services d'initiation de paiement (PISP) pour consulter les modes de paiement du vendeur.
Pour obtenir la liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle, reportez-vous à Fournisseur de services d'initiation de paiement.
Pour plus d'informations sur l'enregistrement des développeurs de fournisseurs tiers, reportez-vous à Enregistrement d'un fournisseur tiers.
Fournisseur de services d'informations sur les comptes Fournit des informations sur le compte Amazon Selling Partner, notamment des informations sur l'activité du vendeur et les sites de vente sur lesquels le compte vendeur est actif. Vous pouvez utiliser le rôle de fournisseur de services d'informations sur les comptes (AISP) pour consulter les modes de paiement et les événements financiers du vendeur.
Pour obtenir la liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle, reportez-vous à Fournisseur de services d'informations sur les comptes.
Pour plus d'informations sur l'enregistrement des développeurs de fournisseurs tiers, reportez-vous à Enregistrement d'un fournisseur tiers.
Expédition directe aux consommateurs (restreint) Expédiez les commandes directement aux clients en utilisant le transporteur de leur choix, y compris Amazon. Les opérations qui nécessitent ce rôle utilisent les informations personnelles identifiables requises pour l'expédition. Généralement utilisé pour les rapports de commande, les rapports de suivi des commandes, EasyShip et pour les opérations liées à l'expédition des commandes passées sur Amazon. Exemples d'opérations nécessitant l'attribution de ce rôle :
  • Le getShipment fonctionnement de l'API Selling Partner pour Merchant Fulfillment, qui renvoie les informations d'expédition pour une expédition spécifiée.
  • Le getOrders fonctionnement de l'API Selling Partner pour les commandes, qui renvoie une liste des commandes et des informations sur les commandes en fonction des critères spécifiés.
  • Le createReport fonctionnement de l'API Selling Partner pour les rapports, lorsqu'elle est utilisée pour demander le GET_FLAT_FILE_ ORDER_REPORT_DATA_SHIPPING rapport.
  • Le createFeed fonctionnement de l'API Selling Partner pour les flux, lorsqu'elle est utilisée pour soumettre un POST_ORDER_FULFILLMENT_DATA nourrir. Ce flux permet à votre système de mettre à jour le système d'Amazon avec les informations relatives au traitement des commandes.
Consultez la section Expédition directe aux consommateurs (restreint) pour obtenir une liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle.

Facturation fiscale (restreint) Générez des factures fiscales pour vous conformer à la réglementation fiscale. Les opérations qui nécessitent ce rôle ont besoin des informations personnelles identifiables pour permettre la génération de factures fiscales. Généralement utilisé pour les rapports fiscaux et les rapports sur les commandes, ainsi que pour les opérations qui renvoient des informations sur les commandes. Exemples d'opérations nécessitant l'attribution de ce rôle :
  • Le createReport fonctionnement de l'API Selling Partner pour les rapports, lorsqu'elle est utilisée pour demander GET_AMAZON_FULFILLED_SHIPMENTS_INVOICING rapport. Ce rapport fournit des informations détaillées sur la commande/l'expédition/l'article.
  • Le getOrderAddress fonctionnement de l'API Selling Partner pour les commandes, qui renvoie l'adresse de livraison d'une commande.
  • Le getOrderBuyerInfo fonctionnement de l'API Selling Partner pour les commandes, qui renvoie les informations relatives à l'acheteur pour une commande.
  • Le createReport fonctionnement de l'API Selling Partner pour les rapports, lorsqu'elle est utilisée pour demander GET_EASYSHIP_DOCUMENTS rapport. Ce rapport contient la facture, l'étiquette d'expédition et les documents de garantie pour une commande Easy Ship.
Consultez la section Facturation fiscale (restreint) pour obtenir une liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle.
Versement de taxes (restreint) 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:
  • Le createReport fonctionnement de l'API Selling Partner pour les rapports, lorsqu'elle est utilisée pour demander GET_AMAZON_FULFILLED_SHIPMENTS_REMITTANCE rapport. Ce rapport fournit des informations détaillées sur la commande/l'expédition/l'article.
  • Le getOrderItems fonctionnement de l'API Selling Partner pour les commandes, qui renvoie des informations détaillées sur les articles de commande d'une commande.
  • Le getOrders fonctionnement de l'API Selling Partner pour les commandes, qui renvoie une liste des informations sur les articles de commande pour une période donnée et une série de critères.
Consultez la section Versement de taxes (restreint) pour obtenir une liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle.
Services professionnels (Restreint) 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:
  • Le getServiceJobs fonctionnement de l'API Selling Partner pour les services, qui renvoie une liste des détails des tâches de service pour la requête de filtre spécifiée.
  • Le addAppointmentForServiceJobByServiceJobId opération, qui ajoute un rendez-vous à la tâche de service indiquée par l'identifiant de la tâche de service spécifié.
Reportez-vous à Services professionnels pour obtenir une liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle.

Foire aux questions

Comment demander un rôle et remplir les conditions qu'il requiert ?

Vous demandez et remplissez les conditions requises pour les rôles d'API de partenaire de vente en renseignant votre profil de développeur. Les informations spécifiques demandées varient selon que vous vous êtes déjà inscrit ou non.

Une fois votre profil soumis, Amazon évalue les informations fournies et approuve ou refuse votre demande. En cas de refus, vous pouvez résoudre la raison du refus, puis soumettre à nouveau votre profil.

Comment choisir les rôles pour mon application ?

Lorsque vous créez votre application API partenaire de vente sur la page de création de client d'application, vous pouvez choisir des rôles parmi ceux qui ont été demandés et approuvés dans votre profil de développeur. Si le rôle dont vous avez besoin n'est pas disponible, vous devez mettre à jour les rôles de votre profil de développeur pour l'inclure, puis soumettre à nouveau votre profil pour évaluation par Amazon. Une fois approuvé, le rôle ajouté pourra être sélectionné pour votre application.

Remarque : si vous avez publié une application SP-API hybride, vous devez répertorier à nouveau votre application avant de procéder à une nouvelle autorisation.

Comment déterminer les rôles à demander ?

Consultez les descriptions des rôles dans ce document pour comprendre l'objectif de chaque rôle et pour voir des exemples de ressources et d'opérations régies par chaque rôle. Pour chaque rôle, utilisez le lien fourni pour accéder à la documentation qui fournit une liste complète des opérations et des types de flux, de rapports et de notifications qui nécessitent ce rôle.

Que se passe-t-il lorsque j'appelle une opération pour laquelle je n'ai pas le ou les rôles requis ?

La réponse à la demande contiendra un code d'état HTTP 403 et des informations sur l'erreur dans le corps de la réponse.

Comment ajouter un nouveau rôle après la publication de mon application ?

Pour ajouter un nouveau rôle après la publication de votre application, procédez comme suit :

  1. Accédez à votre profil de développeur et soumettez un rôle à ajouter.
  2. Une fois votre profil de développeur approuvé, accédez à la configuration de votre application et appliquez le rôle nouvellement approuvé à votre application. Enregistrez les modifications et enregistrez à nouveau l'application.
  3. Une fois l'application approuvée, obtenez de nouvelles autorisations pour générer un nouveau jeton d'actualisation qui donnera accès aux opérations d'API, aux rapports, aux flux et aux notifications fournis par le nouveau rôle.

Cette page vous a-t-elle été utile ?