Documentación de Frihet
Frihet es un ERP moderno diseñado para gestionar facturación, gastos, clientes, contabilidad e impuestos desde el teclado, desde la web o mediante agentes de IA y la API REST.
1. Empezar a facturar
Configura tu perfil fiscal, prueba tu primera factura en borrador con datos sintéticos y conoce la frontera entre borrador, emisión y envío.
2. Traer mis datos
Importa clientes, productos, facturas y gastos desde CSV, Excel o desde tu programa anterior con validación previa de columnas.
3. Conectar API o agente IA
Ejecuta tu primera lectura en GET /v1/clients, interpreta respuestas 200/401/403/429 o conecta Claude, Cursor o Hermes vía MCP.
[!TIP] ¿Algo no coincide con la guía o necesitas ayuda sobre tu cuenta? Consulta Soporte y diagnóstico rápido para resolver los errores más frecuentes de VeriFactu, facturación, bancos, API y MCP, o para abrir una consulta contextual con el equipo.
Elige tu recorrido inicial
1. Empezar a facturar
Si vas a emitir tus primeras facturas o quieres validar cómo calcula Frihet tus impuestos antes de emitir documentos reales:
- Crear una cuenta — alta de tu espacio de trabajo y acceso a la aplicación.
- Configurar tu negocio — NIF/CIF y razón social en Ajustes → Perfil Fiscal, y zona fiscal (IVA en Península y Baleares, IGIC en Canarias o IPSI en Ceuta y Melilla), retención de IRPF y series de numeración en Ajustes → Facturación.
- Tu primera factura — recorrido completo con ejemplo sintético en borrador (sin encadenar en VeriFactu ni enviar correos reales), punto de revisión antes de emitir, resultado esperado y recuperación si algún dato no coincide.
- Atajos de teclado — usa
Cmd+K(Ctrl+Ken Windows/Linux) para abrir la paleta de comandos y secuencias rápidas comoCy luegoF(crear factura) oGy luegoF(ir a facturas).
2. Traer mis datos
Si ya trabajabas con otro software de facturación o con hojas de cálculo y quieres conservar tu histórico y tu numeración:
- Importar facturas y migrar desde otro programa — orden recomendado de carga (clientes → catálogo → facturas), validador interactivo de cabeceras CSV en el navegador y revisión en lote antes de guardar en Ventas → Facturas → Importar o en Ajustes → Importar y migrar.
- Importar y exportar clientes y Subir facturas y tickets con IA — plantillas de columnas para tu base de contactos y extracción asistida a borradores para tus documentos de compra.
3. Conectar API o agente IA
Si quieres consultar o automatizar tu ERP desde código, flujos sin código o un asistente de IA:
- Inicio rápido para desarrolladores — genera tu clave (
fri_...) en Integraciones → API Keys, haz tu primera peticiónGET https://api.frihet.io/v1/clients?limit=5y comprueba la diferencia entre una respuesta200 OKcon datos, una cuenta nueva con lista vacía ("data": []) y los errores401,403o429. - Conectar tu agente IA y Servidor MCP — conecta Claude Code, Cursor, Windsurf, ChatGPT o Hermes mediante
@frihet/mcp-server(1.17.0,157operaciones canónicas). - Referencia de la API REST y Explorador OpenAPI interactivo — esquemas completos de petición/respuesta, filtros, cursores e idempotencia.
Conecta Frihet
Frihet publica sus propios canales oficiales para trabajar con las herramientas que ya usas. Todos están en el hub de integraciones y ecosistema.
| Canal | Para qué |
|---|---|
| Zapier | App pública de Frihet en Zapier: automatiza sin código. Ficha oficial |
| Shopify | App en la Shopify App Store: tus pedidos se convierten en facturas. Ficha oficial |
| n8n | Nodo de comunidad oficial para tus flujos de n8n |
| Hermes Agent | Plugin oficial de Frihet en el catálogo de Hermes, con confirmación humana en escrituras irreversibles |
| Servidor MCP | Claude, Cursor, ChatGPT y otros agentes conectados a tu ERP |
| CLI y SDK | Terminal y cliente TypeScript para tu código |
¿Qué es Frihet?
Una plataforma de gestión empresarial que reúne en un mismo lugar:
- Facturación y cobros — Presupuestos, facturas, facturas recurrentes, anticipos, enlaces de pago y notas de crédito
- Gestión de gastos y clientes — Registro de gastos, OCR, proveedores y CRM con contactos, notas y actividades
- Asistente IA con control humano — Propone acciones y borradores sobre tus datos para que tú los revises y confirmes
- Modo offline y sincronización — Consulta y prepara operaciones incluso con conexión intermitente
- Navegación por teclado — Paleta de comandos (
Cmd+K/Ctrl+K) y atajos directos en todas las vistas - Cumplimiento fiscal español — VeriFactu (encadenamiento hash SHA-256 y QR tributario), Facturae y modelos fiscales
Consulta todas las funcionalidades de Frihet o compara planes y precios.
Acceso rápido
Funcionalidades principales
| Sección | Qué encontrarás |
|---|---|
| Facturación | Crear facturas, presupuestos, notas de crédito, enlaces de pago y cobros |
| Clientes | Ficha de cliente, datos fiscales, contactos, notas, actividades y portal del cliente |
| Gastos | Registro, categorización, importación CSV y gastos deducibles |
| Productos | Catálogo de artículos, servicios, variantes, tarifas e impuestos |
| IA | Qué hace el asistente IA en la app, propuestas de borradores, consultas e impuestos |
| Integraciones | Canales oficiales, bancos, pasarelas de cobro, e-commerce y todas las integraciones |
| Configuración | Datos fiscales, series de facturación, equipo, permisos y seguridad |
| Desarrolladores | Inicio rápido de la API REST, webhooks, SDK TypeScript, CLI y servidor MCP |
| Soporte y diagnóstico | Árbol de resolución rápida de incidencias y canales de soporte contextual |
Para desarrolladores
| Recurso | Descripción |
|---|---|
| API REST | 8 recursos CRUD principales, subcolecciones CRM y 4 endpoints de inteligencia con autenticación por API key y paginación |
| Webhooks | 15 tipos de evento en tiempo real con firma HMAC-SHA256 y reintentos automáticos |
| Servidor MCP | 157 herramientas en @frihet/mcp-server (v1.17.0) para conectar Claude, Cursor, Windsurf o ChatGPT a tu ERP |
| Skill Claude Code | Comandos /frihet y contexto fiscal español directamente desde tu terminal (npx skills add Frihet-io/frihet-mcp) |
Información legal
Principios de diseño
Frihet está construido alrededor de tres ideas:
- Velocidad desde el teclado — Navega y ejecuta acciones con la paleta de comandos (
Cmd+K/Ctrl+K) y atajos de dos teclas sin levantar las manos del teclado. - Inteligencia verificable — El asistente IA te ayuda a preparar borradores y consultar datos, manteniendo siempre tu confirmación antes de ejecutar cambios.
- Datos abiertos y portables — Tus documentos y registros son accesibles en formatos estándar (CSV, PDF, Facturae XML, API REST JSON y MCP).
¿Dudas o algún paso no coincide con lo que ves en pantalla? Revisa Soporte y diagnóstico rápido, consulta cómo funciona el asistente IA o abre la paleta de comandos en la aplicación con Cmd+K (Ctrl+K). También puedes visitar el blog de Frihet para guías prácticas y novedades.