Складские запасы

Краткий обзор

Узнайте, почему данные об остатках, полученные через API, могут отличаться от данных на octopart.com и как интерпретировать сведения о наличии, возвращаемые в ответах на ваши запросы. В этой статье рассматриваются актуальность данных, настройки страны по умолчанию, поля остатков на уровне компонентов и отдельных предложений, специальные коды наличия, а также влияние предложений брокеров на суммарные показатели. Читайте дальше, чтобы увереннее интерпретировать результаты запросов об остатках.

- Узнайте, как параметры страны и обновления данных от дистрибьюторов влияют на отображаемые сведения об остатках.
- Научитесь различать суммарные остатки и количество в отдельных предложениях, а также понимать значение отрицательных кодов 'inventoryLevel'.
- Разберитесь, когда 'totalAvail' указывает на наличие у брокеров, а не на фактическое количество единиц, и как распознавать предложения брокеров.
Узнайте больше с ИИ:

Данные о запасах в API и на octopart.com

Данные о запасах, возвращаемые API, могут отличаться от данных на octopart.com. Это объясняется двумя причинами:

  • Data freshness – API возвращает данные о запасах из регулярно загружаемых фидов дистрибьюторов. octopart.com для некоторых дистрибьюторов использует данные в реальном времени, которые могут отражать более свежие изменения запасов.

  • Country defaulting – octopart.com определяет страну пользователя по IP-адресу и показывает предложения для соответствующего региона. Если параметр country не указан, API по умолчанию использует US. Если вы запрашиваете данные для региона за пределами США, всегда явно передавайте параметр country (и при необходимости currency).

Запрос данных о запасах

Информация о запасах представлена на двух уровнях ответа:

  • SupPart – агрегированные поля totalAvail и avgAvail содержат сводные данные о запасах у всех продавцов

  • SupOffer – поле inventoryLevel содержит количество в наличии для конкретного предложения конкретного продавца

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

Поле updated в SupOffer показывает, когда данные о запасах были в последний раз получены из фида дистрибьютора, что помогает оценить их актуальность.

inventoryLevel Специальные коды

inventoryLevel обычно возвращает неотрицательное целое число, обозначающее количество единиц в наличии. Если дистрибьютор не может предоставить точное количество, вместо него возвращается отрицательный специальный код:

Код

Значение

-1

Non-Stocked – этот компонент отсутствует в ассортименте дистрибьютора

-2

Yes – есть в наличии, но количество не указано

-3

Unknown – значение количества не предоставлено или не является допустимым целым числом

-4

RFQ – обратитесь к дистрибьютору для получения ценового предложения

totalAvail и avgAvail

totalAvail — сумма запасов у всех дистрибьюторов; avgAvail — среднее количество на одного дистрибьютора. Оба поля находятся в SupPart.

Запасы брокеров влияют на эти значения особым образом: если ни у одного обычного дистрибьютора нет запасов, но у одного или нескольких брокеров указано inventoryLevel > 0 или inventoryLevel == -2, то для totalAvail устанавливается значение 1. Фактическое количество у брокера никогда не прибавляется к сумме — обозначается только сам факт наличия запасов у брокера.

Это означает, что значение 1 в поле totalAvail при отсутствии запасов у обычных дистрибьюторов — сигнал проверить предложения брокеров, а не буквальное количество единиц.

Чтобы отличать дистрибьюторов от брокеров в вашем приложении, используйте поле isBroker в SupPartSeller:

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

 

AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Contents
Contents