marketplace-fulfillment — скилл для Claude Code: установка
Скилл помогает написать сторону селлера в VTEX: ответ на симуляцию, приём заказа с резервом, подтверждение отгрузки, накладные и трекинг в OMS.
npx skills add vtex/skills --skill marketplace-fulfillment -a claude-codeЧто делает marketplace-fulfillment
Скилл учит агента протоколу External Seller в VTEX. Сторона селлера отвечает на симуляцию при индексации и в чекауте, создаёт резерв при POST /pvt/orders и подтверждает заказ в POST /pvt/orders/{sellerOrderId}/fulfill. После отгрузки селлер сам идёт в OMS маркетплейса за накладной и трекингом.
Симуляция должна уложиться в 2.5 секунды, иначе товар считается недоступным. В пути /api/oms/pvt/orders/... стоит id заказа маркетплейса, а не orderId резерва: с id резерва накладная не прикрепится к заказу клиента. Накладная Output оформляет продажу, Input возврат, а заказ с накладной нельзя отменить без возвратной.
Трекинг уходит отдельным PATCH после того, как его дал перевозчик. При разбивке на посылки на каждую шлют свою накладную, и invoiceValue считается только по её товарам. Каталог и ленту событий заказов скилл не покрывает: для них есть marketplace-catalog-sync и marketplace-order-hook.
Какие задачи решает
- ответить на симуляцию VTEX с доставкой и остатками за 2.5 секунды
- создать резерв при приёме заказа и вернуть его id как
orderId - превратить резерв в твёрдый заказ при вызове
fulfill - отправить накладную и трекинг в OMS по id заказа маркетплейса
- выписать отдельную накладную на каждую посылку
Примеры запросов агенту
- Напиши обработчик
POST /pvt/orderForms/simulationдля VTEX External Seller, чтобы ответ укладывался в 2.5 секунды - Сделай приём заказа
POST /pvt/ordersс созданием резерва и обработчик/fulfillдля нашего селлера - Отправь накладную в OMS, а потом обнови трекинг через
PATCHдля заказа, разбитого на посылки
Как установить marketplace-fulfillment
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill marketplace-fulfillment -a claude-code2Вручную: положить файлы
~/.claude/skills/marketplace-fulfillment/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/marketplace-fulfillment/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill marketplace-fulfillment -a codex2Вручную: положить файлы
.agents/skills/marketplace-fulfillment/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill marketplace-fulfillment -a cursor2Вручную: положить файлы
.cursor/skills/marketplace-fulfillment/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills marketplace-fulfillment2Вручную: положить файлы
.github/skills/marketplace-fulfillment/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill marketplace-fulfillment -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/marketplace-fulfillmentВручную: положить файлы
.devin/skills/marketplace-fulfillment/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill marketplace-fulfillment -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о marketplace-fulfillment
Как установить marketplace-fulfillment в Claude Code?
Выполните npx skills add vtex/skills --skill marketplace-fulfillment -a claude-code. Файл скилла лежит в ~/.claude/skills/marketplace-fulfillment/SKILL.md.
Что делает marketplace-fulfillment?
Подсказывает агенту, как реализовать на хосте селлера симуляцию, приём заказа и подтверждение отгрузки, а также как слать в OMS маркетплейса накладные и трекинг, включая частичные накладные.
Какой id подставлять в путь OMS при отправке накладной?
Id заказа маркетплейса, то есть marketplaceOrderId из запроса VTEX. orderId резерва, который вы вернули при создании заказа, для этого не годится: накладная не найдёт заказ клиента.
