Inventário

Inventário da API vs octopart.com

Os dados de inventário retornados pela API podem diferir do que você vê em octopart.com. Há duas razões para isso:

• Data freshness – A API retorna inventário de feeds de dados de distribuidores ingeridos regularmente. octopart.com usa dados ativos de distribuidores para alguns distribuidores, o que pode refletir alterações de estoque mais recentes.

• Country defaulting – octopart.com detecta o país do usuário a partir do endereço IP e exibe ofertas apropriadas para a região. A API usa por padrão US se nenhum parâmetro country for especificado. Se você estiver consultando uma região fora dos EUA, sempre passe o parâmetro country explicitamente (e, opcionalmente, currency).

Consultando Dados de Inventário

As informações de inventário estão distribuídas em dois níveis da resposta:

• SupPart – os campos agregados totalAvail e avgAvail resumem o estoque de todos os vendedores

• SupOffer – o campo inventoryLevel fornece a quantidade em estoque para uma oferta específica de um vendedor específico

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

O campo updated em SupOffer mostra quando os dados de inventário foram recebidos pela última vez do feed do distribuidor, o que pode ajudar a avaliar a atualidade dos dados.

inventoryLevel Códigos Especiais

inventoryLevel normalmente retorna um inteiro não negativo que representa as unidades em estoque. Quando um distribuidor não pode fornecer uma quantidade exata, um código especial negativo é retornado:

totalAvail e avgAvail

totalAvail são a soma do estoque em todos os distribuidores; avgAvail é a média por distribuidor. Ambos os campos estão em SupPart.

O estoque de brokers afeta esses valores de uma forma específica: se nenhum distribuidor padrão tiver estoque, mas um ou mais brokers tiverem inventoryLevel > 0 ou inventoryLevel == -2, então totalAvail será definido como 1. A quantidade real do broker nunca é adicionada numericamente — apenas a presença de estoque do broker é sinalizada.

Isso significa que um totalAvail de 1 sem estoque de distribuidores padrão é um sinal para verificar ofertas de brokers, e não uma contagem literal de unidades.

Para distinguir distribuidores de brokers em seu aplicativo, use o campo isBroker em SupPartSeller:

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