Saltar al contenido principal

Tareas humanas

Una tarea humana detiene el proceso hasta que alguien con el rol y el grupo adecuados la completa. Es el punto donde el banco pone una aprobación, por ejemplo «Aprobar alta» para el grupo de cumplimiento.

Consultar la bandeja​

Roles ORQ_APPROVER u ORQ_OPERATOR. Sin filtros devuelve tu bandeja: las tareas asignadas a tu cliente o a sus grupos.

curl -s "https://orquestador.banco.example/api/v1/tasks?businessKey=solicitud-100" \
  -H "Authorization: Bearer $TOKEN"

Filtros opcionales: assignee, candidateGroup, processInstanceId y businessKey.

[
  {
    "id": "8e4b1d66-3b4d-11f1-9a0e-0242ac120004",
    "name": "Aprobar alta",
    "taskKey": "aprobarAlta",
    "processInstanceId": "5c1e9a72-3b4d-11f1-9a0e-0242ac120004",
    "processKey": "altaClienteAprobacion",
    "businessKey": "solicitud-100",
    "assignee": null,
    "candidateGroups": ["oficial-cumplimiento"],
    "fourEyes": true,
    "createdAt": "2026-10-20T14:02:11Z"
  }
]

Completar una tarea​

Rol ORQ_APPROVER. Las variables que envíes pasan al proceso, que decide con ellas el camino siguiente.

curl -s -X POST "https://orquestador.banco.example/api/v1/tasks/8e4b1d66-3b4d-11f1-9a0e-0242ac120004:complete" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{ "variables": { "aprobado": true } }'

Respuesta 204 sin cuerpo. Quien completa queda registrado como asignado en el historial de la instancia.

Reglas​

  • Grupos candidatos: solo la completa un cliente que pertenezca a alguno de los candidateGroups de la tarea.
  • Asignación: una tarea asignada solo la completa su asignado.
  • Cuatro ojos: si fourEyes es true, el cliente que inició la instancia no puede completarla, aunque pertenezca al grupo. Usa credenciales distintas para iniciar y para aprobar.
  • Variables inválidas (por ejemplo, un cuerpo que no es un objeto): 400 VARIABLES_INVALIDAS.