FIVO
Construimos FIVO de extremo a extremo: una plataforma de crédito y factoraje agrícola para productores mexicanos. El núcleo es un motor de validación paralela —resolvimos que las tres áreas (Legal, Mesa de Control y Documentos) revisen una solicitud al mismo tiempo, cada una con su checklist configurable y su SLA, y que el crédito avance al comité solo cuando las tres aprueban; donde antes había una fila de semanas, ahora hay un proceso simultáneo. Lo importante no era el formulario, era el flujo entre áreas. Encima montamos el factoraje del mismo día: adelantamos hasta el 90% del valor de una entrega de cosecha pendiente de pago, y para que ese número sea real lo conectamos al sistema del comprador vía OAuth2, webhooks firmados y reconciliación contra sus recepciones. La prueba está en la escala: una sola API centralizada de 150 route handlers alimenta cuatro frontends (web pública, dashboard del productor, backoffice por rol y el portal Collect para comercializadoras), sobre 51 modelos Prisma en PostgreSQL, con un onboarding de 11 pasos y 170+ campos que el cliente edita sin tocar código. Está en Next.js, Prisma e IBM Carbon, con CI/CD a staging y producción.
Categoría
Fintech
Stack
Next.js, TypeScript, PostgreSQL
Status
En desarrollo
El problema
El crédito agrícola en México se atora porque el dinero llega tarde. Una solicitud pasa por Legal, luego por Mesa de Control, luego por Comité —en serie— y el productor espera semanas mientras su cosecha ya está en el camión. Y el factoraje contra entregas vive en otro mundo: la comercializadora tiene los datos de recepción en su propio sistema y FIVO los necesita para adelantar. El problema no está en cada sistema; está entre ellos.
Lo que construimos
- —Motor de validación paralela: al enviar una solicitud se abren las 3 áreas (Legal, Mesa de Control, Documentos) a la vez, cada una con su checklist configurable, SLA en horas y ciclo de observaciones; la solicitud avanza a Comité solo cuando las 3 quedan APROBADA.
- —Wizard de onboarding no-code y versionado: 11 pasos / 170+ campos tipados (RFC, CURP, CLABE, etc.) que el área Admin edita sin tocar código; los campos se mapean a columnas de la solicitud.
- —Máquina de estados de crédito de 16 estados (BORRADOR → ENVIADA → revisión por área → EN_COMITE → FIRMADA → ACTIVA → LIQUIDADA) con comité que vota Aprobado/Condicionado/Rechazado/Diferido.
- —Factoraje (adelantos) el mismo día: hasta 90% del valor de una entrega de cosecha pendiente de pago, con tasas, comisión de apertura, mora y score de elegibilidad parametrizados en código de negocio.
- —Collect, portal para las comercializadoras: registran entregas, ven productores vinculados, configuran su integración API y resuelven discrepancias —10 páginas, 13 hooks, scoping estricto por comercializadora.
- —Integración OAuth2 con APIs de comercializadoras (verificar productor, capacidad de entrega, historial, registrar adelanto, deducción) más webhook de pagos firmado.
- —Reconciliación FIVO ↔ comercializadora: detecta discrepancias de datos, registra cada sincronización (status HTTP, request/response) y permite elegir el origen correcto.
- —Backoffice por rol: bandejas de Legal, Mesa de Control y Comité, expedientes, dispersiones, cobranza, reportes de cartera/tiempos y administración de roles, permisos y catálogos.
- —CMS propio en PayloadCMS para el sitio público (6 colecciones + 11 globals) con seed de contenido y clientes tipados para migrar el copy hardcoded.
- —Mapeo documentado de la base de trazabilidad real del comprador hacia el modelo Entrega de FIVO, con manejo de fechas como texto, llaves foráneas en texto y estatus inconsistentes.
Resultados
150 route handlers (API centralizada) que alimentan 4 frontends
106 páginas de aplicación construidas
51 modelos y 35 enums en el schema Prisma
Wizard de 11 pasos con 170+ campos configurables
Sistema de validación con 3 áreas en paralelo y 16 estados de solicitud
Portal Collect: 10 páginas + 13 hooks React Query
Integración con 6 endpoints OAuth2 del comprador + webhook firmado
Rango de crédito $50K–$50M MXN; adelanto de factoraje hasta 90% del valor de entrega
Mapeo de trazabilidad del comprador: 195,514 recepciones, 1,279 productores, 2,860 huertos, 16 sedes