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

Skroutz MCP-сервер: заказы, остатки и возвраты

API Skroutz Marketplace (Умная Корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, Установить как Готово, отслеживание, загрузка счетов, возвраты, запасы Выполнено Skroutz, заказы на покупку и поставщики, массовое обновление цен и запасов и заказы CPS. API токен из панели продавцов.

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

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

Skroutz

Skroutz

Skroutz Marketplace (Smart Cart) API for sellers on the Greek and Cypriot marketplace: read, accept and schedule orders, Set as Ready, tracking, invoice uploads, returns, Fulfilled by Skroutz stock, purchase orders and suppliers, bulk price and stock updates and CPS orders. API token from the merchants panel.

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

27

Регион

INTL

Категория

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

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

API credentials

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

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

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

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

Кратко

API Skroutz Marketplace (Умная Корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, Установить как Готово, отслеживание, загрузка счетов, возвраты, запасы Выполнено Skroutz, заказы на покупку и поставщики, массовое обновление цен и запасов и заказы CPS. API токен из панели продавцов.

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

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

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

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

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

Примеры промптов для Skroutz

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

Skroutz · live via MCP
Поделиться
Opus 4.7

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

💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Skroutz, вставь свои учетные данные, создай ключ API MCP и готово. Никакого Docker, никакого git clone, никакого локального сервера.

Skroutz

API Skroutz Marketplace (Умная Корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, Установить как Готово, отслеживание, загрузка счетов, возвраты, запасы Выполнено Skroutz, заказы на покупку и поставщики, массовое обновление цен и запасов и заказы CPS. API токен из панели продавцов.

Настройка

Настройка занимает около 3 минут.

  1. Войди в панель продавцов Skroutz и открой Услуги, Skroutz Marketplace (страница настроек Умной Корзины).
  2. Сгенерируй API токен и вставь его в SKROUTZ_API_TOKEN. У магазина есть один активный токен: генерация нового завершает предыдущий, поэтому токен, используемый другой интеграцией, перестает работать.
  3. По желанию, для массового обновления цен и запасов: в Продукты, Обновления ленты сгенерируй токен API Продуктов и вставь его в SKROUTZ_PRODUCTS_TOKEN.
  4. По желанию, для заказов CPS из собственного интернет-магазина: в Παραγγελίες καταστήματος, Αυτόματη διαχείριση (заказы магазина, автоматическое управление) сгенерируй токен CPS и вставь его в SKROUTZ_CPS_TOKEN.

Каждый вызов отправляет токен как Authorization: Bearer с типом медиа application/vnd.skroutz+json; version=3.0. Проверка установки считывает демонстрационный заказ DEMO-OPEN, который подтверждает токен рынка, не касаясь реальных данных.

С чего начать: API не имеет списка заказов. Заказы поступают в магазин через вебхук заказов, панель продавцов и электронные письма с заказами, поэтому спроси у пользователя код заказа (например, 191128-1234567) и считай его с помощью skroutz_get_order. Демонстрационные коды DEMO-OPEN, DEMO-ACCEPTED, DEMO-REJECTED, DEMO-INVOICE, DEMO-FBS, DEMO-STORE-PICKUP и DEMO-RETURN безопасны для чтения, принятия и отклонения для тестирования: ничего не сохраняется.

Заказы: открытый заказ содержит accept_options и reject_options и должен быть обработан до expires_at. Прими его с помощью skroutz_accept_order, отправив идентификатор места забирания и идентификатор одного из собственных окон забирания этого места (окна различаются в зависимости от места). Затем Skroutz бронирует курьера, и PDF ваучер появляется в courier_voucher. Экспресс-заказы автоматически принимаются Skroutz. skroutz_reject_order установлен выключенным: отклонение нельзя отменить и оно учитывается против магазина. Чтобы изменить место забирания принятого заказа, считай его с помощью action_options 1 сразу перед этим и используй skroutz_reschedule_order_pickup (дата из reschedule_options) или skroutz_relocate_order_pickup (идентификатор из relocate_options); списки со временем уменьшаются. skroutz_request_preorder_voucher создает ваучер принятого предзаказа заранее.

Установить как Готово: когда заказ показывает set_as_ready_required true, Skroutz Last Mile забирает его только после skroutz_set_order_ready; загрузка ваучера больше не помечает его как готовый (с 30 марта 2026 года). Раннее помечание может переместить забирание на более раннее окно. skroutz_set_order_not_ready отменяет это перед забиранием. Магазины с set_as_ready_required false не нуждаются в этом.

Доставка и документы: skroutz_update_tracking_details отправляет курьера и код отслеживания только для заказов, выполненных продавцом (FBM). skroutz_upload_invoice и skroutz_upload_credit_invoice принимают публичную ссылку на PDF, PNG или JPG (максимум 7 МБ); коннектор загружает его и загружает файл, по одному на заказ, заменяя ранее загруженный.

Возвраты: skroutz_get_return считывает возврат по его коду (например, R-111111-1111111, из вебхука возврата или панели продавцов; returns заказа дает только uuid и идентификаторы отслеживания). skroutz_handle_return (реши возврат, ожидающий проверки до review.expires_at, включая отправку недостающей части за счет магазина) и skroutz_submit_service_inspection (технический отчет о неисправном товаре, как ссылка на файл) установлены выключенными, потому что они приводят к возвратам денег, заменам или платным отправкам. skroutz_file_compensation_request также выключен: он требует деньги от Skroutz за возвращенные товары, и через этот коннектор только по причинам, которые не требуют фотографий.

Выполнено Skroutz: skroutz_list_fbs_products (запасы на складах Skroutz), skroutz_list_fbs_purchase_orders, skroutz_list_fbs_purchase_order_items, skroutz_list_fbs_suppliers, skroutz_create_fbs_supplier и skroutz_update_fbs_supplier. skroutz_create_fbs_purchase_order выключен, потому что с ним связаны сборы за хранение. Списки разбиваются на страницы с помощью page и приходят с meta.pagination (100 строк на страницу). Магазин без FBS получает 401 здесь.

API Продуктов (нужен SKROUTZ_PRODUCTS_TOKEN): skroutz_validate_product_updates проверяет партию, не изменяя ничего; skroutz_update_products (выключен) обновляет доступность, цену и количество до 500 существующих продуктов и вариаций, асинхронно; skroutz_get_product_update_status сообщает о успехе, отсутствии изменений или ошибке для каждого продукта. Цены здесь — целые евроценты (1050 — это 10,50 EUR), в то время как суммы заказов — десятичные евро. Он не создает продукты: они поступают из XML-ленты. Ошибка 422, говорящая о том, что XML сканируется, означает, что нужно попробовать снова позже.

Заказы CPS (нужен SKROUTZ_CPS_TOKEN): skroutz_get_cps_order считывает продажу из твоего собственного интернет-магазина по твоему собственному номеру заказа, с доходом и комиссией; skroutz_reject_cps_order (выключен) отклоняет его, чтобы не взималась комиссия.

Полевые заметки: время в формате ISO 8601 с афинским смещением (+02:00 зимой, +03:00 летом). Метки, такие как окна забирания, причины отклонения и состояния CPS, приходят на греческом. Идентификаторы строк — короткие строки (l39vKqxqwe); shop_uid — это твой собственный идентификатор продукта. Ошибки содержат массив errors с code и messages: 422 order_status означает, что заказ не находится в состоянии для этого действия. Неправильный или замененный токен рынка отвечает 403. Коннектор никогда не перемещает деньги: отклонения, решения по возвратам, требования компенсации, заказы на покупку и массовые обновления продуктов установлены выключенными, чтобы администратор мог включить их намеренно.

Предварительные условия: SKROUTZ_API_TOKEN

Установи коннектор локально

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, выбери Skroutz и вставь переменные окружения, указанные в предварительных условиях.

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

ИнструментЧто он делает
skroutz_get_orderСчитывает один заказ Skroutz Marketplace (Умная Корзина) по его коду: состояние (открыт, принят, отклонен, отменен, истек, отправлен, доставлен…
skroutz_accept_orderПринимает открытый заказ: затем Skroutz бронирует курьера и выдает ваучер (он приходит на заказ как courier_voucher). Отправь…
skroutz_reject_orderОтклоняет открытый заказ, либо по строке с идентификатором причины из reject_options (с available_quantity, когда причина имеет…
skroutz_reschedule_order_pickupПеремещает забирание курьера принятого заказа на другую дату. Считай заказ с action_options 1 сразу перед этим и отправь один из его…
skroutz_relocate_order_pickupПеремещает забирание курьера принятого заказа на другое место забирания магазина, сохраняя дату и слот забирания. Курьер…
skroutz_set_order_readyПомечает принятый заказ как упакованный и готовый к отправке (Установить как Готово). Требуется для магазинов, заказы которых показывают set_as_ready_required true…
skroutz_set_order_not_readyОтменяет Установить как Готово на принятом заказе, который курьер еще не забрал. Skroutz пытается вернуть забирание на исходную дату.…
skroutz_update_tracking_detailsОтправляет курьера и код отслеживания каждой отправки заказа, выполненного продавцом (FBM), чтобы клиент мог следить за ним. Только для FBM…
skroutz_request_preorder_voucherЗапрашивает ваучер курьера принятого предзаказа сейчас, когда продукт пришел до запланированной даты отправки (Создать в панели…
skroutz_upload_invoiceЗагружает квитанцию или счет заказа по ссылке на файл (PDF, PNG или JPG, максимум 7 МБ). Один файл на заказ: новая загрузка…
skroutz_upload_credit_invoiceЗагружает кредитный счет заказа, который был отменен, возвращен, частично возвращен или возвращен отправителю после его получения или счета…
skroutz_file_compensation_requestЗапрашивает у Skroutz компенсацию для магазина за возвращенные товарные позиции, отправленные в формате JSON без фотографий, только по причинам, которые не требуют…
skroutz_get_returnСчитывает один возврат по его коду: состояние (ожидание проверки продавцом, возврат, ожидание физической проверки, ожидание технической проверки, возвращен…
skroutz_handle_returnРешает возврат в состоянии ожидания проверки продавцом с одним из его handle_options: одобрить, отклонение, такое как не неисправный (с комментарием, когда…
skroutz_submit_service_inspectionОтправляет результат технической проверки неисправного возвращенного товара (возврат в состоянии ожидания технической проверки): идентификатор товара, один из его…
skroutz_list_fbs_productsСписок товаров магазина, выполненных Skroutz (FBS), хранящихся на складах Skroutz: идентификатор, shop_uid (твой идентификатор продукта), активный (доступный для покупки с…
skroutz_list_fbs_purchase_ordersСписок заказов на покупку, выполненных Skroutz (запасы, отправленные на склады Skroutz): код, created_at, ожидаемая дата и received_at.…
skroutz_list_fbs_purchase_order_itemsСписок строковых элементов одного заказа на покупку, выполненного Skroutz: product_id, shop_uid, активный, ожидаемое количество и фактическое количество…
skroutz_create_fbs_purchase_orderОбъявляет новый заказ на покупку, выполненный Skroutz: запасы, которые ты доставишь на склад Skroutz, с ожидаемой датой, поставщиком…
skroutz_list_fbs_suppliersСписок поставщиков магазина, выполненных Skroutz: идентификатор (используй его для заказов на покупку), код, имя, адрес, город, район, почтовый индекс, телефон…
skroutz_create_fbs_supplierДобавляет поставщика, выполненного Skroutz (который отправляет запасы на склад Skroutz для тебя) с уникальным кодом, именем, адресом, городом, районом, почтовым индексом…
skroutz_update_fbs_supplierИзменяет поля поставщика, выполненного Skroutz; изменяются только поля, которые ты отправляешь. Ответ success: true
skroutz_validate_product_updatesПроверяет партию обновлений продуктов (доступность, цена в центах, количество, вариации) без изменения чего-либо: Skroutz выполняет каждую проверку…
skroutz_update_productsОбновляет доступность, цену (евроценты) и количество до 500 существующих продуктов и их вариаций в одной партии; он не создает…
skroutz_get_product_update_statusСчитывает результат обновления партии продуктов: статус (in_progress, пока любой продукт ожидает, затем completed), created_at и для каждого продукта…
skroutz_get_cps_orderСчитывает один заказ CPS (продажа в твоем собственном интернет-магазине, пришедшая от Skroutz, оплаченная комиссией) по коду заказа, который твой магазин ему дал: дата…
skroutz_reject_cps_orderОтклоняет заказ CPS, чтобы Skroutz не взимал комиссию за него, с одним из его reject_options (user_cancel, user_return, undelivered…

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

  • "Покажи заказ 251114-3920517 с его товарами, его вариантами забирания и когда он истекает."
  • "Прими заказ 251114-3920517 для первого окна забирания моего склада в Афинах."
  • "Заказ 251112-1187340 нуждается в Установить как Готово: готов ли он к пометке, и когда забирание?"
  • "Что говорит возврат R-251110-2045318, и до какого срока я должен его проверить?"
  • "Сколько единиц каждого продукта у меня на складах Skroutz?"

Следующие шаги

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

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

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

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

Коннекторы

Skroutz MCP: подключить к ChatGPT

API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.

Коннекторы

Skroutz MCP: подключить к Claude

API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.

Коннекторы

Skroutz MCP: подключить к Microsoft Copilot

API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.

Коннекторы

Skroutz MCP: подключить к Cursor

API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.

Коннекторы

Skroutz MCP: подключить к Gemini CLI

API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.

Коннекторы

Skroutz MCP: подключить к Meta Muse

API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.