e-suppy

List Servers

Список подключённых источников и что каждый из них умеет. Вызывать первым и при сомнениях. Набор инструментов при подключении нового источника не меняется — меняется этот список, поэтому он и есть источник правды о том, что доступно сейчас. Поле kind различает официальный MCP вендора и нашу обёртку над его API: у обёртки нет обязательств вендора, и она живёт до изменения его API.

Search Products

Найти товары в магазине. Возвращает цены, фасовку и product_id.

Product Details

Детали товара: бренд, цена, фасовка.

Find By Barcode

Найти товар по штрихкоду. Точный ключ: совпавший EAN-13 — единственное сопоставление товара между магазинами, которое не требует ни порога уверенности, ни разметки.

List Discounts

Акционные товары магазина.

Create Cart

Собрать корзину и получить ссылку на неё. Это завершение покупки со стороны роутера. Дальше пользователь открывает ссылку и оформляет заказ в магазине сам: роутер не принимает оплату и не подтверждает заказ за него. Состав корзины показать пользователю до того, как отдавать ссылку.

Clean Address

Привести адрес к стандартному виду: индекс, регион, улица, координаты. Нужен перед расчётом доставки: по «мск тверская 7» тариф не посчитает никто. Поле quality = 0 означает, что адрес распознан уверенно; иное значение — повод показать результат человеку до оформления заказа.

Find Company

Найти организацию или ИП по ИНН либо ОГРН. Поле status показывает, действует ли организация: перед сделкой с юрлицом это стоит проверять, а не предполагать.

Currency Rate

Официальный курс Банка России к рублю. Часть валют котируется за несколько единиц: лира — за десять, иена — за сто. Поле rate уже приведено к одной единице, value и nominal оставлены как их публикует ЦБ.

Estimate Delivery

Стоимость и сроки доставки по доступным тарифам. Адреса сначала приводятся к стандартному виду, дальше в службу уходит только индекс: по «мск тверская 7» тариф не считает никто, а квартира и имя для расчёта не нужны. Отправление не создаётся — это только расчёт. Поле complete говорит, полон ли список тарифов: он зависит от договора с перевозчиком, и молчать об этом нельзя, иначе сравнение служб будет врать.