One-click install
npx skills add https://github.com/vtex/ai-skills --skill marketplace-fulfillment-vtex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: marketplace-fulfillment
Source: https://github.com/vtex/ai-skills/tree/main/tracks/marketplace/skills/marketplace-fulfillment
Command: npx skills add https://github.com/vtex/ai-skills --skill marketplace-fulfillment-vtex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables building and operating the external seller fulfillment workflow for VTEX marketplaces by implementing the required simulation, placement, fulfillment, invoice, and tracking endpoints and data flows.

Core Features & Use Cases

  • Implement POST /pvt/orderForms/simulation to return available items and logistics for indexation or checkout contexts.
  • Implement POST /pvt/orders to create reservations and return an orderId per item for subsequent fulfillment and OMS operations.
  • Implement POST /pvt/orders/{sellerOrderId}/fulfill to commit the order and trigger the OMS invoice/tracking sequence.
  • Send invoice notifications and update tracking via VTEX OMS endpoints with correct marketplaceOrderId (not the reservation id), including support for partial invoicing.

Quick Start

Register the endpoints and wire them to your fulfillment backend to enable end-to-end order flow.

Frequently Asked Questions about marketplace-fulfillment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate external seller fulfillment workflows in a VTEX marketplace?

External seller fulfillment workflows in a VTEX marketplace are integrated by implementing simulation, placement, fulfillment, invoice, and tracking endpoints with correct data mappings and latency constraints.

What's the best way to handle order reservation and fulfillment authorization for VTEX marketplaces?

Order reservation and fulfillment authorization for VTEX marketplaces are handled by implementing POST /pvt/orders to create reservations, then POST /pvt/orders/{sellerOrderId}/fulfill to commit the order and trigger the OMS invoice sequence.

How do I send partial invoice and tracking updates to VTEX OMS?

Partial invoice and tracking updates are sent to VTEX OMS endpoints using the correct marketplaceOrderId rather than the reservation id, ensuring structured invoice and tracking formats for compliant order management.

Does the VTEX marketplace fulfillment simulation endpoint support checkout logistics contexts?

The VTEX marketplace fulfillment simulation endpoint supports checkout logistics contexts by implementing POST /pvt/orderForms/simulation to return available items and logistics information for indexation or checkout scenarios.

Why does my VTEX marketplace order fulfillment fail due to latency constraints?

VTEX marketplace order fulfillment fails due to latency constraints when endpoint integrations do not enforce the required response time limits for simulation, reservation, and fulfillment authorization operations.

Can I use marketplace-fulfillment to orchestrate end-to-end order flows without external dependencies?

Marketplace-fulfillment orchestrates end-to-end order flows by wiring the required endpoints to your fulfillment backend, enabling simulation, reservation, fulfillment, invoice, and tracking operations without additional dependencies.