Las claves de API te permiten conectar aplicaciones externas con tu cuenta de FacturaDirecta de forma segura. Cada clave tiene permisos específicos y da acceso únicamente a la empresa donde se creó.

Acceder a la configuración de API

Para gestionar tus claves de API:

Haz clic en ⚙️ Ajustes (icono de engranaje en el menú superior)
Selecciona "API e integraciones" en el menú lateral

Obtener tu identificador de empresa (companyId)

En la sección de API verás tu identificador de empresa (companyId). Este valor es único para cada empresa y lo necesitarás en todas las llamadas a la API.

El companyId aparece en la URL de la API:

https://app.facturadirecta.com/api/{companyId}/invoices

Crear una nueva clave de API

Haz clic en "Crear nueva clave de API"
Introduce un nombre descriptivo para identificar el uso de la clave (por ejemplo: "Integración CRM" o "App móvil")
Selecciona los permisos que necesitas:
- TODOS: Acceso completo de lectura y escritura
- LECTURA: Solo lectura en todos los recursos
- Permisos individuales: Selecciona los permisos específicos que necesitas
Haz clic en "Crear clave"
Copia y guarda la clave inmediatamente: por seguridad, solo se muestra una vez

⚠️ Importante: Guarda tu clave de API de forma segura. No podrás volver a verla después de cerrar el diálogo. Si la pierdes, tendrás que crear una nueva.

Permisos disponibles (scopes)

Los permisos se organizan por recurso y tipo de acceso:

Permiso	Descripción
`contacts:read`	Lectura de contactos
`contacts:write`	Escritura de contactos
`products:read`	Lectura de productos
`products:write`	Escritura de productos
`invoices:read`	Lectura de facturas
`invoices:write`	Escritura de facturas
`estimates:read`	Lectura de presupuestos
`estimates:write`	Escritura de presupuestos
`deliveryNotes:read`	Lectura de albaranes
`deliveryNotes:write`	Escritura de albaranes
`bills:read`	Lectura de gastos
`bills:write`	Escritura de gastos
`payrolls:read`	Lectura de nóminas
`payrolls:write`	Escritura de nóminas
`banks:read`	Lectura de bancos
`banks:write`	Escritura de bancos
`accounting:read`	Lectura de contabilidad
`accounting:write`	Escritura de contabilidad
`settings:read`	Lectura de configuración
`settings:write`	Escritura de configuración

Gestionar claves existentes

En la tabla de claves puedes ver:

Columna	Descripción
Nombre	El nombre descriptivo que asignaste
Prefijo	Los primeros caracteres de la clave (para identificarla)
Fecha de creación	Cuándo se creó la clave
Creada por	Usuario que creó la clave

Haz clic en una clave para ver sus permisos o eliminarla.

Eliminar una clave

Haz clic en la clave que quieres eliminar
En el menú de acciones, selecciona "Borrar"
Confirma la eliminación

⚠️ Atención: Tras eliminar una clave, cualquier aplicación que la use dejará de funcionar inmediatamente. Asegúrate de actualizar primero tus integraciones con una nueva clave.

Notas de seguridad

No compartas tus claves: Trátalas como contraseñas
Usa permisos mínimos: Asigna solo los permisos que la integración necesita
Rota las claves periódicamente: Si sospechas que una clave está comprometida, elimínala y crea una nueva
Una clave por integración: Facilita identificar y revocar accesos si es necesario

💡 Tip: Las claves API del sandbox son independientes de las de producción. Crea claves distintas para cada entorno y no las mezcles.