Maqueta arquitectónica del mundo de una empresa en la hora azul. Un hilo de luz verde lima traza la ruta de un pedido por sus distritos.

Documentación de procesos y código a medida para SAP

Cómo opera su negocio en SAP, documentado con pruebas.

Una exportación de solo lectura de su sistema SAP se convierte en documentación de cómo funcionan sus procesos: qué los inicia, qué tablas leen y modifican, a qué interfaces llegan y qué código a medida los sostiene. Cada línea factual está citada. Sus expertos confirman el propósito de negocio.

Una página del catálogo generada sin IA a partir de nuestro sistema de demostración sintético.

  • Exportación de solo lectura
  • Grafo de evidencias
  • Catálogo con citas
  • Acceso a la app web
Siga un pedido de cliente

Recorrido · 7 min

Conozca la aplicación en siete minutos.

Un recorrido narrado por cada parte de la aplicación: el resumen, el mapa del sistema, los documentos de proceso con citas, Preguntar a la IA, las interfaces y el plan de migración a S/4HANA.

7 min · narración en español · subtítulos · demostración con datos sintéticos

En resumen

  1. Solo lectura

    Un reporte de exportación, instalado sin transporte. Sin datos transaccionales ni nombres de usuario.

  2. Citado

    Cada línea factual lleva una cita a la evidencia que la respalda.

  3. Verificado

    En el piloto: 13.480 relaciones con evidencia verificada y 0 fallos al revalidar cada relación.123

  4. Confirmado

    Los documentos de proceso se publican solo cuando su experto en la materia da su aprobación formal.

Notas sobre las cifras del piloto

  1. 1

    Piloto: un sistema SAP S/4HANA productivo. Análisis automático, revalidado sin fallos.

  2. 2

    Cada relación guarda archivo, línea y nivel de confianza.

  3. 3

    “0 fallos” significa que cada relación se revalidó contra su línea o fila citada. No demuestra que una interpretación de negocio sea correcta; para eso está la aprobación formal del experto.

La misma maqueta de noche, con las luces apagadas: solo unas pocas ventanas están iluminadas y no se ve ninguna ruta.

01El problema

Sin documentación, cada decisión sobre un proceso es una suposición.

Sus procesos se apoyan en el estándar SAP y en lo que su empresa construyó alrededor de él: código a medida, configuración, jobs e interfaces. Las preguntas están en esa segunda parte.

  1. El conocimiento está en pocas cabezas.

    Los consultores se van, los usuarios clave cambian de puesto y la documentación nunca existió o está desactualizada.

  2. Cada cambio es un riesgo.

    “¿Quién más escribe en esta tabla?” o “¿Qué pasa cuando llega este IDoc?” cuestan días de análisis de un experto senior.

  3. Los grandes proyectos arrancan a ciegas.

    SAP S/4HANA, clean core, un cambio de AMS o una auditoría empiezan con un inventario manual.

A continuación: un pedido de cliente, etapa por etapa, con la evidencia detrás de cada paso.

02Descubrimiento de procesos

Siga un pedido de cliente por el sistema.

El descubrimiento de procesos parte de lo que su sistema SAP ya contiene: el código, la configuración, las transacciones y los jobs que hay detrás de cada proceso. A continuación, seis etapas de un pedido de cliente en nuestro sistema de demostración sintético, cada una con la evidencia que la respalda. Las etiquetas con enlace abren la línea o la fila exacta en nuestras páginas de ejemplo públicas.

Ilustración: una maqueta del mundo de una empresa; el hilo verde lima representa la ruta del pedido.

Un pedido de cliente, del IDoc de entrada a la actualización del estado

Sistema de demostración sintético

  1. Etapa 1 de 6

    Llega el pedido

    El tipo de mensaje IDoc ORDERS, de entrada, es procesado por ZSD_ORDER_IDOC_IN, que llama a ZSD_ORDER_CREATE.

  2. Etapa 2 de 6

    Control de crédito

    ZSD_ORDER_CREATE llama a ZSD_ORDER_CHECK_CREDIT, que lee ZSD_CREDIT_LIM (Customer credit limits).

  3. Etapa 3 de 6

    Pedido creado

    ZSD_ORDER_CREATE llama a BAPI_SALESORDER_CREATEFROMDAT2. El índice de la lista de utilización de SAP registra la misma llamada.

  4. Etapa 4 de 6

    Canal y estado registrados

    ZSD_ORDER_CREATE inserta en ZSD_ORDER_LOG (Sales order channel and status log).

  5. Etapa 5 de 6

    Etiqueta de picking impresa

    La transacción ZWM_LABEL (Print picking labels) inicia ZWM_PICK_LABEL, que lee ZSD_ORDER_LOG.

  6. Etapa 6 de 6

    Estado actualizado

    ZSD_ORDER_STATUS_UPDATE actualiza ZSD_ORDER_LOG. Es llamado en tarea de actualización desde tres lugares: el include de exit de usuario MV45AFZZ, el dynpro de la transacción ZSD_STATUS y ZWM_PICK_LABEL.

Punto no resuelto

CALL FUNCTION gv_fm en ZWM_PICK_LABEL: el nombre de la función se calcula en tiempo de ejecución. Queda listado en Cobertura; nunca se adivina.

Ilustración de nuestro sistema de demostración sintético. Cada afirmación reformula líneas de su catálogo, generado sin IA, con sus etiquetas de cita. Los nombres de las etapas y su orden se agregaron para esta página. Las etiquetas con enlace abren la línea o la fila exacta en las páginas de ejemplo. Las etiquetas GRAPH nombran una relación registrada y no tienen una página propia.

03Flujo del proceso

Un flujo para cada proceso.

En la app web, cada proceso tiene su flujo del proceso: cómo se inicia, cada paso en el orden del código, qué llama fuera del proceso, las tablas que usa y las interfaces a las que llega. Se construye a partir del grafo de evidencias, sin IA, con una cita en cada paso. Una capa muestra sus procesos vecinos: aquellos de los que viene y aquellos en los que continúa.

IlustraciónLa etapa 5 de la ruta, abierta como flujo del proceso

El flujo del proceso detrás de la etapa 5: etiquetas de picking

Objetos de este proceso Programa ZWM_PICK_LABEL

Viene deGrupo de funciones ZSD_ORDERZSD_ORDER_CREATE escribe en ZSD_ORDER_LOG, que este proceso lee.
  1. La transacción ZWM_LABEL inicia el programa ZWM_PICK_LABEL.

    • EXPORT:cg_transactions.tsv:15

    Iniciado porZWM_LABELTransacción · Print picking labels

  2. ZWM_PICK_LABEL lee ZSD_ORDER_LOG.

    DatosZSD_ORDER_LOGTabla

  3. Llama a un módulo de funciones cuyo nombre se decide en tiempo de ejecución (CALL FUNCTION gv_fm): un punto no resuelto, que nunca se adivina.

    Llamado fuera del procesogv_fmMódulo de funciones decidido en tiempo de ejecución

  4. Llama a ZSD_ORDER_STATUS_UPDATE en tarea de actualización.

    Llamado fuera del procesoZSD_ORDER_STATUS_UPDATEMódulo de funciones de otro proceso · tarea de actualización

Continúa enGrupo de funciones ZSD_ORDEREste proceso llama a ZSD_ORDER_STATUS_UPDATE, que actualiza ZSD_ORDER_LOG.
Ilustración dibujada para esta página a partir de la ruta verificada de nuestro sistema de demostración sintético; no es una captura de la app web. Muestra pasos seleccionados del flujo que inicia la transacción ZWM_LABEL; la agrupación en procesos se agregó para esta página. El flujo en la app web tiene más pasos; esta ilustración muestra cuatro.

Límite declarado. Los pasos siguen el orden de las líneas del código fuente; las condiciones y los bucles no se evalúan. Las llamadas que se deciden en tiempo de ejecución quedan listadas como puntos no resueltos; nunca se adivinan. No se muestra lo que hacen por dentro los módulos de funciones y las BAPI de SAP.

El flujo del proceso, en detalle

04Proceso y código

Un mismo hecho, dos lecturas.

Un responsable del proceso lee una etapa del pedido. Un desarrollador lee la línea de código que la respalda. Ambos leen la misma evidencia, con la misma cita.

Fotografía macro: un hilo verde lima une una línea resaltada de un reporte impreso con un alfiler en un diagrama de procesos.
Tres etapas del pedido de cliente, cada una leída como paso del proceso y como la línea de código que la respalda
Lectura del procesoLectura del código
Llega el pedidoEl tipo de mensaje IDoc ORDERS, de entrada, es procesado por ZSD_ORDER_IDOC_IN, que llama a ZSD_ORDER_CREATE.
Módulo de funciones ZSD_ORDER_IDOC_INLínea 34 del include LZSD_ORDERU03CALL FUNCTION 'ZSD_ORDER_CREATE'
Canal y estado registradosZSD_ORDER_CREATE inserta en ZSD_ORDER_LOG (Sales order channel and status log).
Módulo de funciones ZSD_ORDER_CREATELínea 55 del include LZSD_ORDERU01INSERT zsd_order_log FROM ls_log.
Estado actualizadoZSD_ORDER_STATUS_UPDATE actualiza ZSD_ORDER_LOG.
Módulo de funciones ZSD_ORDER_STATUS_UPDATELínea 8 del include LZSD_ORDERU04UPDATE zsd_order_log SET status = iv_status

De nuestro sistema de demostración sintético. Las líneas de código se citan tal como se exportaron, numeradas como en el editor ABAP (SE80). Los nombres de las etapas se agregaron para esta página.

Cinco etiquetas y un marcador, cada uno con un solo significado

CODE
La línea exacta de su código fuente ABAP o CDS, numerada como en el editor ABAP (SE80).
GRAPH
Una relación registrada, como “este programa lee esa tabla”, siempre acompañada de la línea de código o de la fila exportada de la que proviene.
SCHEMA
La definición del Diccionario ABAP: una tabla, un campo, un elemento de datos, un dominio o un mensaje.
EXPORT
Una fila de un archivo exportado: la configuración, el índice de la lista de utilización (where-used) de SAP, la lista de transacciones o de jobs, o el inventario de objetos y paquetes.
INFERRED
Una deducción o un límite declarado, marcado claramente como algo que no es evidencia.
SME-REVIEW-REQUIRED
Una pregunta para su experto en la materia cuando la evidencia no es suficiente. Nunca se completa adivinando.

Un script determinista, no una IA, confirma que cada etiqueta apunta a evidencia real que coincide con ella.

Límite declarado. Una verificación superada demuestra que cada cita coincide con su evidencia, no que una interpretación de negocio sea correcta. Para eso está la aprobación formal de su experto.

Abrir la línea 55 en el ejemplo

05Qué documenta

Dos caminos a la misma evidencia.

Los responsables de procesos y los analistas parten de los procesos de negocio. Los desarrolladores y los arquitectos parten de los objetos. Unos y otros leen documentación construida a partir del mismo grafo de evidencias, con las mismas citas.

Documentación de procesos de negocio

Cómo funciona cada proceso, de lo que lo inicia a lo que modifica.

Su código a medida, agrupado por área de negocio y en procesos de negocio, cada uno anclado en lo que lo inicia. Luego, los documentos de proceso describen un proceso de principio a fin, para que sus expertos los confirmen y den su aprobación formal.

  • Áreas de negocio: qué inicia cada una, a qué otras áreas llama y qué tablas lee y modifica.
  • Un mapa de procesos propuesto a partir de la evidencia: el código a medida agrupado en procesos de negocio sin IA, con nombres tomados de textos registrados en SAP.
  • Qué inicia cada proceso: transacciones, jobs de fondo, configuración como IDoc y formatos de soporte de pago, y el código SAP que llama al suyo.
  • El flujo de cada proceso: cada paso en el orden del código, las tablas que usa y las interfaces a las que llega, con una cita en cada paso.
  • Documentos de proceso en ocho secciones fijas, desde los flujos del proceso y las reglas de negocio hasta las historias de usuario y una lista de verificación de validación.
  • La aprobación formal de su experto en la materia, que publica el documento.
El lado de los procesos, vista por vista
Código propio por área de negocio: el mapa del sistema con su título, el diagrama de dependencias entre áreas y la lista de áreas.
Pantallas de un sistema de demostración sintético.

Documentación de código a medida

Su código a medida, objeto por objeto, hasta la línea citada.

Una página con citas por objeto, generada sin IA: cómo se inicia, qué llama, quién lo llama y qué tablas lee y modifica.

  • Un catálogo con una página por módulo, módulo de funciones, transacción, job y tabla, generado sin IA.
  • Dónde se usa cada objeto (where-used), en ambas direcciones: quién llama a su código desde SAP y qué referencia su código.
  • Puntos de entrada: todas las formas en que se inicia el código a medida, desde transacciones y jobs hasta el procesamiento de IDocs, los BAdI y los exits de usuario.
  • Impacto de un cambio: tabla, programa, job y transacción, con la línea de código de cada paso.
  • Un visor de código fuente que resalta la línea citada, numerada como en el editor ABAP (SE80); un panel lateral abre cada fila exportada citada.
  • Las llamadas dinámicas, el SQL dinámico y los destinos fuera de la exportación quedan listados como puntos no resueltos; nunca se fuerzan dentro del grafo.
El lado del código, vista por vista
Código del include LZSD_ORDERU01, numerado como en SE80, con las líneas citadas marcadas y la línea 55, INSERT zsd_order_log FROM ls_log., resaltada.
Pantallas de un sistema de demostración sintético.

06En la app web

Qué más muestra cada proceso.

Más allá del flujo: quién usa cada tabla, qué interfaces existen y cómo se confirma un documento de proceso.

  • Matriz de uso de datos: objetos propios en filas, tablas en columnas y C, R, U o D en la celda cuando el objeto inserta, lee, actualiza o borra datos en esa tabla.
    Uso de datos. C, R, U o D en una celda cuando un objeto inserta, lee, actualiza o borra datos en esa tabla. Pantallas de un sistema de demostración sintético.

    Uso de datos, tabla por tabla

    Una matriz muestra qué código a medida inserta, lee, actualiza o borra datos en cada tabla, con un clic hasta las líneas de código exactas. En nuestro sistema de demostración sintético, la página de la tabla ZSD_ORDER_LOG lista siete sentencias de base de datos: dos inserciones, cuatro lecturas y una actualización.

  • Pasarelas elevadas de vidrio entre torres de oficinas, de noche, iluminadas por dentro.

    Interfaces y canales

    Canales agrupados según lo que hacen: lo que sale del sistema SAP, lo que se ejecuta más tarde, lo que registra en el estándar SAP y dónde hay acoplamiento oculto. Se clasifican como IDoc, RFC, BAPI, batch input, tarea de actualización, HTTP, archivo, memoria compartida, pago y BAdI, y cada uno muestra el número de objetos a medida que lo usan.

  • Un responsable del proceso firma un documento de validación encuadernado.

    Validación y aprobación

    Un documento de proceso (Paquete de validación) describe un proceso de principio a fin en ocho secciones fijas. Tres controles automáticos se ejecutan antes de que lo vea su experto, y ninguno se puede omitir ni dar por superado. Su experto en la materia confirma los puntos marcados SME-REVIEW-REQUIRED y da su aprobación formal, con lo que el documento queda publicado.

07Cómo funciona

De un reporte de solo lectura a documentación verificable por sus equipos.

Cuatro pasos. Cada uno produce algo que usted puede abrir e inspeccionar.

  1. ExportarUn reporte ABAP de solo lectura, instalado como objeto local en unos 5 minutos, sin transporte. Lee código, definiciones del diccionario y configuración, y no lee datos transaccionales ni nombres de usuario.
  2. Grafo de evidenciasCada relación guarda archivo, línea y nivel de confianza, y queda etiquetada según cómo se estableció. Lo que no se puede resolver se lista; no se fuerza en el grafo.
  3. VerificarUn verificador del grafo revalida cada relación contra su línea de código o fila exportada. Un auditor de citas determinista vuelve a comprobar cada etiqueta. Sin IA en este paso.
  4. Documentar y confirmarEl catálogo y el mapa de procesos se generan sin IA y se ofrecen en una app web en español, inglés y portugués. Luego vienen los documentos de proceso, redactados con IA solo bajo su autorización registrada y publicados cuando su experto da su aprobación formal.

Piloto

1 día de la exportación a la documentación4

  1. 4

    “1 día” cubre de la exportación a la documentación; los documentos de proceso llevan más tiempo. Abarca el grafo de evidencias, el catálogo y la app web. Los Paquetes de validación requieren ejecuciones de IA y la aprobación formal del experto.

Cómo funciona, paso a paso

08Para quién es

Qué recibe cada equipo.

Negocio

  • Responsable del proceso

    Su proceso, descrito de principio a fin en un documento de proceso, con las preguntas abiertas marcadas para usted. Su aprobación formal lo publica.

  • Analista funcional

    Qué inicia cada proceso, qué tablas lee y modifica y a qué interfaces llega, cada dato con su evidencia. La función Preguntar a la IA responde preguntas en lenguaje natural, con evidencia numerada.

  • Auditoría y cumplimiento

    Qué código escribe en tablas de pagos y finanzas, qué objetos de autorización verifica y qué interfaces existen, cada dato con su cita.

  • Líder de transformación SAP S/4HANA

    Un inventario por área de negocio y por proceso: qué existe, cómo se ejecuta y de qué depende, para que el alcance de la remediación se apoye en datos.

TI

  • Líder de CoE SAP y TI

    Cada objeto a medida inventariado, un registro de cobertura que compara lo documentado con lo exportado y una reconstrucción revalidada después de cada nueva exportación.

  • Desarrollador ABAP y equipo AMS

    Dónde se usa cada objeto (where-used) en ambas direcciones, árboles de llamadas, puntos de entrada y el impacto de un cambio, cada uno hasta la línea citada. Documentación de traspaso verificable.

Una sala de planificación de la migración, con las paredes cubiertas de tarjetas agrupadas por área de negocio.

Tres momentos en que todos necesitan los mismos datos.

  1. SAP S/4HANA y clean core

    Qué existe, cómo se ejecuta y de qué depende: un menor alcance de remediación y decisiones basadas en datos.

  2. Traspaso de AMS

    La documentación de traspaso ya existe y es verificable, así que un proveedor entrante puede comprobar lo que recibe.

  3. Auditoría y cumplimiento

    Qué código escribe en tablas de pagos y finanzas, qué autorizaciones controla y qué interfaces hay. Para lectores externos a su empresa, como auditores externos, el visor de código fuente puede ocultar nombres e ID de usuario.

Estos beneficios son cualitativos. No los hemos medido en porcentajes, horas ni retorno de la inversión.

Ver los cinco casos de uso

09Seguridad y datos

Solo lectura por diseño. IA solo con su autorización.

Para sus equipos de seguridad y de protección de datos, explicado con claridad. Sin sellos que no tengamos.

Seguridad y datos, en detalle
  • Exportación de solo lectura

    Un reporte ABAP, instalado como objeto local, sin transporte. No contiene ningún INSERT, UPDATE, MODIFY, DELETE ni COMMIT sobre la base de datos, y necesita autorizaciones de visualización y permiso para escribir sus archivos de exportación.

  • Sin datos transaccionales ni nombres de usuario

    Lee código, definiciones del diccionario y configuración; nunca pedidos, facturas ni contabilizaciones. Se eliminan las columnas de autor y de última modificación, y cualquier otra columna con nombres de usuario.

  • IA solo con su autorización registrada

    El grafo, el catálogo y el mapa de procesos se construyen sin IA. Los documentos de proceso y la función Preguntar a la IA solo se ejecutan con su autorización explícita y registrada; esta última está desactivada de forma predeterminada. Antes de cualquier paso de IA, se ocultan los datos personales de los comentarios y las cadenas.

  • Inicio de sesión obligatorio

    Cada página y cada API de la app web requieren iniciar sesión. Un administrador crea las cuentas; no hay autorregistro.

Una caja de archivo sellada y una unidad de disco, atadas con un hilo verde lima.

10Idiomas

Documentación en español, inglés y portugués.

La app web y el catálogo están disponibles en español, inglés y portugués, al igual que las demostraciones y el soporte.

  • Los nombres de objetos SAP y el código, los nombres de tablas y campos, las etiquetas de cita y los textos exportados de SAP nunca se traducen.
  • Los documentos de proceso se redactan y pasan los controles en inglés. La versión en español es una traducción automática, que se marca como verificada solo cuando se confirma que cada cita, fragmento de código, cifra y tabla se mantiene sin cambios y un modelo revisor comprueba el significado.
Un equipo multilingüe en una sala de reuniones de São Paulo, en la hora dorada.

11Preguntas frecuentes

Qué preguntar antes de empezar.

¿Es minería de procesos?

No. CodeGraphAI for SAP nunca lee pedidos, facturas ni contabilizaciones, así que no muestra cuántos pedidos pasan por un proceso ni cuánto tardan. Documenta cómo está construido su sistema para ejecutar cada proceso: qué lo inicia, qué hace su código y qué tablas e interfaces toca. Cada línea factual está citada.

¿Documenta el estándar SAP o solo lo que construimos?

Lo que usted construyó alrededor del estándar SAP: su código a medida y la configuración, las transacciones, los dynpros y los jobs que lo inician o lo conectan. También registra las definiciones de las tablas SAP que usa su código y, a partir del índice de la lista de utilización de SAP, el código SAP que llama al suyo. Se muestran las llamadas a los módulos de funciones y las BAPI de SAP; lo que hacen por dentro, no. Nunca lee código fuente estándar de SAP, salvo los includes de exit de usuario que usted indique en la pantalla de selección.

¿Quién decide qué significa un proceso?

Sus expertos. El catálogo indica qué hacen el código y la configuración, y dónde, nunca el propósito de negocio, y el mapa de procesos se presenta como una propuesta. Un documento de proceso se publica solo después de que su experto en la materia confirme los puntos marcados SME-REVIEW-REQUIRED y dé su aprobación formal.

¿Qué lee la exportación y qué sale de nuestro sistema?

Su código fuente a medida, las definiciones del Diccionario ABAP (la estructura, no el contenido de las tablas), el índice de la lista de utilización de SAP, las transacciones, los dynpros, los jobs de fondo y la configuración de procesos, como IDoc, pagos y DMEE, BAdI y CMOD. No lee datos transaccionales ni nombres de usuario. Usted entrega el archivo de exportación para el análisis. Los pasos de IA envían datos del código y extractos de código fuente con los datos personales ocultos a proveedores externos de IA (OpenAI o Anthropic), y solo con su autorización registrada. Sobre el alojamiento y la conservación de los datos, consúltenos.

¿Cuánto tiempo lleva?

Instalar el reporte de exportación lleva unos 5 minutos. En el piloto, en un sistema SAP S/4HANA productivo, pasar de la exportación a la documentación llevó 1 día: el grafo de evidencias, el catálogo y la app web. Los documentos de proceso llevan más tiempo, porque requieren ejecuciones de IA y la aprobación formal de su experto.

¿Cómo se mantiene al día la documentación?

No hay una conexión en vivo con SAP. Después de un release, usted vuelve a ejecutar la exportación. La nueva documentación se construye y se verifica por separado, en cada idioma, antes de publicarse; la versión anterior se archiva y se puede restaurar. Las cuentas de usuario, las aprobaciones y los documentos de proceso se conservan; un documento de proceso regenerado debe volver a pasar los controles.

Panorámica al anochecer de una ciudad latinoamericana y su puerto, con sus distritos unidos por líneas de luz.

Traiga sus preguntas sobre cómo funcionan sus procesos.

Una demostración guiada con nuestro equipo: la app web, el grafo de evidencias y una página del catálogo con citas en nuestro sistema de demostración sintético, y luego sus preguntas. Entre 30 y 45 minutos, aproximadamente, en español, inglés o portugués. Le respondemos por correo electrónico para coordinarla.

o escriba a hello@codegraphai.com