Create suppliers
There are two ways to create suppliers in Akeneo Onboarder:
- Fill in the supplier form,
- Import a flat files.
When creating a supplier, you must provide the following information:
| Name | Code | Definition | Requirement |
|---|---|---|---|
| Supplier code | code | The code of the supplier | Required |
| Supplier name | name | The name of the supplier | Required |
| Supplier contact emails | supplier_contact_emails | List of supplier contact emails | Required |
| PIM user(s) | retailer_contact_usernames | List main PIM user(s) in charge of this supplier | Required |
| Catalog locales | catalog_locales | List all catalog locales you want your supplier to enrich | Required |
| Default locale for display | user_default_locale | The default locale to display the interface. The supplier user can change it afterward. | Required |
| Families | families | List all families the supplier can enrich | Required |
| Product creation | allow_product_creation | Toggle to authorize product creation by the supplier. | Optional |
Once you've created the suppliers, you can directly see them in the suppliers' grid.
For example, your excel file could look like this:
When you create a supplier, the supplier contact receives a welcome email.
The suppliers cannot create product models and variants. You'll need to link them with each product variant.
Use the interface
Before creating a supplier, make sure you already created the supplier contact associated to it.
You can directly create and edit the supplier from the interface by following these steps:
- Access your Onboarder from the PIM,
- Click on Suppliers
- Click on Create
- Fill in the required information (see supplier definition to learn more about the expected properties)
- Save
Your supplier is created.
Use flat-file import
You can also use CSV or XLSX files to import suppliers. You can download a template containing the header with the code for each column.
When you fill in the supplier_contact_emails, retailer_contact_usernames, catalog_locales, families, columns the values must be separated by comas.
And the allow_product_creation column is boolean with 0 for No and 1 for Yes.
Formerly the supplier_contact_emails column was named supplier_referent_email. To continue using the same import file you were using, you must change this column header.
Then you can create your suppliers with the file you completed by following these steps:
- Access your Onboarder from the PIM,
- Click on Import on the Suppliers page,
- Select CSV or XLSX,
- Click on Upload a file,
- Drag your file in the drop area or browse disk,
- Click on Upload and import now.
You are redirected to the Process tracker page, where you can follow the import progress and your suppliers are created.
Delete supplier
During your use of Onboarder, you may need to delete suppliers for different reasons. There are two ways to proceed:
- From the supplier page
- From suppliers list
In both cases, you'll need to confirm this action.
Once you choose to delete a supplier, there are several consequences you should be aware of:
- All the supplier contacts connected to this supplier will be unlinked from it and will no longer have access to Akeneo Onboarder,
- The supplier and supplier ref of products that are assigned to the deleted supplier will be purged at the same time,
- All data stored in Akeneo Onboarder will be deleted (products, their values and assets). Make sure they completed all required data, and you have it into the PIM before you proceed to deletion.
If, after some time, you decide to create a supplier that has been previously removed, the data won't be recovered as a new supplier will be created from scratch.