Passa al contenuto principale

Harvest

Disponibile

Questa integrazione è attiva e pronta all'uso in Frihet.

Collega Harvest a Frihet. Importa i registri di tempo e converti le ore lavorate in voci di fattura automaticamente. Definisci tariffe per cliente o progetto e fattura direttamente dal tuo ERP.

A cosa serve?​

Con Harvest integrato:

  • Importare registri di tempo — Porta le tue ore registrate in Harvest a Frihet
  • Creare fatture dalle ore — Converti il tempo in fatture con tariffe configurabili
  • Progetti e clienti — Raggruppa le ore per progetto per fatture dettagliate
  • Tariffe personalizzate — Definisci prezzo/ora per cliente o progetto
  • Senza duplicati — Le ore già importate non vengono re-importate

Requisiti​

  • Account Harvest attivo — getharvest.com
  • Personal Access Token — Si genera dalle impostazioni di Harvest
  • Account ID — Si ottiene insieme al token
  • Frihet Pro o superiore

Collegare Harvest con Frihet​

Passo 1: Ottenere il tuo Personal Access Token​

  1. Vai su id.getharvest.com/developers
  2. Accedi con il tuo account Harvest
  3. Clicca su Create New Personal Access Token
  4. Assegna un nome (es: "Frihet ERP")
  5. Clicca su Create Personal Access Token
  6. Vedrai due dati:
    • Token — La tua chiave di accesso (es: 123456.pt.abcdefg...)
    • Account ID — L'identificatore numerico del tuo account (es: 987654)
  7. Copia entrambi i valori
Salva entrambi i valori

Il Token viene mostrato solo una volta. L'Account ID puoi consultarlo in seguito, ma copialo ora.

Passo 2: Configurare in Frihet​

  1. Vai su Impostazioni → Integrazioni
  2. Cerca Harvest
  3. Clicca su Connetti
  4. Inserisci il tuo Personal Access Token
  5. Inserisci il tuo Account ID
  6. Clicca su Verifica connessione
  7. Se è corretto, vedrai il nome della tua azienda in Harvest

Passo 3: Verificare la connessione​

  1. Frihet mostrerà un riepilogo:
    • Nome dell'azienda in Harvest
    • Numero di progetti attivi
    • Ore registrate di recente
  2. Puoi effettuare un'importazione di prova

Come funziona​

Frihet utilizza la API v2 di Harvest con due header di autenticazione:

Authorization: Bearer <token>
Harvest-Account-Id: <account-id>
  1. Fornisci il tuo Personal Access Token e Account ID
  2. Frihet invia entrambi negli header di ogni richiesta
  3. I registri di tempo vengono importati su richiesta o periodicamente
  4. Ogni registro include progetto, attività, cliente e ore
  5. Le credenziali vengono archiviate crittografate (AES-256-GCM) in Frihet

Dati sincronizzati​

DatoDirezioneFrequenza
Registri di tempoHarvest → FrihetSu richiesta / periodica
ProgettiHarvest → FrihetSu richiesta
Clienti di HarvestHarvest → FrihetSu richiesta
AttivitàHarvest → FrihetCon ogni registro

Esempio: Convertire ore in fattura​

In Harvest​

Proyecto: Rediseño Web - ClienteXYZ
  Lun 3 feb: 4h — Diseño de wireframes
  Mar 4 feb: 3h — Maquetación responsive
  Jue 6 feb: 5h — Desarrollo frontend
  Total: 12 horas

In Frihet (dopo l'importazione)​

Factura #1047 - ClienteXYZ
Concepto: Rediseño Web

  Diseño de wireframes:     4h × 75 EUR = 300,00 EUR
  Maquetación responsive:   3h × 75 EUR = 225,00 EUR
  Desarrollo frontend:      5h × 75 EUR = 375,00 EUR

Total: 900,00 EUR

Tariffe personalizzate​

Tariffa predefinita​

Al configurare l'integrazione, definisci una tariffa base (es: 60 EUR/h). Tutte le importazioni utilizzano questa tariffa predefinita.

Tariffa per cliente​

  1. Vai su Clienti → apri il cliente
  2. In "Tariffa Harvest", inserisci la tariffa specifica (es: 80 EUR/h)
  3. Le prossime importazioni di questo cliente utilizzeranno questa tariffa

Modificare nella fattura​

Dopo l'importazione, la fattura è in stato Bozza. Puoi:

  • Cambiare la tariffa oraria di qualsiasi voce
  • Aggiungere o rimuovere voci
  • Modificare la descrizione
  • Confermare quando è pronta

Importare registri di tempo​

Frihet può convertire i tuoi registri di tempo in voci di fattura automaticamente:

  1. Collega il tuo account Harvest
  2. Vai alla scheda Dati dell'integrazione
  3. Clicca su Importa registri di tempo
  4. Inserisci la tua tariffa oraria
  5. Frihet raggruppa le voci per progetto e crea una bozza di fattura

Le voci di Harvest includono direttamente il nome del progetto e dell'attività, quindi ogni voce di fattura riflette l'attività svolta.

Casi d'uso​

Agenzia di sviluppo​

Il tuo team registra le ore in Harvest per progetto e attività. Alla fine del mese, importi le ore in Frihet e generi fatture dettagliate per ogni cliente con il riepilogo delle attività.

Consulente indipendente​

Registri le tue ore di consulenza in Harvest. Settimanalmente o mensilmente, importi in Frihet e crei fatture per cliente. Ogni fattura mostra il riepilogo esatto di ciò che hai fatto e quanto tempo hai dedicato.

Fatturazione per progetto​

Hai un progetto grande con preventivo chiuso. Utilizzi Harvest per tracciare le ore effettive e Frihet per fatturare le tappe del progetto. Le ore importate ti danno visibilità sulla redditività.

Risoluzione dei problemi​

"Errore di autenticazione"​

  • Verifica che il Personal Access Token sia corretto
  • Controlla che l'Account ID corrisponda al tuo account attivo
  • Se hai rigenerato il token, aggiornalo in Frihet

"Non vedo i miei registri di tempo"​

  • Verifica di aver registrato le ore in Harvest (non bozze)
  • Controlla di aver selezionato il intervallo di date corretto
  • Le voci di tempo devono avere un progetto assegnato

"Le tariffe non sono corrette"​

  • Controlla la tariffa predefinita in Impostazioni → Harvest
  • Controlla se il cliente ha una tariffa personalizzata configurata
  • Puoi modificare la tariffa direttamente nella bozza di fattura prima di confermare

"Voglio cambiare l'Account ID"​

  1. Vai su Impostazioni → Integrazioni → Harvest
  2. Clicca su Disconnetti
  3. Riconnetti con il nuovo Account ID e token

Prossimi passi​