Кратко
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 и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Skroutz, вставь свои учетные данные, создай ключ API MCP и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Skroutz
API Skroutz Marketplace (Умная Корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, Установить как Готово, отслеживание, загрузка счетов, возвраты, запасы Выполнено Skroutz, заказы на покупку и поставщики, массовое обновление цен и запасов и заказы CPS. API токен из панели продавцов.
Настройка
Настройка занимает около 3 минут.
- Войди в панель продавцов Skroutz и открой Услуги, Skroutz Marketplace (страница настроек Умной Корзины).
- Сгенерируй API токен и вставь его в
SKROUTZ_API_TOKEN. У магазина есть один активный токен: генерация нового завершает предыдущий, поэтому токен, используемый другой интеграцией, перестает работать. - По желанию, для массового обновления цен и запасов: в Продукты, Обновления ленты сгенерируй токен API Продуктов и вставь его в
SKROUTZ_PRODUCTS_TOKEN. - По желанию, для заказов 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?"
Следующие шаги
Это руководство помогло?