How to Set Up Customers in Business Central Portal
In the Customer Portal for Microsoft Dynamics 365 Business Central, your customers sign in to track orders, create and view quotations and sales orders, and see invoices, balances and payment history. Each person who signs in is a customer contact with portal access. This article covers the role, the user form, and how to add and give access to customer contacts.
Before you start
- Connect Business Central to the portal. See How to Connect Business Central to CRMJetty Portal.
- Enable the tables customers need, such as sales orders and invoices. See How to Configure Business Central Table Sync.
- Set up SMTP, so customers receive verification and password emails. See How to Configure SMTP Email in CRMJetty Portal.
- Only admin users with access to add contacts can create customer contacts.
Where customer contacts come from
The Portal User Customer list shows customer contacts created in three ways:
| Source | How it gets there |
|---|---|
| Business Central | Contacts created in Business Central. |
| Admin portal | Contacts an admin creates on the Portal User Customer page. |
| Website | Contacts who register through the portal’s registration form. |
Step 1: Create a customer role
In Business Central, each portal user role has a Role Type of Customer or Vendor. Customers and vendors have different roles and permissions.
- Go to Settings → User Settings → Portal User Roles.
- Edit the Default role, or select Create to add a new role.
- Enter the Role Name, Status and Description.
- In Role Type, select Customer.
- Turn on Is Default if this should be the default role.
- Under Table Permissions, select View for each table customers should see.
- For each table, set the Relationship Type and select Add, Edit or Delete as needed.
- Select Save.
| Table permission | What it does |
|---|---|
| Table | The Business Central portal table name. |
| View | Lets customers see this table. |
| Relationship Type | Sets which records of the table customers can access. |
| Add, Edit, Delete | Let customers add, edit or delete records. |
| Enable Logs | Records logs for this permission. |
For all role options, see How to Create Portal User Roles and Permissions.
Step 2: Design the customer user form and list
The form and list you design here are what admins use to add customer contacts in the admin portal. They are not shown to portal users.
- Go to Settings → Portal Settings → Portal User Settings.
- In Select User Type, select the customer user type.
- On the list page, drag the fields you want into the list. You can’t remove required fields.
- On the form page, select the Add/Edit option.
- Add a section with the + icon, select Add Grid, then drag fields into the grid. Each grid box holds one field.
- Select Save, or Save & Preview to check the layout.
See How to Configure Portal User Settings and Layouts.
Step 3: Add a customer contact
- Go to Settings → User Settings → Portal User Customer.
- Select Create. The Create Contact page opens.
- Fill in the portal contact details. All mandatory fields are required.
- In Role, select a customer role. If you leave it empty, the contact gets the Default role.
- Select Save & Generate credential to send the contact an email with a verification link, or Save to create the contact without sending one.
If you save a contact as not approved, you can approve it and generate credentials later from the Portal User Customer list.
Step 4: Give existing contacts portal access
Contacts that come from Business Central need portal access before they can sign in. Use the Bulk Actions menu on the Portal User Customer list.
- Select one or more contacts.
- In Bulk Actions, select Enable. This works for new contacts and for contacts you disabled earlier.
- In the pop-up, select the role to assign and select Save.
- Review the summary, which shows Selected User, Disabled Users and Conversion Pending.
Approve customers who registered
If User Approval is turned on for the site, customers who register need admin approval.
- Select the contacts, then select Approve. The contacts get a verification link; their credentials are still pending.
- Or open the contact, select Approved, and select Save & Generate Credentials. This approves the contact and emails an access link.
See How to Enable Email Verification and Admin Approval.
Manage customer contacts
These options are in the Bulk Actions menu on the Portal User Customer list.
| Action | What it does |
|---|---|
| Approve | Approves selected contacts that registered and are waiting for approval. |
| Enable | Gives selected contacts portal access with the role you choose. |
| Disable | Removes portal access temporarily. A summary shows the result. |
| Assign New Role | Opens a pop-up where you choose a new role for the selected contacts. |
| Send Password Link | Emails a password reset link. A pop-up shows the delivery status. |
| Assign New Site | Shows a drop-down in the Assigned Sites column, where you pick one or more sites for each contact. |
| Delete | Deletes the selected contacts. |
To edit or delete one contact, select the three dots (…) next to it, then the Edit or Delete icon. Deleting asks you to confirm with OK.
Assign New Site is useful only if you run more than one portal site. The number of portal sites depends on your plan.
Note: This feature is available on selected plans. See Pricing.
Let customers register and sign in
- Registration: add the Registration widget to a page. In its settings, choose the Select Registration Form and use Select Role to give new customers a role.
- Sign-in: add the Login widget. Use Role-wise Redirection to send customers to their own landing page after login. See How to Redirect Users After Login by Role.
- Emails: under Settings → Portal Settings → Email Templates, the Customer Registration, Customer Confirm Email and Customer Approve templates send the set password link, the email confirmation link and the approval notice.
Troubleshooting
A customer doesn’t receive the verification or password email: Check SMTP under Settings → Portal Settings → SMTP Settings and send a test email. Check that the Customer Registration and Customer Confirm Email templates are active.
A customer contact from Business Central can’t sign in: The contact may not have portal access yet. Select it and use Bulk Actions → Enable.
A customer sees the wrong data: Check the contact’s role, its Role Type and the table permissions in that role.
Related articles
- Getting Started with Business Central Customer Portal
- How to Set Up a Business Central Vendor Portal
- How to Create Portal User Roles and Permissions
- How to Assign Roles to Portal Users in Bulk
- How to Let Customers Download Invoice PDFs