Кратко
API Walmart Marketplace для продавцов в США: заказы с подтверждением и отправкой с отслеживанием, возвраты, поиск товаров и каталога, инвентаризация, цены, массовые загрузки, отчеты по запросу, входящие отгрузки WFS и настройки доставки. Идентификатор клиента и секрет.
Пошаговая настройка
Подключи Walmart Marketplace к ChatGPT за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Walmart Marketplace в пошаговой настройке и добавь свой MCP URL в ChatGPT. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Плагин AnythingMCP в каталоге ChatGPT отвечает на вопросы по базам данных вашей компании в AnythingMCP Cloud (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, только чтение): откройте страницу плагина (откроется в новой вкладке) и нажмите Install plugin. Все остальные коннекторы добавляются в ChatGPT как собственный MCP-сервер с MCP URL вашего AnythingMCP.
Попробуй спросить
Примеры промптов для Walmart Marketplace
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Walmart Marketplace, вставь свои учетные данные, создай ключ API MCP, и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Walmart Marketplace + ChatGPT
API Walmart Marketplace для продавцов в США: заказы с подтверждением и отправкой с отслеживанием, возвраты, поиск товаров и каталога, инвентаризация, цены, массовые загрузки, отчеты по запросу, входящие отгрузки WFS и настройки доставки. Идентификатор клиента и секрет.
Предварительные требования
Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
WALMART_CLIENT_ID, WALMART_CLIENT_SECRET
Шаг 1 — Получи учетные данные
Настройка занимает около 5 минут.
- Войди на https://developer.walmart.com с помощью своего логина Seller Center (выбери продавца Marketplace).
- Открой Мой аккаунт, затем API Keys (управление ключами) и создай или скопируй production идентификатор клиента и секрет.
- Вставь идентификатор клиента в
WALMART_CLIENT_ID, а секрет вWALMART_CLIENT_SECRET.
Коннектор обменивает их на POST /v3/token (HTTP Basic, учетные данные клиента) для получения токена доступа, который действует 15 минут, повторно использует его до истечения и сам запрашивает новый. Каждый вызов содержит WM_SEC.ACCESS_TOKEN, WM_SVC.NAME и новый WM_QOS.CORRELATION_ID. Используй свои собственные учетные данные продавца: ключи делегированного доступа для поставщиков решений больше не выдаются (новые больше не могут быть созданы, существующие перестанут работать после 30 апреля 2027 года).
С чего начать: walmart_marketplace_list_released_orders (заказы, ожидающие тебя), затем walmart_marketplace_get_order. walmart_marketplace_list_items перечисляет твой каталог, а walmart_marketplace_get_inventory — запасы SKU.
Заказы: walmart_marketplace_list_orders (все статусы), walmart_marketplace_list_released_orders (строки в статусе Created), walmart_marketplace_get_order. Строка может быть Created, Acknowledged, Shipped, Delivered или Cancelled. Подтверждай новые заказы оперативно с помощью walmart_marketplace_acknowledge_order, затем отправляй каждую строку с помощью walmart_marketplace_ship_order_line (перевозчик, метод, номер отслеживания, время отправки в миллисекундах эпохи); отправка фиксирует оплату клиента. walmart_marketplace_cancel_order_line и walmart_marketplace_refund_order_lines установлены в выключенном состоянии: отмена негативно сказывается на твоих метриках продавца, а возврат перемещает деньги. Списки заказов охватывают 180 дней назад, максимум 10,000 заказов, и по умолчанию показывают последние 7 дней.
Пагинация: заказы и возвраты отвечают с meta.nextCursor, готовой строкой запроса, начинающейся с ?. Передай ее без изменений как next_cursor и оставь другие фильтры. Товары используют nextCursor (начни с *, действителен 2 минуты) или limit и offset.
Возвраты: walmart_marketplace_list_returns (статусы INITIATED, DELIVERED, COMPLETED). walmart_marketplace_refund_return выключен, потому что он возвращает деньги клиенту.
Товары и каталог: walmart_marketplace_list_items, walmart_marketplace_get_item, walmart_marketplace_count_items, walmart_marketplace_search_my_catalog (твой каталог с фильтрами, такими как НЕНАПЕЧАТАННЫЕ товары) и walmart_marketplace_search_walmart_catalog (публичный каталог Walmart.com по ключевому слову, UPC или GTIN). walmart_marketplace_retire_item выключен: вывод товара из обращения удаляет листинг.
Инвентаризация и цены: walmart_marketplace_get_inventory, walmart_marketplace_get_inventory_by_ship_node, walmart_marketplace_update_inventory (абсолютное количество, единица EACH), walmart_marketplace_get_wfs_inventory (запасы, хранящиеся WFS). walmart_marketplace_update_price устанавливает БАЗОВУЮ цену одного SKU в USD (100 вызовов в час); walmart_marketplace_get_promotional_prices показывает цены распродаж.
Загрузки: массовые изменения проходят через загрузки. walmart_marketplace_submit_item_feed и walmart_marketplace_submit_price_feed установлены в выключенном состоянии, потому что одна загрузка изменяет множество активных листингов, а массовые загрузки цен ограничены по количеству в час и в день (10 в час, общие для всех загрузок цен и акций). Проверь результаты с помощью walmart_marketplace_list_feeds и walmart_marketplace_get_feed_status (ошибки по элементам с include_details).
Отчеты: walmart_marketplace_request_report, затем walmart_marketplace_list_report_requests или walmart_marketplace_get_report_request до READY, затем walmart_marketplace_get_report_download_url. Статус и вызовы загрузки ограничены 20 в час каждый, поэтому подожди несколько минут между проверками. Ссылка — это временная сжатая CSV.
WFS: walmart_marketplace_list_inbound_shipments, walmart_marketplace_list_inbound_shipment_items, walmart_marketplace_create_inbound_shipment_label (этикетки получения в формате PDF или ZPL, бесплатно).
Настройки (только для чтения): walmart_marketplace_list_ship_nodes (идентификаторы узлов доставки), walmart_marketplace_list_carrier_methods, walmart_marketplace_list_shipping_templates, walmart_marketplace_get_lag_time (20 вызовов в час).
Ограничения по количеству вызовов: у каждого API есть свой собственный токен (все заказы 5,000 в минуту, выпущенные заказы 60 в минуту, отправка, подтверждение и отмена 60 в минуту, инвентаризация 200 в минуту, товары 300 в минуту). Код 429 означает, что токен исчерпан; заголовки x-current-token-count и X-Next-Replenishment-Time указывают, когда можно повторить попытку.
Форматы: даты в формате ISO 8601 в UTC; даты заказов в ответах — в миллисекундах эпохи. Деньги в USD. SKU — это твои собственные SKU продавца; идентификаторы Walmart — это purchaseOrderId (заказы), returnOrderId (возвраты), wpid и itemId (каталог). Ошибки возвращаются как errors.error[] с кодом, полем и описанием; код 400 INVALID_REQUEST_HEADER обычно означает проблему с токеном или заголовком.
Шаг 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 — Добавь коннектор в ChatGPT
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
ChatGPT добавляет MCP-серверы как плагины на странице Plugins, в веб-версии и в платных планах. Режим разработчика для этого больше не нужен. В рабочем пространстве Business это могут только администраторы и владельцы; в Enterprise и Edu администратор может выдать право Create plugins with MCPs.
- Перейди на chatgpt.com/plugins, нажми Add, затем Add custom MCP server.
- Введи название, например Name:
Walmart Marketplace. - В разделе Connection укажи в поле Server URL адрес
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDи оставь Authentication на OAuth. - Выбери I understand and want to continue, затем Create as a plugin. Когда ChatGPT попросит, войди в AnythingMCP и разреши доступ.
- Установи новый плагин из своих личных плагинов, затем введи @ в чате и выбери его.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
walmart_marketplace_list_orders | Список заказов на покупку, начиная с самых новых: list.meta (totalCount, limit, nextCursor) и list.elements.order[] с purchaseOrderId… |
walmart_marketplace_list_released_orders | Список выпущенных заказов: заказы на покупку со строками, которые все еще находятся в статусе Created, готовые к подтверждению и отправке. Те же поля, что и… |
walmart_marketplace_get_order | Чтение одного заказа на покупку: purchaseOrderId, customerOrderId, customerEmailId (адрес для пересылки), orderDate, shippingInfo (телефон… |
walmart_marketplace_acknowledge_order | Подтверждение целого заказа на покупку (каждая строка переходит из Created в Acknowledged), подтверждая, что ты его выполните. Walmart ожидает этого… |
walmart_marketplace_ship_order_line | Отметить одну строку заказа как отправленную с перевозчиком и номером отслеживания. Walmart затем фиксирует оплату клиента, поэтому отправляй только то, что действительно… |
walmart_marketplace_cancel_order_line | Отменить единицы одной строки заказа, которую ты не можешь отправить, с указанием причины. Это нельзя отменить и это учитывается в твоем проценте отмен; используй… |
walmart_marketplace_refund_order_lines | Возврат отправленных строк заказа (полный или частичный) клиенту. Это перемещает деньги обратно к клиенту и не может быть отменено. Строки используют… |
walmart_marketplace_list_returns | Список заказов на возврат (RMA), начиная с самых новых: meta (totalCount, limit, nextCursor) и returnOrders[] с returnOrderId, customerOrderId… |
walmart_marketplace_refund_return | Выдать возврат для строк заказа на возврат (RMA). Это перемещает деньги обратно к клиенту и не может быть отменено. Возвращает результат возврата… |
walmart_marketplace_list_items | Список товаров в твоем каталоге Walmart: ItemResponse[] с sku, wpid, upc, gtin, productName, productType, shelf, price (amount… |
walmart_marketplace_get_item | Чтение одного товара из твоего каталога по SKU (по умолчанию) или по другому идентификатору: sku, wpid, upc, gtin, productName, shelf, productType, price… |
walmart_marketplace_search_my_catalog | Поиск в твоем собственном каталоге продавца с запросом, фильтрами и сортировкой: items[] с sku, itemId, productName, brand, price, publishedStatus… |
walmart_marketplace_search_walmart_catalog | Поиск в публичном каталоге Walmart.com (все продавцы) по ключевому слову или по UPC, GTIN, EAN или ISBN, чтобы увидеть, существует ли продукт уже перед… |
walmart_marketplace_count_items | Подсчет товаров в твоем каталоге в одном статусе (PUBLISHED, UNPUBLISHED, SYSTEM_PROBLEM, IN_PROGRESS или ALL). Только для чтения, дешевый обзор… |
walmart_marketplace_retire_item | Вывод (постоянное удаление) одного товара из Walmart.com по SKU. Листинг удаляется; вернуть его обратно нужно будет заново настраивать товар. Возвращает… |
walmart_marketplace_get_inventory | Чтение запасов одного SKU на твоем узле доставки по умолчанию или на указанном узле: sku, quantity (единица EACH, amount = доступные для продажи единицы)… |
walmart_marketplace_get_inventory_by_ship_node | Чтение запасов одного SKU на каждом узле доставки твоего аккаунта (или на одном узле): sku и nodes[] с shipNode, inputQty (что ты установил)… |
walmart_marketplace_update_inventory | Установка запасов одного SKU на абсолютное количество на твоем узле доставки по умолчанию (или на указанном узле). Количество заменяет текущее значение… |
walmart_marketplace_get_wfs_inventory | Чтение запасов Walmart Fulfillment Services (WFS): заголовки (totalCount, limit, offset) и payload.inventory[] с itemInformation (sku, gtin… |
walmart_marketplace_update_price | Установка обычной (БАЗОВОЙ) цены продажи одного SKU в USD. Возвращает ItemPriceResponse с sku и сообщением. Ограничено 100 вызовами в… |
walmart_marketplace_get_promotional_prices | Чтение рекламных цен одного SKU: payload.itemIdentifier и pricingList.pricing[] с currentPriceType (BASE, REDUCED, CLEARANCE… |
walmart_marketplace_submit_item_feed | Отправка массовой загрузки товаров (создание или обновление до 10,000 товаров) в формате JSON в спецификации товара Walmart, например, MP_ITEM с… |
walmart_marketplace_submit_price_feed | Отправка массовой загрузки цен (feedType PRICE_AND_PROMOTION, до 10,000 SKU, 1,000 рекомендуемых)… |
walmart_marketplace_list_feeds | Список твоих недавних загрузок (или одной загрузки): totalResults и results.feed[] с feedId, feedType, feedSource, feedStatus (RECEIVED, INPROGRESS… |
walmart_marketplace_get_feed_status | Чтение статуса одной загрузки: feedStatus, itemsReceived, itemsSucceeded, itemsFailed, itemsProcessing и, с include_details… |
walmart_marketplace_request_report | Попросить Walmart сгенерировать отчет по запросу (ITEM каталог, INVENTORY, BUYBOX, CANCELLATION, RETURN_OVERRIDES, ITEM_PERFORMANCE, WFS… |
walmart_marketplace_list_report_requests | Список запросов отчетов одного типа за последние 30 дней: requests[] с requestId, requestStatus (RECEIVED, INPROGRESS, READY, ERROR)… |
walmart_marketplace_get_report_request | Чтение статуса одного запроса отчета: requestId, requestStatus (RECEIVED, INPROGRESS, READY, ERROR), reportType, reportVersion… |
walmart_marketplace_get_report_download_url | Получить ссылку для загрузки готового отчета: downloadURL (предварительно подписанная, сжатая CSV), downloadURLExpirationTime, reportType и… |
walmart_marketplace_list_inbound_shipments | Список входящих отгрузок WFS (твои запасы на пути к центрам выполнения Walmart): headers.totalCount и payload[] с inboundOrderId… |
walmart_marketplace_list_inbound_shipment_items | Список SKU входящих отгрузок WFS: headers.totalCount и payload[] с inboundOrderId, shipmentId, sku, gtin, itemDesc, itemQty… |
walmart_marketplace_create_inbound_shipment_label | Генерация этикеток получения WFS для входящей отгрузки (не этикетка перевозчика: эти позволяют центру выполнения сопоставить коробки или поддоны с… |
walmart_marketplace_list_ship_nodes | Список твоих центров выполнения (узлы доставки): shipNode (идентификатор, который используют другие инструменты), shipNodeName, nodeType, status, timeZone, postalAddress… |
walmart_marketplace_list_carrier_methods | Список доступных методов перевозки для твоей конфигурации доставки: carrierMethodId, carrierMethodName, carrierMethodType и… |
walmart_marketplace_list_shipping_templates | Список твоих шаблонов доставки: totalRecords и shippingTemplates[] с id, name, type (DEFAULT, CUSTOM, DELIVERR), status (ACTIVE… |
walmart_marketplace_get_lag_time | Чтение времени задержки выполнения одного SKU: sku и fulfillmentLagTime (дни между заказом и отправкой; 2 дня или более требует Walmart… |
Примеры подсказок
- "Какие выпущенные заказы Walmart еще нужно отправить сегодня?"
- "Покажи заказ на покупку 1234567890123 с адресом доставки клиента и строками."
- "Какие SKU имеют менее 5 единиц на складе на моих узлах доставки?"
- "Установи цену SKU WM-1001 на 24.99 USD."
- "Подтверди все выпущенные заказы с сегодняшнего дня и перечисли те, у которых еще нет отслеживания."
Часто задаваемые вопросы
Какие рынки Walmart охватывает? Американский рынок Walmart Marketplace (marketplace.walmartapis.com). Walmart Канада, Мексика и Чили имеют отдельные API и не охватываются.
Нужен ли мне приложение поставщика решений или делегированный доступ? Нет. Ты создаешь свой собственный идентификатор клиента и секрет в Портале разработчиков Walmart с помощью своего логина продавца. Walmart больше не выдает новые ключи делегированного доступа.
Может ли он отменять заказы или выдавать возвраты? Инструменты существуют, но установлены в выключенном состоянии: walmart_marketplace_cancel_order_line, walmart_marketplace_refund_order_lines и walmart_marketplace_refund_return. Включай их на странице коннектора только если ИИ должен их использовать; он попросит тебя подтвердить каждое изменение.
Работает ли бесплатный план ChatGPT со своими MCP-серверами? OpenAI описывает свои MCP-серверы только для платных планов; план Free в этом списке не указан.
Следующие шаги
Это руководство помогло?