PrimApp

• Introducción
• Visión general
• Conceptos clave
• Primer Acceso
• Inicio de sesión
• Configuración de servidor y POS ID
• Selección de empresa, rol y organización
• Uso General
• Dashboard y navegación
• Clientes
• Productos y precios
• Pedidos y operación comercial
• Devoluciones y notas de crédito
• Configuración de organización
• Modo POS
• Qué cambia en modo POS
• Cierre de caja
• Pagos y Yappy

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.

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.

Primer Acceso

Inicio de sesión

La pantalla de inicio de sesión es el primer paso para entrar a PrimApp.

Qué debes ingresar

Campo	Descripción
Usuario	Normalmente tu correo o usuario asignado.
Contraseña	La clave de acceso.
Idioma	Permite cambiar entre español e inglés.
Recuérdame	Guarda tu usuario y preferencia de idioma para próximos accesos.

Pasos para entrar

1. Escribe tu usuario y contraseña.
2. Selecciona el idioma si necesitas cambiarlo.
3. Activa Recuérdame solo si estás usando un equipo de confianza.
4. Presiona Iniciar Sesión.
5. Selecciona empresa, rol y organización.

Nota: el botón con engranaje abre la configuración del servidor y del modo POS. Normalmente soporte o un administrador te indicará si necesitas cambiar algo ahí.

Registro de cuenta

Si la opción está habilitada, puedes usar Regístrate para iniciar el flujo de creación de cuenta desde la web de PrimApp.

Configuración de servidor y POS ID

Esta pantalla se usa para indicar a qué servidor se conectará PrimApp y si la app debe trabajar como punto de venta.

URL del servidor

La URL del servidor indica contra qué ambiente trabajará la app.

Ambiente	URL
Producción	https://fe.primware.net
Pruebas	https://primhub.primware.net

Nota: en la mayoría de los casos, el usuario final no necesita cambiar este valor. Si hay dudas, debe validarlo con soporte.

POS ID

El campo POS ID cambia el comportamiento de la app.

Valor	Resultado
Vacío	PrimApp funciona en modo no POS. Este es el modo principal y más usado.
ID válido	PrimApp funciona en modo POS para punto de venta.

Recomendación: solo se debe colocar un POS ID cuando soporte confirme que existe una terminal POS configurada para ese usuario o dispositivo.

Selección de empresa, rol y organización

Después de validar tus credenciales, PrimApp te pide escoger el contexto de trabajo.

Qué significa cada selección

Selección	Uso
Empresa	Empresa o grupo empresarial donde vas a trabajar.
Rol	Permisos y opciones disponibles para tu trabajo, como ventas, administración o soporte.
Organización	Unidad donde se registrarán tus operaciones.

Recordar configuración

Puedes activar la opción de recordar configuración si normalmente trabajas siempre con la misma empresa, rol y organización.

Importante: si trabajas con varias organizaciones, revisa esta selección cada vez antes de continuar.

Qué pasa al continuar

Modo	Destino
No POS	Dashboard.
POS	Nueva orden de venta.

Uso General

Dashboard y navegación

En modo no POS, el dashboard es la pantalla principal de PrimApp. Desde aquí puedes revisar información comercial y moverte a las opciones principales de la app.

Qué puedes ver

Ventas del periodo Resumen de actividad comercial para el rango disponible.	Ventas por día Movimiento diario para revisar comportamiento reciente.
Ventas por representante Indicadores por vendedor cuando el ambiente lo permite.	Categorías y accesos rápidos Información por categoría de producto y accesos a operaciones frecuentes.

Nota: si no hay datos para el periodo, la app puede mostrar el dashboard vacío o sin pedidos del mes.

Menú lateral

Desde el menú puedes acceder a las opciones principales de trabajo.

Opción	Uso
Dashboard	Revisar indicadores y actividad comercial.
Nuevos documentos	Crear pedidos u otros documentos habilitados.
Mis pedidos	Consultar documentos creados o asignados.
Productos y clientes	Buscar información comercial para operar.
Configuración	Revisar opciones de la app y contexto.

Nota: las opciones disponibles pueden cambiar según el rol del usuario y si la app está o no en modo POS.

Clientes

La sección de clientes permite buscar, revisar y gestionar terceros comerciales registrados en iDempiere.

Qué información puedes encontrar

Dato	Para qué sirve
Nombre e identificación fiscal	Confirmar que se está usando el cliente correcto.
Correo, contacto y dirección	Revisar datos de comunicación y ubicación.
Grupo y tipo de identificación	Aplicar clasificación comercial y fiscal según iDempiere.
Lista de precios asociada	Usar precios especiales del cliente cuando aplique.

Uso dentro de pedidos

Cuando creas un pedido, debes seleccionar el cliente de la operación.

Modo no POS: si el cliente tiene una lista de precios asignada, PrimApp puede usarla para calcular los precios de los productos.

Modo POS: la lista de precios viene de la terminal POS y no del cliente.

Productos y precios

PrimApp muestra los productos y precios que vienen desde iDempiere. La app no inventa precios ni mantiene un catálogo separado.

Idea clave: los precios, impuestos y disponibilidad dependen de la configuración de iDempiere y del contexto seleccionado en PrimApp.

Por qué un producto puede no aparecer

Revisión	Qué validar
Estado del producto	Debe estar activo y marcado para venta.
Impuestos	Debe tener categoría de impuesto.
Precio	Debe tener precio en la lista de precios activa.
Contexto operativo	Debe pertenecer al contexto de empresa, organización y almacén correcto.

Cómo se resuelven los precios

Modo	Origen del precio
No POS	Lista de precios estándar de venta o lista asociada al cliente seleccionado.
POS	Lista de precios configurada en la terminal POS.

Nota: en modo POS, la app también puede mostrar disponibilidad según el almacén de la terminal.

Pedidos y operación comercial

La creación de pedidos es una de las funciones principales de PrimApp. Desde este flujo puedes seleccionar cliente, agregar productos, revisar totales y guardar o completar el documento según la configuración disponible.

Flujo general

1. Selecciona el tipo de documento comercial.
2. Elige el cliente.
3. Agrega los productos.
4. Revisa cantidades, precios, descuentos, impuestos y totales.
5. Selecciona la acción del documento.
6. Guarda el documento como borrador o complétalo según permisos.
7. Desde el detalle, imprime, comparte, duplica, convierte o sincroniza información cuando corresponda.

Partes del pedido

Parte	Uso
Tipo de documento	Define si la operación será pedido, factura, cotización o devolución según configuración.
Cliente	Identifica a quién se le registra la operación comercial.
Productos	Líneas del documento con cantidades, precios, descuentos e impuestos.
Pagos	En modo POS permite registrar medios de pago antes de completar la venta.
Acción del documento	Permite guardar, completar u operar el documento según permisos y estado.

Agregar productos

Desde el pedido puedes buscar productos y agregarlos al documento. La disponibilidad, precio e impuestos dependen de la lista de precios, almacén, organización y configuración de iDempiere.

Detalle del documento

Después de crear un pedido, puedes revisar su detalle, líneas, totales, estado, factura relacionada y acciones disponibles.

Acciones disponibles desde el detalle

Acción	Qué hace	Cuándo aparece
Imprimir ticket	Genera un comprobante tipo ticket POS, optimizado para impresión de 80mm cuando aplica.	Principalmente en modo POS o cuando el documento tiene datos suficientes para impresión.
Compartir PDF	Genera un PDF del documento para compartirlo desde el dispositivo.	Cuando el documento puede representarse como comprobante o resumen comercial.
Completar borrador	Ejecuta la acción de documento para completar una orden guardada previamente.	Cuando el documento está en borrador y el usuario tiene permisos.
Duplicar	Crea un nuevo documento tomando como base el cliente, productos y cantidades del documento original.	Cuando el documento puede usarse como plantilla para una nueva venta.
Convertir	Permite crear otro tipo de documento relacionado, según la configuración documental disponible.	Cuando el tipo de documento y estado permiten conversión.
Sincronizar factura electrónica	Consulta o ejecuta la sincronización de factura electrónica asociada.	Cuando existe factura relacionada y el ambiente tiene facturación electrónica configurada.
Crear nota de crédito	Genera una nota de crédito desde una factura/documento relacionado.	Cuando el documento está completo, tiene factura relacionada y el rol tiene permisos.

Impresión, PDF y ticket POS

PrimApp puede generar comprobantes en PDF y tickets POS. En modo POS, el ticket puede incluir logo, datos de organización, QR de factura electrónica si está disponible, líneas del documento, pagos registrados, vuelto y textos personalizados de encabezado o pie.

Nota: el formato final del ticket depende de la configuración de organización, la configuración de impresora POS y los datos retornados por iDempiere.

Factura electrónica

Cuando la operación genera o tiene una factura relacionada, PrimApp puede mostrar información de factura electrónica, consultar su estado o incluir un QR en el comprobante si el ambiente lo provee.

Si la información de factura electrónica no aparece, revisa que la factura exista, que el proceso de sincronización esté disponible y que el usuario tenga permisos para consultar los datos relacionados.

Idea clave: en modo no POS los tipos de documento dependen del rol y la configuración de iDempiere. En modo POS se toman desde la terminal POS configurada.

Devoluciones y notas de crédito

PrimApp puede trabajar con devoluciones y notas de crédito cuando el ambiente, el rol del usuario y el estado del documento lo permiten. La app muestra estas acciones solo cuando tiene suficiente información para iniciar el flujo correcto.

Idea clave: la disponibilidad de una devolución no depende solo de la app. También depende del estado del documento, la factura relacionada, los permisos y la configuración fiscal/documental en iDempiere.

Diferencias por modo

Modo	Comportamiento
No POS	El usuario trabaja con documentos comerciales habilitados para su rol. Si una orden está completa y tiene factura relacionada, PrimApp puede iniciar la creación de una nota de crédito.
POS	La devolución usa el tipo de documento de devolución configurado en la terminal POS.

Flujo en modo POS

En caja, la devolución normalmente parte de una orden existente y usa la configuración de la terminal POS.

1. El usuario abre el documento original desde el listado o detalle de pedidos.
2. PrimApp valida que exista configuración POS y documento de devolución.
3. El usuario inicia la devolución desde la acción disponible.
4. La app prepara una nueva operación con el tipo de documento de devolución POS.
5. El usuario revisa líneas, cantidades y totales antes de completar.
6. Luego puede imprimir ticket o compartir PDF según corresponda.

Nota: en modo POS, el documento de devolución depende de C_DocTypeRefund_ID asociado a la terminal.

Flujo en modo no POS

En operación comercial general, la nota de crédito se basa en la factura relacionada con la orden.

1. El usuario abre una orden completa desde pedidos.
2. PrimApp revisa si existe una factura relacionada.
3. Si corresponde, muestra la acción para crear nota de crédito.
4. La app ejecuta el proceso de iDempiere para crear la nota de crédito.
5. El usuario revisa el resultado y consulta el documento generado.

Qué se puede ajustar antes de completar

Elemento	Revisión recomendada
Cliente	Confirmar que corresponde al documento original.
Productos	Revisar líneas, cantidades y productos devueltos.
Impuestos	Validar que los impuestos se calculen según la configuración fiscal.
Total	Confirmar que el total coincide con lo que se va a devolver o acreditar.

Qué revisar si no aparece la opción

Revisión	Detalle
Permisos	El rol debe tener acceso al documento y a la acción correspondiente.
Documento original	Debe estar en un estado compatible con devolución o nota de crédito.
Factura relacionada	Debe existir cuando el flujo de nota de crédito lo requiera.
Configuración POS	Para modo POS, la terminal debe tener documento de devolución configurado.
Configuración fiscal	Debe existir configuración fiscal y documental en iDempiere.

Importante: antes de completar una devolución o nota de crédito, revisa cantidades, impuestos y total. Una vez completado el documento, los cambios dependen de las reglas de iDempiere y de la configuración fiscal.

Configuración de organización

Desde la configuración de organización, PrimApp permite revisar y actualizar datos básicos de la empresa que se usan en la app, en documentos y en la impresión POS cuando corresponde.

Nota: estos datos se guardan en iDempiere. Si un dato no aparece o no se puede editar, revisa permisos del rol, organización activa y configuración del servidor.

Qué se puede configurar

Dato	Uso en PrimApp
Nombre de la organización	Identifica la empresa dentro de la app y puede mostrarse en comprobantes.
RUC / identificación fiscal	Se usa como referencia fiscal de la organización.
DV	Complementa la identificación fiscal cuando aplica.
Teléfono y correo	Datos de contacto visibles para operación y documentos.
País, ciudad y dirección	Ubicación fiscal o comercial de la organización.
Logo	Puede mostrarse en la app y en comprobantes generados por PrimApp.

Logo de la organización

PrimApp permite cargar o actualizar el logo de la organización desde la cámara o la galería del dispositivo. Después de seleccionar la imagen, la app permite recortarla antes de guardarla.

1. Abre el menú de configuración.
2. Entra a la tarjeta de información de organización.
3. Selecciona el logo actual o la opción para cambiarlo.
4. Elige cámara o galería.
5. Recorta la imagen si es necesario.
6. Guarda los cambios.

Importante: usa una imagen clara y legible. Logos demasiado pequeños, con mucho detalle o con fondo transparente irregular pueden verse mal en tickets POS.

Encabezado y pie de página POS

Cuando la app trabaja en modo POS, puede usar textos personalizados para complementar el encabezado y pie del comprobante. Estos textos se guardan en la configuración de impresora POS.

Campo	Uso
Header1 a Header4	Líneas adicionales del encabezado del ticket.
Footer1 a Footer4	Líneas adicionales del pie del ticket.

Además de estos campos, PrimApp puede tomar datos de la organización para construir encabezados fiscales y de contacto, como nombre, dirección, RUC, DV, teléfono, correo y logo.

Relación con iDempiere

Modelo	Uso
AD_OrgInfo	Información fiscal, contacto, dirección y logo de la organización.
C_Location	Dirección, país y ciudad relacionados con la organización.
AD_Image / Logo_ID	Imagen usada como logo de la organización.
CDS_POSPrinterConfig	Textos personalizados de encabezado y pie de página para impresión POS.

Cuándo revisar esta configuración

• Antes de usar PrimApp en producción.
• Cuando el ticket POS muestra datos incompletos.
• Cuando el logo no aparece o se ve incorrecto.
• Cuando cambian datos fiscales, teléfono, correo o dirección de la empresa.
• Cuando se quiere personalizar el mensaje de encabezado o pie del comprobante POS.

Modo POS

Qué cambia en modo POS

El modo POS se activa cuando se configura un POS ID válido antes de iniciar sesión. Este modo cambia la entrada a la app, los documentos usados, los medios de pago disponibles y la forma de impresión.

Idea clave: el modo POS es una especialización para venta rápida en caja. Para operación comercial general, el modo recomendado es no POS.

Entrada a la aplicación

Modo	Después de seleccionar contexto
No POS	El usuario entra al dashboard y trabaja con el flujo comercial general.
POS	El usuario entra directamente a una nueva orden para venta rápida.

Datos que vienen de la terminal POS

Dato	Uso
Lista de precios	Define precios para la venta rápida.
Documentos POS	Define documento principal de venta y documento de devolución.
Cliente de caja	Permite operar con cliente plantilla o cliente de caja.
Almacén	Permite consultar disponibilidad asociada a la terminal.
Tipos de pago	Habilitan pago único, multipago y cálculo de vuelto cuando aplica.
Yappy	Habilita pagos Yappy cuando existe configuración.

Impresión POS

Cuando la terminal tiene configuración de impresora POS, PrimApp puede generar un ticket de 80 mm con información fiscal, logo, líneas de encabezado y líneas de pie configurables.

Elemento	De dónde sale
Logo	AD_OrgInfo.Logo_ID, configurado desde información de organización.
Nombre, RUC, DV, dirección, teléfono y correo	Datos de organización y ubicación.
Encabezado adicional	Header1 a Header4 en CDS_POSPrinterConfig.
Pie de ticket	Footer1 a Footer4 en CDS_POSPrinterConfig.

Pagos en caja

En modo POS, el flujo de pago está pensado para caja. Puede existir un solo pago o una combinación de varios medios.

• La suma de pagos debe cubrir el total del documento.
• El efectivo puede generar vuelto cuando el monto entregado supera el total.
• Yappy se puede usar cuando la terminal tiene configuración válida.
• Los pagos registrados forman parte de la operación POS y deben revisarse antes de completar la venta.

Acciones frecuentes en modo POS

Acción	Qué permite
Completar venta	Cerrar el documento cuando productos, cliente y pagos son correctos.
Imprimir ticket	Generar comprobante POS de 80 mm con encabezado y pie configurados.
Compartir PDF	Enviar una versión PDF del documento cuando aplique.
Crear devolución	Usar el documento de devolución configurado para la terminal POS.
Cierre de caja	Revisar y cerrar operaciones asociadas a la caja.

Importante: usa modo POS solo cuando soporte haya confirmado que el POS ID, los tipos de pago, la configuración de impresión y los documentos POS están correctamente configurados.

Cierre de caja

El cierre de caja es una opción disponible solo cuando PrimApp está trabajando en modo POS.

Dónde aparece

Cuando el modo POS está activo, el menú muestra una sección de punto de venta con opciones para cerrar caja y consultar cierres anteriores.

Para qué sirve

El cierre de caja ayuda a consolidar la operación de ventas y pagos registrados durante el turno o periodo de caja.

Opción	Uso
Cerrar caja	Ejecuta el cierre del turno o periodo de caja.
Mis cierres de caja	Permite consultar cierres registrados previamente.

Qué revisar si no aparece

La app debe estar en modo POS.

El POS ID debe ser válido.

El usuario debe tener permisos.

Los procesos de cierre deben estar instalados y configurados en iDempiere.

Nota: si trabajas en modo no POS, esta opción no debería aparecer.

Pagos y Yappy

PrimApp puede trabajar con diferentes medios de pago cuando el ambiente POS está configurado para ello. En ventas POS, los pagos se registran antes de completar el documento y pueden combinarse varios medios de pago en una misma operación.

Medios de pago

Si existen tipos de pago POS configurados, la app permite registrar pagos con uno o varios medios. La lista disponible depende de la terminal POS y de la configuración de iDempiere.

Concepto	Comportamiento
Pago único	El total se registra con un solo medio de pago.
Multipago	El total puede dividirse entre varios medios, por ejemplo efectivo y Yappy.
Validación de total	La suma de pagos debe cubrir el total del documento antes de completar.
Vuelto	Cuando el pago en efectivo supera el total, la app puede mostrar el cambio a entregar.

Yappy

Yappy se usa cuando la terminal POS tiene la configuración necesaria. En ese caso, la app puede generar un QR para que el cliente pague desde Yappy o desde la app de su banco.

Flujo general de Yappy

1. El usuario selecciona Yappy como medio de pago.
2. PrimApp genera el QR.
3. El cliente escanea y paga.
4. La app consulta si el pago fue confirmado.
5. Si el pago se confirma, se registra en el documento.
6. Si forma parte de un multipago, se valida la suma total contra el total del documento.

Datos usados por Yappy

Dato	Uso
CDS_YappyConf_ID	Configuración principal de Yappy asociada a la terminal POS.
CDS_YappyGroup_ID	Grupo o configuración relacionada para procesar pagos.
CDS_YappyReceiptUnit_ID	Unidad o punto de recepción configurado para la operación.
RoutingNo	Referencia de transacción usada para identificar el pago.

Situaciones comunes

Situación	Qué hacer
Pago confirmado	Continuar con el registro del documento.
Pago no completado	Cancelar la operación, volver a consultar o seleccionar otro medio de pago.
La suma de pagos no cubre el total	Agregar otro pago o ajustar montos antes de completar el documento.
Yappy no aparece	Revisar configuración de la terminal POS, tipos de pago y permisos.

Importante: no completes la venta hasta confirmar que los pagos registrados coinciden con el total esperado y que cualquier vuelto en efectivo fue revisado por el cajero.