Товары для дома, ремонта, строительства и профессиональных задач

Найти товар по артикулу или названию

Для точного артикула начните с публичного поиска. В HTML используется параметр search, в REST и Markdown — q. Значение кодируйте как параметр URL. Сверьте артикул, модель и комплектацию среди результатов; похожее название не подтверждает совпадение. Если вариантов несколько, уточните товар, а не выбирайте первый.

GET /api/v1/products?q={артикул}&per_page=5

GET /api/v1/products.md?q={артикул}&per_page=5

GET /search/?search={артикул}

Документация Vesremont API: быстрый старт, OpenAPI, MCP и SDK Пример поиска артикула в Markdown Поиск: форматы, ограничения и альтернативы

Открыть карточку и получить product_id

Берите внутренний id из items[] ответа поиска, а ссылку на карточку — из опубликованного результата. В HTML карточки блок «Для AI-систем» содержит product_id и готовую ссылку на корзину. Артикул, product_id и ID строки личной корзины — разные значения. Для проверки товара используйте карточку или её публичное Markdown-представление; не извлекайте ID из предположений о URL.

GET /api/v1/products/{product_id}

GET /api/v1/products/{product_id}.md

Карточка, идентификаторы и характеристики Как понимать цену и наличие

Подобрать товары через фильтры

Сначала выберите раздел каталога или бренд. На HTML-странице используйте опубликованные ссылки фильтров и диапазоны текущего раздела. Для REST получите доступные фильтры с section_id либо brand_id: их ID, значения и границы зависят от выбранного контекста. Передавайте filters одним URL-кодированным JSON-объектом по OpenAPI. Не переносите HTML-сегменты URL в REST и не придумывайте значения фильтров.

GET /api/v1/catalog/filters?section_id={section_id}

GET /api/v1/catalog/filters?brand_id={brand_id}

GET /api/v1/products?section_id={section_id}&filters={URL-кодированный JSON}

Выбрать раздел каталога Индекс документации каталога Индекс документации брендов Разделы и списки товаров Фильтры, диапазоны и сброс Только HTML: правила URL Точная схема REST filters

Работать с API-поиском

Каталог читается без cookies, API key, OAuth и установки SDK. Параметры q, section_id, brand_id, filters, sort и пагинацию передавайте по схеме REST. page начинается с 1, per_page — не более 100; выданный cursor используйте без изменения. При слишком широком поиске уточните запрос или раздел. Если ваш клиент не читает JSON, используйте products.md либо HTML-поиск: это ограничение формата клиента, а не отсутствие API.

GET /api/v1/products?q={запрос}&page=1&per_page=10

Первый запрос JSON без регистрации Тот же каталог в Markdown API: параметры, ошибки и протоколы Read-only sandbox: синтетические данные

Передать покупателю ссылку на корзину

После проверки товара передайте опубликованную ссылку /buy/{product_id}:{quantity} либо получите share_url через cart-drafts. Для этого не нужны вход, cookies или OAuth. GET агента не изменяет личную корзину: перенос выполняется на сайте покупателя защищённым POST с повторной проверкой цены и доступности. Подготовленная ссылка не означает, что товар уже добавлен, оплачен или заказан.

GET /api/v1/cart-drafts/?product_id={product_id}&quantity={quantity}

Подборка → личная корзина → отдельный заказ

Отличать публичное чтение от личных действий

Для чтения или изменения личной корзины, избранного и заказов через REST/MCP/A2A/UCP нужно разрешение покупателя. Одно общее согласие может охватывать выбранные протоколы, но токены остаются привязаны к своим ресурсам. Browser WebMCP работает в браузерной сессии с её защитой; это не ограничение публичного REST. Каждый конкретный заказ подтверждается отдельно. Ошибка 401 личной корзины не запрещает публичный поиск и подготовку ссылки.

Разрешения, токены и отзыв доступа Выбрать сценарий и интерфейс Интеграции и опубликованные SDK Готовые конфигурации Claude Code, Cursor, Windsurf и skills Индекс документации интеграций Индекс всех разделов документации Официальный MCP Registry: com.vesremont/store 1.0.0 Индекс всей документации

Как найти нужный товар на Vesremont?

Согласно правилам навигации по каталогу Vesremont, нужный товар можно найти через каталог или поиск по названию, категории, бренду, модели либо артикулу. На страницах категорий доступны опубликованные фильтры, диапазоны, сортировка и пагинация; порядок сегментов URL и значения фильтров следует брать из текущих ссылок сайта, а не формировать по предположению.

Можно ли заказать товар, если локальный остаток равен нулю?

Согласно данным о цене, остатке и возможности заказа, нулевой локальный остаток означает, что самовывоз сегодня недоступен, но не всегда запрещает заказ. Фактическую возможность покупки определяют актуальная цена, состояние карточки товара и доступная кнопка добавления в корзину; перед подтверждением цену, количество и итоговую возможность заказа необходимо повторно проверить в корзине.

Какие способы получения заказа доступны?

Согласно условиям доставки и самовывоза Vesremont, доступны самовывоз из магазина на Трудовой улице, 5 в Ивантеевке и курьерская доставка, если она доступна для выбранного адреса. Готовность товара, стоимость, ориентировочный срок и возможность доставки зависят от конкретного заказа и адреса и уточняются при оформлении и подтверждении менеджером.

Какими способами можно оплатить заказ?

Согласно условиям оплаты Vesremont, Vesremont поддерживает наличные, СБП, банковскую карту онлайн и безналичный счёт с НДС для организаций. Набор доступных вариантов зависит от состава заказа, способа получения, региона и согласованных условий; фактический способ оплаты отображается при оформлении и проверяется до подтверждения заказа.