Create invoice
By default, there is no standard process in the tebio Business portal where you can create an invoice manually. The platform is designed for automated billing. Invoices (as well as receipts and invoice corrections) are generated by the system as soon as certain conditions are met.
This article explains the key concepts that control the timing, content and presentation of invoice creation.
When is an invoice created?
Section titled “When is an invoice created?”The timing of invoice creation depends on the automated billing cycle:
- Automated billing runs (bill runs): The central basis for invoice creation are so-called bill runs. A billrun is an automated background process that runs at regular intervals (e.g. daily or monthly) across all active subscriptions in the system.
- Billrun checks whether the next billing period has been reached for a subscription. If this is the case, the system calculates the applicable fees (basic fees, usage-based fees, discounts) and generates the invoice.
Requirements and limitations
Section titled “Requirements and limitations”In order for an invoice to be generated correctly, the following requirements must be met in the system:
- Active Billrun: The automated billing runs must be configured and active for your client.
- Products: Products with defined prices and billing cycle frequency must be available and ordered.
- Tax Catalog: A valid tax catalog must be configured for your scenario in order for tax rates to be calculated. For Germany and the EU, all common scenarios are preconfigured in the tebio platform.
Presentation and content of the invoice
Section titled “Presentation and content of the invoice”Step-by-step instructions
Section titled “Step-by-step instructions”Layout and design
Section titled “Layout and design”The visual appearance of the generated PDF document is controlled by a global document template (so-called white label invoice template). The system uses this standardized template in the background. This template specifies the structure (header, position table, footer, totals block).
For information about customizing and configuring the template (such as uploading your own company logo or defining footers and sender information), please read the detailed article Manage billing settings.
Contents of the invoice
Section titled “Contents of the invoice”The textual and financial content of the invoice is made up of the master data of the various platform components:
- Recipient data: Name and billing address come from the customer or sales partner’s master data.
- Item texts and amounts: Are taken from the product configuration. The names of the products will appear on the invoice as they are named in the catalog.
- Taxes: The system calculates taxes based on the configured tax catalog.
- Payment information: tebio automatically shows the appropriate payment information for each payment method on the invoice.
- For SEPA direct debit, for example, the mandate reference and creditor ID are printed.
- For transfer, the correct bank details and an EPC QR code (for banking apps) are printed so that the customer can record the payment more easily in a banking app.
Notes and typical errors
Section titled “Notes and typical errors”- Missing logo configuration: If no logo has been uploaded in the invoice settings, the corresponding placeholder in the white label invoice will remain empty.
- Incorrect item texts: If there are typos on the invoice, always check the source component (e.g. the product catalog), as the invoice only references the values.
Result
Section titled “Result”The system automatically generates PDF invoices in the final status (Final) in the background, which can be communicated to the customer and transferred to the financial journal.
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/invoice | POST | Create invoice | createInvoice |
Related topics
Section titled “Related topics”- View billing details
- Manage billing settings
- Create subscription product
- Configure taxes