# Introducción # Visión general **PrimApp** ayuda a que el trabajo comercial del día a día sea más rápido, ordenado y fácil de seguir desde una experiencia simple conectada con iDempiere. Desde PrimApp puedes consultar clientes, revisar productos, crear pedidos, registrar ventas y dar seguimiento a documentos sin tener que entrar directamente al ERP para cada operación. ## Qué puedes hacer con PrimApp

Clientes Consultar información comercial, buscar clientes y usarlos rápidamente al crear pedidos.	Productos y precios Revisar productos disponibles, precios, impuestos y datos necesarios para vender.
Pedidos y ventas Crear operaciones comerciales usando la configuración definida en iDempiere.	Dashboard Ver indicadores y acceder rápidamente a las opciones principales de trabajo.

## Cómo se conecta todo La app se comunica con iDempiere usando **API REST**. PrimApp muestra una experiencia sencilla para el usuario, mientras iDempiere sigue siendo el sistema principal donde viven los datos, reglas de negocio, documentos, precios e impuestos. > **Idea clave:** PrimApp no reemplaza iDempiere. Lo acerca al equipo comercial con una interfaz más directa para las tareas frecuentes.

Diagrama general de conexión entre PrimApp e iDempiere

## Modo de uso principal El **modo no POS** es el flujo principal y el más usado. En este modo, después de iniciar sesión y seleccionar empresa, rol y organización, la app abre el dashboard.

Modo	Cuándo se usa	Pantalla inicial
No POS	Operación comercial general: pedidos, clientes, productos y dashboard.	Dashboard
POS	Venta rápida en caja con una terminal POS configurada.	Nueva venta

**Nota:** el modo POS solo se activa cuando se configura un `POS ID`. Si no se usa POS ID, PrimApp entra al flujo normal de operación.

# Conceptos clave Antes de usar PrimApp, conviene conocer algunos términos. No necesitas dominarlos a nivel técnico, pero ayudan a entender por qué la app solicita ciertos datos al iniciar sesión. ## Conceptos principales

Concepto	Qué significa	Por qué importa
Empresa o grupo empresarial	Es el ambiente de trabajo de una empresa dentro de iDempiere.	Agrupa clientes, productos, usuarios, documentos, precios y configuraciones.
Organización	Es la unidad donde se registran las operaciones.	Puede representar una sucursal, una unidad administrativa o una operación específica del negocio.
Rol	Define qué puede ver y hacer cada usuario.	Puede cambiar documentos disponibles, acciones permitidas e información visible.
Almacén	Es el lugar desde donde se manejan productos e inventario.	Permite asociar operaciones comerciales con disponibilidad y movimiento de productos.
Lista de precios	Define qué precio tiene cada producto.	Puede venir de la lista estándar de venta, del cliente o de la terminal POS.
Tipo de documento	Define el tipo de operación que se va a crear.	Puede representar pedido, factura, cotización o devolución según la configuración del ERP.

## Cómo se usan al iniciar sesión 1. El usuario inicia sesión contra el servidor configurado. 2. PrimApp obtiene las empresas, roles y organizaciones disponibles para ese usuario. 3. El usuario selecciona el contexto con el que va a trabajar. 4. La app abre el flujo correspondiente: dashboard en modo no POS o venta rápida en modo POS. > **En resumen:** estos conceptos no son pasos adicionales sin razón. Son la forma en que PrimApp sabe con qué empresa, permisos, documentos, precios y operación debe trabajar.

**Importante:** si un usuario no ve una opción esperada, normalmente se debe revisar su rol, organización, lista de precios o configuración en iDempiere.

Clientes Consultar información comercial, buscar clientes y usarlos rápidamente al crear pedidos.	Productos y precios Revisar productos disponibles, precios, impuestos y datos necesarios para vender.
Pedidos y ventas Crear operaciones comerciales usando la configuración definida en iDempiere.	Dashboard Ver indicadores y acceder rápidamente a las opciones principales de trabajo.