Edit sales partners
After a sales partner has been created in the system, you can call up its detailed view. From here you can not only update the master data, but also manage related information such as payment agreements, addresses, users and associated sub-distribution partners.
When do I need this function?
Section titled “When do I need this function?”Use this feature if:
- the contractual or tax framework conditions (e.g. VAT ID, legal form) of the partner have changed.
- the sales partner should be assigned to a different sales region or a new account manager.
- You need to maintain address data (billing or delivery address).
- You want to assign new sub-distribution partners (UVPs) to the partner or view his commission statements.
Requirements
Section titled “Requirements”- You need administrative rights to edit sales partners.
- In order to change the status of a partner, no blocking dependencies (such as unpaid invoices) must exist in the system.
Step-by-step instructions
Section titled “Step-by-step instructions”1. Open detailed view
Section titled “1. Open detailed view”Search for the desired sales partner in the Sales partner search and click on the corresponding list entry to open the detailed view.
2. Edit master data
Section titled “2. Edit master data”On the left you can see the sales partner’s summary.
- Click on the Edit sales partner button.
- A dialog opens in which you can adjust the following fields:
- Status: Change the status (e.g. to
Aktivif the partner comes out of validation, orGesperrt). - Account Manager, Channel, Region and Language: Organizational assignments.
- Tax data: VAT ID, tax number, legal form and commercial register number.
- External reference: Your internal ID from third-party systems.
- Status: Change the status (e.g. to
- Save your changes.
(Note: You can adjust the partner’s admin user separately using the Edit user button).
3. Manage tabs
Section titled “3. Manage tabs”On the right-hand side you will find various tabs through which you can manage the partner’s linked data records:
- Addresses: Here you can see all stored addresses (e.g. billing and delivery addresses). Click on Edit to correct the address.
- Sub-distribution partners (RRP): Here you can see a list of all assigned sub-distribution partners. You can directly create a new sub-distribution partner for this distribution partner using the Create RRP buttons. With Add relationship you can link an existing partner to this partner as a sub-distribution partner.
- Invoices: This tab lists all commission invoices or service invoices generated for or by this partner. Here you can see the status, the amount and the due date at a glance.
- Payment agreements: This is where the deposited payment methods (e.g. PayPal, credit card) are managed, which may be used for billing.
Result
Section titled “Result”The changes to master data or linked elements are adopted after saving and - if configured - reported to your third-party systems via appropriate webhooks (e.g. salespartner.updated).
Notes and typical errors
Section titled “Notes and typical errors”- Required fields when changing status: Please note that certain fields (such as VAT ID or a valid address) must usually be filled out for activation (status
Aktiv). If these are missing, tebio returns a validation error. - Distinguish user account and sales partner: Make sure that master data of the sales partner company (such as the VAT ID) is changed via “Edit sales partner”, while personal data of the user account (such as the email address) must be maintained via “Edit user”.
API Notes
Section titled “API Notes”The functions described in this article can be automated using the following API endpoints:
| End point | Method | Description | OperationId |
|---|---|---|---|
/v1/salespartner/-uuid- | PATCH | Update sales partners | updateSalespartner |