Contacto

App Facturas & Presupuestos

Ecosistema de automatización para autónomos con herramientas gratuítas: de la foto de la factura al libro de cuentas en segundos, con generación de presupuestos profesional.

Descargar Guía en PDF Ver todos los Recursos
1. Concepto y Stack Tecnológico

Esta app automatiza dos pilares del negocio: el registro de gastos (facturas subidas por foto/PDF) y la creación de presupuestos PDF para clientes. Todo centralizado en la nube.

Stack Técnico

  • Backend: FastAPI (Python) para orquestación y lógica.
  • Inteligencia Artificial: LLama 4 Scout (Groq) con fallback a OpenRouter.
  • Infraestructura: Hugging Face Spaces (Backend) y Netlify (Frontend).
  • Automatización: Make.com para conectar con Google Drive y Sheets.
2. Requisitos Previos

Necesitas tener cuentas activas en las siguientes plataformas (todas tienen niveles gratuitos):

  • Groq (API Key para extracción ultra rápida).
  • OpenRouter (API Key para modelos de respaldo).
  • Hugging Face (Para hospedar el backend Python).
  • Make.com (Para el flujo de datos).
  • Netlify (Para hospedar el frontal web).
3. Preparación del Backend

Antes de desplegar, asegúrate de configurar los archivos base del proyecto:

  • file: company_config.json: Rellena tus datos fiscales, nombre de empresa, CIF, dirección y numeración de presupuestos.
  • assets/logo.png: Sube tu logo corporativo para incluirlo en los PDFs.
  • Variables de Entorno: Prepara tus claves GROQ_API_KEY, OPENROUTER_API_KEY y las URLs de los webhooks de Make.
4. Funcionalidad 1: Extractor de Facturas

El sistema acepta múltiples archivos (JPG, PNG, PDF) simultáneamente. Si es una imagen, la IA detecta el documento, mejora la legibilidad y extrae:

  • Proveedor, CIF/NIF y Número de factura.
  • Fecha de factura y vencimiento.
  • Base imponible, Tipo de IVA e Importe Total.
  • Categoría de gasto y método de pago sugerido.

Si la IA tiene dudas, marcará el campo needs_review para que lo revises manualmente en el frontend antes de enviarlo a tu libro de cuentas.

5. Funcionalidad 2: Generador de Presupuestos

Desde el frontend, introduces los datos del cliente y los conceptos. El backend:

  • Calcula automáticamente IVA y totales.
  • Genera un PDF profesional con tu logo y pie legal.
  • Nombra el archivo con formato estándar: AAAA-MM-DD_Num_Presupuesto_Cliente.pdf.
  • Envía el PDF al webhook de Make para guardarlo en tu Drive.
6. Configuración de Make.com (Escenarios)

Necesitarás dos escenarios en Make:

6.1 Escenario de Facturas

Recibe el JSON confirmado -> Sube el archivo original a Google Drive (Carpeta FACTURAS) -> Añade una fila al Google Sheets con todos los datos extraídos.

6.2 Escenario de Presupuestos

Recibe el PDF generado -> Lo guarda en Google Drive (Carpeta PRESUPUESTOS) -> (Opcional) Envía el PDF por email al cliente.

7. Errores Comunes y Soluciones
  • Error de CORS: Asegúrate de que FastAPI tiene configurado el CORSMiddleware para aceptar peticiones desde tu dominio de Netlify.
  • Límite de API de Groq: Si subes muchas facturas a la vez, podrías alcanzar el rate limit. El sistema incluye un fallback automático a OpenRouter para evitar interrupciones.
  • PDF no se guarda en Drive: Revisa que en Make el campo "Data" del módulo de Drive esté recibiendo el contenido binario o base64 correctamente desde el webhook.
8. Checklist Final para Despliegue
  • [✓] Backend desplegado en Hugging Face (Status Health: OK).
  • [✓] Variables de entorno configuradas (API Keys + Webhooks).
  • [✓] Carpetas "FACTURA" y "PRESUPUESTOS" creadas en Drive.
  • [✓] Escenarios de Make activos y con estructura de datos detectada.
  • [✓] Frontend en Netlify apuntando a la URL de tu Space.