For my business I need to send out invoices that are mostly based on my time registration data. The first few times I did it by hand using an xls export, but that got old real fast, so, being a developer, I took some time to automate it. After a while I thought it might be fun to open source this. Because why not?
This Laravel based app retrieves all data from my time tracking app Toggl Track using their REST api and compiles it into the correct form to create an invoice for e-boekhouden using their SOAP webservice.
It creates invoice lines based on time entries grouped by project name. The time will be rounded to nearest quarters. The line description will include the project name and a list of dates, intelligently generated.
This app is of very limited use to others. It works for me but it is by no means finished or stable. The implementation is very specific. There is only a very simple CLI interface. And no documentation except this readme.
But if you're using Toggl Track for time tracking and e-boekhouden for book keeping, and you have a very similar workflow and invoice format as I have, this just might be useful to you.
- PHP8.1+
- a relational database (tested with MySQL)
- a Toggl Track account and API credentials
- an e-boekhouden account and API credentials
- Clone the repo
composer install- Copy
.env.exampleto.env php artisan key:generate- Adjust
.envsettings, in particular theDB_*,TOGGL_TRACK_*andE_BOEKHOUDEN_*keys
Run php artisan invoice:generate and follow the prompts.
This software is open-sourced software licensed under the MIT license.