marketplace-order-hook — скилл для Claude Code: заказы и установка
Помогает проектировать VTEX-интеграции заказов через Feed v3 и Hook. Нужен для вебхуков, проверки событий и защиты от повторной обработки.
npx skills add vtex/skills --skill marketplace-order-hook -a claude-codeЧто делает marketplace-order-hook
Скилл разбирает интеграцию заказов VTEX с ERP, WMS и другими внешними системами. Он помогает выбрать Feed v3 с pull-моделью или Hook с push-моделью, настроить фильтр FromWorkflow либо FromOrders и учесть жизненный цикл статусов заказа.
Вебхук содержит идентификатор заказа и состояние, поэтому за полными данными нужно обращаться к GET /api/oms/pvt/orders/{orderId}. Скилл также задаёт проверку Origin.Account, Origin.Key и настроенного заголовка, а для защиты от повторов использует OrderId + State + LastChange. Hook должен вернуть HTTP 200 за 5000ms, иначе схема не подходит для такого обработчика.
FromWorkflow и FromOrders нельзя включать в одном запросе: VTEX вернёт 409 Conflict. Для Feed события сохраняются в очереди до подтверждения, а Hook требует постоянно доступного обработчика.
Какие задачи решает
- выбрать Feed v3 или Hook для заказов
- настроить фильтрацию событий по статусу или свойствам заказа
- получить полные данные заказа после уведомления
- проверить подлинность входящего вебхука
- устранить повторную обработку одного события
Примеры запросов агенту
- Спроектируй обработчик Hook для изменений статуса заказа в VTEX.
- Сравни Feed v3 и Hook для интеграции заказов с ERP и выбери подходящую модель.
- Проверь обработчик вебхука: добавь проверку
Origin.Account,Origin.Keyи дедупликацию поOrderId,StateиLastChange.
Как установить marketplace-order-hook
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill marketplace-order-hook -a claude-code2Вручную: положить файлы
~/.claude/skills/marketplace-order-hook/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/marketplace-order-hook/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill marketplace-order-hook -a codex2Вручную: положить файлы
.agents/skills/marketplace-order-hook/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill marketplace-order-hook -a cursor2Вручную: положить файлы
.cursor/skills/marketplace-order-hook/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills marketplace-order-hook2Вручную: положить файлы
.github/skills/marketplace-order-hook/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill marketplace-order-hook -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/marketplace-order-hookВручную: положить файлы
.devin/skills/marketplace-order-hook/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill marketplace-order-hook -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о marketplace-order-hook
Как установить marketplace-order-hook в Claude Code?
Выполните npx skills add vtex/skills --skill marketplace-order-hook -a claude-code, затем проверьте файл ~/.claude/skills/marketplace-order-hook/SKILL.md.
Что делает marketplace-order-hook?
Скилл помогает создавать интеграции заказов VTEX через Feed v3 и Hook: выбирать модель доставки, настраивать фильтры, валидировать события и обрабатывать их без дублей.
Чем Feed отличается от Hook в marketplace-order-hook?
Feed работает по pull-модели и хранит события в очереди до подтверждения. Hook отправляет уведомления push-моделью, поэтому обработчик должен быть доступен и ответить HTTP 200 за 5000ms.
