Кратко
API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.
Пошаговая настройка
Подключи Skroutz к Microsoft Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Skroutz в пошаговой настройке и добавь свой MCP URL в Microsoft Copilot. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Skroutz
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Skroutz, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Skroutz + Microsoft Copilot
API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.
Предварительные требования
Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
SKROUTZ_API_TOKEN
Шаг 1 — Получи учетные данные
Настройка занимает около 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. Коннектор никогда не перемещает деньги: отклонения, решения по возвратам, требования о компенсации, закупочные заказы и массовые обновления продуктов установлены выключенными, чтобы администратор мог включить их намеренно.
Шаг 2 — Установи адаптер
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
Шаг 3 — Добавь коннектор в Microsoft Copilot
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.
- В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
- Укажи Server name (например,
AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер. - В аутентификации выбери API key, установи Type в Header, укажи имя заголовка
X-API-Keyи нажми Create. - В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
- Проверь в панели Test агента: попроси о том, для чего нужны инструменты
Skroutz. - Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.
Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
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, expected_date и 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 | Читает результат обновления партии продуктов: статус (в процессе, пока любой продукт ожидает, затем завершено), 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, и это три отдельных токена: токен API рынка в разделе Услуги, Skroutz Marketplace (заказы, возвраты, выполненные Skroutz), необязательный токен API продуктов в разделе Продукты, Обновления ленты для массовых обновлений цен и запасов, и необязательный токен CPS для заказов из твоего собственного интернет-магазина. Генерация нового токена рынка завершает старый.
Может ли он перечислить мои заказы? Нет. API Skroutz не имеет списка заказов: заказы поступают в магазин через вебхук, панель продавцов и электронные письма с заказами. Дай ИИ код заказа (например, 251114-3920517), и он прочитает заказ. Демонстрационные коды, такие как DEMO-OPEN, безопасны для тестирования.
Какие инструменты установлены выключенными? skroutz_reject_order и skroutz_reject_cps_order, потому что отклонение не может быть отменено, инструменты возврата skroutz_handle_return, skroutz_submit_service_inspection и skroutz_file_compensation_request, skroutz_create_fbs_purchase_order, что приводит к сборам за хранение, и skroutz_update_products.
Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.
Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.
Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.
Следующие шаги
Это руководство помогло?