Squadra PlanningSquadra
Planes Pro y Enterprise

Conecta Squadra a tus herramientas

Nuestra API permite obtener tus datos (planificación, fichajes, empleados, permisos) desde cualquier herramienta externa: Power BI, Metabase, HRIS, scripts Excel, paneles internos… sin escribir código en Squadra.

¿Para qué sirve?

Panel Power BI / Metabase

Crea un panel BI sobre horas, costes, ausencias.

Exportación Excel automática

Script diario que obtiene los fichajes y rellena tu hoja de nómina.

Sincronización HRIS o CRM

Alinea plantilla y ausencias con tu RRHH o CRM.

Solo lectura

Sin escritura, tus datos no se pueden modificar vía la API.

Accesos limitados

Cada clave tiene sus permisos. Una clave por integración, más seguro.

1000 llamadas / hora

Cuota generosa, trazabilidad completa, revocación inmediata.

Cómo funciona, en 3 pasos

1

Generar una clave

Desde Admin → Claves API, haz clic en "Nueva clave". Nómbrala y marca los permisos. La clave se muestra UNA SOLA VEZ, cópiala de inmediato.

Generar una clave API
2

Enviarla en cada solicitud

En tu herramienta, añade la clave en el encabezado HTTP "Authorization" formato Bearer.

Authorization: Bearer sqd_live_xxxxxxxxxxxxxxxxxxxx
3

Llamar a una URL

Llama a la URL del dato deseado. Recibes JSON limpio, listo para usar.

curl https://www.squadraplanning.com/api/v1/employees \
  -H "Authorization: Bearer sqd_live_..."

¿Qué puedes obtener?

Lista de datos disponibles. Cada URL empieza con https://www.squadraplanning.com/api

GET/v1/organization

Nombre y plan de tu organización

organization.read
GET/v1/employees

Empleados con rol, contrato, tarifa horaria

employees.read
GET/v1/locations

Tus tiendas, dirección, GPS

locations.read
GET/v1/shifts

Turnos planificados en un rango de fechas

shifts.read
GET/v1/timesheets

Fichajes reales (entrada, salida, anomalías)

timesheets.read
GET/v1/leave-requests

Solicitudes de permiso (estado, fechas, tipo)

leave_requests.read

Filtrar resultados

Todos los endpoints de lista aceptan filtros:

limit

Número de resultados (máx 200, por defecto 50)

offset

Saltar los primeros N (paginación)

from

Fecha de inicio (ISO)

to

Fecha de fin (ISO)

user_id

Limitar a un empleado

location_id

Limitar a una tienda

Ejemplo completo

Obtener todos los fichajes de Lucile en abril:

curl "https://www.squadraplanning.com/api/v1/timesheets?user_id=LUCILE_ID&from=2026-04-01&to=2026-04-30" \
  -H "Authorization: Bearer sqd_live_xxxxxxxxxxxx"

# Response
{
  "data": [
    {
      "id": "a1b2c3...",
      "user_id": "LUCILE_ID",
      "check_in":  "2026-04-15T09:03:00Z",
      "check_out": "2026-04-15T17:58:00Z",
      "break_duration": 45,
      "status": "VALIDATED",
      "is_late": false
    }
  ]
}

Si no funciona

401Clave ausente, inválida, revocada o expirada
402API requiere plan Pro o Enterprise
403Tu clave no tiene permiso para este endpoint
429Demasiadas llamadas (máx 1000/hora)
500Problema nuestro, contacta soporte

¿Listo para empezar?

30 segundos para generar una clave y probar.

Abrir mi espacio API