Configuración

Todo lo que define cómo se comporta tu empresa vive en un solo panel organizado en grupos y secciones: Menú → Configuración (ruta /app/config). Cada sección se puede abrir directo con ?tab= en la URL (por ejemplo /app/config?tab=equipo), y así enlazan a ella otros módulos.

Permiso

Para entrar necesitas ACCESO_CONFIGURACION. Las secciones que guardan credenciales o llaves (Wompi, DIAN, Opciones de la empresa, Servientrega, tokens del cliente POS y Scraping) exigen además CONFIG_CREDENCIALES: sin él no cargan ni guardan.

Un vistazo

Menú → Configuración

settingsPanel de configuración

scheduleHorarioslistMotivosstraightenUnidadesplaceCiudadescredit_cardWompipercentImpuestosdescriptionDocumentospaymentsFormas de pagoprintImpresión POSprintImpresión por documentobusinessEmpresabadgeNómina electrónicagroupEquipotunePreferenciaspaletteTiendadownloadScraping 1

Unidades de medidaadd Agregar 2

Nombre	Código DIAN	Chequeo duplicados (días)
Unidad	94	0	edit delete
Kilo	1	0	edit delete

Conversiones entre unidadesadd Agregar conversión 3

El panel con todas las pestañas posibles. En tu empresa solo verás las que activan tus módulos y permisos.

1. 1 Pestañas en el orden real del panel. Si no caben, se desplazan con las flechas de los extremos o con la rueda del mouse.
2. 2 Las pestañas de listas (Unidades, Impuestos, Documentos, Formas de pago, Motivos, Impresoras…) funcionan igual: Agregar abre el formulario, el lápiz abre Editar — …, la papelera pregunta ¿Eliminar este registro?.
3. 3 Algunas pestañas traen más de una lista; aquí Conversiones entre unidades (unidad de compra, unidad de receta y factor) para las recetas.

Grupos y secciones

El panel tiene dos niveles: arriba eliges el grupo y debajo la sección. Un grupo solo aparece si tienes al menos una de sus secciones.

Grupo › Sección	Para qué sirve	Flag/permiso que la muestra	Página de esta guía
Empresa › Datos	Datos de la empresa: identidad, contacto, logo, redes y datos bancarios.	Siempre	Configurar tu empresa
Empresa › Preferencias	Interruptores y valores del día a día (caja, POS, tienda, notificaciones, página de inicio).	Siempre (Opciones de la empresa exige CONFIG_CREDENCIALES)	Preferencias
Empresa › Horarios	Horarios de atención: hora en que Abre y Cierra y los días de la semana.	Flag SCHEDULES	—
Equipo	Miembros, roles e invitaciones.	Permiso GESTIONAR_EQUIPO	Invitar a tu equipo
Ventas › Documentos	Tipos de documento, resolución DIAN y consecutivos.	Siempre	Configurar tu empresa
Ventas › Impuestos	Tarifas de IVA y retenciones con sus cuentas contables.	Siempre	Configurar tu empresa · Impuestos y retenciones
Ventas › Formas de pago	Opciones del campo Forma de pago y su cuenta contable.	Siempre	Configurar tu empresa
Ventas › Procesos por documento	Reglas que lanzan un proceso interno al guardar un documento.	Flag INTERNAL_PROCESS + permiso PROCESOS_CONFIGURAR	Lanzar desde documentos
Inventario › Unidades (o Conceptos)	Unidades de medida con Código DIAN y Conversiones entre unidades. Se llama Conceptos con el flag PRODUCTS_ARE_PERSONS.	Siempre	Configurar tu empresa
Inventario › Motivos de ajuste	Motivos de ajuste de inventario que eliges al ajustar stock.	Flag INVENTORY	Ajuste y conteo
Inventario › Importación (Scraping)	Credenciales de proveedores y categorías a importar con margen.	Flag SCRAPING (+ CONFIG_CREDENCIALES)	Ver abajo
Impresión y dispositivos › Impresión POS	Modo de impresión, impresoras térmicas, cliente de impresión y sus tokens.	Siempre (tokens exigen CONFIG_CREDENCIALES)	Impresión POS
Impresión y dispositivos › Impresión por documento	Modo, auto-impresión y plantilla por cada tipo de documento.	Siempre	Impresión POS
Impresión y dispositivos › Terminales y numeración	Equipos del POS sin conexión y sus resoluciones de facturación.	Flag POS_OFFLINE + permiso CONFIG_CREDENCIALES	—
Impresión y dispositivos › Comanderos	Comanderos de mano: alta, vinculación y revocación.	Flag COMANDERO + permiso CONFIG_CREDENCIALES	—
Tienda en línea › Apariencia	Apariencia de la tienda: plantilla, tipografía, colores, misión y visión.	Siempre	Apariencia
Tienda en línea › Envíos	Ciudades de cobertura a las que vendes y envías, y la tarjeta Envíos — Servientrega.	Siempre (Servientrega exige CONFIG_CREDENCIALES)	Envíos
Tienda en línea › Wompi	Pagos en línea — Wompi: activar, modo sandbox y llaves.	Siempre (editar exige CONFIG_CREDENCIALES)	Pagos en línea
Tienda en línea › Bre-B	Pagos por transferencia — Bre-B: llave, titular, QR e instrucciones.	Siempre (editar exige CONFIG_CREDENCIALES)	Pagos en línea
Documentos electrónicos › Facturación electrónica	Proveedor tecnológico, numeración de notas y documentos que se transmiten.	Flag FACTURACION_DIAN + permiso FACTURACION_DIAN_CONFIGURAR	Activar
Documentos electrónicos › Nómina electrónica	Proveedor, credenciales y parámetros de liquidación de nómina.	Flag PAYROLL + permiso NOMINA_CONFIGURAR	Configurar nómina
Documentos electrónicos › Credenciales	Tarjeta Facturación electrónica (DIAN): facturador electrónico y sus llaves.	Flag ELECTRONIC_BILLING (+ CONFIG_CREDENCIALES)	Activar

La Billetera no es una sección del panel: es una entrada propia del menú (flag STELLAR_WALLET), pero la documentamos en esta sección.

Abrir una sección directo

Los valores de ?tab= son, por grupo: empresa, preferencias, horarios · equipo · documentos, impuestos, formas-pago, procesos-documentos · unidades, motivos, scraping · pos-printing, documento-printing, equipos, comanderos · tienda, ciudades, wompi, breb · facturacion-dian, nomina, fe-credenciales. La URL se actualiza sola al cambiar de sección, así que puedes copiarla y compartirla.

• Sin ?tab=, el panel abre en Empresa › Datos.
• Un ?tab= que no existe, o de una sección que tu empresa o tu rol no tienen (por ejemplo ?tab=equipo sin GESTIONAR_EQUIPO), te deja en Empresa › Datos.
• Las rutas viejas /app/equipo y /app/nomina/configuracion redirigen a su sección.

Scraping: importar catálogos de proveedores

Solo con el flag SCRAPING. Tiene dos bloques:

• Credenciales de proveedores: eliges el Proveedor (SYSCOM, DYNA o DROPI), escribes Client ID / Usuario y Client Secret / Token y pulsas Guardar credenciales (Credenciales guardadas). La lista de abajo muestra cada proveedor con la etiqueta secret ✓ o sin secret; el secreto nunca se vuelve a mostrar.
• Categorías a importar: con Agregar abres Nueva categoría a importar: Proveedor (los tres anteriores más HOUSEOFBEAUTY, MAGICHAIR y DISTRICOSMETICOS, que no llevan credenciales), Categoría, Subcategoría (opcional), Expresión adicional (opcional) y Margen % (20 por defecto). Crear deja la búsqueda en la tabla (Proveedor, Búsqueda, Familia, Margen %, Activo), donde puedes corregir el margen en el sitio, apagarla con el interruptor o borrarla con la papelera.

El Margen % es el porcentaje que se suma al costo del proveedor para calcular tu precio de venta al importar.

Cada tarjeta guarda por su cuenta

En las pestañas de formulario (Wompi, Tienda, Preferencias) cada bloque tiene su propio botón Guardar y confirma con Configuración guardada. Guardar uno no guarda los demás.

Credenciales: solo con CONFIG_CREDENCIALES

Es un permiso aparte de ACCESO_CONFIGURACION: quien crea la empresa lo tiene, pero un rol nuevo no. Si un bloque muestra No se pudo guardar la configuración o aparece vacío, revisa ese permiso en Roles y permisos.

¿Problemas?

• No veo Configuración en el menú. Tu rol no tiene ACCESO_CONFIGURACION.
• Falta el grupo Equipo o la sección Nómina electrónica. Necesitas GESTIONAR_EQUIPO o, para nómina, el flag PAYROLL y el permiso NOMINA_CONFIGURAR.
• Wompi, Scraping u Opciones de la empresa dicen No se pudo guardar la configuración. Te falta CONFIG_CREDENCIALES.
• Abrí ?tab=nomina y caí en Empresa › Datos. No tienes permiso para esa sección; el panel te lleva a la primera disponible.

Siguiente: Impresión POS.