What TimeInvoicer does for you
Initial Setup
Step by step
-
Grant calendar permission
On first launch, the app will ask for calendar access. Tap Allow. -
Set up an Android calendar (if you don't have one yet)
If no calendars are visible: start with the simple local method. Google is optional.Recommendation: Use at least 2 calendars: 1 default calendar for work and 1 backup calendar. If something goes wrong during sync, you'll have a separate calendar copy.A — Simple method: add a local calendar on your phone
- Open the pre-installed Calendar app on your phone.
- Tap Settings or Manage calendars.
- Select Add calendar.
- Choose the type Phone / Local / Device (varies by manufacturer).
- Create two local calendars, e.g. Practice and Practice Backup.
- Then open TimeInvoicer and set in Menu → Calendar Settings: Practice = Default and Practice Backup = Backup.
With the local option, there is usually no cloud sync. Therefore, also use Menu → Backups → Save calendar locally for regular backups.B — Optional: Google Calendar for multiple devices
If you want to use your calendar on tablet, second phone or PC, Google Calendar is a simple solution with automatic synchronization.- Open the Settings app on your phone (gear icon).
- Scroll to Accounts or Passwords & Accounts.
- Tap Add account.
- Select Google from the list.
- Sign in with your existing Google address — or tap Create account at the bottom.
- After signing in: Tap the new Google account and make sure Calendar is enabled.
- Briefly open the Google Calendar app and check that your account is visible there.
- Return to TimeInvoicer — the calendars will now appear in the list.
C — Create a new Google account (if you don't have one)
- Follow steps B 1-4 above, until the Google sign-in screen appears.
- Tap Create account at the bottom → For myself.
- Enter first and last name, tap Next.
- Enter your date of birth and gender, tap Next.
- Choose a Gmail address or type your preferred address.
- Set a secure password (min. 8 characters, upper/lowercase, number).
- Add optional recovery email / phone number, then Next.
- Accept terms of service → I agree.
- Continue with step B 6-8 above.
D — Create a new calendar in Google Calendar
By default, you already have at least one calendar after adding your Google account. If you want to create a dedicated one (e.g. "Practice"), follow these steps:- Open calendar.google.com in your browser.
- Sign in with your Google account.
- Click on Other calendars on the left → + Create new calendar.
- Give the calendar a name (e.g. Practice or Clients).
- Click Create calendar.
- On your phone, open the Google Calendar app → Menu → Settings → Your account → Sync.
- Return to TimeInvoicer — the new calendar will now appear in the list.
E — Advanced Android guide (Samsung / Pixel / Xiaomi)
Quick tip: Open the search in Android Settings and type Calendar. This usually helps you find the right menus much faster.Option A: New calendar via your Google account (most common)
This keeps the calendar in sync across all devices (phone, tablet, web).
- Open Settings.
- Tap Accounts or Passwords & Accounts.
- Select Google.
- Check if your desired Google account is present.
- If not: Add account → Google and sign in.
- Tap the account → Account sync.
- Enable Calendar.
Your Google Calendar is now connected. You can create an additional calendar most easily in the Google Calendar app or on the web.- Open the Google Calendar app.
- Menu → Settings → Your Google account.
- Depending on version: Add calendar / Manage calendars.
- If no "New calendar" button is visible: open calendar.google.com in your browser and create one under Other calendars → Create new calendar.
- Then wait briefly or trigger sync again.
In some versions of the Google Calendar app, you can only show/hide calendars but not create new ones. The web method is the standard workaround.Option B: Local calendar on phone only (no sync)
- Open Calendar app (Google Calendar or Samsung Calendar).
- Open the Calendar app settings.
- Look for Manage calendars / Add calendar / Accounts.
- Choose Device / Phone as storage location (if offered).
- Create a new calendar, set name and color, save.
Advantage: no account needed. Disadvantage: may be lost on phone change/reset. Therefore back up regularly.Option C: Exchange / Outlook / iCloud
- Settings → Accounts → Add account.
- Select Exchange or Microsoft Outlook.
- Enter email + password.
- Enable sync: turn on Calendar.
- Check in the Calendar app: Menu → Calendar list (visible/active).
When sync only shows "Contacts sync"
This is a typical Android/Samsung issue. Follow these steps in order:- Install/activate Google Calendar app (Play Store), then restart the device.
- Check Calendar Storage: Settings → Apps → Show system apps → Calendar Storage must be active.
- Open the correct sync path: Samsung usually Settings → Accounts and backup → Manage accounts → Google → Sync account.
- Check app permissions: Settings → Apps → Google Calendar → Permissions → Allow Calendar.
- Trigger sync in Google Calendar app and then sync again under Android Accounts.
- On Samsung, also check whether only Samsung Calendar/local calendars are active.
Online help: Google Calendar Help · Android Accounts & SyncTip: For therapists, we recommend a separate calendar just for client appointments (e.g. "Practice"), a backup calendar and an anonymized backup calendar — all three can be set up in TimeInvoicer with just a few taps. -
Select invoice directory
Menu → Settings → Invoice directory
Choose the folder where invoices will be saved (e.g. Documents/Invoices). -
Assign default calendar & additional calendars
Menu → Settings → Calendar → Calendars & Colors
Assign the Default calendar label to at least one calendar.
Optional: select a Backup calendar and/or an Anonymous backup calendar. -
Choose invoice template
Invoices → Template — select a default template or create your own. -
Create a test invoice
Check the PDF — this way you can immediately see if the layout and signature look correct.
Appointment format (important!)
| Field | What goes there | Example |
|---|---|---|
| Title | Full client name | Jane Smith |
| Description | Service + € + rate | Individual Therapy €160 |
| Duration | Actual session length | 50 minutes |
Calendar & Appointments
The calendar is the control center: view appointments, create new ones and jump directly to invoicing.
Create a new appointment
- Tap New Appointment or the + icon.
- Fill in title (= client name), description (= service + € rate), date, time and duration.
- Select calendar (work / personal).
- Save — the appointment appears immediately in your calendar.
Smart Appointment Suggestion NEW
- Select a client in the appointment form.
- Tap the Suggest Appointment button.
- The app detects the pattern (e.g. Tuesday 10:00 AM, 5 times).
- Dialog shows: "Next appointment: Tue, Feb 25, 2026, 10:00-11:00 AM"
- Apply → date and time are filled in automatically.
Edit / delete an appointment
More features
| Feature | Where | What |
|---|---|---|
| Switch view | Menu top right | Day, week or list view |
| Filter | Filter icon | Show only certain calendars or clients |
| SMS new appointment | Appointment menu | Send appointment confirmation via SMS |
| Email new appointment | Appointment menu | Send appointment confirmation via email |
| Reports | Menu → Reports | Statistics on appointments and fees |
How an invoice is created from your calendar
The process at a glance
Step 1: Create the appointment correctly
For the app to recognize the appointment, it must contain two things:
| Calendar field | What goes there | Why |
|---|---|---|
| Title | Full client name e.g. "Jane Smith" |
The app searches appointments by name |
| Description | Service name + € + amount e.g. "Individual Therapy €160" |
The € amount is used as the fee |
| Duration | Actual session length e.g. 50 minutes |
Shown as units on the invoice |
Step 2: Open the invoice
There are two ways to reach the invoice form:
Client, service and date are pre-filled instantly.
Select client manually, then specify date range.
Step 3: Choose date range
- Select client (dropdown or search).
- Set from and to dates (e.g. last month).
- The app automatically searches all appointments for this client in the date range.
- The matching appointments appear as a service table.
Step 4: Review the service table
| Column | Where the value comes from |
|---|---|
| Date | Start date of the calendar appointment |
| Description | Description text of the appointment (without € part) |
| Duration / Units | Appointment duration / unit length (e.g. 50 min) |
| Fee per unit | € amount from the appointment description |
| Total | Units x fee |
Step 5: Diagnosis & payment status
- Diagnosis — optional, ICD-10 or ICD-11 code (from the client's saved diagnosis)
- Payment method — cash / transferred / outstanding
- Invoice number — automatic, editable
Step 6: Preview and PDF
Tap Preview → review → Create PDF.
The app automatically saves: Original PDF + anonymized PDF + HTML.
All files are stored in your selected invoice directory.
Managing Clients
Client master data — automatically used in invoices.
Add a new client
- Main menu → Clients → +
- Enter first name, last name, insurance ID.
- Optional: diagnosis, title.
- Save.
| Field | Meaning | Required? |
|---|---|---|
| First / Last name | Printed on the invoice | Yes |
| Insurance ID | Social insurance number | Recommended |
| Diagnosis (ICD-10/11) | Appears on the invoice | No |
| Contact ID | Link to Android contacts for SMS/email | Recommended |
Creating an Invoice
Automatically from calendar (recommended)
- Menu → Invoices → New Invoice
- Select client.
- Choose date range (from / to).
- The app searches all appointments for this client in the date range.
- Review and adjust the service table as needed.
- Check invoice number and date.
- Tap Preview.
Manually
- Menu → Invoices → New Invoice
- Select client.
- Tap New Service and enter details directly.
- Continue as above (preview, PDF).
| Field | Meaning |
|---|---|
| Invoice No. | Invoice number (automatic, editable) |
| Date | Invoice date (default: today) |
| Services | Table with date, description, duration, fee |
| Payment method | Cash / transferred / outstanding |
| Diagnosis | Optional: ICD-10 or ICD-11 code |
| Signature | Your signature (from template) |
Preview & PDF Creation
The preview shows how the invoice will look as a PDF. Review first, then create the PDF.
Mandatory checks
| Check point | Why |
|---|---|
| Name and insurance ID correct | Avoids correction invoices |
| All services complete | Correct total amount |
| Payment information visible | Clear instruction for client |
| Signature visible | Professional finish |
Create PDF
- Tap Create PDF.
- The app automatically saves: regular PDF + anonymized PDF + HTML.
- Files are stored in your selected invoice directory.
Buttons
Send Invoice by Email
Send the invoice directly as a PDF attachment to your client — without leaving the app.
- First tap Create PDF.
- Then tap Share.
- Select Send PDF by email.
- Your email app opens with:
- Recipient: Email from contacts
- Subject: New Invoice
- Body: Your template text
- Attachment: the PDF file
- Review and tap Send.
Anonymized Invoice
What is it for?
How?
When you tap Create PDF, the app automatically creates both versions:
Invoice_[No]_[Name].pdf— real dataInvoice_[No]_ANONYMOUS.pdf— anonymized
SMS & Email Communication
Send appointment confirmations, cancellations and reminders with pre-written texts.
Placeholders in templates
| Placeholder | Replaced with |
|---|---|
[NAME] | Full client name |
[VORNAME] | First name only |
[DATUM] | Appointment date |
[UHRZEIT] | Appointment time |
[ANREDE] | Mr. / Ms. |
Edit templates
- Menu → Settings → Messages
- Tap the desired template.
- Enter text with placeholders.
- Save.
Settings & Templates
| Section | What you configure |
|---|---|
| Invoice directory | Storage location for PDFs and HTML files |
| Calendar | Which calendars the app uses |
| Messages | Text templates for SMS and email |
| Invoice | Default fee rate, max services per page, header |
| ICD Mode | For therapists: ICD codes as project categories |
| Logging | Log detail level (for support) |
Invoice templates — placeholders
[NAME]— Client name[SVNR]— Insurance ID[DIAGNOSE]— ICD diagnosis
[RENR]— Invoice number[DATUM]— Invoice date[ZEILENLEISTUNGEN]— Service table[BEZAHLT]— Payment status[SIGNATURE]— Signature
Switch template
- Menu → Invoices → Template
- Tap Templates....
- Select a template from the list.
- Save as default template
Backup & Restore
Create backup
- Menu → Backups → Backup
- The app saves all clients, invoices and settings.
- The file is stored in your invoice directory.
Calendar backup
Save & restore calendar locally NEW
-
Create local calendar backup
Menu → Backups → Save calendar locally → save file. -
Restore local calendar backup
Menu → Backups → Restore calendar locally → select backup file. -
Check after restore
Open the calendar view and spot-check some appointments.
Restore
- Menu → Backups → Restore
- Select the backup file.
- Confirm.
| Data | In backup? |
|---|---|
| Client data | Yes |
| Invoices | Yes |
| Settings & templates | Yes |
| SMS/Email templates | Yes |
| PDF files | Back up separately! |
ICD-10 & ICD-11 Diagnoses
ICD-10 e.g. F41.1 = Generalized anxiety disorder.
ICD-11 NEW — newer WHO version, over 35,000 entries, available offline.
Add a diagnosis to an invoice
- Open the invoice → Diagnosis section.
- Choose ICD version: ICD-10 or ICD-11.
- Tap the Search Diagnosis button.
- Enter keywords, e.g. anxiety depression — spaces = AND search.
- Select a diagnosis from the list.
- Optional free text in the notes field.
Example:
anxiety social finds all social anxiety disorders.
Compare ICD versions
| Feature | ICD-10 | ICD-11 |
|---|---|---|
| Standard | Currently valid in AT/DE | WHO successor from 2022 |
| Scope | ~14,000 codes | ~35,000 codes |
| Search | Full-text + multi-keyword | Full-text + multi-keyword |
| Offline | Yes (own database) | Yes (built-in, no download) |
| Recommended for | Insurance billing | Documentation, research |
Manage database (ICD-10)
| Function | Where | What |
|---|---|---|
| ICD-10 Import | Menu → ICD-10 Import | Load new ICD-10 codes |
| ICD-10 Import 2 | Menu → ICD-10 Import 2 | Alternative import |
| ICD-10 Export | Menu → ICD-10 Export | Back up data |
ICD Mode NEW — for Therapists & Psychologists
In ICD Mode, project categories are populated directly from ICD codes — the separate diagnosis field is no longer needed.
Activate ICD Mode
- Open Menu → Settings.
- Under Appointment & Project, toggle ICD Mode on.
- Return to the invoice — the change takes effect immediately.
What changes
- "Project" spinner shows ICD codes as categories
- ICD-10/11 toggle + search button visible
- Diagnosis fields on the invoice hidden
- "Project" spinner shows your own project names
- Diagnosis fields visible
- ICD elements hidden
Select an ICD code as project
- In the invoice form: go to the Project section.
- Choose ICD version (ICD-10 or ICD-11).
- Tap Search Diagnosis and enter keywords.
- Select an ICD code from the list (e.g. F41.1 Generalized anxiety disorder).
- The code appears as the project on the invoice.
Frequently Asked Questions & Solutions
Invoice
| Problem | Solution |
|---|---|
| Service missing | Check appointment description: must contain € sign + amount |
| Wrong client name | Appointment title must exactly match the client name |
| PDF cut off at the sides | Check template — tables must not be wider than A4 |
| Signature missing | Recreate PDF; check signature block in template |
| Blank second page | Check template for excess spacing |
| Total incorrect | Review service table and correct amounts/durations |
Appointment suggestion
| Problem | Solution |
|---|---|
| "Too few appointments" | At least 2 past appointments with the client needed |
| Suggestion doesn't fit | Change appointment manually — the suggestion is just a reference |
SMS / Email
| Problem | Solution |
|---|---|
| Email without recipient | Add email address in Android contacts |
| Placeholders not replaced | Contact name must match the client name |
| PDF attachment missing | First Create PDF, then Send by email |
Calendar
| Problem | Solution |
|---|---|
| No appointments visible | Check Settings → Calendar; allow Android permission |
| Calendar write permissions missing | Android Settings → Apps → TimeInvoicer → Permissions → Calendar |
| Duplicate appointments | Check if multiple calendars show the same appointment |
ICD search
| Problem | Solution |
|---|---|
| No results | Check spelling; use fewer or different keywords |
| ICD-11 empty on first launch | Wait a few seconds — 35,000 entries are being imported |
General tips
- Clear cache: Menu → Clear cache for display issues.
- Backup before support: Create a backup before reporting issues.
- Anonymized PDF for support: Never send the real invoice with client data.
- Logging: Settings → Logging for detailed logs.
Set up the AI Assistant PRO
What does it cost?
Google's free tier includes 1,500 requests per day — for occasional template creation there is no cost. With heavy usage, a request costs approximately € 0.0002 (Gemini 1.5 Flash, as of 2026).
Step 1: Create a Google Cloud project
- Open console.cloud.google.com and sign in with your Google account.
- Click the project selector in the top left.
- Select "New Project".
- Enter a name (e.g. timeinvoicer-ai) and click "Create".
- Wait about 10 seconds for the project to be created.
Step 2: Create a Gemini API key
- Open aistudio.google.com.
- Click "Get API Key" in the top left.
- Select "Create API key".
- Choose your project from the dropdown list.
- Copy the displayed key (starts with
AIza, approximately 39 characters).
Step 3: Enter the key in the app
There are two ways:
- Setup dialog: When you first click "Create AI Template", a step-by-step wizard opens automatically.
- Settings: Menu → Settings → AI Assistant (Pro) → enter Gemini API key.
Troubleshooting
You don't have a Google Cloud project yet. Go back to Step 1 and create a project first.
The Gemini API has not been activated for your project yet. Open console.cloud.google.com, search for "Generative Language API" and activate it.
The key is incorrect or was copied incorrectly. Go back to AI Studio and copy the key again.
Make sure your device is connected to the internet. The AI feature requires an active connection.
The key has not been entered yet. Go to Settings → AI Assistant (Pro) and enter the key.
Quick Invoice NEW
Create an invoice with a single tap directly from a calendar appointment. Client and service are automatically recognized from the appointment.
How to create a Quick Invoice
- Open the calendar view in TimeInvoicer.
- Long-press an appointment (long press) until the context menu appears.
- Select Quick Invoice.
- The app automatically recognizes the client (from the appointment title) and the service (from the description).
- The invoice is instantly created and shown in the preview.
€100).
Batch Invoice NEW
Combine all appointments for a client within a month into a single invoice. Ideal for monthly billing with insurance providers.
How to create a Batch Invoice
- Open the contact list (Menu → Clients).
- Long-press the desired contact (long press).
- Select Batch Invoice (Month) from the context menu.
- Choose the desired month.
- The app collects all appointments for this client in the selected month and creates a combined invoice.
Payment Reminders NEW
Keep track of outstanding and overdue invoices. The reminder system automatically shows the current reminder level and helps you send payment reminders.
Access payment reminders
- Open Menu → Reports & Finance → Payment Reminders.
- The overview shows all overdue invoices with their current reminder level.
- Tap a reminder to view the reminder text.
Reminder levels
| Level | Description | When |
|---|---|---|
| 1 | Payment reminder | After payment deadline expires |
| 2 | 1st notice | 14 days after payment reminder |
| 3 | 2nd notice | 14 days after 1st notice |
| 4 | Final notice | 14 days after 2nd notice |
Home Screen Widget NEW
See your next appointment directly on your home screen and create invoices with a single tap — without opening the app first.
Add the widget
- Long-press an empty space on your home screen.
- Select Widgets.
- Find TimeInvoicer in the widget list.
- Drag the widget to your home screen.
Widget features
Insurance XML Export NEW
Export invoices in WAH format for upload to insurance platforms — the electronic submission system for social insurance providers.
Export insurance XML
- Open an invoice and switch to the Preview.
- Tap Share.
- Select Insurance XML Export.
- The XML file is generated and can be saved or shared directly.
- Then manually upload the file to the insurance portal.
Bank Details on Invoice NEW
Automatically display your bank details on every invoice — optionally with a QR code for quick payment by your clients.
Set up bank details
- Open Menu → Settings → Bank Details & Invoice.
- Enter your IBAN.
- Optional: enter BIC and Account holder.
- Enable the QR code on invoice toggle if you want clients to pay via QR code.
- Save the settings.
Smart Event Titles NEW
When you name your calendar appointments with specific codes, TimeInvoicer automatically recognizes the service and client — without manual input.
How it works
Name your calendar appointment using the pattern:
[Code] [Description] - [Client name]
Example: KP10 Treatment - Ms. Smith
Supported codes
| Code | Service |
|---|---|
KP01 | Diagnostics |
KP10 | Treatment (individual therapy) |
KP11 | Group therapy |
KP20 | Consultation |
Diagnosis Suggestions NEW
When recording services, the app automatically suggests matching ICD-10-F diagnoses — based on the selected service and common clinical associations.
How the suggestions work
- Create a new invoice or edit an existing one.
- Select a service (e.g. treatment, diagnostics).
- The app automatically shows matching diagnosis suggestions.
- Tap a suggestion to apply it — or continue searching manually.
Example associations
| Service | Suggested diagnoses |
|---|---|
| Treatment (KP10) | F32 Depression, F33 Recurrent depression |
| Diagnostics (KP01) | F41 Anxiety disorder, F43 Stress reaction |
| Consultation (KP20) | F43 Adjustment disorder, Z63 Relationship problems |
Statistics NEW
The statistics dashboard gives you a quick overview of revenue, services and insurance provider distribution.
Access statistics
- Open Menu → Reports & Finance → Statistics.
- Select the desired time period (month or year).
- The dashboard shows you the key metrics.