Skip to content

Set up invoicing

In the Invoicing area (under Invoicing and Invoices) you organize your global billing process or Billrun. Here you determine how and when invoices and receipts are generated, grouped, sent and posted. The platform offers you configuration options to adapt the billing cycle to your business models (prepaid or postpaid).

You need this function to instruct the system whether it should automatically create invoices, send them to the customer and post them, or whether you want to precede manual approval steps. The bundling of content of invoices and the definition of intended use are also controlled here.

[!TIP] Support from tebio: The automated billing run (Billrun) is a sensitive area that has a direct impact on your sales. If you are unsure about the configuration, the tebio team is available to support you! We are also happy to offer you a final check to ensure that billing is going exactly as you imagine.

  • You have configured the general company data and tax rates.
  • You have created products in your catalog that have a corresponding payment strategy (prepaid or postpaid).

In the left menu, navigate to Billing and Invoices > Invoicing. There you will find three different tabs with which you can configure Billrun.

In this tab you define the basic behavior of the invoice run.

  • Invoice date offset (Offset for effective date): Use the dropdown to determine how many days before or after the end of a billing period the invoice date should be calculated.
  • Suppress Zero Amounts…: Enable this switch if you want to prevent blank receipts or invoices with an amount of €0.00 from being generated.
  • Invoice grouping (Grouping of invoices): Determine whether invoices should be created per subscription (Per Subscription) or bundled for the entire customer/recipient (Per Recipient).

[!NOTE] Grace Duration: By default, the platform gives events a certain grace period before the billing run starts if data arrives late. These grace periods depend on the frequency of the billing run: For daily bill runs the grace period for delayed events is 24 hours, for weekly bill runs it is 48 hours and for all other frequencies it is 72 hours. If you would like to change these fixed values ​​and speed up the Billrun, please contact our support.

2. Settings for prepaid products (“Prepaid” tab)

Section titled “2. Settings for prepaid products (“Prepaid” tab)”

Here you control the behavior for advance payment models (prepaid), where receipts are typically generated.

  • Create receipts automatically: tebio generates, records and sends the receipts automatically (if the notification switch is activated) without you having to intervene manually.
  • Approval process for invoice run (invoicing): If you activate this switch, receipts from tebio will initially only be created as a draft. These will only be recorded and sent after your manual approval.
    • Details about the release process: This mode generates an Interim Billrun Report, which you can download in the Finance > Reports menu item. This report contains all relevant data and information about the documents created and serves as a basis for decision-making for your release. You can also view the receipts in advance as a PDF draft (with a watermark) directly in the portal.
  • Automatically notify customers of new receipts: Enable this switch so that the customer receives an email after the receipt is created and posted.
  • Add cover letter to receipt: Optionally adds a textual cover letter to the generated PDF receipt.

Note: The specific intended use for prepaid products must be configured at the Product level (Use Select Product).

3. Settings for postpaid products (“Postpaid” tab)

Section titled “3. Settings for postpaid products (“Postpaid” tab)”

In this area you manage products that are subsequently billed (postpaid).

  • Create invoices automatically: tebio generates, posts and sends the invoices automatically (if the notification switch is activated) without you having to intervene manually.
  • Approval process for invoice run (invoicing): If you activate this switch, tebio will initially only create invoices as a draft. These will only be booked and sent after your manual approval in the portal.
    • Details about the release process: Similar to prepaid, this mode generates a detailed Interim Billrun Report (available under Finance > Reports), which serves as the basis for your release decision. You can view the invoices as a PDF draft (with watermark) before releasing them.
  • Automatically notify customers about new invoices: Automatic email sending after an invoice has been posted.
  • Add Cover Letter to Invoice: Attaches a separate cover letter to the invoice PDF.

Description of the payment (purpose) Here you centrally define the purpose that your customers will later see on their account statement. For better assignment, tebio offers dynamic placeholders:

  • {{ .productName }} = Name of the product
  • {{ .extRef }} = customer number (recipient reference)
  • {{ .invoiceID }} = Invoice number
  • {{ .effectiveDate }} = invoice date

Example of intended use: RE {{ .invoiceID }} ABO {{ .extSubscriptionRef }} vom {{ .effectiveDate }}

As soon as you have configured all relevant tabs and clicked on Save, tebio will take over the control of your invoice runs. If the approval process is deactivated, your customers will now automatically receive their receipts or invoices without any manual steps.

  • Customers are not receiving invoices: One of the most common causes is an accidentally activated approval process. If this switch is active, the invoices go into draft status. You then have to check and send these manually under the menu item Invoices.
  • Incomplete intended use: When using the placeholders in the postpaid tab, pay close attention to the spelling of the brackets ({{ }}), otherwise there may be display errors in the intended use.

You can control the basic settings for invoice creation and bill runs via the API.