Search subscription
In the tebio business portal you have various ways to find a specific subscription. Many users look for a subscription through the associated customer. A direct subscription search is also available.
When do I need this function?
Section titled “When do I need this function?”Finding a subscription is the first step for many administrative tasks, such as pausing, canceling, or switching products. Which search method you choose depends on what information you have:
- You know the customer, for example name, email address or company: Use method 1 via the customer view.
- You have a subscription reference, for example from a support ticket: Use method 2 via the direct subscription search.
Requirements
Section titled “Requirements”- You need access to the tebio business portal.
- For the direct subscription search: The subscription must have already been created in the system. Important: If a future start date was specified when ordering, the subscription may not yet exist and cannot yet be found using the direct search. In this case you will only find the waiting order in the customer file.
Step-by-step instructions
Section titled “Step-by-step instructions”Way 1: Customer-based search (CRM approach)
Section titled “Way 1: Customer-based search (CRM approach)”This approach is often helpful in everyday life because it directly shows the customer context.
- Click on Customers in the main menu.
- Search for the person or company you want (e.g. by name or email address).
- Open the customer file by clicking on the hit.
- The Subscriptions tab is open by default when calling a customer.
- You’ll see a list of this customer’s active, paused, or canceled subscriptions.
Way 2: The direct subscription search
Section titled “Way 2: The direct subscription search”If you don’t want to search for a specific customer but want to filter directly by subscriptions, use this method.
- In the main menu, click Subscriptions or Subscriptions, depending on the name in your portal.
- The global list view of all subscriptions in your system opens.
- Use the search and filter fields at the top to narrow down the list:
- Product name: Finds subscriptions for a specific product.
- Subscription Reference: Use this field if you are looking for a specific subscription or subscription reference. Enter the specific reference here.
- Customer/Partner: Filters based on whether the subscription is assigned to a customer or sales partner.
- Status: Filters subscriptions by status, for example paused, suspended, or disabled.
Result
Section titled “Result”Once you have found the subscription you are looking for (whether via route 1 or route 2), simply click on the relevant list entry.
This opens the detailed view of the subscription. There you can see important metadata, upcoming events and previous event history.
(Note: You can find out how to work in the detailed view and modify contracts in the article Edit subscription.)
Notes and typical errors
Section titled “Notes and typical errors”- Search without hits: If you enter a subscription reference and don’t get a hit, check the status filter. Deactivated or canceled subscriptions may be hidden in standard views. In this case, delete the status filter (empty field) to search across all historical contracts.
- Customer vs. Partner Agreement: Subscriptions that are assigned to a sales partner (e.g. for an agency collective billing) only appear in the search if the “Customer/Partner” dropdown is configured accordingly.
API Notes
Section titled “API Notes”For external systems or headless integrations, search and retrieval functions are available via the API:
| End point | Method | Description | OperationId |
|---|---|---|---|
/v1/subscription | GET | Search subscriptions based on search parameters | searchSubscription |
/v1/subscription/{uuid} | GET | Get details of a subscription | getSubscription |
/v1/subscription/extSubscriptionRef/{extSubscriptionRef} | GET | Retrieve subscription using an external reference | getSubscriptionByExtSubscriptionRef |