Integrating your VTEX store with non-VTEX marketplaces enables you to expand your sales channels, reach new customers, and increase brand visibility. This guide shows how to connect your VTEX store as a seller to marketplaces through connectors, APIs, or custom integrations.

If you want to integrate your VTEX store as a seller of a VTEX marketplace, see the guide Integrating VTEX stores.

Marketplace integration connects your VTEX store (as a seller) to non-VTEX marketplaces. This architecture allows you to sell on multiple sales channels while managing everything from your VTEX Admin.

The following are the available marketplace integration types:

Native connectors:

• Pre-built integrations developed by VTEX.
• Available for major marketplaces (Amazon, Mercado Libre, etc.).
• Maintained and updated by VTEX.

Partner connectors:

• Integrations developed by VTEX partners.
• Specialized solutions for specific marketplaces.
• Support provided by partner companies.
• May include additional features or customizations.

External marketplace (custom connectors):

• Developed specifically for unsupported marketplaces.
• Requires technical development resources.
• Uses VTEX APIs and marketplace APIs.
• Full control over integration logic.
• Ideal for unique or regional marketplaces.

Check if VTEX offers a native connector or if certified partner solutions are available for your business needs:

1. In the VTEX Admin, go to Marketplace > Connections > Marketplaces and Integrations.
2. Browse available connectors or search for your target marketplace.
3. Check if the connector supports your business needs.

For the list of available connectors and partner solutions, see Marketplace strategies at VTEX.

For unsupported marketplaces, consider developing a custom connector.

When to develop custom connectors:

• No native or partner connector is available.
• The marketplace has specific technical requirements.
• The integration requires unique business logic.
• Volume justifies development investment.

To develop a custom marketplace integration, see the guides External Marketplace Integration and Integration app template.

Sales channels (formerly called trade policies) control which products, prices, and conditions apply to each channel, including marketplaces.

For each additional sales channel, a monthly fee is charged, whether used for integration with VTEX, partner or external marketplaces.

To define sales channels for your marketplace, follow the steps below:

1. Evaluate if you need a specific configuration for each marketplace. If they all share the same settings, use your default sales channel.

You can use the same sales channel to integrate with multiple marketplaces. Requesting additional sales channels for marketplace integrations may incur a monthly fee. 2. If you need specific settings, create a new sales channel for your operations. 3. Configure the sales channel with the appropriate settings for catalog, pricing, promotions, and logistics. For detailed configuration instructions, see Configuring a marketplace trade policy.

Make sure you have admin access to configure affiliates. For more information, see the release note New permissions for accessing order configurations.

The affiliate is the code that identifies the marketplace where you sell your products. Each marketplace must have a unique affiliate.

To create an affiliate, follow the steps below:

1. In the VTEX Admin, go to Store Settings > Orders > Settings.
2. In the Affiliates tab, click + New Affiliate.
3. Complete the required fields. For detailed information about these fields, see Configuring affiliates.
4. Click Save to create the affiliate.

After creating the affiliate, provide the affiliate ID to the marketplace operator. The marketplace will use this ID when adding your store as a seller.

For VTEX native connectors or partner solutions:

1. In the VTEX Admin, go to Marketplace > Connections > Marketplaces and Integrations.
2. Find the marketplace connector.
3. Click Connect.
4. Follow the connector-specific setup wizard.
5. Provide required credentials and settings.
6. Authorize the connection with the marketplace.

For detailed instructions on connectors and partner solutions, including category and attribute mapping, see the integration tutorial for each marketplace in the guide Marketplace and Integrations.

For native connectors or partner solutions, products associated with the corresponding sales channel are sent automatically.

In custom integrations, you should:

• Implement product export using VTEX APIs.
• Handle Change Notification and SKU Suggestion flows.
• Process responses and retry failed products.

For detailed information, see Sending products to the marketplace.

Price divergence rules protect your store from processing orders with unexpected price differences between VTEX and the marketplace. Price differences can occur due to:

• Synchronization delays
• Promotional pricing mismatches
• Currency conversion variations
• Marketplace-applied promotions
• System errors or bugs

To configure acceptable price variance, follow these instructions:

1. In the VTEX Admin, go to Store Settings > Orders > Order authorization.
2. Click the Price divergence tab.
3. Click Create rule.
4. In the Authorization Rules panel, click CREATE RULES to configure a new rule.
5. Set the interval and select the desired action: Automatically authorize, Automatically deny, or Create a VTEX DO task for approval.
6. Click SAVE RULES to save the rule.

For detailed information, see Price Divergence rule.