> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payana.la/llms.txt
> Use this file to discover all available pages before exploring further.

# Construir y editar un flujo

> Arma el recorrido de tus documentos en un editor visual: agrega pasos, define responsables, activa agentes y configura las reglas de cada paso — sin escribir una línea de código

El **editor de flujos** es un lienzo visual donde armas, paso a paso, el recorrido que seguirán tus documentos. Todo se hace arrastrando, haciendo clic y llenando un panel de configuración: no necesitas conocimientos técnicos.

<Frame caption="Vista general del editor de flujos: el canvas con los pasos del recorrido.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/workflows/overview-flujo-completo.gif?s=dddc3d10c650ace14bfd3e20681d97cb" alt="Vista general del editor de flujos" width="1066" height="600" data-path="images/workflows/overview-flujo-completo.gif" />
</Frame>

<Note>
  **¿Quién puede editar flujos?** Solo los usuarios con el permiso **Editar flujos de trabajo** pueden agregar, quitar y publicar pasos. Si no ves los botones para editar, pídele a un administrador de tu empresa que te asigne ese permiso desde **Espacio de trabajo → Roles y permisos**. Ver [Permisos](#permisos-para-editar).
</Note>

## Cómo llegar al editor

<Steps>
  <Step title="Abre la sección Flujos">
    En el menú lateral, entra a **Flujos**. Verás la lista de todos los flujos de tu empresa con su estado (publicado, borrador) y sus responsables.

    <Frame caption="La lista de flujos con su estado, responsables y agentes.">
      <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/workflows/lista-flujos.png?fit=max&auto=format&n=ciZIXW9SReB7Uh7w&q=85&s=613b9a5e146b905dc61e38fca7e95b69" alt="Lista de flujos de la empresa" width="1280" height="720" data-path="images/workflows/lista-flujos.png" />
    </Frame>
  </Step>

  <Step title="Abre el flujo que quieres editar">
    Haz clic en un flujo para abrir su editor. Se abre el canvas con el recorrido actual.
  </Step>

  <Step title="Edita el recorrido">
    Agrega, mueve o quita pasos, y configura cada uno desde el panel lateral (lo vemos abajo).
  </Step>
</Steps>

## Agregar un paso

Cada conector (la flecha entre dos pasos) tiene un botón **+**. Ahí insertas un paso nuevo.

<Steps>
  <Step title="Haz clic en el + del conector">
    Elige el punto del recorrido donde quieres insertar el paso: al inicio (antes del primer paso) o entre dos pasos existentes.
  </Step>

  <Step title="Elige el tipo de paso">
    Se abre un menú con los pasos disponibles: **Clasificación, Aprobación, Etiquetado, Registro en ERP (Causación), Generar CxP** y **Enviar eventos DIAN**. El menú desactiva las opciones que no aplican (por ejemplo, si el flujo ya causa, no te deja agregar otra causación).

    <Frame caption="Al hacer clic en el + de un conector se abre el menú de pasos disponibles.">
      <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/workflows/agregar-paso.gif?s=51f13a05c1e13f36e7ad8bc152275af3" alt="Menú para agregar un paso desde el conector" width="1066" height="600" data-path="images/workflows/agregar-paso.gif" />
    </Frame>
  </Step>

  <Step title="Configura el paso recién agregado">
    Al insertarlo, Payana abre automáticamente el panel de configuración para que lo completes. Un paso sin configurar queda **incompleto** y no dejará publicar el flujo hasta que lo termines.
  </Step>
</Steps>

### Qué pasos puedes agregar

Estos son los tipos de paso disponibles y cuántos admite un flujo. El menú del conector desactiva los que no aplican según lo que ya tenga tu recorrido:

| Tipo de paso                    | Qué hace                                                                                                                                                                                         | ¿Cuántos por flujo?                       |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- |
| **Clasificación**               | Asigna a cada documento **un** valor de un campo (Área, Centro de costo…) y **enruta** el recorrido según ese valor.                                                                             | Varios                                    |
| **Etiquetado**                  | Aplica **una o varias** etiquetas de tu catálogo para organizar y filtrar. **No** cambia el camino del documento.                                                                                | Varios                                    |
| **Aprobación**                  | Pide el visto bueno de una o varias personas (o de un agente) antes de continuar.                                                                                                                | Varios                                    |
| **Registro en ERP (Causación)** | Registra el documento en tu ERP. Es un paso con efecto real.                                                                                                                                     | Máximo **uno**                            |
| **Generar CxP**                 | Crea una cuenta por pagar a partir del documento.                                                                                                                                                | Máximo **uno** (excluyente con Causación) |
| **Enviar eventos DIAN**         | Envía a la DIAN los eventos que elijas para el documento (acuse de recibo, recibo del bien o servicio, aceptación expresa o tácita, reclamo), sin intervención manual. Disponible para Colombia. | Varios                                    |

<Note>
  Todo paso que agregues (o edites) vive en el **borrador** del flujo: no afecta a ningún documento hasta que **publicas**. Ver [Publicar un flujo](/flujos/publicar-flujo).
</Note>

<Warning>
  Algunas combinaciones no están permitidas porque romperían la lógica del flujo (por ejemplo, causar antes de aprobar, o tener dos causaciones). El editor te avisa y bloquea la publicación hasta corregirlo. Ver [Reglas del flujo](/flujos/publicar-flujo#reglas-del-flujo).
</Warning>

### Ejemplo: agregar un paso de etiquetado

Veámoslo de principio a fin con un caso real: agregar un paso de **etiquetado** que aplica etiquetas de *centro de costo*, con un agente que las asigna automáticamente.

<Steps>
  <Step title="Inserta el paso donde lo necesitas">
    Haz clic en el **+** del conector en el punto del recorrido donde quieres etiquetar y elige **Etiquetado** en el menú. Payana inserta el paso y abre su panel de configuración.

    <Tip>
      Si vas a etiquetar documentos que aún no se han clasificado, inserta el etiquetado **antes** de la clasificación. Cada documento pasará primero por el etiquetado.
    </Tip>
  </Step>

  <Step title="Ponle nombre">
    En **Información general**, dale un nombre claro (por ejemplo, *«Etiquetado por centro de costo»*). Ese nombre es el que verá tu equipo en el canvas y en sus tareas.
  </Step>

  <Step title="Elige las etiquetas disponibles">
    En **Etiquetas disponibles**, selecciona el conjunto que este paso podrá aplicar (por ejemplo, *Centro de Costos 1*, *Centro de Costos 2* y *Centro de Costos 3*). Si no eliges ninguna, el paso podrá usar cualquier etiqueta activa de tu empresa.

    <Frame caption="Elegir las etiquetas disponibles del paso: se abre el selector con el catálogo de la empresa, se buscan y se marcan las etiquetas de centro de costo que el paso podrá aplicar.">
      <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/workflows/etiquetado-tags-centro-costo.gif?s=e8e206e0799fd6cd925de4acaed123e7" alt="Seleccionar las etiquetas disponibles (Centro de Costos) de un paso de etiquetado" width="1000" height="625" data-path="images/workflows/etiquetado-tags-centro-costo.gif" />
    </Frame>

    <Note>
      Solo puedes elegir etiquetas que **ya existen** en tu empresa. Crear etiquetas nuevas es una acción aparte, desde la configuración de la empresa. El agente nunca inventa etiquetas.
    </Note>
  </Step>

  <Step title="Escribe la política del paso">
    En **Política del paso**, describe en lenguaje natural cuándo aplicar cada etiqueta. Es opcional, pero es lo que le da criterio al agente. Ver [Políticas de paso](/flujos/politicas).
  </Step>

  <Step title="Activa el agente y elige su modo">
    En **Agente IA**, enciende el agente y elige cómo trabaja: **Solo recomendar** (sugiere y una persona confirma) o **Recomendar y ejecutar** (aplica solo las etiquetas de alta confianza y deja el resto como sugerencias). Ver [Agente de etiquetado](/agentes/agente-etiquetado).
  </Step>

  <Step title="Guarda y publica">
    **Guarda** el paso: el cambio queda en el borrador. Cuando estés listo, **Publica** el flujo. Como agregar un paso es un cambio estructural, verás el aviso de [no-retroactividad](/flujos/publicar-flujo#no-retroactividad): el nuevo paso solo aplica a los documentos que entren de ahí en adelante.
  </Step>
</Steps>

<Frame caption="Agregar un paso de etiquetado de principio a fin: el menú del conector con los tipos de paso disponibles, elegir «Etiquetado» y el panel de configuración que se abre para completarlo.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/workflows/agregar-paso-etiquetado.gif?s=8f64960edfd14b7ddcc16c71fe84b85f" alt="Agregar y configurar un paso de etiquetado" width="1024" height="640" data-path="images/workflows/agregar-paso-etiquetado.gif" />
</Frame>

## Configurar un paso

Al hacer clic en cualquier paso, se abre un **panel lateral** con su configuración, organizada en secciones. No todos los pasos tienen todas las secciones: dependen del tipo.

<Frame caption="El panel lateral de un paso de aprobación, con sus secciones de configuración.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/workflows/panel-config-paso.png?fit=max&auto=format&n=ciZIXW9SReB7Uh7w&q=85&s=cd8cfff66c5fabeeabfb942f23a9e1fc" alt="Panel de configuración de un paso de aprobación" width="1280" height="720" data-path="images/workflows/panel-config-paso.png" />
</Frame>

### Información general

El nombre y la descripción del paso, tal como aparecerán en el canvas y en las tareas de tu equipo.

### Responsables

Quién es responsable de ese paso: las personas (o roles) que recibirán la tarea cuando un documento llegue ahí. En aprobaciones, aquí defines quién aprueba.

<Frame caption="La sección Responsables: tipo de asignación y a quién se asigna el paso.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/workflows/seccion-responsables.png?fit=max&auto=format&n=ciZIXW9SReB7Uh7w&q=85&s=407ce454a9d6fbbde5952651de0eb054" alt="Sección de responsables de un paso" width="421" height="186" data-path="images/workflows/seccion-responsables.png" />
</Frame>

<Note>
  **Cambiar responsables no re-versiona el flujo.** Si ajustas quién aprueba o clasifica, el cambio se aplica incluso a los documentos que ya están en curso. Es distinto de un cambio estructural (agregar o quitar pasos), que solo afecta a documentos nuevos. Ver [No-retroactividad](/flujos/publicar-flujo#no-retroactividad).
</Note>

### Campo a clasificar (solo Clasificación)

En los pasos de clasificación defines **el campo** por el cual se clasifica (por ejemplo *Área* o *Centro de costo*) y **sus valores posibles**. Cada valor puede tomar su propio camino en el flujo. Aprende más en [Campos personalizados](/flujos/campos-personalizados).

### Etiquetas (Clasificación / Etiquetado)

* En **Clasificación**, las etiquetas elegidas se vuelven las ramas de enrutamiento del flujo, así que necesitas al menos una.
* En **Etiquetado**, defines el conjunto de etiquetas que el responsable (o el agente) podrá aplicar. Si no eliges ninguna, quedan disponibles todas las etiquetas de la empresa.

### Modo de aprobación (solo Aprobación)

Define si la aprobación requiere el visto bueno de **todos** los aprobadores o de **cualquiera** de ellos, y si es una lista fija (sencilla) o cambia según la clasificación (condicional).

### Eventos a enviar (solo Enviar eventos DIAN)

Elige qué eventos DIAN se envían automáticamente cuando el flujo llega a este paso. Puedes seleccionar uno o varios:

* **Acuse de recibo**
* **Recibo del bien o servicio**
* **Aceptación expresa**
* **Aceptación tácita**
* **Reclamo**

<Frame caption="La sección Eventos a enviar del panel: elige uno o más eventos DIAN del catálogo fijo.">
  <img src="https://mintcdn.com/payana/C9bVZugqCl87xtc1/images/workflows/seccion-eventos-dian.png?fit=max&auto=format&n=C9bVZugqCl87xtc1&q=85&s=7ee8556d778b258c9b4726b74a3d85bc" alt="Sección Eventos a enviar de un paso de Eventos DIAN" width="1440" height="900" data-path="images/workflows/seccion-eventos-dian.png" />
</Frame>

<Note>
  Este paso es del tipo **sistema**: no tiene responsables ni agente, porque no requiere que nadie actúe. Payana envía los eventos elegidos apenas el flujo llega a este punto del recorrido, sin intervención manual.
</Note>

### Política del paso

El texto en lenguaje natural con los criterios de decisión de ese paso. Es opcional, pero es lo que le da inteligencia al agente. Puedes escribirla desde cero o reutilizar una del catálogo. Ver [Políticas de paso](/flujos/politicas).

<Frame caption="La sección Política del paso, con las opciones para agregar o reutilizar una política.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/workflows/seccion-politica.png?fit=max&auto=format&n=ciZIXW9SReB7Uh7w&q=85&s=f7637afb677248598bc01d4ba41f8586" alt="Sección Política del paso" width="1280" height="720" data-path="images/workflows/seccion-politica.png" />
</Frame>

### Agente IA

Aquí activas el agente del paso y eliges su modo de trabajo. Cada tipo de paso trae su propio agente (aprobación, etiquetado, clasificación…). Ver [Agentes de decisión](/agentes/introduccion-agentes-decision).

<Frame caption="La sección Agente IA del paso: interruptor para activar el agente y selector de modo.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/agentes/seccion-agente-ia.png?fit=max&auto=format&n=ciZIXW9SReB7Uh7w&q=85&s=0e9f88bed7909a5993d43ac1f3c4732e" alt="Sección Agente IA del paso" width="1280" height="720" data-path="images/agentes/seccion-agente-ia.png" />
</Frame>

### Editar un paso existente

Editar un paso es igual que configurarlo por primera vez: haz clic en el paso, ajusta lo que necesites en el panel lateral y **Guarda**. Al guardar, el cambio se queda en el **borrador** del flujo — no impacta a tus documentos hasta que **publicas**.

<Steps>
  <Step title="Haz clic en el paso que quieres cambiar">
    Se abre el panel lateral con su configuración actual.
  </Step>

  <Step title="Ajusta lo que necesites">
    Cambia el nombre, los responsables, las etiquetas, la política o el modo del agente. Puedes editar varias secciones de una sola vez.
  </Step>

  <Step title="Guarda y publica cuando estés listo">
    **Guardar** deja el cambio en el borrador. Cuando termines, **Publica** el flujo para aplicarlo. Ver [Publicar un flujo](/flujos/publicar-flujo).
  </Step>
</Steps>

<Tip>
  No todos los cambios se comportan igual al publicar. Cambiar **responsables, política o el agente** de un paso se aplica incluso a los documentos que ya están en curso; **agregar, quitar o reordenar** pasos solo aplica a los nuevos. Ver [No-retroactividad](/flujos/publicar-flujo#no-retroactividad).
</Tip>

## Mover y quitar pasos

* **Quitar un paso:** desde el menú de acciones del paso (el ícono de opciones), elige eliminar. Payana re-conecta automáticamente las flechas alrededor del paso eliminado para que el flujo siga siendo válido.
* **Reordenar:** inserta el paso en la posición correcta con el botón **+** del conector; el editor mantiene el recorrido consistente.

<Frame caption="El menú de acciones del paso abre la opción Eliminar, con un diálogo de confirmación antes de quitarlo.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/workflows/quitar-paso.gif?s=86ff4f1b8c2f96a41f08eb970fb12d92" alt="Quitar un paso desde el menú de acciones" width="1066" height="600" data-path="images/workflows/quitar-paso.gif" />
</Frame>

<Warning>
  Quitar o agregar pasos es un **cambio estructural**: solo afecta a los documentos nuevos. Los documentos que ya están recorriendo el flujo conservan la versión con la que entraron. Ver [No-retroactividad](/flujos/publicar-flujo#no-retroactividad).
</Warning>

## Campos personalizados

En el editor tienes una pestaña de **campos personalizados**, donde defines los campos propios de tu empresa (*Área*, *Proyecto*, *Ciudad*…) y sus valores. Estos campos alimentan la clasificación y también sirven para filtrar documentos. Ver la guía completa en [Campos personalizados](/flujos/campos-personalizados).

## Permisos para editar

Editar flujos toca pasos que tienen efectos reales (registrar en el ERP, generar cuentas por pagar), así que está protegido por un permiso dedicado:

* El permiso **Editar flujos de trabajo** habilita agregar, quitar y publicar pasos, y activar agentes.
* Un administrador lo asigna a los roles que corresponda desde **Espacio de trabajo → Roles y permisos**.
* Sin ese permiso, puedes ver el flujo pero no modificarlo.

<Frame caption="El permiso «Editar flujos de trabajo», dentro del grupo Flujos de trabajo al editar un rol.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/workflows/permiso-editar-flujos.png?fit=max&auto=format&n=ciZIXW9SReB7Uh7w&q=85&s=537c16b0796762335052888486eacc2d" alt="Permiso Editar flujos de trabajo en la edición de un rol" width="1280" height="720" data-path="images/workflows/permiso-editar-flujos.png" />
</Frame>

## Siguiente paso

Cuando termines de armar el flujo, publícalo para que empiece a aplicar a los documentos nuevos.

<Card title="Publicar un flujo" icon="rocket" href="/flujos/publicar-flujo">
  Borrador, publicación, descarte y las reglas que debe cumplir el flujo antes de publicarse.
</Card>
