Saltar a contenido

Operaciones y pruebas

Qué pide el SEPE

El SEPE no “entra en Moodle”. Exige que el centro publique un servicio web de seguimiento en HTTPS que cumpla el contrato ProveedorCentroTFWS (Anexo V de la Orden TMS/369/2019). Los sistemas del SEPE llaman a tu URL y tu plataforma responde.

Ese contrato define seis operaciones SOAP 1.1. No son extras del plugin: son lo que pide la norma. local_sepe implementa el lado proveedor: publica el WSDL y atiende esas llamadas. La autenticación, la sede electrónica y el IAE van aparte; esto es solo la pieza técnica del seguimiento.

Autenticación

Cada llamada: SOAP 1.1, HTTPS, WS-Security UsernameToken (PasswordText). Usuario fijo SEPE y la contraseña que define el centro (la misma que consignas en el trámite). Usuario/clave mal → Fault SOAP, sin datos de Moodle. Detalle: campos del plugin.

Las seis operaciones SOAP

Resumen rápido:

Operación Para qué
crearCentro Alta/actualización de la ficha del centro en el servicio.
obtenerDatosCentro Devuelve esa ficha (códigos, URLs, contacto).
crearAccion Registra una acción formativa en el seguimiento.
obtenerListaAcciones Lista los identificadores de las acciones.
obtenerAccion Detalle de una acción y su seguimiento (participantes, resultados…).
eliminarAccion Elimina una acción del seguimiento.

crearCentro

El SEPE (o el kit oficial de pruebas) empuja los datos identificativos del centro: origen, código, nombre, URL de plataforma, URL de seguimiento, teléfono y email. El servicio los guarda como ficha del “quién eres” ante el seguimiento.

En el kit oficial suelen usar, por ejemplo, origen 20 y código 9999999999. En producción esos códigos los asigna el organismo competente para tu expediente; en local_sepe también puedes mantener la ficha en ajustes del plugin.

obtenerDatosCentro

Pide esa ficha otra vez: “dime quién eres”. Sirve para comprobar que lo que hay en tu sistema coincide con lo esperado (nombre, URLs, códigos, contacto).

crearAccion

Envía una acción formativa (identificador SEPE, fechas, situación, especialidad, etc.) para que la registres en la plataforma y quede disponible para el seguimiento. En Moodle puedes vincularla a un curso para enriquecer participantes y notas.

obtenerListaAcciones

Devuelve la lista de identificadores (ORIGEN_ACCION + CODIGO_ACCION) de las acciones que tiene el servicio. El kit oficial comprueba que esa lista coincida con las acciones que acaba de crear (incluido el orden de creación).

obtenerAccion

Detalle de una acción concreta. Aquí suele ir la parte de seguimiento: participantes, evaluación, etc. Si la acción tiene curso Moodle vinculado, local_sepe puede aportar matrículas y calificaciones desde el campus.

eliminarAccion

Borra una acción del seguimiento. El kit oficial la usa al final de la batería; en producción se usa cuando toque dar de baja esa acción en el servicio.

Flujo típico (kit oficial)

El JAR ProvCentTFVal del SEPE ejercita el contrato en este orden aproximado:

  1. obtenerDatosCentro con password incorrecta → debe fallar bien (Fault / rechazo).
  2. obtenerDatosCentro con datos correctos → ficha alineada con el XML de prueba.
  3. crearCentro → ficha 20 / 9999999999 (en el XML de demo del kit).
  4. Lista vacía → varias crearAccion → lista que coincide → obtenerAccion → eliminarAccion.

Eso valida el servicio web. No sustituye el alta en el IAE ni la acreditación/inscripción administrativa del centro.

Prueba de humo

Es el chequeo mínimo de que el conector “enciende”: no es una auditoría ni el kit oficial completo.

  1. El WSDL responde XML por HTTPS.
  2. obtenerDatosCentro con UsernameToken devuelve código 0.
  3. obtenerAccion de una acción conocida devuelve código 0.
  4. Si hay curso vinculado, salen participantes y notas finales (demo: Ana 85, María 91, Luis 72).

Acción demo: origen 20, código 201428001000000000000000000001.

En el campus de demostración también se ha ejecutado el kit oficial ProvCentTFVal con resultado todo OK (0 KO). Ver landing del producto.

Note

Los códigos de demo solo ilustran el formato. En producción, CODIGO_CENTRO, CODIGO_ACCION y códigos de especialidad los asigna el SEPE / el organismo competente para tu expediente.