> ## 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.
# Publicar un flujo
> Cómo pasar de borrador a publicado, qué le pasa a los documentos que ya están en curso y por qué a veces el flujo no te deja publicar
Mientras editas un flujo, tus cambios viven en un **borrador**. Nada de lo que modificas afecta a tus documentos hasta que **publicas**. Esta separación te deja experimentar tranquilo: puedes armar, ajustar y revisar sin miedo a romper la operación en vivo.
## Borrador, publicado y descartar
Tus cambios sin publicar. Solo tú (y quien edite el flujo) los ve. Los documentos siguen usando la última versión publicada.
Promueve el borrador a la versión activa. A partir de ese momento, los documentos **nuevos** entran por este recorrido.
Revierte el borrador y vuelve a la última versión publicada. Útil cuando quieres deshacer cambios que aún no publicaste.
**Todo cambio exige publicar.** Sin importar si es agregar un paso, cambiar responsables o afinar una política, nada surte efecto mientras siga en borrador: publicar es siempre el paso que lo activa. Lo que cambia entre un tipo de cambio y otro es **a qué documentos** aplica una vez publicado (a los nuevos, o también a los que ya están en curso). Eso lo decide la [no-retroactividad](#no-retroactividad).
Asegúrate de que ningún paso quede incompleto. El editor marca los pasos que necesitan atención.
Payana valida el flujo. Si algo impide publicar, te lo muestra con un enlace directo al paso que hay que corregir.
Si tu borrador cambia la forma del flujo (agregaste o quitaste pasos), aparece un aviso de **no-retroactividad** antes de confirmar. Léelo abajo.
> 📸 **Imagen sugerida** · `workflows/publish-issues.png`
> Captura del encabezado del editor mostrando la lista de "problemas de publicación" con enlaces para saltar a cada paso a corregir.
## No-retroactividad
Esta es la regla más importante al publicar, y conviene entenderla bien:
**Los cambios de forma del flujo solo aplican a los documentos nuevos.** Los documentos que ya están recorriendo el flujo conservan la versión con la que entraron, hasta que terminen.
¿Por qué? Porque cambiar el recorrido de un documento a mitad de camino sería impredecible y riesgoso. Imagina un documento que ya pasó por aprobación: si de repente le insertas una aprobación nueva, ¿debería devolverse? Para evitar esas ambigüedades, cada documento se "congela" en la versión del flujo con la que entró.
Qué **sí** se aplica de inmediato a documentos en curso, y qué **no**:
| Tipo de cambio | ¿Afecta documentos en curso? |
| ------------------------------------------ | ------------------------------------------------------------ |
| Agregar o quitar un paso | No — solo documentos nuevos |
| Cambiar el orden de los pasos | No — solo documentos nuevos |
| Cambiar los responsables de un paso | Sí — se re-sincroniza en vivo |
| Prender/apagar un agente o cambiar su modo | Sí — es un ajuste de configuración, no estructural |
| Editar una política | Sí — la política se lee en el momento en que el agente actúa |
Prender un agente o afinar su política **no** es un cambio estructural. Puedes activar el agente de aprobación de un paso existente y empezar a verlo trabajar sobre los documentos que ya están en ese paso, sin re-crear el flujo.
## Reglas del flujo
Un flujo debe tener sentido de negocio antes de poder publicarse. Payana valida estas reglas y bloquea la publicación (con un mensaje claro) si alguna no se cumple:
Un documento no puede causarse dos veces (sería un doble registro en tu ERP). El flujo admite un único paso de **Registro en ERP**.
Igual que la causación: un único paso de **Generar CxP** por flujo.
Un flujo termina registrando en el ERP **o** generando una cuenta por pagar, no ambas. Si ya tienes uno, el editor desactiva el otro.
No tiene sentido causar un documento que todavía no se aprobó. El orden aprobación → causación es obligatorio.
Todo recorrido debe terminar en un desenlace válido (causado, cuenta por pagar generada, en la papelera…). No puede quedar un camino "abierto" sin final.
Estas reglas se validan del lado del servidor, no solo en tu navegador. Eso garantiza que ningún flujo mal formado llegue a producir efectos reales en tu ERP, sin importar cómo se haya editado.
## Preguntas frecuentes
Sí: edita el flujo para deshacer el cambio y vuelve a publicar. Si el cambio aún estaba en borrador, usa **Descartar** para revertir a la última versión publicada.
Depende del cambio. Los cambios de responsables, agentes y políticas sí se aplican a documentos en curso; agregar o quitar pasos no. Ver la tabla de [No-retroactividad](#no-retroactividad).
Significa que hay pasos incompletos o que el flujo no cumple alguna [regla del flujo](#reglas-del-flujo). El editor lista cada problema con un enlace para saltar al paso correspondiente.