Bulk Upload Suppliers
Overview
When you need to create several suppliers at once, use the bulk upload instead of the Create form. You fill a spreadsheet template, upload it, and kolum creates one supplier per row, each with a default contact person. The same template serves CBAM and EUDR, because a supplier is one record for both.
Before you start
- A role with permission to manage master data.
- For each supplier: a unique identifier from your own systems, name, address, and the contact person's name, phone, and email.
Step by step
- Go to Suppliers in the sidebar and open Upload & Download.
- Download a fresh copy of the template and fill one supplier per row.
- Upload the completed file and review the preview.
- Confirm to import. The new suppliers appear in the Suppliers list.
Template columns
| Column | Required | Notes |
|---|---|---|
| Identifier | Yes | Your unique identifier for the supplier. Never generated for you: a blank cell makes the row invalid, and an identifier already used by a supplier in your account is rejected as a conflict. |
| Name | Yes | Legal or trading name. |
| Postal Code / City / Country | Yes | Country is an ISO 3166-1 alpha-2 code. |
| Street Name / Street Number / Post Office Box | No | Street address. |
| Contact Person First Name / Last Name | Yes | The default contact. |
| Contact Person Phone Number | Yes | Include the country code. |
| Contact Person E-Mail | Yes | Used for connection invitations. |
| BPN | No | The Catena-X Business Partner Number. Leave empty if you do not use Catena-X. |
Every column is explained in full on the Supplier upload template glossary page.
ℹ️ The upload creates the supplier and its contact. Production locations (plot geolocation) and compliance documents are added separately, on each supplier's EUDR tab or with Upload Production Locations. See Provide production locations and documents.
Tips
- Use accurate contact emails; they are what connection invitations are sent to after import.
- Keep identifiers consistent with the ones you use on the imports and supplier production facilities uploads, so records link cleanly. To see which identifiers are already taken, export your supplier list first.
- Because an existing identifier is rejected rather than duplicated, uploading the same file twice does not create a second set of suppliers.
Troubleshooting
- A row failed to import. The usual cause is a blank or already-used Identifier, a missing required field such as Name, Postal Code, City, Country, or the contact person's name and email, or two rows in the file sharing the same new identifier.
- A country was rejected. Use the ISO 3166-1 alpha-2 code, not the full country name.
ℹ️ Regulatory context. Suppliers are where EUDR due diligence data originates. Their plot geolocation, required under Article 9, is added separately on the EUDR tab. See the consolidated EUDR text.
Common Questions
What's new
Suppliers for EUDR are uploaded with the same template as for CBAM, from the unified Suppliers section. Your own identifier is the key of every row, repeated uploads never create duplicates, and an optional BPN column covers Catena-X.