B2B Easy Set Up is an app that helps you quickly get your store configured for B2B ecommerce.
Installation
- Download and install the VTEX IO CLI.
- Log in to your account with
vtex login {accountName}
. - Create a new workspace with
vtex use easysetupworkspace
. - Install the app on your store with
vtex install vtex.easy-setup
.
We strongly advise that you do not run Easy Setup on a production environment. It will make irreversible changes and may delete some previous configurations on your store.
Store configuration
Now that the Easy Setup app is installed in your store, proceed to operate the app on the Admin.
-
Open your Admin panel and navigate to Store Settings > Easy Setup.
-
On the right side of the screen, select which resources you want to apply on your store. If you want to configure all the options, select All Resources.
If you are using the B2B Suite solution, you must not select the Organizations resource. Otherwise this will alter the user profile Master Data schema and prevent the B2B Suite apps from creating users."
-
Click on the
Start Easy Setup
button. -
Click on the
I Understand
button that will appear in the Are you sure you want to proceed? dialog.
Once you click
I Understand
, this step is irreversible.
Wait a few seconds for the setup to complete.
When the configuration is complete, you will receive a positive feedback on the screen.
️ If you get an error message for some of the resources, try again this time only selecting the troublesome resources. If the error persists, contact support.
Check out the Resources section below for details on the sample data used by the app in the initial setup.
Resources
Users
This resource creates some users with priceTables
data.
View Sample Data
- Email:
john@email.com
- PriceTable: platinum
- Email:
steven@email.com
- PriceTable: gold
- Email:
chris@email.com
- PriceTable: silver
Brands
This resource creates one brand.
View Sample Data
- Name: Brand (9280)
Categories
This resource creates seven categories.
View Sample Data
- Name: Apparel (9281)
- Name: Food and beverage (9282)
- Name: Sporting (9283)
- Name: Agribusiness (9284)
- Name: Home Appliance (9285)
- Name: Computer & Software (9286)
- Name: Power tools (9287)
Collections
This resource creates a collection with all products.
View Sample Data
- Name: All
- Type: Inclusive
- BrandId: 9280 (Brand)
Fields
This resource creates a group with two fields containing a variety of field values for two specifics categories.
View Sample Data
- Group: Specifications
- Category: Apparel (9281)
- Field: Clothes Size
- Field Values: S, M, L and XL
- Category: Sporting (9283)
- Field: Shoes Size
- Field Values: 8, 8.5, 9, 9.5 and 10
Products
This resource creates an assortment of products and SKUs and sets their specifications, images and attachments (related to customizations and subscriptions).
View Sample Data
- Product Name: adidas Men's Performance Polo - Blast Blue (880001)
- SKU Name: S (880010)
- SKU Name: M (880011)
- SKU Name: L (880012)
- SKU Name: XL (880013)
- Product Name: adidas Men's Performance Polo - Green Night (880002)
- SKU Name: S (880020)
- SKU Name: M (880021)
- SKU Name: L (880022)
- SKU Name: XL (880023)
- Product Name: adidas Women's Microdot Polo - Night Indigo (880003)
- SKU Name: S (880030)
- SKU Name: M (880031)
- SKU Name: L (880032)
- SKU Name: XL (880033)
- Product Name: adidas Women's Microdot Polo - True Pink (880004)
- SKU Name: S (880040)
- SKU Name: M (880041)
- SKU Name: L (880042)
- SKU Name: XL (880043)
- Product Name: Yellow Onions (10 lbs.) (880026)
- SKU Name: same name (880260)
- Product Name: Cauliflower Fresh (880027)
- SKU Name: same name (880270)
- Product Name: Asparagus Green Conventional (880028)
- SKU Name: same name (880280)
- Product Name: Fresh Hass Avocadoes (880029)
- SKU Name: same name (880290)
- Product Name: Fresh Coconuts (880030)
- SKU Name: same name (880300)
- Product Name: Whole Watermelon Mini Fresh (880031)
- SKU Name: same name (880310)
- Product Name: Navel Oranges Grown Large Fresh (880032)
- SKU Name: same name (880320)
- Product Name: Navel Oranges Grown Large Fresh, Pack of 10 (880039)
- SKU Kit: same name (880390)
- SKU Components: 10un of Navel Oranges Grown Large Fresh
- Product Name: Nike Men's Roshe G Spikeless Golf Shoes (880005)
- SKU Name: 8 (880050)
- SKU Name: 8.5 (880051)
- SKU Name: 9 (880052)
- SKU Name: 9.5 (880053)
- SKU Name: 10 (880054)
- Product Name: Nike Men's Air Max 1 G Spikeless Golf Shoes (880006)
- SKU Name: 8 (880060)
- SKU Name: 8.5 (880061)
- SKU Name: 9 (880062)
- SKU Name: 9.5 (880063)
- SKU Name: 10 (880064)
- Product Name: Nike Air Max 270 G Spikeless Golf Shoes (880007)
- SKU Name: 8 (880070)
- SKU Name: 8.5 (880071)
- SKU Name: 9 (880072)
- SKU Name: 9.5 (880073)
- SKU Name: 10 (880074)
- Product Name: Skechers Women's Go Golf Drive 4 Dogs At Play Spikeless Golf Shoes (880008)
- SKU Name: 8 (880080)
- SKU Name: 8.5 (880081)
- SKU Name: 9 (880082)
- SKU Name: 9.5 (880083)
- SKU Name: 10 (880084)
- Product Name: 2020 APACHE AS1040 (880033)
- SKU Name: same name (880330)
- Product Name: 2 POST CANOPY (880034)
- SKU Name: same name (880340)
- Product Name: 2020 AMACSA PH390 (880035)
- SKU Name: same name (880350)
- Product Name: Faceplate Combine Snout (880036)
- SKU Name: same name (880360)
- Product Name: 2016 MK MARTIN ENT MKGB788 Blades/Box Scraper (880037)
- SKU Name: same name (880370)
- Product Name: 1998 JOHN DEERE 8400T (880038)
- SKU Name: same name (880380)
- Product Name: Weber 45010001 Spirit II E-310 3-Burner Liquid Propane Grill, Black (880021)
- SKU Name: same name (880210)
- Product Name: iRobot Roomba 675 Robot Vacuum-Wi-Fi Connectivity, Works with Alexa, Good for Pet Hair, Carpets, Hard Floors, Self-Charging (880022)
- SKU Name: same name (880220)
- Product Name: ALROCKET Dehumidifier 35oz(1000ml) Small Dehumidifier for 2100 Cubic Feet (260 sq ft) Portable and Compact Ultra Quiet (880023)
- SKU Name: same name (880230)
- Product Name: McCulloch MC1375 Canister Steam Cleaner with 20 Accessories (880024)
- SKU Name: same name (880240)
- Product Name: Cuisinart GR-4N 5-in-1 Griddler (880025)
- SKU Name: same name (880250)
- Product Name: Acer Aspire Z24-890-UA91 AIO Desktop - Windows 10 (880015)
- SKU Name: same name (880150)
- Product Name: Lenovo IdeaCentre AIO 3 - Windows 10 (880016)
- SKU Name: same name (880160)
- Product Name: Acer Aspire TC-885-UA92 Desktop - Windows 10 (880017)
- SKU Name: same name (880170)
- Product Name: CYBERPOWERPC Gamer Xtreme VR Gaming PC - Windows 10 (880018)
- SKU Name: same name (880180)
- Product Name: Acer Aspire 5 Slim Laptop - Windows 10 (880019)
- SKU Name: same name (880190)
- Product Name: Jumper EZbook X3 Windows 10 Laptop (880020)
- SKU Name: same name (880200)
- Product Name: Acer Aspire z24 890 + Acer Aspire ATC 885 (880040)
- SKU Kit: same name (880400)
- SkuComponents:
- 1un of Acer Aspire Z24-890-UA91 AIO Desktop - Windows 10 (880015)
- 1un of Acer Aspire TC-885-UA92 Desktop - Windows 10 (880017)
- Product Name: BLACK+DECKER 20V MAX Drill & Home Tool Kit, 68 Piece (LDX120PK),Black/Orange (880009)
- SKU Name: same name (880090)
- Product Name: BLACK+DECKER 20V MAX Cordless Drill / Driver with 30-Piece Accessories (LD120VA) (880010)
- SKU Name: same name (880100)
- Product Name: BLACK+DECKER 20V Max Cordless Chainsaw, 10-Inch, Tool Only (LCS1020B) (880011)
- SKU Name: same name (880110)
- Product Name: BLACK+DECKER 20V MAX Cordless Drill Combo Kit, 2-Tool (BD2KITCDDI),Black/Orange Impact Combo Kit (880012)
- SKU Name: same name (880120)
- Product Name: BLACK+DECKER 20V MAX 5-1/2-Inch Cordless Circular Saw, Tool Only (BDCCS20B) (880013)
- SKU Name: same name (880130)
- Product Name: BLACK+DECKER 20V MAX 5-1/2-Inch Cordless Circular Saw (BDCCS20C) (880014)
- SKU Name: same name (880140)
Category: Apparel (9281)
Category: Food and beverage (9282)
Category: Sporting (9283)
Category: Agribusiness (9284)
Category: Home Appliance (9285)
Category: Computer & Software (9286)
Category: Power tools (9287)
Attachments
Customization
View Sample Data
- Name: T-Shirt Customization (T-Shirt Name - 15 characters)
- Products: adidas Men's Performance Polo - Blast Blue (880001)
Subscriptions
It is mandatory to follow these additional steps if you want to enable subscriptions.
View Sample Data
- Name: Subscription
- Products: All from category Food and beverage (9282)
Prices
This resource sets sample prices and price tables.
Most products
View Sample Data
- ListPrice: 30.00
- BasePrice: between 50.00 and 2000.00
- Markup: 0%
Quantity prices
View Sample Data
- Product Name: BLACK+DECKER 20V MAX Cordless Drill / Driver with 30-Piece Accessories (LD120VA) (880100)
- ListPrice: null
- BasePrice: 100.00
- FixedPrices:
- Minimum Quantity: 1
- Value: 100.00
- Minimum Quantity: 10
- Value: 90.00
- Minimum Quantity: 50
- Value: 80.00
- Minimum Quantity: 100
- Value: 70.00
Price Tables
View Sample Data
- Name: silver
- Percentual Modifier: -5%
- Name: gold
- Percentual Modifier: -10%
- Name: platinum
- Percentual Modifier: -15%
Payments
This resource sets 3 affiliations (Promissory, Test and CreditControlV2), the custom payment Promissories and the payment condition using them, the VISA credit card condition and the Customer Credit condition.
View Sample Data
- Affiliation: Promissory
- Custom Payment: Promissory (201)
- Payment Condition: Promissory
- Affiliation: Test
- Payment Condition: VISA (credit card)
- Affiliation: CreditControlV2
- Payment Conditions:
- 15 days (0% interest)
- 30 days (0% interest)
- 15 and 30 days (1% interest)
- 15, 30 and 45 days (1.5% interest)
Benefits
This resource sets a Progressive Discount promotion.
View Sample Data
- Name: Progressive Discount
- Conditions:
- Start: 2010-01-01
- End: 2070-01-01
- Collection: All
- Benefit:
- Quantity: 5
- Discount: 5%
- Quantity: 10
- Discount: 15%
- Quantity: 15
- Discount: 25%
- Quantity: 20
- Discount: 35%
Taxes
This resource sets VAT and ICMS taxes.
View Sample Data
- Name: VAT
- Condition:
- Start: 2010-01-01
- End: 2070-01-01
- Category: Agribusiness (9284)
- Tax: 5%
- Name: ICMS
- Condition:
- Start: 2010-01-01
- End: 2070-01-01
- Category: Agribusiness (9284)
- Tax: 12%
Logistics
This resource updates the Logistics module using sample docks, warehouse and carrier.
View Sample Data
- Freight Values:
- Country: BRA
- ZipCodeStart: 0
- ZipCodeEnd: 9999999
- Country: USA
- ZipCodeStart: 0
- ZipCodeEnd: 99999999
- Docks:
- Name: Doca Principal (1)
- Country: BRA
- Name: Main Dock (2)
- Country: USA
- Warehouse:
- Name: Estoque (1_1)
- Docks:
- Doca Principal (1)
- Main Dock (2)
Organizations
This resource creates Master Data schemas that are necessary to set up Roles and Permissions in your store's Admin, as described in this guide.