Questions fréquentes
Qu'est-ce que le rôle Professional Services (Restricted) sur l'API SP d'Amazon ?
Il s'agit du rôle de l'API Selling Partner qui, selon les propres termes d'Amazon, « donne accès aux opérations qui fournissent des services additionnels tels que l'assemblage et l'installation aux acheteurs Amazon ». Il contrôle l'accès à l'API Services v1, qui permet à un vendeur de services de récupérer les tâches de service, de planifier et de reprogrammer des rendez-vous, d'affecter des techniciens et de gérer la capacité. « Restreint » signifie que le rôle renvoie des données sensibles, y compris des informations personnelles identifiables (PII).
Quelles API et opérations le rôle Professional Services contrôle-t-il ?
Il contrôle l'API Services v1 (chemin de base /service/v1/). Le guide d'utilisation de l'API Services v1 indique qu'il s'agit du seul rôle requis pour toutes ses opérations. Le document d'Amazon sur les rôles nomme deux opérations sous ce rôle : getServiceJobs (renvoie une liste de détails de tâches de service pour une requête de filtre) et addAppointmentForServiceJobByServiceJobId (ajoute un rendez-vous à la tâche de service indiquée). Le rôle contrôle l'ensemble des opérations de l'API Services v1, récupération des tâches, des rendez-vous, affectation des ressources, exécution et capacité.
Pourquoi le rôle Professional Services est-il « Restreint » ?
Parce que ses opérations renvoient des PII d'acheteur. Une charge utile ServiceJob expose le nom et le téléphone de l'acheteur, l'adresse complète du service (domicile) et l'heure du rendez-vous, exactement assez pour localiser physiquement une personne à un moment connu. Le document d'Amazon sur les rôles définit un rôle restreint comme un rôle qui « nécessite des informations sensibles, qui peuvent inclure des informations personnelles identifiables (PII) ». Pour les rôles restreints, vous devez fournir des informations supplémentaires sur votre utilisation des données et vos contrôles de sécurité.
Quelles données d'acheteur getServiceJobs renvoie-t-elle réellement ?
La charge utile ServiceJob inclut buyer.name et buyer.phone ; l'adresse serviceLocation (addressLine1, addressLine2, addressLine3, city, county, district, stateOrRegion, postalCode, countryCode, plus phone et name) ; appointmentTime (startTime et durationInMinutes) ; le scopeOfWork (asin, title, quantity, requiredSkills) et les associatedItems (y compris orderId liant la tâche à la commande produit) ; et assignedTechnicians. Cette combinaison de nom, d'adresse complète, de téléphone et d'une heure planifiée est la raison pour laquelle Amazon la contrôle.
Ai-je besoin d'un Restricted Data Token (RDT) pour l'API Services ?
Oui. Parce que le rôle est restreint et que la charge utile contient des PII, les opérations restreintes de Services nécessitent un Restricted Data Token émis par l'API Tokens (createRestrictedDataToken). Le RDT est passé à la place du jeton d'accès normal lors de l'appel restreint avant que les champs PII ne soient renvoyés. (La page publique d'Amazon listant les opérations restreintes n'énumérait pas les chemins Services lors de notre dernière passe de recherche, traitez donc le mappage de chemin spécifique comme un détail d'implémentation à confirmer par rapport à la documentation en direct.)
Quels sont les statuts des tâches de service ?
L'énumération serviceJobStatus a sept valeurs : NOT_SERVICED, CANCELLED, COMPLETED, PENDING_SCHEDULE, NOT_FULFILLABLE, HOLD et PAYMENT_DECLINED. getServiceJobs vous permet de filtrer par statut (et par identifiants de commande de service, identifiants de commande produit, dates de planification, ASINs, compétences requises, etc.). Notez que marketplaceIds est un paramètre obligatoire sur getServiceJobs.
Puis-je reprogrammer, annuler ou clôturer des tâches via l'API ?
Oui. L'API Services v1 couvre l'ensemble du cycle de vie : confirmer ou reprogrammer des rendez-vous (rescheduleAppointmentForServiceJobByServiceJobId), affecter des ressources (assignAppointmentResources), définir les données d'exécution (setAppointmentFulfillmentData), télécharger des documents de preuve (createServiceDocumentUploadDestination), et terminer ou annuler des tâches (completeServiceJobByServiceJobId, cancelServiceJobByServiceJobId). La capacité est gérée par updateSchedule et les opérations de réservation.
Qui a besoin du rôle Professional Services, et qui n'en a pas besoin ?
Il est destiné aux vendeurs de services Amazon proposant des services additionnels en personne, installateurs, assembleurs, réparateurs, techniciens CVC et d'électroménager, fournisseurs d'installation à domicile, et aux logiciels de service sur le terrain, de répartition, d'itinéraire et WMS/OMS/ERP qui les soutiennent (le guide mentionne explicitement la planification d'itinéraire et d'exécution). Il est réservé aux vendeurs, dans les régions NA, UE et FE. Les vendeurs purement en ligne ou FBA sans composante de service à domicile n'en ont pas besoin.
Comment obtenir l'approbation du rôle Professional Services (Restricted) ?
Amazon approuve sur la base de la conformité, pas sur la qualité de la rédaction de la demande. Vous avez besoin d'une justification commerciale crédible pour le rôle et ses PII, de réponses cohérentes à chaque question de la demande, d'une politique de traitement des données et de confidentialité publiable, et d'une liste de contrôle de mise en œuvre couvrant la conservation, le chiffrement, le contrôle d'accès, la journalisation et la réponse aux incidents. Fenchell reconstruit ce dossier exact afin que la raison d'un refus soit éliminée, sans jamais toucher à votre code, vos serveurs ou votre compte Amazon.
Pourquoi les demandes Professional Services sont-elles rejetées ?
Presque toujours parce que la documentation de sécurité et de conformité ne répondait pas aux exigences, pas parce que le produit est faible. Causes courantes : les réponses à la demande, la politique de confidentialité et les procédures de sécurité se contredisent ; des réponses génériques copiées-collées ; une justification faible pour avoir besoin de l'adresse et du téléphone de l'acheteur ; aucun inventaire des données au niveau des champs ; une conservation des PII non plafonnée ou non automatisée de manière prouvable ; des journaux qui stockent des PII ; tout indice de collecte d'identifiants ou de revente de données entre vendeurs ; ou un site web public qui ne correspond pas au rôle demandé.
Ai-je besoin d'une entreprise européenne pour demander le rôle Professional Services ?
Pas strictement, mais une entreprise correctement établie avec une présence publique propre et une véritable politique de traitement des données facilite l'approbation, et une structure européenne conforme aide avec les attentes en matière de TVA et de protection des données. Fenchell peut
créer une société bulgare conforme, 100 % à distance, et aligner votre structure, votre TVA et votre demande Amazon pour qu'elles se soutiennent mutuellement.
Combien cela coûte-t-il et combien de temps cela prend-il ?
Le dossier standard pour le rôle restreint Professional Services est un paiement unique de 650 EUR, livré dans les 48 heures suivant le paiement, avec jusqu'à 3 tentatives de soumission. Les applications publiques proposées à de nombreux vendeurs sont un engagement plus important, dont le prix est établi après un court appel. Après la livraison, le délai de soumission dépend de la rapidité avec laquelle votre équipe met en œuvre la liste de contrôle, et Amazon contrôle son propre délai d'examen. Nous ne promettons jamais l'approbation, Amazon garde la décision finale, mais nous éliminons les raisons de conformité pour lesquelles elle est refusée.
Combien de temps Amazon met-il pour approuver le rôle Professional Services ?
Amazon contrôle le calendrier final, il n'y a donc pas de délai garanti. D'après notre expérience de préparation de demandes de rôles restreints depuis 2018, une soumission complète et conforme est généralement examinée dans un délai d'environ 2 à 6 semaines. Les applications publiques qui nécessitent également l'évaluation de sécurité des données tierce ajoutent environ un mois pour cette étape. Le plus grand accélérateur est un dossier qui répond à la barre de sécurité et de conformité d'Amazon dès la première tentative, c'est exactement ce que nous construisons.