Skip to content

Latest commit

 

History

History
49 lines (42 loc) · 3.07 KB

README.md

File metadata and controls

49 lines (42 loc) · 3.07 KB
Raw

UNMAINTAINED

Toggl Moneybird Integration

This integration aims to export Toggl entries and create a Moneybird invoice based on those entries (you'll need PHP 5.6 -> upgrade people!).

Screenshots

These screenshots have dummy data in them, 'Contact / Project XX' would be an actual contact / project name. screenshot 2016-01-07 21 14 02 screenshot 2016-01-07 21 14 24 screenshot 2016-01-07 21 14 43 screenshot 2016-01-07 21 14 59

Installation

$ git clone https://github.com/peterjaap/TogglMoneybirdIntegration
$ cd TogglMoneybirdIntegration
$ composer install

If you have whiptail installed on your system, it will use whiptail to create a dialog where you can select multiple time entries for invoicing. This works easier than the default (Symfony) dialog box. You can install whiptail (which is part of newt) under Mac OS through Homebrew;

$ brew install newt

Configuration

The config.yml file takes a few inputs. The first time you'll run the application it will ask you a number of inputs and write them to the config.yml file.

  • toggl_token (required) - this can be found in your profile on Toggl.com
  • moneybird_access_token (required) - this can be generated at https://moneybird.com/user/applications/new (choose the API token for Personal Use and select your administration)
  • moneybird_administration_id (required, autofilled if there is only one administration) - this is the first number in your Moneybird URL when you are logged in to your administration
  • hourly_rate (required) - your hourly rate, to calculate the prices
  • round_to (optional) - round your time entries to the nearest X minutes (leave empty or set to 0 to disable rounding)
  • moneybird_vat_outside_eu (optional) - if this is set, this tax rate ID is used for invoices that are sent outside the EU
  • moneybird_vat_inside_eu (optional) - if this is set, this tax rate ID is used for invoices that are sent inside the EU (excluding NL)

Usage

$ php application.php

The application will run you through a number of steps to create your invoice;

  1. (optional, only when multiple are found) Choose Toggl workspace
  2. Choose which project you want to find entries for.
  3. From which date do you want to find entries?
  4. Until which date do you want to find entries?
  5. Choose which time entries you want to invoice.
  6. (optional) Confirm you want to invoice items that are bugfixes or have the 'billed' tag in Toggl
  7. Choose which contact you want to create the invoice for
  8. (optional) Do you want to add the entries to an existing concept invoice for this contact?

Made by @peterjaap / @elgentos