Manual de Usuario — Portal SAP

Módulo 00 — General

Inicio / Hub

La página de inicio es el punto de entrada al Portal SAP. Muestra todas las herramientas disponibles en una grilla de tarjetas organizadas por categoría. Desde aquí puedes acceder a cualquier módulo con un solo clic y cambiar el tema visual del portal.

01

Abrir el portal

Ingresa la URL del portal en tu navegador. Verás la grilla de tarjetas con todos los módulos disponibles. Cada tarjeta muestra el nombre, descripción breve y categoría del módulo.

02

Seleccionar un módulo

Haz clic sobre cualquier tarjeta para ingresar al módulo. Las tarjetas responden al hover con un efecto de brillo para indicar que son interactivas.

03

Cambiar el tema visual

Usa el botón de luna/sol en la esquina superior derecha para alternar entre modo oscuro y modo claro. La preferencia se guarda en tu navegador y se mantiene entre sesiones.

04

Volver al inicio desde cualquier módulo

Desde cualquier página del portal encontrarás el botón ← Volver en la cabecera superior para regresar al hub principal, o haz clic en el logo / IA Solutions.

Módulo 01 — Administración

Configurar Usuarios

Permite gestionar los usuarios que tienen acceso al Portal SAP. Puedes crear nuevos usuarios, modificar sus datos y controlar sus permisos de acceso a los diferentes módulos del sistema.

01

Ver la lista de usuarios

Al ingresar al módulo verás la tabla con todos los usuarios registrados, incluyendo nombre, correo electrónico, rol asignado y estado de la cuenta (activo / inactivo).

02

Crear un nuevo usuario

Haz clic en + Nuevo Usuario. Completa el formulario con nombre completo, correo electrónico y rol asignado. Confirma con el botón Guardar.

03

Editar un usuario existente

Haz clic en el ícono de edición de la fila correspondiente. Modifica los campos necesarios y guarda los cambios. Los cambios se aplican de inmediato sin necesidad de reiniciar sesión.

04

Desactivar o eliminar un usuario

Usa el toggle de estado para desactivar temporalmente el acceso de un usuario sin eliminarlo, o el botón de eliminar para borrarlo definitivamente del sistema.

⚠️

Importante: Solo los usuarios con rol de Administrador pueden acceder a este módulo. Si no ves la tarjeta en el hub, tu cuenta no tiene los permisos necesarios.

Módulo 02 — Administración

Historial de Accesos

Visualiza el registro de actividad de cada usuario: qué módulos utilizó, cuándo ingresó y las acciones realizadas dentro del portal. Útil para auditoría y seguimiento de uso del sistema.

01

Seleccionar un usuario

Elige el usuario del selector desplegable en la parte superior. El sistema cargará automáticamente su historial de actividad con las últimas sesiones registradas.

02

Filtrar por fecha o módulo

Usa los filtros de rango de fechas y módulo para acotar los resultados al período o herramienta que deseas revisar.

03

Revisar el detalle de cada acceso

Cada fila muestra: fecha y hora de acceso, módulo utilizado, duración de la sesión y acciones principales realizadas durante el uso.

04

Exportar el historial

Haz clic en Exportar para descargar el historial filtrado en formato CSV o PDF para reportes de auditoría.

Módulo 03 — CDS / Analítica

Búsqueda CDS S/4HANA

Permite buscar y explorar las vistas CDS (Core Data Services) disponibles en el sistema S/4HANA. Filtra por nombre, tipo, paquete o módulo funcional y explora las relaciones entre vistas para encontrar exactamente lo que necesitas.

01

Ingresar el término de búsqueda

Escribe en el campo de búsqueda el nombre parcial o completo de la vista CDS. Por ejemplo: I_SalesOrder o simplemente SALES para ver todas las vistas relacionadas con ventas.

02

Aplicar filtros

Refina la búsqueda usando los filtros de tipo de vista (Basic, Composite, Consumption), paquete SAP y módulo funcional (SD, MM, FI, etc.).

03

Explorar los resultados

Los resultados aparecen como tarjetas con el nombre técnico, descripción, tipo de vista y paquete. Haz clic en una tarjeta para ver el detalle completo: campos disponibles y vistas relacionadas.

04

Copiar el nombre para usarlo en otros módulos

Desde el detalle de cualquier vista puedes copiar el nombre técnico al portapapeles para usarlo directamente en el Creador de Reportes, CDS Embebido u otras herramientas del portal.

💡

Tip: Busca por prefijo de capa para encontrar vistas del mismo grupo. I_ = Interface layer, C_ = Consumption layer, P_ = Private layer, Z = vistas personalizadas.

Módulo 04 — CDS / Analítica

CDS Analytics Wizard

Asistente guiado para crear vistas CDS de analítica desde cero. El wizard te conduce paso a paso a través de la configuración necesaria y genera el código ABAP CDS completo, listo para implementar en Eclipse ADT.

01

Elegir el tipo de vista analítica

Selecciona el tipo de vista a crear según el propósito: Básica (datos crudos), Compuesta (combina varias básicas) o Consumo (expuesta al usuario final / OData).

02

Configurar parámetros base

Ingresa el nombre técnico de la vista (obligatoriamente con prefijo Z), la entidad de base sobre la que se construirá y la descripción funcional del objeto.

03

Definir campos y anotaciones

Selecciona los campos que formará la vista y configura sus anotaciones de analítica, UI y control de acceso. El wizard sugiere las anotaciones más comunes según el tipo de campo.

04

Generar y copiar el código

El wizard genera automáticamente el código ABAP CDS completo. Cópialo con un clic y pégalo en Eclipse ADT para crear el objeto en tu sistema de desarrollo SAP.

💡

Tip: Antes de generar, usa el módulo Búsqueda CDS para confirmar que no existe ya una vista estándar que cubra tu necesidad — reutilizar vistas SAP ahorra tiempo y mantenimiento.

Módulo 05 — CDS / Analítica

CDS Analítica Embebida

Herramienta de 6 pasos para crear vistas CDS con analítica embebida (Embedded Analytics) para S/4HANA. Genera el código completo con anotaciones @Analytics, @UI y @AccessControl listas para activar en el sistema.

01

Paso 1 — Identificación del CDS

Define el nombre técnico (prefijo Z), la descripción funcional y el paquete de desarrollo donde se almacenará la vista en el repositorio ABAP.

02

Paso 2 — Código fuente base

Pega el código fuente del CDS de origen o búscalo directamente en el módulo Búsqueda CDS. Esta será la vista sobre la que se construirá la analítica embebida.

03

Paso 3 — Selección de campos

El sistema detecta automáticamente los campos disponibles del CDS de origen. Selecciona cuáles incluir y clasifícalos como dimensiones (textos / claves) o medidas (valores numéricos).

04

Paso 4 — Anotaciones de cabecera

Configura: @Analytics.dataCategory, @AccessControl.authorizationCheck, @UI.headerInfo, @UI.chart y @UI.presentationVariant.

05

Paso 5 — Anotaciones por campo

Para cada campo seleccionado configura sus anotaciones individuales: @UI.lineItem, @UI.selectionField y propiedades de agrupación/agregación para la analítica.

06

Paso 6 — CDS generado

Revisa el código final. Puedes copiarlo al portapapeles o descargarlo como archivo .cds para importarlo en Eclipse ADT. Los pasos completados quedan marcados en verde en la barra de progreso.

💡

Tip: Puedes navegar libremente entre pasos usando la barra de progreso superior o el panel lateral del wizard. No es necesario completarlos en orden estricto.

Módulo 06 — Reportes

Creador de Reportes

Genera el esqueleto de código ABAP para reportes SAP de forma asistida. Elige el tipo de reporte, configura los parámetros, selecciona una plantilla rápida y obtén el código listo para continuar el desarrollo en el sistema ABAP.

01

Completar los parámetros del reporte

Ingresa el nombre del programa ABAP (con prefijo Z o Y), el título funcional, la descripción y si el reporte se basa en una vista CDS o en tablas ABAP directas.

02

Seleccionar una plantilla rápida

Elige entre las plantillas disponibles: Reporte ALV simple, ALV con jerarquía, Reporte de variantes o Reporte Fiori. La plantilla preconfigura la estructura del código automáticamente.

03

Generar el código ABAP

Haz clic en Generar Reporte. El sistema produce el código ABAP con la estructura del programa, pantalla de selección, declaraciones de tipos y la lógica base del ALV o Fiori.

04

Copiar o descargar

Usa Copiar código para llevar el resultado al portapapeles o Descargar para obtenerlo como archivo .abap e importarlo en SE38 o Eclipse ADT.

Módulo 07 — Reportes / Fiori

Generador Fiori Elements

Asistente para generar la configuración de aplicaciones SAP Fiori Elements sobre vistas CDS. Produce las anotaciones UI, el metadata extension y la configuración del servicio OData necesarios para desplegar la aplicación.

01

Seleccionar el tipo de aplicación Fiori

Elige el floorplan según el caso de uso: List Report (listados con filtros), Object Page (detalle de un registro), Analytical List (KPIs + tabla) o Overview Page (dashboard).

02

Configurar la vista CDS base

Ingresa el nombre de la vista CDS de consumo sobre la que se construirá la app Fiori y configura las propiedades del servicio OData (nombre, versión, scope de entidad).

03

Configurar webhook n8n (opcional)

Si la aplicación requiere lógica de automatización al guardar o aprobar registros, ingresa la URL del webhook de n8n que procesará los eventos.

04

Generar y descargar los artefactos

El sistema genera los archivos de configuración. Descárgalos e impórtalos en tu proyecto SAP BTP Fiori o en el sistema ABAP usando las herramientas de desarrollo SAP.

Módulo 08 — ABAP / IA

Revisión de Programas ABAP

Analiza programas ABAP con Inteligencia Artificial. Sube un archivo ZIP con el código fuente y recibe un informe detallado de calidad, seguridad, rendimiento y sugerencias de mejora específicas para cada hallazgo.

01

Preparar el archivo ZIP

Exporta el programa ABAP desde Eclipse ADT o la transacción SE38 y comprímelo en un archivo .zip. Puedes incluir un programa principal junto con todos sus includes en el mismo ZIP.

02

Subir el archivo

Arrastra el archivo ZIP al área de carga punteada o haz clic sobre ella para buscar el archivo en tu equipo. El sistema validará el formato automáticamente antes de continuar.

03

Iniciar el análisis

Haz clic en Analizar. La IA procesa el código fuente en la nube. El análisis tarda entre 30 y 90 segundos según el tamaño del programa.

04

Revisar el informe de resultados

El informe clasifica los hallazgos por severidad: 🔴 Crítico, 🟡 Advertencia, 🔵 Informativo. Cada hallazgo incluye número de línea, descripción del problema y sugerencia de corrección concreta.

05

Guardar el informe

Descarga el informe completo como PDF o cópialo como texto para incluirlo en la documentación técnica del proyecto de desarrollo.

💡

Tip: Para mejores resultados incluye el programa principal junto con todos sus includes y formularios en el mismo ZIP. El análisis es más preciso cuando tiene el contexto completo del código.

Módulo 09 — ABAP / Errores

Analizador Dump ST22

Analiza volcados de error (short dumps) de la transacción SAP ST22 usando Inteligencia Artificial. Sube el dump en formato ZIP y obtén una explicación clara de la causa raíz, el impacto y los pasos concretos para resolver el error.

01

Exportar el dump desde ST22

En el sistema SAP ve a la transacción ST22, selecciona el dump que deseas analizar y usa la función de exportación (botón "Exportar" o menú Sistema → Lista → Grabar). Guarda el archivo y comprímelo en formato .zip.

02

Subir el archivo ZIP

Arrastra el archivo al área de carga punteada o haz clic para buscar el archivo en tu equipo. El módulo acepta dumps individuales o múltiples dumps agrupados en un solo ZIP.

03

Iniciar el análisis con IA

Haz clic en Analizar Dump. La IA interpreta el contenido del dump e identifica el tipo de error: excepción ABAP, problema de memoria, error SQL, etc.

04

Leer el diagnóstico

El diagnóstico incluye: tipo de excepción, programa y objeto afectado, causa probable del error y pasos de corrección recomendados. Cuando aplica, incluye referencias a notas SAP relacionadas.

💡

Tip: Si el dump ocurrió durante un trabajo batch, incluye también el log del job en el ZIP para que la IA tenga mayor contexto y pueda dar un diagnóstico más preciso.

Módulo 10 — Integración OData

API OData VTAD

Interfaz para consultar datos de cabecera de documentos SAP SD mediante el servicio OData VTAD. Permite buscar documentos por patente o matrícula, visualizar los datos principales del registro y acumular consultas para análisis posterior.

01

Ingresar la patente o clave de búsqueda

Escribe la patente del vehículo en el campo de búsqueda superior. El campo acepta caracteres alfanuméricos y los convierte automáticamente a mayúsculas. Puedes usar el contador de patentes consultadas a la derecha.

02

Ejecutar la consulta

Presiona Enter o el botón Buscar. El sistema consulta el servicio OData de SAP en tiempo real. El resultado aparece en el panel de detalle derecho en pocos segundos.

03

Revisar el detalle del documento

El panel derecho muestra los campos del documento: número, fecha, cliente, material, cantidad y estado. Los valores se presentan formateados según el tipo de dato SAP correspondiente.

04

Acumular y exportar registros

Haz clic en Agregar a lista para guardar el registro actual en la tabla de registros acumulados. Al finalizar, puedes exportar todos los registros acumulados juntos en un archivo Excel.

ℹ️

Nota: Este módulo requiere conectividad con el sistema SAP S/4HANA. Si aparece un error de conexión, verifica que el servicio OData VTAD esté activo en la transacción /IWFND/MAINT_SERVICE.

Módulo 11 — Integración OData

Historial VTAD

Registro histórico de todas las consultas realizadas en el módulo API OData VTAD. Permite buscar, filtrar y exportar el historial de búsquedas por fecha, usuario o patente consultada para auditoría y trazabilidad.

01

Ver el historial completo

Al ingresar verás la tabla con todas las consultas registradas, ordenadas de la más reciente a la más antigua, con columnas de fecha, usuario, patente consultada y resultado obtenido.

02

Filtrar por fecha o patente

Usa el rango de fechas para acotar el período y el campo de búsqueda por patente para encontrar consultas específicas dentro del historial completo.

03

Exportar el historial

Descarga el historial filtrado en formato Excel o PDF con el botón Exportar en la esquina superior derecha de la tabla de resultados.

Módulo 12 — IA / Facturas

Agente RAG Facturas

Asistente de Inteligencia Artificial con tecnología RAG (Retrieval Augmented Generation) para consultas sobre facturas. Escribe preguntas en lenguaje natural y el agente responde con información extraída directamente de los documentos, citando la fuente exacta de cada dato.

01

Hacer una pregunta

Escribe tu consulta en el campo de texto inferior y presiona Enter o el botón de envío. Las preguntas pueden ser sobre montos, proveedores, fechas, estados de pago o cualquier dato contenido en las facturas.

02

Leer la respuesta

El agente busca en la base de documentos y responde con los datos relevantes, citando las fuentes (número de factura, fecha, proveedor) para que puedas verificar la información directamente.

03

Continuar la conversación

Puedes hacer preguntas de seguimiento sobre los mismos datos o consultar otras facturas. El agente mantiene el contexto de la conversación activa para respuestas más precisas.

04

Iniciar una nueva sesión

Usa Nueva Conversación para limpiar el historial del chat y comenzar una consulta completamente independiente sobre un tema diferente.

💡

Tip: Las preguntas específicas dan mejores resultados. En vez de "muéstrame facturas", prueba con "facturas del proveedor XYZ con monto mayor a $500.000 emitidas en junio 2025 que estén pendientes de pago".

Módulo 13 — IA / Facturas

Dashboard Facturas

Panel de análisis visual del portafolio de facturas con gráficos interactivos y métricas clave (KPIs). Visualiza tendencias de pago, distribución por proveedor, alertas de vencimiento y evolución histórica de montos.

01

Seleccionar el período de análisis

Usa el selector de período en el panel lateral izquierdo para filtrar todo el dashboard: mes actual, trimestre, año o rango de fechas personalizado.

02

Revisar los indicadores KPI

Las tarjetas superiores muestran: total de facturas, monto total, facturas pendientes de pago, facturas vencidas y pagadas. El porcentaje de variación respecto al período anterior aparece en verde (mejora) o rojo (deterioro).

03

Analizar los gráficos

Los gráficos de barras y líneas muestran la evolución de montos y volumen de facturas en el tiempo. Posiciona el cursor sobre cualquier punto del gráfico para ver el detalle exacto del período.

04

Usar el análisis IA por sección

Cada sección del dashboard tiene un botón de análisis IA que abre un panel de chat para hacer preguntas específicas sobre los datos que estás viendo en ese momento.

Módulo 14 — Automatización

N8N Dashboard

Panel de control para monitorear y gestionar los flujos de automatización n8n integrados con el Portal SAP. Visualiza el estado de los workflows, historial de ejecuciones y errores en tiempo real sin necesidad de acceder directamente a la interfaz de n8n.

01

Ver el estado de los workflows

La pantalla principal muestra todos los workflows n8n configurados, con su estado actual: 🟢 Activo, 🟡 En pausa, 🔴 Error, y la fecha y hora de la última ejecución.

02

Revisar las ejecuciones recientes

La sección de historial muestra las últimas ejecuciones de cada workflow con el resultado: exitosa (verde), fallida (rojo) o en curso (naranja parpadeante).

03

Activar o pausar un workflow

Usa el toggle de cada workflow para activarlo o pausarlo desde el portal, sin necesidad de entrar a la interfaz de n8n. Los cambios se aplican inmediatamente en el servidor.

04

Ver el detalle de errores

Haz clic en cualquier ejecución fallida para ver el log completo: nodo que falló, mensaje de error y timestamp exacto para facilitar el diagnóstico y la corrección del workflow.

⚠️

Nota: Este módulo requiere que el servidor n8n esté activo y accesible. Si aparecen errores de conexión, verifica primero el estado del servidor en el módulo VPS Status.

Módulo 15 — Infraestructura

VPS Status

Monitor en tiempo real del servidor VPS (Hostinger) que aloja los servicios del portal. Muestra métricas de CPU, memoria RAM, disco y red, además del estado individual de los servicios principales como n8n y Nginx.

01

Leer el resumen de estado general

Los indicadores superiores muestran el estado general del servidor: 🟢 Operativo, 🟡 Advertencia (recursos elevados), 🔴 Falla o servicio caído. Una mirada rápida a estos indicadores es suficiente para saber si el servidor está funcionando correctamente.

02

Monitorear el uso de recursos

Las tarjetas de métricas muestran en tiempo real: CPU (%), memoria RAM utilizada vs. total disponible, espacio en disco y tráfico de red entrante/saliente del servidor.

03

Verificar el estado de los servicios

La lista de servicios indica cuáles están activos y cuáles detenidos. Si un servicio clave (n8n, Nginx, base de datos) aparece como inactivo, contacta al administrador del sistema para reiniciarlo.

04

Actualizar las métricas

Las métricas se actualizan automáticamente cada 30 segundos. Puedes forzar una actualización inmediata con el botón Refrescar para ver el estado actual sin esperar el ciclo automático.

Módulo 16 — Infraestructura

Ubuntu OS Update

Gestiona las actualizaciones del sistema operativo Ubuntu del servidor VPS directamente desde el portal, sin necesidad de conexión SSH. Muestra los paquetes con actualizaciones disponibles y permite aplicarlas de forma controlada y segura.

01

Buscar actualizaciones disponibles

Haz clic en Buscar actualizaciones. El sistema ejecuta apt update en el servidor y lista todos los paquetes que tienen una versión más reciente disponible.

02

Revisar los paquetes

La lista muestra cada paquete con su versión actual y la versión disponible. Los paquetes de seguridad se destacan con un indicador especial — prioriza su instalación para mantener el servidor protegido.

03

Aplicar las actualizaciones

Selecciona los paquetes que deseas actualizar (o usa Seleccionar todo) y haz clic en Actualizar. El proceso puede demorar varios minutos según la cantidad y tamaño de los paquetes.

04

Verificar el log de instalación

Al finalizar, el log muestra el resultado de cada paquete instalado. Los errores aparecen en rojo con el mensaje detallado del sistema operativo para facilitar la resolución de problemas.

⚠️

Precaución: Aplica actualizaciones en horario de baja carga del sistema (fuera de horario laboral). Algunos paquetes del kernel requieren reinicio del servidor, lo que dejará los servicios inaccesibles temporalmente durante el proceso.

Módulo 17 — Propuesta

Automatización SAP SD

Propuesta de integración para automatizar procesos del módulo SAP SD (Sales & Distribution) con Inteligencia Artificial. Presenta el análisis de procesos candidatos, la arquitectura de solución, beneficios esperados y el plan de implementación por fases.

01

Revisar el análisis de procesos actuales

La primera sección describe los procesos del módulo SD que son candidatos a automatización: creación de pedidos de venta, determinación de precios y condiciones, gestión de entregas y facturación a clientes.

02

Explorar la arquitectura de solución

La sección de solución detalla la arquitectura técnica propuesta: integración entre SAP SD, el Portal IA y los workflows de n8n para procesar eventos SAP y generar respuestas automatizadas.

03

Consultar los beneficios y ROI esperado

La sección de beneficios presenta las métricas de eficiencia proyectadas: reducción de tiempos de procesamiento, disminución de errores manuales y ahorro estimado de horas de trabajo mensual.

04

Ver el plan de implementación

El roadmap presenta las fases del proyecto con duración estimada, entregables concretos por fase y criterios de aceptación para validar cada hito antes de avanzar.

📋

Nota: Este módulo es una propuesta informativa. Para iniciar el proyecto de automatización SAP SD, contacta al equipo de implementación para coordinar el levantamiento técnico inicial con el sistema cliente.

Manualde Usuario