Inventaire

Inventaire de l’API vs octopart.com

Les données d’inventaire renvoyées par l’API peuvent différer de ce que vous voyez sur octopart.com. Il y a deux raisons à cela :

• Data freshness – L’API renvoie l’inventaire à partir de flux de données de distributeurs ingérés régulièrement. octopart.com utilise des données distributeur en direct pour certains distributeurs, ce qui peut refléter des changements de stock plus récents.

• Country defaulting – octopart.com détecte le pays de l’utilisateur à partir de son adresse IP et affiche les offres adaptées à sa région. L’API utilise par défaut US si aucun paramètre country n’est spécifié. Si vous interrogez une région hors États-Unis, transmettez toujours explicitement le paramètre country (et éventuellement currency).

Interroger les données d’inventaire

Les informations d’inventaire sont réparties sur deux niveaux de la réponse :

• SupPart – les champs agrégés totalAvail et avgAvail résument le stock de tous les vendeurs

• SupOffer – le champ inventoryLevel indique la quantité en stock pour une offre spécifique d’un vendeur spécifique

query InventoryCheck {
  supSearchMpn(q: "LM358DR", limit: 2) {
    results {
      part {
        mpn
        totalAvail
        avgAvail
        sellers(includeBrokers: false) {
          company {
            name
          }
          isAuthorized
          offers {
            inventoryLevel
            updated
          }
        }
      }
    }
  }
}

Le champ updated sur SupOffer indique quand les données d’inventaire ont été reçues pour la dernière fois à partir du flux du distributeur, ce qui peut aider à évaluer la fraîcheur des données.

inventoryLevel Codes spéciaux

inventoryLevel renvoie normalement un entier positif ou nul représentant le nombre d’unités en stock. Lorsqu’un distributeur ne peut pas fournir une quantité exacte, un code spécial négatif est renvoyé à la place :

totalAvail et avgAvail

totalAvail correspond à la somme du stock de tous les distributeurs ; avgAvail est la moyenne par distributeur. Les deux champs se trouvent sur SupPart.

Le stock des courtiers affecte ces valeurs d’une manière particulière : si aucun distributeur standard n’a de stock mais qu’un ou plusieurs courtiers ont inventoryLevel > 0 ou inventoryLevel == -2, alors totalAvail est défini sur 1. La quantité réelle du courtier n’est jamais ajoutée numériquement ; seule la présence d’un stock chez un courtier est signalée.

Cela signifie qu’une valeur totalAvail de 1 sans stock chez un distributeur standard est un signal indiquant qu’il faut vérifier les offres des courtiers plutôt qu’un nombre d’unités littéral.

Pour distinguer les distributeurs des courtiers dans votre application, utilisez le champ isBroker sur SupPartSeller :

sellers(includeBrokers: true) {
  company { name }
  isAuthorized
  isBroker
  offers {
    inventoryLevel
  }
}