Upomínka platby faktury

Automated payment reminders by email

A Kimai plugin that automatically sends payment reminders for overdue invoices — to the customer with the invoice attached and internally to the responsible team members.

No more manual follow-ups: the plugin checks daily for open invoices and sends tiered reminders based on how long the payment is overdue.

What’s included?

• Daily check for overdue invoices with status “Pending”
• Email reminders to the customer (optionally with the invoice attached)
• Internal notifications to invoice creators and/or selected users
• 3 reminder levels:
  • Level 1: 1 day after due date
  • Level 2: 8 days after due date
  • Level 3: 15 days after due date
• Configurable reminder intervals
• Custom meta fields on invoices to track reminder status
• Fully customizable email templates

System Requirements

You need the ability to execute cronjobs on your server, either in your hosting administration platform or manually via crontab -e. This is required for running the command bin/console invoice-payment-reminder:send on a daily basis.

Setup steps after Installation

1. Configure the plugin

Go to System > Settings > Invoice Payment Reminder to configure the plugin:

There are two sections for configuring the plugin: “Payment Reminders for Kimai Users” and “Payment Reminders for Customers”

• Notification Strategy: Choose who receives internal notifications:
  • Invoice creator only: Only the user who created the invoice.
  • Selected users only: Only specific users selected in the configuration.
  • Invoice creator and selected users: Both groups receive notifications.
• Notify Users: Select the users who should receive notifications (multiselect).
• Attach Invoice: Enable or disable attaching the invoice PDF to the customer reminder email.
• Check Bank Account: When enabled, sends an email to internal users when an invoice becomes due, reminding them to check for payment receipt.
• Reminder Intervals: Configure the number of days after the due date for each reminder level.

2. Set up the cron job

To send reminders automatically every day, add a cron job to your server.

Add the following line to your crontab (runs daily at 8:00 AM):

0 8 * * * cd /path/to/kimai && bin/console invoice-payment-reminder:send --env=prod >> var/log/invoice-reminder.log 2>&1

3. Run the command manually

You can also run the command manually at any time:

bin/console invoice-payment-reminder:send

Use the --dry-run option to test the process without sending any emails or writing to the database:

bin/console invoice-payment-reminder:send --dry-run

Customizing email templates

The default email templates are located in Resources/views/emails/:

• customer_reminder.html.twig — Sent to the customer.
• user_check_payment_received.html.twig — Sent to internal users when an invoice is due to prompt them to check for payment receipt.
• user_notification.html.twig — Sent to internal users when a customer reminder has been dispatched.

Important: Do not modify the original plugin templates directly, as any plugin update will overwrite your changes. Instead, customize the templates by creating your own Kimai plugin using an EventSubscriber that listens to ModifyTemplatedEmailEvent.

How to create a Kimai plugin is explained in the official Kimai Plugin Documentation.

Translation

The plugin is available in two languages: English and German. To offer the plugin in your language, please contact me, and I will translate the labels accordingly.

Kompatibilita

Následující tabulka obsahuje seznam pluginů a k nim minimální požadovanou verzi Kimai.