Create customers
Customer management is a central component of the tebio business portal, as every order and every subscription must always be assigned a unique customer.
When do I need this function?
Section titled “When do I need this function?”You need this function if you want to manually enter a new prospect or customer in the system in order to then assign offers, products or subscriptions to them.
Requirements
Section titled “Requirements”- You need access to the Customers menu item in the business portal (assuming you have the appropriate user role).
- Customer creation can be done entirely in the tebio business portal. External systems are not required for this.
Step-by-step instructions
Section titled “Step-by-step instructions”You can access the customer overview in the portal via the main menu under Customers. There you will see a tabular list of your existing customer base. To enter a new customer manually, click on the green Create customer button at the top right.
1. Select customer type (private vs. business)
Section titled “1. Select customer type (private vs. business)”Right at the beginning of the form, you can use the Type drop-down field to specify whether it is a private customer (PRIVAT, B2C) or a business customer (BUSINESS, B2B). This selection changes the following input mask, as other mandatory tax information applies to business customers.
Private customers (B2C)
Section titled “Private customers (B2C)”If you choose the type PRIVAT, the mask focuses on specifying first name, last name and date of birth. All three fields are initially marked as optional for private customers, as often only the email address is required for pure registration. However, this data may be required for later invoicing, communication or contract processing.
[!TIP] Create customer without email address and user account You can activate the switch of the same name next to the email field. This is useful if you create a customer who should not have access to the self-care / customer portal or who is cared for outside of digital self-service processes. In this case, the email requirement does not apply.
Business customers (BUSINESS)
Section titled “Business customers (BUSINESS)”The mask is more comprehensive for B2B customers. The Company name is a mandatory field to ensure correct invoicing to business partners.
You will also find specific fields here such as the legal form, the commercial register number (under More options) and in particular the **Buyer Tax Category) right next to the VAT ID.
[!IMPORTANT] Automatic tax category The Tax Category (Buyer) field is read-only when creating a business customer. It will be calculated automatically by the system as soon as you have entered the corresponding billing address and VAT ID further down in the form.
2. Optional master data and properties
Section titled “2. Optional master data and properties”Expand the More Options section to capture additional metadata about the customer:
- Internal note: A comment box for your support team. This note is not visible to the end customer.
- External customer reference: If you connect tebio to your ERP or CRM system, you can enter the ID from the third-party system here (e.g.
CUST-9923). - Properties: Using the drop-down selection, you can assign previously defined Custom Fields (Customer Properties) to the customer (e.g. “Lead Source” or “Priority”).
3. Enter addresses
Section titled “3. Enter addresses”Capturing a valid billing address is critical, especially for business customers.
To ensure correct invoicing and taxation of your customer, enter at least one valid billing address.
The address panel is therefore opened by default.
- For business customers (BUSINESS), entering the address is mandatory, as this is the only way (in combination with the legal form and VAT ID) that the system can determine the correct taxation (e.g. reverse charge procedure in other EU countries).
- If the billing and shipping addresses are the same, simply activate the use as shipping address switch at the end of the address block.
4. User account for the self-care / customer portal
Section titled “4. User account for the self-care / customer portal”Unless you have created the customer without an email address and user account, you can prepare a user account for the self-care / customer portal in the last section:
- Username: Is automatically prefilled by the system according to the pattern
vorname.nachname. If this user name is already taken, the system will automatically suggest up to three similar alternatives that are still available. - Authentication method: Choose how the customer should log in (e.g. via OTP via email or with a classic password).
- Actions required: Check Verify email to ask the customer to confirm their address via a link when they first log in.
Finally click on Save to create the customer.
Result
Section titled “Result”After saving, the new customer immediately appears in the customer list. You can now open the customer profile and in the next step book subscriptions for this customer or create helpdesk tickets.
Notes and typical errors
Section titled “Notes and typical errors”- Invalid VAT ID for B2B customers: Make sure to enter the sales tax identification number (VAT ID) correctly formatted (including country code), otherwise the automatic tax calculation, for example for the reverse charge procedure in other EU countries, may fail.
- Forgot email verification: If customers want to log in to the self-care / customer portal but are not given access, the Verify email action was often not selected when creating the account or the customer was created without a user account.
API Notes
Section titled “API Notes”Creating and managing customers is a common API integration case, for example to connect an external CRM system.
[!TIP] When making the API call
Create a customerfor the typeBUSINESS, make sure that you send the blockaddressfor the billing address in the payload. The address is required so that the tax category can be calculated correctly.
| End point | Method | Description | OperationId |
|---|---|---|---|
/v1/customer | POST | Create customers | createCustomer |
/v1/customer | GET | Search customers (list) | searchCustomer |
/v1/customer/{uuid} | GET | Retrieve customers | getCustomer |