Add properties
In many cases, standard customer master data such as name, address and email address are not sufficient to map internal processes or additional information. tebio offers custom fields that can be assigned to a customer as properties.
When do I need this function?
Section titled “When do I need this function?”You need this function if you want to store additional customer-related information in the tebio business portal. Examples are:
- Sales data: for example lead source or priority.
- Billing-specific information: for example payment by standing order or special conditions until.
- Service level: for example assignment to a specific price zone or an internal supervisor.
Assigned properties can be used for filters in the customer overview or for automated processes via the API.
Requirements
Section titled “Requirements”- The properties must exist: Before you can assign a property to a customer, this property must have been created in the Configure properties area. If the property drop-down box is empty, no appropriate property has been configured yet. For more information, see Configuring properties.
- Permission: You need permission to edit customer data.
- Customer: The customer to whom the property should be assigned must already exist.
Step-by-step instructions
Section titled “Step-by-step instructions”The assignment of properties takes place in the detailed view of a specific customer. Alternatively, properties can also be managed directly when creating a customer or via Edit Customer.
1. Call up the customer profile
Section titled “1. Call up the customer profile”Find the desired customer in the customer overview and click on the customer entry to open the detailed view.
2. Open the properties dialog
Section titled “2. Open the properties dialog”In the profile view’s left info card, scroll down until you see the Properties section.
If the customer has not yet been assigned a property, it will say No Properties Existed. Click + Add Properties.
3. Select a property
Section titled “3. Select a property”A dialog opens. Click the Customer Properties (Custom Fields) drop-down box. tebio displays a list of all configured properties, for example payment by or price zone personal.
Select the desired property.
4. Enter the value
Section titled “4. Enter the value”Once you select a property, the Property Value field appears. The input format depends on how the property was configured:
- If the property is defined as a dropdown, select a predefined value, for example standing order.
- If the property is defined as a text field, enter the value manually.
[!TIP] Create multiple properties at once You can assign multiple properties to a customer at the same time. To do this, click + Add more. To remove an entry before saving, click the trash can icon next to it.
Finally click Save.
Result
Section titled “Result”The property is now linked to the customer and is displayed in the left info card of the detailed view.
Notes and typical errors
Section titled “Notes and typical errors”- Delete properties: You can remove assigned properties again. To do this, open the customer’s properties dialog again, click on the trash can icon next to the corresponding property and save the change.
- Empty Dropdown: If the Customer Properties dropdown box is left blank, no properties have yet been defined for the Customer entity in Settings > Configure Properties.
API Notes
Section titled “API Notes”Custom properties are passed in the customer payload as a JSON array.
[!TIP] Example payload: To assign properties via the API, use the properties array within the PUT /v1/customer/{uuid} request. Each object in the array must contain the key name of the configured property and the desired value.
| End point | Method | Description | OperationId |
|---|---|---|---|
/v1/customer/{uuid} | PUT | Update customer data including properties | updateCustomer |