> Mejora continua de procesos > Gestión de contratos > SAP Ariba Contracts > Template de datos

Su Template de datos de gestión de contratos

SAP Ariba Contracts

Atributos de gestión de contratos (19) Actividades de gestión de contratos (14) Guías de extracción (2)

Su Template de datos de gestión de contratos

Esta plantilla ofrece una guía completa para recopilar los datos necesarios para analizar su proceso de gestión de contratos. Describe los atributos esenciales que debe recopilar, las actividades clave que debe supervisar y recomendaciones prácticas para extraer esta información de sus sistemas de origen. Utilice este recurso para agilizar la preparación de sus datos y comenzar su recorrido de Process Mining.

Atributos recomendados para recopilar
Actividades clave de gestión de contratos que debe supervisar
Recomendaciones prácticas para la extracción

¿Es nuevo en los registros de eventos? Aprenda a crear un registro de eventos de Process Mining.

Descargar Template

Atributos de gestión de contratos

Estos son los campos de datos esenciales recomendados para su registro de eventos, con el fin de garantizar un análisis completo de su proceso de gestión de contratos.

3 Obligatorio 6 Recomendado 10 Opcional

	Nombre	Descripción
	Actividad ActivityName	El nombre del paso o evento específico del proceso empresarial que tuvo lugar.
Descripción Este atributo describe la tarea o el hito completado en un momento concreto, como «Contrato redactado» o «Revisión legal iniciada». La secuencia de estas actividades constituye la base del mapa de procesos. Analizar las actividades es fundamental para comprender qué trabajo se realiza, con qué frecuencia se producen los distintos pasos y en qué orden. Permite identificar rutas habituales del proceso, desviaciones y ciclos de retrabajo, como las actividades repetidas de «Contrato revisado». Por qué es importante Define los pasos del proceso, lo que permite visualizar el flujo del proceso e identificar cuellos de botella y retrabajo. Dónde obtenerlo Normalmente se obtiene de los cambios de estado de las tareas, las pistas de auditoría o las tablas de eventos del módulo SAP Ariba Contracts. Ejemplos Revisión interna iniciadaContrato ejecutadoModificación iniciadaContrato cerrado
	ID del contrato ContractId	El identificador único de cada espacio de trabajo contractual, que sirve como identificador principal del caso.
Descripción Este atributo sirve como identificador principal del caso y vincula todas las actividades y eventos a lo largo del ciclo de vida del contrato. Permite reconstruir el recorrido completo de cada contrato, desde su creación hasta su cierre. En process mining, cada evento con el mismo Contract ID se considera parte de la misma instancia del proceso. Esto es fundamental para analizar las variantes del proceso, calcular los tiempos de ciclo e identificar cuellos de botella específicos de contratos individuales o tipos de contrato. Por qué es importante Es la clave esencial para realizar el seguimiento del recorrido completo de un contrato y permite todos los análisis a nivel de caso y la visualización del flujo del proceso. Dónde obtenerlo Es un identificador principal de SAP Ariba Contracts, que normalmente se encuentra en todas las tablas y vistas relacionadas con contratos como Contract Workspace ID. Ejemplos CW2023-00123CW-MSA-45892CW2024-FIN-001CW19876
	Marca de tiempo del evento EventTime	La fecha y hora exactas en las que tuvo lugar una actividad o un evento.
Descripción Esta marca de tiempo señala el inicio de cada actividad del proceso de gestión de contratos. Es un componente crítico para todos los análisis basados en el tiempo, incluido el cálculo de tiempos de ciclo, duraciones y tiempos de espera entre pasos. Al ordenar los eventos según esta marca de tiempo, las herramientas de process mining pueden reconstruir con precisión la secuencia de actividades de cada contrato. Esto permite analizar el rendimiento del proceso a lo largo del tiempo e identificar cuellos de botella relacionados con el tiempo, como los retrasos en la fase de revisión legal. Por qué es importante Este atributo es fundamental para calcular todas las métricas basadas en el tiempo, como los tiempos de ciclo y de espera, y para ordenar correctamente los eventos del proceso. Dónde obtenerlo Se encuentra en los registros de eventos, las pistas de auditoría o las tablas del historial de cambios de estado, junto con la información de actividad de SAP Ariba Contracts. Ejemplos 2023-04-15T10:22:05Z2023-05-01T14:00:12Z2023-05-20T09:30:00Z
	Asesoría jurídica LegalCounsel	La persona del equipo jurídico asignada para revisar el contrato.
Descripción Este atributo identifica específicamente al abogado o profesional jurídico asignado a las tareas de revisión jurídica del contrato. A menudo se trata de una función más específica que la del usuario general que realiza otras actividades. Este atributo es esencial para el Dashboard «Carga de trabajo y eficiencia de la revisión jurídica». Permite hacer seguimiento del número de contratos asignados a cada asesor jurídico, su tiempo medio de revisión y el rendimiento general del departamento jurídico. Esto ayuda a equilibrar las cargas de trabajo, identificar a las personas o prácticas con mejor rendimiento y optimizar la asignación de recursos jurídicos. Por qué es importante Permite analizar en detalle la fase de revisión jurídica, gestionar la carga de trabajo del equipo jurídico, identificar cuellos de botella y mejorar la eficiencia. Dónde obtenerlo Consulte la documentación de SAP Ariba Contracts. Este dato puede registrarse en los detalles de asignación de tareas o como una función específica dentro del flujo de aprobación. Ejemplos s.jonesm.riverad.chen
	Departamento Department	El departamento empresarial que inició el contrato o es responsable de él.
Descripción Este atributo especifica el departamento de la organización, como Ventas, TI o Compras, responsable del contrato. Proporciona un contexto empresarial esencial para analizar el proceso. Segmentar el análisis del proceso por departamento ayuda a identificar comportamientos, cuellos de botella o problemas de cumplimiento específicos de cada área. Por ejemplo, puede revelar si el proceso de aprobación contractual es considerablemente más lento en el departamento de Ventas que en otros, lo que permite investigar sus prácticas concretas. Por qué es importante Permite segmentar el proceso por área empresarial y ayuda a identificar cuellos de botella y variaciones de rendimiento específicos de cada departamento. Dónde obtenerlo Normalmente se encuentra en la cabecera del contrato o en los detalles del espacio de trabajo de SAP Ariba Contracts. Puede estar vinculado al perfil de usuario del propietario del contrato. Ejemplos VentasTecnologías de la informaciónComprasLegal
	Hora de finalización del evento EventEndTime	La marca de tiempo que indica cuándo se completó una actividad.
Descripción Este atributo registra la hora de finalización de una actividad. Mientras que StartTime marca el inicio, EndTime marca la conclusión, lo que permite medir con precisión la duración de las actividades que no son instantáneas. En el análisis, la diferencia entre EndTime y StartTime proporciona el tiempo de procesamiento de una actividad. Esto es esencial para realizar un análisis detallado de cuellos de botella, ya que ayuda a distinguir entre el tiempo dedicado activamente a una tarea y el tiempo de espera entre tareas. Por ejemplo, permite medir con precisión la duración de la actividad «Revisión legal». Por qué es importante Permite calcular con precisión los tiempos de procesamiento de las actividades, algo fundamental para identificar cuellos de botella y medir la eficiencia de los recursos. Dónde obtenerlo Consulte la documentación de SAP Ariba Contracts. Esta información puede estar disponible en los registros de auditoría o en los registros de finalización de tareas. Ejemplos 2023-04-16T11:45:10Z2023-05-03T17:21:09Z2023-05-20T10:05:00Z
	Tipo de contrato ContractType	La clasificación del contrato, como MSA, NDA o SOW.
Descripción Este atributo clasifica los contratos según su finalidad jurídica o empresarial. Entre los tipos habituales se incluyen Master Service Agreement (MSA), Non-Disclosure Agreement (NDA) y Statement of Work (SOW). Analizar el proceso por tipo de contrato es esencial para comprender las variaciones del proceso. Los distintos tipos de contrato suelen tener rutas de aprobación, SLA y niveles de complejidad diferentes. Por ejemplo, un NDA puede seguir un proceso muy sencillo y rápido, mientras que un MSA puede requerir varios niveles de revisión jurídica y financiera. Este atributo es un filtro clave de los Dashboards para comparar los tiempos de ciclo y las tasas de cumplimiento entre distintas categorías de contratos. Por qué es importante Permite segmentar el análisis y revelar cómo los distintos tipos de contrato afectan al flujo, la complejidad y la duración del proceso. Dónde obtenerlo Es un campo de clasificación estándar disponible en los detalles del espacio de trabajo del contrato en SAP Ariba Contracts. Ejemplos Acuerdo marco de serviciosAcuerdo de confidencialidadDeclaración de trabajoAcuerdo de ventas
	Usuario UserName	El nombre o ID del usuario que realizó la actividad.
Descripción Este atributo identifica a la persona responsable de completar una tarea o actividad específica del ciclo de vida contractual. Puede ser el propietario del contrato, una persona revisora del área jurídica o una persona aprobadora. Analizar los datos por usuario ayuda a comprender la distribución de la carga de trabajo, el rendimiento individual y las oportunidades de formación específica. Por ejemplo, en un Dashboard de carga de trabajo de revisión legal, este atributo permite ver cuántos contratos gestiona cada asesor jurídico y cuál es su tiempo medio de revisión. Por qué es importante Proporciona visibilidad sobre la distribución de la carga de trabajo y el rendimiento de los usuarios, lo que permite gestionar los recursos y analizar la eficiencia. Dónde obtenerlo Se encuentra en las tablas de pistas de auditoría o registros de eventos de SAP Ariba Contracts, normalmente asociado a un campo «Modificado por» o «ID de usuario». Ejemplos john.doejane.smithlegal_team_member_1
	Valor del contrato ContractAmount	El valor monetario total del contrato.
Descripción Este atributo representa el valor financiero del contrato. Es una métrica clave para comprender el impacto empresarial y el riesgo asociados a cada contrato. En el análisis, el valor del contrato puede utilizarse para priorizar los contratos de mayor valor y someterlos a un seguimiento más exhaustivo, o para identificar tendencias en el volumen de negocio. El Dashboard «Tendencia del valor de los contratos ejecutados» utiliza este atributo para agregar el valor de los contratos firmados a lo largo del tiempo y ofrecer una visión del rendimiento empresarial. También resulta útil para el análisis de causa raíz, ya que permite comprobar si los contratos de mayor valor siguen un proceso diferente, posiblemente más lento. Por qué es importante Cuantifica el impacto financiero de los contratos y permite realizar análisis basados en el valor, establecer prioridades y hacer un seguimiento del rendimiento empresarial. Dónde obtenerlo Consulte la documentación de SAP Ariba Contracts. Es un campo estándar del espacio de trabajo del contrato, que suele aparecer con la etiqueta «Amount» o «Contract Value». Ejemplos 150000.0025000.501200000.00
	Es retrabajo IsRework	Un indicador que señala si una actividad es un retrabajo o una repetición de un paso anterior.
Descripción Este atributo booleano se establece en true si una actividad, como «Contract Revised», ocurre más de una vez dentro del mismo caso de contrato. Ayuda a identificar y cuantificar explícitamente los bucles de retrabajo del proceso. Este indicador es fundamental para calcular el KPI «Tasa de retrabajo contractual» y visualizar el retrabajo en el mapa de procesos. Al filtrar por este atributo, los analistas pueden aislar rápidamente los contratos que requirieron revisiones importantes, investigar las causas raíz y medir el impacto del retrabajo en los tiempos de ciclo generales. También pone de manifiesto las ineficiencias en las fases de redacción y negociación. Por qué es importante Cuantifica el retrabajo, facilita la medición de las ineficiencias del proceso, el análisis de sus causas raíz y el seguimiento de las mejoras a lo largo del tiempo. Dónde obtenerlo Es un atributo derivado, calculado durante la transformación de datos mediante la detección de actividades repetidas dentro del mismo caso. Ejemplos truefalse
	Estado de cumplimiento del SLA SlaAdherenceStatus	Indica si una actividad de revisión se completó dentro del SLA definido.
Descripción Este atributo clasifica las actividades de revisión como «Met», «Breached» o «N/A» según el tiempo de finalización en relación con el «SLA de revisión». Se calcula comparando «ActivityProcessingTime» con la duración objetivo del SLA. Ofrece una evaluación clara e inmediata del rendimiento frente a los acuerdos de nivel de servicio. Es la métrica principal del KPI y el Dashboard «Cumplimiento del SLA de las revisiones internas y jurídicas». Al visualizar este estado, los responsables pueden consultar rápidamente el porcentaje de revisiones conformes y analizar en detalle los incumplimientos para comprender sus causas. Por qué es importante Mide directamente el rendimiento frente a los objetivos de servicio, permite supervisar con claridad el cumplimiento del SLA e identificar rápidamente los incumplimientos. Dónde obtenerlo Es un atributo derivado, calculado durante la transformación de datos mediante la comparación de ActivityProcessingTime con SlaForReview. Ejemplos CumplidoIncumplidoN/D
	Estado del contrato ContractStatus	El estado general actual del contrato en su ciclo de vida.
Descripción Este atributo indica el estado general actual del contrato, como «Borrador», «En revisión», «Formalizado», «Vencido» o «Terminado». Se diferencia de la actividad, que es un evento único, mientras que el estado representa una situación durante un periodo de tiempo. Este atributo es fundamental para Dashboards como «Estado de las obligaciones y renovaciones de contratos», que ofrecen una instantánea de la cartera actual de contratos. Ayuda a identificar contratos bloqueados y a gestionar eventos del ciclo de vida, como renovaciones y vencimientos. Analizar las transiciones entre estados también puede revelar cuellos de botella o ineficiencias en el proceso. Por qué es importante Ofrece una visión general del estado actual de un contrato, esencial para gestionar la cartera, hacer seguimiento de los estados y analizar el ciclo de vida. Dónde obtenerlo Es un campo de estado principal de la cabecera del espacio de trabajo del contrato en SAP Ariba Contracts. Ejemplos BorradorEn aprobaciónFormalizadoVencido
	Fecha de vencimiento del contrato ContractExpirationDate	La fecha en la que está previsto que venza el contrato.
Descripción Este atributo almacena la fecha oficial de vencimiento del contrato ejecutado. Es un dato fundamental para gestionar el ciclo de vida del contrato después de su ejecución. Esta fecha es la base del Dashboard «Estado de obligaciones y renovaciones contractuales». Se utiliza para activar alertas sobre próximas renovaciones o vencimientos y evitar que los contratos caduquen involuntariamente. El análisis de estos datos ayuda a las organizaciones a gestionar de forma proactiva su cartera de contratos, mitigar los riesgos asociados a acuerdos vencidos y aprovechar las oportunidades de renovación. Por qué es importante Es fundamental para gestionar de forma proactiva el ciclo de vida, facilitar renovaciones oportunas, evitar vencimientos involuntarios y gestionar las obligaciones. Dónde obtenerlo Es un campo estándar del espacio de trabajo del contrato, que suele encontrarse en la cabecera o en la sección de detalles de las condiciones en SAP Ariba Contracts. Ejemplos 2025-12-31T23:59:59Z2024-08-15T23:59:59Z2026-06-30T23:59:59Z
	Nombre de la contraparte CounterpartyName	El nombre de la parte externa del contrato, como un proveedor o cliente.
Descripción Este atributo identifica a la otra parte involucrada en el contrato. Puede tratarse de un proveedor, cliente o socio. Esta información aporta un contexto empresarial esencial al proceso de gestión de contratos. El análisis por contraparte puede ayudar a identificar patrones relacionados con socios concretos. Por ejemplo, las negociaciones con determinadas contrapartes pueden tardar sistemáticamente más, lo que indica la necesidad de utilizar plantillas estandarizadas o condiciones negociadas previamente. También puede utilizarse para evaluar la salud de la relación y el rendimiento de los proveedores en toda la cartera de contratos. Por qué es importante Permite analizar el rendimiento del proceso según la parte externa, identificar dificultades en las negociaciones y gestionar las relaciones con los proveedores. Dónde obtenerlo Esta información suele almacenarse en la sección de información del proveedor o cliente del espacio de trabajo del contrato en SAP Ariba Contracts. Ejemplos Acme CorporationGlobal Tech Inc.Innovate Solutions LLC
	Región Region	La región geográfica asociada al contrato o a la contraparte.
Descripción Este atributo define el área geográfica, como Norteamérica, EMEA o APAC, a la que se aplica el contrato. A menudo se determina según la ubicación de la contraparte o de la unidad de negocio propietaria del contrato. Segmentar el proceso por región permite identificar diferencias regionales en el rendimiento, el cumplimiento y el comportamiento del proceso. Por ejemplo, el análisis puede mostrar que los tiempos de ciclo de los contratos en la región APAC son más largos debido a pasos específicos de revisión normativa. Esta información ayuda a adaptar las mejoras del proceso y la asignación de recursos a las necesidades regionales. Por qué es importante Permite analizar los datos geográficamente para identificar variaciones regionales en el rendimiento del proceso, los tiempos de ciclo y el cumplimiento. Dónde obtenerlo Consulte la documentación de SAP Ariba Contracts. Puede ser un campo del espacio de trabajo del contrato o derivarse de la dirección de la contraparte. Ejemplos NorteaméricaEMEAAPACLATAM
	Sistema de origen SourceSystem	El sistema de registro del que proceden los datos.
Descripción Este atributo identifica el sistema de origen en el que se generaron los datos del evento. En este proceso, será siempre «SAP Ariba Contracts». Incluir este atributo es una buena práctica de gobernanza y trazabilidad de datos. Resulta especialmente importante al combinar datos de varios sistemas, ya que garantiza la claridad sobre su procedencia y ayuda a solucionar problemas de calidad de datos. Por qué es importante Proporciona un contexto esencial sobre el origen de los datos, garantiza la trazabilidad y permite el análisis de varios sistemas. Dónde obtenerlo Normalmente es un valor estático que se añade durante el proceso de extracción y transformación de datos para identificar el origen del conjunto de datos. Ejemplos SAP Ariba Contracts
	SLA de revisión SlaForReview	La duración objetivo o el plazo para completar una actividad de revisión.
Descripción Este atributo define el acuerdo de nivel de servicio (SLA) establecido para tareas de revisión específicas, como «Internal Review» o «Legal Review». Representa el tiempo objetivo en el que debe completarse la revisión. Este atributo es esencial para el Dashboard y el KPI «Cumplimiento del SLA de las revisiones internas y jurídicas». Al comparar el tiempo real dedicado a la revisión con este objetivo, las organizaciones pueden medir el cumplimiento de los niveles de servicio internos. Esto ayuda a identificar retrasos sistémicos, exigir responsabilidades a los equipos y evitar que el proceso de revisión se convierta en un cuello de botella importante. Por qué es importante Establece el objetivo de rendimiento de las actividades de revisión y permite medir el cumplimiento del SLA e identificar retrasos. Dónde obtenerlo Consulte la documentación de SAP Ariba Contracts. Puede configurarse en las reglas o plantillas del flujo de aprobación. Ejemplos P3DP5DP10D
	Tiempo total del ciclo contractual TotalContractCycleTime	El tiempo total transcurrido desde la creación del espacio de trabajo del contrato hasta su ejecución final.
Descripción Este atributo calculado mide la duración completa, de principio a fin, de un único contrato. Normalmente se calcula como la diferencia de tiempo entre la primera y la última actividad, a menudo «Espacio de trabajo del contrato creado» y «Contrato formalizado». Es un indicador clave de rendimiento principal, el «Tiempo de ciclo del contrato de principio a fin». Ofrece una medida general de la eficiencia del proceso de gestión de contratos. Se utiliza en los Dashboards para realizar un seguimiento del rendimiento a lo largo del tiempo y comparar los tiempos de ciclo entre distintos tipos de contrato, departamentos o regiones, lo que ayuda a identificar las principales áreas de mejora. Por qué es importante Ofrece la medida definitiva de la velocidad y la eficiencia del proceso, ya que resume el rendimiento de todo el ciclo de vida contractual en una sola métrica. Dónde obtenerlo Es una métrica calculada a nivel de caso dentro de la herramienta de Process Mining o durante la transformación de datos. Ejemplos P35DP12DT5HP90D
	Última actualización de datos LastDataUpdate	La marca de tiempo que indica cuándo se actualizaron o extrajeron por última vez los datos de este evento.
Descripción Este atributo registra la fecha y hora de la última extracción de datos del sistema de origen. No indica cuándo ocurrió el evento, sino cuándo se cargó el registro en la plataforma de process mining. Esta información es fundamental para la gobernanza de datos y para comprender la actualidad del análisis. Ayuda a saber si se están consultando los datos más recientes y es esencial para gestionar las cargas de datos incrementales. Por qué es importante Garantiza que los usuarios comprendan la actualidad de los datos, un aspecto crítico para realizar análisis y supervisión de procesos precisos y oportunos. Dónde obtenerlo Esta marca de tiempo se genera y añade durante el proceso de incorporación de datos a la herramienta de process mining. Ejemplos 2024-05-21T02:00:00Z2024-05-22T02:00:00Z

Obligatorio Recomendado Opcional

Actividades de gestión de contratos

Estos son los pasos principales y los hitos críticos del proceso que debe capturar en su registro de eventos para descubrir con precisión el proceso de gestión de contratos.

6 Recomendado 8 Opcional

	Actividad	Descripción
	Aprobación interna completada	Marca la finalización satisfactoria de todas las tareas de aprobación interna requeridas para el contrato. Esto indica que el contrato está listo para la firma final, a la espera del acuerdo de la contraparte.
Por qué es importante Es un hito crítico antes de la ejecución. El tiempo transcurrido entre este evento y la ejecución final pone de manifiesto cualquier retraso en la obtención de las firmas externas o en la finalización del documento. Dónde obtenerlo Se captura a partir de la marca de tiempo de finalización de la última tarea de aprobación del Workflow de Ariba. El sistema registra cuándo concluye correctamente todo el flujo de aprobación. Recopilar Utilice la marca de tiempo de finalización del grupo general de tareas del flujo de aprobación. Tipo de evento explicit
	Contrato activado	Representa el momento en que un contrato ejecutado entra en vigor y sus obligaciones comienzan a aplicarse. Normalmente se activa mediante un cambio de estado posterior a la ejecución, a veces en una fecha de entrada en vigor determinada.
Por qué es importante Señala el inicio de la fase de gestión posterior a la ejecución. Activa la supervisión de las obligaciones y es fundamental para el KPI «Tasa de cumplimiento de obligaciones». Dónde obtenerlo Normalmente se infiere a partir del cambio del campo «Estado» de Contract Workspace a «Activo». Puede ocurrir automáticamente después de la ejecución o mediante un paso manual. Recopilar Realice un seguimiento de la marca de tiempo en la que el campo «Estado» del contrato cambia a «Activo». Tipo de evento inferred
	Contrato cerrado	Es una actividad terminal en la que el contrato se cierra formalmente en el sistema. Puede ocurrir después del vencimiento, la terminación o la finalización satisfactoria de todas las obligaciones.
Por qué es importante Marca el final del ciclo de vida del contrato. Es un evento final crítico para medir la duración completa del ciclo de vida y garantizar que se sigan los procedimientos de cierre adecuados. Dónde obtenerlo Se infiere a partir del cambio del campo «Estado» de Contract Workspace a «Cerrado», «Terminado» o «Vencido». El cambio de estado puede ser automático o manual. Recopilar Realice un seguimiento de la marca de tiempo en la que el campo «Estado» del contrato cambia a un estado terminal. Tipo de evento inferred
	Contrato ejecutado	La ejecución formal del contrato tiene lugar cuando se han obtenido todas las firmas requeridas. En ese momento, el contrato pasa de ser un documento en proceso a convertirse en un acuerdo jurídicamente vinculante.
Por qué es importante Este es el principal punto final satisfactorio del proceso previo a la firma. Es fundamental para calcular el «Tiempo de ciclo contractual de principio a fin» y el «Tiempo medio de ciclo de aprobación contractual». Dónde obtenerlo Este evento se captura a partir del estado final de finalización de la tarea de firma en el Workflow de Ariba, especialmente cuando está integrado con una herramienta de firma electrónica. El estado de Contract Workspace también cambia a «Ejecutado». Recopilar Utilice la marca de tiempo de finalización de la tarea de firma final o el cambio de estado a «Ejecutado». Tipo de evento explicit
	Espacio de trabajo contractual creado	Esta actividad marca el inicio del proceso de gestión de contratos. En SAP Ariba se crea un Contract Workspace que sirve como repositorio central de todos los documentos, las tareas y las comunicaciones relacionados con un contrato específico.
Por qué es importante Este es el evento de inicio principal del proceso de principio a fin. Analizar el tiempo transcurrido desde esta actividad hasta la ejecución es fundamental para medir la duración total del ciclo de vida contractual. Dónde obtenerlo Este evento se registra a partir de la fecha de creación del objeto de proyecto Contract Workspace. Es una marca de tiempo fundamental disponible en la cabecera del contrato o en los datos del proyecto. Recopilar Utilice la marca de tiempo de creación del objeto Contract Workspace. Tipo de evento explicit
	Revisión legal iniciada	Indica que el contrato se ha enviado formalmente al departamento jurídico para su revisión. Suele ser una tarea específica y obligatoria dentro del Workflow de aprobación general.
Por qué es importante La revisión legal suele ser un cuello de botella importante. Medir su duración es fundamental para el KPI «Tiempo medio de ciclo de la revisión legal» y para optimizar la asignación de recursos jurídicos. Dónde obtenerlo Se captura a partir del inicio de una tarea específica de «Revisión legal» en el Workflow de Ariba. El sistema registra la marca de tiempo cuando se asigna o se inicia la tarea. Recopilar Identifique la marca de tiempo de inicio de las tareas asignadas específicamente al equipo o rol jurídico. Tipo de evento explicit
	Aprobación de la contraparte recibida	Indica que la parte externa ha aceptado formalmente las condiciones del contrato. Normalmente se captura mediante una solución integrada de firma electrónica o mediante una actualización manual al recibir el documento firmado.
Por qué es importante Esta actividad confirma el acuerdo mutuo y es el último paso antes de considerar el contrato legalmente ejecutado. Es un hito clave para finalizar el acuerdo. Dónde obtenerlo Puede ser un evento explícito de una herramienta de firma electrónica como DocuSign, que registra el estado «Completado». También puede inferirse a partir de un cambio de estado manual a «Firmado por la contraparte». Recopilar Capture el evento de finalización de los registros del proveedor integrado de firma electrónica. Tipo de evento explicit
	Contrato redactado	Representa la creación o carga inicial del documento contractual principal en el espacio de trabajo. Suele ser la primera acción importante relacionada con el contenido después de configurar el espacio de trabajo.
Por qué es importante El seguimiento de esta actividad ayuda a comprender cuánto tiempo se necesita para preparar el borrador inicial. Los retrasos en esta fase pueden afectar significativamente al tiempo de ciclo total. Dónde obtenerlo Puede inferirse a partir de la marca de tiempo de creación de la primera versión del documento principal del acuerdo en la carpeta de documentos de Contract Workspace. Recopilar Identifique la marca de tiempo de la primera versión del documento cargada en el espacio de trabajo. Tipo de evento inferred
	Contrato renovado	Indica que un contrato activo se ha renovado correctamente. Este proceso suele dar lugar a la creación de un nuevo espacio de trabajo contractual que sucede al original.
Por qué es importante Ayuda a analizar la retención contractual y la eficiencia de las renovaciones. Es un resultado clave del ciclo de vida contractual, ya que indica la continuidad de la relación comercial. Dónde obtenerlo Puede capturarse cuando se crea un nuevo contrato con un vínculo de relación, por ejemplo, «renovación de», con el contrato que está a punto de vencer. A menudo es una acción explícita iniciada por un usuario. Recopilar Identifique la creación de un nuevo contrato vinculado como renovación de un contrato existente. Tipo de evento explicit
	Contrato revisado	Esta actividad tiene lugar cuando se crea o carga una nueva versión del documento contractual principal. Normalmente ocurre como respuesta a los comentarios de la revisión interna, la revisión legal o las negociaciones con la contraparte.
Por qué es importante La frecuencia de las revisiones mide directamente el retrabajo. El seguimiento de esta actividad es esencial para calcular la «Tasa de retrabajo contractual» e identificar oportunidades para estandarizar el lenguaje o los procesos. Dónde obtenerlo Se infiere a partir del sistema de gestión documental de Contract Workspace. Cada vez que se guarda una nueva versión del documento principal del acuerdo, se crea una marca de tiempo. Recopilar Utilice las marcas de tiempo de creación de las versiones de documento superiores a uno. Tipo de evento inferred
	Modificación iniciada	Esta actividad marca el inicio de una modificación formal de un contrato activo. Normalmente implica crear una nueva versión o un subproyecto vinculado al espacio de trabajo del contrato original.
Por qué es importante La frecuencia y el momento de las modificaciones proporcionan información sobre la estabilidad del contrato y las necesidades empresariales cambiantes. Es un elemento clave del Dashboard «Tendencias de modificaciones y terminaciones». Dónde obtenerlo Es una acción explícita en la que un usuario inicia un proceso de «Modificación» sobre un contrato existente, y el sistema la registra. Recopilar Capture el evento de creación de un espacio de trabajo o una tarea de modificación contractual. Tipo de evento explicit
	Negociación con la contraparte	Representa la fase en la que el contrato se comparte con la parte externa para negociar y realizar cambios. Esta actividad puede registrarse mediante un cambio de estado manual dentro del espacio de trabajo.
Por qué es importante Proporciona visibilidad sobre los ciclos de negociación externa, que pueden ser impredecibles. Medir esta fase ayuda a cuantificar el «Promedio de ciclos de negociación» e identificar las negociaciones complejas. Dónde obtenerlo A menudo se infiere cuando el estado del espacio de trabajo cambia manualmente a un estado como «Negociación» o «Con el proveedor». También puede inferirse a partir del momento en que se envía un documento a un contacto externo. Recopilar Realice un seguimiento de los cambios en el campo de estado de Contract Workspace a valores que indiquen una revisión externa. Tipo de evento inferred
	Revisión interna iniciada	Esta actividad indica el inicio del Workflow de revisión y aprobación interna del borrador del contrato. El documento se envía a las partes interesadas pertinentes, como los equipos de finanzas u operaciones, para que aporten sus comentarios.
Por qué es importante Marca el inicio de un posible cuello de botella. Analizar la duración de esta fase es clave para identificar retrasos en el proceso de revisión interna y respaldar el KPI «Cumplimiento del SLA de revisión interna». Dónde obtenerlo Este evento suele registrarse cuando se crea y asigna una tarea de revisión en el motor de Workflow de SAP Ariba. El estado de la tarea cambia a «En curso» o a un estado similar. Recopilar Capture la marca de tiempo en la que se inicia una tarea de revisión en el Workflow de aprobación del contrato. Tipo de evento explicit
	Tarea de cumplimiento completada	Indica la finalización de una tarea programada posterior a la ejecución, como una revisión de cumplimiento o una comprobación de obligaciones. Estas tareas se configuran para garantizar una gobernanza continua.
Por qué es importante El seguimiento de la finalización de estas tareas es esencial para medir la «Tasa de cumplimiento de obligaciones» y garantizar que la organización cumpla sus compromisos contractuales. Dónde obtenerlo Se captura a partir de la marca de tiempo de finalización de tareas específicas de seguimiento o relacionadas con obligaciones dentro de Contract Workspace. Recopilar Utilice la marca de tiempo de finalización de las tareas posteriores a la ejecución configuradas en el espacio de trabajo. Tipo de evento explicit

Recomendado Opcional

Guías de extracción

Cómo obtener sus datos de SAP Ariba Contracts

Pasos

Acceda a Analytical Reporting: Inicie sesión en su sistema SAP Ariba. Acceda a la sección de informes haciendo clic en el menú principal y seleccionando Analytical Reports o una ruta similar, como Manage > Analytical Reports.
Cree un informe nuevo: Haga clic en el botón Create y seleccione New Report. Elija crear un informe con varios hechos.
Seleccione el hecho principal: En el generador de informes, seleccione Contract Workspace (Projects) como hecho de datos principal. Este hecho contiene la información básica de cada caso contractual.
Una hechos adicionales: Para capturar todas las actividades y los atributos necesarios, una los siguientes hechos al hecho Contract Workspace (Projects). Utilice el campo común Project Id o Contract Id como condición de unión:
- Approval History: Para obtener información sobre las tareas de aprobación, incluidos los envíos, las aprobaciones y los rechazos.
- Task: Para consultar todas las tareas del Workflow, sus fechas de inicio y finalización y las personas asignadas.
- Document: Para realizar el seguimiento de las versiones de los documentos, algo fundamental para identificar las actividades Contract Drafted y Contract Revised.
Defina los campos del informe (lógica de transformación): El objetivo es crear una fila independiente para cada actividad empresarial. Como la interfaz de usuario de Ariba normalmente crea una fila por contrato, debe definir manualmente campos calculados o exportar una tabla ancha y transformarla posteriormente. El enfoque recomendado consiste en añadir una columna para cada posible marca de tiempo de evento, por ejemplo:
- Workspace Creation Date del hecho Contract Workspace (Projects).
- Main Document Create Date del hecho Document, filtrado para el acuerdo principal y la primera versión.
- Legal Review Start Date del hecho Task, filtrado para la tarea específica de revisión jurídica.
- Execution Date del hecho Contract Workspace (Projects).
- Continúe añadiendo una columna específica para la marca de tiempo de cada una de las 14 actividades requeridas.
Seleccione los campos de atributos: Añada al informe todos los campos de atributos requeridos y recomendados, como Contract Id, Project Owner (para UserName), Department, Amount (para ContractAmount) y Contract Type.
Aplique filtros: Acceda a la pestaña Filters. Establezca un filtro Time Created para el hecho Contract Workspace (Projects) con el fin de limitar la extracción a un periodo manejable, por ejemplo, los últimos 6 a 12 meses. Añada otros filtros relevantes, como Project Type, para incluir únicamente los espacios de trabajo de contratos.
Ejecute y exporte los datos: Ejecute el informe. El resultado será una tabla ancha con una fila por contrato y muchas columnas para distintos eventos de fecha. Exporte el informe a un archivo CSV o Microsoft Excel.
Transforme los datos: El archivo exportado no es un Registro de eventos. Debe transformarlo. Utilice una herramienta como Microsoft Excel Power Query, Python o una herramienta ETL específica para deshacer la estructura de columnas. Para cada fila del archivo exportado, cree varias filas en el archivo nuevo, una por cada columna de fecha creada en el paso 5. Este proceso convierte el formato ancho en el formato largo de Registro de eventos que requiere ProcessMind.
Dé formato al Registro de eventos: En el archivo transformado, asegúrese de que las columnas tengan exactamente los nombres requeridos: ContractId, ActivityName, EventTime, EventEndTime, UserName, etc. Dé a las columnas de marca de tiempo un formato coherente, como YYYY-MM-DD HH:MI:SS. Guarde el archivo final como CSV.
Cargue los datos en ProcessMind: El archivo CSV resultante ya está listo para cargarse en su herramienta de Process Mining.

Configuración

Hechos que deben incluirse: El informe debe unir varios hechos de datos. Comience con Contract Workspace (Projects) y una los hechos Approval History, Task y Documentar para recopilar un historial completo.
Intervalo de fechas: Para el análisis inicial, establezca un filtro en el campo Time Created del hecho Contract Workspace (Projects) para los últimos 6 a 12 meses. Si el volumen es elevado, considere exportar los datos en lotes trimestrales o mensuales más pequeños.
Filtros clave: Es fundamental filtrar por Project Type para garantizar que solo se extraigan espacios de trabajo de contratos y no otros tipos de proyectos, como proyectos de abastecimiento. También puede filtrar por Departamento o Commodity para centrar el análisis.
Granularidad de los datos: Seleccione campos que proporcionen marcas de tiempo para eventos específicos, como fechas de activación de tareas, fechas de aprobación y fechas de creación de documentos. Evite utilizar únicamente la fecha de última modificación, ya que no ofrece contexto sobre un evento concreto.
Requisitos previos: Su cuenta de usuario de SAP Ariba necesita permisos para crear y ejecutar informes analíticos. Estos permisos suelen asignarse a roles como Analysis User o Reporting Administrator.
Consideraciones de rendimiento: Unir varios hechos y exportar muchos campos durante un intervalo de fechas amplio puede hacer que el informe se ejecute muy lentamente o agote el tiempo de espera. Tenga paciencia y considere ejecutar el informe fuera de las horas punta o en lotes más pequeños.

a Consulta de ejemplo sql

-- This is a logical representation of the report configuration in the SAP Ariba Analytical Reporting UI.
-- The tool does not use a direct query language; you build this logic by selecting facts, fields, and filters.
-- The final step requires transforming the wide export file into this long format.

-- FACT: Contract Workspace (Projects) as c
-- JOIN: Approval History as a ON c."Project Id" = a."Project Id"
-- JOIN: Task as t ON c."Project Id" = t."Project Id"
-- JOIN: Document as d ON c."Project Id" = d."Project Id"

-- Each of the following SELECT blocks represents a set of rows for a specific activity.

SELECT c."Contract Id" AS ContractId, 'Contract Workspace Created' AS ActivityName, c."Time Created" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Drafted' AS ActivityName, d."Time Created" AS EventTime, NULL AS EventEndTime, d."Created By" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Document" AS d ON c."Project Id" = d."Project Id" WHERE d."Is Main Agreement" = TRUE AND d.Version = 1
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Internal Review Started' AS ActivityName, t."Activated Date" AS EventTime, t."Completed Date" AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Internal Review%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Legal Review Started' AS ActivityName, t."Activated Date" AS EventTime, t."Completed Date" AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Legal Review%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Revised' AS ActivityName, d."Time Created" AS EventTime, NULL AS EventEndTime, d."Created By" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Document" AS d ON c."Project Id" = d."Project Id" WHERE d."Is Main Agreement" = TRUE AND d.Version > 1
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Negotiation With Counterparty' AS ActivityName, t."Activated Date" AS EventTime, t."Completed Date" AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Negotiation%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Internal Approval Completed' AS ActivityName, a."Time Completed" AS EventTime, NULL AS EventEndTime, a."Approver" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Approval History" AS a ON c."Project Id" = a."Project Id" WHERE a."Approval Task Name" LIKE '%Internal Approval Flow%' AND a.Status = 'Approved' AND a."Is Last Approver" = TRUE
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Counterparty Approval Received' AS ActivityName, t."Completed Date" AS EventTime, NULL AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Counterparty Signature%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Executed' AS ActivityName, c."Executed Date" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Executed Date" IS NOT NULL
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Activated' AS ActivityName, c."Activated Date" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Activated Date" IS NOT NULL
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Compliance Task Completed' AS ActivityName, t."Completed Date" AS EventTime, NULL AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Compliance%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Amendment Initiated' AS ActivityName, c."Time Created" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Is Amendment" = TRUE
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Renewed' AS ActivityName, c."Time Created" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Is Renewal" = TRUE
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Closed' AS ActivityName, c."Completed Date" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c.Status = 'Completed'

Pasos

Requisito previo: registre una aplicación en SAP Ariba Developer Portal. Antes de extraer datos, debe registrar una aplicación nueva en SAP Ariba Developer Portal. Este proceso le proporcionará una Application Key, un OAuth Client ID y un OAuth Client Secret. Asegúrese de conceder a la aplicación los permisos necesarios para acceder a la API de Contract Workspaces.
Configure su entorno de Python. Instale Python 3 en su equipo. Después, instale las bibliotecas necesarias para realizar solicitudes a la API y gestionar datos. Abra un terminal o símbolo del sistema y ejecute: pip install requests pandas.
Configure el script de Python. Copie el script de Python proporcionado en un archivo, por ejemplo, ariba_extraction.py. Abra el archivo y actualice los valores de marcador de posición de la sección de configuración situada al principio. Deberá proporcionar su Ariba Realm, API Key, OAuth Client ID y Client Secret. También debe establecer el intervalo de fechas deseado para la extracción.
Comprenda el flujo de autenticación. El script llama primero al endpoint de autenticación de la API de SAP Ariba utilizando sus credenciales para obtener un token de acceso temporal. Este token es necesario para todas las solicitudes de datos posteriores y el script lo incluye automáticamente en los encabezados de las llamadas a la API.
Ejecute el script para obtener los espacios de trabajo de contratos. Ejecute el script desde su terminal: python ariba_extraction.py. El script comenzará a obtener una lista de todos los espacios de trabajo de contratos actualizados dentro del intervalo de fechas especificado. Gestiona la paginación automáticamente para recuperar todos los registros relevantes.
Obtenga los datos detallados del espacio de trabajo. Para cada espacio de trabajo de contratos identificado en el paso anterior, el script realiza una llamada de seguimiento detallada a la API. Esta llamada recupera objetos asociados, como tareas, documentos, miembros del equipo y cambios históricos de estado del espacio de trabajo, que son esenciales para construir el Registro de eventos.
Transforme las respuestas de la API en eventos. La lógica principal del script recorre la respuesta JSON detallada de cada contrato. Asigna de forma inteligente distintos puntos de datos, como la fecha de creación del espacio de trabajo, los cambios de estado de las tareas, las cargas de versiones de documentos y los campos de estado del contrato (contractStatus), a los nombres de actividad específicos requeridos para el Registro de eventos.
Estructure y enriquezca el Registro de eventos. A medida que identifica los eventos, el script los añade a un DataFrame de pandas. Completa las columnas requeridas (ContractId, ActivityName, EventTime) y las columnas recomendadas (UserName, ContractAmount, ContractType, etc.) extrayendo los valores pertinentes de los datos de la API.
Exporte el Registro de eventos final. Una vez procesados todos los espacios de trabajo de contratos, el script guarda el Registro de eventos completo como un archivo CSV denominado ariba_contract_management_event_log.csv en el mismo directorio. El archivo tiene el formato adecuado y está listo para cargarse en ProcessMind.

Configuración

Credenciales de la API: Debe obtener los siguientes datos de SAP Ariba Developer Portal:
- API_KEY: La clave de aplicación generada para su aplicación registrada.
- CLIENT_ID: El ID de cliente de OAuth, una cadena codificada en base64.
- CLIENT_SECRET: El secreto de cliente de OAuth.
Realm: El nombre específico del SAP Ariba realm de su empresa, por ejemplo, 'mycompany-T'. Este valor dirige las llamadas de la API al centro de datos correcto.
Filtros de intervalo de fechas: Es fundamental establecer los parámetros UPDATED_DATE_FROM y UPDATED_DATE_TO para limitar el alcance de la extracción. Se recomienda comenzar con los últimos 3 a 6 meses para mantener controlados el volumen de datos y el tiempo de ejecución del script.
Filtros del espacio de trabajo: Puede modificar el script para incluir filtros adicionales en la llamada a la API de la función fetch_workspaces. Puede filtrar por campos como contractStatus, por ejemplo, 'Active' o 'Executed', o projectType para dirigirse a tipos de contratos específicos.
Requisitos previos: Se necesita una suscripción activa a SAP Ariba Contracts con la función de API habilitada. También necesita una cuenta de usuario con permisos suficientes para registrar aplicaciones en el portal de desarrolladores y consultar los datos de los espacios de trabajo de contratos.

a Consulta de ejemplo python

import requests
import pandas as pd
import base64
from datetime import datetime, timedelta

class=class="hl-string">"hl-comment"># --- CONFIGURATION --- #
class=class="hl-string">"hl-comment"># Replace with your SAP Ariba realm and API credentials
REALM = class="hl-string">'[Your Ariba Realm]'
API_KEY = class="hl-string">'[Your Application Key]'
class=class="hl-string">"hl-comment"># The OAUTH_CLIENT_ID is your Application Key and a hyphen, base64 encoded.
class=class="hl-string">"hl-comment"># Example: class="hl-string">'yourappkey:' -> class="hl-string">'eW91cmFwcGtleTo='
OAUTH_CLIENT_ID = class="hl-string">'[Your Base64 Encoded OAuth Client ID]'
OAUTH_CLIENT_SECRET = class="hl-string">'[Your OAuth Client Secret]'

class=class="hl-string">"hl-comment"># --- FILTERS --- #
class=class="hl-string">"hl-comment"># Set the date range for contracts to extract (based on last modified date)
UPDATED_DATE_TO = datetime.now().strftime(class="hl-string">'%Y-%m-%dT%H:%M:%SZ')
UPDATED_DATE_FROM = (datetime.now() - timedelta(days=180)).strftime(class="hl-string">'%Y-%m-%dT%H:%M:%SZ')

class=class="hl-string">"hl-comment"># API Endpoints
AUTH_URL = fclass="hl-string">'https://api.ariba.com/v2/oauth/token'
BASE_API_URL = fclass="hl-string">'https://{REALM}.api.ariba.com/api/contracts/v1/workspaces'

class=class="hl-string">"hl-comment"># --- AUTHENTICATION --- #
def get_access_token():
    class="hl-string">"""Authenticates with Ariba API to get an access token."""
    auth_header = {class="hl-string">'Authorization': fclass="hl-string">'Basic {OAUTH_CLIENT_ID}'}
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_secret': OAUTH_CLIENT_SECRET
    }
    try:
        response = requests.post(AUTH_URL, headers=auth_header, data=payload)
        response.raise_for_status()
        return response.json().get(class="hl-string">'access_token')
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error getting access token: {e}")
        return None

class=class="hl-string">"hl-comment"># --- DATA FETCHING --- #
def fetch_paginated_data(url, headers, params):
    class="hl-string">"""Fetches data from a paginated Ariba API endpoint."""
    all_records = []
    page = 0
    while True:
        params[class="hl-string">'page'] = page
        response = requests.get(url, headers=headers, params=params)
        response.raise_for_status()
        data = response.json()
        all_records.extend(data)
        if len(data) == 0: class=class="hl-string">"hl-comment"># Assuming empty list means last page
            break
        page += 1
    return all_records

class=class="hl-string">"hl-comment"># --- EVENT DERIVATION LOGIC --- #
def derive_events_from_workspace(workspace_details):
    class="hl-string">"""Derives multiple event log rows from a single workspace's detailed data."""
    events = []
    case_id = workspace_details.get(class="hl-string">'contractId')
    if not case_id:
        return []

    class=class="hl-string">"hl-comment"># Helper function to create a standard event dictionary
    def create_event(activity, timestamp, user=class="hl-string">'System'):
        return {
            class="hl-string">'ContractId': case_id,
            class="hl-string">'ActivityName': activity,
            class="hl-string">'EventTime': timestamp,
            class="hl-string">'EventEndTime': None, class=class="hl-string">"hl-comment"># Populate if available
            class="hl-string">'UserName': user,
            class="hl-string">'Department': workspace_details.get(class="hl-string">'custom', {}).get(class="hl-string">'Department', None),
            class="hl-string">'ContractAmount': workspace_details.get(class="hl-string">'amount', {}).get(class="hl-string">'amount', None),
            class="hl-string">'ContractType': workspace_details.get(class="hl-string">'contractType', {}).get(class="hl-string">'name', None),
            class="hl-string">'LegalCounsel': next((member.get(class="hl-string">'name') for member in workspace_details.get(class="hl-string">'team', []) if member.get(class="hl-string">'role') == class="hl-string">'Legal Counsel'), None)
        }

    class=class="hl-string">"hl-comment"># 1. Contract Workspace Created
    if workspace_details.get(class="hl-string">'createDate'):
        events.append(create_event(class="hl-string">'Contract Workspace Created', workspace_details[class="hl-string">'createDate']))

    class=class="hl-string">"hl-comment"># 2. Contract Drafted & 5. Contract Revised
    if workspace_details.get(class="hl-string">'documents'):
        main_doc_versions = sorted([v for doc in workspace_details[class="hl-string">'documents'] if doc.get(class="hl-string">'isMainAgreement') for v in doc.get(class="hl-string">'versions', [])], key=lambda x: x[class="hl-string">'createDate'])
        if main_doc_versions:
            events.append(create_event(class="hl-string">'Contract Drafted', main_doc_versions[0][class="hl-string">'createDate'], main_doc_versions[0].get(class="hl-string">'createdBy')))
            for version in main_doc_versions[1:]:
                events.append(create_event(class="hl-string">'Contract Revised', version[class="hl-string">'createDate'], version.get(class="hl-string">'createdBy')))

    class=class="hl-string">"hl-comment"># 3, 4, 7, 11. Task-based activities
    if workspace_details.get(class="hl-string">'tasks'):
        for task in workspace_details[class="hl-string">'tasks']:
            task_name = task.get(class="hl-string">'name', class="hl-string">'').lower()
            if class="hl-string">'internal review' in task_name and task.get(class="hl-string">'startDate'):
                events.append(create_event(class="hl-string">'Internal Review Started', task[class="hl-string">'startDate'], task.get(class="hl-string">'owner')))
            if class="hl-string">'legal review' in task_name and task.get(class="hl-string">'startDate'):
                events.append(create_event(class="hl-string">'Legal Review Started', task[class="hl-string">'startDate'], task.get(class="hl-string">'owner')))
            if class="hl-string">'internal approval' in task_name and task.get(class="hl-string">'completionDate'):
                events.append(create_event(class="hl-string">'Internal Approval Completed', task[class="hl-string">'completionDate'], task.get(class="hl-string">'owner')))
            if class="hl-string">'compliance' in task_name and task.get(class="hl-string">'completionDate'):
                events.append(create_event(class="hl-string">'Compliance Task Completed', task[class="hl-string">'completionDate'], task.get(class="hl-string">'owner')))

    class=class="hl-string">"hl-comment"># 6, 8. Status-based manual activities
    class=class="hl-string">"hl-comment"># This requires interpreting status history, which can be complex. Simplified here.
    if workspace_details.get(class="hl-string">'statusHistory'):
        for status_change in workspace_details.get(class="hl-string">'statusHistory'):
            status = status_change.get(class="hl-string">'status', class="hl-string">'').lower()
            if class="hl-string">'negotiation' in status:
                events.append(create_event(class="hl-string">'Negotiation With Counterparty', status_change[class="hl-string">'date'], status_change.get(class="hl-string">'user')))
            if class="hl-string">'counterparty approval' in status:
                events.append(create_event(class="hl-string">'Counterparty Approval Received', status_change[class="hl-string">'date'], status_change.get(class="hl-string">'user')))

    class=class="hl-string">"hl-comment"># 9. Contract Executed
    if workspace_details.get(class="hl-string">'executionDate'):
        events.append(create_event(class="hl-string">'Contract Executed', workspace_details[class="hl-string">'executionDate']))

    class=class="hl-string">"hl-comment"># 10. Contract Activated
    if workspace_details.get(class="hl-string">'effectiveDate'):
        events.append(create_event(class="hl-string">'Contract Activated', workspace_details[class="hl-string">'effectiveDate']))

    class=class="hl-string">"hl-comment"># 12. Amendment Initiated
    if workspace_details.get(class="hl-string">'isAmendment'):
        events.append(create_event(class="hl-string">'Amendment Initiated', workspace_details[class="hl-string">'createDate']))

    class=class="hl-string">"hl-comment"># 13. Contract Renewed
    if workspace_details.get(class="hl-string">'renewalOfWorkspaceId'):
         events.append(create_event(class="hl-string">'Contract Renewed', workspace_details[class="hl-string">'createDate']))

    class=class="hl-string">"hl-comment"># 14. Contract Closed
    if workspace_details.get(class="hl-string">'closeDate'):
        events.append(create_event(class="hl-string">'Contract Closed', workspace_details[class="hl-string">'closeDate']))

    return events

class=class="hl-string">"hl-comment"># --- MAIN EXECUTION --- #
def main():
    class="hl-string">"""Main function to orchestrate the extraction process."""
    print(class="hl-string">"Attempting to get access token...")
    access_token = get_access_token()
    if not access_token:
        print(class="hl-string">"Failed to get access token. Exiting.")
        return

    print(class="hl-string">"Successfully obtained access token.")
    headers = {
        class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}',
        class="hl-string">'apiKey': API_KEY
    }

    print(fclass="hl-string">"Fetching contract workspaces updated from {UPDATED_DATE_FROM} to {UPDATED_DATE_TO}...")
    workspace_params = {
        class="hl-string">'filters': fclass="hl-string">'updatedDateFrom={UPDATED_DATE_FROM}&updatedDateTo={UPDATED_DATE_TO}'
    }
    try:
        workspaces = fetch_paginated_data(BASE_API_URL, headers, workspace_params)
        print(fclass="hl-string">"Found {len(workspaces)} workspaces.")

        all_events = []
        for i, ws_summary in enumerate(workspaces):
            ws_id = ws_summary.get(class="hl-string">'contractId')
            print(fclass="hl-string">"Processing workspace {i+1}/{len(workspaces)}: {ws_id}")
            detail_url = fclass="hl-string">"{BASE_API_URL}/{ws_id}"
            class=class="hl-string">"hl-comment"># Add parameters to get full details
            detail_params = {class="hl-string">'include': class="hl-string">'tasks,documents,team,statusHistory'}
            try:
                ws_details_response = requests.get(detail_url, headers=headers, params=detail_params)
                ws_details_response.raise_for_status()
                ws_details = ws_details_response.json()
                
                events = derive_events_from_workspace(ws_details)
                all_events.extend(events)
            except requests.exceptions.RequestException as e:
                print(fclass="hl-string">"Could not fetch details for workspace {ws_id}: {e}")

        if not all_events:
            print(class="hl-string">"No events were generated. Check API responses and derivation logic.")
            return

        class=class="hl-string">"hl-comment"># Convert to DataFrame and save to CSV
        event_log_df = pd.DataFrame(all_events)
        event_log_df[class="hl-string">'EventTime'] = pd.to_datetime(event_log_df[class="hl-string">'EventTime'])
        event_log_df = event_log_df.sort_values(by=[class="hl-string">'ContractId', class="hl-string">'EventTime'])
        
        output_filename = class="hl-string">'ariba_contract_management_event_log.csv'
        event_log_df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%d %H:%M:%S')
        print(fclass="hl-string">"Successfully created event log: {output_filename}")

    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"An error occurred during API request: {e}")

if __name__ == class="hl-string">'__main__':
    main()

¿Listo para comenzar?

Utilice esta plantilla para preparar sus datos con confianza y comenzar a descubrir información valiosa sobre su proceso de gestión de contratos. Agilice la recopilación de datos y acelere su camino hacia la optimización de procesos.

Volver a la guía de mejora Descargar Template

Aumente la eficiencia de la gestión de contratos. Inicie su prueba ahora

Reduzca un 30 % el tiempo del ciclo de los contratos y agilice sus procesos de SAP Ariba.

Iniciar la prueba gratuita

No necesita tarjeta de crédito. Configuración rápida.

Su Template de datos de gestión de contratos

Su Template de datos de gestión de contratos

Atributos de gestión de contratos

Actividades de gestión de contratos

Guías de extracción

Exportación de datos desde la interfaz de usuario de Analytical Reporting de SAP Ariba

Pasos

Configuración

a Consulta de ejemplo sql

Script de Python mediante la API de gestión de contratos de Ariba

Pasos

Configuración

a Consulta de ejemplo python

¿Listo para comenzar?

Aumente la eficiencia de la gestión de contratos. Inicie su prueba ahora

Su Template de datos de gestión de contratos

Su Template de datos de gestión de contratos

Atributos de gestión de contratos

Actividades de gestión de contratos

Guías de extracción

Exportación de datos desde la interfaz de usuario de Analytical Reporting de SAP Ariba

Pasos

Configuración

a Consulta de ejemplo sql

Script de Python mediante la API de gestión de contratos de Ariba

Pasos

Configuración

a Consulta de ejemplo python

¿Listo para comenzar?

Aumente la eficiencia de la gestión de contratos. Inicie su prueba ahora

Valoramos su privacidad