# Desarrolladores Frihet expone una API REST completa, un sistema de webhooks y un servidor MCP para que puedas integrar tu ERP con cualquier herramienta. Automatiza flujos de trabajo, sincroniza datos con tus sistemas existentes o construye integraciones a medida. Consulta todas las [funcionalidades de Frihet](https://www.frihet.io/es/features) y las [integraciones disponibles](https://www.frihet.io/es/integrations). ## Recursos principales ### [API REST](/desarrolladores/api-rest) API RESTful con autenticacion por API key. Accede a facturas, gastos, clientes, productos, presupuestos y proveedores de forma programatica. - Endpoints CRUD completos para 8 recursos: facturas, gastos, clientes, proveedores, productos, presupuestos, depositos y webhooks - Subcollections CRM: contactos, actividades y notas por cliente - 4 endpoints de inteligencia: `/summary`, `/context`, `/monthly`, `/quarterly` - Acciones especiales: descargar PDF/XML, enviar por email, marcar como pagada, rectificativas, recargos, facturacion de gastos, depositos - Creacion en lote (batch): hasta 50 registros por peticion - Filtrado por estado, rango de fechas, busqueda full-text y paginacion (offset + cursor) - Limite de 100 peticiones/minuto por clave - Respuestas JSON estandarizadas con validacion estricta (Zod) ### [Webhooks](/desarrolladores/webhooks) Recibe notificaciones en tiempo real cuando ocurren eventos en tu cuenta de Frihet. 27 tipos de evento con firma HMAC-SHA256 para verificar la autenticidad de cada payload. - 27 tipos de evento (facturas, pagos, rectificativas, presupuestos, gastos, clientes, productos, cobros) - Firma criptografica HMAC-SHA256 en cada entrega - Reintentos automaticos con backoff exponencial (3 intentos) - Circuit breaker: 3 fallos consecutivos pausa el webhook automaticamente - Logs de entrega consultables desde el panel ### [Servidor MCP](/desarrolladores/mcp-server) Servidor MCP oficial publicado en npm como `@frihet/mcp-server` (v1.15.3), registrado como `io.frihet/erp` en el MCP Registry. 157 herramientas para integrar Frihet con asistentes de IA (Claude, Cursor, Windsurf). - 157 herramientas, 11 recursos, 10 prompts (facturas, gastos, clientes, CRM, productos, presupuestos, proveedores, inteligencia, webhooks, e-invoicing, Stay, POS, banking, fiscal, time, recurring, HR, payroll, onboarding, permissions, period close, IGIC, impuesto de sociedades, audit GL, gestoria) - Transporte local (stdio) y remoto (mcp.frihet.io) - Logging estructurado, metricas por herramienta, rate-limit retry automatico - Autenticacion via API key o flujo OAuth - Open source (MIT) en [GitHub](https://github.com/Frihet-io/frihet-mcp) ### [Skill para Claude Code](/desarrolladores/skill-claude-code) Skill oficial que anade inteligencia de negocio sobre el servidor MCP. Comandos conversacionales, contexto fiscal espanol, recetas de flujos de trabajo y formateo de informes. - Comandos: `/frihet invoice`, `/frihet expense`, `/frihet report`, `/frihet clients` - Preparacion automatica del Modelo 303 (IVA trimestral) - Cierre mensual, seguimiento de morosos, conversion presupuesto-factura - Instalacion: `npx skills add Frihet-io/frihet-mcp` --- ## Modelo de tiers de integracion Frihet organiza sus 100+ integraciones en tres niveles segun la profundidad de la conexion: | Tier | Nombre | Descripcion | | ---------- | ----------------------- | --------------------------------------------------------------------------------------------------- | | **Tier 1** | Full Sync | Sincronizacion bidireccional completa vía servicios dedicados (import + webhooks + reconciliacion). | | **Tier 2** | Credentials Only / Beta | Credenciales guardadas de forma segura. Sincronizacion automatica completa en roadmap. | | **Tier 3** | Webhook URL | Genera una URL webhook para conectar con tus automatizaciones. Sin sync bidireccional. | Puedes ver el badge de tier de cada integracion en la pantalla de conexion dentro de la app. --- ## Integraciones soportadas Frihet se conecta de forma nativa con mas de 100 herramientas. Cada integracion se puede complementar con la API REST y los webhooks para cubrir casos de uso avanzados. Consulta las [integraciones disponibles](https://www.frihet.io/es/integrations) en la web. ### Tier 1 — Full Sync (41 integraciones) Sincronizacion bidireccional completa. Lista para produccion. | Categoria | Servicio | | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Pagos** | [PayPal](/integraciones/paypal), GoCardless, Stripe Revenue, Stripe Connect | | **Banca** | Mercury, Pleo, Wise, Qonto | | **E-commerce** | [Shopify](/integraciones/shopify), [WooCommerce](/integraciones/woocommerce), [Gumroad](/integraciones/gumroad), [Lemon Squeezy](/integraciones/lemon-squeezy), [Etsy](/integraciones/etsy), [Square](/integraciones/square), [Squarespace](/integraciones/squarespace), [PrestaShop](/integraciones/prestashop) | | **Contabilidad** | Xero, QuickBooks Online, FreshBooks, Wave Accounting, Zoho Books, Sage Business Cloud, Lexoffice | | **Time tracking** | [Toggl](/integraciones/toggl), [Clockify](/integraciones/clockify), [Harvest](/integraciones/harvest) | | **Productividad** | [Asana](/integraciones/asana), [Trello](/integraciones/trello), [Notion](/integraciones/notion) | | **Calendario** | [Google Calendar](/integraciones/google-calendar), [Outlook Calendar](/integraciones/outlook-calendar) | | **Almacenamiento** | [Google Drive](/integraciones/google-drive), [Google Sheets](/integraciones/google-sheets), [Dropbox](/integraciones/dropbox) | | **Comunicacion** | [Slack](/integraciones/slack) | | **CRM** | [HubSpot](/integraciones/hubspot), [Pipedrive](/integraciones/pipedrive), [Intercom](/integraciones/intercom) | | **Firma** | [PandaDoc](/integraciones/pandadoc), [DocuSign](/integraciones/docusign), [HelloSign](/integraciones/hellosign) | | **Gastos** | [Expensify](/integraciones/expensify) | | **Email** | [Mailchimp](/integraciones/mailchimp) | ### Tier 2 — Credentials Only / Beta (56 integraciones) Credenciales conectadas y configuracion lista. Sincronizacion completa en roadmap. | Categoria | Servicios | | ---------------- | ---------------------------------------------------------------------------------------------- | | **E-commerce** | eBay, TikTok Shop, Printful, BigCommerce, Magento/Adobe Commerce | | **CRM** | Salesforce, Zoho CRM, Freshsales, Close CRM, Copper CRM | | **Logistica** | Sendcloud, ShipStation, Correos Spain, SEUR, DHL Express, FedEx, UPS, Shippo | | **RRHH** | Factorial, Personio, BambooHR, Gusto, PayFit | | **Marketing** | Brevo, ConvertKit, ActiveCampaign, Lemlist, Beehiiv, Meta Marketing API, Google Ads API | | **TPV** | SumUp POS, SumUp Payments, SumUp Invoices, Lightspeed Restaurant, Lightspeed X-Series | | **Comunicacion** | Discord Webhooks, Microsoft Teams Webhooks, Telegram Bot API | | **Freelance** | Upwork | | **Pagos** | Adyen, Checkout.com, Braintree, Mollie, Bunq, Brex, Monzo Premium, N26 Business, Starling Bank | | **Open Banking** | Tink, OpenBanking, PayPal Sandbox, Plaid, Revolut | | **Banca** | [N26](/integraciones/n26) | | **Mensajeria** | [WhatsApp](/integraciones/whatsapp) | | **Marketplaces** | [Amazon Seller](/integraciones/amazon-seller) | | **Contabilidad** | Bexio | ### Tier 3 — Webhook URL (2 integraciones) Conecta via webhook personalizado a tus flujos de automatizacion. | Servicio | Descripcion | | --------------------------- | ------------------------------------------------------ | | [n8n](/integraciones/n8n) | Flujos de automatizacion personalizados via webhook | | [Make](/integraciones/make) | Automatizacion visual con cientos de apps via webhooks | ### App nativa oficial — Zapier [Zapier](/integraciones/zapier) tiene una **app nativa oficial de Frihet** (Beta publica, aprobada 26-jun-2026) con autenticacion por API key. 43 operaciones: 14 triggers, 21 acciones y 8 busquedas. Conecta Frihet con 7.000+ apps sin configurar webhooks manualmente. [Ver en Zapier →](https://zapier.com/apps/frihet/integrations) --- ## Seguridad La seguridad es una prioridad en toda la capa de integraciones de Frihet. - **Cifrado AES-256-GCM** para datos sensibles almacenados (tokens de integracion, secretos de webhook) - **HMAC-SHA256** en cada entrega de webhook para verificar la autenticidad del payload - **Hashing SHA-256** de las API keys en el servidor -- la clave en texto plano solo se muestra una vez al crearla - **Validacion de formato** de API keys antes de procesarlas (prefijo `fri_`, longitud 40-60 caracteres, charset restringido) - **Rate limiting** de 100 peticiones por minuto por clave API, respaldado por almacenamiento persistente - **Validacion estricta** de datos con Zod — campos desconocidos se rechazan - **Validacion de URL** en webhooks: solo se permiten endpoints HTTPS (excepto localhost en desarrollo) - **Bloqueo de IPs privadas** para evitar SSRF en las URLs de webhook - **Validacion de IDs de documento** para prevenir path traversal e inyeccion - **Tokens con expiracion configurable** -- puedes crear claves con fecha de caducidad - **Cabeceras de seguridad** en todas las respuestas: `X-Content-Type-Options`, `X-Frame-Options`, `X-XSS-Protection` --- ## SDKs y CLI SDKs oficiales para integrar Frihet en tu stack: | Paquete | Instalacion | Descripcion | | ---------------------------------------------------------- | ------------------- | ------------------------------------------------------------------------------ | | [`@frihet/sdk`](https://www.npmjs.com/package/@frihet/sdk) | `npm i @frihet/sdk` | SDK TypeScript — `frihet.invoices.create()`, tipos completos, retry automatico | | [`frihet`](https://www.npmjs.com/package/frihet) | `npm i -g frihet` | CLI — `frihet invoices list --status overdue` | | **Python** | Proximamente | En desarrollo | ```typescript const frihet = new Frihet({ apiKey: 'fri_...' }); const invoice = await frihet.invoices.create({ clientName: 'Acme Corp', items: [{ description: 'Consulting', quantity: 10, unitPrice: 150 }], }); ``` Repositorio: [github.com/Frihet-io/frihet-sdk](https://github.com/Frihet-io/frihet-sdk) --- ## Limites y cuotas | Recurso | Limite | | ------------------------------ | --------------------------- | | Peticiones API | 100/minuto por clave | | Tamano de peticion | 1 MB maximo | | Offset maximo | 10.000 | | Tamano de payload de webhook | 100 KB maximo | | Webhooks por cuenta | 20 maximo | | Reintentos de webhook | 3 intentos por entrega | | Resultados por pagina | 100 maximo (50 por defecto) | | Claves API activas por usuario | 5 maximo (via OAuth) | --- ## Primeros pasos 1. Accede a **Ajustes > Desarrolladores > API Keys** en tu cuenta de Frihet 2. Crea una nueva API key y copia la clave (solo se muestra una vez) 3. Prueba la conexion con una peticion GET a `/v1/clients` 4. Configura webhooks para recibir eventos en tiempo real ```bash curl -s https://api.frihet.io/v1/clients \ -H "X-API-Key: fri_tu-clave-aqui" | head -c 200 ``` Si la respuesta incluye tus clientes, la integracion esta funcionando. Consulta la [referencia de la API REST](./api-rest.md) para ver todos los endpoints disponibles.