Desarrolladores
Frihet expone una API REST completa y un sistema de webhooks para que puedas integrar tu ERP con cualquier herramienta. Automatiza flujos de trabajo, sincroniza datos con tus sistemas existentes o construye integraciones a medida.
Recursos principales
API REST
API RESTful con autenticacion por API key. Accede a facturas, gastos, clientes, productos y presupuestos de forma programatica.
- Endpoints CRUD completos para 5 recursos
- Paginacion, filtrado y ordenacion
- Limite de 100 peticiones/minuto por clave
- Respuestas JSON estandarizadas
Webhooks
Recibe notificaciones en tiempo real cuando ocurren eventos en tu cuenta de Frihet. 14 tipos de evento con firma HMAC-SHA256 para verificar la autenticidad de cada payload.
- 14 tipos de evento (facturas, gastos, presupuestos, clientes, productos)
- Firma criptografica en cada entrega
- Reintentos automaticos con backoff exponencial
- Logs de entrega consultables desde el panel
Integraciones soportadas
Frihet se conecta de forma nativa con las siguientes herramientas. Cada integracion se puede complementar con la API REST y los webhooks para cubrir casos de uso avanzados.
| Categoria | Servicio | Descripcion |
|---|---|---|
| Pagos | Stripe | Suscripciones y cobros a clientes mediante Stripe Billing y Connect |
| E-commerce | Shopify | Importacion de pedidos y sincronizacion de productos via OAuth |
| E-commerce | WooCommerce | Sincronizacion bidireccional de pedidos y productos via webhooks |
| Banca | Revolut Business | Importacion automatica de transacciones via OAuth |
| Productividad | Google Calendar | Recordatorios de vencimiento y eventos de facturacion |
| Comunicacion | Slack | Notificaciones de facturas pagadas, gastos registrados y alertas |
| Automatizacion | n8n | Conexion via webhooks para flujos de automatizacion personalizados |
| Time tracking | Toggl | Importacion de registros de tiempo para facturacion por horas |
| Time tracking | Clockify | Sincronizacion de proyectos y registros de tiempo |
| Resend | Envio de facturas por correo con plantillas transaccionales |
Servidor MCP
Servidor MCP oficial publicado en npm como @frihet/mcp-server. Conecta tu asistente de IA (Claude, Cursor, Windsurf, Cline) directamente con tu ERP.
- 31 herramientas para 6 recursos (facturas, gastos, clientes, productos, presupuestos, webhooks)
- Transporte local (stdio) y remoto (mcp.frihet.io)
- Open source (MIT) en GitHub
- Rate-limit retry automatico con backoff exponencial
Skill para 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:
git clone+ symlink a~/.claude/skills/frihet
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
- Rate limiting de 100 peticiones por minuto por clave API
- 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
- Tokens con expiracion configurable -- puedes crear claves con fecha de caducidad
SDKs (proximamente)
Estamos trabajando en SDKs oficiales para simplificar la integracion:
| SDK | Estado |
|---|---|
| Node.js / TypeScript | En desarrollo |
| Python | En desarrollo |
Mientras tanto, la API REST es accesible desde cualquier lenguaje que soporte peticiones HTTP. Los ejemplos de esta documentacion usan curl y se pueden adaptar directamente.
Limites y cuotas
| Recurso | Limite |
|---|---|
| Peticiones API | 100/minuto por clave |
| Tamano de peticion | 1 MB maximo |
| 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) |
Primeros pasos
- Accede a Configuracion > API en tu cuenta de Frihet
- Crea una nueva API key y copia la clave (solo se muestra una vez)
- Prueba la conexion con una peticion GET a
/api/v1/clients - Configura webhooks para recibir eventos en tiempo real
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 para ver todos los endpoints disponibles.