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

# Primeros pasos con Flowker

> Descubre cómo Flowker automatiza operaciones financieras a través de escenarios reales — desde orquestación de pagos hasta prevención de fraude.

Las operaciones financieras involucran múltiples pasos, aprobaciones y verificaciones externas. Gestionarlas manualmente genera errores, retrasos y brechas de cumplimiento. Flowker te permite definir estos procesos una vez como workflows y ejecutarlos de forma consistente — con trazabilidad completa y visibilidad en tiempo real.

Esta página te muestra lo que Flowker puede hacer por tu negocio. Para instrucciones de configuración técnica, consulta el [Quickstart técnico](/es/reference/flowker/flowker-api-quick-start).

## Cómo funciona Flowker

***

Comienza explorando las integraciones disponibles, conectándolas a tu entorno, define un workflow que modele tu proceso de negocio y luego ejécutalo. Cada ejecución queda registrada, es auditable y recuperable.

Aquí está el flujo de alto nivel:

<Steps>
  <Step title="Explora el catálogo">
    Consulta los providers, executors y triggers integrados disponibles para ver qué integraciones están disponibles de serie.
  </Step>

  <Step title="Configura tus executors">
    Conecta Flowker a los servicios externos que tus workflows necesitan — motores anti-fraude, procesadores de pago, proveedores KYC, servicios de notificación — creando configuraciones de executor con credenciales y endpoints.
  </Step>

  <Step title="Define tus workflows">
    Modela tu proceso de negocio como un workflow: define los pasos (nodes), el orden de ejecución (edges) y las condiciones que controlan las bifurcaciones.
  </Step>

  <Step title="Ejecuta y monitorea">
    Activa workflows vía API o webhook. Monitorea cada ejecución en tiempo real y consulta los resultados cuando finalice.
  </Step>
</Steps>

## Qué puedes automatizar

***

Flowker está diseñado para procesos financieros de múltiples pasos que requieren confiabilidad, trazabilidad e integración con servicios externos. Estos son los escenarios más comunes.

### Orquestación de pagos

**El desafío:** Un pago involucra múltiples pasos — validación, enrutamiento al proveedor correcto, confirmación y notificación. Cuando se manejan manualmente o con integraciones dispersas, las fallas pasan desapercibidas y la conciliación se vuelve dolorosa.

**Cómo lo resuelve Flowker:** Define un workflow que coordine todo el ciclo de vida del pago:

1. **Trigger** — Llega una nueva solicitud de pago vía API o webhook.
2. **Validar** — Verificar que los datos del pago estén completos y la cuenta tenga saldo suficiente.
3. **Enrutar** — Seleccionar el proveedor de pago adecuado según monto, moneda o rail (Pix, TED, SWIFT).
4. **Confirmar** — Llamar al proveedor y esperar confirmación.
5. **Notificar** — Enviar un evento de confirmación al cliente y actualizar el ledger.

Si algún paso falla, el workflow maneja reintentos automáticamente. Cada paso queda registrado para conciliación y auditoría.

### Validación anti-fraude

**El desafío:** Las verificaciones de fraude deben ocurrir antes de procesar una transacción — pero involucran servicios externos, lógica de scoring y diferentes umbrales según el tipo de transacción. Codificar esta lógica a mano genera pesadillas de mantenimiento.

**Cómo lo resuelve Flowker:** Define un workflow previo a la transacción que ejecute las verificaciones de fraude antes de que algo llegue al ledger:

1. **Trigger** — Se envía una nueva transacción.
2. **Enriquecer** — Recopilar historial del cliente, datos del dispositivo y geolocalización.
3. **Scoring** — Llamar a uno o más proveedores de detección de fraude y recopilar puntuaciones de riesgo.
4. **Decidir** — Aplicar reglas: si el score supera el umbral, bloquear; si es limítrofe, marcar para revisión; si es bajo, aprobar.
5. **Actuar** — Proceder con la transacción o notificar al equipo de cumplimiento.

Todas las decisiones son trazables. Puedes ajustar umbrales y agregar nuevos proveedores sin cambiar la lógica central.

### Onboarding de clientes

**El desafío:** El onboarding requiere verificación de identidad, validación de documentos, checks AML/KYC y creación de cuenta. Estos pasos involucran múltiples proveedores externos y requisitos regulatorios que varían por jurisdicción.

**Cómo lo resuelve Flowker:** Define un workflow de onboarding que automatice todo el proceso:

1. **Trigger** — Llega un nuevo registro de cliente.
2. **Verificar identidad** — Llamar a un proveedor KYC para validar documentos e identidad.
3. **Verificar cumplimiento** — Ejecutar screening AML contra listas de sanciones y bases PEP.
4. **Evaluar riesgo** — Aplicar reglas internas de riesgo basadas en perfil, jurisdicción e historial.
5. **Crear cuenta** — Si todas las verificaciones pasan, crear la cuenta del cliente.
6. **Notificar** — Enviar email de bienvenida o notificar al gerente de relación si se necesita revisión manual.

El resultado de cada paso determina la siguiente acción. Si una verificación falla, el workflow se detiene y crea un registro de auditoría explicando el motivo.

### Workflows de aprobación manual

**El desafío:** Algunas operaciones — transferencias de alto valor, cambios de límite, cierres de cuenta — requieren aprobación humana. Pero construir flujos de aprobación con notificaciones por email, timeouts y rutas de escalamiento es complejo y propenso a errores.

**Cómo lo resuelve Flowker:** Define un workflow que llama a un servicio de aprobación externo mediante un executor:

1. **Trigger** — Se envía una solicitud de transferencia de alto valor.
2. **Evaluar** — Verificar monto, perfil de riesgo y políticas internas.
3. **Solicitar aprobación** — Llamar a un servicio de aprobación externo (gerente, oficial de cumplimiento) a través de un nodo executor.
4. **Decidir** — Un nodo condicional evalúa la respuesta de aprobación.
5. **Actuar** — Si se aprueba, proceder con la transferencia. Si se rechaza, cancelar y notificar.

Puedes definir aprobaciones de múltiples niveles encadenando nodos executor que llamen a tu servicio de aprobación en cada nivel.

## Capacidades clave

***

* **Validación pre-ledger** — Todas las verificaciones se ejecutan antes de cualquier registro en el ledger.
* **Trazabilidad completa** — Cada paso genera logs detallados que se pueden consultar, revisar y exportar.
* **Integraciones con providers** — Conecta con motores de fraude, proveedores KYC, procesadores de pago y cualquier servicio HTTP.
* **Bifurcación condicional** — Enruta la ejecución según resultados, montos, scores de riesgo o cualquier campo.
* **Ejecución idempotente** — Idempotencia integrada que garantiza reintentos seguros sin procesamiento duplicado.
* **Monitoreo en tiempo real** — Consulta el estado de ejecución y resultados de cada paso mientras los workflows se ejecutan.

<Note>
  Cuando la autenticación por API Key está habilitada (`API_KEY_ENABLED=true`), las solicitudes a la API de Flowker deben incluir el header `X-API-Key: <your-api-key>`, con la clave provisionada mediante la variable de entorno `API_KEY` durante el despliegue. Alternativamente, Flowker puede autenticar las solicitudes a través de Access Manager. Las credenciales específicas de proveedores (para servicios externos) se gestionan a través de [configuraciones de provider](/es/reference/flowker/list-provider-configurations). Consulta el [Quickstart técnico](/es/reference/flowker/flowker-api-quick-start) para el flujo completo de bootstrapping.
</Note>

## Próximos pasos

***

<CardGroup cols={2}>
  <Card title="Conceptos fundamentales" icon="diagram-project" href="/es/flowker/flowker-concepts">
    Comprende los bloques esenciales de Flowker: workflows, nodes, edges, providers y executors.
  </Card>

  <Card title="Quickstart técnico" icon="terminal" href="/es/reference/flowker/flowker-api-quick-start">
    Configura tu primer workflow paso a paso con instrucciones técnicas detalladas.
  </Card>

  <Card title="¿Qué es Flowker?" icon="circle-question" href="/es/flowker/what-is-flowker">
    Conoce la visión, arquitectura y diferenciadores de la plataforma de orquestación.
  </Card>

  <Card title="Referencia API" icon="code" href="/es/reference/flowker/create-workflow">
    Explora los endpoints disponibles para crear, ejecutar y gestionar workflows.
  </Card>
</CardGroup>
