News

Now it’s easier to sell the products from your physical stores in marketplaces

Beatriz Silva
Beatriz Silva
Created at
3/20/2019

You can now easily sell products from your entire network of physical stores in external marketplaces. Through the Recursive Marketplace, the franchise accounts are fully integrated with the main account immediately after being created. This means that when the main account sets up an integration with an external marketplace, the franchise accounts' inventory will also be considered in the process, ie, it will no longer be necessary to manage each franchise account individually in order to integrate it into the marketplace.

Main benefits

  • Setup of the integration with an external marketplace in one account only, the main one.
  • Omnichannel power in your business; you can use the franchise accounts for pickup points, for example.
  • Simplification of Checkout APIs.

What you need to do

The only necessary setting is the integration of the main account with the external marketplace. Once this is done, the inventories of all franchise accounts linked to the main one will also be sent to the marketplace. This is a new franchise account feature, which is active and ready to make your life easier whenever you need to integrate your operation with marketplaces.

For now, automatic integration of the franchise accounts inventory is only available when the marketplace is not a VTEX one.

What has changed

The Recursive Marketplace brought a new ally for omnichannel operations. However, to be used, the store that will be exclusively a marketplace in the order flow (the link closest to the customer), must adjust its Checkout APIs according to the changes below:

  • AffiliateId, marketplacePaymentValue, marketplaceOrderGroup and marketplaceServicesEndpoint are the 4 new required Checkout PlaceOrder fields. The paymentData field is no longer required.
  • New route for progressing the order after marketplace approval (Marketplace Order Authorization).
  • The Marketplace needs to support the new route so it can be notified of a seller (or an intermediate agent) cancellation and to receive the invoice from the seller (or the intermediate agent).

To learn more about Recursive Marketplace and changes to the Checkout APIs, visit this Help article.

Still got questions?
Ask the community
Find solutions and share ideas in VTEX's community.
Talk to our experts
Get in touch if you have something specific to ask about the platform.
  • PT
  • ES
VTEX website