Glosario¶

Términos del sistema y de la normativa colombiana, en el orden en que suelen aparecer.

Cuenta y acceso¶

Empresa: Tu negocio dentro de Agapanto. Cada empresa tiene sus propios datos, usuarios, productos y consecutivos. Un mismo usuario puede pertenecer a varias.
Rol: El conjunto de permisos de un usuario en una empresa. Se crea a partir de una plantilla (Propietario, Vendedor, Contador…) y luego se ajusta permiso por permiso. Ver Roles y permisos.
Permiso: Una acción concreta que un rol puede hacer, por ejemplo ACCESO_POS o CERRAR_CAJA_DIARIA.
Feature flag (módulo activado): Interruptor por empresa que enciende un módulo completo (nómina, procesos, MercadoLibre…). Sin el flag, la entrada no aparece en el menú aunque el rol tenga el permiso. Ver Módulos y feature flags.
2FA / OTP: Segundo factor de autenticación: un código de seis dígitos que genera una app en tu celular. Si lo activas, el inicio de sesión lo pide siempre.
Prueba gratis: Los 30 días sin costo ni tarjeta al crear la empresa. Al vencer, la aplicación se bloquea hasta elegir un plan.

Documento: Tipo de comprobante que emites: factura de venta, cotización, factura de compra, nota crédito… Cada uno lleva su consecutivo y, si aplica, su resolución DIAN.
Consecutivo: Número correlativo del documento. Se asigna al Guardar y nunca se reutiliza, ni siquiera si anulas la factura.
Prefactura / factura abierta: La factura que estás armando en el POS antes de pulsar Guardar. Puedes tener varias abiertas (una por mesa o cliente).
Entidad: Un cliente, un proveedor o una mesa. El mapa de mesas y la lista de clientes muestran entidades.
Forma de pago: Cómo te pagan: efectivo, transferencia, tarjeta… Cada forma de pago apunta a una cuenta contable.
Contado / crédito: Si la factura queda pagada al guardar (contado) o con saldo pendiente y plazo (crédito). Las facturas a crédito alimentan la cartera.
Cartera: Lo que tus clientes te deben. Ver Cartera y Cartera vencida.
Nota crédito / nota débito: Documentos que corrigen una factura ya emitida: la nota crédito la disminuye (devolución, descuento), la débito la aumenta. Ver Notas crédito y débito.
Tirilla: El recibo angosto que imprime una impresora térmica (58 u 80 mm).
Formato de impresión: Plantilla del documento en PDF (formal) que diseñas por secciones. Ver Formatos de impresión.
Comanda: Impresión para cocina o bar con lo que hay que preparar de un pedido.

Base: El efectivo con el que abre la caja cada día.
Cierre de caja: Corte que agrupa las ventas y compras del turno, calcula el total en caja y deja las facturas marcadas como cerradas. Ver Caja diaria.
Arqueo: Comparar el dinero físico con el total que dice el cierre, desglosado por forma de pago.

Familia: Categoría de productos. Puede tener una familia padre y define las cuentas contables de sus productos.
Stock / cantidad: Unidades disponibles de un producto. Baja al guardar una venta y sube con compras, ajustes o procesos finalizados.
Movimiento: Cada entrada o salida de stock con su origen (factura, ajuste, traslado, proceso).
Ajuste / conteo: Corregir el stock al valor real contado, indicando un motivo.
Alerta mínimo: Cantidad bajo la cual el producto se muestra como stock bajo.
Unidad de medida: Cómo se vende o compra un producto (unidad, kilo, caja…). Las conversiones relacionan unidades entre sí.
Receta / producto compuesto: Producto que se arma con otros (ingredientes). Su costo se calcula desde los componentes. Ver Productos compuestos.
Tarifa: Precio especial de un producto para un cliente concreto.

PUC: Plan Único de Cuentas colombiano. Agapanto lo instala y lo asigna automáticamente a familias, impuestos y formas de pago.
Asiento: Registro contable con movimientos débito y crédito que deben cuadrar. Las ventas y compras generan asientos solos.
Libro mayor: Movimientos de una cuenta a lo largo del tiempo.
Periodo contable: Mes (o rango) que se cierra cuando está revisado. En un periodo cerrado no se aceptan más asientos.
IVA / impuesto: Porcentaje que se suma al precio. Se configura una vez y se asigna a cada producto.
Retención: Impuesto que se resta del pago (retefuente, reteIVA…). Usa cuentas distintas en venta y en compra.
Activo fijo: Bien duradero (máquina, vehículo, computador) que se deprecia mes a mes según su categoría.

DIAN: La autoridad tributaria colombiana. Recibe y valida facturas y nóminas electrónicas.
Resolución de facturación: Autorización de la DIAN con prefijo, rango de números y fecha de vencimiento. Se registra en el documento.
CUFE / CUDE / CUNE: Códigos únicos que la DIAN asigna a una factura (CUFE), a una nota (CUDE) y a un documento de nómina (CUNE). Prueban que el documento fue aceptado.
Proveedor tecnológico: Empresa autorizada por la DIAN a través de la cual se transmite la nómina electrónica.
SMMLV / auxilio de transporte: Salario mínimo y auxilio legales del año. Se actualizan cada enero en la configuración de nómina.
Nota de ajuste: Documento de nómina que reemplaza o elimina uno ya transmitido.

Flujo: Un proceso configurable (reacondicionar portátiles, hornear pan, armar estibas) con sus pasos y transiciones.
Paso: Una columna del tablero: una estación de trabajo. Puede tener formulario, materiales predeterminados, responsables y costo por defecto.
Transición: El botón que mueve un item de un paso a otro. Puede exigir una nota o un permiso adicional.
Item: Lo que recorre el flujo: una unidad con serial o un lote con cantidad.
Orden: Un ingreso de items al flujo, normalmente ligado a una compra (proveedor, costo, cantidad).
Costo acumulado: Compra + materiales consumidos + costo de cada paso. Es el total del item; el costo unitario se obtiene dividiendo por la cantidad.
Finalizar: Sacar el item del flujo creando un producto nuevo en inventario o reponiendo el stock de uno existente.

Nombre corto: El identificador de tu tienda en internet: nombre-corto.agapanto.com.co.
Plantilla de tienda: El diseño visual de tu tienda (Moderna, Clásica, Minimalista, Elegante, Vibrante, Artesanal, Tecno).
Cotización: Solicitud de precio que un cliente hace desde la tienda para productos que no se venden directo. Tiene código y vigencia.
Wompi: Pasarela de pagos colombiana para cobrar con tarjeta, PSE o QR en la tienda y en el POS.
Servientrega: Transportadora con la que se cotiza el envío en el checkout, usando peso y dimensiones del producto.
MercadoLibre: Marketplace con el que Agapanto sincroniza publicaciones, órdenes, preguntas y mensajes.
Cliente de impresión: Programa pequeño que se instala en el computador del punto de venta para imprimir en la impresora térmica sin diálogos del navegador.
Token del cliente POS: Credencial que identifica al cliente de impresión de tu empresa. Se muestra una sola vez al crearlo.
API: Puerta para que otros programas lean o escriban en tu empresa con permiso. Ver API.
MCP / bot: Forma de exponer Agapanto como herramientas para asistentes de IA y bots de Telegram. Ver Bots e IA.
Billetera: Saldo de la empresa en la red Stellar. Mueve valor real. Ver Billetera.