Gesbon API v1

Todas las peticiones requieren HTTP Basic Auth con las mismas credenciales que se usan para acceder al panel de Gesbon.

Ejemplo

# Con curl
curl -u "[email protected]:contraseña" https://api.gesbon.es/v1/bonificada/trabajadores?ejercicio=2026&empresa_id=123

# O con header explícito (Base64 de "email:password")
curl -H "Authorization: Basic ZW1haWxAZW1wcmVzYS5jb206Y29udHJhc2XDsWE=" https://api.gesbon.es/v1/...

https://api.gesbon.es/v1/{perfil}/{recurso}

Perfiles disponibles

Parámetros obligatorios en TODAS las peticiones

Parámetros opcionales (query string)

Ejemplo respuesta

{
  "data": [
    {
      "id": 12345,
      "empresa_id": 5196,
      "ejercicio": 2026,
      "tipo_documento": "NIF",
      "documento": "12345678Z",
      "nombre": "Juan",
      "primer_apellido": "García",
      "segundo_apellido": "López",
      "genero": "Hombre",
      "fecha_nacimiento": "15/03/1990",
      "niss": "281234567890",
      "cuenta_cotizacion": "28123456789",
      "email": "[email protected]",
      "telefono": "600123456",
      "salario_bruto_anual": "30000",
      "horas_convenio": "1800",
      "nivel_estudios": 4,
      "categoria_profesional": 5,
      "grupo_cotizacion": 5,
      "discapacidad": 0,
      "victima_terrorismo": 0,
      "violencia_genero": 0,
      "fijo_discontinuo": 0,
      "creado": 1710720000
    }
  ],
  "pagination": { "page": 1, "limit": 100, "total": 47, "pages": 1 }
}

Body (JSON) - Campos

Ejemplo: Crear trabajador

curl -X POST \
  -u "[email protected]:password" \
  -H "Content-Type: application/json" \
  -d '{
    "empresa_id": 5196,
    "tipo_documento": "NIF",
    "documento": "12345678Z",
    "nombre": "Juan",
    "primer_apellido": "García",
    "segundo_apellido": "López",
    "genero": "Hombre",
    "fecha_nacimiento": "15/03/1990",
    "niss": "281234567890",
    "email": "[email protected]",
    "salario_bruto_anual": "30000",
    "horas_convenio": "1800"
  }' \
  "https://api.gesbon.es/v1/bonificada/trabajadores?ejercicio=2026"

Respuesta (201 Created)

{
  "data": { /* objeto trabajador completo */ },
  "action": "created",
  "message": "Trabajador created successfully."
}

Respuesta upsert (200 OK) - Si el NIF ya existía

{
  "data": { /* objeto trabajador actualizado */ },
  "action": "updated",
  "message": "Trabajador with NIF '12345678Z' already existed and was updated (upsert)."
}

Ejemplo

curl -X PUT \
  -u "[email protected]:password" \
  -H "Content-Type: application/json" \
  -d '{
    "empresa_id": 5196,
    "email": "[email protected]",
    "telefono": "600999888"
  }' \
  "https://api.gesbon.es/v1/bonificada/trabajadores/12345?ejercicio=2026"

Parámetros opcionales (query string)

Ejemplo respuesta

{
  "data": [
    {
      "id": 5196,
      "ejercicio": 2026,
      "nif": "B12345678",
      "nombre_fiscal": "Empresa Ejemplo S.L.",
      "nombre_comercial": "Ejemplo",
      "representante_legal": "Juan García",
      "direccion": "Calle Mayor 1",
      "codigo_postal": "28001",
      "provincia": "Madrid",
      "poblacion": "Madrid",
      "telefono": "910000000",
      "email": "[email protected]",
      "expediente": "EX-2026-001",
      "cuenta_cotizacion": "28123456789",
      "credito_asignado": 15000.00,
      "plantilla_media": 50
    }
  ],
  "total": 3,
  "filters": { "ejercicio": 2026, "search": null }
}

Body (JSON) - Campos

Parámetros opcionales (query string)

Body (JSON) - Campos

Body (JSON, opcional)

{ "dry_run": false }

Lógica de asignación

Documentos base — siempre, en cualquier modalidad:

• recibi
• certificado (variante certificado_mixta cuando modalidad = Mixta)
• evaluacion

Reglas adicionales según modalidad y checks del grupo:

Respuesta (modo ejecución)

{
    "data": {
        "grupo_formativo_id": 123,
        "grupo_formativo_codigo": "G001",
        "modalidad": "Presencial",
        "tipos_documento": ["recibi", "certificado", "evaluacion", "control_asistencia"],
        "participantes_count": 8,
        "plan": [
            { "id_grupos_formativos_participantes": 5001, "id_usuario_participante": 200, "tipo_documento": "recibi" },
            "..."
        ],
        "plan_size": 32,
        "dry_run": false,
        "inserted": 32,
        "skipped_existing": 0
    },
    "message": "Asignación ejecutada: 32 nuevos registros, 0 saltados..."
}

Parámetros opcionales (query string)

Ejemplo respuesta

{
  "data": [
    {
      "id": 789,
      "grupo_formativo_id": 456,
      "grupo_formativo_codigo": "G01",
      "trabajador_id": 12345,
      "trabajador_documento": "12345678Z",
      "trabajador_nombre": "Juan García López",
      "evaluacion_positiva": 1,
      "minimo_horas": 1,
      "ejercicio": 2026
    }
  ],
  "total": 15,
  "filters": { "ejercicio": 2026, "empresa_id": 5196, "grupo_formativo_id": null }
}

Body (JSON) - Campos

Formato de error

{
  "error": true,
  "message": "Validation failed",
  "details": [
    "Invalid NIF/NIE: '1234'. Checksum does not match.",
    "Field 'nombre' is required."
  ]
}

Endpoints disponibles

La API ofrece los siguientes recursos para integración completa:

Configuración en SAP PI/PO

1. Crear un Communication Channel tipo HTTP con:
   • URL: https://api.gesbon.es/v1/{perfil}/{recurso}?ejercicio=2026
   • Auth: Basic Authentication
   • User: email de acceso a Gesbon
   • Password: contraseña de acceso a Gesbon
2. Content-Type: application/json
3. Método: POST para crear/actualizar, PUT para modificar, DELETE para eliminar
4. Mapear los campos de SAP HR al JSON de la API

Configuración en SAP CPI (Cloud Platform Integration)

1. Crear un HTTP Receiver Adapter
2. URL: https://api.gesbon.es/v1/{perfil}/{recurso}?ejercicio=2026
3. Authentication: Basic
4. Credential Name: crear credential con email/password de Gesbon

Flujo recomendado

1. Consultar empresas disponibles con GET /empresas
2. SAP extrae datos de empleados (PA30, Infotipo 0001/0002)
3. Envía POST por cada trabajador (upsert por NIF)
4. Crea acciones formativas y grupos formativos vía POST (upsert por código)
5. Asigna participantes a los grupos con POST /participantes
6. Registra respuestas para auditoría