Skip to main content

​
Claves API

Las claves API permiten que sistemas externos (CRM, ERP, scripts, automatizaciones) se conecten a FinSync sin que un empleado inicie sesión en el navegador. Se administran desde Configuración > Equipo y acceso → Empleados, sección Configuraciones avanzadas → Claves API. FinSync ofrece dos tipos de credenciales:
  • Claves de la empresa: una credencial por integración. Autentican a nombre de la compañía (sin persona asociada) y no pasan por los permisos de rol. Son las de esta pantalla.
  • Claves personales de empleado: quien tenga el permiso Solicitar clave API personal genera la suya desde el menú de usuario → Claves API personales. Las solicitudes quedan registradas a su nombre (email) en la auditoría y respetan los permisos de su rol (incluidos los alcances de clientes). Ver más abajo.

​
Requisitos de acceso

  • Disponible en planes que incluyan acceso a API (en el plan gratuito verás un mensaje de que la API no está habilitada).
  • Quien gestione empleados y configuración avanzada de la empresa debe tener acceso para administrar claves API (típicamente Administrador). Ver Roles y Empleados para entender cómo funcionan los accesos.
  • Las claves personales las crea cada empleado para sí mismo si su rol tiene Solicitar clave API personal (personal_api.create). El rol de sistema Operador no lo trae; Administrador sí. Un administrador con acceso a claves API puede revocarlas desde la columna Clave API del listado de empleados.

​
Límites y creación

  • Podés tener hasta 25 claves API activas o inactivas por empresa.
  • Al crear una clave ingresás un nombre descriptivo (ej. “Integración con CRM”, “Script conciliación nocturna”).
  • Tras crearla, el sistema muestra la clave completa una sola vez. Copiala y guardala en un gestor de secretos; no se vuelve a mostrar.
  • En la lista verás un preview parcial de cada clave, fecha de creación y último uso si aplica.

​
Acciones sobre cada clave

  • Activar / desactivar: Una clave inactiva deja de autenticar llamadas sin borrar el registro.
  • Eliminar: Borra la clave de forma permanente (pedirá confirmación). Cualquier integración que la use dejará de funcionar de inmediato.

​
Cómo se usan en integraciones

Las rutas de API para tu compañía esperan el header:
Las claves personales de empleado aceptan el mismo header o un token Bearer:
La documentación técnica (endpoints, ejemplos en varios lenguajes y convenciones) está en el portal de documentación de FinSync, pestaña Overview y API Reference. Desde la misma pantalla de claves API hay un enlace Ver documentación de API disponible.

​
Claves API personales de empleado

Un empleado con el permiso Solicitar clave API personal puede generar su credencial desde el menú de usuario (abajo a la izquierda) → Claves API personales. Se usa igual que las claves de empresa, pero:
  • Auditoría: cada operación queda registrada con el email del empleado, no como una integración anónima. Ver Auditoría.
  • Permisos: la clave puede hacer exactamente lo que el rol del empleado permite en el dashboard. Si el rol no puede crear operaciones o solo ve ciertos clientes, la clave hereda esas restricciones.
  • Límite: 1 clave por empleado (activa o inactiva).
  • Revocación: el empleado puede desactivar o eliminar su clave; un administrador con acceso a claves API puede revocarla desde la columna Clave API del listado de empleados.
Las claves personales se invalidan automáticamente si el empleado es eliminado de la empresa o la empresa queda bloqueada.