> Melhoria contínua de processos > Purchase to Pay Processamento de faturas > Oracle Fusion Financials > Template de dados

Seu Template de dados de Purchase to Pay - processamento de faturas

Oracle Fusion Financials

← Voltar ao guia de melhoria

Purchase to Pay - Atributos do processamento de faturas (20) Purchase to Pay - Atividades de processamento de faturas (15) Guias de extração (3)

Seu Template de dados de Purchase to Pay - processamento de faturas

Este Template foi criado para orientar você na coleta dos dados essenciais para analisar o processo de Purchase to Pay, especificamente o processamento de faturas, no Oracle Fusion Financials. Ele apresenta os principais atributos e atividades e orienta como extrair essas informações do seu sistema. Usar este Template ajuda você a preparar um Event Log preciso e completo para Process Mining.

Atributos recomendados para coletar
Principais atividades para acompanhar
Orientações para extração no Oracle Fusion Financials

Novo em Event Logs? Aprenda como criar um Event Log de Process Mining.

Baixar Template

Purchase to Pay - Atributos do processamento de faturas

Estes são os campos de dados recomendados para incluir no seu Event Log e realizar uma análise completa do processamento de faturas de Purchase to Pay.

3 Obrigatório 7 Recomendado 10 Opcional

	Nome	Descrição
	Número da fatura InvoiceNumber	O identificador exclusivo de uma fatura de fornecedor.
Descrição O número da fatura funciona como o identificador principal do caso, vinculando todas as atividades e eventos relacionados a uma única fatura de fornecedor, desde sua criação até o pagamento final. Cada fatura é tratada como uma instância de caso única na análise do processo. No Process Mining, esse atributo é fundamental para reconstruir a jornada completa de cada fatura. Ele permite analisar fluxos de processo, tempos de ciclo e variações por fatura. É a chave para conectar diferentes atividades, como validação, aprovação e pagamento, em uma narrativa coerente do processo. Por que isso importa Esse é o identificador essencial do caso que conecta todas as etapas relacionadas do processo, permitindo rastrear todo o ciclo de vida de uma fatura. Onde obter Normalmente encontrado na tabela AP_INVOICES_ALL, na coluna INVOICE_NUM. Exemplos INV-2023-001987654321ACME-FIN-5501
	Atividade ActivityName	O nome da atividade de negócio ou do evento ocorrido no processo da fatura.
Descrição Esse atributo descreve uma etapa específica ou uma mudança de status no ciclo de vida da fatura, como 'Invoice Created', 'Invoice Approved' ou 'Payment Executed'. Ele forma a sequência de eventos que constitui o fluxo do processo. Analisar a sequência e a frequência das atividades é a base do Process Mining. Isso ajuda a descobrir o caminho real do processo, identificar gargalos onde as atividades atrasam e detectar desvios ou ciclos de retrabalho, como uma fatura rejeitada depois da aprovação. Por que isso importa Ele define as etapas do processo, o que é essencial para visualizar o mapa do processo, analisar variações do fluxo e identificar gargalos. Onde obter Esse atributo normalmente é derivado de uma combinação de campos de status, tabelas de auditoria ou registros de Workflow no Oracle Fusion Financials, como AP_INVOICES_ALL.WFAPPROVAL_STATUS ou tabelas de Workflow relacionadas. Exemplos Fatura validadaBloqueio aplicado à faturaFatura aprovadaPagamento executado
	Horário de início EventTime	O registro de data e hora que indica quando uma atividade ou evento ocorreu.
Descrição Esse atributo fornece a data e o horário de cada atividade no processo da fatura. Ele é essencial para todas as análises de processo baseadas em tempo, incluindo o cálculo de tempos de ciclo, durações e tempos de espera entre etapas. Ao ordenar os eventos cronologicamente usando esse registro de data e hora, as ferramentas de Process Mining conseguem reconstruir a sequência exata de atividades de cada fatura. Isso permite calcular KPIs importantes, como o Average Invoice Cycle Time, e ajuda a identificar quais etapas do processo consomem mais tempo. Por que isso importa Esse registro de data e hora é essencial para calcular todas as métricas de performance relacionadas à duração e ao tempo, como tempos de ciclo e gargalos. Onde obter Esse registro de data e hora é derivado de vários campos de data nas tabelas do Oracle Fusion, como CREATION_DATE ou LAST_UPDATE_DATE em tabelas como AP_INVOICES_ALL ou tabelas relacionadas de Workflow e pagamentos. Exemplos 2023-04-15T10:00:00Z2023-04-16T14:35:10Z2023-04-20T09:05:00Z
	Código da empresa CompanyCode	O identificador da entidade legal ou da empresa que processa a fatura.
Descrição O código da empresa representa a entidade de negócio específica da organização que é financeiramente responsável pela fatura. Em organizações com várias empresas, esse é um dado organizacional fundamental. Esse atributo permite segmentar a análise do processo por entidade legal. Isso é útil para comparar a performance do processo entre diferentes partes da empresa, identificar gargalos ou problemas de Conformidade específicos de cada entidade e garantir que os KPIs possam ser reportados no nível da empresa. Ele também costuma ser um fator para determinar o Workflow de aprovação correto. Por que isso importa Permite comparar processos e fazer benchmarking de performance entre diferentes entidades legais ou unidades de negócio da organização. Onde obter Normalmente é representado pelo campo LEGAL_ENTITY_ID ou por um campo semelhante na AP_INVOICES_ALL, que pode ser associado a tabelas do General Ledger para obter um código ou nome. Exemplos 1001US01DE01
	Data de vencimento do pagamento PaymentDueDate	A data até a qual o pagamento da fatura deve ser feito ao fornecedor.
Descrição A data de vencimento do pagamento é calculada com base nas condições de pagamento acordadas com o fornecedor. Ela funciona como o prazo para realizar o pagamento, evitar penalidades, manter um bom relacionamento com o fornecedor e aproveitar possíveis descontos por pagamento antecipado. Esse atributo é essencial para o Dashboard 'On-Time Payment Performance' e para o KPI associado. Ao comparar o registro de data e hora da execução efetiva do pagamento com a data de vencimento, a análise pode classificar os pagamentos como feitos no prazo ou atrasados, ajudando a organização a monitorar e melhorar a pontualidade dos pagamentos. Por que isso importa É a referência para medir a performance de pagamentos no prazo, um KPI crítico para a gestão de fornecedores e a saúde financeira. Onde obter Essa data geralmente está disponível em tabelas de programação de pagamentos, como AP_PAYMENT_SCHEDULES_ALL, vinculadas à fatura. Exemplos 2023-05-152023-06-012023-06-30
	Horário de término EndTime	O registro de data e hora que indica quando uma atividade ou evento foi concluído.
Descrição O horário de término marca a conclusão de uma atividade específica. Enquanto o horário de início sinaliza o começo, o horário de término fornece o ponto final, permitindo calcular com precisão a duração de cada etapa. Na análise, a diferença entre o horário de término e o horário de início fornece o tempo de processamento de cada atividade. Isso é essencial para uma análise detalhada de performance, ajudando a distinguir o tempo de processamento ativo do tempo de espera. Por exemplo, permite medir o tempo efetivamente gasto por uma pessoa aprovadora em uma tarefa de aprovação em comparação com o tempo em que a tarefa ficou aguardando na fila. Por que isso importa Permite calcular com precisão os tempos de processamento das atividades, separando o tempo de trabalho ativo do tempo de espera. Onde obter Esse é um atributo conceitual derivado do horário de início do evento seguinte na sequência de um determinado caso. Exemplos 2023-04-15T10:05:12Z2023-04-16T15:00:00Z2023-04-20T09:15:30Z
	Nome de usuário UserName	O nome da pessoa usuária que executou a atividade.
Descrição Esse atributo identifica a pessoa usuária ou o agente do sistema responsável por executar uma atividade, como validar uma fatura, aplicar um bloqueio ou aprovar um pagamento. Ele adiciona ao processo uma dimensão de recurso humano ou sistêmico. Analisar por pessoa usuária ajuda a entender a distribuição da carga de trabalho, identificar pessoas com melhor performance e detectar possíveis necessidades de treinamento ou problemas de Conformidade. Por exemplo, pode revelar se determinadas pessoas estão constantemente associadas a ciclos de retrabalho ou se etapas específicas de aprovação são sempre tratadas pela mesma pessoa, criando um possível ponto único de falha. Por que isso importa Permite analisar a performance dos recursos, equilibrar a carga de trabalho e identificar quais pessoas usuárias ou equipes participam de etapas específicas do processo. Onde obter Essas informações geralmente são armazenadas em colunas de auditoria, como CREATED_BY ou LAST_UPDATED_BY, em tabelas como AP_INVOICES_ALL ou em registros de Workflow relacionados. Exemplos john.doejane.smithSystem.Admin
	Nome do fornecedor VendorName	O nome do fornecedor que emitiu a fatura.
Descrição Esse atributo identifica a entidade fornecedora à qual a fatura pertence. As informações do fornecedor fornecem um contexto de negócio essencial para a transação financeira. Analisar o processo por fornecedor pode revelar insights importantes sobre o relacionamento e a performance dos fornecedores. Por exemplo, pode destacar se as faturas de determinados fornecedores têm maior probabilidade de apresentar divergências de conciliação, bloqueios ou atrasos. Essas informações podem ser usadas para melhorar o cadastro de fornecedores, a comunicação e a eficiência geral da cadeia de suprimentos. Também são usadas para identificar possíveis pagamentos duplicados. Por que isso importa Permite analisar o processo por fornecedor, ajudando a identificar problemas com fornecedores específicos que causam atrasos ou exceções. Onde obter Encontrado na tabela POZ_SUPPLIERS. A tabela de faturas AP_INVOICES_ALL contém um VENDOR_ID, que pode ser usado para fazer a junção com a tabela de fornecedores. Exemplos Acme CorporationGlobal Tech Inc.Office Supplies Co.
	Status da fatura InvoiceStatus	O status atual da fatura em seu ciclo de vida.
Descrição Esse atributo reflete o último estado conhecido da fatura, como 'Validated', 'Needs Revalidation', 'Paid' ou 'Canceled'. Ele fornece uma visão de onde a fatura está no processo em determinado momento. O status da fatura é essencial para o Dashboard 'Current Invoice Status Distribution', que ajuda gestores de operações a identificar pendências e monitorar a saúde geral do pipeline de processamento de faturas. Analisar como os status mudam ao longo do tempo também pode fornecer uma visão simplificada do fluxo do processo. Por que isso importa Fornece uma visão do estado atual das faturas, essencial para Dashboards operacionais que acompanham pendências e carga de trabalho. Onde obter Consulte a documentação do Oracle Fusion Financials. O status pode ser derivado de campos como WFAPPROVAL_STATUS na AP_INVOICES_ALL ou de tabelas relacionadas de aprovação e pagamentos. Exemplos ValidadoPagoCanceladoPrecisa ser revalidada
	Valor da fatura InvoiceAmount	O valor monetário total da fatura.
Descrição O valor da fatura representa o total devido ao fornecedor conforme indicado na fatura. Esse é um atributo financeiro crítico que influencia todo o processo, muitas vezes determinando o caminho de aprovação, o nível de análise e a prioridade do pagamento. Na análise de Process Mining, o valor da fatura é uma dimensão importante para filtros e segmentações. Por exemplo, os analistas podem comparar o processo de faturas de alto valor com o de faturas de baixo valor para verificar se caminhos diferentes são seguidos ou se os tempos de ciclo variam significativamente. Ele também é essencial para calcular KPIs financeiros e avaliar o impacto monetário de ineficiências do processo, como pagamentos atrasados. Por que isso importa Esse valor é essencial para a análise financeira, para entender desvios do processo com base no valor e para KPIs como Approval Compliance Rate. Onde obter Encontrado na tabela AP_INVOICES_ALL, na coluna INVOICE_AMOUNT. Exemplos 1500.00250.75125000.50
	Data da fatura InvoiceDate	A data informada no documento da fatura do fornecedor.
Descrição Este atributo corresponde à data em que o fornecedor emitiu oficialmente a fatura. É uma informação essencial do documento de origem e serve como ponto de partida para calcular a data de vencimento do pagamento com base nas condições de pagamento acordadas. Embora nem sempre marque o início do processo interno, a data da fatura fornece um contexto importante. Ela é usada em conjunto com o nome do fornecedor e o valor da fatura para ajudar a identificar possíveis faturas duplicadas. Analisar o intervalo entre a data da fatura e a data em que ela é criada no sistema também pode revelar ineficiências no recebimento de correspondências ou na entrada de faturas. Por que isso importa É um dado essencial para identificar faturas duplicadas e calcular as datas de vencimento dos pagamentos. Onde obter Este é um campo padrão da tabela AP_INVOICES_ALL, chamado INVOICE_DATE. Exemplos 2023-04-102023-05-012023-05-25
	É retrabalho IsRework	Um indicador booleano que identifica atividades que fazem parte de um loop de retrabalho.
Descrição Este indicador recebe o valor true para atividades que representam um desvio do fluxo ideal do processo, como 'Fatura corrigida' ou uma segunda ocorrência de 'Fatura validada' após uma rejeição. Ele ajuda a marcar e quantificar explicitamente os loops ineficientes do processo. Este atributo é essencial para o Dashboard 'Taxa de retrabalho e tratamento de exceções'. Ao marcar as atividades de retrabalho, os analistas podem quantificar facilmente o volume e o custo do retrabalho, identificar suas causas-raiz e medir o impacto das iniciativas de melhoria de processos voltadas a fazer certo na primeira vez. Por que isso importa Ele identifica e quantifica o retrabalho de forma explícita, facilitando a análise da frequência, das causas e do impacto das ineficiências do processo. Onde obter Este é um atributo calculado. A lógica é definida durante a transformação dos dados para identificar sequências de atividades que caracterizam retrabalho. Exemplos truefalse
	Moeda InvoiceCurrencyCode	A moeda do valor da fatura.
Descrição Este atributo especifica a moeda em que a fatura é expressa, por exemplo, USD, EUR ou GBP. Ele é um contexto essencial para o campo Valor da fatura. Em uma organização global, analisar as faturas por moeda é importante para os relatórios financeiros e para entender as variações do processo por região. Isso garante que os valores monetários sejam interpretados corretamente e permite análises específicas sobre práticas de pagamento ou limites de aprovação por moeda. Por que isso importa Fornece o contexto necessário para todos os valores financeiros, garantindo uma interpretação e uma análise precisas, especialmente em operações multinacionais. Onde obter Está na tabela AP_INVOICES_ALL, na coluna INVOICE_CURRENCY_CODE. Exemplos USDEURGBPCAD
	Motivo da divergência na conciliação MatchingDiscrepancyReason	O motivo específico da divergência entre uma fatura, um pedido de compra e um recebimento.
Descrição Este atributo detalha por que uma fatura não passou pelo processo automatizado de conciliação. Os motivos comuns incluem diferenças de preço, quantidade ou códigos de itens entre a fatura e o pedido de compra ou recebimento de mercadorias correspondente. Essas informações são essenciais para o Dashboard 'Taxa de divergência na conciliação de faturas'. Ao categorizar e analisar os motivos das divergências, as empresas podem identificar problemas sistêmicos nos processos de compras ou recebimento. Isso permite tomar ações corretivas que aumentam a taxa de processamento direto e sem intervenção manual das faturas. Por que isso importa Ele explica por que as faturas não passam pela conciliação automatizada, fornecendo os insights necessários para melhorar as taxas de conciliação na primeira tentativa e reduzir o retrabalho manual. Onde obter Consulte a documentação do Oracle Fusion Financials. Essa informação pode ser registrada como um tipo específico de motivo de retenção na AP_HOLDS_ALL ou em tabelas relacionadas aos detalhes da conciliação. Exemplos Preço unitário diferente do pedido de compraQuantidade faturada > quantidade recebidaItem inválido na nota fiscal
	Motivo do bloqueio HoldReason	O motivo pelo qual uma retenção ou um bloqueio de pagamento foi aplicado a uma fatura.
Descrição Quando uma fatura é colocada em retenção, este atributo especifica o motivo, como 'Divergência de preço', 'Divergência de quantidade' ou 'Aguardando recebimento de mercadorias'. Isso fornece o contexto para entender por que o fluxo normal do processo foi interrompido. Este atributo é a principal dimensão do Dashboard 'Tendências e análise de bloqueios de pagamento'. Ao analisar a frequência dos diferentes motivos de retenção, a empresa pode identificar e tratar as causas-raiz dos bloqueios de pagamento, como problemas nos processos de compras ou na precisão do faturamento dos fornecedores, reduzindo os atrasos no processamento. Por que isso importa Ele fornece a causa-raiz dos bloqueios de pagamento, permitindo melhorias direcionadas para reduzir a frequência das retenções e dos atrasos nos pagamentos. Onde obter As informações de retenção geralmente ficam armazenadas na tabela AP_HOLDS_ALL, que se relaciona à fatura e contém um motivo ou código de retenção. Exemplos Divergência de preçoQuantidade faturada excede a quantidade recebidaNúmero do pedido de compra inválido
	Nome da pessoa aprovadora ApproverName	O nome da pessoa que aprovou ou rejeitou a fatura.
Descrição Esse atributo registra a identidade da pessoa que tomou uma ação durante a etapa de aprovação. Isso é registrado em atividades como 'Invoice Approved' ou 'Invoice Rejected'. Na análise, o nome da pessoa aprovadora é usado para entender as cargas de trabalho de aprovação, medir os tempos de ciclo individuais e auditar a Conformidade com as políticas de aprovação. Para o KPI 'Approval Compliance Rate', esse atributo pode ser comparado às regras de delegação de autoridade com base no valor da fatura e no código da empresa. Por que isso importa É essencial para analisar tempos de ciclo de aprovação, garantir a Conformidade com as políticas da matriz de aprovação e entender a distribuição da carga de trabalho. Onde obter Essas informações ficam nas tabelas de Workflow ou de histórico de aprovações do Oracle Fusion associadas ao objeto da fatura. Exemplos David WilsonSarah JohnsonMichael Brown
	Número do pedido de compra PurchaseOrderNumber	O identificador do pedido de compra associado à fatura.
Descrição Este atributo relaciona a fatura ao pedido de compra correspondente, ou PO, que autorizou a aquisição dos bens ou serviços. As faturas podem estar vinculadas a um PO ou não. Analisar os dados por PO cria uma conexão com a etapa de compras do processo P2P. Isso ajuda a entender o nível de conformidade do processo de compras e se problemas no faturamento, como divergências na conciliação, têm origem em falhas no PO inicial. A presença ou ausência de um número de PO é uma das principais formas de segmentar e analisar diferentes caminhos de processamento de faturas. Por que isso importa Ele relaciona a fatura ao processo de compras e é um atributo essencial para analisar os fluxos de faturas com e sem PO. Onde obter Essas informações estão disponíveis relacionando os itens de linha da fatura em AP_INVOICE_LINES_ALL às distribuições do PO por meio de PO_DISTRIBUTION_ID. Exemplos PO-2023-5001600789PO-FIN-9981
	Pagamento no prazo IsOnTimePayment	Um indicador booleano que informa se a fatura foi paga até a data de vencimento.
Descrição Este indicador recebe o valor true quando o pagamento é executado na data de vencimento ou antes dela, e false nos demais casos. Ele fornece uma classificação simples e clara para cada fatura paga. Este atributo calculado dá suporte direto ao KPI Taxa de pagamentos no prazo e ao Dashboard correspondente. Ele simplifica a análise ao permitir que os usuários filtrem, contem e visualizem facilmente a proporção de pagamentos atrasados e realizados no prazo, sem precisar comparar datas durante a análise. Isso ajuda a identificar rapidamente a dimensão dos atrasos nos pagamentos e acompanhar as melhorias ao longo do tempo. Por que isso importa Ele simplifica a análise da pontualidade dos pagamentos e é a entrada direta para calcular o KPI Taxa de pagamentos no prazo. Onde obter Este é um atributo calculado, obtido pela comparação do timestamp da atividade 'Pagamento executado' com o atributo 'PaymentDueDate'. Exemplos truefalse
	Sistema de origem SourceSystem	Identifica o sistema de origem onde os dados do evento foram registrados.
Descrição Esse atributo especifica o aplicativo ou módulo de origem que gerou os dados, como o Oracle Fusion Financials. Em ambientes com vários sistemas integrados, esse campo ajuda a distinguir a origem das diferentes etapas do processo. Entender o sistema de origem é útil para validar dados, solucionar problemas e analisar variações do processo que podem ser específicas de determinado sistema. Isso garante clareza em ambientes de TI complexos, nos quais a jornada de uma fatura pode passar por vários aplicativos. Por que isso importa Ele fornece contexto sobre a origem dos dados, o que é importante para a governança de dados, a solução de problemas e a análise do comportamento do processo específico de cada sistema. Onde obter Geralmente é um valor estático adicionado durante a extração dos dados para identificar a origem do conjunto de dados. Exemplos Oracle Fusion FinancialsOracle Payables Cloud
	Última atualização dos dados LastUpdateDate	Registro de data e hora que indica quando o registro foi atualizado pela última vez no sistema de origem.
Descrição Esse atributo reflete o horário da modificação mais recente dos dados subjacentes no Oracle Fusion Financials. Ele é usado para gerenciar cargas incrementais de dados e manter o modelo de Process Mining atualizado. Embora não seja usado diretamente na análise do fluxo do processo, esse registro de data e hora técnico é essencial para manter a atualidade e a integridade dos dados. Ele permite que os pipelines de dados consultem com eficiência apenas os registros novos ou alterados desde a última atualização, reduzindo a carga no sistema de origem. Por que isso importa Garante que os pipelines de dados possam ser executados de forma eficiente e incremental, mantendo a análise do processo atualizada sem recargas completas. Onde obter Comumente encontrado como LAST_UPDATE_DATE em várias tabelas do Oracle Fusion, incluindo AP_INVOICES_ALL. Exemplos 2023-05-20T11:00:00Z2023-05-21T16:45:00Z

Obrigatório Recomendado Opcional

Purchase to Pay - Atividades de processamento de faturas

Estas são as principais etapas e marcos do processo que você deve registrar no seu Event Log para descobrir o processo com precisão.

6 Recomendado 9 Opcional

	Atividade	Descrição
	Fatura aprovada	A fatura foi totalmente aprovada por todas as pessoas necessárias no Workflow. Agora ela está pronta para a contabilização e o agendamento do pagamento.
Por que isso importa Um marco importante que indica a conclusão bem-sucedida do processo de aprovação. Atrasos antes dessa etapa são gargalos comuns. Onde obter Inferido a partir da mudança de APPROVAL_STATUS na tabela AP_INVOICES_ALL para um estado final de aprovação, como 'Approved' ou 'Workflow Approved'. O histórico de auditoria desse campo fornece o registro de data e hora. Captura Inferido a partir da alteração de AP_INVOICES_ALL.APPROVAL_STATUS para 'Approved'. Tipo de evento inferred
	Fatura conciliada com PO	Essa atividade indica a conciliação bem-sucedida de uma linha da fatura com a linha correspondente de um Purchase Order, confirmando que os produtos ou serviços faturados foram solicitados. Normalmente, trata-se de uma ação automática ou manual registrada no sistema.
Por que isso importa É essencial para a conciliação de três vias, envolvendo o PO, o recebimento e a fatura. Falhas nessa etapa são uma das principais fontes de exceções e atrasos. Onde obter Pode ser inferido a partir da criação de registros na tabela AP_INVOICE_DISTRIBUTIONS_ALL que vinculam a fatura a uma distribuição do PO (PO_DISTRIBUTION_ID). O status da conciliação no nível da linha em AP_INVOICE_LINES_ALL também pode ser usado. Captura Inferido a partir do preenchimento dos dados de distribuição do PO nas linhas da fatura. Tipo de evento inferred
	Fatura contabilizada	A fatura é lançada com sucesso no General Ledger, gerando lançamentos contábeis. Esse evento confirma que o impacto financeiro da fatura foi formalmente registrado.
Por que isso importa Um ponto de controle financeiro crítico e um pré-requisito para o pagamento. Confirma que a fatura foi totalmente validada e aprovada e está pronta para liquidação. Onde obter Inferido a partir do status na tabela AP_INVOICE_DISTRIBUTIONS_ALL (ACCRUAL_POSTED_FLAG = 'Y') ou pela verificação de lançamentos contábeis correspondentes nas tabelas do General Ledger, como XLA_AE_HEADERS. Captura Inferido a partir de indicadores na AP_INVOICE_DISTRIBUTIONS_ALL ou de lançamentos vinculados no GL. Tipo de evento inferred
	Fatura criada	Representa a criação inicial de um registro de fatura no sistema, seja por lançamento manual, digitalização ou envio eletrônico. Esse evento normalmente é capturado quando uma nova linha é inserida na tabela principal de faturas.
Por que isso importa Marca o início do ciclo de processamento da fatura. Analisar o tempo a partir desse evento ajuda a entender a eficiência do lançamento de dados e os atrasos gerais no início do processo. Onde obter No Oracle Fusion Financials, isso corresponde ao registro de data e hora de criação do registro na tabela AP_INVOICES_ALL, especificamente na coluna CREATION_DATE. Captura Registro de data e hora da criação na AP_INVOICES_ALL. Tipo de evento explicit
	Fatura enviada para aprovação	A fatura é enviada para um Workflow de aprovação com base nas regras de negócio configuradas. Isso marca o início do ciclo formal de aprovação.
Por que isso importa Inicia uma parte crítica do processo. Acompanhar esse horário de início é essencial para medir e otimizar o 'Invoice Approval Cycle Time'. Onde obter Inferido a partir de uma mudança de status na tabela AP_INVOICES_ALL, quando APPROVAL_STATUS passa para um estado como 'Initiated' ou 'Pending Approval'. As tabelas do Workflow também podem conter esse evento. Captura Inferido a partir da alteração de AP_INVOICES_ALL.APPROVAL_STATUS para 'Initiated'. Tipo de evento inferred
	Pagamento executado	A confirmação final de que o pagamento foi realizado e compensado. Para cheques, seria a data de compensação; para pagamentos eletrônicos, é a confirmação do banco.
Por que isso importa Essa é a atividade final do ciclo da fatura, marcando a conclusão bem-sucedida do processo. É o ponto final para calcular o 'Average Invoice Cycle Time' e o 'On-Time Payment Rate'. Onde obter Inferido a partir da atualização do status do pagamento para 'Cleared' ou 'Reconciled' na tabela AP_CHECKS_ALL, usando CLEARED_DATE, ou por meio de dados da conciliação bancária no módulo Cash Management (CE_STATEMENT_LINES). Captura Inferido a partir das atualizações de status na AP_CHECKS_ALL ou da conciliação no módulo CE. Tipo de evento inferred
	Bloqueio aplicado à fatura	Uma atividade genérica que representa a aplicação de qualquer bloqueio a uma fatura, impedindo seu avanço para o pagamento. Isso pode ocorrer por vários motivos, como problemas de conciliação, fundos insuficientes ou intervenção manual.
Por que isso importa Afeta diretamente o tempo de ciclo e pode causar pagamentos atrasados. Analisar os bloqueios é essencial para identificar e resolver problemas sistêmicos do processo, apoiando a análise de 'Payment Block Trends'. Onde obter Registrado explicitamente na tabela AP_HOLDS_ALL. Cada linha representa um bloqueio com uma data de criação (HOLD_DATE) e um motivo. Captura Criação de um registro na tabela AP_HOLDS_ALL. Tipo de evento explicit
	Bloqueio liberado da fatura	Esse evento marca a resolução de um bloqueio aplicado anteriormente à fatura. Uma pessoa ou um processo automatizado remove o bloqueio, permitindo que a fatura continue seu ciclo.
Por que isso importa O tempo entre a aplicação e a liberação de um bloqueio é uma medida crítica da eficiência no tratamento de exceções. Isso apoia o KPI 'Average Exception Resolution Time'. Onde obter Registrado na tabela AP_HOLDS_ALL. Quando um bloqueio é liberado, os campos RELEASE_LOOKUP_CODE e RELEASE_REASON são preenchidos junto com LAST_UPDATE_DATE. Captura Atualização de um registro na tabela AP_HOLDS_ALL indicando que o bloqueio foi liberado. Tipo de evento explicit
	Divergência de conciliação identificada	Ocorre quando o sistema ou uma pessoa identifica uma divergência entre as informações da fatura, do pedido de compra e do recebimento, como preço ou quantidade. Isso geralmente resulta na aplicação de um bloqueio do sistema à fatura.
Por que isso importa Destaca exceções do processo que exigem intervenção manual. Acompanhar esses eventos é essencial para o KPI 'Invoice Matching Discrepancy Rate' e para a análise de causas raiz. Onde obter Isso geralmente é registrado como um tipo específico de bloqueio aplicado à fatura. Consulte a tabela AP_HOLDS_ALL para verificar tipos de bloqueio relacionados à conciliação, como 'QTY REC' ou 'PRICE'. HOLD_DATE indica o registro de data e hora. Captura Criação de um registro na AP_HOLDS_ALL com um tipo de bloqueio relacionado à conciliação. Tipo de evento explicit
	Fatura cancelada	A fatura foi anulada ou cancelada e não será mais processada nem paga. Isso representa um estado final do processo.
Por que isso importa Um ponto final importante para faturas que não resultam em pagamento. Analisar os cancelamentos pode revelar problemas com faturas duplicadas ou envios incorretos por fornecedores. Onde obter Inferido a partir de uma mudança de status na AP_INVOICES_ALL. A coluna CANCELLED_DATE será preenchida com o registro de data e hora do cancelamento. Captura O campo CANCELLED_DATE na tabela AP_INVOICES_ALL é preenchido. Tipo de evento explicit
	Fatura corrigida	Ocorre quando uma pessoa modifica uma fatura, geralmente em resposta a uma rejeição ou para corrigir um erro de lançamento de dados. Isso representa uma etapa de retrabalho manual no processo.
Por que isso importa Essa atividade é um indicador claro de retrabalho. Analisar sua frequência ajuda a quantificar a ineficiência do processo e apoia o KPI 'Invoice Rework Rate'. Onde obter Pode ser inferido pelo acompanhamento de atualizações significativas no registro da fatura em AP_INVOICES_ALL depois que ela já foi validada ou enviada para aprovação. O registro de data e hora LAST_UPDATE_DATE, junto com os dados da trilha de auditoria, seria necessário. Captura Inferido pela comparação de LAST_UPDATE_DATE após uma rejeição ou bloqueio. Tipo de evento inferred
	Fatura rejeitada	Uma pessoa aprovadora rejeitou a fatura durante o Workflow de aprovação. Essa ação normalmente envia a fatura de volta para correção ou cancelamento, iniciando um ciclo de retrabalho.
Por que isso importa Representa um resultado negativo e um dos principais fatores de retrabalho e aumento do tempo de ciclo. Acompanhar as rejeições ajuda a identificar problemas na qualidade da fatura ou na Conformidade do PO. Onde obter Inferido a partir da mudança de APPROVAL_STATUS na tabela AP_INVOICES_ALL para 'Rejected'. O histórico do Workflow conterá detalhes sobre quem rejeitou a fatura e quando. Captura Inferido a partir da alteração de AP_INVOICES_ALL.APPROVAL_STATUS para 'Rejected'. Tipo de evento inferred
	Fatura validada	Indica que a fatura passou pelas verificações de validação do sistema quanto à integridade e à correção das informações do cabeçalho e das linhas. Isso geralmente é inferido a partir de uma mudança de status no registro da fatura.
Por que isso importa Um marco importante antes da conciliação e da aprovação. Atrasos nessa etapa podem indicar problemas na qualidade dos dados da fatura ou na configuração do sistema. Onde obter Inferido a partir da mudança do status da fatura para 'Validated' na tabela AP_INVOICES_ALL. O histórico de alterações ou a trilha de auditoria da coluna VALIDATION_STATUS pode ser usado. Captura Inferido a partir da alteração do campo AP_INVOICES_ALL.VALIDATION_STATUS. Tipo de evento inferred
	Pagamento agendado	A fatura é selecionada e incluída em uma solicitação de processo de pagamento, geralmente chamada de payment run ou lote de pagamentos. Agora ela está na fila para pagamento.
Por que isso importa É a etapa entre a contabilização e o pagamento efetivo. A duração dessa etapa afeta a previsão do fluxo de caixa e a possibilidade de aproveitar descontos por pagamento antecipado. Onde obter Isso é registrado na tabela AP_INVOICE_PAYMENTS_ALL quando um registro de pagamento é criado, mas ainda não foi confirmado como pago. Também pode ser encontrado em tabelas de lotes de pagamento, como IBY_PAYMENT_PROCESS_REQUESTS. Captura Criação de um registro na AP_INVOICE_PAYMENTS_ALL para um pagamento agendado. Tipo de evento explicit
	Pagamento criado	A instrução de pagamento da fatura foi gerada pelo sistema. Isso pode envolver a criação de um cheque, um arquivo de transferência eletrônica de fundos (EFT) ou outro instrumento de pagamento.
Por que isso importa É nesse momento que a organização compromete os fundos para o pagamento. Trata-se de um marco importante imediatamente antes de o dinheiro sair da conta bancária. Onde obter Registrado na tabela AP_CHECKS_ALL, que armazena informações sobre todos os pagamentos. CHECK_DATE indica quando o documento de pagamento foi criado. Captura Criação de um registro na tabela AP_CHECKS_ALL. Tipo de evento explicit

Recomendado Opcional

Guias de extração

Como obter seus dados do Oracle Fusion Financials

Etapas

Faça login no Oracle Fusion Cloud: acesse seu ambiente Oracle Fusion Cloud com um usuário que tenha a função BI Cloud Connector Administrator (BICC_ADMIN).
Acesse o BI Cloud Connector: no menu principal de navegação, vá para Tools > BI Cloud Connector. O console do BICC será aberto.
Selecione a oferta: no console do BICC, escolha a oferta correspondente aos seus dados do Financials. Normalmente, ela se chama 'Financials'.
Configure o armazenamento externo: acesse a seção 'Configure External Storage'. Configure a conexão com o armazenamento em nuvem onde os arquivos CSV extraídos serão entregues, como o Oracle Cloud Infrastructure (OCI) Object Storage.
Ative as ofertas para extração: acesse 'Manage Offerings and PVOs' ou uma seção semelhante. Selecione a oferta 'Financials' e ative-a para extração.
Selecione os Public View Objects (PVOs): pesquise e selecione os PVOs específicos necessários para o processo de faturas. Os principais PVOs são: FscmTopModelAM.FinApInvQuickInvoicesAM.InvoiceHeaderPVO, FscmTopModelAM.FinApInvHoldAM.InvoiceHoldPVO, FscmTopModelAM.FinApInvSharedAM.InvoiceApprovalHistoryPVO e FscmTopModelAM.FinApPmtsInvPmtsAM.PaymentPVO.
Agende o job de extração: acesse 'Manage Extract Schedules'. Crie um novo job, dê a ele um nome descritivo e selecione todos os PVOs ativados na etapa anterior. Agende a execução. Para a carga inicial, execute o job no intervalo histórico desejado. Nas execuções seguintes, configure extrações incrementais com base em LastUpdateDate.
Monitore e recupere os dados: acompanhe o andamento do job no console do BICC. Quando ele for concluído com sucesso, acesse o local de armazenamento em nuvem configurado. Você encontrará os dados extraídos em um conjunto de arquivos CSV compactados, um para cada PVO.
Carregue os dados na área de staging: descompacte os arquivos e carregue os CSVs em um banco de dados de staging ou em uma plataforma de processamento de dados, como um data warehouse ou data lake, onde você possa executar consultas SQL. Cada arquivo CSV deve ser carregado em sua própria tabela.
Transforme os dados em um Event Log: execute a consulta SQL fornecida nas tabelas da sua área de staging. Essa consulta combina dados das diferentes tabelas para criar uma única tabela de Event Log unificada.
Exporte para o ProcessMind: exporte o resultado da consulta SQL como um único arquivo CSV. Verifique se os cabeçalhos das colunas correspondem aos atributos necessários (InvoiceNumber, ActivityName, EventTime etc.) para o upload no aplicativo ProcessMind.

Configuração

Principais Public View Objects (PVOs): a extração depende de vários PVOs essenciais da oferta Financials. No mínimo, você deve incluir:
- FscmTopModelAM.FinApInvQuickInvoicesAM.InvoiceHeaderPVO: para os dados principais das faturas e os eventos de criação, validação e cancelamento.
- FscmTopModelAM.FinApInvHoldAM.InvoiceHoldPVO: para todos os eventos de retenção e liberação de faturas.
- FscmTopModelAM.FinApInvSharedAM.InvoiceApprovalHistoryPVO: para capturar etapas detalhadas do Workflow de aprovação, como envio, aprovação e rejeição.
- FscmTopModelAM.FinApPmtsInvPmtsAM.PaymentPVO: para os eventos de criação e execução de pagamentos.
- FscmTopModelAM.FinApInvPmtsAM.InstallmentPVO: para identificar quando uma fatura é programada para pagamento.
Extrações incrementais: para o monitoramento contínuo, configure o job do BICC para realizar extrações incrementais. Use a coluna LastUpdateDate, disponível na maioria dos PVOs, como critério de filtro para extrair apenas os registros novos ou alterados desde a última execução.
Filtro por intervalo de datas: para a carga histórica inicial, recomenda-se extrair um período gerenciável, como os últimos 6 a 12 meses de dados. Você pode aplicar um filtro global na programação do job do BICC para restringir a extração a um intervalo de datas específico.
Filtro por unidade de negócio: para limitar o escopo da extração, aplique um filtro em BusinessUnitName ou em um atributo semelhante na configuração do job do BICC. Isso é essencial em ambientes com várias entidades para controlar o volume de dados.
Pré-requisitos: sua conta de usuário precisa das funções apropriadas, principalmente BICC Administrator (BICC_ADMIN) e Functional Setup User (FSM_IMPLEMENTATION_CONSULTANT), para configurar e executar jobs de extração. Você também precisa ter um local de armazenamento em nuvem configurado e acessível, como OCI Object Storage ou UCM.

a Consulta de exemplo 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;

Etapas

Acesse o Oracle BI Publisher: faça login no Oracle Fusion Applications com um usuário que tenha a função BI Administrator ou uma função semelhante. Acesse a ferramenta Reports and Analytics abrindo o menu Navigator, selecionando Tools e clicando em Reports and Analytics.
Acesse o catálogo: na área de trabalho Reports and Analytics, clique no botão Browse Catalog para abrir a interface do Oracle BI Publisher.
Crie um novo modelo de dados: no catálogo do BI Publisher, acesse uma pasta adequada, como Shared Folders > Custom. Clique no menu suspenso New e selecione Data Model.
Defina o conjunto de dados da consulta SQL: no editor do Data Model, clique no ícone '+' para adicionar um novo conjunto de dados e selecione SQL Query na lista.
Configure o conjunto de dados: na caixa de diálogo New Data Set, informe um nome, como P2P_Invoice_Events. Selecione a Data Source apropriada, normalmente ApplicationDB_FSCM para dados financeiros. Verifique se o Type of SQL está definido como Standard SQL.
Insira a consulta SQL: copie a consulta SQL completa fornecida na seção query deste documento e cole-a na área de texto SQL Query.
Defina os parâmetros: a consulta usa parâmetros para filtragem. Nas propriedades do Data Model, crie três parâmetros: p_start_date, p_end_date e p_bu_name. Defina o tipo de dados como String. O usuário informará os valores ao executar o relatório, por exemplo, '2023-01-01' para as datas e o nome específico da unidade de negócio.
Salve o Data Model: salve o modelo de dados na sua pasta personalizada. Você pode visualizar dados de exemplo clicando na aba 'Data' e informando os valores dos parâmetros criados.
Crie um relatório: volte ao catálogo, clique no menu suspenso New e selecione Report. No assistente de criação do relatório, selecione a opção 'Use Data Model' e localize o modelo de dados que você acabou de salvar.
Configure o layout e a saída do relatório: no editor do relatório, um layout simples em tabela é suficiente. A etapa mais importante é configurar o formato de saída padrão. Clique em 'View a List' e verifique se CSV é o formato padrão e o único habilitado. Isso garante uma saída limpa e sem formatação.
Agende o relatório: salve o relatório. Agora você pode executá-lo sob demanda ou, para obter melhor performance, programá-lo para rodar fora do horário de pico. A programação pode ser configurada para entregar a saída CSV a um destino específico, como o servidor Universal Content Management (UCM), de onde ela poderá ser recuperada para upload.
Exporte e prepare os dados: quando o job do relatório for concluído, baixe o arquivo CSV resultante. Verifique se os cabeçalhos das colunas correspondem aos atributos necessários (InvoiceNumber, ActivityName, EventTime etc.) antes de fazer o upload na ferramenta de Process Mining.

Configuração

Fonte de dados: a consulta deve ser executada no banco de dados do aplicativo Fusion Financials, normalmente conectado por meio da fonte de dados JNDI ApplicationDB_FSCM no BI Publisher.
Parâmetros: o modelo de dados deve ser configurado com os seguintes parâmetros para permitir uma extração flexível:
- p_start_date: a data inicial do período de extração no formato 'YYYY-MM-DD'.
- p_end_date: a data final do período de extração no formato 'YYYY-MM-DD'.
- p_bu_name: o nome da Unidade de negócio (Company Code) usada para filtrar os dados. Use um caractere curinga, como '%', para extrair dados de todas as unidades de negócio.
Período: para a extração inicial, recomenda-se usar dados de um período de 3 a 6 meses. Isso equilibra a obtenção de um conjunto de dados representativo com o controle da performance da extração.
Considerações de performance: extrair dados de períodos longos ou de todas as unidades de negócio de uma só vez pode consumir muitos recursos e causar timeouts. Recomenda-se executar extrações grandes em lotes menores e sequenciais, por exemplo, mês a mês, ou agendá-las para horários de menor movimento.
Pré-requisitos: o usuário que criar e executar o relatório precisa ter uma função com permissões para acessar a ferramenta BI Publisher, como BI Administrator, além dos privilégios de segurança de dados necessários para visualizar as tabelas subjacentes de Contas a pagar (AP_INVOICES_ALL, AP_PAYMENTS_ALL etc.) das unidades de negócio de destino.

a Consulta de exemplo 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

Etapas

Pré-requisitos: verifique se o Python 3.6 ou superior está instalado no seu sistema, junto com as bibliotecas requests e pandas. Você pode instalá-las usando pip: pip install requests pandas.
Configure a API do Oracle Fusion: na sua instância do Oracle Fusion, acesse o Security Console. Crie um novo aplicativo confidencial para obter acesso à API. Anote o Client ID e o Client Secret atribuídos. Verifique se o usuário do aplicativo tem as funções necessárias para ler dados de faturas e pagamentos, como Financials - Payables Invoice Inquiry Duty.
Configure o script Python: copie o script Python fornecido para um arquivo, por exemplo extract_fusion_invoices.py. Abra o arquivo e preencha as variáveis de espaço reservado no início do script. Isso inclui CLIENT_ID, CLIENT_SECRET, TOKEN_URL, FUSION_HOST, START_DATE e END_DATE. FUSION_HOST deve ser a URL base dos seus aplicativos Oracle Cloud.
Defina o período de extração: altere as variáveis START_DATE e END_DATE para definir o intervalo da extração. Recomenda-se começar com um período menor, como um mês, para testar o script e verificar a saída.
Execute o script: execute o script pela linha de comando ou pelo terminal, acessando o diretório correspondente e digitando python extract_fusion_invoices.py. O script fará a autenticação, buscará os dados e exibirá mensagens de progresso no console.
Processo de autenticação: primeiro, o script envia uma solicitação com suas credenciais de cliente ao provedor de identidade do Oracle (TOKEN_URL) para obter um token de acesso OAuth. Depois, esse token é incluído no cabeçalho de todas as solicitações seguintes à API do Fusion Financials para autenticação.
Busca de dados e paginação: o script consulta o endpoint REST invoices, recuperando os registros criados no intervalo de datas especificado. Ele gerencia a paginação automaticamente, verificando o indicador hasMore na resposta da API e fazendo novas solicitações com um parâmetro offset atualizado até recuperar todos os dados das faturas.
Recuperação detalhada dos dados: para cada fatura recuperada, o script faz chamadas adicionais à API para buscar os detalhes associados. Ele consulta o endpoint /child/holds para obter informações de retenção e liberação e o endpoint /payments, filtrado pelo número da fatura, para coletar os dados de pagamento.
Geração do Event Log: a lógica principal do script processa os dados JSON brutos da API. Ela verifica datas, status e registros filhos específicos para gerar linhas distintas para cada uma das 15 atividades de negócio necessárias. Por exemplo, a presença de CancelledDate gera um evento 'Fatura cancelada'.
Revise a saída: quando o script terminar, ele criará um arquivo chamado invoice_event_log.csv no mesmo diretório. Abra esse arquivo CSV em um aplicativo de planilhas para revisar os dados. Verifique se todas as colunas necessárias (InvoiceNumber, ActivityName, EventTime) e os atributos recomendados estão presentes.
Prepare o upload: verifique se os cabeçalhos das colunas no arquivo CSV correspondem aos nomes dos atributos necessários. Normalmente, nenhuma formatação adicional é necessária. O arquivo estará pronto para ser carregado na sua ferramenta de Process Mining.

Configuração

Credenciais de autenticação: são necessários um Client ID e um Client Secret de um aplicativo confidencial registrado no Security Console do Oracle Fusion. A Token URL do seu domínio de identidade também deve ser informada.
URL do host da API: a variável FUSION_HOST deve ser definida como a URL base da sua instância do Oracle Fusion, por exemplo, https://[your-instance].fa.us2.oraclecloud.com.
Intervalo de datas: as variáveis START_DATE e END_DATE são essenciais para controlar o escopo da extração. Recomenda-se extrair de 3 a 6 meses de dados para a análise inicial, equilibrando o volume de dados e a performance.
Endpoints da API usados: o script interage principalmente com os endpoints fscmRestApi/resources/11.13.18.05/invoices e fscmRestApi/resources/11.13.18.05/payments. Ele também usa o sub-recurso /invoices/{InvoiceId}/child/holds.
Limite de paginação: a variável LIMIT no script controla quantos registros são buscados por solicitação à API. O padrão é 100. Um valor maior pode reduzir o número de chamadas à API, mas aumenta o consumo de memória por solicitação. Um valor menor pode ser necessário se você encontrar erros de timeout.
Permissões necessárias: a conta de usuário associada às credenciais da API precisa ter acesso de leitura a faturas de Contas a Pagar, retenções de faturas, pagamentos e informações de fornecedores. A função Payables Invoice Inquiry Duty normalmente fornece permissões suficientes.

a Consulta de exemplo 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()

Pronto para começar?

Comece a otimizar o processamento das suas faturas preparando os dados com este Template. Desbloqueie insights valiosos e promova melhorias significativas de eficiência na sua organização.

Voltar ao guia de melhoria Baixar Template

Otimize agora o processamento das suas faturas P2P e tenha ciclos 30% mais rápidos

Elimine gargalos no Oracle Fusion Financials e reduza o tempo de ciclo em 30%.

Começar o teste grátis

Não é necessário cartão de crédito. Veja resultados em poucos dias.

Seu Template de dados de Purchase to Pay - processamento de faturas

Seu Template de dados de Purchase to Pay - processamento de faturas

Purchase to Pay - Atributos do processamento de faturas

Purchase to Pay - Atividades de processamento de faturas

Guias de extração

Exportação em massa de dados pelo Oracle BI Cloud Connector (BICC)

Etapas

Configuração

a Consulta de exemplo sql

Relatório do Oracle BI Publisher com modelo de dados SQL personalizado

Etapas

Configuração

a Consulta de exemplo sql

Extração com script Python usando a API REST do Fusion Financials

Etapas

Configuração

a Consulta de exemplo python

Pronto para começar?

Otimize agora o processamento das suas faturas P2P e tenha ciclos 30% mais rápidos

Seu Template de dados de Purchase to Pay - processamento de faturas

Seu Template de dados de Purchase to Pay - processamento de faturas

Purchase to Pay - Atributos do processamento de faturas

Purchase to Pay - Atividades de processamento de faturas

Guias de extração

Exportação em massa de dados pelo Oracle BI Cloud Connector (BICC)

Etapas

Configuração

a Consulta de exemplo sql

Relatório do Oracle BI Publisher com modelo de dados SQL personalizado

Etapas

Configuração

a Consulta de exemplo sql

Extração com script Python usando a API REST do Fusion Financials

Etapas

Configuração

a Consulta de exemplo python

Pronto para começar?

Otimize agora o processamento das suas faturas P2P e tenha ciclos 30% mais rápidos

Valorizamos sua privacidade