Search for invoice
In the tebio business portal you will find a central overview of all generated billing documents in the finance area. In addition to invoices for postpaid products, receipts for prepaid products, canceled invoices and invoice corrections are also displayed here.
When do I need this function?
Section titled “When do I need this function?”Use this feature if you:
- Want to check whether and when a specific invoice is due or has been paid.
- You want to search for the corresponding invoice correction for a cancellation.
- Need an overview of all open items for a specific customer.
- Need to look up a specific invoice number as part of a support request.
Requirements and limitations
Section titled “Requirements and limitations”- Permissions: In order to open the detailed view of an invoice from the list, you need appropriate reading rights in the Finance area.
- Delayed visibility: Depending on the configuration of the product and the billing process, it can take a few minutes to several weeks after ordering a subscription until an invoice is generated and thus appears in the finance area.
Step-by-step instructions
Section titled “Step-by-step instructions”- Navigate to the Finance section in the main menu of the portal.
- By default you are directly in the Invoices tab.
- Use the search bar and filters at the top of the table to narrow down the invoice you want.
- Click on more filters to display additional search criteria.
- The table shows the relevant documents.
- Clicking on the corresponding table row opens the detailed view of the respective invoice.
Filter and search options
Section titled “Filter and search options”The portal offers you search and filter options to search specifically for documents.
Standard filter:
- Customer or Distributor: Select the context and search specifically for the name or ID of a specific customer or distributor.
- Invoice number: Allows direct search for a unique invoice number (e.g. “ABC-123”).
- Type: Filter by document type (e.g. invoice, receipt or invoice correction).
- Status: Filter by current payment status (e.g. Not Cleared or Fully Cleared).
- Due from / Due by: Limit the period by which the invoice must be paid.
Advanced filters (more filters):
- Subscription ID: Finds all invoices that belong to a specific subscription.
- Cancellation Status: Filters for invoices that have been canceled.
- Billing period: Limit the search to the billed period of the underlying service provision.
Available information
Section titled “Available information”The table provides you with the following overview of each document:
- Invoice number: The unique identifier of the receipt in the system.
- Name: The name of the invoice recipient.
- Type: The type of receipt (e.g. “Invoice”, “Invoice Correction” or “Receipt (Prepaid)”).
- Amount: The gross amount. In the case of invoice corrections, this is shown negatively.
- Invoice Date: The date the invoice was generated.
- Due by: The deadline for payment. Often left blank for receipts and corrections.
- Status: A status indicator that signals the payment status (e.g. red for “Not cleared”, green for “Paid in full”).
Notes and typical errors
Section titled “Notes and typical errors”- Distinction from orders: Please note that an order does not always correspond to an invoice. A subscription can generate many ongoing invoices (e.g. monthly) over its term.
- Negative amounts: A negative amount (e.g. -12.37 €) in combination with the “Invoice correction” type means that a credit was created that reduces the customer’s balance.
Result
Section titled “Result”You have successfully found the invoice you were looking for in the table, checked its status and can now open it for further details with a click.
API Notes
Section titled “API Notes”If you want to search or filter invoices system-controlled (e.g. for a connected accounting or dunning system), use the search endpoint of the invoice API:
| End point | Method | Description | OperationId |
|---|---|---|---|
/v1/invoice/search | POST | Search for invoices and receipts using filter criteria | searchInvoices |