Documentation
Feedback
Guides
VTEX IO Apps

VTEX IO Apps
B2B Suite
Official extension
Version: 0.3.1
Latest version: 0.3.1

{"base64":"  ","img":{"width":110,"height":20,"type":"svg","mime":"image/svg+xml","wUnits":"px","hUnits":"px","url":"https://img.shields.io/badge/all_contributors-0-orange.svg?style=flat-square"}}

B2B Suite is a collection of VTEX IO apps that allow stores to manage organizations, storefront roles and permissions, and checkout settings for B2B commerce relationships.

These features are particularly useful for B2B stores: in commerce relations between businesses, it is essential to simplify the purchase flow, reduce costs, and provide a personalized buying experience.

B2B customers frequently have distinct roles within their organization, such as professional buyers, managers, or supervisors. Each role is associated with a different set of storefront permissions, depending on the actions the user needs to perform.

Grouping different users from the same company under an organization and defining custom payment methods, product selections, and prices for each customer are also everyday needs in B2B.

In addition, it is often necessary to provide customized options for B2B customers during checkout, such as a specific selection of payment methods per organization or cost center, pre-filled addresses, purchase order numbers, and order quotes.

By installing the B2B Suite, you have access to seven apps with the following features for B2B:

App nameDescription
Storefront PermissionsStores a predefined set of roles and permissions related to what B2B users can access and do in the storefront, which other integrated apps can check. This is useful for stores that want to set specific permissions for users with different organizational roles.
Storefront Permissions UIProvides an interface for the Storefront Permissions app, communicates with its stored roles and permissions, and provides the following features for this scenario. Role management: Allows VTEX Admin users to manage B2B roles and associated app permissions through an interface. Theme block configuration: Enables conditional theme blocks so only users with the required permissions can access specific content in your storefront.
B2B OrganizationsEnables you to group B2B users into organizations to which you can assign specific payment methods, price tables, and product collections. This allows all organization users to share the same commercial conditions. Each organization is further segmented into one or more cost centers, with its own shipping addresses, which will be available for cost center users at checkout.
B2B QuotesEnables B2B users to create quotes and saved carts, which are then shared with the other members of their organization. Users with the appropriate storefront permissions can modify quotes to apply discounts or change the amount of items, so the resulting quote can then be used to place an order.
B2B Checkout SettingsExtends the checkout experience for users who are members of B2B organizations. With this app, you can allow specific payment methods for the user's organization, provide prefilled addresses based on the cost center of each user, add a purchase order number to the order, and allow customers to create an order quote before placing the order.
B2B Orders HistoryProvides a new Orders page under My Account so that B2B users can view all previous orders placed by users in their organization or cost center, depending on their role.
B2B Admin CustomersProvides additional customer information management capabilities on the VTEX Admin, allowing store administrators to create, edit, and search for customers.

Make sure to read the documentation for each app to learn more about their features and settings.

After installing B2B Suite, make sure to hide the default Order History link within My Account by configuring vtex.my-account. Otherwise, B2B Orders History will not work as expected. You can do this at https://{{accountName}}.myvtex.com/admin/apps/vtex.my-account@1.x/setup/, by unselecting the Visible option in the Orders section.

For additional features, you can also install the Quick Order app, which creates a custom page in your store aimed at bulk purchases, offering tools such as uploading a spreadsheet to make bulk orders more agile.

Frequently Asked Questions

How do I fix the schema issue?

If you are getting alerts on B2B apps regarding a schema issue, please follow the steps below:

  1. Open the VTEX Admin, and click the Master Data link on the left side of the screen.

    {"base64":"  ","img":{"width":3782,"height":2796,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":670200,"url":"https://raw.githubusercontent.com/vtex-apps/b2b-suite/main/docs/assets/schema-1.png"}}

  2. After logging in, click Advanced settings as shown in the image below:

    {"base64":"  ","img":{"width":4496,"height":2690,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":323865,"url":"https://raw.githubusercontent.com/vtex-apps/b2b-suite/main/docs/assets/schema-2.png"}}

  3. Click the last link in the list:

    {"base64":"  ","img":{"width":3644,"height":1892,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":253198,"url":"https://raw.githubusercontent.com/vtex-apps/b2b-suite/main/docs/assets/schema-3.png"}}

  4. Click Data Entities, find the CL row, and click the Edit button as shown in the image below:

    {"base64":"  ","img":{"width":4468,"height":2032,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":479149,"url":"https://raw.githubusercontent.com/vtex-apps/b2b-suite/main/docs/assets/schema-4.png"}}

  5. Find the unchecked field that is nullable and check it. Only the email field must be unchecked.

    {"base64":"  ","img":{"width":2298,"height":2778,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":548770,"url":"https://raw.githubusercontent.com/vtex-apps/b2b-suite/main/docs/assets/schema-5.png"}}

  6. Click Save.

    {"base64":"  ","img":{"width":1224,"height":712,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":79625,"url":"https://raw.githubusercontent.com/vtex-apps/b2b-suite/main/docs/assets/schema-6.png"}}

  7. Click the Publish button to apply the changes:

    {"base64":"  ","img":{"width":3600,"height":1836,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":570179,"url":"https://raw.githubusercontent.com/vtex-apps/b2b-suite/main/docs/assets/schema-7.png"}}

See also
VTEX App Store
VTEX IO Apps