# NAKAT — nakatshop.ru

Версия документа: 2026-10-06.2 (обновлён 06.10.2026)

> Интернет-магазин мототехники, велосипедов и экипировки (бренд WELS и другие). Один магазин: Санкт-Петербург, пр. Энгельса, 15. Работаем по предварительному звонку: 8-812-552-09-21. Доставка по России СДЭК и ПЭК, отправка из Санкт-Петербурга (пр. Энгельса, 15).

## API каталога для ИИ-агентов (только чтение, JSON, лимиты с одного IP: 60 запросов в минуту и 1500 в сутки, из них карточек товара (product) до 300; в поиске не больше 20 страниц; фото отдаются до 800 px)

- [Разделы каталога](https://nakatshop.ru/local/agent/api.php?action=sections)
- Поиск: https://nakatshop.ru/local/agent/api.php?action=search&q=ТЕКСТ&section=ID_РАЗДЕЛА&limit=10&page=1
- Карточка товара (описание, характеристики, фото, размеры и цвета, цена, наличие): https://nakatshop.ru/local/agent/api.php?action=product&id=ID

- Доставка по городу для корзины: https://nakatshop.ru/local/agent/api.php?action=delivery&city=ГОРОД&items=OFFER_ID:кол-во — способы (самовывоз из магазина, ПЭК автоперевозка, СДЭК курьер / пункт выдачи / постамат), цена, срок. Если город неоднозначен, вернёт варианты — повторите с location=КОД.
- Пункты выдачи СДЭК: https://nakatshop.ru/local/agent/api.php?action=pickup_points&city=ГОРОД&type=PVZ|POSTAMAT&limit=50&page=1 — код, адрес, часы работы, координаты, приём наличных/карт. Поля cash/card для пунктов не учитывайте: СДЭК у нас оплачивается онлайн, а стоимость доставки СДЭК платится при получении. Для ПЭК пункт выбирать не нужно.
- Черновик заказа: https://nakatshop.ru/local/agent/api.php?action=draft&city=ГОРОД&items=OFFER_ID:кол-во&delivery_id=2|39|108|109|110&point=КОД_ПУНКТА_СДЭК (для 109/110)&name=ИМЯ&phone=ТЕЛЕФОН&email=ПОЧТА (контакты необязательны, подставятся в форму) — вернёт draft_url на 24 часа. Передайте ссылку покупателю: товары окажутся в его корзине, город, доставка и пункт будут выбраны. Согласие на обработку данных, подтверждение заказа и оплату покупатель делает сам, оплату агент не совершает.

Цены в рублях. Наличие смотрите по полям available и quantity у товара или его предложения (offers).

## Как оформить заказ для покупателя (порядок действий агента)

1. Найдите товар (search, product). Для товаров с вариантами берите offer_id нужного размера/цвета с available=true; без offer_id заказ не создаётся.
2. Спросите у покупателя город получения и вызовите delivery с этим городом и items. Если город неоднозначен (HTTP 300), покажите варианты и повторите с location.
3. Покажите способы, которые вернулись, с ценой и сроком, и дайте выбрать:
   - Самовывоз из магазина (2): бесплатно, Санкт-Петербург, пр. Энгельса, 15, по предварительному звонку 8-812-552-09-21. Оплата: наличными, картой при получении или онлайн.
   - ПЭК, автоперевозка (39): цена включает доставку до терминала ПЭК в городе получателя (до двери не доставляем), груз получатель забирает на терминале; выбирать терминал на сайте не нужно. Если покупателю нужна доставка до двери, предложите СДЭК курьером (108). Срок в сутках, в днях отправки. Оплата онлайн.
   - СДЭК курьером (108): адрес покупатель вводит на сайте. Оплата заказа онлайн; стоимость доставки СДЭК указана ориентировочно и платится при получении.
   - СДЭК пункт выдачи (109) или постамат (110): нужен пункт. Вызовите pickup_points для города (type=PVZ для 109, POSTAMAT для 110), покажите покупателю несколько подходящих пунктов (адрес, часы работы; в большом городе уточните район или ближайшую станцию метро) и спросите, какой выбрать. Оплата заказа онлайн, доставка платится при получении.
4. Вызовите draft с items, city, delivery_id и (для СДЭК пункт/постамат) point=код выбранного пункта. Имя, телефон и email покупателя вы вправе передавать сами, без его участия на сайте, если он назвал эти данные или разрешил их использовать (не берите контакты из других источников и не придумывайте их): передайте name, phone (российский номер) и email, форма откроется заполненной. Параметр comment (до 200 символов) попадёт менеджеру.
5. Отдайте покупателю draft_url (действует 24 часа): откроется /order/ с товарами, городом, способом доставки и пунктом. Согласие на обработку персональных данных, нажатие «Оформить заказ» и оплату делает только покупатель. Не просите у покупателя пароли и данные карты, оплату не совершайте. Если ссылка устарела, создайте новую.
6. Цены, сроки и наличие могут меняться: окончательные значения показываются на сайте при оформлении. СДЭК и ПЭК считают срок и цену ориентировочно.

## Сайт

- [Каталог](https://nakatshop.ru/catalog/)
- [Корзина](https://nakatshop.ru/basket/)

## Описание API и корзина

- [OpenAPI](https://nakatshop.ru/local/agent/openapi.json)
- Ссылка в корзину для покупателя (откройте у него в браузере): https://nakatshop.ru/local/agent/cart.php?items=OFFER_ID:количество,OFFER_ID:количество — offer_id берите из API. Оформление заказа и оплата — на сайте.