Guia: Como Configurar un Pipeline de Originacion

Audiencia

Esta guia esta dirigida a tenant admins y platform admins que necesitan configurar el pipeline de originacion de un producto de credito en ImagLend.

Prerequisitos

Tener acceso al panel admin (dash.{tenant}.reimaginetech.io)
Tener rol tenant_admin o platform_admin
Al menos un producto de credito creado (en estado draft o published)
Proveedores configurados para los pasos que los requieran (SMS, bureau, firma)

Conceptos Clave

Que es un Pipeline

Un pipeline es la secuencia de pasos que un solicitante debe completar para obtener un credito. Cada producto de credito tiene su propio pipeline configurable.

Fases del Pipeline

Fase	Quien ejecuta	Descripcion
`public`	Usuario final	Pasos que el solicitante completa en el wizard publico
`backend`	Sistema o analista	Pasos automaticos o de revision interna
`post_approval`	Usuario (notificado)	Pasos que se ejecutan despues de aprobar el credito
`post_signature`	Sistema	Acciones automaticas post-firma

Tipos de Paso Disponibles

Tipo	Fase tipica	Requiere proveedor	Descripcion
`landing`	public	No	Landing page con simulador de credito
`user_registration`	public	Keycloak	Crea usuario en el realm del tenant
`legal_consent`	public	No	Muestra documentos legales y registra aceptacion
`contact_verification`	public	SMS/Email	Valida telefono y/o email con OTP
`form`	public	No	Formulario configurable con secciones
`compliance_check`	backend	Bureau/AML	Consulta score crediticio y listas
`manual_review`	backend	No	Cola de revision para analistas
`identity_validation`	post_approval	ImagFlow	Validacion biometrica via flujo
`document_signature`	post_approval	ImagSign	Firma electronica de documentos
`disbursement`	post_signature	Banco	Transferencia de fondos

Paso a Paso: Configurar un Pipeline

1. Acceder al Producto

Ir a Creditos > Productos en el panel admin
Seleccionar el producto a configurar
Si el producto esta publicado, crear un nuevo draft (el pipeline se edita en el draft)
Ir a la pestana Pipeline

2. Agregar Pasos

El editor de pipeline muestra los pasos como tarjetas arrastrables. Para agregar un paso:

Click en + Agregar Paso
Seleccionar el tipo de paso
Configurar las opciones del paso (ver seccion de configuracion por tipo)
El paso se agrega al final — arrastrar para reordenar

3. Configurar Cada Paso

Landing

json

{
  "type": "landing",
  "config": {
    "show_simulator": true,
    "show_requirements": true,
    "show_faq": true,
    "custom_css": null
  }
}

show_simulator: Muestra el simulador de credito (recomendado: siempre true)
show_requirements: Muestra lista de requisitos del producto
show_faq: Muestra preguntas frecuentes configurables

Registro de Usuario

json

{
  "type": "user_registration",
  "config": {
    "create_keycloak_user": true,
    "require_phone": true,
    "require_email": true,
    "password_strategy": "temporary"
  }
}

password_strategy: "temporary" (genera password temporal) o "magic_link" (login sin password)
Despues de este paso, el usuario queda logueado y puede volver a ver su solicitud

Aceptacion Legal

json

{
  "type": "legal_consent",
  "config": {
    "documents": [
      { "code": "privacy_policy", "version": "2.0", "required": true },
      { "code": "terms_conditions", "version": "3.1", "required": true },
      { "code": "data_treatment", "version": "1.0", "required": false }
    ]
  }
}

Cada documento tiene un code unico y una version inmutable
Los documentos required: true deben ser aceptados para continuar
Se registra evidencia completa: IP, fingerprint, timestamp, hash del documento

Validacion de Contacto

json

{
  "type": "contact_verification",
  "config": {
    "channels": ["sms", "email"],
    "check_uniqueness": true,
    "allow_whatsapp": true,
    "otp_ttl_seconds": 300,
    "max_attempts": 3
  }
}

check_uniqueness: Verifica que el telefono/email no este registrado por otro usuario
allow_whatsapp: Permite enviar OTP por WhatsApp ademas de SMS
Requiere que imagy-notifications tenga el canal SMS configurado para el tenant

Formulario

json

{
  "type": "form",
  "config": {
    "sections": ["personal", "financial", "employment"],
    "fields_by_section": {
      "personal": ["full_name", "birth_date", "gender", "address"],
      "financial": ["monthly_income", "monthly_expenses", "other_debts"],
      "employment": ["activity_type", "company_name", "time_in_job"]
    },
    "validations": {
      "birth_date": { "min_age": 18, "max_age": 70 },
      "monthly_income": { "min": 0 }
    }
  }
}

Las secciones y campos son completamente configurables
Las validaciones se aplican tanto en frontend como en backend

Consulta de Bureau/AML

json

{
  "type": "compliance_check",
  "config": {
    "providers": ["datacredito_co"],
    "check_types": ["credit_score", "aml_lists"],
    "auto_reject_if": {
      "score_below": 400,
      "in_aml_list": true
    }
  }
}

Se ejecuta automaticamente (el usuario no ve este paso)
Si se cumple alguna condicion de auto_reject_if, la solicitud se rechaza automaticamente
Requiere que el proveedor de bureau este configurado en ImagFlow

Revision Manual

json

{
  "type": "manual_review",
  "config": {
    "auto_approve": {
      "enabled": true,
      "conditions": {
        "score_above": 700,
        "amount_below": 1000000,
        "no_aml_flags": true
      }
    },
    "assignment_strategy": "round_robin",
    "sla_hours": 24
  }
}

auto_approve.enabled: Si es true, solicitudes que cumplan TODAS las condiciones se aprueban sin analista
assignment_strategy: "round_robin" (distribuye equitativamente) o "least_loaded" (al analista con menos carga)
sla_hours: Tiempo maximo para que un analista tome decision

Validacion de Identidad

json

{
  "type": "identity_validation",
  "config": {
    "flow_id": "uuid-del-flujo",
    "trigger": "after_approval",
    "skip_if_validated_within_days": 30
  }
}

Se ejecuta DESPUES de la aprobacion (ahorra costos de proveedor biometrico)
flow_id: ID del flujo de ImagFlow que ejecuta la validacion (liveness, OCR, etc.)
skip_if_validated_within_days: Si el usuario ya fue validado recientemente, se salta

Firma de Documentos

json

{
  "type": "document_signature",
  "config": {
    "documents": ["credit_contract", "pagare"],
    "signature_type": "electronic_otp",
    "provider_code": "electronic-generic",
    "multi_signer": false
  }
}

signature_type: "electronic_otp" (firma con codigo OTP) o "digital" (certificado digital)
multi_signer: Si es true, permite agregar codeudores como firmantes adicionales
Requiere que ImagSign tenga el proveedor configurado

Desembolso

json

{
  "type": "disbursement",
  "config": {
    "method": "bank_transfer",
    "delay_hours": 0,
    "require_bank_details": true
  }
}

method: "bank_transfer", "mobile_wallet", "check"
delay_hours: Horas de espera antes de ejecutar el desembolso (0 = inmediato)

4. Validar y Publicar

Click en Validar Pipeline — el sistema verifica:
- Al menos un paso configurado
- landing es el primer paso
- disbursement es el ultimo paso
- Proveedores requeridos estan activos
- Orden logico respetado (registro antes de consent, firma despues de aprobacion)
Si la validacion pasa, click en Publicar Version
La version anterior se archiva automaticamente
Las solicitudes en curso siguen usando la version anterior

Ejemplos de Pipelines por Tipo de Producto

Microcredito Express (4-6 pasos)

Para montos bajos con aprobacion rapida:

#	Paso	Notas
1	Landing	Simulador simple
2	Registro	Solo email y telefono
3	Consent	Terminos basicos
4	Contacto	Solo SMS
5	Formulario	Solo datos basicos
6	Desembolso	Inmediato si auto-aprobado

Sin bureau, sin analista, sin validacion de identidad. Auto-aprobacion por monto.

Credito de Consumo (8-10 pasos)

Flujo completo con todas las validaciones:

#	Paso	Notas
1	Landing	Simulador completo
2	Registro	Email + telefono + documento
3	Consent	Privacy + terminos + tratamiento datos
4	Contacto	SMS + email
5	Formulario	Personal + financiero + laboral + referencias
6	Bureau/AML	Score + listas
7	Revision	Auto-aprobacion si score > 700 y monto < 1M
8	Identidad	Biometria post-aprobacion
9	Firma	Contrato + pagare
10	Desembolso	Transferencia bancaria

Credito con Codeudor (multi-firmante)

Igual que consumo pero con firma multi-firmante:

#	Paso	Notas
9	Firma	`multi_signer: true`, deudor + codeudor, estrategia secuencial

Restricciones y Reglas

Regla	Descripcion
Landing siempre primero	No se puede mover de la posicion 1
Desembolso siempre ultimo	No se puede mover de la ultima posicion
Registro antes de consent	El consent necesita un usuario creado
Firma despues de aprobacion	Solo se firma si el credito fue aprobado
Identidad despues de aprobacion	Optimizacion de costos
Minimo 1 paso	Un pipeline vacio no es valido
Pasos opcionales	Se pueden marcar como `required: false` para saltarlos condicionalmente

Troubleshooting

Problema	Causa	Solucion
"Provider inactive" al validar	El proveedor de SMS/bureau/firma no esta activo	Activar el proveedor en Configuracion > Proveedores
"Flow not found" en identity_validation	El `flow_id` no existe o no esta publicado	Verificar que el flujo existe en ImagFlow y tiene version publicada
OTP no llega al usuario	Canal SMS no configurado para el tenant	Configurar canal en imagy-notifications
Auto-aprobacion no funciona	Condiciones no se cumplen	Verificar que `auto_approve.enabled: true` y revisar condiciones
Solicitud se queda en "pending"	Analista no asignado	Verificar que hay analistas con rol `operator` y que `assignment_strategy` esta configurado

Documentos Relacionados

Originacion Pipeline (tecnico) — Detalle tecnico completo
Productos — Configuracion de productos de credito
ImagFlow Overview — Motor de flujos para validacion
ImagSign Overview — Firma digital
Notifications Overview — Canales de notificacion

Guia: Como Configurar un Pipeline de Originacion ​

Audiencia ​

Prerequisitos ​

Conceptos Clave ​

Que es un Pipeline ​

Fases del Pipeline ​

Tipos de Paso Disponibles ​

Paso a Paso: Configurar un Pipeline ​

1. Acceder al Producto ​

2. Agregar Pasos ​

3. Configurar Cada Paso ​

Landing ​

Registro de Usuario ​

Aceptacion Legal ​

Validacion de Contacto ​

Formulario ​

Consulta de Bureau/AML ​

Revision Manual ​

Validacion de Identidad ​

Firma de Documentos ​

Desembolso ​

4. Validar y Publicar ​

Ejemplos de Pipelines por Tipo de Producto ​

Microcredito Express (4-6 pasos) ​

Credito de Consumo (8-10 pasos) ​

Credito con Codeudor (multi-firmante) ​

Restricciones y Reglas ​

Troubleshooting ​

Documentos Relacionados ​

Guia: Como Configurar un Pipeline de Originacion

Audiencia

Prerequisitos

Conceptos Clave

Que es un Pipeline

Fases del Pipeline

Tipos de Paso Disponibles

Paso a Paso: Configurar un Pipeline

1. Acceder al Producto

2. Agregar Pasos

3. Configurar Cada Paso

Landing

Registro de Usuario

Aceptacion Legal

Validacion de Contacto

Formulario

Consulta de Bureau/AML

Revision Manual

Validacion de Identidad

Firma de Documentos

Desembolso

4. Validar y Publicar

Ejemplos de Pipelines por Tipo de Producto

Microcredito Express (4-6 pasos)

Credito de Consumo (8-10 pasos)

Credito con Codeudor (multi-firmante)

Restricciones y Reglas

Troubleshooting

Documentos Relacionados