Harvest

Conexión

Frihet convierte las horas de Harvest en facturas de dos formas: con un clic desde la pestaña Datos (mes actual) o desde la pestaña Facturación de Horas de Facturas, eligiendo cliente, fechas y tarifa. No hay sincronización con Harvest.

Qué hace en Frihet

• Guarda de forma segura las credenciales de Harvest que introduces:
  • Personal Access Token (se guarda cifrado)
  • Account ID
• Probar conexion — Frihet consulta tu usuario en la API de Harvest (/users/me) enviando el token como Authorization: Bearer y el Account ID en la cabecera Harvest-Account-Id.
• Importar registros de tiempo (pestaña Datos) — pide una tarifa por hora, trae las entradas del mes actual hasta hoy y crea una sola factura en borrador con una línea por proyecto: horas sumadas por la tarifa indicada y, en la descripción, las tareas de las entradas (o sus notas si no tienen tarea).
• La factura se numera HRV-AAAA-MM-DD-AAAA-MM-DD (fechas de inicio y fin del rango), con IVA al 0 %, vencimiento a 30 días y sin cliente asignado. Asigna el cliente y revisa los impuestos al editar el borrador.
• Si ya existe una factura con ese mismo número, no crea otra.
• Pestaña Facturación de Horas de Facturas — eliges el cliente, la integración conectada, la tarifa por hora y las fechas de inicio y fin. Importar y Previsualizar muestra las entradas y el total de horas, y Generar Borrador de Factura abre una factura nueva para ese cliente con una línea por proyecto.
• Los temporizadores en marcha no se importan.

Qué no hace Frihet

• Mostrar un resumen de tu cuenta al conectar (empresa, proyectos u horas).
• Importar proyectos o clientes de Harvest, ni crear clientes en Frihet.
• Sincronizar o importar horas de forma automática o periódica: cada importación es un clic en el botón.
• Elegir proyectos concretos: se importan todas las entradas del rango. El botón de la pestaña Datos usa siempre el mes actual; para otras fechas, usa la pestaña Facturación de Horas de Facturas.
• Aplicar tarifas por cliente o por proyecto: la tarifa es una sola, la que escribes al importar.
• Enviar nada a Harvest.

Requisitos

• Cuenta de Harvest con horas registradas
• Personal Access Token y Account ID de Harvest
• Cada integración conectada cuenta para el límite de tu plan: 2 en Free, 5 en Pro y sin límite en Premium.

Conectar

Paso 1: obtén las credenciales en Harvest

1. Ve a id.getharvest.com/developers e inicia sesión.
2. Pulsa Create New Personal Access Token y ponle un nombre (por ejemplo, "Frihet ERP").
3. Copia el Token y el Account ID que aparecen.

Importante

El token solo se muestra una vez. Cópialo antes de cerrar la ventana.

Paso 2: guárdalas en Frihet

1. En Frihet, ve a Integraciones.
2. Abre Harvest.
3. En la pestaña Conexion, pega el Personal Access Token y el Account ID.
4. Pulsa Probar conexion para verificar.
5. Si la prueba es correcta, pulsa Guardar conexion.

Importar horas

1. Abre la pestaña Datos de la integración.
2. Pulsa Importar registros de tiempo.
3. Escribe la tarifa por hora en euros.
4. Revisa el borrador resultante en tus facturas, asigna el cliente y ajusta el IVA.

El rango termina el día en que importas: si importas otro día del mismo mes, se crea otra factura que repite las horas ya incluidas en la anterior. Revisa los borradores antes de emitirlos.

Facturar horas a un cliente

1. Ve a Facturas y abre la pestaña Facturación de Horas.
2. Elige Cliente, Integración, Tarifa por hora (€/h), Fecha Inicio y Fecha Fin.
3. Pulsa Importar y Previsualizar.
4. Pulsa Generar Borrador de Factura, revisa la factura que se abre (impuestos incluidos) y guárdala.

Solución de problemas

Error de conexión

Comprueba que el token está bien copiado, que el Account ID corresponde a la misma cuenta y que no has regenerado el token. Si lo regeneraste, guarda el nuevo.

La importación no crea ninguna factura

Puede que no haya horas registradas en el mes actual, o que ya exista una factura con el mismo número (misma fecha de inicio y de fin).

Relacionado

• Clockify
• Toggl Track
• n8n