El módulo de Workflow implementa un motor BPM (Business Process Management) propio que permite definir procesos, tareas y formularios dinámicos. Los procesos se modelan con estados, transiciones y acciones configurables desde la interfaz de administración.

Conceptos clave

Flujo de vida de una instancia

1. Se crea una instancia del proceso (normalmente desde un módulo ciudadano).
2. El sistema asigna la primera tarea al pool o a un usuario específico.
3. El usuario toma la tarea (POST /api/tomar-tarea/).
4. El usuario completa el formulario dinámico de la tarea.
5. Se ejecuta una acción (POST /api/ejecutar-accion/) para avanzar el proceso.
6. El sistema actualiza el estado de la instancia y asigna la siguiente tarea.
7. El ciclo se repite hasta que el proceso llega a un estado final.

Endpoints de usuario

Mis tareas

Formulario de tarea

API de tareas y procesos

Gestión de formularios dinámicos

Esquema de formulario (JSON Schema)

Los formularios dinámicos se definen mediante JSON Schema. Ejemplo mínimo:

{
  "type": "object",
  "properties": {
    "nombre": {
      "type": "string",
      "title": "Nombre completo"
    },
    "fecha_nacimiento": {
      "type": "string",
      "format": "date",
      "title": "Fecha de nacimiento"
    },
    "estado": {
      "type": "string",
      "title": "Estado",
      "enum": ["activo", "inactivo"]
    }
  },
  "required": ["nombre"]
}

Webhook de reconciliación BPM

Permite que sistemas externos sincronicen el estado de los procesos mediante una llamada server-to-server autenticada.

POST /workflow/api/reconciliar-bpm/
X-Reconcile-Token: tu_token_secreto_bpm
Content-Type: application/json

{
  "instancia_id": "uuid-de-la-instancia",
  "nuevo_estado": "completado",
  "datos": { }
}

import requests

TOKEN = "tu_token_secreto_bpm"
resp = requests.post(
    "https://TU-DOMINIO/workflow/api/reconciliar-bpm/",
    headers={"X-Reconcile-Token": TOKEN},
    json={
        "instancia_id": "uuid-de-la-instancia",
        "nuevo_estado": "completado",
        "datos": {}
    }
)
data = resp.json()

const TOKEN = 'tu_token_secreto_bpm';
const { data } = await axios.post(
  'https://TU-DOMINIO/workflow/api/reconciliar-bpm/',
  {
    instancia_id: 'uuid-de-la-instancia',
    nuevo_estado: 'completado',
    datos: {}
  },
  { headers: { 'X-Reconcile-Token': TOKEN } }
);

client.DefaultRequestHeaders.Add("X-Reconcile-Token", "tu_token_secreto_bpm");
var body = new StringContent(
    JsonSerializer.Serialize(new {
        instancia_id = "uuid-de-la-instancia",
        nuevo_estado = "completado",
        datos = new { }
    }),
    Encoding.UTF8, "application/json"
);
var response = await client.PostAsync(
    "https://TU-DOMINIO/workflow/api/reconciliar-bpm/", body);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://TU-DOMINIO/workflow/api/reconciliar-bpm/"))
    .header("X-Reconcile-Token", "tu_token_secreto_bpm")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(
        "{\"instancia_id\":\"uuid-de-la-instancia\"," +
        "\"nuevo_estado\":\"completado\",\"datos\":{}}"
    ))
    .build();

Modelos de datos

Staging y publicación de procesos

Los procesos siguen un flujo de versionado antes de activarse en producción:

1. Borrador (staging): Se editan los procesos y formularios sin afectar instancias activas.
2. Guardar staging: POST /workflow/api/procesos/{llave}/staging/guardar/ — persiste cambios en staging.
3. Publicar: POST /workflow/api/procesos/{llave}/publicar/ — promueve el staging a versión activa.

Generación de documentos desde Workflow

Las instancias de proceso pueden generar documentos PDF con información del trámite:

• GET /generar/{plantilla}/{llave}/ — genera HTML desde plantilla Django con datos de la instancia.
• POST /imprimir/ — convierte el HTML generado a PDF para descarga.
• POST /api-siud/documentos/generar/ — versión API (requiere codigo y llave).