# Introducción

# Visión general

PrimApp es una aplicación comercial conectada directamente con iDempiere. Permite trabajar con clientes, productos, pedidos, ventas, facturas y caja sin entrar al ERP para cada operación.

## Cómo se selecciona el modo

```mermaid
flowchart LR
    A[Iniciar PrimApp] --> B{¿POS ID válido?}
    B -- No --> C[Modo fuerza de venta]
    C --> D[Dashboard]
    B -- Sí --> E[Modo punto de venta]
    E --> F[Nueva venta]
```

## Funciones disponibles

- Inicio de sesión con selección de empresa, rol, organización y almacén.
- Catálogos de clientes y productos con búsqueda, filtros, paginación y sincronización local.
- Pedidos, cotizaciones y ventas en modo fuerza de venta.
- Ventas rápidas y operación de caja en modo punto de venta.
- Descuentos, múltiples medios de pago y modificación de precios cuando la terminal lo permite.
- Historial, comprobantes, facturas de regalo, devoluciones y cierres de caja.

## Modos de operación

<table id="bkmrk-modo-uso-inicio-fuer" style="width:100%;border-collapse:collapse;margin:12px 0 20px 0;"><thead style="border:1px solid #d8dee9;padding:12px;background:#eef2f7;text-align:left;"><tr><th style="border:1px solid #d8dee9;padding:12px;background:#eef2f7;text-align:left;">Modo</th><th style="border:1px solid #d8dee9;padding:12px;background:#eef2f7;text-align:left;">Uso</th><th style="border:1px solid #d8dee9;padding:12px;background:#eef2f7;text-align:left;">Inicio</th></tr></thead><tbody><tr><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Fuerza de venta</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Gestión comercial, pedidos, facturas, clientes, productos y dashboard.</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Dashboard</td></tr><tr><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Punto de venta</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Venta rápida, pagos, devoluciones, tickets y cierre de caja.</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Nueva venta</td></tr></tbody></table>

El **modo fuerza de venta** funciona sin POS ID. El **modo punto de venta** se activa al configurar un POS ID válido.

<p class="callout info">POS sigue utilizándose como abreviatura técnica en campos como POS ID y modelos como `C_POS`.</p>

# 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

<table id="bkmrk-conceptoqu%C3%A9-signific" style="width:100%;border-collapse:collapse;margin:12px 0 20px 0;"><thead style="border:1px solid #d8dee9;padding:12px;background:#eef2f7;text-align:left;"><tr><th style="border:1px solid #d8dee9;padding:12px;background:#eef2f7;text-align:left;">Concepto</th><th style="border:1px solid #d8dee9;padding:12px;background:#eef2f7;text-align:left;">Qué significa</th><th style="border:1px solid #d8dee9;padding:12px;background:#eef2f7;text-align:left;">Por qué importa</th></tr></thead><tbody><tr><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">**Empresa o grupo empresarial**</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Es el ambiente de trabajo de una empresa dentro de iDempiere.</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Agrupa clientes, productos, usuarios, documentos, precios y configuraciones.</td></tr><tr><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">**Organización**</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Es la unidad donde se registran las operaciones.</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Puede representar una sucursal, una unidad administrativa o una operación específica.</td></tr><tr><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">**Rol**</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Define qué puede ver y hacer cada usuario.</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Puede cambiar documentos disponibles, acciones permitidas e información visible.</td></tr><tr><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">**Almacén**</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Es el lugar desde donde se manejan productos e inventario.</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Asocia operaciones comerciales con disponibilidad y movimiento de productos.</td></tr><tr><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">**Modo fuerza de venta**</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Flujo comercial sin una terminal POS.</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Abre en el dashboard y permite gestionar pedidos, clientes, productos y facturas.</td></tr><tr><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">**Modo punto de venta**</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Flujo de caja asociado a un POS ID.</td><td style="border:1px solid #d8dee9;padding:12px;vertical-align:top;">Abre en nueva venta y habilita pagos, tickets, devoluciones y cierre de caja.</td></tr></tbody></table>

## 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.
3. El usuario selecciona el contexto de trabajo.
4. La app abre el dashboard en modo fuerza de venta o la nueva venta en modo punto de venta.

<p class="callout info">**En resumen:** PrimApp usa el contexto y el POS ID para decidir qué modo debe abrir.</p>