Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Tutorials
Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
B2B
B2B Organizations
Configuring bulk data import for organizations and cost centers
Configuring bulk data import for organizations and cost centers

Bulk data import simplifies the process of updating and maintaining information for buyer organizations, their users (members), and cost centers.

Before configuring the bulk import feature, you should have the B2B Suite installed in your store.

Here's how to import data in bulk into the VTEX platform:

  1. In the VTEX Admin, go to Apps > B2B Organizations & Cost Centers > Organizations, or type Organizations in the search bar at the top of the page.

  2. In the Organizations tab, click New, and then Bulk Import. Click the Upload button and select your XLSX file, or drag and drop the file into the dashed area. The imported file must be smaller than 50 MB.

If necessary, download a template file by clicking VTEX File Template at the bottom of the import window and enter the import data.

  1. Once the platform has verified the imported file and found no errors, click Import.

If the platform detects any errors, check the section Import errors.

  1. Once the import process is complete, you can click View Import Details to access the import report.

{"base64":"  ","img":{"width":1894,"height":947,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":348432,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/B2B/B2B%20Organizations/configuring-bulk-data-import-for-organizations-and-cost-centers_1.gif"}}

Import errors

During the import process, the system will check the file for errors. If errors are detected, you will be notified by email and receive a notification on your screen.

To get a detailed overview of the detected problems, follow the steps below:

  1. Click View Import Details to access the corresponding error report.
  2. Download the spreadsheet by clicking Download Reviewed XLSX. This spreadsheet shows the error details.
  3. After fixing the errors, you can restart the import process by uploading the corrected file again.

Make sure you only upload the file with corrections to the previously detected errors to ensure a successful import.

{"base64":"  ","img":{"width":1876,"height":926,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":388678,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/B2B/B2B%20Organizations/configuring-bulk-data-import-for-organizations-and-cost-centers_2.gif"}}

Bulk Import via API

You can also import information using the Bulk Import API, which allows you to validate and import files, as well as monitor the import progress and result.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback