Cómo funciona la facturación

Vibes to Bucks rastrea los costos de tokens de Cursor AI y los convierte en horas facturables en tu software de seguimiento de tiempo (Moneybird o Harvest). La conversión se basa en tu tarifa por hora — así que la extensión calcula cuántas horas de tu tiempo representa el costo del AI y crea una entrada de tiempo por esa cantidad.

Por cada cliente, controlas tres cosas:

• Facturable o no — marca Facturable para generar una entrada de tiempo para el cliente. Desmárcalo para rastrear costos internamente sin facturar al cliente (útil para tus propios proyectos o gastos generales absorbidos).
• Cómo calcular el tiempo facturable — elige entre Multiplicar costo AI (añade tu margen) o Pasar al valor nominal (solo recuperación de costos).
• Tarifa por hora — la tarifa del cliente utilizada para convertir el costo en euros a horas.

Multiplicar costo AI (recomendado)

Usa esto cuando quieras facturar el trabajo asistido por AI con un margen de ganancia. Estableces un Multiplicador de Costo a Ganancia que escala el costo bruto del AI antes de convertirlo a horas. Esto captura el valor real que entregas — elaboración de prompts, revisión e iteración de resultados, integración del resultado y responsabilidad por el producto final.

Las matemáticas:

cost_eur = cost_usd × multiplier × fx_rate
hours    = cost_eur / hourly_rate

Ejemplo: €10 de costo AI, multiplicador 5, tarifa por hora €120/h:

cost_eur = €10 × 5 = €50
hours    = €50 / €120 = 0.42h (≈ 25 minutes billed)

Un multiplicador de 5 significa que cada €1 gastado en AI se convierte en €5 de ingresos facturables — un margen que refleja la experiencia y el tiempo que inviertes alrededor del resultado del AI. Comienza en 5 y ajusta para que coincida con los acuerdos de tus clientes.

Pasar al valor nominal

Usa esto para facturación de recuperación de costos — el costo bruto del AI se pasa al cliente al valor nominal, convertido a horas a tu tarifa por hora. No se añade margen.

Las matemáticas:

cost_eur = cost_usd × fx_rate
hours    = cost_eur / hourly_rate

Ejemplo: $12.00 de costo AI, tasa EUR/USD 0.92, tarifa por hora €120/h:

cost_eur = $12.00 × 0.92 = €11.04
hours    = €11.04 / €120  = 0.092h (≈ 6 minutes billed)

No facturable

Desmarca Facturable en un mapeo para rastrear los costos de AI para ese cliente o proyecto sin generar ninguna entrada de tiempo. Los costos aparecen en tu panel de control para que puedas ver el gasto, pero nada se sincroniza con Moneybird o Harvest. Útil para proyectos internos, I+D o cualquier trabajo donde absorbas el costo del AI tú mismo.

Tipos de cambio

La conversión USD→EUR utiliza la API de Frankfurter, que ofrece tasas de referencia del Banco Central Europeo publicadas diariamente alrededor de las 16:00 CET. Las tasas se almacenan en caché localmente para evitar llamadas redundantes a la API. Cuando la API no está disponible, la extensión recurre a la fallback_rate de tu configuración.

Para el llenado retroactivo, la extensión obtiene la tasa histórica para cada día específico, así obtienes conversiones precisas incluso para fechas pasadas.

Redondeo y mínimos

Las entradas de tiempo se almacenan como marcas de tiempo de inicio/fin. La extensión convierte horas a minutos y redondea al minuto más cercano, con un mínimo de 1 minuto:

• 0.001h → 1 minuto (mínimo)
• 0.092h → 6 minutos
• 2.25h → 2 horas 15 minutos

Todas las entradas comienzan a las 09:00 UTC. La hora de finalización se calcula a partir de la duración redondeada. Estas marcas de tiempo son un requisito de la API y no reflejan las horas de trabajo reales.

Una entrada por cliente por proyecto por día

El motor de sincronización produce como máximo una entrada de tiempo por cliente por proyecto por día. Si más eventos llegan más tarde el mismo día, la siguiente sincronización actualiza la entrada existente en lugar de crear una nueva. Esto mantiene tu hoja de tiempo limpia y evita entradas fragmentadas.

Sincronización idempotente

Antes de crear una entrada, la extensión verifica si ya existe una para la misma combinación (día, contacto, proyecto):

• No existe entrada → crear
• Entrada existente, totales cambiados → actualizar
• Entrada existente, totales sin cambios → omitir (sin llamada a la API)

Ejecutar “Sincronizar ahora” dos veces seguidas no produce duplicados.

Límite de presupuesto semanal

Establece un límite de costo AI semanal por mapeo (Pro). La extensión rastrea el gasto por repositorio y envía notificaciones de Cursor en hitos: 25%, 50%, 75%, 85%, 95% como alertas informativas, escalando a una advertencia al 100% y cada 10% más allá. Cada hito se activa una vez por semana por repositorio.

Este es un límite flexible — nunca bloquea el uso de AI, solo te mantiene informado antes de que te excedas. El estado del presupuesto también es visible en el Tablero de Uso con indicadores que muestran el gasto vs. el límite.