Inventario

Inventario de la API vs octopart.com

Los datos de inventario devueltos por la API pueden diferir de lo que ve en octopart.com. Hay dos razones para ello:

• Data freshness – La API devuelve inventario a partir de fuentes de datos de distribuidores ingeridas regularmente. octopart.com utiliza datos en vivo de distribuidores para algunos distribuidores, lo que puede reflejar cambios de stock más recientes.

• Country defaulting – octopart.com detecta el país del usuario a partir de su dirección IP y muestra ofertas adecuadas para su región. La API usa por defecto US si no se especifica ningún parámetro country. Si está consultando una región fuera de EE. UU., pase siempre el parámetro country explícitamente (y, de forma opcional, currency).

Consulta de datos de inventario

La información de inventario se distribuye en dos niveles de la respuesta:

• SupPart – los campos agregados totalAvail y avgAvail resumen el stock de todos los vendedores

• SupOffer – el campo inventoryLevel indica la cantidad en stock para una oferta específica de un vendedor específico

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

El campo updated en SupOffer muestra cuándo se recibió por última vez la información de inventario desde la fuente de datos del distribuidor, lo que puede ayudar a evaluar la actualidad de los datos.

inventoryLevel Códigos especiales

inventoryLevel normalmente devuelve un entero no negativo que representa las unidades en stock. Cuando un distribuidor no puede proporcionar una cantidad exacta, se devuelve en su lugar un código especial negativo:

totalAvail y avgAvail

totalAvail es la suma del stock de todos los distribuidores; avgAvail es el promedio por distribuidor. Ambos campos están en SupPart.

El stock de brokers afecta estos valores de una forma específica: si ningún distribuidor estándar tiene stock, pero uno o más brokers tienen inventoryLevel > 0 o inventoryLevel == -2, entonces totalAvail se establece en 1. La cantidad real del broker nunca se suma numéricamente; solo se indica la presencia de stock del broker.

Esto significa que un valor de totalAvail de 1, sin stock de distribuidores estándar, es una señal para revisar las ofertas de brokers en lugar de interpretarlo como un recuento literal de unidades.

Para distinguir entre distribuidores y brokers en su aplicación, utilice el campo isBroker en SupPartSeller:

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