Harvest
Denne integrasjonen er aktiv og klar til bruk i Frihet.
Koble Harvest til Frihet. Importer tidsregistreringer og konverter arbeidstimer til fakturalinjer automatisk. Definer priser per kunde eller prosjekt og fakturer direkte fra ditt ERP.
Hva brukes det til?
Med Harvest-integrasjon:
- Importer tidsregistreringer — Hent dine registrerte timer i Harvest til Frihet
- Lag fakturaer fra timer — Konverter tid til fakturaer med konfigurerbare priser
- Prosjekter og kunder — Grupper timer etter prosjekt for detaljerte fakturaer
- Tilpassede priser — Definer pris/time per kunde eller prosjekt
- Ingen duplikater — Allerede importerte timer re-importeres ikke
Krav
- Aktiv Harvest-konto — getharvest.com
- Personal Access Token — Genereres fra Harvest-innstillingene
- Account ID — Hentes sammen med tokenet
- Frihet Pro eller høyere
Koble Harvest til Frihet
Trinn 1: Hent ditt personlige tilgangstoken
- Gå til id.getharvest.com/developers
- Logg inn med din Harvest-konto
- Klikk på Create New Personal Access Token
- Gi det et navn (f.eks.: "Frihet ERP")
- Klikk på Create Personal Access Token
- Du vil se to data:
- Token — Din tilgangsnøkkel (f.eks.:
123456.pt.abcdefg...) - Account ID — Den numeriske identifikatoren for din konto (f.eks.:
987654)
- Token — Din tilgangsnøkkel (f.eks.:
- Kopier begge verdiene
Tokenet vises bare én gang. Account ID kan du sjekke senere, men kopier begge nå.
Trinn 2: Konfigurer i Frihet
- Gå til Innstillinger → Integrasjoner
- Søk etter Harvest
- Klikk på Koble til
- Skriv inn ditt Personal Access Token
- Skriv inn ditt Account ID
- Klikk på Verifiser tilkobling
- Hvis det er korrekt, vil du se navnet på din bedrift i Harvest
Trinn 3: Verifiser tilkobling
- Frihet vil vise en oppsummering:
- Navn på bedriften i Harvest
- Antall aktive prosjekter
- Nylig registrerte timer
- Du kan gjøre en testimport
Hvordan det fungerer
Frihet bruker Harvest API v2 med to autentiseringsheadere:
Authorization: Bearer <token>
Harvest-Account-Id: <account-id>
- Du oppgir ditt Personal Access Token og Account ID
- Frihet sender begge i headerne for hver forespørsel
- Tidsregistreringene importeres ved behov eller periodisk
- Hver registrering inkluderer prosjekt, oppgave, kunde og timer
- Legitimasjonen lagres kryptert (AES-256-GCM) i Frihet
Synkroniserte data
| Data | Retning | Frekvens |
|---|---|---|
| Tidsregistreringer | Harvest → Frihet | Ved behov / periodisk |
| Prosjekter | Harvest → Frihet | Ved behov |
| Harvest-kunder | Harvest → Frihet | Ved behov |
| Oppgaver | Harvest → Frihet | Med hver registrering |
Eksempel: Konverter timer til faktura
I Harvest
Prosjekt: Web-redesign - KundeXYZ
Man 3. feb: 4t — Design av wireframes
Tir 4. feb: 3t — Responsiv layout
Tor 6. feb: 5t — Frontend-utvikling
Totalt: 12 timer
I Frihet (etter import)
Faktura #1047 - KundeXYZ
Beskrivelse: Web-redesign
Design av wireframes: 4t × 75 EUR = 300,00 EUR
Responsiv layout: 3t × 75 EUR = 225,00 EUR
Frontend-utvikling: 5t × 75 EUR = 375,00 EUR
Totalt: 900,00 EUR
Tilpassede priser
Standardpris
Ved oppsett av integrasjonen definerer du en basispris (f.eks.: 60 EUR/t). Alle importer bruker denne standardprisen.
Pris per kunde
- Gå til Kunder → åpne kunden
- Under "Harvest-pris" skriver du inn den spesifikke prisen (f.eks.: 80 EUR/t)
- Neste import for denne kunden vil bruke denne prisen
Rediger på fakturaen
Etter import er fakturaen i status Utkast. Du kan:
- Endre timeprisen på en hvilken som helst linje
- Legge til eller fjerne linjer
- Justere beskrivelsen
- Bekrefte når det er klart
Importer tidsregistreringer
Frihet kan konvertere dine tidsregistreringer til fakturalinjer automatisk:
- Koble til din Harvest-konto
- Gå til Data-fanen for integrasjonen
- Klikk på Importer tidsregistreringer
- Skriv inn din timepris
- Frihet grupperer oppføringene etter prosjekt og oppretter et fakturautkast
Harvest-oppføringene inkluderer prosjektnavn og oppgave direkte, slik at hver fakturalinje reflekterer den utførte oppgaven.
Bruksområder
Utviklingsbyrå
Ditt team registrerer timer i Harvest per prosjekt og oppgave. Ved slutten av måneden importerer du timene til Frihet og genererer detaljerte fakturaer for hver kunde med en oversikt over oppgavene.
Uavhengig konsulent
Du registrerer dine konsulenttimer i Harvest. Ukentlig eller månedlig importerer du til Frihet og oppretter fakturaer per kunde. Hver faktura viser den nøyaktige oversikten over hva du gjorde og hvor mye tid du brukte.
Fakturering per prosjekt
Du har et stort prosjekt med lukket budsjett. Du bruker Harvest til å spore de faktiske timene og Frihet til å fakturere prosjektmilepæler. De importerte timene gir deg innsikt i lønnsomhet.
Feilsøking
"Autentiseringsfeil"
- Kontroller at Personal Access Token er korrekt
- Sjekk at Account ID tilsvarer din aktive konto
- Hvis du regenererte tokenet, oppdater det i Frihet
"Jeg ser ikke tidsregistreringene mine"
- Kontroller at du har registrert timer i Harvest (ikke utkast)
- Sjekk at du velger riktig datoområde
- Tidsoppføringene må ha et tildelt prosjekt
"Prisene er ikke korrekte"
- Gå gjennom standardprisen under Innstillinger → Harvest
- Sjekk om kunden har en tilpasset pris konfigurert
- Du kan redigere prisen direkte i fakturautkastet før du bekrefter
"Jeg vil endre Account ID"
- Gå til Innstillinger → Integrasjoner → Harvest
- Klikk på Koble fra
- Koble til igjen med det nye Account ID og tokenet