marketplace-catalog-sync

Automate VTEX marketplace catalog sync via Change Notification and SKU suggestion workflows.

39|9|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/vtex/ai-skills --skill marketplace-catalog-sync-vtex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: marketplace-catalog-sync
Source: https://github.com/vtex/ai-skills/tree/main/tracks/marketplace/skills/marketplace-catalog-sync
Command: npx skills add https://github.com/vtex/ai-skills --skill marketplace-catalog-sync-vtex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Integrates external seller catalogs with VTEX marketplaces by handling Change Notification and SKU Suggestion workflows, enabling consistent catalog synchronization and rate-limited batch processing. Use for implementing seller-side catalog integration that pushes SKUs to VTEX marketplaces with proper notification handling and rate-limited batch synchronization.

Core Features & Use Cases

  • Change Notification flow: leverages changenotification with sellerId and sellerSkuId to trigger marketplace updates.
  • SKU Suggestion lifecycle: supports pending state and subsequent approval or denial to finalize SKUs.
  • Product data mapping: aligns external product data to VTEX catalog schema for accurate syncing.
  • Price & inventory sync: uses dedicated price/inventory notification endpoints to keep marketplace data current.
  • Fulfillment simulation: provides a seller-side endpoint to simulate availability with fast responses.
  • Rate-limited batch processing: implements batching, exponential backoff, and retry logic to respect VTEX API limits.

Quick Start

Configure your seller connector to start sending changenotification and SKU suggestions to VTEX marketplaces.

Frequently Asked Questions about marketplace-catalog-sync

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

FAQPage Schema
How do I sync an external seller catalog with a VTEX marketplace?

Sync external seller catalogs with VTEX marketplaces by automating change notification and SKU suggestion workflows. The process aligns external product data to the VTEX catalog schema and pushes SKUs through rate-limited batch processing.

How does the VTEX Change Notification API work for SKU suggestions?

The VTEX Change Notification API works by sending a changenotification payload with sellerId and sellerSkuId to trigger marketplace updates. It manages the SKU suggestion lifecycle from a pending state to final approval or denial.

How do I sync price and inventory for seller SKUs on VTEX?

Sync price and inventory for seller SKUs on VTEX using dedicated price and inventory notification endpoints. This keeps marketplace data current alongside the catalog synchronization process without writing directly to the catalog.

Can I use direct catalog writes to push seller SKUs to a VTEX marketplace?

Direct catalog writes are not supported for pushing seller SKUs to a VTEX marketplace. You must use the Change Notification API and SKU suggestion workflows to ensure consistent catalog synchronization and proper rate limiting.

What is the best way to handle VTEX API rate limits when pushing seller catalogs?

Handle VTEX API rate limits when pushing seller catalogs by implementing rate-limited batch processing. This includes request batching, exponential backoff, and retry logic to respect API limits during catalog synchronization.

Does VTEX marketplace integration support fulfillment simulation for seller SKUs?

VTEX marketplace integration supports fulfillment simulation for seller SKUs by providing a seller-side endpoint. This simulates product availability with fast responses to verify marketplace fulfillment capacity.