Каталог для ИИ-агентов

Прочитать и подобрать

• Весь каталог в JSON — GET /api/catalog. Ответ содержит все совпавшие модели и их варианты, без скрытой пагинации.
• Пример: нитрил, M, без пудры. Фильтры: material, brand, size, sterile, powder, special, color, pack, texture, accelerator, query. Используются те же значения и правила, что в каталоге; pack — число отдельных перчаток в упаковке, sterile — yes или no. all снимает отдельный фильтр. texture — точное значение из filter_options, accelerator=yes — только подтверждённое ACC-free, неизвестные свойства не проходят этот фильтр.
• Паспорт одной модели — GET /api/catalog/{model_id}. Содержит источники и даты проверки, размеры, фасовку и фото, когда оно подтверждено.
• Читаемый TXT-паспорт: GET /api/catalog/{model_id}/passport.txt. Постоянная ссылка доступна в text_passport_url; файл содержит только справочник, без корзины и реквизитов покупателя. Не используйте его как подтверждение поставки или документ соответствия.

model_id и variant_id — внутренние идентификаторы каталога, не артикулы производителя и не GTIN. Вариант обозначает модель и размер; ссылка открывает этот размер в карточке.

Найти конкретный размер по коду

В query можно передать полный артикул из variants.supplier_reference.article или подтверждённый variants.gtin. Например: GTIN 04699591111200 возвращает только размер M модели SFM в упаковке 10 штук. Полное совпадение кода не заменяется похожим товаром. Если фильтр размера противоречит коду, результат пустой.

supplier_reference содержит название поставщика, ссылку на его размерную карточку, дату проверки и фасовку. Это не артикул производителя и не SKU ООО «МАДЖЕСТИК». GTIN хранится строкой с ведущим нулём только при явном подтверждении источником. Не выводите GTIN из артикула, адреса страницы или соседнего размера. Код группы SFM и размерный код — разные сущности.

При вставке размерного кода в таблицу закупки размер остаётся отдельным обязательным полем. Несовпадение с кодом блокирует всю операцию до исправления. Автоматический заказ и запись на сервер не выполняются.

Рассчитать количество

Пример расчёта 2 000 пар размера M: GET /api/catalog/quantity?model_id=benovy-multicolor-white&size=M&quantity=2000&unit=pairs.

Единицы: pairs — пары, pieces — отдельные перчатки, packs — упаковки. Количество — положительное целое число. Расчёт возвращает целые упаковки, фактическое количество штук и пар и излишек при округлении вверх. Округление требует согласования покупателя. Предел расчёта — 100 000 упаковок одного размера; это технический предел, не минимальная партия и не остаток.

Расчёт не меняет корзину, не резервирует товар и не создаёт заказ. В карточках доступен такой же калькулятор с явной кнопкой применения количества.

Как понимать ответ

• null означает, что данные не подтверждены. Не трактуйте его как нулевую цену, отсутствие товара или отрицательное свойство.
• technical содержит дополнительные подтверждённые параметры части моделей: толщину по зонам, её нижнюю границу либо номинал с допуском, ACC-free и источник. Зоны finger, palm, middle_finger различаются; отсутствующий ключ зоны означает неподтверждённое значение. mass задаётся в граммах на одну перчатку (per: glove) с признаком нижней границы; это не масса пары или упаковки. shape: ambidextrous — на обе руки; cuff: beaded — манжета с валиком. technical.sources содержит размерные источники; дата относится к дополнительным параметрам, не ко всем данным модели. length.tolerance_mm — допуск длины. Не отбрасывайте квалификаторы измерений при сравнении.
• technical.manufacturer_model_reference при подтверждении имеет область model_group: это код группы модели в каталоге SFM, не артикул размера и не GTIN. Его можно искать целиком или вставить в столбец модели, но размер нужно указать отдельно. Размерные артикулы остаются null, пока не подтверждены.
• quote_required: true: цену, наличие, минимальный объём, документы и доставку нужно согласовать. Автоматического оформления и оплаты нет.
• Число пар — пересчёт количества перчаток. Индивидуальное парное исполнение и стерильность проверяются отдельно по характеристикам модели.
• При отсутствии совпадений возвращается пустой список; подмена материала, стерильности, размера или фасовки не выполняется. Другие модели не объявляются подтверждёнными аналогами.
• В подборе и расчёте ошибочные или повторяющиеся параметры дают HTTP 400, неизвестная модель паспорта — HTTP 404. Пустой корректный поиск — HTTP 200.

Подготовить запрос

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

Для нескольких позиций подготовьте таблицу из четырёх столбцов: model_id, size, quantity, unit, разделённых табуляцией или точкой с запятой. Покупатель может вставить её в сборщике спецификации, проверить соответствие моделей и объединить с черновиком. Используйте ID из текущего JSON-каталога, подтверждённый размер и единицы pairs, pieces, packs. Не подменяйте отсутствующую модель похожей без выбора покупателя.

Шаблон заголовка для вставки: Модель;Размер;Количество;Единица. До 60 строк. Это локальный импорт для проверки человеком, а не API создания заказа. Исходная потребность сохраняется; округление до упаковок подтверждается отдельно перед переносом в корзину.

Эти GET-интерфейсы выдают только справочник и расчёт; они не читают корзину и персональные данные. Действуют общие правила доступа сайта. Это собственный формат версии 1.0, а не подключение к торговым платформам или готовый WebMCP-интерфейс.