What problem does it solve?
This Skill solves the integration gap when building an External Seller fulfillment connector for VTEX marketplace by providing the fulfillment simulation, reservation-based order placement, authorize-fulfillment dispatch, and OMS invoice/tracking follow-up workflow with correct ID mapping.
Core Features & Use Cases
- Fulfillment simulation (indexation + checkout): Implement
POST /pvt/orderForms/simulation to return per-item availability plus aligned logisticsInfo and SLAs (including pickup-in-point when offered), while meeting the 2.5s SLA.
- Reservation-based order placement and dispatch: Implement
POST /pvt/orders (array in, array out) to create reservations and return them as orderId, then handle POST /pvt/orders/{sellerOrderId}/fulfill to commit the reservation into a firm order and return OMS-ready receipt data.
- OMS invoice and tracking for marketplace: Call
POST /api/oms/pvt/orders/{marketplaceOrderId}/invoice for Output invoices and PATCH /api/oms/pvt/orders/{marketplaceOrderId}/invoice/{invoiceNumber} for tracking, including correct partial invoicing per split shipment.
Use case: a seller-side service must answer VTEX within the simulation SLA, place orders with a reservation id, then generate correct invoices and tracking updates in OMS so customers see accurate shipment status.
Quick Start
Use marketplace-fulfillment to implement VTEX External Seller fulfillment: simulate logistics and SLAs, place reservation orders with correct orderId echoing, authorize and dispatch fulfillment, then send marketplace OMS invoices and tracking updates using the marketplaceOrderId.
