> Melhoria contínua de processos > Record to Report Fechamento do período e reconciliação > BlackLine > Template de dados

Seu Template de dados de registro a relatório: fechamento do período e conciliação

BlackLine

← Voltar ao guia de melhoria

Atributos de registro a relatório: fechamento do período e conciliação(20) Atividades de registro a relatório: fechamento do período e conciliação(14) Guias de extração(1)

Seu Template de dados de registro a relatório: fechamento do período e conciliação

Este Template oferece um guia completo para preparar os dados do processo de registro a relatório, fechamento do período e conciliação. Ele apresenta os atributos essenciais a coletar, as atividades importantes a acompanhar e orientações práticas para extrair esses dados. Use este material para simplificar a preparação dos dados e garantir uma análise bem-sucedida.

Atributos recomendados para coleta
Principais atividades a acompanhar
Orientações para extração de dados do BlackLine

Novidade em Event Logs? Saiba como criar um Event Log para Process Mining.

Baixar Template

Atributos de registro a relatório: fechamento do período e conciliação

Estes são os campos de dados recomendados para incluir no Event Log e analisar de forma abrangente o processo de registro a relatório, fechamento do período e conciliação.

5 Obrigatório 6 Recomendado 9 Opcional

	Nome	Descrição
	Atividade ActivityName	Nome de um evento de negócio ou de uma tarefa específica que ocorreu durante o processo de fechamento do período.
Descrição Este atributo descreve uma etapa ou um marco do processo de registro ao reporte, como Conciliação preparada ou Lançamento de ajuste contabilizado. Os eventos são ordenados cronologicamente para reconstruir o fluxo do processo de cada período financeiro. Analisar a sequência e a frequência das atividades ajuda a identificar o caminho real do processo, os desvios em relação ao procedimento padrão e os gargalos que fazem o processo parar. Esse atributo é fundamental para criar o mapa do processo e calcular os principais indicadores de performance. Por que isso importa Ele forma a estrutura básica do mapa do processo e permite visualizar e analisar o fluxo, as variantes e as exceções do processo. Onde encontrar Geralmente, é derivado de registros de eventos, status de tarefas ou trilhas de auditoria em vários módulos do BlackLine, como Tasks, Journals e Account Reconciliations. Exemplos Conciliação preparadaConciliação certificadaLançamento de ajuste contabilizadoPeríodo fechado
	Hora de início EventTime	Data e hora que indicam quando uma atividade ou um evento começou.
Descrição EventTime informa a data e a hora exatas em que uma etapa específica do processo de fechamento do período começou. Esse registro de data e hora é essencial para ordenar os eventos corretamente e calcular a duração entre as diferentes etapas do processo. Na análise, esse atributo é usado para criar o registro cronológico de eventos de cada caso. Ele serve de base para calcular todas as métricas relacionadas ao tempo, como tempos de ciclo, de espera e de processamento, essenciais para identificar atrasos e ineficiências. Por que isso importa Esse registro de data e hora é essencial para ordenar os eventos, descobrir o fluxo do processo e calcular todas as métricas de performance baseadas em duração. Onde encontrar Corresponde à data de criação, à data de início ou à data e hora da mudança de status nos registros de tarefas, conciliações ou lançamentos contábeis do BlackLine. Exemplos 2023-10-02T09:00:00Z2023-10-05T14:30:15Z2023-10-10T11:21:05Z
	Período financeiro FinancialPeriod	Identificador exclusivo de um ciclo específico de reporte financeiro, como um mês ou trimestre. Ele funciona como o principal identificador do caso.
Descrição O período financeiro reúne todas as atividades relacionadas ao fechamento e à conciliação de contas daquele ciclo de reporte. Por exemplo, 2023-01 representa todas as atividades de fechamento de janeiro de 2023. Em Process Mining, esse atributo é essencial para analisar a duração total do processo de fechamento do período. Ele permite comparar os tempos de ciclo entre diferentes períodos e ajuda a identificar tendências, variações sazonais e o impacto das melhorias no processo ao longo do tempo. Por que isso importa Este é o identificador principal que conecta todas as atividades relacionadas ao fechamento e à conciliação, permitindo visualizar por completo o fluxo do processo e a performance de cada período. Onde encontrar Geralmente, é derivado do contexto do período de reporte nos módulos Period Close ou Reconciliation do BlackLine. Pode ser uma combinação dos campos de ano e mês. Exemplos 2023-122024-T12023-09AF2024-P03
	Sistema de origem SourceSystem	Sistema do qual os dados de eventos foram extraídos.
Descrição Este atributo identifica a origem dos dados do processo. Nesta visualização, o valor será sempre BlackLine, mas, em uma análise que envolva vários sistemas, ele ajuda a diferenciar as fontes de dados. Em uma análise de vários sistemas, esse campo é essencial para entender a linhagem dos dados e comparar a performance de cada sistema. Mesmo em uma visualização de um único sistema, ele oferece contexto importante para a governança e a gestão dos dados. Por que isso importa Ele oferece contexto essencial sobre a origem dos dados, necessário para a governança, a validação e a integração com outros sistemas. Onde encontrar Geralmente, é um valor estático adicionado durante a transformação dos dados para identificar a origem dos registros. Exemplos BlackLineBlackLine-APIBlackLine-Reporting
	Última atualização dos dados LastDataUpdate	Data e hora da última atualização dos dados extraídos do sistema de origem.
Descrição Este atributo indica quando o conjunto de dados foi atualizado pela última vez. Ele informa o quão atualizados estão os dados analisados e ajuda os usuários a entenderem a atualidade dos insights sobre o processo. Isso é importante para quem consulta o Dashboard e precisa saber se a análise está atualizada. Ajuda a alinhar expectativas e confirma que as decisões estão sendo tomadas com base em dados recentes o suficiente. Por que isso importa Ele informa aos usuários quando os dados foram atualizados, algo essencial para tomar decisões de negócio oportunas e relevantes com base na análise. Onde encontrar Este registro de data e hora é gerado e armazenado durante o processo de extração, transformação e carregamento de dados (ETL). Exemplos 2024-03-15T02:00:00Z2024-03-16T02:00:00Z
	Código da empresa CompanyCode	Identificador da entidade legal para a qual a atividade financeira está sendo realizada.
Descrição O código da empresa representa uma entidade legal específica dentro da organização. As atividades de fechamento financeiro costumam ser realizadas separadamente para cada código da empresa antes da consolidação. Esse atributo é essencial para analisar o processo de fechamento do período no nível da entidade. Ele permite comparar a performance entre diferentes entidades legais, o que é especialmente importante na análise da duração da conciliação intercompany. Também ajuda a identificar quais entidades têm processos de fechamento mais complexos ou ineficientes. Por que isso importa Ele permite segmentar a análise do processo por entidade legal, o que é fundamental para identificar gargalos e problemas de performance específicos de cada entidade. Onde encontrar Disponível como campo padrão na maioria das transações financeiras, incluindo lançamentos contábeis e conciliações, no BlackLine e no ERP de origem. Exemplos 1000US01DE012500
	Conta do razão geral GLAccount	Número da conta do razão geral associada à conciliação ou ao lançamento contábil.
Descrição Esse atributo identifica a conta específica do plano de contas que está sendo conciliada ou ajustada. Ele fornece contexto financeiro detalhado para as atividades do processo. A análise por conta do razão geral é essencial para o Dashboard de tendências de ajustes manuais de lançamentos contábeis, pois ajuda a identificar quais contas exigem mais intervenção manual. Também é usada para detectar retrabalho, quando ocorrem vários ajustes ou tentativas de conciliação para a mesma conta em um único período. Por que isso importa Ele fornece contexto financeiro e ajuda a identificar quais contas estão mais sujeitas a erros, exigem ajustes frequentes ou causam atrasos no fechamento. Onde encontrar Esse é um campo principal nos módulos de conciliações de contas e lançamentos contábeis do BlackLine. Exemplos 101000405020210010
	Departamento Department	Departamento funcional ou equipe associada à atividade ou ao usuário.
Descrição O atributo Departamento indica a unidade de negócio, como Contabilidade corporativa ou Auditoria interna, responsável por uma atividade. Essas informações costumam vir dos perfis de usuário ou da própria natureza da tarefa. Essa dimensão é útil para comparar a performance do processo entre diferentes áreas da organização. Ela ajuda a identificar quais departamentos são mais eficientes, quais podem precisar de recursos adicionais durante o fechamento e onde as transferências entre departamentos estão causando atrasos. Por que isso importa Ele permite comparar a performance entre diferentes unidades de negócio e é essencial para analisar a carga de trabalho e os gargalos por departamento. Onde encontrar Essas informações podem vir dos dados do perfil de usuário associados a ResponsibleUser ou das propriedades da tarefa ou da conta do razão geral no BlackLine ou em um sistema ERP integrado. Exemplos Contabilidade corporativaPlanejamento e análise financeiraAuditoria internaImpostos
	Hora de término EventEndTime	Data e hora que indicam quando uma atividade ou um evento foi concluído.
Descrição EventEndTime informa a data e a hora exatas em que uma tarefa específica foi concluída. Esse dado é usado com StartTime para calcular o tempo de processamento de cada atividade. Na análise, EndTime é essencial para calcular quanto tempo cada etapa leva. Isso ajuda a identificar quais atividades consomem mais tempo no processo como um todo e serve de base para a análise de gargalos e a avaliação da alocação de recursos. Por que isso importa Ele permite calcular o tempo de processamento das atividades, algo fundamental para identificar gargalos e medir a eficiência operacional. Onde encontrar Corresponde à data de conclusão, à data da última modificação ou à data e hora de uma mudança específica de status nos registros de tarefas, conciliações ou lançamentos do BlackLine. Exemplos 2023-10-02T11:30:00Z2023-10-05T15:00:45Z2023-10-10T11:25:10Z
	Status da conciliação ReconciliationStatus	Status atual ou final de uma tarefa de conciliação.
Descrição Este atributo registra o estado de uma conciliação em um momento específico, por exemplo, Não iniciada, Em andamento, Certificada ou Rejeitada. Ele mostra o andamento e o resultado de cada conciliação. Analisar os dados por status é essencial para o Dashboard de detalhamento do status das conciliações, que permite aos gestores ver rapidamente quantas conciliações estão pendentes, concluídas ou precisam de atenção. Acompanhar as mudanças de status ajuda a identificar ciclos de retrabalho e atrasos na análise e na aprovação. Por que isso importa Ele oferece uma visão clara do andamento e dos resultados das conciliações, ajudando a identificar acúmulos de trabalho e acompanhar a Conformidade com os procedimentos. Onde encontrar Disponível diretamente no campo de status dos registros do módulo Account Reconciliations do BlackLine. Exemplos PreparadoCertificadoAprovadoRejeitadoEm atraso
	Usuário responsável ResponsibleUser	ID ou nome do usuário que realizou a atividade ou foi designado para ela.
Descrição Este atributo identifica a pessoa responsável por executar uma tarefa específica, como preparar uma conciliação ou contabilizar um lançamento. Pode ser um nome de usuário, um ID de funcionário ou um endereço de e-mail. Analisar os dados por usuário responsável é essencial para entender a distribuição da carga de trabalho, a performance individual e as necessidades de treinamento. Isso ajuda a identificar quem tem os melhores resultados, se o trabalho está bem distribuído e onde ocorrem retrabalho ou erros com mais frequência. Por que isso importa Ele é essencial para analisar a distribuição da carga de trabalho, identificar gargalos causados por grupos específicos de usuários e avaliar a performance da equipe. Onde encontrar Encontrado em campos como Atribuído a, Concluído por, Preparador, Certificador ou Aprovador nos módulos do BlackLine. Exemplos john.doejane.smithuser123
	Data prevista para conclusão TargetCompletionDate	Prazo planejado para o fechamento do período financeiro.
Descrição Esse atributo representa o prazo oficial para concluir o processo de fechamento do período. Ele serve como referência para medir o tempo real de conclusão. Essa data é essencial para calcular o KPI de taxa de fechamento do período no prazo. Ao comparar o horário de conclusão real da atividade de fechamento do período com essa data prevista, a análise pode sinalizar períodos concluídos com atraso e medir a duração desse atraso, algo fundamental para a conformidade e os relatórios. Por que isso importa É a referência para medir a performance dentro do prazo e é essencial para calcular KPIs de conformidade, como a taxa de fechamento do período no prazo. Onde encontrar Essa data costuma ser definida no calendário de fechamento do período ou nas configurações de gerenciamento de tarefas do BlackLine. Exemplos 2023-10-15T23:59:59Z2024-01-12T23:59:59Z
	É automatizado IsAutomated	Indicador booleano que informa se a atividade foi realizada pelo sistema ou por uma pessoa.
Descrição Esse indicador diferencia as tarefas executadas automaticamente pelo sistema, como a certificação automática de conciliações de baixo risco, daquelas realizadas manualmente por uma pessoa. Isso é fundamental para entender o nível de automação do processo de fechamento. A análise desse atributo ajuda a medir o impacto das iniciativas de automação. Ele pode ser usado para comparar a velocidade e a consistência das tarefas automatizadas com as manuais e identificar oportunidades para ampliar a automação, aumentar a eficiência e reduzir erros humanos. Por que isso importa Ele ajuda a medir o nível de automação do processo e a identificar oportunidades para automatizar tarefas manuais e aumentar a eficiência. Onde encontrar Esse dado pode ser obtido verificando se o usuário responsável é uma conta de sistema ou de serviço, ou por meio de indicadores específicos nas propriedades da tarefa no BlackLine. Exemplos truefalse
	É retrabalho IsRework	Indicador calculado que identifica atividades que fazem parte de um ciclo de retrabalho.
Descrição Esse indicador recebe o valor verdadeiro para atividades que mostram que etapas do processo estão sendo repetidas sem necessidade. Por exemplo, um evento de conciliação rejeitada seguido por outro evento de conciliação preparada para a mesma conciliação seria marcado como retrabalho. Identificar retrabalho é fundamental para revelar ineficiências no processo e problemas de qualidade. O KPI de taxa de retrabalho em conciliações é calculado com base nesse atributo e destaca áreas em que o trabalho não é feito corretamente na primeira vez, gerando esforço desperdiçado e atrasos. Por que isso importa Ele sinaliza ciclos ineficientes no processo e trabalho repetido, ajudando a quantificar o esforço desperdiçado e identificar as causas raiz dos problemas de qualidade. Onde encontrar Esse dado costuma ser calculado pelos algoritmos da ferramenta de Process Mining, que detectam sequências repetidas de atividades no mesmo caso, geralmente envolvendo o mesmo ID de conciliação ou a mesma conta do razão geral. Exemplos truefalse
	Está no prazo IsOnTime	Indicador calculado que informa se o fechamento do período foi concluído até a data prevista.
Descrição Esse atributo booleano é calculado comparando o horário real de conclusão da atividade de fechamento do período com a data prevista para conclusão daquele período financeiro. Ele fornece um indicador simples e claro de conformidade com os prazos. Esse indicador é a base para calcular o KPI de taxa de fechamento do período no prazo. Ele facilita a filtragem e a visualização dos períodos concluídos no prazo ou com atraso, ajudando a identificar rapidamente os períodos que não cumpriram os prazos e precisam de investigação. Por que isso importa Ele simplifica o acompanhamento da performance ao sinalizar claramente os casos que não cumpriram os prazos, contribuindo diretamente para os relatórios de conformidade e SLA. Onde encontrar Calculado comparando o registro de data e hora da atividade final de fechamento do período com o atributo de data prevista para conclusão. Esse cálculo é feito na ferramenta de Process Mining. Exemplos truefalse
	ID da conciliação ReconciliationId	Identificador exclusivo de uma tarefa específica de conciliação de conta.
Descrição O ID da conciliação é uma chave exclusiva atribuída a cada conciliação realizada para uma conta específica do razão geral em um período financeiro. Isso permite acompanhar com precisão cada conciliação ao longo do processo. Na análise, esse ID ajuda a diferenciar conciliações distintas que podem ocorrer para a mesma conta ao longo do tempo. Ele é essencial para análises detalhadas, investigação de problemas específicos e acompanhamento preciso do status e do histórico de cada item. Por que isso importa Ele fornece uma chave exclusiva para acompanhar cada item de conciliação, permitindo análises detalhadas e uma investigação aprofundada de áreas problemáticas específicas. Onde encontrar Esse identificador exclusivo é gerado pelo sistema para cada registro de conciliação no módulo de conciliações de contas do BlackLine. Exemplos REC-893475REC-893476REC-893477
	ID do lançamento contábil JournalId	Identificador exclusivo de um lançamento contábil específico.
Descrição O ID do lançamento contábil é uma chave exclusiva para cada lançamento de ajuste manual criado e contabilizado no BlackLine. Ele permite acompanhar cada lançamento individualmente, da criação à contabilização. Esse ID é essencial para o Dashboard de tendências de ajustes manuais de lançamentos contábeis. Ele permite contar com precisão os ajustes manuais e ajuda os analistas de negócios a investigar os detalhes de lançamentos específicos que podem indicar problemas nos dados ou no processo. Por que isso importa Ele identifica cada lançamento contábil manual de forma exclusiva, o que é fundamental para contar os ajustes e investigar a causa raiz do alto volume de ajustes. Onde encontrar Esse identificador exclusivo é gerado pelo sistema para cada lançamento no módulo de lançamentos contábeis do BlackLine. Exemplos JRN-2023-10-001JRN-2023-10-002ADJ-58321
	Moeda Currency	Código da moeda do valor monetário, como USD ou EUR.
Descrição Esse atributo especifica a moeda do valor do ajuste. Em organizações multinacionais, os lançamentos contábeis podem estar em diferentes moedas locais. A moeda é um atributo contextual necessário para qualquer valor financeiro. Ela garante a interpretação correta dos valores monetários e permite agregações e comparações adequadas. Para a análise, muitas vezes é necessário converter os valores para uma moeda padrão de relatório. Por que isso importa Fornece contexto essencial para os valores monetários, garantindo que sejam interpretados corretamente e permitindo a conversão adequada de moedas para os relatórios. Onde encontrar Geralmente fica junto aos campos de valor no módulo de lançamentos contábeis do BlackLine ou nas propriedades do código da empresa associado. Exemplos USDEURGBPJPY
	Tipo de conciliação ReconciliationType	Classifica a conciliação, por exemplo, como balanço patrimonial, lucros e perdas ou intercompany.
Descrição Esse atributo classifica o tipo de conciliação realizada. Isso é importante porque diferentes tipos de conciliação podem ter níveis distintos de complexidade, risco e prazo esperado para conclusão. Com esse atributo, você pode segmentar a análise e comparar a performance e os desafios de diferentes categorias de conciliação. Por exemplo, ele pode ajudar a determinar se as conciliações intercompany estão levando muito mais tempo do que as conciliações padrão de balanço patrimonial. Por que isso importa Ele permite analisar separadamente diferentes categorias de conciliação, que costumam apresentar níveis variados de complexidade e risco. Onde encontrar Esse dado pode ser obtido das propriedades da conta do razão geral ou das configurações do Template de conciliação no BlackLine. Exemplos Balanço patrimonialLucros e perdasIntercompanyConciliação bancária
	Valor do ajuste AdjustmentAmount	Valor monetário de um lançamento contábil de ajuste manual.
Descrição Esse atributo registra o impacto financeiro de um ajuste manual. Ele pode ser representado por um único valor ou por valores separados de débito e crédito. Analisar o valor dos ajustes, além do volume, oferece uma visão mais completa da relevância deles. Ajustes de alto valor ou frequentes em contas ou departamentos específicos podem indicar riscos materiais para os relatórios financeiros ou falhas significativas em etapas anteriores do processo que precisam ser corrigidas. Por que isso importa Ele quantifica o impacto financeiro dos ajustes manuais e ajuda a priorizar investigações em áreas com alterações de alto valor. Onde encontrar Disponível nos campos de valor do módulo de lançamentos contábeis do BlackLine. Exemplos 1500.75-250.0010000.00

Obrigatório Recomendado Opcional

Atividades de registro a relatório: fechamento do período e conciliação

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

6 Recomendado 8 Opcional

	Atividade	Descrição
	Conciliação aprovada	Representa a aprovação final de uma conciliação de conta, indicando que todos os níveis de análise foram concluídos. O evento é registrado quando a conciliação chega ao status final de aprovação.
Por que isso importa Este é um marco importante, pois indica a conclusão de uma unidade de trabalho significativa. É essencial para medir o tempo de ciclo total da conciliação e identificar gargalos nas aprovações. Onde encontrar Inferido a partir do registro de data e hora da mudança para o status de aprovação final no módulo Account Reconciliation do BlackLine. Isso ocorre quando o fluxo de trabalho da conciliação é concluído. Coleta O evento é gerado quando o status da conciliação muda para Aprovada ou para o status de aprovação final no fluxo de trabalho. Tipo de evento inferred
	Conciliação certificada	Marca o momento em que a pessoa responsável pela preparação conclui o trabalho na conciliação de uma conta e a envia formalmente para análise. Em geral, isso é registrado por uma mudança de status no objeto de conciliação do módulo Account Reconciliation do BlackLine.
Por que isso importa Este é um ponto crítico de transferência no processo. Analisar o tempo entre a certificação e a aprovação revela gargalos no fluxo de trabalho de análise das conciliações e ajuda a acompanhar o KPI de tempo de aprovação das conciliações. Onde encontrar Inferido a partir do registro de data e hora de uma mudança de status no módulo Account Reconciliation. O evento ocorre quando o status de uma conciliação muda para Certificada ou outro status que indique que ela está pronta para análise. Coleta O evento é gerado quando o campo de status da conciliação muda para Certificada. Tipo de evento inferred
	Demonstrações financeiras geradas	As demonstrações financeiras formais, como o balanço patrimonial e a demonstração de resultados, foram preparadas. Este é um marco importante que indica que o pacote principal de reporte está pronto.
Por que isso importa Marca a transição dos processos contábeis para o reporte e a análise financeira. Acompanhar essa etapa ajuda a medir a eficiência da fase final do fechamento. Onde encontrar Essa etapa provavelmente é gerenciada como uma tarefa importante no módulo Close Management do BlackLine. A conclusão da tarefa indica que as demonstrações estão prontas para análise. Coleta Registre a data e hora de conclusão da tarefa de geração das demonstrações financeiras no plano de fechamento. Tipo de evento inferred
	Lançamento de ajuste contabilizado	Um lançamento contábil de ajuste criado no BlackLine foi contabilizado com sucesso no razão geral do sistema ERP de origem. Isso indica que a correção foi registrada formalmente.
Por que isso importa Esta atividade alimenta diretamente o KPI de quantidade de lançamentos de ajuste manual e é essencial para identificar áreas com baixa qualidade dos dados ou controles frágeis, que exigem correções manuais frequentes. Onde encontrar Registrado por meio de uma mudança de status no módulo Journal Entry do BlackLine. O evento ocorre quando o status do lançamento é atualizado para Contabilizado, geralmente após a confirmação da integração com o ERP. Coleta O evento é registrado quando o status do lançamento contábil muda para Contabilizado. Tipo de evento inferred
	Período aberto para fechamento	Esta atividade marca o início oficial do processo de fechamento financeiro de um período específico. Geralmente, é um evento programado no módulo Close Management do BlackLine, quando as tarefas são ativadas e o período passa a ser considerado aberto.
Por que isso importa Este é o principal evento de início do processo. Todos os cálculos de tempo de ciclo, como Tempo de ciclo total do fechamento do período e tempo de atravessamento da coleta de dados de origem, começam neste ponto. Onde encontrar Este evento provavelmente é registrado no módulo Close Management (Task Management) do BlackLine. Ele pode ser inferido pela data de ativação do plano de fechamento ou pela data de início da primeira tarefa do período financeiro. Coleta Identifique o registro de data e hora mais antigo associado a uma tarefa ou ao momento em que o período fica ativo no cronograma de fechamento. Tipo de evento inferred
	Período fechado	Esta é a atividade final: indica que todas as tarefas relacionadas ao fechamento foram concluídas e que o período financeiro foi oficialmente fechado. Não é possível contabilizar novas transações nesse período.
Por que isso importa Este é o principal evento de fim do processo. Ele é usado para calcular o tempo de ciclo total do fechamento do período e determinar a taxa de fechamentos de período dentro do prazo. Onde encontrar Este evento pode ser registrado no módulo Close Management do BlackLine quando o status geral do período muda para Fechado. Também pode ser inferido pela data e hora de conclusão da última tarefa do plano de fechamento. Coleta Identifique a data e hora em que o status do período muda para Fechado ou a data e hora da última tarefa concluída. Tipo de evento inferred
	Balancete gerado	Indica o momento em que um balancete preliminar ou final é gerado e analisado. Este é um marco crítico antes da elaboração das demonstrações financeiras finais.
Por que isso importa Esta atividade funciona como um ponto de controle importante no processo de fechamento. Atrasos na geração de um balancete estável costumam indicar problemas significativos nas etapas anteriores de conciliação ou de lançamento contábil. Onde encontrar Essa etapa costuma ser gerenciada como uma tarefa de marco específica no módulo Close Management do BlackLine. Sua conclusão indica que o balancete está pronto. Coleta Registre a data e hora de conclusão de uma tarefa específica de geração do balancete no plano de fechamento. Tipo de evento inferred
	Conciliação analisada	Indica que uma conciliação passou por pelo menos um nível de análise. Em fluxos de trabalho com vários níveis de aprovação, representa uma etapa intermediária antes da aprovação final.
Por que isso importa Esta atividade ajuda a identificar onde ocorrem atrasos em cadeias de aprovação complexas. Ela separa o tempo da análise inicial dos tempos das aprovações posteriores, feitas por níveis superiores. Onde encontrar Inferido a partir de uma mudança de status no módulo Account Reconciliation, quando um usuário com permissão de revisor aprova a conciliação sem concluir todo o fluxo de trabalho. Coleta O evento é registrado quando o status da conciliação muda para uma aprovação intermediária, como Analisada ou Aprovada no nível 1. Tipo de evento inferred
	Conciliação preparada	Um usuário realizou as etapas necessárias para conciliar uma conta, mas ainda não a enviou formalmente para análise. O evento é registrado quando a conciliação é salva com um status como Em andamento ou Preparada.
Por que isso importa Acompanhar essa etapa ajuda a entender o esforço inicial necessário para as conciliações. Um intervalo longo entre essa etapa e a certificação pode indicar conciliações complexas ou problemas na carga de trabalho dos usuários. Onde encontrar Inferido a partir das mudanças de status no módulo Account Reconciliation do BlackLine. Corresponde à primeira vez que uma conciliação passa de Não iniciada para um status ativo. Coleta O evento é registrado quando o status da conciliação muda de Não iniciada para Em andamento ou um status semelhante. Tipo de evento inferred
	Conciliação rejeitada	Um revisor rejeitou uma conciliação certificada e a devolveu à pessoa responsável pela preparação para correções. Esse evento indica um problema de qualidade ou uma exceção e inicia um ciclo de retrabalho.
Por que isso importa Esta atividade é essencial para medir a qualidade do processo e o retrabalho. Rejeições frequentes podem indicar treinamento insuficiente, políticas pouco claras ou problemas na qualidade dos dados. Onde encontrar Inferido a partir de uma mudança de status no módulo Account Reconciliation. O evento é registrado quando o status de uma conciliação muda para Rejeitada ou quando ela é devolvida à fila da pessoa responsável pela preparação. Coleta O evento é acionado quando o campo de status da conciliação é atualizado para Rejeitada ou um status semelhante. Tipo de evento inferred
	Dados de origem carregados	Indica que o carregamento dos dados transacionais dos sistemas de origem, como um ERP, para o BlackLine foi concluído. Essa etapa é necessária para iniciar as conciliações e os lançamentos contábeis do período.
Por que isso importa Atrasos no carregamento de dados criam um gargalo significativo para todo o processo de fechamento. Acompanhar essa atividade ajuda a medir o tempo de atravessamento da coleta de dados e a identificar problemas nas fontes de dados anteriores do processo. Onde encontrar Isso pode ser registrado como a conclusão de uma tarefa específica no módulo Close Management. Outra possibilidade é inferir o evento pelo registro de data e hora da primeira transação importada para o BlackLine no período financeiro em questão. Coleta Registre a data e hora de conclusão de uma tarefa específica de carregamento de dados ou use a data e hora da primeira importação de transação do período. Tipo de evento inferred
	Lançamento de ajuste criado	Durante a conciliação, um usuário identificou a necessidade de um ajuste e criou um lançamento contábil no BlackLine. Esse lançamento ainda não foi contabilizado no sistema ERP.
Por que isso importa Acompanhar a criação de lançamentos ajuda a entender o volume e o momento em que os ajustes são feitos. Isso diferencia a identificação de um problema da sua resolução final por meio da contabilização. Onde encontrar Este provavelmente é um evento explícito registrado no módulo Journal Entry do BlackLine. A criação de um novo registro de lançamento contábil para o período gera esse evento. Coleta Um registro é criado quando um usuário salva um novo lançamento contábil. Tipo de evento explicit
	Tarefa concluída	Uma tarefa específica da lista de verificação do fechamento de período foi marcada como concluída pelo usuário responsável. Isso representa a conclusão de um procedimento definido, como uma verificação de controle ou uma etapa de reporte.
Por que isso importa Analisar a conclusão das tarefas permite acompanhar o andamento do período de fechamento em detalhes. Isso ajuda a identificar quais etapas específicas estão atrasando o cronograma geral. Onde encontrar Este é um evento explícito do módulo Close Management (Task Management) do BlackLine. Cada tarefa tem uma data e hora de conclusão, registradas quando um usuário a marca como concluída. Coleta Registrado quando um usuário atualiza o status de uma tarefa para Concluída. Tipo de evento explicit
	Tarefa de fechamento em atraso	O prazo definido para uma tarefa programada de fechamento passou, mas ela não foi concluída. Este evento é calculado comparando o horário atual com a data de vencimento da tarefa.
Por que isso importa Isso destaca problemas de Conformidade e possíveis gargalos antes que afetem gravemente o prazo de fechamento. Assim, você pode gerenciar o processo de fechamento de forma proativa. Onde encontrar Este não é um evento explícito do sistema. Ele precisa ser calculado comparando a data e hora de conclusão da tarefa com o atributo de data de vencimento da tarefa nos dados do módulo Close Management. Coleta Calculado comparando a data de vencimento da tarefa com a data e hora de conclusão da tarefa. Se a conclusão ocorrer após o vencimento, a tarefa ficou em atraso. Tipo de evento calculated

Recomendado Opcional

Guias de extração

Como obter seus dados do BlackLine

Etapas

Pré-requisitos: configure o acesso à API do BlackLine
- Acesse sua instância do BlackLine com privilégios administrativos.
- Acesse a seção Admin e localize API Management. Se essa opção não estiver visível, entre em contato com o administrador do BlackLine.
- Registre um novo aplicativo de API para gerar um Client ID e um Client Secret.
- Conceda ao aplicativo os escopos de leitura necessários para reconciliações, tarefas, lançamentos e dados de usuários.
- Gere um Refresh Token para o aplicativo. O script usará esse token para autenticação.
- Armazene o Client ID, o Client Secret e o Refresh Token em um local seguro.
Configure o ambiente Python
- Verifique se o Python 3.8 ou uma versão mais recente está instalado no seu sistema.
- Abra um terminal ou prompt de comando e instale as bibliotecas necessárias com o comando: pip install requests pandas
Configure o script Python
- Salve o código Python fornecido na seção 'Consulta' em um arquivo, como extract_blackline_data.py.
- Abra o arquivo em um editor de texto e localize a seção de configuração no início.
- Substitua os valores de exemplo de BLACKLINE_BASE_URL, CLIENT_ID, CLIENT_SECRET e REFRESH_TOKEN pelas credenciais obtidas na Etapa 1.
- Defina as variáveis START_DATE e END_DATE para especificar o intervalo de extração dos dados. Use o formato 'YYYY-MM-DD'.
Entenda a lógica do script
- Primeiro, o script usa suas credenciais para se autenticar na API do BlackLine e obter um token de acesso temporário.
- Em seguida, faz chamadas sequenciais à API para buscar dados de reconciliações, tarefas e lançamentos no intervalo de datas especificado.
- O script inclui uma lógica para lidar com a paginação da API e recuperar todos os registros, não apenas os da primeira página.
Transforme os dados e crie eventos
- Para cada registro recuperado (reconciliação, tarefa ou lançamento), o script cria um ou mais eventos.
- Por exemplo, um único registro de reconciliação da API pode gerar várias linhas no Event Log: 'Reconciliação preparada', 'Reconciliação certificada', 'Reconciliação aprovada' etc., com base nos diferentes campos de data e hora dos dados.
- O script identifica atividades importantes, como 'Período aberto para fechamento' ou 'Demonstrações financeiras geradas', procurando nomes predefinidos específicos na lista de tarefas do BlackLine. Atualize o dicionário MILESTONE_TASK_MAPPING no script para que corresponda exatamente aos nomes dessas tarefas na sua configuração do BlackLine.
Execute o script
- Abra um terminal ou prompt de comando e acesse o diretório onde salvou o script.
- Execute o script com o comando: python extract_blackline_data.py
- O script exibirá mensagens de progresso no console enquanto busca e processa os dados.
Revise o arquivo de saída
- Ao terminar, o script gerará um arquivo CSV chamado blackline_event_log.csv no mesmo diretório.
- Esse arquivo contém o Event Log extraído, formatado com as colunas necessárias para carregamento no ProcessMind.
- Abra o CSV para revisar os dados e confirmar se estão corretos e completos antes de carregá-los.

Configuração

Credenciais da API: O script precisa de um CLIENT_ID, um CLIENT_SECRET e um REFRESH_TOKEN de um aplicativo de API registrado na sua instância do BlackLine. Mantenha essas credenciais em sigilo.
URL base do BlackLine: Informe a URL base da API da sua instância do BlackLine, por exemplo, https://api.blackline.com/v2.
Intervalo de datas: Os parâmetros START_DATE e END_DATE definem o período de extração. Para a primeira extração, recomenda-se um intervalo de 3 a 6 meses, que oferece dados suficientes para análise sem gerar um volume excessivo.
Mapeamento de tarefas importantes: A capacidade do script de identificar marcos importantes do processo, como 'Período fechado' ou 'Balancete gerado', depende do dicionário MILESTONE_TASK_MAPPING. Configure esse mapeamento com os nomes exatos das tarefas correspondentes na configuração do Close Management do BlackLine.
Limite de paginação: A variável LIMIT controla quantos registros são solicitados por chamada à API. O valor padrão costuma ser suficiente, mas pode ser ajustado conforme a performance e as recomendações do servidor da API.
Pré-requisitos: A conta de usuário da API precisa ter permissões de leitura para os módulos Account Reconciliations, Task Management e Journal Entry. Sem essas permissões, o script falhará ou retornará dados incompletos.

Consulta de exemplo python

import requests
import pandas as pd
import datetime
import time
import os

class=class="hl-string">"hl-comment"># --- CONFIGURATION SECTION --- #
class=class="hl-string">"hl-comment"># Replace with your BlackLine instance details
BLACKLINE_BASE_URL = class="hl-string">"https://[your-instance].blackline.com/v2" class=class="hl-string">"hl-comment"># e.g., https://api.blackline.com/v2
CLIENT_ID = os.environ.get(class="hl-string">'BLACKLINE_CLIENT_ID', class="hl-string">"YOUR_CLIENT_ID")
CLIENT_SECRET = os.environ.get(class="hl-string">'BLACKLINE_CLIENT_SECRET', class="hl-string">"YOUR_CLIENT_SECRET")
REFRESH_TOKEN = os.environ.get(class="hl-string">'BLACKLINE_REFRESH_TOKEN', class="hl-string">"YOUR_REFRESH_TOKEN")

class=class="hl-string">"hl-comment"># Date range for 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"># Records per page

class=class="hl-string">"hl-comment"># Mapping of BlackLine Task Names to ProcessMind Activity Names
class=class="hl-string">"hl-comment"># CRITICAL: Update these keys to match the exact names of tasks in your BlackLine instance.
MILESTONE_TASK_MAPPING = {
    class="hl-string">"Period Open": class="hl-string">"Period Open For Close",
    class="hl-string">"Load Source System Data": class="hl-string">"Source Data Loaded",
    class="hl-string">"Generate Preliminary Trial Balance": class="hl-string">"Trial Balance Generated",
    class="hl-string">"Generate Final Financial Statements": class="hl-string">"Financial Statements Generated",
    class="hl-string">"Close Period - Final": class="hl-string">"Period Closed"
}
class=class="hl-string">"hl-comment"># --- END CONFIGURATION --- #

def get_access_token():
    class="hl-string">"""Authenticates with BlackLine API to get an access token."""
    auth_url = fclass="hl-string">"{BLACKLINE_BASE_URL.replace('/v2', '')}/oauth/token"
    payload = {
        class="hl-string">'grant_type': class="hl-string">'refresh_token',
        class="hl-string">'refresh_token': REFRESH_TOKEN,
        class="hl-string">'client_id': CLIENT_ID,
        class="hl-string">'client_secret': CLIENT_SECRET
    }
    try:
        response = requests.post(auth_url, data=payload)
        response.raise_for_status()
        return response.json()[class="hl-string">'access_token']
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error getting access token: {e}")
        return None

def fetch_paginated_data(endpoint, headers, params):
    class="hl-string">"""Fetches all data from a paginated BlackLine API endpoint."""
    all_data = []
    url = fclass="hl-string">"{BLACKLINE_BASE_URL}/{endpoint}"
    offset = 0
    while True:
        params[class="hl-string">'offset'] = offset
        try:
            response = requests.get(url, headers=headers, params=params)
            response.raise_for_status()
            data = response.json()
            records = data.get(class="hl-string">'data', [])
            all_data.extend(records)

            if len(records) < LIMIT:
                break
            offset += LIMIT
            time.sleep(0.5) class=class="hl-string">"hl-comment"># Be respectful to the API rate limits
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching data from {endpoint}: {e}")
            break
    return all_data

def main():
    class="hl-string">"""Main function to extract, transform, and save BlackLine data."""
    print(class="hl-string">"Starting BlackLine data extraction...")
    access_token = get_access_token()
    if not access_token:
        return

    headers = {
        class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}',
        class="hl-string">'Content-Type': class="hl-string">'application/json'
    }

    event_log = []
    last_data_update = datetime.datetime.now().isoformat()

    class=class="hl-string">"hl-comment"># 1. Fetch and process Reconciliations
    print(class="hl-string">"Fetching reconciliations...")
    rec_params = {class="hl-string">'limit': LIMIT, class="hl-string">'updatedAfter': START_DATE, class="hl-string">'updatedBefore': END_DATE}
    reconciliations = fetch_paginated_data(class="hl-string">'reconciliations', headers, rec_params)
    for rec in reconciliations:
        common_attrs = {
            class="hl-string">'FinancialPeriod': rec.get(class="hl-string">'periodName'),
            class="hl-string">'CompanyCode': rec.get(class="hl-string">'companyCode'),
            class="hl-string">'GLAccount': rec.get(class="hl-string">'accountNumber'),
            class="hl-string">'Department': rec.get(class="hl-string">'preparer', {}).get(class="hl-string">'department'),
            class="hl-string">'SourceSystem': class="hl-string">'BlackLine',
            class="hl-string">'LastDataUpdate': last_data_update
        }
        if rec.get(class="hl-string">'preparedDate'):
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Reconciliation Prepared', class="hl-string">'EventTime': rec[class="hl-string">'preparedDate'], class="hl-string">'ResponsibleUser': rec.get(class="hl-string">'preparer', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': class="hl-string">'Prepared'}) 
        if rec.get(class="hl-string">'certifiedDate'):
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Reconciliation Certified', class="hl-string">'EventTime': rec[class="hl-string">'certifiedDate'], class="hl-string">'ResponsibleUser': rec.get(class="hl-string">'preparer', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': class="hl-string">'Certified'}) 
        if rec.get(class="hl-string">'reviewedDate'): class=class="hl-string">"hl-comment"># This may represent first or last review depending on config
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Reconciliation Reviewed', class="hl-string">'EventTime': rec[class="hl-string">'reviewedDate'], class="hl-string">'ResponsibleUser': rec.get(class="hl-string">'reviewer', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': class="hl-string">'Reviewed'}) 
        if rec.get(class="hl-string">'rejectedDate'):
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Reconciliation Rejected', class="hl-string">'EventTime': rec[class="hl-string">'rejectedDate'], class="hl-string">'ResponsibleUser': rec.get(class="hl-string">'reviewer', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': class="hl-string">'Rejected'}) 
        if rec.get(class="hl-string">'approvedDate'):
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Reconciliation Approved', class="hl-string">'EventTime': rec[class="hl-string">'approvedDate'], class="hl-string">'ResponsibleUser': rec.get(class="hl-string">'approver', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': class="hl-string">'Approved'}) 

    class=class="hl-string">"hl-comment"># 2. Fetch and process Tasks
    print(class="hl-string">"Fetching tasks...")
    task_params = {class="hl-string">'limit': LIMIT, class="hl-string">'updatedAfter': START_DATE, class="hl-string">'updatedBefore': END_DATE}
    tasks = fetch_paginated_data(class="hl-string">'tasks', headers, task_params)
    today = datetime.datetime.now().isoformat()
    for task in tasks:
        common_attrs = {
            class="hl-string">'FinancialPeriod': task.get(class="hl-string">'periodName'),
            class="hl-string">'CompanyCode': task.get(class="hl-string">'companyCode'),
            class="hl-string">'GLAccount': None,
            class="hl-string">'Department': task.get(class="hl-string">'assignee', {}).get(class="hl-string">'department'),
            class="hl-string">'SourceSystem': class="hl-string">'BlackLine',
            class="hl-string">'LastDataUpdate': last_data_update
        }
        if task.get(class="hl-string">'status') == class="hl-string">'Completed' and task.get(class="hl-string">'completedDate'):
            activity_name = MILESTONE_TASK_MAPPING.get(task.get(class="hl-string">'name'), class="hl-string">'Task Completed')
            event_log.append({**common_attrs, class="hl-string">'ActivityName': activity_name, class="hl-string">'EventTime': task[class="hl-string">'completedDate'], class="hl-string">'ResponsibleUser': task.get(class="hl-string">'assignee', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': None})
        elif task.get(class="hl-string">'dueDate') and task.get(class="hl-string">'dueDate') < today and task.get(class="hl-string">'status') != class="hl-string">'Completed':
             event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Task Delinquent', class="hl-string">'EventTime': task[class="hl-string">'dueDate'], class="hl-string">'ResponsibleUser': task.get(class="hl-string">'assignee', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': None})

    class=class="hl-string">"hl-comment"># 3. Fetch and process Journals
    print(class="hl-string">"Fetching journals...")
    journal_params = {class="hl-string">'limit': LIMIT, class="hl-string">'updatedAfter': START_DATE, class="hl-string">'updatedBefore': END_DATE}
    journals = fetch_paginated_data(class="hl-string">'journals', headers, journal_params)
    for journal in journals:
        common_attrs = {
            class="hl-string">'FinancialPeriod': journal.get(class="hl-string">'periodName'),
            class="hl-string">'CompanyCode': journal.get(class="hl-string">'companyCode'),
            class="hl-string">'GLAccount': journal.get(class="hl-string">'lines', [{}])[0].get(class="hl-string">'accountNumber'), class=class="hl-string">"hl-comment"># Get account from first line
            class="hl-string">'Department': journal.get(class="hl-string">'creator', {}).get(class="hl-string">'department'),
            class="hl-string">'SourceSystem': class="hl-string">'BlackLine',
            class="hl-string">'LastDataUpdate': last_data_update
        }
        if journal.get(class="hl-string">'createdDate'):
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Adjusting Journal Created', class="hl-string">'EventTime': journal[class="hl-string">'createdDate'], class="hl-string">'ResponsibleUser': journal.get(class="hl-string">'creator', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': None})
        if journal.get(class="hl-string">'postedDate'):
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Adjusting Journal Posted', class="hl-string">'EventTime': journal[class="hl-string">'postedDate'], class="hl-string">'ResponsibleUser': journal.get(class="hl-string">'poster', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': None})

    class=class="hl-string">"hl-comment"># 4. Create DataFrame and save to CSV
    if not event_log:
        print(class="hl-string">"No events found for the specified period.")
        return

    df = pd.DataFrame(event_log)
    class=class="hl-string">"hl-comment"># Add missing recommended columns with null values if they don't exist
    recommended_cols = [class="hl-string">'EventEndTime']
    for col in recommended_cols:
        if col not in df.columns:
            df[col] = None

    class=class="hl-string">"hl-comment"># Reorder columns to match ProcessMind requirements
    final_cols = [class="hl-string">'FinancialPeriod', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'EventEndTime', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate', class="hl-string">'ResponsibleUser', class="hl-string">'Department', class="hl-string">'ReconciliationStatus', class="hl-string">'CompanyCode', class="hl-string">'GLAccount']
    df = df[final_cols]

    output_file = class="hl-string">'blackline_event_log.csv'
    df.to_csv(output_file, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%S.%f')
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_file}")

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

Pronto para começar?

Com este Template, você tem tudo o que precisa para preparar os dados e começar a otimizar o processo de registro a relatório, fechamento do período e conciliação. Comece hoje a melhorar a eficiência e a precisão.

Voltar ao guia de melhoria

Baixar Template

Otimize agora o processo de registro ao reporte, fechamento do período e reconciliação

Reduza o tempo de ciclo em 30% e garanta relatórios financeiros precisos.

Comece hoje seu teste gratuito.

Não é necessário informar cartão de crédito

Seu Template de dados de registro a relatório: fechamento do período e conciliação

Seu Template de dados de registro a relatório: fechamento do período e conciliação

Atributos de registro a relatório: fechamento do período e conciliação

Atividades de registro a relatório: fechamento do período e conciliação

Guias de extração

Extração de dados com script Python pela API REST do BlackLine

Etapas

Configuração

Consulta de exemplo python

Pronto para começar?

Otimize agora o processo de registro ao reporte, fechamento do período e reconciliação