Fulfillment, simulation, orders & OMS follow-up

When this skill applies

Use this skill when building an External Seller integration: VTEX forwards availability, shipping, checkout simulation, and order placement to your fulfillment base URL, and you call the marketplace OMS APIs for invoice and tracking after dispatch.

• Implementing POST /pvt/orderForms/simulation (indexation and/or checkout — with or without customer context)
• Implementing POST /pvt/orders (order placement — create reservation; return orderId = reservation id in your system)
• Handling POST /pvt/orders/{sellerOrderId}/fulfill (order dispatch after approval — path uses the same id you returned as orderId at placement)
• Sending invoice notifications via POST /api/oms/pvt/orders/{marketplaceOrderId}/invoice (marketplace order id in the path)
• Updating tracking via PATCH /api/oms/pvt/orders/{marketplaceOrderId}/invoice/{invoiceNumber}
• Implementing partial invoicing for split shipments

Do not use this skill for:

• Catalog or SKU synchronization (see marketplace-catalog-sync)
• Order event consumption via Feed/Hook (see marketplace-order-hook)
• General API rate limiting (see marketplace-rate-limiting)

Decision rules