Store setup for VTEX Seller
For a VTEX store to act as a seller, it has to do the following for each external marketplace:
This article explains what must be done to complete each of these configuration steps.
Define channel settings
Sales channels are used in VTEX to group catalog, pricing, promotions, inventory, shipping and payments settings for different channels. The sections that follow describe where you can use sales channels in each of these modules.
Once all the channel settings that should be applied to the marketplace are grouped under a single sales channel, take note of the sales channel ID before you move on to the next step.
Multiple channels can share the same settings by using the same sales channel. Request a new sales channel to be able to differentiate settings per channel.
Catalog
When adding products to your catalog, you may restrict their availability to certain sales channels. If no restriction is made, the product will be available in all sales channels.
In the example above, the product will be available only to the B2C - USA and Marketplace - USA sales channels.An error occurred while loading the image https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/external-marketplace-integration-vtex-seller-setup-0.png
Pricing
When setting prices for your products, keep in mind that each sales channel is created with its own price table. To differentiate prices between your sales channels, you may use:
- Price rules to set a different markup for specific categories / brands
- Fixed prices to set a different price for specific products
In the example above, a price rule applied an additional 10% markup to the B2C - USA sales channel and a fixed price of $ 500.00 was set in the Marketplace - USA sales channel for SKU 14.
Read about our pricing system architecture if these concepts are unfamiliar to you.
Promotions
When creating promotions as a seller, you may restrict their availability to certain sales channels. If no sales channel is selected, the promotion will be available in all sales channels. The origin must be set as Fulfillment / Delivered by me in all promotions you offer as a seller.
In the example above, the promotion will be applied only to Marketplace - USA orders where the store is acting as a seller. The promotion will not be available in the VTEX storefront.
Inventory
When defining your shipping strategy, you may restrict the logistics routes available to certain sales channels through loading docks. Each loading dock linked to a sales channel makes inventory available through the warehouses connected to it.
Shipping
When defining your shipping strategy, you may restrict the logistics routes available to certain sales channels through loading docks. Each loading dock linked to a sales channel makes carriers and pick-up points available through the shipping policies connected to it.
Payment
When creating a payment condition, you may restrict its availability to certain sales channels through special conditions. If no restriction is made, it will be available in all sales channels.
Set up catalog notifications
Affiliates are used in VTEX to broadcast catalog notifications to marketplaces and other external services. These include changes in product information, price and quantity in stock.
To create an affiliate for an external marketplace, go to the Orders > Orders management > Settings section of your Admin, select the Affiliates tab and click on the New affiliate button. Then fill out the form according to the table below:
| Field | Description |
|---|---|
| Name | Marketplace display name in orders management |
| ID | 3-consonant identifier for marketplace orders |
| Sales Channel | ID of the sales channel defining channel settings |
| E-mail for notifications | E-mail address that will receive error notifications |
| Search Endpoint | URL of the marketplace endpoint that will receive catalog notifications |
Once the affiliate is created, take note of the affiliate ID before you move on to the next step.
If the external marketplace connector is still under development, you may postpone filling out the Search Endpoint field until its catalog notification endpoint is available.
Set up API authentication credentials
To allow the external marketplace connector to authenticate and interact with your account through API calls, you will need to create an appKey / appToken with the IntegrationProfile - Fulfillment Gateway Oms role or equivalent.
Once the authentication credentials are created, take note of the appKey / appToken pair so you can share it with the external marketplace.
For a matter of safety, the appToken is only shown once after you create it. Copy this token, save it in a safe place and share it only with the external marketplace.
Wrapping up
If you have done things correctly, you should be able to provide the following seller registration details to the external marketplace connector:
- Account Name
- Affiliate ID
- API Credentials
- Sales Channel ID