Referencia de ayuda de la API Flowenti Robots

Devuelve el contexto de la organización asociada a la API Key emitida para el robot. Se debe llamar antes de cualquier otra petición.

{
  "organizations": [
    {
      "id": 14299,
      "name": "robots snippet",
      "administrator": false,
      "subscriptionname": "",
      "hasmultipleuser": false,
      "creation": "2026-09-07T14:00:12.282+02:00",
      "deleted": false,
      "icon": null
    }
  ]
}

• organizationsLista de las organizaciones vinculadas a la API key del robot: con un token de robot contiene una sola.
• idID numérico de la organización: es el valor que se usa como {idorganization} en los demás endpoints.
• nameNombre visible de la organización.
• administratortrue si el robot opera con permisos de administrador de la organización.
• subscriptionnameNombre del plan/suscripción de la organización (puede estar vacío).
• hasmultipleusertrue si la organización tiene varios usuarios asociados.
• creationFecha/hora de creación de la organización (ISO 8601).
• deletedtrue si la organización fue eliminada (soft delete).
• iconIcono/logo de la organización (null si no está configurado).

Descubre qué procesos el robot tiene autorizados para iniciar en la organización especificada.

{
  "possiblestart": [
    {
      "id": 21,
      "name": "",
      "idtype": 0,
      "idprocessmodel": 88,
      "processmodelname": "Gestione Ordini",
      "idswimlane": 1,
      "swimlanename": "Lane 1",
      "idorganization": 14207,
      "assignmentmode": 0,
      "userschema": "[]"
    }
  ]
}

• possiblestartLista de eventos de inicio disponibles: cada entrada es un proceso que el robot puede instanciar.
• idID del evento de inicio: es el valor que se usa como {idevent} al iniciar el proceso.
• nameNombre del evento de inicio (puede estar vacío).
• idtypeTipo de evento de inicio definido en el modelo BPMN.
• idprocessmodelID del modelo de proceso (BPMN) al que se refiere la operación.
• processmodelnameNombre del modelo de proceso (BPMN) al que pertenece el evento de inicio.
• idswimlaneID de la lane (swimlane) asignada a las actividades del proceso iniciado.
• swimlanenameNombre de la lane asociada.
• idorganizationID de la organización donde se ejecuta la operación: la misma asociada a la API key (JWT) del robot.
• assignmentmodeModo de asignación de tareas definido en el modelo (0 = asignación automática desde la cola).
• userschemaEsquema de usuarios admitidos (JSON serializado) asociado al evento de inicio.

Instancia un nuevo proceso BPMN generando el token inicial de avance.

{
  "idprocessmodel": 88,
  "idorganization": 14207,
  "idevent": 21,
  "startdate": "2026-08-26T08:00:00Z",
  "enddate": null,
  "description": "Fattura #2026-0451",
  "descriptiondetail": "Emissione automatica da robot",
  "userdata": { "cliente": "Acme Spa" }
}

• idprocessmodelID del modelo de proceso (BPMN) al que se refiere la operación.
• idorganizationID de la organización donde se ejecuta la operación: la misma asociada a la API key (JWT) del robot.
• ideventID del evento de inicio del modelo que instancia el proceso: se elige de /startevents/organizations/{idorganization}.
• startdateFecha/hora de inicio del proceso en formato ISO 8601 (p. ej. 2026-08-26T08:00:00Z).
• enddateFecha/hora de fin del proceso; null hasta que el proceso se cierre.
• descriptionDescripción breve del proceso, visible en la interfaz (p. ej. Factura #2026-0451).
• descriptiondetailDescripción ampliada opcional con los detalles operativos de la instancia del proceso.
• userdataObjeto con datos libres ligados a la instancia (p. ej. cliente): persistentes durante toda la vida del proceso.

{
  "process": {
    "id": 773019
  },
  "processtoken": {
    "id": 901,
    "state": 0
  },
  "previousprocesstoken": {
    "id": 901
  }
}

• processProceso instanciado: el campo id es la referencia global para leer adjuntos y consultar el proceso.
• processtokenToken de avance creado o movido por la operación: es la unidad de trabajo que el robot guía nodo a nodo.
• idID del token de avance: identificador único de la unidad de trabajo.
• stateEstado del token: 0 = en espera (todo), 1 = en curso (doing), 2 = completada (done).
• previousprocesstokenEstado del token antes de la operación: útil para auditoría y para reconstruir el historial del proceso.

Consulta el sistema para verificar si hay tareas disponibles que el robot pueda asumir.

{
  "waitingflownodes": [
    {
      "idprocesstoken": 901,
      "idflownode": 41,
      "designerid": "Task_EstrarreFatturePDF",
      "flownodename": "EstrarreFatturePDF",
      "idprocess": 773019,
      "idprocessmodel": 88,
      "idorganization": 14207,
      "processmodelname": "Gestione Ordini",
      "state": 0,
      "priority_name": "HIGH",
      "countcomments": 0,
      "countattachments": 2
    }
  ],
  "doingflownodes": []
}

• waitingflownodesTareas en espera (estado todo) que el robot puede tomar con nextstate/doing.
• doingflownodesTareas actualmente en curso (estado doing) por el robot.
• idprocesstokenID del token de avance sobre el que operar en las llamadas siguientes (nextstate, adjuntos, exit).
• idflownodeID del nodo de actividad: es el valor que se usa como {idflownode} en el body de nextstate.
• designeridID alfanumérico del nodo en el diagrama BPMN (id XML del diseñador): necesario para /exit/{designerid} en los gateways.
• flownodenameNombre legible de la actividad tal como está dibujada en el modelo BPMN.
• idprocessID del proceso al que pertenece la tarea: se necesita para leer adjuntos (/processes/{idprocess}/attachments/light).
• idprocessmodelID del modelo de proceso (BPMN) al que se refiere la operación.
• idorganizationID de la organización donde se ejecuta la operación: la misma asociada a la API key (JWT) del robot.
• processmodelnameNombre del modelo de proceso (BPMN) al que pertenece el evento de inicio.
• stateEstado del token: 0 = en espera (todo), 1 = en curso (doing), 2 = completada (done).
• priority_namePrioridad de la tarea definida en el modelo (p. ej. HIGH): guía el orden de procesamiento.
• countcommentsNúmero de comentarios presentes en la tarea (solo lectura).
• countattachmentsNúmero de adjuntos ya presentes en la tarea (solo lectura).

Notifica a Flowenti que el robot ha tomado la tarea, cambiando el estado del token a

{
  "idflownode": 555,
  "iduserrobot": 17
}

• idflownodeID del nodo de actividad (flownode) al que se refiere la acción: llega en la lista waitingflownodes devuelta por el polling.
• iduserrobotID del usuario/robot que ejecuta la operación: el asociado al token JWT del robot.

{
  "idtoken": 888111,
  "state": 1,
  "claimedAt": "2026-08-27T14:33:02Z",
  "iduserrobot": 17
}

• idtokenID del token cuyo estado cambió como resultado de la operación.
• stateEstado del token: 0 = en espera (todo), 1 = en curso (doing), 2 = completada (done).
• claimedAtFecha/hora de la toma de la tarea (ISO 8601).
• iduserrobotID del usuario/robot que ejecuta la operación: el asociado al token JWT del robot.

Marca la finalización correcta de la tarea y avanza el flujo al siguiente nodo.

{
  "idflownode": 555,
  "result": {
    "validated": true,
    "extractedFields": {
      "total": 1234.56,
      "vat": 258.86
    }
  }
}

• idflownodeID del nodo de actividad (flownode) al que se refiere la acción: llega en la lista waitingflownodes devuelta por el polling.
• resultPayload de resultado en formato libre con los datos producidos por la tarea (p. ej. campos extraídos): se guarda en el proceso y queda disponible para los nodos siguientes.

{
  "process": {
    "id": 1661721,
    "idprocessmodel": 27613,
    "idorganization": 14299,
    "state": 0
  },
  "processtoken": {
    "id": 35093744,
    "idprocess": 1661721,
    "idflownode": 38882,
    "flownodetype": 0,
    "iduser": 21976,
    "state": 2,
    "previous": 35093743,
    "created": "...",
    "startdoing": "...",
    "done": "..."
  },
  "previousprocesstoken": {
    "id": 35093743,
    "state": 2,
    "idflownode": 40414
  },
  "previousflownode": {
    "id": 40414,
    "designerid": "Activity_1",
    "name": "prima task"
  },
  "flownode": {
    "id": 38882,
    "designerid": "Event_1blr1wv",
    "idtype": 1
  },
  "sequenceflows": []
}

• processProceso instanciado: el campo id es la referencia global para leer adjuntos y consultar el proceso.
• processtokenToken de avance creado o movido por la operación: es la unidad de trabajo que el robot guía nodo a nodo.
• idID del token de avance: identificador único de la unidad de trabajo.
• idprocessID del proceso al que pertenece el token.
• idflownodeID del nodo (actividad o evento) en el que se encuentra el token.
• flownodetypeTipo de nodo (0 = evento, 1 = actividad, ...).
• iduserID del usuario/robot que tiene el token a su cargo (0 si está en cola).
• stateEstado del token: 0 = en espera (todo), 1 = en curso (doing), 2 = completada (done).
• previousID del token anterior en el historial del proceso.
• createdFecha/hora de creación del token (ISO 8601).
• startdoingFecha/hora de toma de la tarea; null hasta que el token pasa a doing.
• doneFecha/hora de finalización; null hasta que el token pasa a done.
• previousprocesstokenEstado del token antes de la operación: útil para auditoría y para reconstruir el historial del proceso.
• previousflownodeNodo de donde proviene el token antes de la operación.
• flownodeNodo (actividad o evento) en el que se encuentra ahora el token.
• sequenceflowsFlujos de secuencia alcanzables desde el nodo actual: no vacío cuando se necesitan decisiones posteriores.

Deshace la última acción del robot sobre la tarea (undo): devuelve el estado del token de En curso (Doing, 1) a En espera (ToDo, 0) y reingresa la tarea en la cola de las disponibles. Es el único mecanismo de recuperación soportado hoy — no hay nextstate/error, failed ni abort — para usar cuando el runtime del robot no puede completar la actividad.

{
  "process": {
    "id": 1,
    "idorganization": 1,
    "idprocessmodel": 1,
    "startdate": "...",
    "enddate": null,
    "userdata": "{}"
  },
  "processtoken": {
    "id": 2,
    "idprocess": 1,
    "idflownode": 7,
    "flownodetype": 1,
    "iduser": 2,
    "state": 0,
    "previous": 0,
    "created": "...",
    "startdoing": null,
    "done": null
  },
  "flownode": {
    "id": 7,
    "name": "Attività 1",
    "designerid": "Activity_1"
  },
  "previousflownode": {
    "id": 6,
    "name": "Evento",
    "designerid": "StartEvent_1"
  },
  "previousprocesstoken": {
    "id": 1,
    "state": 2,
    "idflownode": 6,
    "flownodetype": 0,
    "iduser": 2,
    "previous": 0
  }
}

• processProceso instanciado: el campo id es la referencia global para leer adjuntos y consultar el proceso.
• processtokenToken de avance creado o movido por la operación: es la unidad de trabajo que el robot guía nodo a nodo.
• idID del token de avance: identificador único de la unidad de trabajo.
• idprocessID del proceso al que pertenece el token.
• idflownodeID del nodo (actividad o evento) en el que se encuentra el token.
• flownodetypeTipo de nodo (0 = evento, 1 = actividad, ...).
• iduserID del usuario/robot que tiene el token a su cargo (0 si está en cola).
• stateEstado del token: 0 = en espera (todo), 1 = en curso (doing), 2 = completada (done).
• previousID del token anterior en el historial del proceso.
• createdFecha/hora de creación del token (ISO 8601).
• startdoingFecha/hora de toma de la tarea; null hasta que el token pasa a doing.
• doneFecha/hora de finalización; null hasta que el token pasa a done.
• flownodeNodo (actividad o evento) en el que se encuentra ahora el token.
• previousflownodeNodo de donde proviene el token antes de la operación.
• previousprocesstokenEstado del token antes de la operación: útil para auditoría y para reconstruir el historial del proceso.

Selecciona la salida específica del gateway cuando el flujo BPMN llega a una decisión condicional o a un ramo guiado por el robot.

{
  "reason": "validated_by_robot",
  "metadata": {
    "validationScore": 0.97
  }
}

• reasonEtiqueta libre que documenta el motivo de la elección del ramo del gateway (p. ej. validated_by_robot).
• metadataObjeto opcional con datos adicionales sobre la decisión (p. ej. puntuación de validación).

{
  "idtoken": 888111,
  "selectedExit": "approve",
  "designerid": "Gateway_approve_01",
  "advancedAt": "2026-08-27T14:34:01Z"
}

• idtokenID del token cuyo estado cambió como resultado de la operación.
• selectedExitNombre de la salida del gateway seleccionada por el robot.
• designeridID alfanumérico del nodo en el diagrama BPMN (id XML del diseñador): necesario para /exit/{designerid} en los gateways.
• advancedAtFecha/hora del avance (ISO 8601).

Sube un archivo/documento adjunto vinculado al nodo actual del proceso (utiliza

{
  "idorganization": 14207,
  "filename": "fattura_2026.pdf",
  "cloudlink": "",
  "idtype": 1,
  "description": "Fattura 2026",
  "blob": "<base64 del file>",
  "size": 24576
}

• idorganizationID de la organización donde se ejecuta la operación: la misma asociada a la API key (JWT) del robot.
• filenameNombre del archivo con extensión, tal como debe aparecer en el adjunto.
• cloudlinkURL cloud alternativa a la subida binaria: si se informa, el adjunto apunta a un recurso remoto en lugar del blob.
• idtypeTipo de adjunto (idtype): identificador de la categoría de archivo gestionada por la plataforma.
• descriptionDescripción breve del proceso, visible en la interfaz (p. ej. Factura #2026-0451).
• blobContenido del archivo codificado en base64; size es su tamaño en bytes.
• sizeTamaño del archivo en bytes, coherente con el contenido del blob.

{
  "idattachment": 7890,
  "idprocesstoken": 888111,
  "filename": "fattura_2026.pdf",
  "size": 24576,
  "uploadedAt": "2026-08-27T14:34:10Z"
}

• idattachmentID del adjunto creado: para referenciarlo en operaciones posteriores.
• idprocesstokenID del token de avance sobre el que operar en las llamadas siguientes (nextstate, adjuntos, exit).
• filenameNombre del archivo con extensión, tal como debe aparecer en el adjunto.
• sizeTamaño del archivo en bytes, coherente con el contenido del blob.
• uploadedAtFecha/hora de la subida (ISO 8601).

Lee la lista ligera de todos los adjuntos del proceso (utiliza

{
  "attachments": [
    {
      "id": 7890,
      "idorganization": 1,
      "filename": "invoice-98765.pdf",
      "description": "",
      "idtype": 1,
      "cloudlink": "",
      "creation": "2026-09-09T14:34:10Z",
      "iduser": 0,
      "username": "",
      "activityname": "acct1"
    }
  ]
}

• attachmentsLista de adjuntos del proceso: una entrada por cada archivo subido.
• idID del adjunto.
• idorganizationID de la organización donde se ejecuta la operación: la misma asociada a la API key (JWT) del robot.
• filenameNombre del archivo con extensión, tal como debe aparecer en el adjunto.
• descriptionDescripción del adjunto (vacía si no se indicó al subirlo).
• idtypeTipo de adjunto (idtype): identificador de la categoría de archivo gestionada por la plataforma.
• cloudlinkURL cloud alternativa a la subida binaria: si se informa, el adjunto apunta a un recurso remoto en lugar del blob.
• creationFecha/hora de creación del adjunto (ISO 8601).
• iduserID del usuario que subió el adjunto (0 para los robots).
• usernameNombre de usuario de quien subió el adjunto (vacío para los robots).
• activitynameNombre de la actividad (nodo BPMN) a la que está vinculado el adjunto.

Variante de /tasks/doing filtrada por organización. Devuelve las tareas Doing del robot actual para una única organización.

{
  "doingflownodes": [
    {
      "idprocesstoken": 1,
      "idprocess": 1,
      "idflownode": 7,
      "flownodename": "Attività 1",
      "priority_name": "Alta"
    }
  ]
}

• doingflownodesTareas actualmente en curso (estado doing) por el robot.
• idprocesstokenID del token de avance sobre el que operar en las llamadas siguientes (nextstate, adjuntos, exit).
• idprocessID del proceso al que pertenece la tarea: se necesita para leer adjuntos (/processes/{idprocess}/attachments/light).
• idflownodeID del nodo de actividad: es el valor que se usa como {idflownode} en el body de nextstate.
• flownodenameNombre legible de la actividad tal como está dibujada en el modelo BPMN.
• priority_namePrioridad de la tarea definida en el modelo (p. ej. HIGH): guía el orden de procesamiento.

Descubrimiento global de todos los eventos de inicio disponibles para el robot en todas las organizaciones. Alternativa cross-org a /startevents/organizations/{id}.

{
  "possiblestart": [
    {
      "id": 1,
      "name": "StartEvent_1",
      "idtype": 0,
      "idprocessmodel": 1,
      "processmodelname": "Modello A",
      "idswimlane": 1,
      "swimlanename": "Lane 1",
      "idorganization": 1,
      "assignmentmode": 1,
      "userschema": "..."
    }
  ]
}

• possiblestartLista de eventos de inicio disponibles: cada entrada es un proceso que el robot puede instanciar.
• idID del evento de inicio: es el valor que se usa como {idevent} al iniciar el proceso.
• nameNombre del evento de inicio (puede estar vacío).
• idtypeTipo de evento de inicio definido en el modelo BPMN.
• idprocessmodelID del modelo de proceso (BPMN) al que se refiere la operación.
• processmodelnameNombre del modelo de proceso (BPMN) al que pertenece el evento de inicio.
• idswimlaneID de la lane (swimlane) asignada a las actividades del proceso iniciado.
• swimlanenameNombre de la lane asociada.
• idorganizationID de la organización donde se ejecuta la operación: la misma asociada a la API key (JWT) del robot.
• assignmentmodeModo de asignación de tareas definido en el modelo (0 = asignación automática desde la cola).
• userschemaEsquema de usuarios admitidos (JSON serializado) asociado al evento de inicio.

Recupera la configuración JSON del robot para la organización y el modelo de proceso indicados. Usada en bootstrap para leer parámetros de driver, endpoints remotos y credenciales de integración.

{
  "id": 1,
  "idorganization": 1,
  "idrobot": 1,
  "idprocessmodel": 1,
  "linkedto": "",
  "datajson": {
    "chiave": "valore"
  }
}

• idID de la fila de configuración.
• idorganizationID de la organización donde se ejecuta la operación: la misma asociada a la API key (JWT) del robot.
• idrobotID del robot al que se refieren los datos.
• idprocessmodelID del modelo de proceso (BPMN) al que se refiere la operación.
• linkedtoReferencia interna de enlace (normalmente vacía).
• datajsonConfiguración y parámetros runtime del robot en JSON libre: se lee en el bootstrap y la interpreta el robot.

Lista las organizaciones asociadas al robot actual con sus tags (urgente, rutina, batch, etc.). Útil para enrutar la tarea a la organización correcta antes de tomarla.

{
  "idrobot": 1,
  "organizations": [
    {
      "id": 1,
      "name": "Org1",
      "tags": [
        {
          "id": 1,
          "name": "urgente",
          "idorganization": 1,
          "color": "#ff0000"
        }
      ]
    }
  ]
}

• idrobotID del robot al que se refieren los datos.
• organizationsLista de las organizaciones vinculadas a la API key del robot: con un token de robot contiene una sola.
• idID numérico de la organización: es el valor que se usa como {idorganization} en los demás endpoints.
• nameNombre visible de la organización.
• tagsTags asociados a la organización (p. ej. urgente, rutina, batch).
• tags.idID del tag.
• tags.nameNombre del tag (p. ej. urgente).
• tags.idorganizationID de la organización donde se ejecuta la operación: la misma asociada a la API key (JWT) del robot.
• tags.colorColor del tag en formato hex (p. ej. #ff0000).

Ajustes por-robot para una organización y modelo de proceso específicos. El query param `idprocessmodel` es obligatorio: sin él, el servidor busca la fila a nivel de organización (idprocessmodel is null), que normalmente no existe. Incluye el payload datajson con los parámetros runtime del robot.

{
  "id": 1,
  "idorganization": 1,
  "idrobot": 1,
  "idprocessmodel": null,
  "linkedto": "",
  "datajson": {
    "properties": {
      "campo1 ssss": {
        "type": "...",
        "value": "Test"
      }
    }
  }
}

• idID de la fila de configuración.
• idorganizationID de la organización donde se ejecuta la operación: la misma asociada a la API key (JWT) del robot.
• idrobotID del robot al que se refieren los datos.
• idprocessmodelID del modelo de proceso (BPMN) al que se refiere la operación.
• linkedtoReferencia interna de enlace (normalmente vacía).
• datajsonConfiguración y parámetros runtime del robot en JSON libre: se lee en el bootstrap y la interpreta el robot.
• propertiesMapa nombre → {type, value} con los parámetros runtime del robot.