Inventario

Inventario API vs octopart.com

I dati di inventario restituiti dall'API possono differire da quelli visualizzati su octopart.com. Ci sono due motivi:

• Data freshness – L'API restituisce l'inventario dai feed di dati dei distributori acquisiti regolarmente. octopart.com utilizza dati live dei distributori per alcuni distributori, che possono riflettere variazioni di stock più recenti.

• Country defaulting – octopart.com rileva il paese dell'utente dal suo indirizzo IP e mostra offerte appropriate per la regione. L'API usa come impostazione predefinita US se non viene specificato alcun parametro country. Se stai eseguendo una query per una regione non USA, passa sempre esplicitamente il parametro country (e facoltativamente currency).

Interrogazione dei dati di inventario

Le informazioni di inventario sono distribuite su due livelli della risposta:

• SupPart – i campi aggregati totalAvail e avgAvail riepilogano lo stock di tutti i venditori

• SupOffer – il campo inventoryLevel indica la quantità di stock per un'offerta specifica di un venditore specifico

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

Il campo updated in SupOffer mostra quando i dati di inventario sono stati ricevuti l'ultima volta dal feed del distributore, il che può aiutare a valutarne l'aggiornamento.

inventoryLevel Codici speciali

inventoryLevel normalmente restituisce un numero intero non negativo che rappresenta le unità disponibili in stock. Quando un distributore non può fornire una quantità esatta, viene invece restituito un codice speciale negativo:

totalAvail e avgAvail

totalAvail è la somma dello stock di tutti i distributori; avgAvail è la media per distributore. Entrambi i campi si trovano in SupPart.

Lo stock dei broker influisce su questi valori in modo specifico: se nessun distributore standard ha stock ma uno o più broker hanno inventoryLevel > 0 o inventoryLevel == -2, allora totalAvail viene impostato su 1. La quantità effettiva del broker non viene mai aggiunta numericamente: viene solo segnalata la presenza di stock presso broker.

Ciò significa che un valore totalAvail di 1 in assenza di stock presso distributori standard è un segnale per controllare le offerte dei broker piuttosto che un conteggio letterale delle unità.

Per distinguere i distributori dai broker nella tua applicazione, utilizza il campo isBroker in SupPartSeller:

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