Кратко
Веб-сервисы Spartoo marketplace для продавцов: заказы с деталями клиента и доставки, принятие и отправка заказов с номером отслеживания, возвраты, статус продукта на сайте и обновления запасов по размеру. Код партнера в качестве поля формы, XML ответы читаются как JSON.
Пошаговая настройка
Подключи Spartoo Marketplace к Claude, ChatGPT или Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Spartoo Marketplace в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Spartoo Marketplace
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Spartoo Marketplace, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Spartoo Marketplace
Веб-сервисы Spartoo marketplace для продавцов: заказы с деталями клиента и доставки, принятие и отправка заказов с номером отслеживания, возвраты, статус продукта на сайте и обновления запасов по размеру. Код партнера в качестве поля формы, XML ответы читаются как JSON.
Настройка
Настройка занимает около 3 минут.
- Войди в бэк-офис Spartoo marketplace и открой Документацию, затем Веб-сервисы и любую страницу сервиса, например, Экспорт заказов.
- Строка Webservice URL указывает адрес веб-сервиса твоего сайта Spartoo, например,
https://sws.spartoo.euилиhttps://sws.spartoo.it. Помести часть перед/mp/вSPARTOO_HOST. - На той же странице строка
partnerпоказывает твой уникальный код, когда ты вошел в систему. Помести его вSPARTOO_PARTNER_KEY. Если на странице нет кода, спроси своего контактного лица в Spartoo marketplace о коде веб-сервиса твоего аккаунта.
С чего начать: spartoo_list_orders с начальной датой. spartoo_get_order считывает один заказ по его id.
Заказы: заказ приходит в статусе 11 (подтвержден). spartoo_accept_order переводит его в 2 (в подготовке): после этого его имя, адрес и перевозчик больше не могут изменяться. spartoo_ship_order переводит его из 2 в 3 (отправлен) с номером отслеживания перевозчика, и Spartoo отправляет клиенту ссылку для отслеживания по электронной почте. spartoo_cancel_order (статус 41) установлен в выключенном состоянии: клиенту возвращаются деньги, и это нельзя отменить. Статусы 45 (посылка потеряна) и 47 (посылка не доставлена) устанавливаются Spartoo.
Возвраты: spartoo_list_returns и spartoo_get_return. Один возврат содержит один продукт. Статусы возвратов: 2 ожидает получения, 3 отказано, 4 посылка получена и возврат принят, 5 оплачено, 7 возврат, 14 ожидает предоплаченной этикетки возврата от продавца. Этот коннектор не принимает и не отказывает в возвратах.
Продукты и запасы: spartoo_check_product_status сообщает, находится ли продукт на сайте (OK), отсутствует на складе (OS), создан, но еще не в сети (EC) или неизвестен (KO), с указанием причины. spartoo_update_stock устанавливает запас одного размера. Оба используют твои собственные ссылки: reference_partenaire — это продукт в одном цвете, size_reference — один размер этого продукта. Запас 0 убирает размер с сайта.
Примечания к полям
- Идентификаторы заказов и возвратов — это короткие коды, такие как
90D813EA1A2365A8. - Фильтр даты заказа записывается как
YYYY-MM-DD:hh:mm:ssс двоеточием между днем и часом. Фильтр даты возврата — это Unix временная метка в секундах. Spartoo не документирует часовой пояс. - Цены — это десятичные числа в валюте сайта заказа;
products_final_price— это цена за единицу со скидкой, умноженная на количество. - Заказ для пункта выдачи имеет
relay_infoвместо адреса доставки. - Текстовые значения приходят как строки, включая числа. Один заказ или продукт в списке приходит как объект, несколько — как массив.
Ошибки: каждый ответ содержит код. 1 означает отсутствие ошибки. -1 и -2: код партнера отсутствует или неизвестен. -3: дата или id отсутствуют. -4: неверный формат даты. -6 и -28: заказ или возврат не найдены. -8: номер отслеживания отклонен. -9: у заказа уже есть этот статус. -19: неверный порядок статусов (2 только из 11, 3 только из 2). -14: продукт не найден. -16, -18 и -20: запас не изменен (невозможно, уже это значение или размер больше не действителен). -30: заказ слишком стар для отправки, свяжись со Spartoo. -428: аккаунт деактивирован. -429: слишком много запросов за один час. Коннектор сообщает отрицательный код как неудавшийся вызов.
Не охвачено: создание и редактирование продуктов, цен и скидок (они проходят через XML файл каталога), упаковочные листы и решения по возвратам.
Предварительные условия: SPARTOO_HOST, SPARTOO_PARTNER_KEY
Установить коннектор локально
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, выбери Spartoo Marketplace и вставь переменные окружения, указанные в разделе Предварительные условия.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
spartoo_list_orders | Список заказов, размещенных с определенной даты, опционально только тех, что в одном статусе. Для каждого заказа под root.orders.order: orders_id, customers… |
spartoo_get_order | Считывает один заказ по его id: детали клиента и доставки (или пункт выдачи в relay_info), способ оплаты, имя и цена доставки, заказ… |
spartoo_accept_order | Принять новый заказ: переводит его из статуса 11 (подтвержден) в 2 (в подготовке). После этого имя заказа, адрес доставки и перевозчик могут… |
spartoo_ship_order | Отметить принятый заказ как отправленный с номером отслеживания перевозчика: переводит его из статуса 2 в 3, и Spartoo отправляет ссылку для отслеживания… |
spartoo_cancel_order | Отменить заказ, который не был отправлен (статус 41). Клиент не получает заказ и ему возвращаются деньги от Spartoo; это нельзя отменить… |
spartoo_list_returns | Список возвратов, зарегистрированных с определенного момента, опционально только тех, что в одном статусе. Для каждого возврата под root.returns.return: return_id… |
spartoo_get_return | Считывает возвраты одного заказа или один возврат по его id: id возврата и дата, статус id и имя, причина, id заказа и возвращенный продукт… |
spartoo_check_product_status | Проверяет, находится ли один из твоих продуктов на сайте Spartoo. Возвращает под root.products.product твою ссылку, статус (OK на сайте… |
spartoo_update_stock | Устанавливает запас одного размера одного продукта в реальном времени. Запас 0 убирает этот размер с сайта; продукт, у которого все размеры 0, уходит в оффлайн.… |
Примеры запросов
- "Какие заказы Spartoo пришли с понедельника и еще не были приняты?"
- "Принять заказ 90D813EA1A2365A8 и отправить его с отслеживанием Royal Mail AB123456789GB."
- "Какие возвраты ожидают получения?"
- "Мой продукт REF-BOOT-221 онлайн, и если нет, то почему?"
- "Установить запас размера 38 для REF-BOOT-221 на 6."
Следующие шаги
Это руководство помогло?