Manual oficial de usuario — SGC v2
Este manual describe la aplicación de facturación formada por frontnew y
backnew. Está dirigido al usuario final, al administrador funcional y al
personal que capacita o da soporte.
Cómo usar este manual
La documentación está dividida por responsabilidad:
- Conceptos generales, acceso y caja
- Operación: ventas, cartera, compras, órdenes e inventario
- Catálogos y configuración
- Reportes, estados, permisos y solución de problemas
- Módulos verticales: qué son y cómo se activan
- Módulo Carnicería: básculas, mermas, transformaciones y liquidaciones PV
- Módulo Planta de beneficio: lotes, empaque, despachos y liquidación
- Informe de validación y límites de la revisión
Los nombres de menús, campos y botones corresponden a la interfaz actual. Si una opción no aparece, normalmente el usuario no tiene el permiso requerido o no existe una configuración activa que permita la operación.
Alcance comprobado
El manual fue construido contrastando:
- las pantallas y controles de
frontnew/src/app; - el menú y sus restricciones por permiso;
- las rutas, validaciones y servicios de dominio de
backnew; - las migraciones y settings vigentes;
- los contratos API y las pruebas automatizadas de ambos proyectos.
Los capítulos 1–4 describen el núcleo, disponible para todas las empresas. Los capítulos 6 y 7 describen los módulos verticales (Carnicería y Planta), que solo aparecen en empresas donde el módulo fue activado (capítulo 5).
Mapa rápido
| Necesidad | Menú o acceso |
|---|---|
| Vender | Ventas → tipo de documento activo |
| Consultar una factura | Ventas → Facturas |
| Registrar un recaudo | Ventas → Recibos o Registrar pago desde una factura |
| Preparar una precuenta | Órdenes → Nueva orden |
| Registrar una compra | Compras → tipo de documento activo |
| Pagar a un proveedor | Compras → Egresos |
| Registrar entrada o salida de efectivo | Caja → Efectivo |
| Registrar un gasto | Caja → Gastos |
| Abrir/cerrar caja | Panel superior o Inicio |
| Consultar existencias | Inventario → Stock |
| Ajustar inventario por conteo | Inventario → Cierres de inventario |
| Descargar informes | Reportes → Reportes PDF / Excel |
| Corregir envíos electrónicos | Reportes → Electrónica |
| Administrar maestros | Catálogo y Configuración |
| Vender pesando con báscula | Módulo Carnicería → escáner del POS (cap. 6) |
| Ver lo pesado y no facturado | Carnicería → Tiquetes sin facturar |
| Convertir un producto en otro (desposte de mostrador) | Carnicería → Transformaciones |
| Recibir mercancía liquidada por la planta | Carnicería → Liquidaciones PV |
| Operar la planta (lotes → empaque → despacho) | Grupos Planta/Empaque/Despacho/Liquidación (cap. 7) |
Convenciones
- Activo/inactivo: los registros inactivos se conservan para la historia, pero no se ofrecen para operaciones nuevas.
- Anulado: la operación queda visible para auditoría y sus efectos contables u operativos se revierten según el módulo; no se elimina.
- Sucursal: una operación siempre se asocia a una sede de un tercero, no únicamente al tercero.
- POS: venta de contado en punto de venta.
- FV/crédito: factura con vencimiento y saldo por cobrar.
- Nota crédito/débito: documento que disminuye/aumenta un documento origen.
- Caja abierta: sesión personal necesaria para operaciones que mueven efectivo.
- Tercero: cliente, proveedor o ambos.
- Módulo: funcionalidad vertical activada por empresa; ver capítulo 5.
Principios de seguridad y auditoría
- Cada empresa accede por su dirección (tenant) y sus datos están aislados.
- La sesión y los permisos pertenecen a esa empresa; una sesión de otra empresa no es válida.
- El menú oculta opciones sin permiso, pero el servidor también valida cada acción.
- Las creaciones sensibles son idempotentes: si una respuesta tarda, no se debe hacer clic repetidamente; el sistema evita duplicar la misma solicitud.
- Los documentos numerados no se borran. Se anulan o se corrigen mediante notas.
- Cambios externos como DIAN, impresión y carga en nube pueden ejecutarse después de guardar. Que fallen no significa que el documento interno no exista.