Inicio rápido

AgroFlow es un sistema ERP orientado a operaciones agroindustriales. Integra Configuración, Finanzas, Inventario, Compras y Ventas bajo una misma base de datos, con trazabilidad completa, asientos contables automáticos y correlativos únicos por documento.

Stack técnico

Requisitos del cliente

Módulos del sistema

AgroFlow cuenta con 6 módulos implementados que suman más de 50 submódulos operativos.

Submódulos por área

Flujos de negocio

AgroFlow prioriza flujos integrados en un solo paso cuando la operación lo permite, para reducir carga administrativa y evitar documentos huérfanos.

Flujo de compras

• Recepción + Factura en un solo paso: al recibir mercadería se genera simultáneamente la factura del proveedor, actualizando existencias y generando la CxP automáticamente.
• Devoluciones descuentan existencias y crean nota de débito contra el proveedor.
• Asiento contable automático al cerrar la recepción/factura.

Flujo de ventas

• Despachos parciales: una orden de venta puede entregarse en múltiples despachos con trazabilidad de saldos pendientes.
• Trazabilidad por lote desde la recepción hasta el despacho.
• Nota de crédito reversa la factura (total o parcial) y ajusta CxC.

Flujo financiero

• Asientos: generados automáticamente por transacciones de compras, ventas, ajustes de inventario y conciliaciones; pueden también crearse manualmente.
• Tasa de cambio: se consulta al crear cada asiento. Si la moneda de la transacción difiere de la moneda base, el sistema hace auto-fetch y alerta si la tasa no está vigente.
• Normas de reparto distribuyen costos/gastos entre múltiples centros de costo según reglas definidas.
• Presupuesto vs real compara el ejercicio presupuestario con el movimiento contable real.

Reportes

El sistema incluye 18 reportes imprimibles y exportables, organizados por módulo. Todos siguen el estándar visual del Plan de Cuentas (encabezado limpio, filtros superiores, tabla con totales).

Acceso y seguridad

Inicio de sesión

1. Acceda a http://localhost/AgroFlow/login.html (o la URL pública del servidor).
2. Ingrese el correo y contraseña asignados por su administrador.
3. Marque "Mantener sesión" si desea permanecer autenticado por 30 días.

Protecciones activas

• Rate limiting: tras 5 intentos fallidos desde la misma IP o correo en 15 minutos, el acceso se bloquea temporalmente.
• Auditoría: todo intento (exitoso o fallido) se registra en tbl_seg_login_intentos y tbl_log_auditoria con IP, email y timestamp.
• Cookie de sesión: httponly + samesite=Lax; la cookie "remember" extiende la sesión a 30 días.
• Cierre automático si se detecta uso desde file:// o sin el protocolo correcto.

Roles

El control de acceso es por rol (RBAC). Los roles se gestionan desde Configuración → Roles y permisos. Cada rol define qué módulos y qué acciones puede ejecutar el usuario.

Navegación

La aplicación se organiza en tres áreas:

• Barra superior: selector de módulo, usuario activo y cierre de sesión.
• Menú lateral: submódulos del módulo activo.
• Área de trabajo: listados con CrudEngine (paginación, búsqueda, modales SweetAlert2) y formularios.

URL de cada vista

Toda vista se alcanza por /AgroFlow/index.php?mod=<módulo>&view=<submódulo>. Ejemplos:

Convenciones del sistema

Correlativos automáticos

Todo documento transaccional recibe un correlativo único generado por el sistema a partir de la serie configurada:

Estados y eliminación lógica

Ningún registro se borra físicamente. Se marca estado = 0 (inactivo) y queda disponible para auditoría en tbl_log_auditoria.

Tablas y prefijos de BD

Tasa de cambio

Cada asiento en moneda distinta a la moneda base consulta automáticamente la tasa vigente. Si no hay tasa para la fecha del documento, el sistema alerta al usuario antes de guardar.

API & ruteo interno

AgroFlow usa un ruteador simple en index.php. Las peticiones AJAX se diferencian de las vistas por el parámetro action.

Vista (con layout)

Petición AJAX (sin layout, retorna JSON)

Catálogos genéricos

Para catálogos consumidos por múltiples módulos existe un endpoint genérico:

Formato de respuesta estándar

Integraciones previstas

• Correo SMTP — configurable desde cfg → correo para envío de documentos por email.
• Módulo de integraciones — punto único para conectar con sistemas externos (FEL, bancos, etc.).

Preguntas frecuentes

Ingresé mal mi contraseña varias veces y ahora no me deja entrar

Tras 5 intentos fallidos en 15 minutos, el acceso se bloquea temporalmente. Espere 15 minutos o pida a un administrador que revise tbl_seg_login_intentos.

¿Cómo creo un nuevo usuario?

Desde Configuración → Usuarios. Debe asignarle al menos un rol y asociar la empresa correspondiente.

¿Cómo genero un reporte?

Cada módulo tiene submódulo Reportes con los filtros correspondientes. Los reportes financieros están en /AgroFlow/reportes/ accedidos desde el menú Finanzas.

¿Puedo anular una factura emitida?

No se anulan directamente. Se emite una nota de crédito (total o parcial) desde Ventas → Notas de crédito, que reversa la factura y ajusta CxC y contabilidad.

¿Cómo manejo operaciones en dólares u otra moneda?

Configure la moneda en Configuración → Monedas y registre la tasa de cambio diaria en Finanzas → Tasa de cambio. El sistema la aplicará automáticamente a los documentos en esa moneda.

Cambié un archivo JS/CSS y no veo los cambios

El sistema usa filemtime() como cache-buster. Recargue con Ctrl+F5. Si el problema persiste, limpie la caché del navegador.

¿Cómo reporto un error?

Contacte al equipo de TI desde Contacto IT describiendo el módulo, los pasos para reproducirlo y una captura si es posible.