Toggl Track
Tämä integraatio on aktiivinen ja käyttövalmis kaikilla Pro-sopimuksilla.
Yhdistä Toggl Track Frihetiin. Tuo rekisteröidyt tuntisi ja muunna aika laskuiksi.
Mihin se on tarkoitettu?
Togglin integroinnilla:
- Tuo tunteja — Tuot aikakirjauksesi Frihetiin
- Luo laskuja tunneista — Muunna tunnit laskuiksi asiakaskohtaisesti
- Määritettävä hinta — Määritä hinta/tunti asiakaskohtaisesti
- Projektit ja tehtävät — Ryhmittele projekteittain yksityiskohtaisia laskuja varten
Vaatimukset
- Aktiivinen Toggl Track -tili — Sinulla on oltava kirjattua aikaa
- Togglin API-avain — Yhteyden muodostamista varten
- Frihet Pro tai uudempi
Togglin API-avaimen hankkiminen
Vaihe 1: Avaa Toggl
- Siirry osoitteeseen track.toggl.com
- Kirjaudu sisään
- Napsauta nimeäsi vasemmassa alakulmassa
- Valitse Asetukset (hammasratas)
Vaihe 2: Etsi API-avaimesi
- Siirry Asetuksissa kohtaan API Token
- Näet pitkän tunnisteen (esim:
a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6) - Kopioi se (tärkeää: säilytä se turvallisesti, älä jaa sitä)
Yhdistä Toggl Frihetiin
Vaihe 1: Avaa Frihet
- Siirry kohtaan Asetukset → Integraatiot
- Etsi Toggl Track
- Napsauta Yhdistä
Vaihe 2: Syötä API-avaimesi
- Liitä Togglin tunniste
- Napsauta Tarkista yhteys
- Jos yhteys on oikein, näet "✅ Yhdistetty"
Vaihe 3: Määritä synkronointi
-
Valitse mitkä projektit synkronoidaan:
- Kaikki projektit ✅
- Vain tietyt projektit ⚪
-
Määritä oletushinta:
- Esimerkki: 60 €/tunti
- Voit muuttaa sitä asiakaskohtaisesti myöhemmin
-
Tallenna
Tuo rekisteröidyt tunnit
Vaihtoehto 1: Manuaalinen tuonti
- Siirry Frihetissä kohtaan Laskutus → Tuo Togglista
- Valitse päivämääräalue:
- "Tämä kuukausi"
- "Viimeiset 7 päivää"
- "Mukautetut päivämäärät"
- Valitse tuotavat projektit
- Napsauta "Tuo"
- Luodaan laskuluonnoksia (voit tarkistaa ennen tallentamista)
Vaihtoehto 2: Automaattinen synkronointi
Jos aktivoit sen Asetuksissa:
- Frihet tuo automaattisesti Toggl-tuntisi joka päivä
- Se ryhmittelee ne asiakkaan mukaan
- Se luo laskuluonnoksia
- Tarkistat ja vahvistat ne
Esimerkki: Tuntien muuntaminen laskuksi
Togglissa
Proyecto: Diseño Web - Cliente XYZ
- Lunes 3 feb: 5 horas (Diseño UI)
- Miércoles 5 feb: 3 horas (Desarrollo)
- Total: 8 horas
Proyecto: Consultoría - Juan García
- Jueves 6 feb: 2 horas (Reunión)
- Total: 2 horas
Frihetissä (tuonnin jälkeen)
Lasku #1 - Asiakas XYZ
Concepto: Diseño Web
- 5 horas @ €60 = €300
- 3 horas @ €60 = €180
Total: €480
Desglose:
- 3 feb: 5h Diseño UI
- 5 feb: 3h Desarrollo
Lasku #2 - Juan García
Concepto: Consultoría
- 2 horas @ €60 = €120
Desglose:
- 6 feb: 2h Reunión
Mukautetut hinnat asiakaskohtaisesti
Oletuksena kaikki käyttävät 60 €/h hintaa. Voit muuttaa:
Vaihtoehto 1: Muokkaa laskussa
- Lasku luodaan
- Ennen vahvistamista muutat hintaa manuaalisesti
- Tunnit lasketaan uudelleen automaattisesti
Vaihtoehto 2: Kiinteä hinta asiakaskohtaisesti
- Siirry kohtaan Asiakkaat → avaa asiakas
- Syötä "Toggl-hinta" -kenttään 80 €/tunti
- Seuraava tuonti käyttää tätä hintaa kyseiselle asiakkaalle
Yksityiskohtainen tehtäväerittely
Jos käytät Togglissa tehtävän kuvausta, Frihet sisällyttää ne:
En Toggl:
- 10:00-12:00 "Reunión con cliente" (2h)
- 14:00-16:30 "Correcciones de diseño" (2.5h)
Frihetissä se näkyy seuraavasti:
Factura:
- Reunión con cliente: 2h @ €60 = €120
- Correcciones de diseño: 2.5h @ €60 = €150
Total: €270
Voit muokata jokaista riviä ennen vahvistamista.
Projektit ja asiakkaat
Automaattinen vastaavuus
Frihet yrittää yhdistää:
Proyecto Toggl "Cliente A"
→ Cliente Frihet "Cliente A"
Si el cliente no existe:
→ Frihet lo crea automáticamente
Manuaalinen vastaavuus
Jos haluat, että Toggl-projekti liitetään toiseen asiakkaaseen:
- Siirry kohtaan Asetukset → Toggl → Projektien vastaavuus
- Valitse jokaiselle projektille Frihet-asiakas
- Tallenna
Esimerkki:
Proyecto Toggl "Diseño Q1"
→ Asignar a cliente Frihet "Empresa SL"
Testaa integraatiota
Testituonti
- Kirjaa Togglissa tunti: "Testitehtävä" (1 tunti)
- Siirry Frihetissä kohtaan Laskutus → Tuo Togglista
- Valitse "Viimeiset 24 tuntia"
- Napsauta "Tuo"
- Sinun pitäisi nähdä laskuluonnos
Jos se ei ilmesty:
- Tarkista, että Toggl on yhdistetty ✅
- Tuntien on oltava kirjattuja (ei luonnoksia)
- Odota 24h Togglissa kirjaamisen jälkeen
Tuo aikakirjaukset
Frihet voi muuntaa aikakirjauksesi automaattisesti laskun riveiksi:
- Yhdistä Toggl-tilisi
- Siirry integraation Tiedot-välilehdelle
- Napsauta Tuo aikakirjaukset
- Syötä tuntihintasi
- Frihet ryhmittelee merkinnät projektin mukaan ja luo laskuluonnoksen
Merkinnät ryhmitellään projektin mukaan, jolloin kokonaistunnit lasketaan yhteen ja niihin sovelletaan ilmoitettua hintaa.
Asioita, joita voit tehdä
Ryhmittele projektin mukaan
Tuot koko kuukauden projektin:
Proyecto "App iOS":
- Semana 1: 20 horas
- Semana 2: 25 horas
Total: 45 horas @ €70/h = €3.150
Luot yksittäisen laskun: "iOS-sovelluksen kehitys - Helmikuu 2025"
Laskuta sprintin mukaan
Jos työskentelet sprinteissä:
- Togglissa jokainen sprintti erillisessä projektissa
- Tuot ja luot laskun sprintin mukaan joka kuukausi
- Selkeä erittely asiakkaalle
Hinnat tyypin mukaan
Toggl: Tag "Diseño" → €80/h
Toggl: Tag "Desarrollo" → €100/h
Toggl: Tag "Consultoría" → €60/h
Voit yhdistää nämä eri hinnat Frihetissä.
Reaaliaikainen synkronointi
Työ, jonka kirjaat Togglissa tänään:
- On tuotavissa Frihetiin huomenna
- Jos aktivoit automaattisen synkronoinnin, se tuodaan automaattisesti
Toggl lähettää tietoja kerran päivässä (yleensä klo 3 UTC).
Muokkaa tuonnin jälkeen
Tuntien tuonnin jälkeen:
- Lasku on tilassa "Luonnos"
- Voit muokata:
- Käsite
- Tuntihinta
- Lisää/poista rivejä
- Vaihda asiakas
- Kun se on valmis, vahvista lasku
Togglin alkuperäiset tunnit eivät muutu — voit muokata laskua vapaasti.
Poista tuonti
Jos toit virheellisesti:
- Etsi lasku kohdasta Laskutus → Laskut
- Jos se on edelleen "Luonnos", voit Poistaa
- Togglin tunnit ovat edelleen siellä, muuttumattomina
Jos olet jo vahvistanut sen laskuksi, voit:
- Merkitä sen "Perutuksi"
- Tai luoda hyvityslaskun
Rajat ja rajoitukset
- Enintään 90 päivän historia yhdessä tuonnissa
- 10 samanaikaista tuontia (ei pitäisi vaikuttaa sinuun)
- Ei poistojen synkronointia — Jos poistat tunnin Togglissa, lasku Frihetissä säilyy
Vianmääritys
"En näe tuntejani Togglissa"
- Tarkista, että se on yhdistetty ✅
- Tuntien on oltava kirjattuja (ei luonnoksia)
- Odota 24h Togglissa kirjaamisen jälkeen
"Voinko muuttaa hintaa laskutuksen jälkeen?"
Kyllä. Muokkaa laskua:
- Laskutus → avaa lasku
- Muuta tuntihinta
- Lasketaan uudelleen automaattisesti
- Tallenna muutokset
"Mitä tapahtuu, jos vaihdan API-avaimen?"
Katkaise ja yhdistä uudelleen:
- Asetukset → Integraatiot → Toggl
- Katkaise yhteys
- Syötä uusi API-avain
- Yhdistä
Jo luodut laskut pysyvät ennallaan.