> Mejora continua de procesos > Compras a pago: procesamiento de facturas > Oracle Fusion Financials > Template de datos

Su Template de datos para compra a pago, procesamiento de facturas

Oracle Fusion Financials

← Volver a la guía de mejora

Atributos del procesamiento de facturas de compra a pago(20) Actividades del procesamiento de facturas de compra a pago(15) Guías de extracción(3)

Su Template de datos para compra a pago, procesamiento de facturas

Este Template le guía en la recopilación de los datos esenciales para analizar el proceso de compra a pago, en particular el procesamiento de facturas, en Oracle Fusion Financials. Describe los atributos fundamentales y las actividades clave, y explica cómo extraer esta información de su sistema. Con este Template podrá preparar un Registro de eventos preciso y completo para Process Mining.

Atributos recomendados para recopilar
Actividades clave que debe registrar
Guía de extracción para Oracle Fusion Financials

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

Descargar Template

Atributos del procesamiento de facturas de compra a pago

Estos son los campos de datos recomendados para incluir en su Registro de eventos y analizar de forma completa el procesamiento de facturas de compra a pago.

3 Obligatorio 7 Recomendado 10 Opcional

	Nombre	Descripción
	Número de factura InvoiceNumber	Identificador único de una factura de proveedor.
Descripción El número de factura es el identificador principal del caso y vincula todas las actividades y eventos relacionados con una factura de proveedor, desde su creación hasta el pago final. Cada factura se trata como un caso único en el análisis del proceso. En Process Mining, este atributo es fundamental para reconstruir el recorrido completo de cada factura. Permite analizar los flujos del proceso, los tiempos de ciclo y las variaciones de cada factura. Es la clave para conectar actividades como la validación, la aprobación y el pago en una secuencia coherente. Por qué es importante Es el identificador de caso esencial que conecta todos los pasos relacionados del proceso y permite seguir el ciclo de vida completo de una factura. Dónde obtenerlo Suele encontrarse en la columna INVOICE_NUM de la tabla AP_INVOICES_ALL. Ejemplos INV-2023-001987654321ACME-FIN-5501
	Actividad ActivityName	Nombre de la actividad de negocio o del evento que tuvo lugar en el proceso de facturación.
Descripción Este atributo describe un paso concreto o un cambio de estado en el ciclo de vida de la factura, como 'Factura creada', 'Factura aprobada' o 'Pago ejecutado'. La secuencia de estos eventos constituye el flujo del proceso. Analizar la secuencia y la frecuencia de las actividades es la base de Process Mining. Permite descubrir la ruta real del proceso, detectar cuellos de botella donde se producen demoras y encontrar desviaciones o ciclos de retrabajo, como el rechazo de una factura después de su aprobación. Por qué es importante Define los pasos del proceso, algo esencial para visualizar el mapa del proceso, analizar las variaciones del flujo y detectar cuellos de botella. Dónde obtenerlo Este atributo suele obtenerse combinando campos de estado, tablas de auditoría o registros del flujo de trabajo de Oracle Fusion Financials, como AP_INVOICES_ALL.WFAPPROVAL_STATUS o las tablas relacionadas con el flujo de trabajo. Ejemplos Factura validadaFactura bloqueadaFactura aprobadaPago ejecutado
	Hora de inicio EventTime	Marca de tiempo que indica cuándo tuvo lugar una actividad o un evento.
Descripción Este atributo proporciona la fecha y la hora de cada actividad del proceso de facturación. Es fundamental para todos los análisis de procesos basados en el tiempo, incluidos los cálculos de tiempos de ciclo, duraciones y tiempos de espera entre pasos. Al ordenar cronológicamente los eventos según esta marca de tiempo, las herramientas de Process Mining pueden reconstruir la secuencia exacta de actividades de cada factura. Esto permite calcular indicadores clave de rendimiento, como el tiempo medio del ciclo de facturación, y detectar qué etapas del proceso consumen más tiempo. Por qué es importante Esta marca de tiempo es esencial para calcular todas las métricas de rendimiento relacionadas con la duración y el tiempo, como los tiempos de ciclo y los cuellos de botella. Dónde obtenerlo Esta marca de tiempo se obtiene de distintos campos de fecha de las tablas de Oracle Fusion, como CREATION_DATE o LAST_UPDATE_DATE en AP_INVOICES_ALL y en las tablas relacionadas con los flujos de trabajo y los pagos. Ejemplos 2023-04-15T10:00:00Z2023-04-16T14:35:10Z2023-04-20T09:05:00Z
	Código de empresa CompanyCode	Identificador de la entidad jurídica o empresa que procesa la factura.
Descripción El código de empresa identifica la entidad específica de la organización que asume la responsabilidad financiera de la factura. En las organizaciones con varias empresas, es un dato organizativo fundamental. Este atributo permite segmentar el análisis del proceso por entidad jurídica. Así, se puede comparar el rendimiento del proceso entre distintas áreas de la empresa, identificar cuellos de botella o problemas de cumplimiento específicos de cada entidad y presentar los KPI a nivel de empresa. También suele influir en la determinación del flujo de trabajo de aprobación adecuado. Por qué es importante Permite comparar procesos y evaluar el rendimiento de distintas entidades jurídicas o unidades de negocio de la organización. Dónde obtenerlo Suele representarse mediante el campo LEGAL_ENTITY_ID o uno similar en AP_INVOICES_ALL. Este campo puede relacionarse con tablas del libro mayor para obtener un código o nombre. Ejemplos 1001US01DE01
	Estado de la factura InvoiceStatus	Estado actual de la factura en su ciclo de vida.
Descripción Este atributo refleja el último estado conocido de la factura, como «Validada», «Requiere nueva validación», «Pagada» o «Cancelada». Muestra en qué punto del proceso se encuentra la factura en un momento determinado. El estado de la factura es fundamental para el Dashboard «Distribución del estado actual de las facturas», que ayuda a quienes gestionan las operaciones a identificar acumulaciones de trabajo y supervisar el estado general del proceso de facturación. Analizar cómo cambian los estados con el tiempo también permite obtener una visión simplificada del flujo del proceso. Por qué es importante Ofrece una vista del estado actual de las facturas, esencial para los Dashboards operativos que supervisan las acumulaciones de trabajo y la carga laboral. Dónde obtenerlo Consulte la documentación de Oracle Fusion Financials. El estado puede derivarse de campos como WFAPPROVAL_STATUS en AP_INVOICES_ALL o de tablas relacionadas con las aprobaciones y los pagos. Ejemplos ValidadaPagadaCanceladaRequiere una nueva validación
	Fecha de vencimiento del pago PaymentDueDate	Fecha límite para pagar la factura al proveedor.
Descripción La fecha de vencimiento del pago se calcula según las condiciones de pago acordadas con el proveedor. Es la fecha límite para realizar el pago y evitar penalizaciones, mantener una buena relación con el proveedor y aprovechar posibles descuentos por pronto pago. Este atributo es esencial para el Dashboard «Rendimiento de los pagos puntuales» y el KPI asociado. Al comparar la marca de tiempo de ejecución del pago con la fecha de vencimiento, el análisis permite clasificar los pagos como puntuales o atrasados. Así, la organización puede supervisar y mejorar la puntualidad de sus pagos. Por qué es importante Es la referencia para medir el rendimiento de los pagos puntuales, un KPI fundamental para la gestión de proveedores y la salud financiera. Dónde obtenerlo Esta fecha suele estar disponible en tablas de programación de pagos como AP_PAYMENT_SCHEDULES_ALL, vinculadas a la factura. Ejemplos 2023-05-152023-06-012023-06-30
	Hora de finalización EndTime	Marca de tiempo que indica cuándo se completó una actividad o un evento.
Descripción La hora de finalización marca el momento en que concluye una actividad concreta. Mientras que la Hora de inicio señala el comienzo, la hora de finalización indica el cierre y permite calcular con precisión la duración de cada paso. En el análisis, la diferencia entre la hora de finalización y la Hora de inicio corresponde al tiempo de procesamiento de cada actividad. Este dato es esencial para analizar el rendimiento en detalle y distinguir el tiempo de trabajo activo del tiempo de espera. Por ejemplo, permite medir cuánto tiempo dedicó realmente una persona aprobadora a una tarea de aprobación, frente al tiempo que esta permaneció en su cola. Por qué es importante Permite calcular con precisión el tiempo de procesamiento de las actividades y separar el tiempo de trabajo activo del tiempo de espera. Dónde obtenerlo Se trata de un atributo conceptual que se obtiene de la Hora de inicio del evento siguiente en la secuencia de un caso. Ejemplos 2023-04-15T10:05:12Z2023-04-16T15:00:00Z2023-04-20T09:15:30Z
	Importe de la factura InvoiceAmount	Importe total de la factura.
Descripción El importe de la factura representa el total que se debe al proveedor, según lo indicado en la factura. Es un atributo financiero fundamental que influye en todo el proceso y que suele determinar la ruta de aprobación, el nivel de revisión y la prioridad del pago. En el análisis de Process Mining, el importe de la factura es una dimensión clave para filtrar y segmentar los datos. Por ejemplo, quienes analizan el proceso pueden comparar las facturas de importe alto con las de importe bajo para comprobar si siguen rutas distintas o si sus tiempos de ciclo varían considerablemente. También es esencial para calcular los KPI financieros y evaluar el impacto económico de las ineficiencias del proceso, como los pagos atrasados. Por qué es importante Este valor es fundamental para el análisis financiero, para comprender las desviaciones del proceso según el importe y para calcular KPI como la tasa de cumplimiento de las aprobaciones. Dónde obtenerlo Se encuentra en la columna INVOICE_AMOUNT de la tabla AP_INVOICES_ALL. Ejemplos 1500.00250.75125000.50
	Nombre de usuario UserName	Nombre de la persona usuaria que realizó la actividad.
Descripción Este atributo identifica a la persona usuaria o al agente del sistema responsable de realizar una actividad, como validar una factura, bloquearla o aprobar un pago. Permite analizar el proceso desde la perspectiva de los recursos humanos o del sistema. El análisis por persona usuaria ayuda a comprender cómo se distribuye la carga de trabajo, identificar a quienes obtienen mejores resultados y detectar posibles necesidades de formación o problemas de cumplimiento. Por ejemplo, puede revelar si ciertas personas usuarias aparecen con frecuencia en ciclos de retrabajo o si una misma persona siempre se encarga de determinados pasos de aprobación, lo que podría crear un punto único de fallo. Por qué es importante Permite analizar el rendimiento de los recursos, equilibrar la carga de trabajo e identificar qué personas usuarias o equipos participan en determinados pasos del proceso. Dónde obtenerlo Esta información suele almacenarse en columnas de auditoría como CREATED_BY o LAST_UPDATED_BY en tablas como AP_INVOICES_ALL, o en los registros de los flujos de trabajo relacionados. Ejemplos john.doejane.smithSystem.Admin
	Nombre del proveedor VendorName	Nombre del proveedor que emitió la factura.
Descripción Este atributo identifica al proveedor que emitió la factura. La información del proveedor aporta un contexto empresarial fundamental a la transacción financiera. El análisis del proceso por proveedor puede revelar información importante sobre las relaciones y el rendimiento de los proveedores. Por ejemplo, puede mostrar si las facturas de ciertos proveedores presentan más discrepancias de conciliación, bloqueos o demoras. Esta información puede servir para mejorar la incorporación de proveedores, la comunicación y la eficiencia general de la cadena de suministro. También ayuda a identificar posibles pagos duplicados. Por qué es importante Permite analizar el proceso por proveedor e identificar problemas con proveedores concretos que causan demoras o excepciones. Dónde obtenerlo Se encuentra en la tabla POZ_SUPPLIERS. La tabla de facturas AP_INVOICES_ALL contiene el campo VENDOR_ID, que permite relacionarla con la tabla de proveedores. Ejemplos Acme CorporationGlobal Tech Inc.Office Supplies Co.
	Es retrabajo IsRework	Indicador booleano que identifica las actividades que forman parte de un ciclo de retrabajo.
Descripción Este indicador se establece en verdadero para las actividades que señalan una desviación del flujo ideal del proceso, como «Factura corregida» o una segunda instancia de «Factura validada» después de un rechazo. Permite identificar y cuantificar explícitamente los ciclos de proceso ineficientes. Este atributo es esencial para el Dashboard «Tasa de retrabajo y gestión de excepciones». Al marcar las actividades de retrabajo, quienes analizan el proceso pueden cuantificar fácilmente su volumen y coste, identificar las causas raíz y medir el impacto de las iniciativas de mejora destinadas a hacer las cosas bien desde el primer intento. Por qué es importante Identifica y cuantifica el retrabajo de forma explícita, lo que facilita analizar la frecuencia, las causas y el impacto de las ineficiencias del proceso. Dónde obtenerlo Es un atributo calculado. La lógica se define durante la transformación de datos para identificar las secuencias de actividades que constituyen retrabajo. Ejemplos truefalse
	Fecha de la factura InvoiceDate	Fecha indicada en la factura del proveedor.
Descripción Este atributo indica la fecha en que el proveedor emitió oficialmente la factura. Es un dato clave del documento de origen y se utiliza como punto de partida para calcular la fecha de vencimiento del pago según las condiciones acordadas. Aunque no siempre marca el inicio del proceso interno, la fecha de la factura aporta un contexto fundamental. Se combina con el nombre del proveedor y el importe de la factura para ayudar a identificar posibles facturas duplicadas. Analizar el tiempo transcurrido entre la fecha de la factura y la fecha en que se crea en el sistema también puede revelar ineficiencias en la gestión del correo o en la recepción de facturas. Por qué es importante Es un dato clave para identificar facturas duplicadas y calcular las fechas de vencimiento de los pagos. Dónde obtenerlo Es un campo estándar de la tabla AP_INVOICES_ALL, denominado INVOICE_DATE. Ejemplos 2023-04-102023-05-012023-05-25
	Moneda InvoiceCurrencyCode	Moneda del importe de la factura.
Descripción Este atributo especifica la moneda en la que está expresado el importe de la factura, por ejemplo, USD, EUR o GBP. Aporta un contexto esencial para el campo de importe de la factura. En una organización global, analizar las facturas por moneda es importante para los informes financieros y para comprender las variaciones del proceso por región. Permite interpretar correctamente los importes y analizar las prácticas de pago o los umbrales de aprobación según la moneda. Por qué es importante Aporta el contexto necesario para interpretar y analizar correctamente los importes financieros, especialmente en operaciones multinacionales. Dónde obtenerlo Se encuentra en la columna INVOICE_CURRENCY_CODE de la tabla AP_INVOICES_ALL. Ejemplos USDEURGBPCAD
	Motivo de la discrepancia de conciliación MatchingDiscrepancyReason	Motivo concreto de la discrepancia entre una factura, una orden de compra y una recepción.
Descripción Este atributo detalla por qué una factura no superó el proceso de conciliación automatizada. Entre los motivos habituales se encuentran las diferencias de precio, cantidad o códigos de artículo entre la factura y la orden de compra o el recibo de mercancías correspondiente. Esta información es fundamental para el Dashboard «Tasa de discrepancias en la conciliación de facturas». Al clasificar y analizar los motivos de las discrepancias, las empresas pueden detectar problemas sistémicos en los procesos de compras o recepción. Esto permite tomar medidas correctivas para aumentar la proporción de facturas procesadas de principio a fin sin intervención manual. Por qué es importante Explica por qué las facturas no superan la conciliación automatizada y aporta la información necesaria para mejorar la tasa de conciliación en el primer intento y reducir el retrabajo manual. Dónde obtenerlo Consulte la documentación de Oracle Fusion Financials. El motivo puede registrarse como un tipo específico de bloqueo en AP_HOLDS_ALL o en tablas relacionadas con los detalles de conciliación. Ejemplos El precio unitario difiere del de la orden de compraLa cantidad facturada supera la cantidad recibidaArtículo no válido en la factura
	Motivo del bloqueo HoldReason	Motivo por el que se bloqueó la factura o se impidió su pago.
Descripción Cuando se bloquea una factura, este atributo indica el motivo, como «Diferencia de precio», «Discrepancia de cantidad» o «Pendiente de recepción de mercancías». Aporta contexto sobre la interrupción del flujo normal del proceso. Este atributo es la dimensión principal del Dashboard «Tendencias y análisis de bloqueos de pago». Al analizar la frecuencia de los distintos motivos de bloqueo, la empresa puede identificar y abordar las causas raíz, como problemas en los procesos de compras o errores en las facturas de los proveedores, y reducir así las demoras de procesamiento. Por qué es importante Permite identificar la causa raíz de los bloqueos de pago y aplicar mejoras específicas para reducir la frecuencia de los bloqueos y las demoras en los pagos. Dónde obtenerlo La información sobre los bloqueos suele almacenarse en la tabla AP_HOLDS_ALL, que está vinculada a la factura e incluye el motivo o código del bloqueo. Ejemplos Diferencia de precioLa cantidad facturada supera la cantidad recibidaNúmero de orden de compra no válido
	Nombre de la persona aprobadora ApproverName	Nombre de la persona que aprobó o rechazó la factura.
Descripción Este atributo registra la identidad de la persona que actuó durante el paso de aprobación. Se registra en actividades como «Factura aprobada» o «Factura rechazada». En el análisis, el nombre de la persona aprobadora permite comprender la carga de trabajo de aprobación, medir los tiempos de ciclo individuales y auditar el cumplimiento de las políticas de aprobación. Para el KPI «Tasa de cumplimiento de las aprobaciones», este atributo puede contrastarse con las reglas de delegación de autoridad según el importe de la factura y el código de empresa. Por qué es importante Es esencial para analizar los tiempos de ciclo de aprobación, comprobar el cumplimiento de las políticas de la matriz de aprobación y comprender cómo se distribuye la carga de trabajo. Dónde obtenerlo Esta información se encuentra en las tablas del flujo de trabajo o del historial de aprobaciones de Oracle Fusion asociadas al objeto de factura. Ejemplos David WilsonSarah JohnsonMichael Brown
	Número de orden de compra PurchaseOrderNumber	Identificador de la orden de compra asociada a la factura.
Descripción Este atributo vincula la factura con la orden de compra (PO) correspondiente, que autorizó la adquisición de los bienes o servicios. Las facturas pueden estar asociadas a una PO o no. El análisis por PO conecta el proceso de facturación con la parte de compras del proceso P2P. Ayuda a comprender el grado de cumplimiento del proceso de compras y a determinar si los problemas de facturación, como las discrepancias de conciliación, se originan en la orden de compra inicial. La presencia o ausencia de un número de PO es una forma fundamental de segmentar y analizar las distintas rutas de procesamiento de facturas. Por qué es importante Vincula la factura con el proceso de compras y es un atributo clave para analizar los flujos de facturas asociadas a una PO frente a los que no lo están. Dónde obtenerlo Esta información se obtiene al relacionar las líneas de factura de AP_INVOICE_LINES_ALL con las distribuciones de la PO mediante PO_DISTRIBUTION_ID. Ejemplos PO-2023-5001600789PO-FIN-9981
	Pago puntual IsOnTimePayment	Indicador booleano que señala si la factura se pagó antes de su fecha de vencimiento o en esa fecha.
Descripción Este indicador se establece en verdadero si el pago se ejecutó en la fecha de vencimiento o antes, y en falso en caso contrario. Ofrece una clasificación sencilla y clara para cada factura pagada. Este atributo calculado contribuye directamente al KPI de tasa de pagos puntuales y al Dashboard correspondiente. Simplifica el análisis, ya que permite filtrar, contar y visualizar fácilmente la proporción de pagos atrasados frente a los puntuales, sin tener que comparar fechas en cada consulta. Así, se puede identificar rápidamente la magnitud de las demoras en los pagos y seguir las mejoras a lo largo del tiempo. Por qué es importante Simplifica el análisis de la puntualidad de los pagos y sirve como dato directo para calcular el KPI de tasa de pagos puntuales. Dónde obtenerlo Es un atributo calculado a partir de la comparación entre la marca de tiempo de la actividad «Pago ejecutado» y el atributo «PaymentDueDate». Ejemplos truefalse
	Sistema de origen SourceSystem	Identifica el sistema de origen en el que se registraron los datos del evento.
Descripción Este atributo especifica la aplicación o el módulo de origen que generó los datos, como Oracle Fusion Financials. En entornos con varios sistemas integrados, este campo permite distinguir el origen de los distintos pasos del proceso. Conocer el sistema de origen resulta útil para validar datos, resolver problemas y analizar variaciones del proceso que puedan ser específicas de un sistema. También aporta claridad en entornos de TI complejos, donde el recorrido de una factura puede abarcar varias aplicaciones. Por qué es importante Aporta contexto sobre el origen de los datos, algo importante para la gobernanza de datos, la resolución de problemas y el análisis del comportamiento del proceso en cada sistema. Dónde obtenerlo A menudo se trata de un valor estático que se añade durante la extracción de datos para indicar el origen del conjunto de datos. Ejemplos Oracle Fusion FinancialsOracle Payables Cloud
	Última actualización de los datos LastUpdateDate	Marca de tiempo que indica cuándo se actualizó por última vez el registro en el sistema de origen.
Descripción Este atributo refleja la fecha y hora de la modificación más reciente de los datos subyacentes en Oracle Fusion Financials. Se utiliza para gestionar las cargas incrementales de datos y mantener actualizado el modelo de Process Mining. Aunque no se utiliza directamente para analizar el flujo del proceso, esta marca de tiempo técnica es fundamental para mantener la vigencia y la integridad de los datos. Permite que los flujos de datos consulten de forma eficiente solo los registros nuevos o modificados desde la última actualización, lo que reduce la carga en el sistema de origen. Por qué es importante Permite ejecutar los flujos de datos de forma eficiente e incremental, y mantener actualizado el análisis del proceso sin necesidad de recargas completas. Dónde obtenerlo Suele encontrarse como LAST_UPDATE_DATE en muchas tablas de Oracle Fusion, incluida AP_INVOICES_ALL. Ejemplos 2023-05-20T11:00:00Z2023-05-21T16:45:00Z

Obligatorio Recomendado Opcional

Actividades del procesamiento de facturas de compra a pago

Estos son los pasos y los hitos clave del proceso que debe registrar en su Registro de eventos para descubrir el proceso con precisión.

6 Recomendado 9 Opcional

	Actividad	Descripción
	Factura aprobada	Todas las personas requeridas aprobaron la factura en el flujo de trabajo. Ahora está lista para la contabilización y la programación del pago.
Por qué es importante Es un hito importante que marca la finalización satisfactoria del proceso de aprobación. Las demoras previas a esta etapa suelen ser cuellos de botella. Dónde obtenerlo Se deduce del cambio de APPROVAL_STATUS en la tabla AP_INVOICES_ALL a un estado final de aprobación, como 'Approved' o 'Workflow Approved'. El historial de auditoría de este campo proporciona la marca de tiempo. Capturar Se deduce del cambio de AP_INVOICES_ALL.APPROVAL_STATUS a 'Approved'. Tipo de evento inferred
	Factura conciliada con la orden de compra	Esta actividad indica que una línea de factura se concilió correctamente con la línea correspondiente de una orden de compra, lo que confirma que los bienes o servicios facturados se habían solicitado. Suele ser una acción automática o manual que queda registrada en el sistema.
Por qué es importante Es fundamental para la conciliación a tres vías, que incluye la orden de compra, la recepción y la factura. Los errores en esta etapa son una de las principales causas de excepciones y demoras. Dónde obtenerlo Puede deducirse de la creación de registros en la tabla AP_INVOICE_DISTRIBUTIONS_ALL que vinculan la factura con una distribución de orden de compra (PO_DISTRIBUTION_ID). También puede utilizarse el estado de conciliación de las líneas en AP_INVOICE_LINES_ALL. Capturar Se deduce de la incorporación de datos de distribución de la orden de compra en las líneas de factura. Tipo de evento inferred
	Factura contabilizada	La factura se contabiliza correctamente en el libro mayor y genera asientos contables. Este evento confirma que el impacto financiero de la factura quedó registrado formalmente.
Por qué es importante Es un punto de control financiero fundamental y un requisito previo para el pago. Confirma que la factura está validada y aprobada, y que está lista para liquidarse. Dónde obtenerlo Se deduce del estado en la tabla AP_INVOICE_DISTRIBUTIONS_ALL (ACCRUAL_POSTED_FLAG = 'Y') o de la existencia de los asientos contables correspondientes en tablas del libro mayor, como XLA_AE_HEADERS. Capturar Se deduce de los indicadores en AP_INVOICE_DISTRIBUTIONS_ALL o de los asientos vinculados del libro mayor. Tipo de evento inferred
	Factura creada	Indica la creación inicial de un registro de factura en el sistema, ya sea mediante la introducción manual, el escaneo o el envío electrónico. Este evento suele registrarse cuando se inserta una nueva fila en la tabla principal de facturas.
Por qué es importante Marca el inicio del ciclo de procesamiento de la factura. Analizar el tiempo transcurrido desde este evento ayuda a comprender la eficiencia de la introducción de datos y las demoras al inicio del proceso. Dónde obtenerlo En Oracle Fusion Financials, corresponde a la marca de tiempo de creación del registro en la tabla AP_INVOICES_ALL, concretamente en la columna CREATION_DATE. Capturar Marca de tiempo de creación del registro en AP_INVOICES_ALL. Tipo de evento explicit
	Factura enviada para aprobación	La factura se envía a un flujo de trabajo de aprobación según las reglas de negocio configuradas. Esto marca el inicio del ciclo formal de aprobación.
Por qué es importante Da inicio a una etapa clave del proceso. Registrar la hora de inicio es esencial para medir y optimizar el 'Tiempo de ciclo de aprobación de facturas'. Dónde obtenerlo Se deduce de un cambio de estado en la tabla AP_INVOICES_ALL, cuando APPROVAL_STATUS pasa a un estado como 'Initiated' o 'Pending Approval'. Las tablas del flujo de trabajo también pueden contener este evento. Capturar Se deduce del cambio de AP_INVOICES_ALL.APPROVAL_STATUS a 'Initiated'. Tipo de evento inferred
	Pago ejecutado	Es la confirmación final de que el pago se realizó y se hizo efectivo. En el caso de los cheques, corresponde a la fecha de cobro; en los pagos electrónicos, a la confirmación del banco.
Por qué es importante Es la actividad final del ciclo de vida de la factura y marca la finalización satisfactoria del proceso. Es el punto final para calcular el 'Tiempo medio del ciclo de facturación' y la 'Tasa de pagos puntuales'. Dónde obtenerlo Se deduce de la actualización del estado del pago a 'Cleared' o 'Reconciled' en la tabla AP_CHECKS_ALL (mediante CLEARED_DATE) o de los datos de conciliación bancaria del módulo Cash Management (CE_STATEMENT_LINES). Capturar Se deduce de las actualizaciones de estado en AP_CHECKS_ALL o de la conciliación en el módulo CE. Tipo de evento inferred
	Bloqueo de factura liberado	Este evento marca la resolución de un bloqueo aplicado anteriormente a la factura. Una persona o un proceso automatizado elimina el bloqueo para que la factura pueda continuar su ciclo.
Por qué es importante El tiempo transcurrido entre la aplicación y la liberación de un bloqueo es una medida clave de la eficiencia en la gestión de excepciones. Este dato sirve para calcular el KPI 'Tiempo medio de resolución de excepciones'. Dónde obtenerlo Se registra en la tabla AP_HOLDS_ALL. Al liberar un bloqueo, se completan los campos RELEASE_LOOKUP_CODE y RELEASE_REASON, junto con LAST_UPDATE_DATE. Capturar Actualización de un registro en la tabla AP_HOLDS_ALL para marcar el bloqueo como liberado. Tipo de evento explicit
	Discrepancia de conciliación detectada	Se produce cuando el sistema o una persona detecta una diferencia entre la factura, la orden de compra y los datos de recepción, por ejemplo, en el precio o la cantidad. A menudo, esto hace que el sistema bloquee la factura.
Por qué es importante Señala excepciones del proceso que requieren intervención manual. Registrar estos eventos es esencial para calcular el KPI 'Tasa de discrepancias en la conciliación de facturas' y analizar las causas de raíz. Dónde obtenerlo A menudo se registra como un tipo específico de bloqueo aplicado a la factura. Consulte en la tabla AP_HOLDS_ALL los tipos de bloqueo relacionados con la conciliación, como 'QTY REC' o 'PRICE'. HOLD_DATE indica la marca de tiempo. Capturar Creación de un registro en AP_HOLDS_ALL con un tipo de bloqueo relacionado con la conciliación. Tipo de evento explicit
	Factura bloqueada	Actividad genérica que representa cualquier bloqueo aplicado a una factura e impide que avance al pago. Puede deberse a distintos motivos, como problemas de conciliación, fondos insuficientes o intervención manual.
Por qué es importante Afecta directamente al tiempo de ciclo y puede provocar pagos atrasados. Analizar los bloqueos es clave para detectar y resolver problemas sistémicos del proceso, y sirve de apoyo al análisis 'Tendencias de bloqueos de pago'. Dónde obtenerlo Se registra explícitamente en la tabla AP_HOLDS_ALL. Cada fila representa un bloqueo e incluye la fecha de creación (HOLD_DATE) y el motivo. Capturar Creación de un registro en la tabla AP_HOLDS_ALL. Tipo de evento explicit
	Factura cancelada	La factura se anuló o canceló y no seguirá procesándose ni se pagará. Esto representa un estado final del proceso.
Por qué es importante Es un punto final importante para las facturas que no se pagan. Analizar las cancelaciones puede revelar problemas con facturas duplicadas o envíos incorrectos de proveedores. Dónde obtenerlo Se deduce de un cambio de estado en AP_INVOICES_ALL. La columna CANCELLED_DATE se completa con la marca de tiempo de la cancelación. Capturar Se completa el campo CANCELLED_DATE de la tabla AP_INVOICES_ALL. Tipo de evento explicit
	Factura corregida	Se produce cuando una persona modifica una factura, a menudo en respuesta a un rechazo o para corregir un error de introducción de datos. Representa una etapa de retrabajo manual en el proceso.
Por qué es importante Esta actividad es un indicador claro de retrabajo. Analizar su frecuencia ayuda a cuantificar las ineficiencias del proceso y sirve para calcular el KPI 'Tasa de retrabajo de facturas'. Dónde obtenerlo Puede deducirse al registrar actualizaciones importantes del registro de la factura en AP_INVOICES_ALL después de que ya se haya validado o enviado para aprobación. Se necesitarían la marca de tiempo LAST_UPDATE_DATE y los datos del registro de auditoría. Capturar Se deduce al comparar LAST_UPDATE_DATE después de un rechazo o un bloqueo. Tipo de evento inferred
	Factura rechazada	Una persona aprobadora rechazó la factura durante el flujo de trabajo de aprobación. Por lo general, esta acción devuelve la factura para que se corrija o se cancele, e inicia un ciclo de retrabajo.
Por qué es importante Representa un resultado desfavorable y es una de las principales causas de retrabajo y de ciclos más largos. Registrar los rechazos ayuda a detectar problemas con la calidad de las facturas o el cumplimiento de las órdenes de compra. Dónde obtenerlo Se deduce del cambio de APPROVAL_STATUS en la tabla AP_INVOICES_ALL a 'Rejected'. El historial del flujo de trabajo incluye quién la rechazó y cuándo. Capturar Se deduce del cambio de AP_INVOICES_ALL.APPROVAL_STATUS a 'Rejected'. Tipo de evento inferred
	Factura validada	Indica que la factura superó las comprobaciones del sistema para verificar que la información de la cabecera y las líneas esté completa y sea correcta. A menudo se deduce de un cambio de estado en el registro de la factura.
Por qué es importante Es un hito clave antes de la conciliación y la aprobación. Las demoras en esta etapa pueden indicar problemas con la calidad de los datos de la factura o con la configuración del sistema. Dónde obtenerlo Se deduce del cambio de estado de la factura a 'Validated' en la tabla AP_INVOICES_ALL. Puede utilizarse el historial de cambios o el registro de auditoría de la columna VALIDATION_STATUS. Capturar Se deduce de un cambio en el campo AP_INVOICES_ALL.VALIDATION_STATUS. Tipo de evento inferred
	Pago creado	El sistema generó la instrucción de pago de la factura. Puede tratarse de la creación de un cheque, un archivo de transferencia electrónica de fondos (EFT) u otro instrumento de pago.
Por qué es importante En este punto, la organización compromete los fondos para el pago. Es un hito clave justo antes de que el dinero salga de la cuenta bancaria. Dónde obtenerlo Se registra en la tabla AP_CHECKS_ALL, que almacena información sobre todos los pagos. CHECK_DATE indica cuándo se creó el documento de pago. Capturar Creación de un registro en la tabla AP_CHECKS_ALL. Tipo de evento explicit
	Pago programado	La factura se selecciona y se incluye en una solicitud de proceso de pago, también llamada ejecución o lote de pagos. A partir de ese momento, queda en cola para el pago.
Por qué es importante Es la etapa entre la contabilización y el pago efectivo. Su duración afecta a las previsiones de flujo de caja y a la posibilidad de aprovechar los descuentos por pronto pago. Dónde obtenerlo Se registra en la tabla AP_INVOICE_PAYMENTS_ALL cuando se crea un registro de pago, aunque todavía no se haya confirmado como pagado. También puede encontrarse en tablas de lotes de pago, como IBY_PAYMENT_PROCESS_REQUESTS. Capturar Creación de un registro de pago programado en AP_INVOICE_PAYMENTS_ALL. Tipo de evento explicit

Recomendado Opcional

Guías de extracción

Cómo obtener sus datos de Oracle Fusion Financials

Pasos

Inicie sesión en Oracle Fusion Cloud: Acceda a su entorno de Oracle Fusion Cloud con un usuario que tenga el rol BI Cloud Connector Administrator (BICC_ADMIN).
Vaya a BI Cloud Connector: En el menú de navegación principal, seleccione Tools > BI Cloud Connector. Se abrirá la consola de BICC.
Seleccione la oferta: En la consola de BICC, elija la oferta correspondiente a sus datos financieros. Normalmente se llama 'Financials'.
Configure el almacenamiento externo: Vaya a la sección 'Configure External Storage'. Configure la conexión con el almacenamiento en la nube donde se entregarán los archivos CSV extraídos, por ejemplo, Oracle Cloud Infrastructure (OCI) Object Storage.
Habilite las ofertas para la extracción: Vaya a 'Manage Offerings and PVOs' o a una sección similar. Seleccione la oferta 'Financials' y habilítela para la extracción.
Seleccione los Public View Objects (PVO): Busque y seleccione los PVO específicos que necesita para el proceso de facturas. Los PVO clave son: FscmTopModelAM.FinApInvQuickInvoicesAM.InvoiceHeaderPVO, FscmTopModelAM.FinApInvHoldAM.InvoiceHoldPVO, FscmTopModelAM.FinApInvSharedAM.InvoiceApprovalHistoryPVO y FscmTopModelAM.FinApPmtsInvPmtsAM.PaymentPVO.
Programe el trabajo de extracción: Vaya a 'Manage Extract Schedules'. Cree un nuevo trabajo, asígnele un nombre descriptivo y seleccione todos los PVO que habilitó en el paso anterior. Programe su ejecución. Para la carga inicial, ejecútelo para el período histórico que necesite. En las ejecuciones posteriores, configure extracciones incrementales basadas en LastUpdateDate.
Supervise y recupere los datos: Supervise el progreso del trabajo en la consola de BICC. Cuando termine correctamente, vaya a la ubicación de almacenamiento en la nube que configuró. Encontrará los datos extraídos en varios archivos CSV comprimidos, uno por cada PVO.
Cargue los datos en un área de preparación: Descomprima los archivos y cargue los CSV en una base de datos de preparación o una plataforma de procesamiento de datos, como un almacén o lago de datos, donde pueda ejecutar consultas SQL. Cargue cada archivo CSV en una tabla independiente.
Transforme los datos en un Registro de eventos: Ejecute la consulta SQL proporcionada en las tablas del área de preparación. La consulta combina los datos de las distintas tablas para crear una única tabla unificada de Registro de eventos.
Exporte los datos para ProcessMind: Exporte el resultado de la consulta SQL en un único archivo CSV. Asegúrese de que los encabezados de columna coincidan con los atributos requeridos (InvoiceNumber, ActivityName, EventTime, etc.) para cargar el archivo en la aplicación ProcessMind.

Configuración

Public View Objects (PVO) clave: La extracción utiliza varios PVO esenciales de la oferta Financials. Como mínimo, debe incluir:
- FscmTopModelAM.FinApInvQuickInvoicesAM.InvoiceHeaderPVO: Para los datos principales de las facturas y los eventos de creación, validación y cancelación.
- FscmTopModelAM.FinApInvHoldAM.InvoiceHoldPVO: Para todos los eventos de retención y liberación de facturas.
- FscmTopModelAM.FinApInvSharedAM.InvoiceApprovalHistoryPVO: Para registrar en detalle los pasos del flujo de aprobación, como el envío, la aprobación y el rechazo.
- FscmTopModelAM.FinApPmtsInvPmtsAM.PaymentPVO: Para los eventos de creación y ejecución de pagos.
- FscmTopModelAM.FinApInvPmtsAM.InstallmentPVO: Para identificar cuándo se programa el pago de una factura.
Extracciones incrementales: Para la supervisión continua, configure el trabajo de BICC para realizar extracciones incrementales. Use la columna LastUpdateDate, disponible en la mayoría de los PVO, como criterio de filtro para extraer solo los registros nuevos o modificados desde la última ejecución.
Filtrado por período: Para la carga inicial de datos históricos, se recomienda extraer un período manejable, por ejemplo, los últimos 6 a 12 meses. Puede aplicar un filtro global en la programación del trabajo de BICC para limitar la extracción a un período específico.
Filtro por unidad de negocio: Para limitar el alcance de la extracción, aplique un filtro en BusinessUnitName o en un atributo similar dentro de la configuración del trabajo de BICC. Esto es fundamental en entornos con varias entidades para controlar el volumen de datos.
Requisitos previos: La cuenta de usuario necesita los roles adecuados, principalmente BICC Administrator (BICC_ADMIN) y Functional Setup User (FSM_IMPLEMENTATION_CONSULTANT), para configurar y ejecutar trabajos de extracción. También debe tener una ubicación de almacenamiento en la nube configurada y accesible, como OCI Object Storage o UCM.

Consulta de ejemplo sql

-- This script is designed to be run on the CSV files after they have been extracted by BICC and loaded into a staging database.
-- Each CTE (e.g., Invoices, Holds) represents a table created from a corresponding PVO's CSV file.

WITH Invoices AS (
    SELECT 
        InvoiceId,
        InvoiceNumber,
        InvoiceAmount,
        SupplierName AS VendorName,
        CreationDate,
        CreatedBy AS UserName, 
        LastUpdateDate, 
        LastUpdatedBy, 
        ValidatedDate,
        ApprovalStatus,
        WfApprovalStatus,
        PayablesAccountingStatus,
        CancelledDate,
        CancelledBy,
        BusinessUnitName AS CompanyCode
    FROM FscmTopModelAM_FinApInvQuickInvoicesAM_InvoiceHeaderPVO
    WHERE LastUpdateDate >= '[Specify Start Date]'
),
Holds AS (
    SELECT 
        InvoiceId,
        HoldDate,
        ReleasedDate,
        HoldReason,
        CreatedBy,
        LastUpdatedBy
    FROM FscmTopModelAM_FinApInvHoldAM_InvoiceHoldPVO
),
ApprovalHistory AS (
    SELECT
        InvoiceId,
        ActionDate,
        Action,
        Performer AS UserName
    FROM FscmTopModelAM_FinApInvSharedAM_InvoiceApprovalHistoryPVO
),
Installments AS (
    SELECT 
        InvoiceId,
        DueDate AS PaymentDueDate,
        PaymentStatusFlag,
        LastUpdateDate
    FROM FscmTopModelAM_FinApInvPmtsAM_InstallmentPVO
),
Payments AS (
    SELECT
        InvoiceId,
        PaymentId,
        CreationDate,
        CreatedBy AS UserName,
        PaymentDate
    FROM FscmTopModelAM_FinApPmtsInvPmtsAM_PaymentPVO
)

-- 1. Invoice Created
SELECT
    i.InvoiceNumber AS "InvoiceNumber",
    'Invoice Created' AS "ActivityName",
    i.CreationDate AS "EventTime",
    i.CreationDate AS "EndTime",
    i.UserName AS "UserName",
    i.InvoiceAmount AS "InvoiceAmount",
    i.VendorName AS "VendorName",
    inst.PaymentDueDate AS "PaymentDueDate",
    i.ApprovalStatus AS "InvoiceStatus",
    i.CompanyCode AS "CompanyCode"
FROM Invoices i
LEFT JOIN Installments inst ON i.InvoiceId = inst.InvoiceId

UNION ALL

-- 2. Invoice Validated
SELECT
    i.InvoiceNumber AS "InvoiceNumber",
    'Invoice Validated' AS "ActivityName",
    i.ValidatedDate AS "EventTime",
    i.ValidatedDate AS "EndTime",
    i.LastUpdatedBy AS "UserName",
    i.InvoiceAmount AS "InvoiceAmount",
    i.VendorName AS "VendorName",
    inst.PaymentDueDate AS "PaymentDueDate",
    'Validated' AS "InvoiceStatus",
    i.CompanyCode AS "CompanyCode"
FROM Invoices i
LEFT JOIN Installments inst ON i.InvoiceId = inst.InvoiceId
WHERE i.ValidatedDate IS NOT NULL

UNION ALL

-- 3. Invoice Matched to PO (Inferred from hold release)
SELECT
    i.InvoiceNumber AS "InvoiceNumber",
    'Invoice Matched to PO' AS "ActivityName",
    h.ReleasedDate AS "EventTime",
    h.ReleasedDate AS "EndTime",
    h.LastUpdatedBy AS "UserName",
    i.InvoiceAmount AS "InvoiceAmount",
    i.VendorName AS "VendorName",
    inst.PaymentDueDate AS "PaymentDueDate",
    i.ApprovalStatus AS "InvoiceStatus",
    i.CompanyCode AS "CompanyCode"
FROM Invoices i
JOIN Holds h ON i.InvoiceId = h.InvoiceId
LEFT JOIN Installments inst ON i.InvoiceId = inst.InvoiceId
WHERE h.HoldReason IN ('QTY ORD', 'AMT ORD', 'PRICE') AND h.ReleasedDate IS NOT NULL

UNION ALL

-- 4. Matching Discrepancy Identified
SELECT
    i.InvoiceNumber AS "InvoiceNumber",
    'Matching Discrepancy Identified' AS "ActivityName",
    h.HoldDate AS "EventTime",
    h.HoldDate AS "EndTime",
    h.CreatedBy AS "UserName",
    i.InvoiceAmount AS "InvoiceAmount",
    i.VendorName AS "VendorName",
    inst.PaymentDueDate AS "PaymentDueDate",
    'On Hold' AS "InvoiceStatus",
    i.CompanyCode AS "CompanyCode"
FROM Invoices i
JOIN Holds h ON i.InvoiceId = h.InvoiceId
LEFT JOIN Installments inst ON i.InvoiceId = inst.InvoiceId
WHERE h.HoldReason IN ('QTY ORD', 'AMT ORD', 'PRICE')

UNION ALL

-- 5. Hold Placed on Invoice
SELECT
    i.InvoiceNumber AS "InvoiceNumber",
    'Hold Placed on Invoice' AS "ActivityName",
    h.HoldDate AS "EventTime",
    h.HoldDate AS "EndTime",
    h.CreatedBy AS "UserName",
    i.InvoiceAmount AS "InvoiceAmount",
    i.VendorName AS "VendorName",
    inst.PaymentDueDate AS "PaymentDueDate",
    'On Hold' AS "InvoiceStatus",
    i.CompanyCode AS "CompanyCode"
FROM Invoices i
JOIN Holds h ON i.InvoiceId = h.InvoiceId
LEFT JOIN Installments inst ON i.InvoiceId = inst.InvoiceId

UNION ALL

-- 6. Hold Released from Invoice
SELECT
    i.InvoiceNumber AS "InvoiceNumber",
    'Hold Released from Invoice' AS "ActivityName",
    h.ReleasedDate AS "EventTime",
    h.ReleasedDate AS "EndTime",
    h.LastUpdatedBy AS "UserName",
    i.InvoiceAmount AS "InvoiceAmount",
    i.VendorName AS "VendorName",
    inst.PaymentDueDate AS "PaymentDueDate",
    i.ApprovalStatus AS "InvoiceStatus",
    i.CompanyCode AS "CompanyCode"
FROM Invoices i
JOIN Holds h ON i.InvoiceId = h.InvoiceId
LEFT JOIN Installments inst ON i.InvoiceId = inst.InvoiceId
WHERE h.ReleasedDate IS NOT NULL

UNION ALL

-- 7. Invoice Sent for Approval
SELECT
    i.InvoiceNumber AS "InvoiceNumber",
    'Invoice Sent for Approval' AS "ActivityName",
    ah.ActionDate AS "EventTime",
    ah.ActionDate AS "EndTime",
    ah.UserName AS "UserName",
    i.InvoiceAmount AS "InvoiceAmount",
    i.VendorName AS "VendorName",
    inst.PaymentDueDate AS "PaymentDueDate",
    'Initiated' AS "InvoiceStatus",
    i.CompanyCode AS "CompanyCode"
FROM Invoices i
JOIN ApprovalHistory ah ON i.InvoiceId = ah.InvoiceId
LEFT JOIN Installments inst ON i.InvoiceId = inst.InvoiceId
WHERE ah.Action = 'SUBMITTED'

UNION ALL

-- 8. Invoice Approved
SELECT
    i.InvoiceNumber AS "InvoiceNumber",
    'Invoice Approved' AS "ActivityName",
    ah.ActionDate AS "EventTime",
    ah.ActionDate AS "EndTime",
    ah.UserName AS "UserName",
    i.InvoiceAmount AS "InvoiceAmount",
    i.VendorName AS "VendorName",
    inst.PaymentDueDate AS "PaymentDueDate",
    'Workflow approved' AS "InvoiceStatus",
    i.CompanyCode AS "CompanyCode"
FROM Invoices i
JOIN ApprovalHistory ah ON i.InvoiceId = ah.InvoiceId
LEFT JOIN Installments inst ON i.InvoiceId = inst.InvoiceId
WHERE ah.Action = 'APPROVED'

UNION ALL

-- 9. Invoice Rejected
SELECT
    i.InvoiceNumber AS "InvoiceNumber",
    'Invoice Rejected' AS "ActivityName",
    ah.ActionDate AS "EventTime",
    ah.ActionDate AS "EndTime",
    ah.UserName AS "UserName",
    i.InvoiceAmount AS "InvoiceAmount",
    i.VendorName AS "VendorName",
    inst.PaymentDueDate AS "PaymentDueDate",
    'Rejected' AS "InvoiceStatus",
    i.CompanyCode AS "CompanyCode"
FROM Invoices i
JOIN ApprovalHistory ah ON i.InvoiceId = ah.InvoiceId
LEFT JOIN Installments inst ON i.InvoiceId = inst.InvoiceId
WHERE ah.Action = 'REJECTED'

UNION ALL

-- 10. Invoice Corrected (Inferred from update after rejection)
SELECT
    i.InvoiceNumber AS "InvoiceNumber",
    'Invoice Corrected' AS "ActivityName",
    i.LastUpdateDate AS "EventTime",
    i.LastUpdateDate AS "EndTime",
    i.LastUpdatedBy AS "UserName",
    i.InvoiceAmount AS "InvoiceAmount",
    i.VendorName AS "VendorName",
    inst.PaymentDueDate AS "PaymentDueDate",
    i.ApprovalStatus AS "InvoiceStatus",
    i.CompanyCode AS "CompanyCode"
FROM Invoices i
LEFT JOIN Installments inst ON i.InvoiceId = inst.InvoiceId
WHERE i.WfApprovalStatus = 'WORKFLOW_REJECTED' AND i.LastUpdatedBy <> 'FUSION_APPS_PRC_SOA_APPID'

UNION ALL

-- 11. Invoice Accounted
SELECT
    i.InvoiceNumber AS "InvoiceNumber",
    'Invoice Accounted' AS "ActivityName",
    i.LastUpdateDate AS "EventTime",
    i.LastUpdateDate AS "EndTime",
    i.LastUpdatedBy AS "UserName",
    i.InvoiceAmount AS "InvoiceAmount",
    i.VendorName AS "VendorName",
    inst.PaymentDueDate AS "PaymentDueDate",
    'Accounted' AS "InvoiceStatus",
    i.CompanyCode AS "CompanyCode"
FROM Invoices i
LEFT JOIN Installments inst ON i.InvoiceId = inst.InvoiceId
WHERE i.PayablesAccountingStatus = 'ACCOUNTED'

UNION ALL

-- 12. Payment Scheduled
SELECT
    i.InvoiceNumber AS "InvoiceNumber",
    'Payment Scheduled' AS "ActivityName",
    inst.LastUpdateDate AS "EventTime",
    inst.LastUpdateDate AS "EndTime",
    i.LastUpdatedBy AS "UserName", -- User who ran the PPR is not in this PVO
    i.InvoiceAmount AS "InvoiceAmount",
    i.VendorName AS "VendorName",
    inst.PaymentDueDate AS "PaymentDueDate",
    'Selected for Payment' AS "InvoiceStatus",
    i.CompanyCode AS "CompanyCode"
FROM Invoices i
JOIN Installments inst ON i.InvoiceId = inst.InvoiceId
WHERE inst.PaymentStatusFlag = 'Y'

UNION ALL

-- 13. Payment Created
SELECT
    i.InvoiceNumber AS "InvoiceNumber",
    'Payment Created' AS "ActivityName",
    p.CreationDate AS "EventTime",
    p.CreationDate AS "EndTime",
    p.UserName AS "UserName",
    i.InvoiceAmount AS "InvoiceAmount",
    i.VendorName AS "VendorName",
    inst.PaymentDueDate AS "PaymentDueDate",
    'Paid' AS "InvoiceStatus",
    i.CompanyCode AS "CompanyCode"
FROM Invoices i
JOIN Payments p ON i.InvoiceId = p.InvoiceId
LEFT JOIN Installments inst ON i.InvoiceId = inst.InvoiceId

UNION ALL

-- 14. Payment Executed
SELECT
    i.InvoiceNumber AS "InvoiceNumber",
    'Payment Executed' AS "ActivityName",
    p.PaymentDate AS "EventTime",
    p.PaymentDate AS "EndTime",
    p.UserName AS "UserName",
    i.InvoiceAmount AS "InvoiceAmount",
    i.VendorName AS "VendorName",
    inst.PaymentDueDate AS "PaymentDueDate",
    'Paid' AS "InvoiceStatus",
    i.CompanyCode AS "CompanyCode"
FROM Invoices i
JOIN Payments p ON i.InvoiceId = p.InvoiceId
LEFT JOIN Installments inst ON i.InvoiceId = inst.InvoiceId
WHERE p.PaymentDate IS NOT NULL

UNION ALL

-- 15. Invoice Canceled
SELECT
    i.InvoiceNumber AS "InvoiceNumber",
    'Invoice Canceled' AS "ActivityName",
    i.CancelledDate AS "EventTime",
    i.CancelledDate AS "EndTime",
    i.CancelledBy AS "UserName",
    i.InvoiceAmount AS "InvoiceAmount",
    i.VendorName AS "VendorName",
    inst.PaymentDueDate AS "PaymentDueDate",
    'Cancelled' AS "InvoiceStatus",
    i.CompanyCode AS "CompanyCode"
FROM Invoices i
LEFT JOIN Installments inst ON i.InvoiceId = inst.InvoiceId
WHERE i.CancelledDate IS NOT NULL;

Pasos

Acceda a Oracle BI Publisher: Inicie sesión en Oracle Fusion Applications con un usuario que tenga el rol BI Administrator o uno similar. Abra el menú Navigator, seleccione Tools y, por último, haga clic en Reports and Analytics para acceder a esa herramienta.
Vaya al catálogo: En el área de trabajo Reports and Analytics, haga clic en Browse Catalog para abrir la interfaz de Oracle BI Publisher.
Cree un modelo de datos: En el catálogo de BI Publisher, vaya a una carpeta adecuada, por ejemplo, Shared Folders > Custom. Haga clic en el menú desplegable New y seleccione Data Model.
Defina el conjunto de datos de la consulta SQL: En el editor del modelo de datos, haga clic en el icono '+' para añadir un conjunto de datos y seleccione SQL Query en la lista.
Configure el conjunto de datos: En el cuadro de diálogo New Data Set, escriba un nombre, por ejemplo, P2P_Invoice_Events. Seleccione la fuente de datos adecuada, que normalmente es ApplicationDB_FSCM para los datos financieros. Asegúrese de que el campo Type of SQL esté configurado como Standard SQL.
Introduzca la consulta SQL: Copie la consulta SQL completa de la sección query de este documento y péguela en el área de texto SQL Query.
Defina los parámetros: La consulta usa parámetros para filtrar los datos. En las propiedades del modelo de datos, cree tres parámetros: p_start_date, p_end_date y p_bu_name. Configure su tipo de datos como String. Al ejecutar el informe, deberá introducir valores para estos parámetros, por ejemplo, '2023-01-01' para las fechas y el nombre específico de la unidad de negocio.
Guarde el modelo de datos: Guarde el modelo de datos en su carpeta personalizada. Para ver datos de ejemplo, haga clic en la pestaña 'Data' e introduzca valores para los parámetros que creó.
Cree un informe: Vuelva al catálogo, haga clic en el menú desplegable New y seleccione Report. En el asistente de creación de informes, seleccione la opción 'Use Data Model' y busque el modelo de datos que acaba de guardar.
Configure la disposición y el formato de salida del informe: En el editor del informe basta con una tabla sencilla. El paso más importante es configurar el formato de salida predeterminado. Haga clic en 'View a List' y asegúrese de que CSV sea el formato predeterminado y el único habilitado. Así obtendrá un archivo de datos sin formato ni estilos.
Programe el informe: Guarde el informe. Puede ejecutarlo cuando lo necesite o, para mejorar el rendimiento, programarlo fuera de las horas de mayor actividad. Puede configurar la programación para enviar el archivo CSV a un destino específico, como el servidor Universal Content Management (UCM), desde donde podrá recuperarlo para cargarlo.
Exporte y prepare los datos: Cuando termine el trabajo del informe, descargue el archivo CSV resultante. Antes de cargarlo en la herramienta de Process Mining, compruebe que los encabezados de columna coincidan con los atributos requeridos (InvoiceNumber, ActivityName, EventTime, etc.).

Configuración

Fuente de datos: La consulta debe ejecutarse en la base de datos de la aplicación Fusion Financials, a la que normalmente se accede mediante la fuente de datos JNDI ApplicationDB_FSCM en BI Publisher.
Parámetros: El modelo de datos debe configurarse con los siguientes parámetros para permitir una extracción flexible:
- p_start_date: Fecha de inicio del período de extracción, con el formato 'YYYY-MM-DD'.
- p_end_date: Fecha de finalización del período de extracción, con el formato 'YYYY-MM-DD'.
- p_bu_name: Nombre de la unidad de negocio (código de empresa) que se usará para filtrar los datos. Use un carácter comodín como '%' para extraer datos de todas las unidades de negocio.
Período: Para la extracción inicial, se recomienda usar un período de entre 3 y 6 meses de datos. Así se obtiene un conjunto de datos representativo sin afectar demasiado el rendimiento de la extracción.
Consideraciones de rendimiento: Extraer datos de períodos largos o de todas las unidades de negocio a la vez puede consumir muchos recursos y provocar tiempos de espera agotados. Se recomienda ejecutar las extracciones grandes en lotes secuenciales más pequeños, por ejemplo, mes a mes, o programarlas fuera de las horas de mayor actividad.
Requisitos previos: El usuario que cree y ejecute el informe necesita un rol con permisos para acceder a BI Publisher, como BI Administrator, y los privilegios de seguridad de datos necesarios para consultar las tablas subyacentes de cuentas por pagar (AP_INVOICES_ALL, AP_PAYMENTS_ALL, etc.) de las unidades de negocio correspondientes.

Consulta de ejemplo sql

WITH INVOICE_BASE AS (
    SELECT 
        AIA.INVOICE_ID,
        AIA.INVOICE_NUM,
        AIA.INVOICE_AMOUNT,
        AIA.CREATION_DATE,
        AIA.CREATED_BY,
        AIA.LAST_UPDATE_DATE,
        AIA.LAST_UPDATED_BY,
        AIA.CANCELLED_DATE,
        AIA.CANCELLED_BY,
        AIA.WFAPPROVAL_STATUS,
        AIA.TERMS_DATE AS PAYMENT_DUE_DATE,
        PSV.VENDOR_NAME,
        FABUV.BU_NAME AS COMPANY_CODE
    FROM 
        AP_INVOICES_ALL AIA
    JOIN 
        POZ_SUPPLIERS_V PSV ON AIA.VENDOR_ID = PSV.VENDOR_ID
    JOIN
        FUN_ALL_BUSINESS_UNITS_V FABUV ON AIA.ORG_ID = FABUV.BU_ID
    WHERE 
        AIA.CREATION_DATE BETWEEN TO_DATE(:p_start_date, 'YYYY-MM-DD') AND TO_DATE(:p_end_date, 'YYYY-MM-DD')
        AND FABUV.BU_NAME LIKE :p_bu_name
)
-- 1. Invoice Created
SELECT
    IB.INVOICE_NUM AS "InvoiceNumber",
    'Invoice Created' AS "ActivityName",
    CAST(IB.CREATION_DATE AS TIMESTAMP) AS "EventTime",
    CAST(IB.CREATION_DATE AS TIMESTAMP) AS "EndTime",
    (SELECT USERNAME FROM PER_USERS PU WHERE PU.USER_ID = IB.CREATED_BY AND ROWNUM = 1) AS "UserName",
    IB.INVOICE_AMOUNT AS "InvoiceAmount",
    IB.VENDOR_NAME AS "VendorName",
    IB.PAYMENT_DUE_DATE AS "PaymentDueDate",
    IB.WFAPPROVAL_STATUS AS "InvoiceStatus",
    IB.COMPANY_CODE AS "CompanyCode"
FROM
    INVOICE_BASE IB

UNION ALL

-- 2. Invoice Validated
SELECT
    IB.INVOICE_NUM AS "InvoiceNumber",
    'Invoice Validated' AS "ActivityName",
    CAST(AIA.LAST_UPDATE_DATE AS TIMESTAMP) AS "EventTime",
    CAST(AIA.LAST_UPDATE_DATE AS TIMESTAMP) AS "EndTime",
    (SELECT USERNAME FROM PER_USERS PU WHERE PU.USER_ID = AIA.LAST_UPDATED_BY AND ROWNUM = 1) AS "UserName",
    IB.INVOICE_AMOUNT AS "InvoiceAmount",
    IB.VENDOR_NAME AS "VendorName",
    IB.PAYMENT_DUE_DATE AS "PaymentDueDate",
    AIA.WFAPPROVAL_STATUS AS "InvoiceStatus",
    IB.COMPANY_CODE AS "CompanyCode"
FROM
    AP_INVOICES_ALL AIA
JOIN 
    INVOICE_BASE IB ON AIA.INVOICE_ID = IB.INVOICE_ID
WHERE 
    AIA.WFAPPROVAL_STATUS IN ('VALIDATED', 'NEEDS REVALIDATION', 'STOPPED')

UNION ALL

-- 3. Invoice Matched to PO
SELECT
    IB.INVOICE_NUM AS "InvoiceNumber",
    'Invoice Matched to PO' AS "ActivityName",
    CAST(MIN(AID.CREATION_DATE) AS TIMESTAMP) AS "EventTime",
    CAST(MIN(AID.CREATION_DATE) AS TIMESTAMP) AS "EndTime",
    (SELECT USERNAME FROM PER_USERS PU WHERE PU.USER_ID = MIN(AID.CREATED_BY) AND ROWNUM = 1) AS "UserName",
    IB.INVOICE_AMOUNT AS "InvoiceAmount",
    IB.VENDOR_NAME AS "VendorName",
    IB.PAYMENT_DUE_DATE AS "PaymentDueDate",
    IB.WFAPPROVAL_STATUS AS "InvoiceStatus",
    IB.COMPANY_CODE AS "CompanyCode"
FROM
    AP_INVOICE_DISTRIBUTIONS_ALL AID
JOIN 
    INVOICE_BASE IB ON AID.INVOICE_ID = IB.INVOICE_ID
WHERE
    AID.PO_DISTRIBUTION_ID IS NOT NULL
GROUP BY
    IB.INVOICE_NUM, IB.INVOICE_AMOUNT, IB.VENDOR_NAME, IB.PAYMENT_DUE_DATE, IB.WFAPPROVAL_STATUS, IB.COMPANY_CODE

UNION ALL

-- 4. Matching Discrepancy Identified & 5. Hold Placed on Invoice
SELECT
    IB.INVOICE_NUM AS "InvoiceNumber",
    CASE 
        WHEN AH.HOLD_LOOKUP_CODE IN ('QTY ORD', 'QTY REC', 'PRICE', 'AMT ORD', 'AMT REC') THEN 'Matching Discrepancy Identified'
        ELSE 'Hold Placed on Invoice'
    END AS "ActivityName",
    CAST(AH.HOLD_DATE AS TIMESTAMP) AS "EventTime",
    CAST(AH.HOLD_DATE AS TIMESTAMP) AS "EndTime",
    (SELECT USERNAME FROM PER_USERS PU WHERE PU.USER_ID = AH.CREATED_BY AND ROWNUM = 1) AS "UserName",
    IB.INVOICE_AMOUNT AS "InvoiceAmount",
    IB.VENDOR_NAME AS "VendorName",
    IB.PAYMENT_DUE_DATE AS "PaymentDueDate",
    IB.WFAPPROVAL_STATUS AS "InvoiceStatus",
    IB.COMPANY_CODE AS "CompanyCode"
FROM
    AP_HOLDS_ALL AH
JOIN 
    INVOICE_BASE IB ON AH.INVOICE_ID = IB.INVOICE_ID

UNION ALL

-- 6. Hold Released from Invoice
SELECT
    IB.INVOICE_NUM AS "InvoiceNumber",
    'Hold Released from Invoice' AS "ActivityName",
    CAST(AH.RELEASE_DATE AS TIMESTAMP) AS "EventTime",
    CAST(AH.RELEASE_DATE AS TIMESTAMP) AS "EndTime",
    (SELECT USERNAME FROM PER_USERS PU WHERE PU.USER_ID = AH.LAST_UPDATED_BY AND ROWNUM = 1) AS "UserName",
    IB.INVOICE_AMOUNT AS "InvoiceAmount",
    IB.VENDOR_NAME AS "VendorName",
    IB.PAYMENT_DUE_DATE AS "PaymentDueDate",
    IB.WFAPPROVAL_STATUS AS "InvoiceStatus",
    IB.COMPANY_CODE AS "CompanyCode"
FROM
    AP_HOLDS_ALL AH
JOIN 
    INVOICE_BASE IB ON AH.INVOICE_ID = IB.INVOICE_ID
WHERE 
    AH.RELEASE_LOOKUP_CODE IS NOT NULL AND AH.RELEASE_DATE IS NOT NULL

UNION ALL

-- 7. Invoice Sent for Approval, 8. Invoice Approved, 9. Invoice Rejected
SELECT
    IB.INVOICE_NUM AS "InvoiceNumber",
    CASE 
        WHEN AAH.ACTION = 'INITIATED' THEN 'Invoice Sent for Approval'
        WHEN AAH.ACTION = 'APPROVED' THEN 'Invoice Approved'
        WHEN AAH.ACTION = 'REJECTED' THEN 'Invoice Rejected'
    END AS "ActivityName",
    CAST(AAH.RESPONSE_DATE AS TIMESTAMP) AS "EventTime",
    CAST(AAH.RESPONSE_DATE AS TIMESTAMP) AS "EndTime",
    (SELECT USERNAME FROM PER_USERS PU WHERE PU.USER_ID = AAH.RESPONSE_ID AND ROWNUM = 1) AS "UserName",
    IB.INVOICE_AMOUNT AS "InvoiceAmount",
    IB.VENDOR_NAME AS "VendorName",
    IB.PAYMENT_DUE_DATE AS "PaymentDueDate",
    IB.WFAPPROVAL_STATUS AS "InvoiceStatus",
    IB.COMPANY_CODE AS "CompanyCode"
FROM
    AP_INV_APRVL_HIST_ALL AAH
JOIN 
    INVOICE_BASE IB ON AAH.INVOICE_ID = IB.INVOICE_ID
WHERE
    AAH.ACTION IN ('INITIATED', 'APPROVED', 'REJECTED') AND AAH.RESPONSE_DATE IS NOT NULL

UNION ALL

-- 10. Invoice Corrected
SELECT DISTINCT
    IB.INVOICE_NUM AS "InvoiceNumber",
    'Invoice Corrected' AS "ActivityName",
    CAST(IB.LAST_UPDATE_DATE AS TIMESTAMP) AS "EventTime",
    CAST(IB.LAST_UPDATE_DATE AS TIMESTAMP) AS "EndTime",
    (SELECT USERNAME FROM PER_USERS PU WHERE PU.USER_ID = IB.LAST_UPDATED_BY AND ROWNUM = 1) AS "UserName",
    IB.INVOICE_AMOUNT AS "InvoiceAmount",
    IB.VENDOR_NAME AS "VendorName",
    IB.PAYMENT_DUE_DATE AS "PaymentDueDate",
    IB.WFAPPROVAL_STATUS AS "InvoiceStatus",
    IB.COMPANY_CODE AS "CompanyCode"
FROM
    INVOICE_BASE IB
WHERE
    IB.LAST_UPDATE_DATE > IB.CREATION_DATE
    AND IB.LAST_UPDATED_BY <> IB.CREATED_BY 
    AND EXISTS (
        SELECT 1 FROM AP_INV_APRVL_HIST_ALL AAH 
        WHERE AAH.INVOICE_ID = IB.INVOICE_ID AND AAH.ACTION = 'REJECTED' AND IB.LAST_UPDATE_DATE > AAH.RESPONSE_DATE
    )

UNION ALL

-- 11. Invoice Accounted
SELECT 
    IB.INVOICE_NUM AS "InvoiceNumber",
    'Invoice Accounted' AS "ActivityName",
    CAST(MIN(XAH.ACCOUNTING_DATE) AS TIMESTAMP) AS "EventTime",
    CAST(MIN(XAH.ACCOUNTING_DATE) AS TIMESTAMP) AS "EndTime",
    (SELECT USERNAME FROM PER_USERS PU WHERE PU.USER_ID = MIN(XAH.CREATED_BY) AND ROWNUM = 1) AS "UserName",
    IB.INVOICE_AMOUNT AS "InvoiceAmount",
    IB.VENDOR_NAME AS "VendorName",
    IB.PAYMENT_DUE_DATE AS "PaymentDueDate",
    IB.WFAPPROVAL_STATUS AS "InvoiceStatus",
    IB.COMPANY_CODE AS "CompanyCode"
FROM XLA_AE_HEADERS XAH
JOIN XLA_TRANSACTION_ENTITIES XTE ON XAH.ENTITY_ID = XTE.ENTITY_ID
JOIN INVOICE_BASE IB ON XTE.SOURCE_ID_INT_1 = IB.INVOICE_ID
WHERE XTE.APPLICATION_ID = 200
AND XTE.ENTITY_CODE = 'AP_INVOICES'
AND XAH.ACCOUNTING_ENTRY_STATUS_CODE = 'F' -- Final
GROUP BY
    IB.INVOICE_NUM, IB.INVOICE_AMOUNT, IB.VENDOR_NAME, IB.PAYMENT_DUE_DATE, IB.WFAPPROVAL_STATUS, IB.COMPANY_CODE

UNION ALL

-- 12. Payment Scheduled
SELECT 
    IB.INVOICE_NUM AS "InvoiceNumber",
    'Payment Scheduled' AS "ActivityName",
    CAST(MIN(APISC.CREATION_DATE) AS TIMESTAMP) AS "EventTime",
    CAST(MIN(APISC.CREATION_DATE) AS TIMESTAMP) AS "EndTime",
    (SELECT USERNAME FROM PER_USERS PU WHERE PU.USER_ID = MIN(APISC.CREATED_BY) AND ROWNUM = 1) AS "UserName",
    IB.INVOICE_AMOUNT AS "InvoiceAmount",
    IB.VENDOR_NAME AS "VendorName",
    IB.PAYMENT_DUE_DATE AS "PaymentDueDate",
    IB.WFAPPROVAL_STATUS AS "InvoiceStatus",
    IB.COMPANY_CODE AS "CompanyCode"
FROM AP_INV_SELECTION_CRITERIA_ALL APISC
JOIN AP_INVOICES_ALL AIA ON APISC.CHECKRUN_NAME = AIA.PAYMENT_STATUS_FLAG
JOIN INVOICE_BASE IB ON AIA.INVOICE_ID = IB.INVOICE_ID
GROUP BY
    IB.INVOICE_NUM, IB.INVOICE_AMOUNT, IB.VENDOR_NAME, IB.PAYMENT_DUE_DATE, IB.WFAPPROVAL_STATUS, IB.COMPANY_CODE

UNION ALL

-- 13. Payment Created
SELECT 
    IB.INVOICE_NUM AS "InvoiceNumber",
    'Payment Created' AS "ActivityName",
    CAST(AIPA.CREATION_DATE AS TIMESTAMP) AS "EventTime",
    CAST(AIPA.CREATION_DATE AS TIMESTAMP) AS "EndTime",
    (SELECT USERNAME FROM PER_USERS PU WHERE PU.USER_ID = AIPA.CREATED_BY AND ROWNUM = 1) AS "UserName",
    IB.INVOICE_AMOUNT AS "InvoiceAmount",
    IB.VENDOR_NAME AS "VendorName",
    IB.PAYMENT_DUE_DATE AS "PaymentDueDate",
    IB.WFAPPROVAL_STATUS AS "InvoiceStatus",
    IB.COMPANY_CODE AS "CompanyCode"
FROM AP_INVOICE_PAYMENTS_ALL AIPA
JOIN INVOICE_BASE IB ON AIPA.INVOICE_ID = IB.INVOICE_ID

UNION ALL

-- 14. Payment Executed
SELECT 
    IB.INVOICE_NUM AS "InvoiceNumber",
    'Payment Executed' AS "ActivityName",
    CAST(AC.CLEARED_DATE AS TIMESTAMP) AS "EventTime",
    CAST(AC.CLEARED_DATE AS TIMESTAMP) AS "EndTime",
    (SELECT USERNAME FROM PER_USERS PU WHERE PU.USER_ID = AC.LAST_UPDATED_BY AND ROWNUM = 1) AS "UserName",
    IB.INVOICE_AMOUNT AS "InvoiceAmount",
    IB.VENDOR_NAME AS "VendorName",
    IB.PAYMENT_DUE_DATE AS "PaymentDueDate",
    IB.WFAPPROVAL_STATUS AS "InvoiceStatus",
    IB.COMPANY_CODE AS "CompanyCode"
FROM AP_INVOICE_PAYMENTS_ALL AIPA
JOIN AP_CHECKS_ALL AC ON AIPA.CHECK_ID = AC.CHECK_ID
JOIN INVOICE_BASE IB ON AIPA.INVOICE_ID = IB.INVOICE_ID
WHERE AC.CLEARED_DATE IS NOT NULL

UNION ALL

-- 15. Invoice Canceled
SELECT
    IB.INVOICE_NUM AS "InvoiceNumber",
    'Invoice Canceled' AS "ActivityName",
    CAST(IB.CANCELLED_DATE AS TIMESTAMP) AS "EventTime",
    CAST(IB.CANCELLED_DATE AS TIMESTAMP) AS "EndTime",
    (SELECT USERNAME FROM PER_USERS PU WHERE PU.USER_ID = IB.CANCELLED_BY AND ROWNUM = 1) AS "UserName",
    IB.INVOICE_AMOUNT AS "InvoiceAmount",
    IB.VENDOR_NAME AS "VendorName",
    IB.PAYMENT_DUE_DATE AS "PaymentDueDate",
    IB.WFAPPROVAL_STATUS AS "InvoiceStatus",
    IB.COMPANY_CODE AS "CompanyCode"
FROM
    INVOICE_BASE IB
WHERE
    IB.CANCELLED_DATE IS NOT NULL

Pasos

Requisitos previos: Asegúrese de tener Python 3.6 o una versión posterior instalado en su sistema, junto con las bibliotecas requests y pandas. Puede instalarlas con pip: pip install requests pandas.
Configure la API de Oracle Fusion: En su instancia de Oracle Fusion, vaya a Security Console. Cree una nueva aplicación confidencial para obtener acceso a la API. Anote el Client ID y el Client Secret asignados. Asegúrese de que el usuario de la aplicación tenga los roles necesarios para leer los datos de facturas y pagos, como Financials - Payables Invoice Inquiry Duty.
Configure el script de Python: Copie el script de Python proporcionado en un archivo, por ejemplo, extract_fusion_invoices.py. Abra el archivo y complete las variables de marcador de posición al principio del script. Incluyen CLIENT_ID, CLIENT_SECRET, TOKEN_URL, FUSION_HOST, START_DATE y END_DATE. FUSION_HOST debe ser la URL base de sus aplicaciones Oracle Cloud.
Defina el período de extracción: Modifique las variables START_DATE y END_DATE para establecer el período de extracción de datos. Se recomienda empezar con un período más corto, como un mes, para probar el script y verificar el resultado.
Ejecute el script: Desde la línea de comandos o la terminal, vaya al directorio correspondiente y escriba python extract_fusion_invoices.py. El script se autenticará, obtendrá los datos y mostrará mensajes de progreso en la consola.
Proceso de autenticación: Primero, el script envía sus credenciales de cliente al proveedor de identidad de Oracle (TOKEN_URL) para obtener un token de acceso OAuth. Después, incluye este token en el encabezado de todas las solicitudes posteriores a la API de Fusion Financials para autenticarse.
Obtención de datos y paginación: El script consulta el endpoint REST de invoices para recuperar los registros creados durante el período especificado. Gestiona la paginación automáticamente: comprueba el indicador hasMore en la respuesta de la API y envía solicitudes posteriores con el parámetro offset actualizado hasta recuperar todos los datos de facturas.
Obtención de datos detallados: Para cada factura recuperada, el script realiza llamadas adicionales a la API para obtener los detalles asociados. Consulta el endpoint /child/holds para obtener información sobre retenciones y liberaciones, y el endpoint /payments, filtrado por número de factura, para recopilar los datos de pago.
Generación del Registro de eventos: La lógica principal del script procesa los datos JSON sin procesar de la API. Comprueba fechas, estados y registros secundarios específicos para generar filas distintas para cada una de las 15 actividades empresariales requeridas. Por ejemplo, si existe CancelledDate, se genera un evento 'Invoice Canceled'.
Revise el resultado: Al terminar, el script creará un archivo llamado invoice_event_log.csv en el mismo directorio. Abra el archivo CSV en una aplicación de hojas de cálculo para revisar los datos. Compruebe que estén presentes todas las columnas requeridas (InvoiceNumber, ActivityName, EventTime) y los atributos recomendados.
Prepare la carga: Asegúrese de que los encabezados de columna del archivo CSV coincidan con los nombres de atributo requeridos. Por lo general, no hace falta aplicar ningún otro formato. El archivo ya está listo para cargarse en su herramienta de Process Mining.

Configuración

Credenciales de autenticación: Se necesitan un Client ID y un Client Secret de una aplicación confidencial registrada en Security Console de Oracle Fusion. También debe proporcionar la Token URL de su dominio de identidad.
URL del host de la API: La variable FUSION_HOST debe contener la URL base de su instancia de Oracle Fusion, por ejemplo, https://[your-instance].fa.us2.oraclecloud.com.
Período: Las variables START_DATE y END_DATE son esenciales para controlar el alcance de la extracción. Para el análisis inicial, se recomienda extraer entre 3 y 6 meses de datos, a fin de equilibrar el volumen de datos y el rendimiento.
Endpoints de la API utilizados: El script interactúa principalmente con los endpoints fscmRestApi/resources/11.13.18.05/invoices y fscmRestApi/resources/11.13.18.05/payments. También utiliza el subrecurso /invoices/{InvoiceId}/child/holds.
Límite de paginación: La variable LIMIT del script controla cuántos registros se recuperan por solicitud a la API. El valor predeterminado es 100. Un valor más alto puede reducir el número de llamadas a la API, pero aumenta el consumo de memoria por solicitud. Si se agota el tiempo de espera, quizá sea necesario reducirlo.
Permisos necesarios: La cuenta de usuario asociada a las credenciales de la API necesita acceso de lectura a las facturas por pagar, las retenciones de facturas, los pagos y la información de proveedores. El rol Payables Invoice Inquiry Duty suele proporcionar los permisos necesarios.

Consulta de ejemplo python

import requests
import pandas as pd
import json
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
class=class="hl-string">"hl-comment"># Replace with your Oracle Fusion credentials and instance details
CLIENT_ID = class="hl-string">'[Your Client ID]'
CLIENT_SECRET = class="hl-string">'[Your Client Secret]'
TOKEN_URL = class="hl-string">'[Your Oracle Identity Cloud Service Token URL, e.g., https://idcs-....identity.oraclecloud.com/oauth2/v1/token]'
FUSION_HOST = class="hl-string">'[Your Fusion Host URL, e.g., https://your-fusion-instance.fa.ocs.oraclecloud.com]'

class=class="hl-string">"hl-comment"># --- Extraction Parameters ---
class=class="hl-string">"hl-comment"># Set the date range for the invoice extraction (YYYY-MM-DD)
START_DATE = class="hl-string">'2023-01-01'
END_DATE = class="hl-string">'2023-06-30'

class=class="hl-string">"hl-comment"># API request settings
LIMIT = 100

class=class="hl-string">"hl-comment"># --- Helper Functions ---
def get_access_token():
    class="hl-string">"""Authenticates and retrieves an OAuth2 access token."""
    headers = {class="hl-string">'Content-Type': class="hl-string">'application/x-www-form-urlencoded'}
    data = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'scope': class="hl-string">'urn:opc:resource:consumer::all'
    }
    try:
        response = requests.post(TOKEN_URL, headers=headers, data=data, auth=(CLIENT_ID, CLIENT_SECRET))
        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

def fetch_data(api_url, headers, params):
    class="hl-string">"""Fetches data from a given API endpoint with pagination handling."""
    all_items = []
    offset = 0
    has_more = True

    while has_more:
        params[class="hl-string">'offset'] = offset
        try:
            response = requests.get(api_url, headers=headers, params=params)
            response.raise_for_status()
            data = response.json()
            items = data.get(class="hl-string">'items', [])
            all_items.extend(items)
            has_more = data.get(class="hl-string">'hasMore', False)
            offset += len(items)
            print(fclass="hl-string">"Fetched {len(all_items)} records so far...")
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching data from {api_url}: {e}")
            print(fclass="hl-string">"Response content: {response.text}")
            break
    return all_items

class=class="hl-string">"hl-comment"># --- Main Extraction Logic ---
def main():
    class="hl-string">"""Main function to extract, transform, and save invoice data."""
    access_token = get_access_token()
    if not access_token:
        print(class="hl-string">"Could not obtain access token. Exiting.")
        return

    headers = {
        class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}',
        class="hl-string">'Content-Type': class="hl-string">'application/vnd.oracle.adf.resourceitem+json'
    }

    event_log = []

    class=class="hl-string">"hl-comment"># 1. Fetch Invoices
    print(class="hl-string">"Starting invoice extraction...")
    invoice_url = fclass="hl-string">'{FUSION_HOST}/fscmRestApi/resources/11.13.18.05/invoices'
    invoice_params = {
        class="hl-string">'q': fclass="hl-string">'CreationDate between \'{START_DATE}T00:00:00.000Z\class="hl-string">' and \'{END_DATE}T23:59:59.999Z\class="hl-string">'',
        class="hl-string">'onlyData': class="hl-string">'true',
        class="hl-string">'limit': LIMIT,
        class="hl-string">'fields': class="hl-string">'InvoiceId,InvoiceNumber,InvoiceAmount,CreationDate,CreatedBy,LastUpdateDate,LastUpdatedBy,SupplierName,ValidationDate,CancelledDate,ApprovalStatus,AccountingDate,PaymentStatus,DueDate,InvoiceStatus,BusinessUnitName'
    }
    invoices = fetch_data(invoice_url, headers, invoice_params)
    print(fclass="hl-string">"Total invoices fetched: {len(invoices)}")

    class=class="hl-string">"hl-comment"># 2. Process each invoice to create events
    for inv in invoices:
        case_id = inv.get(class="hl-string">'InvoiceNumber')
        if not case_id:
            continue

        base_event = {
            class="hl-string">'InvoiceNumber': case_id,
            class="hl-string">'EndTime': None,
            class="hl-string">'InvoiceAmount': inv.get(class="hl-string">'InvoiceAmount'),
            class="hl-string">'VendorName': inv.get(class="hl-string">'SupplierName'),
            class="hl-string">'PaymentDueDate': inv.get(class="hl-string">'DueDate'),
            class="hl-string">'InvoiceStatus': inv.get(class="hl-string">'InvoiceStatus'),
            class="hl-string">'CompanyCode': inv.get(class="hl-string">'BusinessUnitName')
        }

        class=class="hl-string">"hl-comment"># Activity: Invoice Created
        if inv.get(class="hl-string">'CreationDate'):
            event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Invoice Created', class="hl-string">'EventTime': inv[class="hl-string">'CreationDate'], class="hl-string">'UserName': inv.get(class="hl-string">'CreatedBy')})

        class=class="hl-string">"hl-comment"># Activity: Invoice Validated
        if inv.get(class="hl-string">'ValidationDate'):
            event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Invoice Validated', class="hl-string">'EventTime': inv[class="hl-string">'ValidationDate'], class="hl-string">'UserName': inv.get(class="hl-string">'LastUpdatedBy')})
        
        class=class="hl-string">"hl-comment"># Activities based on Approval Status
        if inv.get(class="hl-string">'ApprovalStatus') in [class="hl-string">'Initiated', class="hl-string">'Required']:
             event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Invoice Sent for Approval', class="hl-string">'EventTime': inv[class="hl-string">'LastUpdateDate'], class="hl-string">'UserName': inv.get(class="hl-string">'LastUpdatedBy')})
        elif inv.get(class="hl-string">'ApprovalStatus') in [class="hl-string">'Approved', class="hl-string">'Not required', class="hl-string">'Workflow approved']:
            event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Invoice Approved', class="hl-string">'EventTime': inv[class="hl-string">'LastUpdateDate'], class="hl-string">'UserName': inv.get(class="hl-string">'LastUpdatedBy')})
        elif inv.get(class="hl-string">'ApprovalStatus') == class="hl-string">'Rejected':
            event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Invoice Rejected', class="hl-string">'EventTime': inv[class="hl-string">'LastUpdateDate'], class="hl-string">'UserName': inv.get(class="hl-string">'LastUpdatedBy')})
        
        class=class="hl-string">"hl-comment"># This is an inference, might represent corrections after rejection or validation failure
        if inv.get(class="hl-string">'InvoiceStatus') == class="hl-string">'Needs revalidation':
            event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Invoice Corrected', class="hl-string">'EventTime': inv[class="hl-string">'LastUpdateDate'], class="hl-string">'UserName': inv.get(class="hl-string">'LastUpdatedBy')})

        class=class="hl-string">"hl-comment"># Activity: Invoice Accounted
        if inv.get(class="hl-string">'AccountingDate'):
             event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Invoice Accounted', class="hl-string">'EventTime': inv[class="hl-string">'AccountingDate'], class="hl-string">'UserName': inv.get(class="hl-string">'LastUpdatedBy')})

        class=class="hl-string">"hl-comment"># Activity: Invoice Canceled
        if inv.get(class="hl-string">'CancelledDate'):
            event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Invoice Canceled', class="hl-string">'EventTime': inv[class="hl-string">'CancelledDate'], class="hl-string">'UserName': inv.get(class="hl-string">'LastUpdatedBy')})
        
        class=class="hl-string">"hl-comment"># Activity: Matched to PO - Inference based on PaymentStatus which can indicate matching holds resolved
        if inv.get(class="hl-string">'PaymentStatus') == class="hl-string">'Available':
             event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Invoice Matched to PO', class="hl-string">'EventTime': inv.get(class="hl-string">'ValidationDate') or inv.get(class="hl-string">'LastUpdateDate'), class="hl-string">'UserName': inv.get(class="hl-string">'LastUpdatedBy')})

        class=class="hl-string">"hl-comment"># 3. Fetch Holds for the Invoice
        holds_url = fclass="hl-string">'{FUSION_HOST}/fscmRestApi/resources/11.13.18.05/invoices/{inv["InvoiceId"]}/child/holds'
        holds = fetch_data(holds_url, headers, {class="hl-string">'onlyData': class="hl-string">'true'})
        for hold in holds:
            class=class="hl-string">"hl-comment"># Activity: Hold Placed on Invoice
            event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Hold Placed on Invoice', class="hl-string">'EventTime': hold[class="hl-string">'HoldDate'], class="hl-string">'UserName': hold.get(class="hl-string">'LastUpdatedBy')})
            if hold.get(class="hl-string">'HoldReason') in [class="hl-string">'Price', class="hl-string">'Qty Ord', class="hl-string">'Qty Rec', class="hl-string">'Quality']:
                event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Matching Discrepancy Identified', class="hl-string">'EventTime': hold[class="hl-string">'HoldDate'], class="hl-string">'UserName': hold.get(class="hl-string">'LastUpdatedBy')})
            
            class=class="hl-string">"hl-comment"># Activity: Hold Released from Invoice
            if hold.get(class="hl-string">'ReleaseDate'):
                event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Hold Released from Invoice', class="hl-string">'EventTime': hold[class="hl-string">'ReleaseDate'], class="hl-string">'UserName': hold.get(class="hl-string">'LastUpdatedBy')})

        class=class="hl-string">"hl-comment"># 4. Fetch Payments for the Invoice
        if inv.get(class="hl-string">'PaymentStatus') in [class="hl-string">'Paid', class="hl-string">'Partially paid']:
            payment_url = fclass="hl-string">'{FUSION_HOST}/fscmRestApi/resources/11.13.18.05/payments'
            payment_params = {
                class="hl-string">'q': fclass="hl-string">'InvoiceNumber=\'{case_id}\class="hl-string">'',
                class="hl-string">'onlyData': class="hl-string">'true',
                class="hl-string">'fields': class="hl-string">'PaymentId,CreationDate,CreatedBy,ClearedDate,PaymentDate'
            }
            payments = fetch_data(payment_url, headers, payment_params)
            for pmt in payments:
                 class=class="hl-string">"hl-comment"># Activity: Payment Scheduled (Approximation using Payment Creation Date)
                 event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Payment Scheduled', class="hl-string">'EventTime': pmt[class="hl-string">'CreationDate'], class="hl-string">'UserName': pmt.get(class="hl-string">'CreatedBy')})
                 class=class="hl-string">"hl-comment"># Activity: Payment Created
                 event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Payment Created', class="hl-string">'EventTime': pmt[class="hl-string">'PaymentDate'], class="hl-string">'UserName': pmt.get(class="hl-string">'CreatedBy')})
                 class=class="hl-string">"hl-comment"># Activity: Payment Executed
                 if pmt.get(class="hl-string">'ClearedDate'):
                     event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Payment Executed', class="hl-string">'EventTime': pmt[class="hl-string">'ClearedDate'], class="hl-string">'UserName': pmt.get(class="hl-string">'CreatedBy')})

    class=class="hl-string">"hl-comment"># 5. Create and Save DataFrame
    if not event_log:
        print(class="hl-string">"No events were generated. Please check your date range and API responses.")
        return

    df = pd.DataFrame(event_log)
    df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'], inplace=True)
    df[class="hl-string">'EventTime'] = pd.to_datetime(df[class="hl-string">'EventTime']).dt.strftime(class="hl-string">'%Y-%m-%d %H:%M:%S')
    if class="hl-string">'EndTime' in df.columns:
         df[class="hl-string">'EndTime'] = pd.to_datetime(df[class="hl-string">'EndTime']).dt.strftime(class="hl-string">'%Y-%m-%d %H:%M:%S')

    output_filename = class="hl-string">'invoice_event_log.csv'
    df.to_csv(output_filename, index=False)
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_filename}")

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

¿Todo listo para empezar?

Empiece a optimizar el procesamiento de facturas preparando sus datos con este Template. Obtenga información valiosa e impulse mejoras importantes en la eficiencia de su organización.

Volver a la guía de mejora

Descargar Template

Optimice ahora el procesamiento de facturas P2P y reduzca un 30 % la duración de los ciclos

Elimine los cuellos de botella en Oracle Fusion Financials y reduzca un 30 % el tiempo de ciclo.

Comience la prueba gratuita

No se requiere tarjeta de crédito. Vea resultados en pocos días.

Su Template de datos para compra a pago, procesamiento de facturas

Su Template de datos para compra a pago, procesamiento de facturas

Atributos del procesamiento de facturas de compra a pago

Actividades del procesamiento de facturas de compra a pago

Guías de extracción

Exportación masiva de datos con Oracle BI Cloud Connector (BICC)

Pasos

Configuración

Consulta de ejemplo sql

Informe de Oracle BI Publisher con modelo de datos SQL personalizado

Pasos

Configuración

Consulta de ejemplo sql

Extracción mediante script de Python con la API REST de Fusion Financials

Pasos

Configuración

Consulta de ejemplo python

¿Todo listo para empezar?

Optimice ahora el procesamiento de facturas P2P y reduzca un 30 % la duración de los ciclos