Guide des cas d'utilisation de l'API Stock Expédié par Amazon

Récupérez de façon planifiée des informations sur les stocks du réseau de distribution Amazon.

Version de l'API : v1

Qu'est-ce que l'API Stock Expédié par Amazon ?

L'API Stock Expédié par Amazon vous permet de suivre la disponibilité en temps réel de vos stocks dans le réseau de distribution des commandes d'Amazon au niveau du site de vente. Vous pouvez obtenir des détails tels que l'état de la liste et les quantités de stock telles que expédiable, entrante, réservée, non expédiable et en cours de recherche. Cette API est disponible dans le monde entier.

Comment utiliser l'API Stock Expédié par Amazon ?

🚧
nextToken expirera dans 30 secondes
Pour éviter les erreurs, utilisez nextToken pour accéder à la page suivante dans les 30 secondes.

The FBA Inventory API requires the Product Listing role.

The getInventorySummaries operation returns a list of inventory summaries. The summaries returned depend on the presence or absence of the startDateTime and sellerSkus query parameters:

Tous les récapitulatifs de stock comportant tous les détails disponibles sont renvoyés lorsque les paramètres startDateTime et sellerSkus sont omis.
Si startDateTime est fourni, l'opération renvoie les récapitulatifs de stock qui ont été modifiés après la date et l'heure indiquées. Le paramètre sellerSkus est ignoré.

🚧
Évitez les erreurs de pagination
Pour éviter les erreurs, utilisez les paramètres startDateTime et nextToken afin d'obtenir la page suivante des récapitulatifs de stock qui ont été modifiés après la date et l'heure indiquées.

Lorsque ce paramètre sellerSkus est renseigné, l'opération renvoie des récapitulatifs de stock uniquement pour l'unité sellerSkus indiquée.

Tutoriel : Obtenir tous les récapitulatifs de stock disponibles avec tous les détails disponibles

This tutorial shows you how to use the FBA Inventory API to return all the available inventory summaries with full details. This corresponds to number 1 in How to use the FBA Inventory API.

Conditions préalables

Pour terminer ce tutoriel, vous aurez besoin des éléments suivants :

L'identifiant du site de vente pour lequel des récapitulatifs de stock doivent être renvoyés.

Obtenez tous les récapitulatifs de stock disponibles avec tous les détails.

To return all available inventory summaries with full details, call the getInventorySummaries operation of the FBA Inventory API, passing the following query parameters:

Paramètre	Description	Obligatoire
`details`	Sélectionnez `true` pour obtenir des récapitulatifs de stock avec des détails et des quantités supplémentaires. Sinon, renvoie uniquement les récapitulatifs de stock (valeur par défaut).	Oui. Doit être réglé sur `true`.
`granularityType`	Le type de granularité pour le niveau d'agrégation de stock. Valeurs possibles : `Marketplace`.	Oui.
`granularityId`	L'ID de granularité pour le type de granularité indiqué. Si `granularityType` est `Marketplace`, vous devez indiquer la valeur `marketplaceId`.	Oui.
`marketplaceIds`	L'identifiant du site de vente pour lequel des récapitulatifs de stock doivent être renvoyés. Un seul identifiant de site de vente est autorisé.	Oui.
`nextToken`	Jeton de chaîne renvoyé dans la réponse à votre demande précédente. Le jeton expire au bout de 30 secondes.	Non.

Exemple de demande :

GET https://sellingpartnerapi-na.amazon.com/fba/inventory/v1/summaries?details=true&granularityType=Marketplace&granularityId=ATVPDKIKX0DER&marketplaceIds=ATVPDKIKX0DER

Une réponse réussie comprend les éléments suivants dans les données utiles pour chaque sellerSku :

Nom	Description
`sellerSku`	Le SKU du vendeur de l'article.
`fnSku`	L'identifiant des SKU du réseau de distribution Amazon. Les unités de gestion des stocks du réseau de distribution (FNSKU) sont des identifiants uniques attribués par Amazon aux produits stockés dans les centres de distribution Amazon et livrés à partir de ceux-ci.
`asin`	Le numéro d'identification standard Amazon (ASIN) d'un article. Vous trouverez l'ASIN sur la page de détail du produit.
`productName`	Le titre du produit dans la langue localisée de l'article sur le site de vente indiqué.
`lastUpdatedTime`	La date et l'heure de la dernière mise à jour d'une quantité.
`totalQuantity`	Le nombre total d'unités dans une expédition entrante ou dans les centres de distribution Amazon.
`fulfillableQuantity`	La quantité d'articles pouvant être préparés, emballés et expédiés.
`inboundWorkingQuantity`	Le nombre d'unités dans une expédition entrante pour laquelle vous avez notifié Amazon.
`inboundShippedQuantity`	Le nombre d'unités dans une expédition entrante dont vous avez informé Amazon et pour laquelle vous avez fourni un numéro de suivi.
`inboundReceivingQuantity`	Le nombre d'unités qui n'ont pas encore été reçues dans un centre de distribution Amazon pour traitement, mais qui font partie d'une expédition entrante avec certaines unités qui ont déjà été reçues et traitées.
`totalReservedQuantity`	Le nombre total d'unités dans le réseau de distribution Amazon qui sont actuellement en cours de préparation, d'emballage et d'expédition, ou qui sont mises de côté pour des mesures, des échantillonnages ou d'autres processus internes.
`pendingCustomerOrderQuantity`	Le nombre d'unités réservées aux commandes des clients.
`pendingTransshipmentQuantity`	Le nombre d'unités transférées d'un centre de distribution à un autre.
`fcProcessingQuantity`	Le nombre d'unités qui ont été mises de côté au centre de distribution pour un traitement supplémentaire.
`totalUnfulfillableQuantity`	Le nombre total d'unités dans le réseau de distribution des commandes d'Amazon qui ne peuvent être vendues.
`customerDamagedQuantity`	Le nombre d'unités endommagées chez le client.
`warehouseDamagedQuantity`	Le nombre d'unités endommagées dans l'entrepôt.
`distributorDamagedQuantity`	Le nombre d'unités endommagées chez le distributeur.
`carrierDamagedQuantity`	Le nombre d'unités endommagées chez le transporteur.
`defectiveQuantity`	Le nombre d'unités défectueuses.
`expiredQuantity`	Le nombre d'unités ayant atteint la date d'expiration.
`totalResearchingQuantity`	Le nombre total d'unités en cours de recherche dans le réseau de distribution Amazon.
`researchingQuantityBreakdown`	Une liste de détails sur les quantités pour les articles en cours de recherche, notamment `researchingQuantityInShortTerm` (1 à 10 jours) `researchingQuantityInMidTerm` (11 à 20 jours) `researchingQuantityInLongTerm` (21 jours ou plus).

Exemple de réponse :

{
  "pagination": {
    "nextToken": "seed"
  },
  "payload": {
    "granularity": {
      "granularityType": "Marketplace",
      "granularityId": "ATVPDKIKX0DER"
    },
    "inventorySummaries": [
      {
        "asin": "B00T9QONN1",
        "fnSku": "B00T9QONN1",
        "sellerSku": "msku314best",
        "condition": "NewItem",
        "inventoryDetails": {
          "fulfillableQuantity": 66,
          "inboundWorkingQuantity": 21,
          "inboundShippedQuantity": 0,
          "inboundReceivingQuantity": 0,
          "reservedQuantity": {
            "totalReservedQuantity": 0,
            "pendingCustomerOrderQuantity": 0,
            "pendingTransshipmentQuantity": 0,
            "fcProcessingQuantity": 0
          },
          "researchingQuantity": {
            "totalResearchingQuantity": 0,
            "researchingQuantityBreakdown": [
              {
                "name": "researchingQuantityInShortTerm",
                "quantity": 0
              },
              {
                "name": "researchingQuantityInMidTerm",
                "quantity": 0
              },
              {
                "name": "researchingQuantityInLongTerm",
                "quantity": 0
              }
            ]
          },
          "unfulfillableQuantity": {
            "totalUnfulfillableQuantity": 0,
            "customerDamagedQuantity": 0,
            "warehouseDamagedQuantity": 0,
            "distributorDamagedQuantity": 0,
            "carrierDamagedQuantity": 0,
            "defectiveQuantity": 0,
            "expiredQuantity": 0
          }
        },
        "lastUpdatedTime": "2018-03-31T23: 40: 39Z",
        "productName": "CalciumPowder",
        "totalQuantity": 87
      }
    ]
  }
}

Tutoriel : Obtenir tous les récapitulatifs de stock disponibles qui ont changé

This tutorial shows you how to use the FBA Inventory API to return all the available inventory summaries that have changed since the specified start date and time. This corresponds to number 2 in How to use the FBA Inventory API.

Conditions préalables

Pour terminer ce tutoriel, vous aurez besoin des éléments suivants :

L'identifiant du site de vente pour lequel des récapitulatifs de stock doivent être renvoyés.
La date et l'heure d'entrée à utiliser comme base pour renvoyer les récapitulatifs de stock qui ont changé.

Obtenez tous les récapitulatifs de stock disponibles qui ont changé.

📘
startDateTime requis
startDateTime est nécessaire pour obtenir la page suivante des récapitulatifs de stock qui ont changé après la date et l'heure indiquées.

To return all available inventory summaries that have changed, call the getInventorySummaries operation of the FBA Inventory API, passing the following query parameters:

Paramètre	Description	Obligatoire
`details`	Sélectionnez `true` pour obtenir des récapitulatifs de stock avec des détails et des quantités supplémentaires. Sinon, renvoie uniquement les récapitulatifs de stock (valeur par défaut).	Non.
`granularityType`	Le type de granularité pour le niveau d'agrégation de stock. Valeurs possibles : `Marketplace`.	Oui.
`granularityId`	L'ID de granularité pour le type de granularité indiqué. Si `granularityType` est `Marketplace`, vous devez indiquer la valeur `marketplaceId`.	Oui.
`startDateTime`	A start date and time in ISO 8601 format. If specified, all inventory summaries that have changed since then are returned. You must specify a date and time that is no earlier than 18 months prior to the date and time of the request. Remarque : les modifications apportées aux éléments suivants ne sont pas détectées : `inboundWorkingQuantity` `inboundShippedQuantity` `inboundReceivingQuantity`	Oui.
`marketplaceIds`	L'identifiant du site de vente pour lequel des récapitulatifs de stock doivent être renvoyés. Un seul identifiant de site de vente est autorisé.	Oui.
`nextToken`	Jeton de chaîne renvoyé dans la réponse à votre demande précédente. Le jeton expire au bout de 30 secondes.	Non.

Exemple de demande :

GET https://sellingpartnerapi-na.amazon.com/fba/inventory/v1/summaries?granularityType=Marketplace&granularityId=ATVPDKIKX0DER&startDateTime=2018-03-27T23:40:39Z&marketplaceIds=ATVPDKIKX0DER

Une réponse réussie comprend ce qui suit dans la charge utile pour chaque sellerSku. Remarque : comme le paramètre detail n'a pas été indiqué dans l'exemple de demande et que la valeur par défaut est false, les détails et les quantités additionnels du stock récapitulé ne sont pas renvoyés.

Nom	Description
`sellerSku`	Le SKU du vendeur de l'article.
`fnSku`	L'identifiant des SKU du réseau de distribution Amazon. Les unités de gestion des stocks du réseau de distribution (FNSKU) sont des identifiants uniques attribués par Amazon aux produits stockés dans les centres de distribution Amazon et livrés à partir de ceux-ci.
`asin`	Le numéro d'identification standard Amazon (ASIN) d'un article. Vous trouverez l'ASIN sur la page de détail du produit.
`productName`	Le titre du produit dans la langue localisée de l'article sur le site de vente indiqué.
`lastUpdatedTime`	La date et l'heure de la dernière mise à jour d'une quantité.
`totalQuantity`	Le nombre total d'unités dans une expédition entrante ou dans les centres de distribution Amazon.

Exemple de réponse :

{
  "pagination": {
    "nextToken": "seed"
  },
  "payload": {
    "granularity": {
      "granularityType": "Marketplace",
      "granularityId": "ATVPDKIKX0DER"
    },
    "inventorySummaries": [
      {
        "asin": "B00T9QONN1",
        "fnSku": "B00T9QONN1",
        "sellerSku": "msku314best",
        "condition": "NewItem",
        "lastUpdatedTime": "2018-03-31T23: 40: 39Z",
        "productName": "CalciumPowder",
        "totalQuantity": 87
      }
    ]
  }
}

Tutoriel : Obtenir des récapitulatifs de stock pour les SKU de vendeurs indiqués

This tutorial shows you how to use the FBA Inventory API to return inventory summaries for one or more (up to 50) specified sellerSku. This corresponds to number 3 in How to use the FBA Inventory API.

Conditions préalables

Pour terminer ce tutoriel, vous aurez besoin des éléments suivants :

L'identifiant du site de vente pour lequel des récapitulatifs de stock doivent être renvoyés.
Une liste de cinquante sellerSku maximum pour lesquels renvoyer des récapitulatifs de stock.

Obtenez des récapitulatifs de stock avec des détails supplémentaires pour les SKU de vendeur indiqués.

To return inventory summaries with full details for the specified SKUs, call the **getInventorySummaries** operation of the FBA Inventory API, passing the following query parameters:

Paramètre	Description	Obligatoire
`details`	Sélectionnez `true` pour obtenir des récapitulatifs de stock avec des détails et des quantités supplémentaires. Sinon, renvoie uniquement les récapitulatifs de stock (valeur par défaut).	Oui. Doit être réglé sur `true`.
`granularityType`	Le type de granularité pour le niveau d'agrégation de stock. Valeurs possibles : `Marketplace`.	Oui.
`granularityId`	L'ID de granularité pour le type de granularité indiqué. Si `granularityType` est `Marketplace`, vous devez indiquer la valeur `marketplaceId`.	Oui.
`sellerSkus`	Une liste des SKU du vendeur pour lesquels des récapitulatifs de stock doivent être renvoyés. Vous pouvez indiquer jusqu'à 50 SKU.	Oui.
`marketplaceIds`	L'identifiant du site de vente pour lequel des récapitulatifs de stock doivent être renvoyés. Un seul identifiant de site de vente est autorisé.	Oui.

Exemple de demande :

GET https://sellingpartnerapi-na.amazon.com/fba/inventory/v1/summaries?details=true&granularityType=Marketplace&granularityId=ATVPDKIKX0DER&sellerSkus=msku314best%2Cmsku271good&marketplaceIds=ATVPDKIKX0DER

Une réponse réussie inclut les éléments suivants dans la charge utile pour chacun des éléments spécifiés sellerSkus:

Nom	Description
`sellerSku`	Le SKU du vendeur de l'article.
`fnSku`	L'identifiant des SKU du réseau de distribution Amazon. Les unités de gestion des stocks du réseau de distribution (FNSKU) sont des identifiants uniques attribués par Amazon aux produits stockés dans les centres de distribution Amazon et livrés à partir de ceux-ci.
`asin`	Le numéro d'identification standard Amazon (ASIN) d'un article. Vous trouverez l'ASIN sur la page de détail du produit.
`productName`	Le titre du produit dans la langue localisée de l'article sur le site de vente indiqué.
`lastUpdatedTime`	La date et l'heure de la dernière mise à jour d'une quantité.
`totalQuantity`	Le nombre total d'unités dans une expédition entrante ou dans les centres de distribution Amazon.
`fulfillableQuantity`	La quantité d'articles pouvant être préparés, emballés et expédiés.
`inboundWorkingQuantity`	Le nombre d'unités dans une expédition entrante pour laquelle vous avez notifié Amazon.
`inboundShippedQuantity`	Le nombre d'unités dans une expédition entrante dont vous avez informé Amazon et pour laquelle vous avez fourni un numéro de suivi.
`inboundReceivingQuantity`	Le nombre d'unités qui n'ont pas encore été reçues dans un centre de distribution Amazon pour traitement, mais qui font partie d'une expédition entrante avec certaines unités qui ont déjà été reçues et traitées.
`totalReservedQuantity`	Le nombre total d'unités dans le réseau de distribution Amazon qui sont actuellement en cours de préparation, d'emballage et d'expédition, ou qui sont mises de côté pour des mesures, des échantillonnages ou d'autres processus internes.
`pendingCustomerOrderQuantity`	Le nombre d'unités réservées aux commandes des clients.
`pendingTransshipmentQuantity`	Le nombre d'unités transférées d'un centre de distribution à un autre.
`fcProcessingQuantity`	Le nombre d'unités qui ont été mises de côté au centre de distribution pour un traitement supplémentaire.
`totalUnfulfillableQuantity`	Le nombre total d'unités dans le réseau de distribution des commandes d'Amazon qui ne peuvent être vendues.
`customerDamagedQuantity`	Le nombre d'unités endommagées chez le client.
`warehouseDamagedQuantity`	Le nombre d'unités endommagées dans l'entrepôt.
`distributorDamagedQuantity`	Le nombre d'unités endommagées chez le distributeur.
`carrierDamagedQuantity`	Le nombre d'unités endommagées chez le transporteur.
`defectiveQuantity`	Le nombre d'unités défectueuses.
`expiredQuantity`	Le nombre d'unités ayant atteint la date d'expiration.
`totalResearchingQuantity`	Le nombre total d'unités en cours de recherche dans le réseau de distribution Amazon.
`researchingQuantityBreakdown`	Une liste de détails sur les quantités pour les articles en cours de recherche, notamment `researchingQuantityInShortTerm` (1 à 10 jours) `researchingQuantityInMidTerm` (11 à 20 jours) `researchingQuantityInLongTerm` (21 jours ou plus).

Exemple de réponse :

{
  "pagination": {
    "nextToken": "seed"
  },
  "payload": {
    "granularity": {
      "granularityType": "Marketplace",
      "granularityId": "ATVPDKIKX0DER"
    },
    "inventorySummaries": [
      {
        "asin": "B00T9QONN1",
        "fnSku": "B00T9QONN1",
        "sellerSku": " msku314best",
        "condition": "NewItem",
        "inventoryDetails": {
          "fulfillableQuantity": 66,
          "inboundWorkingQuantity": 21,
          "inboundShippedQuantity": 0,
          "inboundReceivingQuantity": 0,
          "reservedQuantity": {
            "totalReservedQuantity": 0,
            "pendingCustomerOrderQuantity": 0,
            "pendingTransshipmentQuantity": 0,
            "fcProcessingQuantity": 0
          },
          "researchingQuantity": {
            "totalResearchingQuantity": 0,
            "researchingQuantityBreakdown": [
              {
                "name": "researchingQuantityInShortTerm",
                "quantity": 0
              },
              {
                "name": "researchingQuantityInMidTerm",
                "quantity": 0
              },
              {
                "name": "researchingQuantityInLongTerm",
                "quantity": 0
              }
            ]
          },
          "unfulfillableQuantity": {
            "totalUnfulfillableQuantity": 0,
            "customerDamagedQuantity": 0,
            "warehouseDamagedQuantity": 0,
            "distributorDamagedQuantity": 0,
            "carrierDamagedQuantity": 0,
            "defectiveQuantity": 0,
            "expiredQuantity": 0
          }
        },
        "lastUpdatedTime": "2018-03-31T23: 40: 39Z",
        "productName": "CalciumPowder",
        "totalQuantity": 87
      },
      {
        "asin": "B00T9QONN2",
        "fnSku": "B00T9QONN2",
        "sellerSku": " msku271good",
        "condition": "NewItem",
        "inventoryDetails": {
          "fulfillableQuantity": 6,
          "inboundWorkingQuantity": 2,
          "inboundShippedQuantity": 0,
          "inboundReceivingQuantity": 0,
          "reservedQuantity": {
            "totalReservedQuantity": 0,
            "pendingCustomerOrderQuantity": 0,
            "pendingTransshipmentQuantity": 0,
            "fcProcessingQuantity": 0
          },
          "researchingQuantity": {
            "totalResearchingQuantity": 0,
            "researchingQuantityBreakdown": [
              {
                "name": "researchingQuantityInShortTerm",
                "quantity": 0
              },
              {
                "name": "researchingQuantityInMidTerm",
                "quantity": 0
              },
              {
                "name": "researchingQuantityInLongTerm",
                "quantity": 0
              }
            ]
          },
          "unfulfillableQuantity": {
            "totalUnfulfillableQuantity": 0,
            "customerDamagedQuantity": 0,
            "warehouseDamagedQuantity": 0,
            "distributorDamagedQuantity": 0,
            "carrierDamagedQuantity": 0,
            "defectiveQuantity": 0,
            "expiredQuantity": 0
          }
        },
        "lastUpdatedTime": "2018-04-01T23: 40: 39Z",
        "productName": "CalciumPowder",
        "totalQuantity": 8
      }
    ]
  }
}

Recommandation générale

NextToken dans GetInventorySummariesResponse

Pour éviter les erreurs, utilisez nextToken pour accéder à la page suivante dans les 30 secondes.

Pagination dans GetInventorySummariesResponse

When a call to the **getInventorySummaries** operation produces a nextToken, then there are inventories that have not been encountered yet and you can get them on the subsequent calls. You iterate through the Inventories using the nextToken token provided in successive responses. All inventory has been traversed, only after the pagination is returned in response. This means the inventorySummaries list can be empty but still produce a nextToken.

Exemples :

Même s'il n'y a pas de stocks dans la liste inventorySummaries, il y a un nextToken :

{
  "response": {
    "pagination": {
      "nextToken": "XXXXXXXXX"
    },
    "payload": {
      "granularity": {
        ...
      },
      "inventorySummaries": []
    }
  }
}

L'opération getInventorySummaries n'est considérée comme terminée que lorsque pagination n'est pas renvoyé dans la réponse :

{
  "response": {
    "payload": {
      "granularity": {
        ...
      },
      "inventorySummaries": []
    }
  }
}

Updated 18 days ago

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

Guide des cas d'utilisation de l'API Stock Expédié par Amazon

Qu'est-ce que l'API Stock Expédié par Amazon ?

Comment utiliser l'API Stock Expédié par Amazon ?

🚧
`nextToken` expirera dans 30 secondes

🚧
Évitez les erreurs de pagination

Tutoriel : Obtenir tous les récapitulatifs de stock disponibles avec tous les détails disponibles

Obtenez tous les récapitulatifs de stock disponibles avec tous les détails.

Tutoriel : Obtenir tous les récapitulatifs de stock disponibles qui ont changé

Obtenez tous les récapitulatifs de stock disponibles qui ont changé.

📘
`startDateTime` requis

Tutoriel : Obtenir des récapitulatifs de stock pour les SKU de vendeurs indiqués

Obtenez des récapitulatifs de stock avec des détails supplémentaires pour les SKU de vendeur indiqués.

Recommandation générale

NextToken dans GetInventorySummariesResponse

Pagination dans GetInventorySummariesResponse

Qu'est-ce que l'API Stock Expédié par Amazon ?

Comment utiliser l'API Stock Expédié par Amazon ?

🚧nextToken expirera dans 30 secondes

🚧Évitez les erreurs de pagination

Tutoriel : Obtenir tous les récapitulatifs de stock disponibles avec tous les détails disponibles

Obtenez tous les récapitulatifs de stock disponibles avec tous les détails.

Tutoriel : Obtenir tous les récapitulatifs de stock disponibles qui ont changé

Obtenez tous les récapitulatifs de stock disponibles qui ont changé.

📘startDateTime requis

Tutoriel : Obtenir des récapitulatifs de stock pour les SKU de vendeurs indiqués

Obtenez des récapitulatifs de stock avec des détails supplémentaires pour les SKU de vendeur indiqués.

Recommandation générale

NextToken dans GetInventorySummariesResponse

Pagination dans GetInventorySummariesResponse

🚧
`nextToken` expirera dans 30 secondes

🚧
Évitez les erreurs de pagination

📘
`startDateTime` requis