Para Gestorías
API con alcance documentado
Automatiza recursos del workspace mediante API key y consulta aging consolidado de workspaces autorizados con el endpoint específico para gestorías.
La API pública expone los recursos incluidos en su contrato OpenAPI. Hoy, la operación multi-cliente específica y verificada es el aging consolidado; no presentamos como live endpoints de cartera, batch fiscal o solicitudes que no figuran en el contrato.
Lo que puedes hacer
Aging consolidado multi-cliente
POST /v1/gestoria/aging acepta hasta 200 workspaces y devuelve datos solo de aquellos donde el solicitante tiene pertenencia autorizada.
Facturas y clientes por workspace
Consulta o crea recursos documentados con una API key del workspace. No se comparte un token universal entre clientes.
Contrato OpenAPI 3.1
Comprueba métodos, payloads y respuestas en /openapi.yaml antes de integrar; el contrato publicado prevalece sobre ejemplos de marketing.
Webhooks documentados
Crea suscripciones desde /v1/webhooks y utiliza los eventos publicados con firma HMAC-SHA256 y reintentos.
MCP remoto
El servidor MCP remoto expone 157 herramientas y usa OAuth 2.0 + PKCE. Es un canal distinto de la API REST con X-API-Key.
Solicitudes y mensajería
Los flujos de solicitudes de documentos y mensajería contextual permanecen en beta y no se anuncian como endpoints REST públicos.
Autenticación y autorización
La API REST usa X-API-Key y aplica el alcance del workspace. POST /v1/gestoria/aging vuelve a comprobar la pertenencia del gestor en cada workspace solicitado. El MCP remoto usa OAuth 2.0 + PKCE; no confundimos ambos mecanismos.
Endpoints más usados
| Método | Ruta | Propósito |
|---|---|---|
| POST | /v1/gestoria/aging | Aging consolidado de workspaces autorizados. |
| GET | /v1/invoices | Listar facturas del workspace autenticado. |
| POST | /v1/invoices | Crear una factura en el workspace autenticado. |
| GET | /v1/clients | Listar clientes del workspace autenticado. |
| GET | /v1/webhooks | Listar suscripciones webhook del workspace. |
| GET | /openapi.yaml | Consultar el contrato OpenAPI 3.1 vigente. |
Documentación completa en docs.frihet.io. Volumen, soporte o un SLA dedicado requieren un acuerdo expreso; no vienen garantizados por esta página.
Ver documentación de la API
Si automatizas con n8n o scripts propios, revisamos contigo el contrato publicado y el alcance del piloto.