Tutoriel : Abonnez-vous à la notification ORDER_CHANGE
Workflow d'abonnement à la notification ORDER_CHANGE
Ce didacticiel explique comment utiliser le ORDER_CHANGE
notification, qui est envoyée chaque fois qu'il y a un changement dans l'état de disponibilité des commandes. L'inscription à cette notification vous aidera à réduire la charge de travail liée au traitement de vos commandes et à améliorer les performances de votre intégration avec l'API Amazon Selling Partner.
Les avantages du ORDER_CHANGE
notification
ORDER_CHANGE
notificationLe ORDER_CHANGE
la notification offre les avantages suivants :
- Suffisamment d'informations pour automatiser vos flux de travail suivants : Vous pouvez désormais utiliser
ORDER_CHANGE
charge utile pour obtenir des informations sur les commandes. La notification est également conçue pour vous avertir si un acheteur demande une annulation. - Événements pour être averti si nécessaire : Vous n'aurez plus besoin de continuer à interroger l'API Orders, ce qui permet d'économiser de la capacité du serveur.
- Charge utile consolidée au niveau de la commande : Si la commande comporte plusieurs articles, vous recevrez des charges utiles consolidées au niveau de la commande. Le déclenchement au niveau de la commande vous permet de créer un flux de travail d'intégration plus efficace.
- Les filtres d'événements permettent de filtrer les abonnements : Les filtres d'événements sont désormais pris en charge avec
ORDER_CHANGE
notification. Grâce aux filtres d'événements, vous pouvez vous abonner avec unOrderChangeType
pour filtrer les notifications de commande pertinentes pour votre entreprise. Nous prenons actuellement en charge les annulations demandées par l'acheteur et la modification du statut de la commande. - Filtres d'événements extensibles pour les futurs cas d'utilisation : Cette nouvelle notification permet à Amazon d'ajouter des événements supplémentaires liés aux commandes à l'avenir, tels que certains événements Easy Ship ou des événements de retrait en bordure de rue.
- Heure du changement ajoutée pour fournir des modifications d'événements en temps réel : Le
ORDER_CHANGE
La notification indique l'heure du changement de commande dans un champ de la charge utile. L'intégrer à votre intégration vous permet de fournir des mises à jour en temps réel à vos vendeurs.
Didacticiel
Le didacticiel suivant vous aidera à vous abonner et à utiliser ORDER_CHANGE
notification.
Conditions préalables
Avant de vous abonner au ORDER_CHANGE
notification, votre profil de développeur et votre application doivent avoir le Rôle de suivi des stocks et des commandes ou Rôle d'Amazon Fulfillment assigné.
Important :
La version précédente de cette notification,
ORDER_STATUS_CHANGE
, sont devenus obsolètes. Abonnez-vous auORDER_CHANGE
notification et supprimez votre abonnement àORDER_STATUS_CHANGE
.
- Appelez le
getSubscription
opération pour récupérer lesubscriptionId
deORDER_STATUS_CHANGE
.- Avec le
subscriptionId
, utilisez ledeleteSubscriptionById
opération pour supprimer l'abonnement auORDER_STATUS_CHANGE
notification. N'oubliez pas que ledeleteSubscriptionById
l'opération est une opération sans subvention.
Étape 1. Abonnez-vous au ORDER_CHANGE
notification
ORDER_CHANGE
notification- Créez un abonnement à
ORDER_CHANGE
en utilisant des directives de traitement.
Le processingDirective
est utilisé pour transmettre des informations supplémentaires à l'abonnement afin de contrôler le traitement des notifications. Par exemple, vous pouvez utiliser eventFilter
pour filtrer les notifications relatives à un type de modification de commande spécifique.
À utiliser eventFilter
pour ORDER_CHANGE
notifications, assurez-vous d'inclure eventFilterType
et orderChangeTypes
à l'étape de création d'un abonnement.
-
Appelez l'opération
createSubscription
. -
Ajoutez le paramètre
ORDER_CHANGE
dans lenotificationType
variable de chemin.
La charge utile suivante montre comment configurer un filtre pour ne recevoir que des notifications concernant les modifications du statut des commandes. Assurez-vous d'inclure votre destinationId
:
POST https://sellingpartnerapi-na.amazon.com/notifications/v1/subscriptions/ORDER_CHANGE
{
"payloadVersion": "1.0",
"destinationId": "e22gf420-1606-47c4-a393-91df6648d3da",
"processingDirective": {
"eventFilter": {
"orderChangeTypes": [
"OrderStatusChange"
],
"eventFilterType": "ORDER_CHANGE"
}
}
}
Si la demande aboutit, vous recevrez la réponse suivante :
{
"payload": {
"subscriptionId": "92d519e4-f208-493b-9092-d70cf546c383",
"destinationId": "e22gf420-1606-47c4-a393-91df6648d3da",
"payloadVersion": "1.0",
"processingDirective": {
"eventFilter": {
"orderChangeTypes": [
"OrderStatusChange"
],
"eventFilterType": "ORDER_CHANGE"
}
}
}
}
Si vous souhaitez recevoir BuyerRequestedChange
informations, vous devez inclure BuyerRequestedChange
dans orderChangeTypes
pour filtrer les notifications pertinentes. Pour recevoir des notifications de commande concernant tous les types de modifications de commande, ajoutez le eventFilterType
réglage lors de l'inscription à cette notification.
Exemple de charge utile :
{
"destinationId": "e22gf420-1606-47c4-a393-91df6648d3da",
"payloadVersion": "1.0",
"processingDirective": {
"eventFilter": {
"eventFilterType": "ORDER_CHANGE"
}
}
}
Étape 2 Recevoir des messages de notification
Une fois la notification correctement configurée, vous recevrez des messages dans votre file d'attente Amazon Simple Queue Service (Amazon SQS) pour tous les changements de statut de la commande.
Ce qui suit est un exemple de ORDER_CHANGE
notification :
{
"NotificationVersion" : "1.0",
"NotificationType" : "ORDER_CHANGE",
"PayloadVersion" : "1.0",
"EventTime" : "2023-10-03T01:35:06.382Z",
"Payload" : {
"OrderChangeNotification" : {
"NotificationLevel" : "OrderLevel",
"SellerId" : "ABCDEFGFMDKELDW",
"AmazonOrderId" : "123-4567891-4567891",
"OrderChangeType" : "OrderStatusChange",
"OrderChangeTrigger" : {
"TimeOfOrderChange" : "2023-10-03T01:35:01.000Z",
"ChangeReason" : "Order Status Change"
},
"Summary" : {
"MarketplaceId" : "A2Q3Y263D00KWC",
"OrderStatus" : "Unshipped",
"PurchaseDate" : "2023-10-03T01:03:44.106Z",
"DestinationPostalCode" : null,
"FulfillmentType" : "MFN",
"OrderType" : "StandardOrder",
"OrderPrograms" : [ ],
"ShippingPrograms" : [ ],
"OrderItems" : [ {
"OrderItemId" : "12345207241",
"SellerSKU" : "SKU123",
"SupplySourceId" : null,
"Quantity" : 15
} ]
}
}
},
"NotificationMetadata" : {
"ApplicationId" : "amzn1.sp.solution.c4d.......",
"SubscriptionId" : "52ac10........",
"PublishTime" : "2023-10-03T01:35:07.931Z",
"NotificationId" : "e9b0f384........"
}
}
Lorsque vous recevez une notification, vérifiez la valeur de OrderChangeTypes
dans la charge utile de notification :
BuyerRequestedChange
: L'acheteur a initié une procédure d'annulation. Pour annuler une commande MFN, utilisez lePOST_ORDER_ACKNOWLEDGEMENT_DATA
nourrir.OrderStatusChange
: Le statut de la commande a changé. Vérifiez les modificationsOrderStatus
. Si c'estUnshipped
, vous pouvez maintenant commencer à préparer votre commande pour expédier les articles achetés par les acheteurs. Il s'agit d'une tâche urgente ; le fait d'être averti en temps réel vous permet de traiter les commandes dans les meilleurs délais. Après avoir expédié le produit au client, vous devez également confirmer l'expédition à Amazon, en informant l'acheteur que le produit est en attente de livraison. Reportez-vous à Comment confirmer les commandes MFN à l'aide de SP-API pour plus d'informations sur la confirmation des commandes MFN à l'aide des API des partenaires de vente.
La charge utile du ORDER_CHANGE
la notification fournit désormais OrderItems
à partir de la commande correspondante. Lorsque vous utilisez le OrderItems
informations, vous n'avez plus besoin d'appeler le getOrderItems
opération pour savoir quels articles se trouvent dans une commande.
Conclusion
Ce tutoriel expliquait comment s'abonner et utiliser le ORDER_CHANGE
notification, qui permet de réduire la charge de travail liée au traitement des commandes et d'améliorer les performances de votre intégration avec l'API Amazon Selling Partner.
Updated 8 months ago