Руководство по коннектору6 мин чтенияMCP-инструментов: 167 языков

Éxito MCP-сервер: товары, предложения и заказы

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, задавай цены и остатки, читай заказы и выписки о выплатах.

HCАвтор: команда HelpCodeОбновлено 6 мин чтения Открытый код на GitHub

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Grupo Éxito Marketplace

Grupo Éxito Marketplace

Let your AI run your exito.com marketplace store in Colombia through Grupo Éxito's seller API: list your products and their approval status, create products with images, descriptions and attributes, set prices and stock, and read orders and payout statements.

инструментов

16

Регион

INTL

Категория

Электронная коммерция

Аутентификация

Sign-in token

Требуемые env-vars

EXITO_USERNAMEEXITO_PASSWORDEXITO_API_KEYEXITO_LOGIN_URLEXITO_SELLER_ID
Установить в Cloud одним кликом

7 дней бесплатно · Без карты

  • 7 дней бесплатно
    Без банковской карты
  • GDPR и готовность к SOC 2
    Данные в ЕС, журналы аудита
  • Открытый код на GitHub
    Open source · AGPL-3.0
  • Работает с ChatGPT, Claude, Gemini
    Любой MCP-совместимый клиент

Кратко

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, задавай цены и остатки, читай заказы и выписки о выплатах.

Пошаговая настройка

Подключи Grupo Éxito Marketplace к Claude, ChatGPT или Copilot за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи Grupo Éxito Marketplace в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Попробуй спросить

Примеры промптов для Grupo Éxito Marketplace

Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.

Grupo Éxito Marketplace · live via MCP
Поделиться
Opus 4.7

Claude — это AI, он может ошибаться. Проверяйте ответы.

💡 Не хочешь ничего устанавливать? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Grupo Éxito Marketplace, вставь свои учётные данные, создай API-ключ MCP — и готово. Без Docker, без git clone, без локального сервера.

Grupo Éxito Marketplace

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, задавай цены и остатки, читай заказы и выписки о выплатах.

Настройка

Настройка занимает около 10 минут после того, как Éxito предоставит тебе доступ к API. Вместе с доступом Éxito присылает инструкции по аутентификации: имя пользователя, пароль, API-ключ и адрес, по которому выдаётся токен. Также тебе понадобится числовой идентификатор продавца.

Песочницы нет: Éxito её не документирует, поэтому каждый вызов, включая запись, действует на твой реальный магазин.

  1. Вставь пользователя API (адрес электронной почты) в EXITO_USERNAME, а пароль API — в EXITO_PASSWORD; оба значения возьми из инструкций Éxito.
  2. Вставь x-api-key из тех же инструкций в EXITO_API_KEY.
  3. Вставь полный адрес запроса токена, начинающийся с https://, в EXITO_LOGIN_URL. Он не опубликован на developers.exito.com, поэтому скопируй его из документа, который прислал Éxito.
  4. Укажи свой числовой идентификатор продавца (idSeller, например 11795) в EXITO_SELLER_ID. exito_marketplace_get_bulk_upload_status также показывает его как data.idSeller.
  5. Установи коннектор. Запусти exito_marketplace_list_categories, чтобы проверить подключение.

Как происходит вход: коннектор запрашивает токен по адресу выдачи токена, используя твоё имя пользователя, пароль и API-ключ, и отправляет его вместе с API-ключом при каждом вызове. Токены обновляются автоматически, самое позднее — раз в час. Пароль и ключ хранятся в зашифрованном виде и никогда не показываются ИИ.

В облаке и при самостоятельном хостинге всё работает одинаково: учётные данные те же, а redirect URL настраивать не нужно.

Продажи на Éxito асинхронны:

  1. Выбери самую точную категорию с помощью exito_marketplace_list_categories и прочитай её характеристики через exito_marketplace_get_category_features. Обязательные характеристики нужно передавать; характеристика со списком значений принимает только их.
  2. Создавай товары с помощью exito_marketplace_create_products, до 400 EAN за вызов. Изображения — это публичные URL размером 1000x1000 px (733x1000 px для одежды). Бренд уже должен существовать в Éxito; отсутствующий бренд создаёт твой аккаунт-менеджер в Éxito.
  3. Отслеживай пакет через exito_marketplace_get_bulk_upload_status. Пока предыдущий пакет запускается или обрабатывается, новый не принимается.
  4. Контент-команда Éxito проверяет каждый товар. exito_marketplace_get_products_waiting показывает товары на проверке, exito_marketplace_get_products_rejected — отклонённые с указанием причины, а exito_marketplace_get_products_pending_seller_approval — те, что отличаются от такого же товара, уже представленного на маркетплейсе. После одобрения товару требуется до часа, прежде чем для него можно создать предложение.
  5. Задай одобренным товарам цену и остаток через exito_marketplace_upsert_offers или, для одного EAN, через exito_marketplace_update_offer_price_stock. exito_marketplace_load_products_and_offers отправляет товары и предложения одним запросом. Предложения появляются на сайтах примерно в течение 4 часов.

Цены и остатки: цены — целые колумбийские песо больше 8000, без разделителей (45000). Цена со скидкой должна быть ниже обычной цены. Чтобы изменить только цену, отправь текущий остаток с IsUpdatedStock 0. Изменение цены более чем на 30% возвращается с кодом PEX и должно быть отправлено повторно с подтверждением цены: перед этим ИИ спросит тебя. Чтобы прекратить продажу товара, установи его остаток в 0: удаления в API нет.

Заказы и выплаты: exito_marketplace_get_orders показывает заказы с exito.com, carulla.com и других сайтов Éxito со статусом, суммами, комиссией и типом доставки. exito_marketplace_get_bills показывает выписки о выплатах. Списки листаются с помощью paginationToken.

Отключено при установке: exito_marketplace_set_order_tracking (отметить товары заказа как отправленные с указанием перевозчика и трек-номера) и exito_marketplace_upload_order_invoice (прикрепить счёт к заказу). Включи их на странице коннектора, если ИИ должен работать с заказами; ИИ попросит тебя подтвердить каждый вызов. Создание товаров и установка цен и остатков включены (exito_marketplace_create_products, exito_marketplace_load_products_and_offers, exito_marketplace_upsert_offers, exito_marketplace_update_offer_price_stock).

Читай каждый ответ: пакетные операции записи отвечают HTTP 200 с отдельным сообщением по каждому отклонённому EAN, поэтому код 200 не означает, что все товары или предложения приняты. Запросы и ответы — на испанском языке.

Не охвачено: транспортные этикетки, модерация Éxito и уведомления о предложениях, а также всё, что веб-приложение Seller Center умеет, а API не предоставляет.

Частые ошибки: если токен не выдаётся, сверь имя пользователя, пароль и API-ключ с инструкциями Éxito и убедись, что EXITO_LOGIN_URL — это адрес токена из этого документа. 401 означает, что токен отклонён. 403 обычно означает, что API-ключ отсутствует или указан неверно либо API не включён для твоего пользователя: уточни у Éxito, какие API входят в твой доступ.

Требования: EXITO_USERNAME, EXITO_PASSWORD, EXITO_API_KEY, EXITO_LOGIN_URL, EXITO_SELLER_ID

Локальная установка коннектора

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Открой http://localhost:3000/connectors/store, выбери Grupo Éxito Marketplace и вставь переменные окружения, перечисленные в разделе «Требования».

Доступные инструменты

ToolWhat it does
exito_marketplace_get_productsСписок товаров продавца на маркетплейсе Éxito с названием, EAN, VTEX PLU, изображением, датами создания и обновления, ценой, ценой со скидкой, остатком…
exito_marketplace_get_products_waitingТовары, ожидающие одобрения контент-командой Éxito (модерация), с EAN, названием, изображением, датой обработки и родительской ссылкой
exito_marketplace_get_products_rejectedТовары, отклонённые контент-командой Éxito и требующие исправления, с EAN, названием, изображением, причиной (Reason) и комментарием (Comment) к отклонению
exito_marketplace_get_products_pending_seller_approvalТовары, по которым нужно твоё решение, так как они отличаются от такого же товара, уже представленного на маркетплейсе: в каждой строке есть oldProduct и…
exito_marketplace_get_bulk_upload_statusСтатус последнего пакета создания товаров (exito_marketplace_create_products). data.status: 4 запускается, 1 обрабатывается, 2 завершён…
exito_marketplace_list_categoriesВсе категории маркетплейса Éxito с Id, IdParent, Name и ProductType (Technology или Clothing)
exito_marketplace_get_categoryОдна категория по идентификатору: Id, IdParent, Name и ProductType
exito_marketplace_get_category_featuresГруппы характеристик категории: для каждой характеристики specName, label, признак обязательности и допустимые значения (values[].label; an…
exito_marketplace_get_ordersЗаказы, полученные через сайты Éxito (exito.com, carulla.com и другие), с номером заказа, каналом, датами, статусом, суммами, комиссией…
exito_marketplace_get_billsВыписки о выплатах (биллинг) продавца: номер счёта, номер заказа, платёжное поручение, назначение, дата платежа, комиссия, итог, IVA и…
exito_marketplace_create_productsСоздание товаров (или изменение существующих: отправь тот же EAN повторно; ModifyImage "1" заменяет изображения) с названием, HTML-описанием…
exito_marketplace_load_products_and_offersОтправка товаров вместе с их предложениями одним запросом: каждый элемент содержит Product (поля exito_marketplace_create_products) и…
exito_marketplace_upsert_offersСоздание или обновление предложений (цена, цена со скидкой, остаток, доставка и срок доставки) для EAN, уже одобренных Éxito, на всех сайтах Éxito…
exito_marketplace_update_offer_price_stockИзменение цены и/или остатка одного существующего предложения (один EAN). Éxito требует EAN, Stock и Price при каждом обновлении: чтобы изменить только цену…
exito_marketplace_set_order_trackingОтметить товары заказа как отправленные с указанием перевозчика и трек-номера (заказы со стандартной доставкой)
exito_marketplace_upload_order_invoiceПрикрепить счёт к заказу в виде PDF или ZIP в формате base64

Примеры запросов

  • "Какие из моих товаров отклонил Éxito и почему?"
  • "Покажи заказы, назначенные мне на этой неделе, которые ещё нужно отправить."
  • "Какая цена и остаток у EAN 7701234567890 на exito.com?"
  • "Установи остаток EAN 7701234567890 в 25 единиц и оставь цену прежней."
  • "Подсчитай сумму комиссии в моих выписках о выплатах за октябрь."

Дальнейшие шаги

Это руководство помогло?

Подключи Grupo Éxito Marketplace к Claude, ChatGPT или Copilot за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи Grupo Éxito Marketplace в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.

Похожие руководства

Коннекторы

Подключить Éxito к ChatGPT через MCP: цены и остатки

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.

Коннекторы

Подключить Éxito к Claude через MCP: товары и заказы

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.

Коннекторы

Подключить Éxito к Microsoft Copilot через MCP

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.

Коннекторы

Подключить Éxito к Cursor через MCP: загрузка каталога

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.

Коннекторы

Подключить Éxito к Gemini CLI через MCP: заказы

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.

Коннекторы

Подключить Éxito к Meta Muse через MCP: заказы магазина

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.