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 Selecciona el tipo de documento comercial. Elige el cliente. Agrega los productos. Revisa cantidades, precios, descuentos, impuestos y totales. Selecciona la acción del documento. Guarda el documento como borrador o complétalo según permisos. 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. El usuario abre el documento original desde el listado o detalle de pedidos. PrimApp valida que exista configuración POS y documento de devolución. El usuario inicia la devolución desde la acción disponible. La app prepara una nueva operación con el tipo de documento de devolución POS. El usuario revisa líneas, cantidades y totales antes de completar. 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. El usuario abre una orden completa desde pedidos. PrimApp revisa si existe una factura relacionada. Si corresponde, muestra la acción para crear nota de crédito. La app ejecuta el proceso de iDempiere para crear la nota de crédito. 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. Abre el menú de configuración. Entra a la tarjeta de información de organización. Selecciona el logo actual o la opción para cambiarlo. Elige cámara o galería. Recorta la imagen si es necesario. 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.