Módulos y feature flags¶
Aquí entiendes por qué un módulo aparece o no en el menú lateral y qué pedir cuando quieres activar uno. Los módulos se encienden por empresa mediante feature flags; el equipo de Agapanto los activa desde su panel de administración.
Permiso
No hay una pantalla para activar flags dentro de la aplicación. Para ver la configuración de tu empresa necesitas ACCESO_CONFIGURACION; para gestionar credenciales de integraciones, CONFIG_CREDENCIALES.
La regla: flag de la empresa + permiso del rol¶
Cada entrada del menú tiene dos candados. Aparece solo si la empresa tiene el flag del módulo y tu rol tiene el permiso. Tres entradas no tienen flag (Facturación, Formatos de impresión y Configuración): dependen solo del permiso.
Menú lateral (Panadería Los Manjares, rol Contador)
calculate
Facturaciónsin ACCESO_POS: oculto
inbox
Caja diariaDAILY_BOX + ACCESO_CAJA
account_balance
ContabilidadACCOUNTING + ACCESO_CONTABILIDAD
assessment
ReportesACCOUNTING_REPORTS + REPORTE_CONTABILIDAD
badge
Nómina electrónicasin flag PAYROLL: oculto
settings
Configuraciónsolo ACCESO_CONFIGURACION
Si tu rol no tiene el permiso de la página de inicio, la aplicación te lleva al primer módulo que sí puedas abrir; si no hay ninguno, a /app/sin-acceso.
Entradas del menú¶
| Entrada del menú | Flag | Permiso | Página |
|---|---|---|---|
| Facturación | — | ACCESO_POS |
/app/pos |
| Cartera | PORTFOLIO |
ACCESO_CARTERA |
/app/cartera |
| Caja diaria | DAILY_BOX |
ACCESO_CAJA |
/app/caja |
| Contabilidad | ACCOUNTING |
ACCESO_CONTABILIDAD |
/app/contabilidad |
| Activos fijos | FIXED_ASSETS |
ACCESO_ACTIVOS |
/app/activos |
| Productos Compuestos | RECIPES |
RECETAS |
/app/cocina |
| Inventario | INVENTORY |
ACCESO_INVENTARIO |
/app/inventario |
| Pedidos | ORDERS o ORDERS_WEB |
ACCESO_PEDIDOS |
/app/pedidos |
| Billetera | STELLAR_WALLET |
ACCESO_BILLETERA |
/app/billetera |
| Historial | BILLING_HISTORY (o EXPORT_TO_CSV con EXPORTAR_CSV) |
HISTORIA_FACTURACION |
/app/caja/historial |
| Reportes | ACCOUNTING_REPORTS |
REPORTE_CONTABILIDAD |
/app/reportes |
| Nómina electrónica | PAYROLL |
ACCESO_NOMINA |
/app/nomina |
| Procesos internos | INTERNAL_PROCESS |
ACCESO_PROCESOS |
/app/procesos |
| MercadoLibre | MERCADO_LIBRE |
ACCESO_MERCADOLIBRE |
/app/mercadolibre |
| Formatos de impresión | — | ACCESO_POS |
/app/formatos |
| Configuración | — | ACCESO_CONFIGURACION |
/app/config |
Flags con descripción oficial¶
Estos flags los crea el propio sistema y traen una descripción:
| Flag | Qué activa |
|---|---|
BARCODE_SCANNING |
Lectura de códigos de barras en facturación. |
ACCOUNTING_REPORTS |
Módulo de reportes contables. |
FIXED_ASSETS |
Activos fijos con depreciación mensual automática, integración contable y NIF PYMES sección 17. |
ACCOUNTING_G2_PYMES |
Marco normativo Grupo 2 (NIIF para PYMES, DUR 2420/2015 anexo 2): cuentas sin PUC base, jerarquía por cuenta padre y asientos ESFA. |
ACCOUNTING_G1_IFRS |
Marco normativo Grupo 1 (NIIF plenas): todo lo de Grupo 2 más instrumentos financieros complejos e información por segmentos. |
ACCOUNTING_MULTICURRENCY |
Registro de transacciones en moneda extranjera con tasa de cambio y saldos en COP. |
ACCOUNTING_ORI |
Otro Resultado Integral (NIC 1 / sección 5 NIIF PYMES) con impuesto diferido. |
RECURRING_INVOICES |
Guardar una factura como plantilla recurrente (diaria, semanal, mensual, trimestral o anual) que se genera sola. |
SCRAPING |
Importar productos desde proveedores externos (SYSCOM, DYNA) por categorías, con margen configurable. |
SPA_UI |
La interfaz actual (/app/). Sin él la empresa usa la interfaz clásica. |
MERCADO_LIBRE |
Módulo MercadoLibre: conexión, publicaciones, órdenes con facturación local, preguntas, mensajes y envíos. |
PAYROLL |
Nómina electrónica: empleados, periodos, liquidación y transmisión mediante el proveedor configurado. |
NOMINA_DIAN |
Transmitir, consultar, reemplazar y eliminar documentos de nómina ante la DIAN. Sin él, nómina funciona en modo local (botones de transmisión ocultos). |
INTERNAL_PROCESS |
Procesos internos: flujos de transformación configurables para convertir materiales en inventario vendible. |
Otros flags que usa la interfaz¶
Estos flags no tienen descripción oficial; el significado se infiere según su uso en la interfaz:
| Flag | Efecto observado |
|---|---|
PORTFOLIO, DAILY_BOX, ACCOUNTING, INVENTORY, RECIPES, ORDERS, ORDERS_WEB, STELLAR_WALLET, BILLING_HISTORY, EXPORT_TO_CSV |
Encienden las entradas del menú de la tabla anterior. INVENTORY además habilita campos de inventario en el diálogo de producto y la pestaña de inventario en Configuración. |
ELECTRONIC_BILLING |
Pestaña de facturación electrónica en Configuración y acciones DIAN en el detalle de la factura. |
ONLINE_PAYMENT |
Botón de pago en línea (Wompi) en la factura y en la tienda. |
CASH_PAYMENT, SHOW_PAYMENT_FORM, AUTOCOMPLETE_PAYMENT |
Controlan el bloque de pago del detalle de factura y de la caja: pago en efectivo, mostrar forma de pago, autocompletar el valor pagado. |
PRINT_ON_SAVE, PRINT_MENU |
Imprimir automáticamente al guardar; menú de impresión por atajo de teclado. |
SHOW_FAMILIES |
Barra de familias en la pantalla de ventas. |
PRODUCTS_HIDDEN |
Permite ocultar productos del catálogo del POS. |
PRODUCT_CUSTOM_IMAGES |
Fotos propias por producto en la cuadrícula. |
NUMBERS_IN_PRODUCT_MODAL, PRODUCT_PAYMENT_HISTORY |
Detalles extra en el diálogo de producto (números y pagos históricos). |
PRODUCTS_ARE_PERSONS, CLIENTS_ARE_FAMILIES |
Modos especiales del catálogo: los "productos" son personas (servicios por concepto) o los clientes se agrupan como familias. |
SCHEDULES |
Pestaña de horarios en Configuración. |
Cómo se activa un módulo¶
- Confirma que tu plan incluye la capacidad (Planes y límites). Por ejemplo, la impresión térmica y los módulos especializados son del plan Empresarial.
- Escribe a soporte de Agapanto indicando la empresa y el módulo. El equipo crea el feature flag para tu empresa (o te agrega a un conjunto de features, como el de TIENDAS WEB que reciben todas las empresas al instalarse).
- Asigna el permiso correspondiente a los roles que deben ver el módulo, en Configuración → Equipo.
- Pide a esos usuarios cerrar sesión y volver a entrar. Los flags se guardan en caché un corto tiempo; el cambio puede tardar unos minutos en verse.
Desactivar es igual de rápido
Un flag desactivado oculta el módulo de inmediato (tras la caché) sin borrar datos. Es la forma de "apagar" nómina, procesos o MercadoLibre si dejas de usarlos.
¿Problemas?
- Tengo el permiso pero no veo el módulo. Falta el flag en la empresa. Pide su activación a soporte.
- Soporte activó el flag y sigo sin verlo. Cierra sesión, vuelve a entrar y espera unos minutos por la caché. Revisa también que tu rol tenga el permiso.
- Veo Historial pero no puedo exportar. Tienes
BILLING_HISTORY+HISTORIA_FACTURACIONpero noEXPORT_TO_CSV+EXPORTAR_CSV. Son dos pares independientes. - Nómina liquida pero no transmite. Falta
NOMINA_DIAN(además dePAYROLL) o el permisoNOMINA_TRANSMITIR.
Siguiente: API.