B2B Users from Contacts
In B2B business, the buyer is not "one person" but a company with several contact persons. The connector maps exactly that: the company account is the customer, and the users who can log in are the contacts of that customer – each with a role.
Customer & contact – how they work together
The customer must be uploaded as a web customer – it represents the company account in Shopware.
Every contact of the customer can be transferred as a separate B2B user who can log in.
Contacts are assigned to the company account by the Customer ID of the customer; if this is not unique, the email address is used as a fallback.
The customer always remains the basis. Therefore, run the customer upload first before you upload contacts as B2B users.
Roles
View
May view and forward for approval.
Orderer
May view and create orders.
Approval
May view, create, and approve.
For details about the approval process, see B2B Roles & Approval Process.
Setup (configuration)
In the B2B Contacts area of the Shopware configuration:
Upload Contacts as B2B Users
Master switch for the feature
B2B Language ID
Language of new B2B users
B2B Role ID (View)
Shopware role ID for "View"
B2B Role ID (Orderer)
Shopware role ID for "Orderer"
B2B Role ID (Approval)
Shopware role ID for "Approval"
B2B Email Substitute Domain
Domain for the substitute email if the contact has no email address
Login email (with fallback)
The email address of the contact is used as the login by default.
If it is missing, the connector builds a substitute address following the pattern
{KontaktNr}@{DebitorNr}.{Ersatz-Domain}.
Without a configured substitute domain, contacts without their own email address cannot be created. Enter the domain if you also want to transfer contacts without an email address.
Procedure
Upload the customer as a web customer
Set Web Customer = Yes and run the customer upload. The customer receives a Web-ID.
Assign roles
Assign the required role (View, Orderer, Approval) to the contacts.
Upload B2B users
Use Upload B2B Users – available both on the Customer Card (all contacts) and on the Contact Card (a single contact).
Check
Use Check B2B User (API) to read the user back from Shopware and verify that it was created.
Where do I find the actions?
Customer Card
Upload B2B users for all contacts, activity log
Contact Card
Set the role, upload a single B2B user, check via API
An activity log on the contact and customer cards helps you track the uploads. Errors additionally appear in the Activity Log.
Troubleshooting
The B2B user is not created
Has the customer been uploaded as a web customer (is a Web-ID present)?
Is Upload Contacts as B2B Users enabled?
Have the role IDs been entered?
Does the contact have an email address – or is a substitute domain configured?
The contact is assigned to the wrong company account
Check the Customer ID link between the contact and the customer. If it is not unique, the email fallback applies – in that case, make sure the email addresses are unique.
Logging in to the shop does not work
The login email corresponds to the contact's email address or to the generated substitute address. Check which address was actually transferred (using Check B2B User (API)).
Related topics