--- title: "Frihet Documentation" description: "Frihet: AI-powered ERP for modern businesses. Start invoicing, migrate your data, and connect the REST API or MCP agents." canonical_url: "https://docs.frihet.io/en/" language: "en" --- # Frihet Documentation **Frihet** is a modern ERP built to manage invoicing, expenses, clients, accounting, and taxes from the keyboard, the web app, or through AI agents and the REST API. - [**1. Start invoicing**](/primeros-pasos/primera-factura): Configure your tax profile, test your first draft invoice with synthetic data, and understand the boundary between draft, issuing, and sending. - [**2. Bring my data**](/facturacion/importar-facturas): Import clients, products, invoices, and expenses from CSV, Excel, or your previous accounting tool with column validation before saving. - [**3. Connect API or AI agent**](/desarrolladores): Run your first GET /v1/clients read request, interpret 200/401/403/429 responses, or connect Claude, Cursor, or Hermes via MCP. > [!TIP] > **Does something not match the guide or do you need help with your account?** Check [Support & Quick Troubleshooting](./primeros-pasos/soporte-diagnostico) to resolve common VeriFactu, invoicing, banking, REST API, and MCP issues, or to open a contextual support request with our team. --- ## Choose your starting journey {#recorridos-iniciales} ### 1. Start invoicing {#empezar-a-facturar} If you are about to create your first invoices or want to verify how Frihet calculates taxes before issuing real fiscal documents: 1. [Create an account](./primeros-pasos/crear-cuenta) — set up your workspace and sign in to the app. 2. [Configure your business](./primeros-pasos/configurar-negocio) — enter your Tax ID (NIF/CIF) and legal name under **Settings** → **Tax Profile**, and set your tax zone (**VAT / IVA** in Mainland Spain & Balearic Islands, **IGIC** in the Canary Islands, or **IPSI** in Ceuta & Melilla), IRPF withholding, and numbering series under **Settings** → **Billing**. 3. [Your first invoice](./primeros-pasos/primera-factura) — end-to-end walkthrough with a **synthetic draft example** (without chaining in VeriFactu or sending real emails), pre-issue review checkpoint, expected result, and recovery steps. 4. [Keyboard shortcuts](./primeros-pasos/atajos-teclado) — press `Cmd+K` (`Ctrl+K` on Windows/Linux) to open the command palette and use two-key sequences such as `C` then `F` (create invoice) or `G` then `F` (go to invoices). ### 2. Bring my data {#traer-mis-datos} If you are switching from another invoicing tool or spreadsheets and want to keep your history and numbering continuity: - [Import invoices and migrate from another tool](./facturacion/importar-facturas) — recommended import sequence (**clients → catalog → invoices**), interactive browser-side CSV header validator, and batch preview before saving under **Sales** → **Invoices** → **Import** or **Settings** → **Import & migrate**. - [Import and export clients](./clientes/importar-exportar) and [Upload invoices and receipts with AI](./ia/subir-documentos) — column templates for your client directory and AI-assisted extraction into drafts for your purchase documents. ### 3. Connect API or AI agent {#conectar-api-o-agente} If you want to query or automate your ERP from code, no-code workflows, or an AI assistant: - [Developer quickstart](./desarrolladores/resumen.md) — create your key (`fri_...`) under **Integrations** → **API Keys**, run your first read request to `GET https://api.frihet.io/v1/clients?limit=5`, and distinguish a `200 OK` response with records, a new account with an empty list (`"data": []`), and `401`, `403`, or `429` error responses. - [Connect your AI agent](./agentes/conectar-tu-agente) and [MCP server](./desarrolladores/mcp-server) — connect Claude Code, Cursor, Windsurf, ChatGPT, or Hermes using `@frihet/mcp-server` (`1.17.0`, `157` canonical operations). - [REST API reference](./desarrolladores/api-rest) and [Interactive OpenAPI explorer](/api-reference) — full request/response schemas, filters, cursor pagination, and idempotency. --- ## Connect Frihet Frihet publishes its own official channels to work with the tools you already use. They are all in the [integrations and ecosystem hub](/integraciones). | Channel | What for | | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | | [Zapier](./integraciones/zapier) | Public Frihet app on Zapier: automate without code. [Official listing](https://zapier.com/apps/frihet/integrations) | | [Shopify](./integraciones/shopify) | App in the Shopify App Store: your orders become invoices. [Official listing](https://apps.shopify.com/frihet-erp) | | [n8n](./integraciones/n8n) | Official community node for your n8n workflows | | [Hermes Agent](./agentes/hermes) | Official Frihet plugin in the Hermes catalog, with human confirmation on irreversible writes | | [MCP server](./desarrolladores/mcp-server) | Claude, Cursor, ChatGPT and other agents connected to your ERP | | [CLI and SDK](./desarrolladores/sdk-cli) | Terminal and TypeScript client for your code | ## What is Frihet? A business management platform that brings together in one place: - **Invoicing and collections** — Quotes, invoices, recurring invoices, deposits, payment links, and credit notes - **Expense and client management** — Expense tracking, OCR, vendors, and CRM with contacts, notes, and activities - **Human-in-the-loop AI assistant** — Proposes actions and drafts over your data for you to review and confirm - **Offline mode and sync** — Browse and prepare operations even with an intermittent connection - **Keyboard navigation** — Command palette (`Cmd+K` / `Ctrl+K`) and direct shortcuts across every screen - **Spanish tax compliance** — VeriFactu (SHA-256 hash chaining and tax QR), Facturae, and tax models See all [Frihet features](https://www.frihet.io/en/features) or compare [plans and pricing](https://www.frihet.io/en/pricing). ## Quick access ### Core features {#funcionalidades-principales} | Section | What you will find | | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | | [Invoicing](./facturacion/facturas) | Create invoices, quotes, credit notes, payment links, and payment records | | [Clients](./clientes/gestion-clientes) | Client records, tax details, contacts, notes, activities, and the client portal | | [Expenses](./gastos/registrar-gastos) | Recording, categorization, CSV import, and deductible expenses | | [Products](./productos/catalogo) | Product and service catalog, variants, price lists, and taxes | | [AI](./ia/que-puede-hacer) | What the in-app AI assistant does, draft proposals, data queries, and tax guidance | | [Integrations](/integraciones) | Official channels, banking, payment gateways, e-commerce, and [all integrations](https://www.frihet.io/en/integrations) | | [Settings](./configuracion/datos-empresa) | Tax profile, invoice series, team members, permissions, and security | | [Developers](./desarrolladores/resumen.md) | REST API quickstart, webhooks, TypeScript SDK, CLI, and MCP server | | [Support & troubleshooting](./primeros-pasos/soporte-diagnostico) | Quick diagnostic matrix and contextual support channels | ### For developers {#para-desarrolladores} | Resource | Description | | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | | [REST API](./desarrolladores/api-rest) | 8 core CRUD resources, CRM subcollections, and 4 intelligence endpoints with API key authentication and pagination | | [Webhooks](./desarrolladores/webhooks) | 15 real-time event types with HMAC-SHA256 signatures and automatic retries | | [MCP Server](./desarrolladores/mcp-server) | 157 tools in `@frihet/mcp-server` (v1.17.0) to connect Claude, Cursor, Windsurf, or ChatGPT to your ERP | | [Claude Code Skill](./desarrolladores/skill-claude-code) | `/frihet` commands and Spanish tax context directly from your terminal (`npx skills add Frihet-io/frihet-mcp`) | ### Legal information {#informacion-legal} - [TicketBAI in the Basque Country](./cumplimiento/ticketbai-pais-vasco) - [Privacy and data protection](./legal/privacidad) --- ## Design principles Frihet is built around three ideas: 1. **Keyboard speed** — Navigate and run actions with the command palette (`Cmd+K` / `Ctrl+K`) and two-key shortcuts without taking your hands off the keyboard. 2. **Verifiable intelligence** — The AI assistant helps you prepare drafts and query data, always requiring your confirmation before saving changes. 3. **Open, portable data** — Your documents and records are accessible in standard formats (CSV, PDF, Facturae XML, REST API JSON, and MCP). --- Questions or does a step not match what you see on screen? Check [Support & Quick Troubleshooting](./primeros-pasos/soporte-diagnostico), learn how the [AI assistant](./ia/que-puede-hacer) works, or open the command palette in the app with `Cmd+K` (`Ctrl+K`). You can also visit the [Frihet blog](https://www.frihet.io/en/blog) for practical guides and product updates.