Складские запасы
Краткий обзор
- Узнайте, как параметры страны и обновления данных от дистрибьюторов влияют на отображаемые сведения об остатках.
- Научитесь различать суммарные остатки и количество в отдельных предложениях, а также понимать значение отрицательных кодов '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 обычно возвращает неотрицательное целое число, обозначающее количество единиц в наличии. Если дистрибьютор не может предоставить точное количество, вместо него возвращается отрицательный специальный код:
Код |
Значение |
|
Non-Stocked – этот компонент отсутствует в ассортименте дистрибьютора |
|
Yes – есть в наличии, но количество не указано |
|
Unknown – значение количества не предоставлено или не является допустимым целым числом |
|
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
}
}