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 :
|
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 :
|
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 :
|
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 :
|
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 :
|
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 :
|
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 :
|
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 :
|
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 :
|
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:
|
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:
|
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 :
|
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 :
|
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:
|
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:
|
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 :
- Accédez à votre profil de développeur et soumettez un rôle à ajouter.
- 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.
- 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.
Updated 27 days ago