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

Le 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 un OrderChangeType 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 au ORDER_CHANGE notification et supprimez votre abonnement à ORDER_STATUS_CHANGE.

  1. Appelez le getSubscription opération pour récupérer le subscriptionId de ORDER_STATUS_CHANGE.
  2. Avec le subscriptionId, utilisez le deleteSubscriptionById opération pour supprimer l'abonnement au ORDER_STATUS_CHANGE notification. N'oubliez pas que le deleteSubscriptionById l'opération est une opération sans subvention.

Étape 1. Abonnez-vous au ORDER_CHANGE notification

  1. 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.

  1. Appelez l'opération createSubscription.

  2. Ajoutez le paramètre ORDER_CHANGE dans le notificationType 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 :

  1. BuyerRequestedChange: L'acheteur a initié une procédure d'annulation. Pour annuler une commande MFN, utilisez le POST_ORDER_ACKNOWLEDGEMENT_DATA nourrir.
  2. OrderStatusChange: Le statut de la commande a changé. Vérifiez les modifications OrderStatus. Si c'est Unshipped, 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.


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