> Mejora continua de procesos > Del registro al informe: asiento contable > BlackLine > Template de datos

Su Template de datos de Record to Report - Journal Entry

BlackLine

Del registro al informe: atributos del asiento contable (19) Del registro al informe: actividades del asiento contable (12) Guías de extracción (2)

Su Template de datos de Record to Report - Journal Entry

Este Template ofrece una guía completa para recopilar los datos adecuados para analizar su proceso de Record to Report - Journal Entry. Describe los atributos esenciales que debe recopilar, las actividades clave que debe seguir y recomendaciones prácticas para extraer esta información de BlackLine. Utilice este recurso para asegurarse de capturar todos los datos necesarios para un Process Mining eficaz.

Atributos recomendados que debe recopilar
Actividades clave que debe seguir
Guía de extracción

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

Descargar Template

Del registro al informe: atributos del asiento contable

Estos son los campos de datos recomendados para incluir en su registro de eventos y realizar un análisis completo de su proceso de registro al informe de asientos contables.

5 Obligatorio 6 Recomendado 8 Opcional

	Nombre	Descripción
	Actividad ActivityName	El nombre del evento empresarial específico que ocurrió en un momento determinado del proceso del asiento contable.
Descripción Este atributo describe un paso o una tarea individual realizada durante el ciclo de vida del asiento contable, como «Journal Entry Created», «Journal Entry Approved» o «Journal Entry Posted». Cada actividad representa un evento distinto del proceso. Analizar la secuencia de estas actividades permite visualizar y comprender el flujo del proceso. Es fundamental para descubrir variaciones del proceso, medir los tiempos de transición entre pasos e identificar ciclos de retrabajo, por ejemplo, cuando un asiento contable se rechaza y se vuelve a enviar. Por qué es importante Define los pasos del proceso, algo esencial para visualizar el mapa del proceso, analizar el flujo e identificar desviaciones o cuellos de botella. Dónde obtenerlo Normalmente se deriva de registros de eventos, registros de cambios de estado o registros de auditoría de BlackLine. Puede ser necesario asignar los códigos de estado del sistema a nombres de actividad comprensibles para los usuarios. Ejemplos Asiento contable creadoAsiento contable enviadoAsiento contable aprobadoAsiento contable contabilizado
	Hora de inicio EventTime	La marca de tiempo precisa que indica cuándo ocurrió una actividad o un evento específico.
Descripción Event Time registra la fecha y la hora en que ocurrió un evento empresarial. Es la base cronológica del proceso, ya que establece la secuencia y la duración de todas las actividades. Esta marca de tiempo es fundamental para todos los análisis de Process Mining basados en el tiempo. Se utiliza para calcular tiempos de ciclo, tiempos de espera y duraciones entre actividades. Permite identificar cuellos de botella, analizar el rendimiento a lo largo del tiempo y evaluar el cumplimiento de los acuerdos de nivel de servicio. Por qué es importante Esta marca de tiempo es la base de todas las métricas de rendimiento, incluido el tiempo de ciclo y el análisis de cuellos de botella, y permite reconstruir cronológicamente el proceso. Dónde obtenerlo Esta información se captura en los campos de marca de tiempo de los registros de eventos o de las transacciones de BlackLine. Ejemplos 2023-10-26T10:00:00Z2023-10-26T11:30:00Z2023-10-27T14:05:00Z
	ID del asiento contable JournalEntryId	El identificador único de un asiento contable individual, que actúa como identificador principal del caso para hacer seguimiento de su ciclo de vida.
Descripción El Journal Entry ID identifica de forma única cada conjunto de transacciones financieras registradas en el libro mayor. Actúa como clave central que vincula todas las actividades relacionadas, como la creación, la revisión, la aprobación y la contabilización. En Process Mining, este ID es esencial para correlacionar todos los eventos pertenecientes a un mismo caso de asiento contable. Analizar el flujo del proceso a partir de este identificador permite reconstruir el recorrido de extremo a extremo, desde el inicio hasta la conciliación final, y facilita un análisis detallado de los tiempos de ciclo, los cuellos de botella y las variaciones del proceso. Por qué es importante Este es el identificador fundamental del caso, que permite rastrear el ciclo de vida completo de un asiento contable individual y analizar su rendimiento. Dónde obtenerlo Es una clave principal en las tablas de asientos contables o en las exportaciones de datos de BlackLine. Consulte la documentación de BlackLine para conocer el nombre específico del campo. Ejemplos JE2024-001234JE2024-001235JE2024-001236
	Sistema de origen SourceSystem	El sistema de registro del que se extrajeron los datos del asiento contable.
Descripción Este atributo identifica el sistema de origen de los datos de eventos. En este contexto, normalmente será «BlackLine», aunque también podría incluir datos de un sistema ERP anterior si el proceso comienza allí. Identificar el sistema de origen es importante para la gobernanza de datos y para comprender el contexto del proceso, especialmente cuando se combinan datos de varios sistemas. Ayuda a solucionar problemas de ingesta de datos y a verificar su trazabilidad. Por qué es importante Proporciona un contexto esencial sobre el origen de los datos, garantiza la trazabilidad y ayuda a gestionar la integración de datos procedentes de distintas plataformas. Dónde obtenerlo Normalmente es un valor estático que se añade durante el proceso de extracción y transformación de datos para etiquetar el origen del conjunto de datos. Ejemplos BlackLineSAP S/4HANAOracle NetSuite
	Última actualización de datos LastDataUpdate	La marca de tiempo que indica la última vez que se actualizaron o extrajeron los datos del sistema de origen.
Descripción Este atributo marca la fecha y la hora de la extracción más reciente de datos. Proporciona un punto de referencia sobre la actualidad de los datos analizados y garantiza que los usuarios sepan hasta qué fecha están actualizados. Es un metadato crítico para cualquier Dashboard o análisis de Process Mining. Informa a los usuarios sobre la actualidad de los insights y ayuda a gestionar las expectativas sobre si la vista incluye las transacciones más recientes. Por qué es importante Garantiza la transparencia sobre la actualidad de los datos y permite comprender hasta qué punto está actualizado el análisis del proceso. Dónde obtenerlo Esta marca de tiempo la genera y añade al conjunto de datos la herramienta de extracción o el proceso ETL durante su ejecución. Ejemplos 2023-11-01T02:00:00Z2023-11-02T02:00:00Z
	Código de empresa CompanyCode	El identificador único de la entidad jurídica o empresa para la que se realiza el asiento contable.
Descripción Company Code representa una entidad jurídica específica dentro de un grupo empresarial. Es una unidad organizativa fundamental de la contabilidad financiera, ya que garantiza que las transacciones se registren en la entidad correcta. En Process Mining, Company Code es una dimensión muy útil para filtrar y comparar. Permite analizar el rendimiento del proceso entre distintas entidades, identificar cuellos de botella y variaciones de cumplimiento específicos de una región o entidad, y detectar oportunidades para estandarizar los procesos a escala global. También respalda directamente el Dashboard «Análisis del retraso entre la aprobación y la contabilización». Por qué es importante Permite comparar el rendimiento y apoyar los esfuerzos de estandarización del proceso entre distintas entidades jurídicas o unidades de negocio. Dónde obtenerlo Es un campo clave de la cabecera del asiento contable en BlackLine y suele sincronizarse desde el sistema ERP subyacente. Ejemplos 1000US01DE012500
	Estado del asiento contable JournalEntryStatus	El estado actual del asiento contable en su ciclo de vida, por ejemplo, «In Progress», «Approved» o «Posted».
Descripción Este atributo indica el estado actual de un caso de asiento contable en el momento de la extracción de datos. Proporciona una instantánea de la posición del asiento dentro del proceso general. Aunque Process Mining reconstruye el flujo a partir de las actividades, disponer del estado final resulta útil para filtrar y crear Dashboards de resumen de alto nivel. Ayuda a identificar rápidamente todos los asientos que están pendientes de aprobación o atascados en un estado concreto, lo que resulta valioso para analizar el trabajo pendiente. Por qué es importante Proporciona una instantánea del estado actual de los asientos, útil para analizar el trabajo pendiente y comprender el trabajo en curso. Dónde obtenerlo Es un campo de estado estándar del asiento contable en BlackLine. Ejemplos En cursoPendiente de aprobaciónAprobadoContabilizadoRechazado
	Importe del asiento contable JournalEntryAmount	El valor monetario total del asiento contable, normalmente la suma de los débitos.
Descripción Este atributo representa el valor financiero del asiento contable. Puede utilizarse para comprender el impacto financiero de las ineficiencias del proceso, como los retrasos en la contabilización de asientos de importe elevado. Analizar el proceso según el valor del asiento permite realizar análisis basados en la materialidad. Por ejemplo, puede priorizar las mejoras de proceso para los asientos de importe elevado, investigar si siguen una ruta de aprobación diferente o determinar si sus tiempos de ciclo son más largos. Esto aporta un contexto empresarial esencial al flujo del proceso. Por qué es importante Proporciona contexto financiero y permite realizar análisis basados en la materialidad, como priorizar asientos de importe elevado o identificar desviaciones del proceso relacionadas con el valor. Dónde obtenerlo Es un campo calculado o estándar de la cabecera del asiento contable en BlackLine que representa el importe total del débito o del crédito. Ejemplos 15000.00250.75125000.50500.00
	Motivo del rechazo RejectionReason	El motivo indicado por la persona revisora cuando se rechaza un asiento contable.
Descripción Cuando un asiento contable se devuelve para corregirlo, la persona aprobadora normalmente indica el motivo del rechazo. Este atributo captura dicho motivo, que puede ser un código predefinido o texto libre. Es un atributo crítico para analizar las causas raíz del retrabajo. Al analizar los motivos de rechazo más frecuentes, una empresa puede identificar problemas sistémicos, como una capacitación insuficiente, políticas poco claras o problemas con la documentación justificativa. Esto respalda directamente el Dashboard «Análisis de rechazos y retrabajos de asientos contables» y ayuda a reducir la tasa general de rechazo. Por qué es importante Es esencial para analizar las causas raíz del retrabajo del proceso, ya que ayuda a identificar por qué se rechazan los asientos contables y permite aplicar mejoras específicas. Dónde obtenerlo Estos datos normalmente se capturan en un campo de comentarios o de código de motivo cuando un usuario ejecuta la acción «Reject» en BlackLine. Ejemplos Código de cuenta incorrectoFalta documentación justificativaSupera el umbralAsiento duplicado
	Tipo de asiento contable JournalEntryType	La clasificación del asiento contable, por ejemplo, estándar, recurrente o de reversión.
Descripción Journal Entry Type clasifica los asientos según su naturaleza o finalidad. Entre los tipos habituales se incluyen los asientos manuales estándar, los asientos generados automáticamente por el sistema, los asientos recurrentes para provisiones de cierre mensual y los asientos de reversión que se revierten automáticamente en el periodo siguiente. Este atributo es fundamental para la segmentación y el análisis comparativo. Permite comparar el rendimiento del proceso, como los tiempos de ciclo o las tasas de rechazo, entre distintos tipos de asientos. Así se puede identificar si determinados tipos de asientos presentan más problemas o son menos eficientes que otros, y aplicar mejoras específicas. Por qué es importante Permite realizar análisis segmentados para comprender si los distintos tipos de asientos contables siguen rutas diferentes o presentan características de rendimiento distintas. Dónde obtenerlo Es un campo estándar de la cabecera del asiento contable en BlackLine. Consulte la documentación de BlackLine para conocer el nombre exacto del campo. Ejemplos EstándarRecurrenteReversiónDevengo
	Usuario UserName	El nombre o el ID del usuario que realizó la actividad.
Descripción Este atributo identifica a la persona responsable de ejecutar un paso específico del proceso, como quien envió, revisó o aprobó un asiento contable. Puede ser un nombre o un ID de usuario único. Analizar las actividades por usuario es esencial para comprender la distribución de la carga de trabajo, el rendimiento individual e identificar oportunidades de capacitación. Ayuda a responder preguntas como «¿El trabajo se distribuye de forma equilibrada en el equipo?» o «¿Qué usuarios tienen los tiempos de aprobación más largos?». También es fundamental para el cumplimiento y el análisis del registro de auditoría. Por qué es importante Permite analizar la carga de trabajo, comparar el rendimiento entre miembros del equipo e identificar cuellos de botella relacionados con los recursos o necesidades de capacitación. Dónde obtenerlo Esta información está disponible en los registros de auditoría de BlackLine, normalmente en campos como «User ID» o «Changed By» asociados a cada evento. Ejemplos j.doea.smithr.joness.patel
	Cuenta conciliada AccountReconciled	El número de la cuenta del libro mayor que se concilia mediante el asiento contable.
Descripción Este atributo identifica la cuenta específica del plan contable que se ve afectada o que se está conciliando. Los asientos contables suelen formar parte del proceso de conciliación de cuentas, y este campo vincula el asiento con esa cuenta concreta. Este atributo respalda directamente el Dashboard «Tiempo de ciclo de conciliación de asientos contables». Al analizar el proceso por cuenta, es posible identificar si las conciliaciones de determinadas cuentas tardan sistemáticamente más, lo que puede indicar complejidad o problemas de datos relacionados con esas cuentas. Por qué es importante Vincula el proceso del asiento contable con las cuentas específicas que se están conciliando y permite analizar de forma focalizada los cuellos de botella de la conciliación. Dónde obtenerlo Esta información forma parte de los detalles de las partidas del asiento contable en BlackLine. Puede ser necesario agregarla al nivel del caso si un asiento afecta a varias cuentas. Ejemplos 101000210500400100550200
	Departamento Department	El departamento de negocio o centro de costos asociado al asiento contable.
Descripción Este atributo especifica el departamento, centro de costos o área funcional que inició el asiento contable o a la que se asignan los costos. Proporciona una capa adicional de contexto organizativo. Analizar el proceso por departamento ayuda a comprender cómo utilizan las distintas áreas de la empresa el proceso de asientos contables. Puede revelar variaciones en la eficiencia, el cumplimiento o las tasas de retrabajo entre departamentos, y poner de relieve las áreas que necesitan apoyo adicional o una mayor estandarización del proceso. Por qué es importante Permite comparar el rendimiento del proceso entre distintos departamentos de la empresa, revelar variaciones e identificar oportunidades de estandarización. Dónde obtenerlo Esta información suele formar parte de los datos de las partidas o de la cabecera del asiento contable en BlackLine, y a menudo está vinculada a la cuenta del libro mayor. Ejemplos FinanzasMarketingVentasOperaciones
	Documento adjunto IsDocumentAttached	Una marca que indica si se adjuntó documentación justificativa al asiento contable.
Descripción Este atributo booleano indica si se han adjuntado uno o más documentos justificativos, como facturas o cálculos, al asiento contable. A menudo, esto es un requisito previo para la aprobación. Esta marca es fundamental para el Dashboard «Cumplimiento de la documentación de asientos contables» y el KPI «Tasa de documentos adjuntos». Ayuda a analizar si la falta de documentación es una causa frecuente de rechazos o retrasos, y contribuye a hacer cumplir las políticas que exigen adjuntar documentos antes de enviar el asiento a revisión. Por qué es importante Mide directamente el cumplimiento de las políticas de documentación y ayuda a diagnosticar una causa raíz frecuente de los retrasos y rechazos en la aprobación. Dónde obtenerlo Probablemente sería un campo derivado, calculado al comprobar si existe un registro de adjunto asociado al JournalEntryId antes de que ocurra la actividad de envío. Ejemplos truefalse
	Es automático IsAutomated	Una marca que indica si el asiento contable fue creado o contabilizado mediante un proceso automatizado.
Descripción Este atributo booleano distingue entre los asientos contables creados y procesados manualmente por usuarios y los generados automáticamente por el sistema, como los asientos recurrentes o las integraciones de sistemas. Analizar este atributo ayuda a evaluar la eficacia de la automatización. Permite comparar directamente los tiempos de ciclo, las tasas de error y los costos de los procesos automatizados y manuales. Es clave para justificar nuevas iniciativas de automatización y medir el ROI de las existentes. Por qué es importante Permite comparar directamente los procesos manuales y automatizados, algo fundamental para medir el impacto y el ROI de las iniciativas de automatización. Dónde obtenerlo Puede derivarse de «Journal Entry Type», por ejemplo, «Recurring», o del campo «User» si se utilizan usuarios del sistema, como «SYSTEM» o «BATCH», para las contabilizaciones automatizadas. Ejemplos truefalse
	Es retrabajo IsRework	Una marca calculada que es verdadera si el asiento contable se ha rechazado al menos una vez.
Descripción Esta marca booleana se calcula para identificar los asientos contables que han pasado por un retrabajo. Normalmente se establece como verdadera si un caso contiene la actividad «Journal Entry Rejected» seguida de la actividad «Corrected and Resubmitted». Este atributo simplifica el análisis del retrabajo, ya que permite filtrar fácilmente todos los casos que han sufrido un rechazo. Es fundamental para calcular el KPI «Tasa de rechazo de asientos contables» y para realizar análisis detallados en el Dashboard «Análisis de rechazos y retrabajos de asientos contables», con el fin de comprender el impacto de los problemas de calidad en el costo y el tiempo. Por qué es importante Identifica fácilmente los casos con retrabajo, simplifica el cálculo de las tasas de rechazo y permite analizar el impacto de los problemas de calidad. Dónde obtenerlo Esta marca se calcula en la herramienta de Process Mining comprobando la secuencia de actividades de cada caso. Ejemplos truefalse
	Fecha de contabilización PostingDate	La fecha en la que el asiento contable se contabiliza oficialmente en el libro mayor.
Descripción La Posting Date es la fecha efectiva de la transacción en los registros financieros. Es una fecha crítica para la contabilidad, ya que determina el periodo fiscal en el que se reconoce la transacción. Aunque la marca de tiempo del evento registra cuándo ocurrió la actividad de contabilización, la Posting Date es un atributo de datos clave. Se utiliza en el análisis financiero para garantizar que los asientos se contabilicen en el periodo correcto y para analizar los retrasos entre la fecha de la transacción, la fecha de aprobación y la fecha de contabilización. Por qué es importante Esta fecha es fundamental para la precisión de los informes financieros y ayuda a analizar si los asientos se contabilizan en el periodo contable correcto. Dónde obtenerlo Es un campo de fecha estándar de la cabecera del asiento contable en BlackLine. Ejemplos 2023-10-312023-11-012023-10-30
	Moneda Currency	El código de moneda del importe especificado en el asiento contable.
Descripción Este atributo especifica la moneda del Journal Entry Amount, como USD, EUR o GBP. Es esencial para interpretar correctamente el valor financiero de las transacciones. En organizaciones multinacionales, analizar los datos por moneda puede aportar un contexto útil. Permite filtrar el análisis del proceso por monedas específicas y es un campo necesario para cualquier Dashboard que agregue importes financieros. Por qué es importante Proporciona el contexto necesario para interpretar correctamente los importes financieros y permite realizar análisis específicos por moneda. Dónde obtenerlo Es un campo estándar de la cabecera del asiento contable en BlackLine, normalmente denominado «Document Currency» o de forma similar. Ejemplos USDEURGBPJPY
	Retraso entre la aprobación y la contabilización ApprovalToPostingLag	La duración calculada entre la aprobación final y la contabilización efectiva del asiento contable.
Descripción Esta métrica mide el retraso que se produce después de que un asiento contable haya sido aprobado por completo, pero antes de contabilizarlo en el libro mayor. Se calcula como la diferencia de tiempo entre la actividad «Journal Entry Approved» y la actividad «Journal Entry Posted». Es un KPI crítico para identificar cuellos de botella posteriores a la aprobación, que pueden retrasar considerablemente el cierre financiero. El Dashboard «Análisis del retraso entre la aprobación y la contabilización» utiliza esta métrica para investigar por qué los asientos aprobados no se contabilizan con rapidez y ayudar a agilizar las etapas finales del proceso. Por qué es importante Mide específicamente la eficiencia posterior a la aprobación y ayuda a identificar y eliminar retrasos que afectan a la rapidez del cierre financiero. Dónde obtenerlo Esta métrica se calcula en la herramienta de Process Mining determinando la duración entre los eventos «Journal Entry Approved» y «Journal Entry Posted» de cada caso. Ejemplos P0DT1H10MP1DT2H0MP0DT0H5M

Obligatorio Recomendado Opcional

Del registro al informe: actividades del asiento contable

Estos son los pasos clave y los hitos del proceso que debe capturar en su registro de eventos para descubrir y analizar con precisión su proceso de asientos contables.

6 Recomendado 6 Opcional

	Actividad	Descripción
	Asiento contable aprobado	Esta actividad indica que el asiento contable ha superado todas las etapas requeridas de revisión y aprobación. Se registra cuando la persona autorizada para la aprobación final aprueba el asiento, lo que activa un cambio de estado a «Approved».
Por qué es importante Este es un hito importante que concluye el proceso de aprobación. El tiempo transcurrido entre «Journal Entry Submitted» y este evento es el «tiempo de ciclo de aprobación», un KPI crítico para medir la eficiencia del Workflow. Dónde obtenerlo Este evento se infiere a partir de un cambio de estado a «Approved» en el registro del asiento contable. Normalmente, el ID de usuario de la persona aprobadora final y la marca de tiempo de la aprobación quedan registrados en el historial de auditoría de BlackLine. Recopilar Se infiere a partir de la marca de tiempo en la que el estado del asiento contable se actualiza a «Approved». Tipo de evento inferred
	Asiento contable conciliado	Marca la finalización del ciclo en el que el asiento contable se incluye en una conciliación de cuentas finalizada y certificada. En BlackLine, corresponde a la certificación de la conciliación que contiene este asiento.
Por qué es importante Esta actividad sirve como punto final del proceso de extremo a extremo. El tiempo transcurrido entre «Journal Entry Posted» y «Reconciled» mide la eficiencia de la parte de conciliación de cuentas del cierre financiero. Dónde obtenerlo Este es un evento inferido. Se deriva de identificar cuándo el estado de la conciliación de cuentas que contiene el asiento contable específico cambia a «Certified» en el módulo Account Reconciliation de BlackLine. Recopilar Se infiere al vincular el asiento contable con su conciliación de cuentas correspondiente y registrar la fecha de certificación de dicha conciliación. Tipo de evento inferred
	Asiento contable contabilizado	Representa el momento en que el asiento contable aprobado se registra oficialmente en el libro mayor. A menudo corresponde a una acción explícita en BlackLine, que posteriormente actualiza el estado del asiento a «Posted».
Por qué es importante Este es un hito crítico, considerado a menudo la conclusión operativa del proceso. El tiempo transcurrido entre «Journal Entry Approved» y esta actividad es un indicador clave de la eficiencia posterior a la aprobación. Dónde obtenerlo Normalmente se infiere a partir de un cambio de estado a «Posted». El evento también puede registrarse explícitamente en una tabla de historial de contabilizaciones o en un registro de auditoría, con una fecha y una marca de tiempo de contabilización específicas. Recopilar Se infiere a partir de la marca de tiempo en la que el estado del asiento contable se actualiza a «Posted». El campo de fecha de contabilización también es relevante. Tipo de evento inferred
	Asiento contable creado	Esta actividad marca el inicio de un caso de asiento contable. Se registra cuando una persona usuaria crea un nuevo registro de asiento contable en BlackLine, lo que genera un Journal Entry ID único y registra la marca de tiempo y la persona usuaria que lo creó.
Por qué es importante Este es el evento de inicio principal del proceso. Analizar el tiempo transcurrido desde esta actividad hasta otras permite conocer el tiempo total de ciclo del proceso y ayuda a identificar retrasos desde el comienzo del Workflow. Dónde obtenerlo Este evento se registra explícitamente en el módulo de asientos contables de BlackLine. Se captura a partir de la marca de tiempo de creación y los datos de la persona usuaria asociados con cada Journal Entry ID en la tabla principal de asientos contables o en su historial de auditoría. Recopilar Se captura a partir de la marca de tiempo «Create Date» asociada con el registro del asiento contable. Tipo de evento explicit
	Asiento contable enviado	Esta actividad ocurre cuando la persona preparadora envía formalmente el asiento contable al Workflow de revisión y aprobación. Normalmente, se captura como un cambio de estado, por ejemplo, de «In Preparation» a «Submitted», junto con una marca de tiempo.
Por qué es importante Esto marca el final de la fase de preparación y el comienzo del ciclo de aprobación. Es un hito clave para medir la duración tanto de la fase de preparación como de la fase de aprobación. Dónde obtenerlo Probablemente se infiere a partir de un cambio de estado en el registro del asiento contable en BlackLine. La marca de tiempo del cambio de estado a «Submitted for Approval» o a un valor similar marca el momento del evento. Recopilar Se infiere a partir de la marca de tiempo en la que el campo de estado del asiento contable se actualiza a «Submitted» o «Pending Approval». Tipo de evento inferred
	Asiento contable rechazado	Esta actividad marca el rechazo de un asiento contable por parte de una persona revisora o aprobadora. Se registra cuando un usuario selecciona la acción «Reject», que actualiza el estado del asiento a «Rejected» y queda registrada en el registro de auditoría.
Por qué es importante Esta es una actividad crítica para identificar retrabajos, problemas de calidad y necesidades de capacitación. Analizar la frecuencia y los motivos de rechazo, así como el ciclo de retrabajo posterior, es clave para mejorar el proceso y reducir los tiempos de ciclo. Dónde obtenerlo Normalmente se infiere a partir de un cambio de estado a «Rejected» o «Needs Correction» en los datos del asiento contable. La marca de tiempo y el usuario que realizó el rechazo quedan registrados en el historial de BlackLine. Recopilar Se infiere a partir de la marca de tiempo en la que el estado del asiento contable se actualiza a «Rejected». Tipo de evento inferred
	Aprobación revocada	Esta actividad representa la revocación de una aprobación concedida previamente, lo que devuelve el asiento contable a un estado anterior. Se registra mediante un cambio de estado de «Approved» a un estado anterior, como «In Preparation».
Por qué es importante Esta actividad, poco frecuente pero importante, pone de relieve excepciones del proceso y posibles problemas detectados después de la aprobación, pero antes de la contabilización. Puede indicar errores en los datos o cambios en las políticas que afectan al asiento. Dónde obtenerlo Sería un evento inferido, identificado por un cambio de estado de «Approved» a un estado editable que aún no se ha contabilizado. Esta acción quedaría registrada en los registros de auditoría detallados de BlackLine. Recopilar Se identifica mediante un cambio de estado de «Approved» a un estado anterior, como «In Preparation» o «Submitted». Tipo de evento inferred
	Asiento contable revisado	Representa un paso formal de revisión dentro de un proceso de aprobación multinivel, completado por una persona revisora designada. Normalmente, se captura como un cambio de estado o una entrada específica del registro que indica la acción de la persona revisora.
Por qué es importante En las organizaciones con etapas diferenciadas de revisión y aprobación, esta actividad ayuda a aislar los cuellos de botella de la cadena de aprobación. Muestra cuánto tiempo esperan los asientos la revisión inicial frente a la aprobación definitiva. Dónde obtenerlo En los Workflows de BlackLine, puede ser un evento explícito del registro del historial de aprobaciones o inferirse a partir de un cambio de estado a «Reviewed» o «Pending Final Approval». Se registran la persona usuaria y la marca de tiempo. Recopilar Se infiere a partir de la marca de tiempo en la que el estado del asiento contable cambia para reflejar la finalización de la etapa de revisión. Tipo de evento inferred
	Asiento corregido y reenviado	Ocurre después de que se rechaza un asiento contable y la persona preparadora realiza las correcciones necesarias y lo vuelve a enviar. Se registra mediante un cambio de estado de «Rejected» a «Submitted for Approval».
Por qué es importante Esta actividad ayuda a cuantificar el tiempo y el esfuerzo dedicados al retrabajo. La duración entre «Journal Entry Rejected» y este evento representa el tiempo de retrabajo, una métrica clave para analizar la eficiencia. Dónde obtenerlo Se infiere al observar una secuencia de cambios de estado en los datos de BlackLine, específicamente una transición de «Rejected» a «Submitted» o «Pending Approval» para el mismo Journal Entry ID. Recopilar Se deriva de un cambio de estado de «Rejected» a «Submitted» o «Pending Approval». Tipo de evento inferred
	Contabilización verificada	Representa la confirmación de que un asiento contable contabilizado se ha recibido y registrado correctamente en el sistema ERP de destino. Puede tratarse de una confirmación automática entre sistemas o de un paso de confirmación manual.
Por qué es importante Esta actividad completa el paso de contabilización y garantiza la integridad de los datos entre sistemas. La duración entre «Posted» y «Verified» puede poner de manifiesto problemas de integración o retrasos en la sincronización de los sistemas. Dónde obtenerlo Puede ser un evento explícito procedente de un registro de integración de sistemas o inferirse a partir de un cambio de estado a un valor como «Posted and Verified». Si es manual, correspondería a una actualización de estado realizada por un usuario. Recopilar Se infiere a partir de una actualización de estado a «Verified» o de una marca de confirmación recibida del sistema ERP de destino. Tipo de evento inferred
	Documentación justificativa adjunta	Representa la acción de una persona usuaria que adjunta uno o varios documentos justificativos al asiento contable. Este evento suele capturarse en un registro de auditoría o en una tabla de documentos adjuntos relacionada con el Journal Entry ID.
Por qué es importante Registrar esta actividad es fundamental para supervisar el cumplimiento y la eficiencia. Ayuda a analizar si los retrasos en el proceso de aprobación se deben a la falta de documentación y respalda el KPI «Documentation Attachment Rate». Dónde obtenerlo Normalmente, este es un evento explícito en BlackLine, registrado en un registro de auditoría o en el historial de documentos adjuntos. Los datos incluirían el Journal Entry ID, la persona usuaria que adjuntó el archivo y una marca de tiempo. Recopilar El evento se registra en el registro de auditoría del sistema o en una tabla específica del historial de documentos adjuntos cada vez que se carga un archivo asociado con un asiento contable. Tipo de evento explicit
	Proceso de reversión de asiento contable completado	Esta actividad registra la creación y contabilización de un nuevo asiento contable que revierte uno contabilizado anteriormente. Normalmente se inicia como respuesta a un error detectado después de contabilizar el asiento original.
Por qué es importante Este evento es un indicador sólido de problemas de calidad de datos en etapas anteriores. Hacer seguimiento de la tasa de reversiones ayuda a medir la «tasa de ajustes posteriores a la contabilización» e identificar áreas que necesitan mayor precisión. Dónde obtenerlo A menudo se trata de un evento explícito en el que un usuario inicia la acción «Reverse» en BlackLine sobre un asiento contabilizado. El sistema crea un nuevo asiento de reversión, normalmente vinculado al Journal Entry ID original. Recopilar Se registra cuando se registra una acción «Reverse» o cuando se crea un nuevo asiento con una marca de reversión y un vínculo al ID del asiento original. Tipo de evento explicit

Recomendado Opcional

Guías de extracción

Cómo obtener sus datos de BlackLine

Pasos

Inicie sesión en su instancia de BlackLine con una cuenta de usuario que tenga los permisos necesarios para acceder a los informes financieros.
Vaya al módulo de informes. Normalmente se encuentra en un menú como «Reports» > «Standard Reports».
Busque y seleccione «Journal Entry & Services Report» o un informe completo de Journal Entry con un nombre similar en la lista de informes estándar disponibles.
Configure los parámetros del informe. Especifique el «Date Range» que desea extraer, que debe corresponder al periodo que quiere analizar. Para comenzar, se recomienda un periodo de 3 a 6 meses.
Aplique los filtros necesarios para acotar los datos. Como mínimo, filtre por los «Company Code(s)» relevantes. También puede filtrar por «Journal Status» para incluir todos los estados relevantes, desde la creación hasta la contabilización.
Seleccione todas las columnas disponibles para la salida, de modo que el informe incluya todos los campos necesarios de fecha, usuario y estado para generar el Registro de eventos. Entre los campos clave se incluyen la fecha de creación, la fecha de envío, la fecha de aprobación, la fecha de contabilización y los roles de usuario.
Ejecute el informe directamente en la interfaz de usuario de BlackLine. Cuando termine de generarse, utilice la función «Export» o «Download» para guardar los datos como archivo CSV. Asígnele el nombre «blackline_report.csv».
Configure un entorno de Python con la biblioteca pandas instalada. Si no la tiene, instálela con el comando: pip install pandas.
Coloque el script de Python proporcionado en el mismo directorio que el archivo «blackline_report.csv» descargado.
Ejecute el script de Python. El script leerá el informe CSV sin procesar, transformará los datos creando una fila independiente para cada actividad empresarial y generará un archivo nuevo llamado «event_log.csv» con el formato requerido.
Realice comprobaciones de validación en el archivo «event_log.csv» para garantizar la calidad y la integridad de los datos antes de cargarlo.
Cargue el archivo «event_log.csv» final en ProcessMind para analizarlo.

Configuración

Nombre del informe: Journal Entry & Services Report. El nombre exacto puede variar según la configuración de BlackLine.
Rango de fechas: Se recomienda extraer entre 3 y 6 meses de datos para el análisis inicial. El filtro de fecha del informe suele aplicarse a la fecha de creación o a la fecha de contabilización del asiento. Confirme qué campo de fecha se utiliza para filtrar y garantizar que se extrae el conjunto de datos correcto.
Filtros clave:
- Company Code: Especifique siempre los códigos de empresa que desea analizar para limitar el volumen de datos y centrar el análisis.
- Journal Status: Seleccione todos los estados, por ejemplo, In Preparation, Submitted, Approved, Rejected y Posted, para capturar el proceso completo de principio a fin.
- Journal Type: Si es necesario para el alcance del análisis, filtre por tipos de asiento específicos, por ejemplo, Standard o Recurring.
Requisitos previos: La cuenta de usuario que ejecute el informe debe tener permisos para consultar los datos de Journal Entry y ejecutar informes estándar en BlackLine. Normalmente se requiere un rol como «Accountant» o «Reporting User».
Consideraciones de rendimiento: Exportar un conjunto de datos grande que abarque un periodo extenso o numerosos códigos de empresa puede consumir muchos recursos y tardar bastante en generarse en la interfaz de usuario de BlackLine. Si encuentra problemas de rendimiento o tiempos de espera agotados, considere ejecutar el informe en lotes más pequeños.

a Consulta de ejemplo python

import pandas as pd
import numpy as np
import datetime

class=class="hl-string">"hl-comment"># --- Configuration ---
class=class="hl-string">"hl-comment"># Define the input file name from BlackLine
input_filename = class="hl-string">'blackline_report.csv'
class=class="hl-string">"hl-comment"># Define the output file for ProcessMind
output_filename = class="hl-string">'event_log.csv'

class=class="hl-string">"hl-comment"># --- Column Mapping ---
class=class="hl-string">"hl-comment"># Map the BlackLine report column names to the required event log attribute names.
class=class="hl-string">"hl-comment"># Adjust the keys in this dictionary to match the exact column headers in your CSV export.
column_mapping = {
    class="hl-string">'Journal ID': class="hl-string">'JournalEntryId',
    class="hl-string">'Journal Type': class="hl-string">'JournalEntryType',
    class="hl-string">'Company': class="hl-string">'CompanyCode',
    class="hl-string">'Amount': class="hl-string">'JournalEntryAmount',
    class="hl-string">'Current Status': class="hl-string">'JournalEntryStatus',
    class="hl-string">'Rejection Reason': class="hl-string">'RejectionReason',
    class="hl-string">'Preparer': class="hl-string">'PreparerUserName',
    class="hl-string">'Submitter': class="hl-string">'SubmitterUserName',
    class="hl-string">'Reviewer': class="hl-string">'ReviewerUserName',
    class="hl-string">'Approver': class="hl-string">'ApproverUserName',
    class="hl-string">'Poster': class="hl-string">'PosterUserName',
    class="hl-string">'Verifier': class="hl-string">'VerifierUserName',
    class="hl-string">'Reverser': class="hl-string">'ReverserUserName',
    class="hl-string">'Reconciler': class="hl-string">'ReconcilerUserName',
    class="hl-string">'Creation Date': class="hl-string">'CreationTimestamp',
    class="hl-string">'Attachment Date': class="hl-string">'AttachmentTimestamp',
    class="hl-string">'Submission Date': class="hl-string">'SubmissionTimestamp',
    class="hl-string">'Review Date': class="hl-string">'ReviewTimestamp',
    class="hl-string">'Rejection Date': class="hl-string">'RejectionTimestamp',
    class="hl-string">'Resubmission Date': class="hl-string">'ResubmissionTimestamp',
    class="hl-string">'Approval Date': class="hl-string">'ApprovalTimestamp',
    class="hl-string">'Rescind Date': class="hl-string">'RescindTimestamp',
    class="hl-string">'Posting Date': class="hl-string">'PostingTimestamp',
    class="hl-string">'Verification Date': class="hl-string">'VerificationTimestamp',
    class="hl-string">'Reversal Date': class="hl-string">'ReversalTimestamp',
    class="hl-string">'Reconciliation Date': class="hl-string">'ReconciliationTimestamp'
}

class=class="hl-string">"hl-comment"># --- Data Loading ---
try:
    df_raw = pd.read_csv(input_filename)
except FileNotFoundError:
    print(fclass="hl-string">"Error: The file {input_filename} was not found. Please ensure it's in the same directory as the script.")
    exit()

class=class="hl-string">"hl-comment"># Rename columns based on the mapping
df = df_raw.rename(columns=column_mapping)

class=class="hl-string">"hl-comment"># Ensure all required timestamp columns exist, fill with NaT if not
for col in column_mapping.values():
    if class="hl-string">'Timestamp' in col and col not in df.columns:
        df[col] = pd.NaT

class=class="hl-string">"hl-comment"># Convert date columns to datetime objects, coercing errors to NaT (Not a Time)
date_cols = [col for col in df.columns if class="hl-string">'Timestamp' in col]
for col in date_cols:
    df[col] = pd.to_datetime(df[col], errors=class="hl-string">'coerce')

all_events = []
last_data_update = datetime.datetime.now()

class=class="hl-string">"hl-comment"># --- Activity Extraction ---

class=class="hl-string">"hl-comment"># 1. Journal Entry Created
event_created = df[df[class="hl-string">'CreationTimestamp'].notna()].copy()
event_created[class="hl-string">'ActivityName'] = class="hl-string">'Journal Entry Created'
event_created[class="hl-string">'EventTime'] = event_created[class="hl-string">'CreationTimestamp']
event_created[class="hl-string">'UserName'] = event_created.get(class="hl-string">'PreparerUserName')
all_events.append(event_created)

class=class="hl-string">"hl-comment"># 2. Supporting Documentation Attached
if class="hl-string">'AttachmentTimestamp' in df.columns:
    event_attached = df[df[class="hl-string">'AttachmentTimestamp'].notna()].copy()
    event_attached[class="hl-string">'ActivityName'] = class="hl-string">'Supporting Documentation Attached'
    event_attached[class="hl-string">'EventTime'] = event_attached[class="hl-string">'AttachmentTimestamp']
    class=class="hl-string">"hl-comment"># Assuming the submitter or preparer attached the document
    event_attached[class="hl-string">'UserName'] = event_attached.get(class="hl-string">'SubmitterUserName', event_attached.get(class="hl-string">'PreparerUserName'))
    all_events.append(event_attached)

class=class="hl-string">"hl-comment"># 3. Journal Entry Submitted
event_submitted = df[df[class="hl-string">'SubmissionTimestamp'].notna()].copy()
event_submitted[class="hl-string">'ActivityName'] = class="hl-string">'Journal Entry Submitted'
event_submitted[class="hl-string">'EventTime'] = event_submitted[class="hl-string">'SubmissionTimestamp']
event_submitted[class="hl-string">'UserName'] = event_submitted.get(class="hl-string">'SubmitterUserName')
all_events.append(event_submitted)

class=class="hl-string">"hl-comment"># 4. Journal Entry Reviewed
if class="hl-string">'ReviewTimestamp' in df.columns:
    event_reviewed = df[df[class="hl-string">'ReviewTimestamp'].notna()].copy()
    event_reviewed[class="hl-string">'ActivityName'] = class="hl-string">'Journal Entry Reviewed'
    event_reviewed[class="hl-string">'EventTime'] = event_reviewed[class="hl-string">'ReviewTimestamp']
    event_reviewed[class="hl-string">'UserName'] = event_reviewed.get(class="hl-string">'ReviewerUserName')
    all_events.append(event_reviewed)

class=class="hl-string">"hl-comment"># 5. Journal Entry Rejected
if class="hl-string">'RejectionTimestamp' in df.columns:
    event_rejected = df[df[class="hl-string">'RejectionTimestamp'].notna()].copy()
    event_rejected[class="hl-string">'ActivityName'] = class="hl-string">'Journal Entry Rejected'
    event_rejected[class="hl-string">'EventTime'] = event_rejected[class="hl-string">'RejectionTimestamp']
    event_rejected[class="hl-string">'UserName'] = event_rejected.get(class="hl-string">'ReviewerUserName', event_rejected.get(class="hl-string">'ApproverUserName'))
    all_events.append(event_rejected)

class=class="hl-string">"hl-comment"># 6. Entry Corrected and Resubmitted
if class="hl-string">'ResubmissionTimestamp' in df.columns:
    event_resubmitted = df[df[class="hl-string">'ResubmissionTimestamp'].notna()].copy()
    event_resubmitted = event_resubmitted[event_resubmitted[class="hl-string">'ResubmissionTimestamp'] > event_resubmitted.get(class="hl-string">'RejectionTimestamp', pd.NaT)]
    event_resubmitted[class="hl-string">'ActivityName'] = class="hl-string">'Entry Corrected and Resubmitted'
    event_resubmitted[class="hl-string">'EventTime'] = event_resubmitted[class="hl-string">'ResubmissionTimestamp']
    event_resubmitted[class="hl-string">'UserName'] = event_resubmitted.get(class="hl-string">'SubmitterUserName')
    all_events.append(event_resubmitted)

class=class="hl-string">"hl-comment"># 7. Journal Entry Approved
event_approved = df[df[class="hl-string">'ApprovalTimestamp'].notna()].copy()
event_approved[class="hl-string">'ActivityName'] = class="hl-string">'Journal Entry Approved'
event_approved[class="hl-string">'EventTime'] = event_approved[class="hl-string">'ApprovalTimestamp']
event_approved[class="hl-string">'UserName'] = event_approved.get(class="hl-string">'ApproverUserName')
all_events.append(event_approved)

class=class="hl-string">"hl-comment"># 8. Approval Rescinded
if class="hl-string">'RescindTimestamp' in df.columns:
    event_rescinded = df[df[class="hl-string">'RescindTimestamp'].notna()].copy()
    event_rescinded[class="hl-string">'ActivityName'] = class="hl-string">'Approval Rescinded'
    event_rescinded[class="hl-string">'EventTime'] = event_rescinded[class="hl-string">'RescindTimestamp']
    event_rescinded[class="hl-string">'UserName'] = event_rescinded.get(class="hl-string">'ApproverUserName')
    all_events.append(event_rescinded)

class=class="hl-string">"hl-comment"># 9. Journal Entry Posted
event_posted = df[df[class="hl-string">'PostingTimestamp'].notna()].copy()
event_posted[class="hl-string">'ActivityName'] = class="hl-string">'Journal Entry Posted'
event_posted[class="hl-string">'EventTime'] = event_posted[class="hl-string">'PostingTimestamp']
event_posted[class="hl-string">'UserName'] = event_posted.get(class="hl-string">'PosterUserName')
all_events.append(event_posted)

class=class="hl-string">"hl-comment"># 10. Posting Verified
if class="hl-string">'VerificationTimestamp' in df.columns:
    event_verified = df[df[class="hl-string">'VerificationTimestamp'].notna()].copy()
    event_verified[class="hl-string">'ActivityName'] = class="hl-string">'Posting Verified'
    event_verified[class="hl-string">'EventTime'] = event_verified[class="hl-string">'VerificationTimestamp']
    event_verified[class="hl-string">'UserName'] = event_verified.get(class="hl-string">'VerifierUserName')
    all_events.append(event_verified)

class=class="hl-string">"hl-comment"># 11. Journal Entry Reversal Processed
if class="hl-string">'ReversalTimestamp' in df.columns:
    event_reversal = df[df[class="hl-string">'ReversalTimestamp'].notna()].copy()
    event_reversal[class="hl-string">'ActivityName'] = class="hl-string">'Journal Entry Reversal Processed'
    event_reversal[class="hl-string">'EventTime'] = event_reversal[class="hl-string">'ReversalTimestamp']
    event_reversal[class="hl-string">'UserName'] = event_reversal.get(class="hl-string">'ReverserUserName')
    all_events.append(event_reversal)

class=class="hl-string">"hl-comment"># 12. Journal Entry Reconciled
if class="hl-string">'ReconciliationTimestamp' in df.columns:
    event_reconciled = df[df[class="hl-string">'ReconciliationTimestamp'].notna()].copy()
    event_reconciled[class="hl-string">'ActivityName'] = class="hl-string">'Journal Entry Reconciled'
    event_reconciled[class="hl-string">'EventTime'] = event_reconciled[class="hl-string">'ReconciliationTimestamp']
    event_reconciled[class="hl-string">'UserName'] = event_reconciled.get(class="hl-string">'ReconcilerUserName')
    all_events.append(event_reconciled)


class=class="hl-string">"hl-comment"># --- Final Assembly ---
if all_events:
    event_log = pd.concat(all_events, ignore_index=True)

    class=class="hl-string">"hl-comment"># Add required constant value attributes
    event_log[class="hl-string">'SourceSystem'] = class="hl-string">'BlackLine'
    event_log[class="hl-string">'LastDataUpdate'] = last_data_update

    class=class="hl-string">"hl-comment"># Select and order columns for the final output
    final_columns = [
        class="hl-string">'JournalEntryId',
        class="hl-string">'ActivityName',
        class="hl-string">'EventTime',
        class="hl-string">'SourceSystem',
        class="hl-string">'LastDataUpdate',
        class="hl-string">'UserName',
        class="hl-string">'JournalEntryType',
        class="hl-string">'CompanyCode',
        class="hl-string">'JournalEntryAmount',
        class="hl-string">'JournalEntryStatus',
        class="hl-string">'RejectionReason'
    ]

    class=class="hl-string">"hl-comment"># Filter for only the columns that exist in the dataframe to avoid errors
    existing_columns = [col for col in final_columns if col in event_log.columns]
    event_log = event_log[existing_columns]

    class=class="hl-string">"hl-comment"># Sort the event log
    event_log = event_log.sort_values(by=[class="hl-string">'JournalEntryId', class="hl-string">'EventTime'])

    class=class="hl-string">"hl-comment"># Save to CSV
    event_log.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%d %H:%M:%S')
    print(fclass="hl-string">"Successfully created event log: {output_filename}")
else:
    print(class="hl-string">"No events were generated. Please check your input file and column mappings.")

Pasos

Requisitos previos y configuración: Asegúrese de tener instalado Python 3.6 o una versión posterior. Instale las bibliotecas necesarias con pip: pip install requests pandas. Obtenga las credenciales de la API, Client ID, Client Secret y Refresh Token, además de la URL base de BlackLine de su organización, a través de su administrador de BlackLine.
Configure las variables del script: Abra el script de Python y localice la sección de configuración. Introduzca su Client ID, Client Secret, Refresh Token y la URL base. Defina el periodo de extracción estableciendo las variables START_DATE y END_DATE con el formato «YYYY-MM-DD».
Autenticación: El script comienza llamando a la función get_access_token. Esta función envía sus credenciales al endpoint de autenticación de BlackLine (/api/oauth/token) y obtiene un token de acceso temporal necesario para todas las solicitudes posteriores a la API.
Obtenga la lista inicial de Journal Entries: El script realiza una solicitud paginada al endpoint /api/v2/journals, filtrada por el rango de fechas de creación especificado. Recorre las páginas y recopila los datos principales de todos los asientos que entran en el alcance.
Recupere el historial detallado de eventos: Para cada ID de Journal Entry recopilado en el paso anterior, el script realiza dos llamadas adicionales a la API. Primero, consulta el endpoint del historial del asiento, por ejemplo, /api/v2/journals/{id}/history, para obtener un registro de auditoría detallado de los cambios de estado, las aprobaciones y los rechazos. Después, llama al endpoint de archivos adjuntos, por ejemplo, /api/v2/journals/{id}/attachments, para identificar cuándo se añadieron los documentos justificativos.
Transforme los datos en un Registro de eventos: El script procesa las respuestas JSON de la API. Recorre cada asiento y sus registros asociados de historial y archivos adjuntos. Asigna los datos sin procesar a un formato estructurado de Registro de eventos y crea una fila independiente para cada una de las 12 actividades requeridas, como «Journal Entry Created», «Journal Entry Submitted» y «Journal Entry Approved».
Asigne los cambios de estado a las actividades: Las actividades clave se generan interpretando los datos del endpoint del historial. Por ejemplo, un elemento del historial que indique un cambio de estado a «Submitted» se convierte en la actividad «Journal Entry Submitted». El script contiene la lógica para asignar distintos tipos de eventos del historial a los nombres de actividad estandarizados que requiere ProcessMind.
Construya los DataFrames: El script utiliza la biblioteca pandas para crear DataFrames. Primero crea un DataFrame para el evento «Created» a partir de la lista principal de asientos. Después crea otro DataFrame con el resto de las actividades derivadas de los registros del historial y de archivos adjuntos. A continuación, combina ambos en un Registro de eventos completo.
Añada metadatos y estandarice las columnas: Después de combinar los datos, el script añade las columnas de metadatos requeridas, incluida SourceSystem (codificada como «BlackLine») y LastDataUpdate (establecida con la hora de ejecución del script). También cambia los nombres de las columnas para que coincidan con el esquema requerido, por ejemplo, asignando el campo id de la API a JournalEntryId.
Exporte a CSV: Por último, el script exporta el DataFrame completo del Registro de eventos a un archivo CSV llamado blackline_journal_entry_event_log.csv. El archivo queda preparado para cargarlo directamente en ProcessMind.

Configuración

Credenciales de la API: Debe disponer de un Client ID, un Client Secret y un Refresh Token válidos para la API REST de BlackLine. Guárdelos de forma segura y no los incluya directamente en scripts de producción.
URL base: El script requiere la URL base específica de la API de BlackLine de su organización, por ejemplo, https://api.blackline.com.
Rango de fechas: El script se configura con las variables START_DATE y END_DATE. Para un análisis inicial, se recomienda un rango que cubra la actividad de los últimos 3 a 6 meses, con suficientes datos sin que el volumen sea excesivo.
Límite de paginación: La variable LIMIT controla cuántos registros se obtienen en cada llamada a la API. El valor predeterminado suele ser 100. Modificarlo puede afectar al rendimiento, por lo que es preferible mantener el valor recomendado salvo que el soporte de BlackLine indique lo contrario.
Permisos necesarios: El usuario de la API asociado a las credenciales debe tener permisos suficientes para leer Journal Entries, su historial y los archivos adjuntos de los códigos de empresa que desea analizar.
Entorno de Python: Para ejecutar el script, es necesario disponer de un entorno funcional de Python 3.6 o posterior con las bibliotecas requests y pandas instaladas.

a Consulta de ejemplo python

import requests
import pandas as pd
from datetime import datetime
import time

class=class="hl-string">"hl-comment"># --- Configuration ---
class=class="hl-string">"hl-comment"># Replace with your BlackLine API credentials and base URL
CLIENT_ID = class="hl-string">'[Your Client ID]'
CLIENT_SECRET = class="hl-string">'[Your Client Secret]'
REFRESH_TOKEN = class="hl-string">'[Your Refresh Token]'
BASE_URL = class="hl-string">'[Your BlackLine API Base URL, e.g., https://api.blackline.com]'

class=class="hl-string">"hl-comment"># --- Extraction Parameters ---
START_DATE = class="hl-string">'2023-01-01' class=class="hl-string">"hl-comment"># Format: YYYY-MM-DD
END_DATE = class="hl-string">'2023-12-31'   class=class="hl-string">"hl-comment"># Format: YYYY-MM-DD
LIMIT = 100 class=class="hl-string">"hl-comment"># Records per page

def get_access_token():
    class="hl-string">"""Authenticates with BlackLine to get an access token."""
    auth_url = fclass="hl-string">"{BASE_URL}/api/oauth/token"
    payload = {
        class="hl-string">'grant_type': class="hl-string">'refresh_token',
        class="hl-string">'client_id': CLIENT_ID,
        class="hl-string">'client_secret': CLIENT_SECRET,
        class="hl-string">'refresh_token': REFRESH_TOKEN
    }
    response = requests.post(auth_url, data=payload)
    response.raise_for_status() class=class="hl-string">"hl-comment"># Raise an exception for bad status codes
    return response.json()[class="hl-string">'access_token']

def main():
    class="hl-string">"""Main function to extract, transform, and save journal entry event data."""
    print(class="hl-string">"Starting BlackLine Journal Entry extraction...")
    
    try:
        access_token = get_access_token()
        headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}'}
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Authentication failed: {e}")
        return

    events = []
    last_data_update = datetime.utcnow().isoformat() + class="hl-string">'Z'

    class=class="hl-string">"hl-comment"># 1. Fetch all journals within the date range
    print(fclass="hl-string">"Fetching journals created between {START_DATE} and {END_DATE}...")
    journals = []
    offset = 0
    while True:
        journals_url = fclass="hl-string">"{BASE_URL}/api/v2/journals"
        params = {
            class="hl-string">'createdStartDate': START_DATE,
            class="hl-string">'createdEndDate': END_DATE,
            class="hl-string">'limit': LIMIT,
            class="hl-string">'offset': offset
        }
        try:
            response = requests.get(journals_url, headers=headers, params=params)
            response.raise_for_status()
            data = response.json()
            journals.extend(data.get(class="hl-string">'data', []))
            if class="hl-string">'nextLink' not in data or not data.get(class="hl-string">'data'):
                break
            offset += LIMIT
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching journals: {e}")
            break

    print(fclass="hl-string">"Found {len(journals)} journals. Now fetching detailed events for each...")

    class=class="hl-string">"hl-comment"># 2. For each journal, fetch history and attachments
    for journal in journals:
        journal_id = journal.get(class="hl-string">'id')
        if not journal_id:
            continue

        class=class="hl-string">"hl-comment"># --- Activity: Journal Entry Created ---
        events.append({
            class="hl-string">'JournalEntryId': journal_id,
            class="hl-string">'ActivityName': class="hl-string">'Journal Entry Created',
            class="hl-string">'EventTime': journal.get(class="hl-string">'createdDate'),
            class="hl-string">'UserName': journal.get(class="hl-string">'createdBy', {}).get(class="hl-string">'username'),
            class="hl-string">'JournalEntryType': journal.get(class="hl-string">'type'),
            class="hl-string">'CompanyCode': journal.get(class="hl-string">'companyCode'),
            class="hl-string">'JournalEntryAmount': journal.get(class="hl-string">'totalDebit'),
            class="hl-string">'JournalEntryStatus': journal.get(class="hl-string">'status'),
            class="hl-string">'RejectionReason': None
        })

        class=class="hl-string">"hl-comment"># Fetch history for other activities
        try:
            history_url = fclass="hl-string">"{BASE_URL}/api/v2/journals/{journal_id}/history"
            history_response = requests.get(history_url, headers=headers)
            history_response.raise_for_status()
            history_items = history_response.json().get(class="hl-string">'data', [])
            
            for item in history_items:
                activity_name = None
                rejection_reason = None
                
                class=class="hl-string">"hl-comment"># This mapping requires knowledge of your specific BlackLine history event descriptions
                class=class="hl-string">"hl-comment"># The following are common examples. Adjust them based on your BlackLine configuration.
                event_description = item.get(class="hl-string">'description', class="hl-string">'').lower()
                if class="hl-string">'submitted' in event_description:
                    activity_name = class="hl-string">'Journal Entry Submitted'
                elif class="hl-string">'reviewed' in event_description:
                    activity_name = class="hl-string">'Journal Entry Reviewed'
                elif class="hl-string">'rejected' in event_description:
                    activity_name = class="hl-string">'Journal Entry Rejected'
                    rejection_reason = item.get(class="hl-string">'comment') class=class="hl-string">"hl-comment"># Assuming comment contains the reason
                elif class="hl-string">'resubmitted' in event_description:
                    activity_name = class="hl-string">'Entry Corrected and Resubmitted'
                elif class="hl-string">'approved' in event_description and class="hl-string">'final' in event_description: class=class="hl-string">"hl-comment"># Example for final approval
                    activity_name = class="hl-string">'Journal Entry Approved'
                elif class="hl-string">'approval rescinded' in event_description:
                    activity_name = class="hl-string">'Approval Rescinded'
                elif class="hl-string">'posted' in event_description:
                    activity_name = class="hl-string">'Journal Entry Posted'
                elif class="hl-string">'posting verified' in event_description:
                     activity_name = class="hl-string">'Posting Verified'
                
                if activity_name:
                    events.append({
                        class="hl-string">'JournalEntryId': journal_id,
                        class="hl-string">'ActivityName': activity_name,
                        class="hl-string">'EventTime': item.get(class="hl-string">'eventDate'),
                        class="hl-string">'UserName': item.get(class="hl-string">'user', {}).get(class="hl-string">'username'),
                        class="hl-string">'JournalEntryType': journal.get(class="hl-string">'type'),
                        class="hl-string">'CompanyCode': journal.get(class="hl-string">'companyCode'),
                        class="hl-string">'JournalEntryAmount': journal.get(class="hl-string">'totalDebit'),
                        class="hl-string">'JournalEntryStatus': journal.get(class="hl-string">'status'),
                        class="hl-string">'RejectionReason': rejection_reason
                    })
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Could not fetch history for Journal ID {journal_id}: {e}")

        class=class="hl-string">"hl-comment"># Fetch attachments
        try:
            attachments_url = fclass="hl-string">"{BASE_URL}/api/v2/journals/{journal_id}/attachments"
            attachments_response = requests.get(attachments_url, headers=headers)
            attachments_response.raise_for_status()
            attachments = attachments_response.json().get(class="hl-string">'data', [])
            for attachment in attachments:
                events.append({
                    class="hl-string">'JournalEntryId': journal_id,
                    class="hl-string">'ActivityName': class="hl-string">'Supporting Documentation Attached',
                    class="hl-string">'EventTime': attachment.get(class="hl-string">'uploadedDate'),
                    class="hl-string">'UserName': attachment.get(class="hl-string">'uploadedBy', {}).get(class="hl-string">'username'),
                    class="hl-string">'JournalEntryType': journal.get(class="hl-string">'type'),
                    class="hl-string">'CompanyCode': journal.get(class="hl-string">'companyCode'),
                    class="hl-string">'JournalEntryAmount': journal.get(class="hl-string">'totalDebit'),
                    class="hl-string">'JournalEntryStatus': journal.get(class="hl-string">'status'),
                    class="hl-string">'RejectionReason': None
                })
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Could not fetch attachments for Journal ID {journal_id}: {e}")

        class=class="hl-string">"hl-comment"># --- Activities based on journal fields (may need customization) ---
        if journal.get(class="hl-string">'isReversed'):
            events.append({
                class="hl-string">'JournalEntryId': journal_id,
                class="hl-string">'ActivityName': class="hl-string">'Journal Entry Reversal Processed',
                class="hl-string">'EventTime': journal.get(class="hl-string">'[reversalDate]'), class=class="hl-string">"hl-comment"># Placeholder for reversal date field
                class="hl-string">'UserName': journal.get(class="hl-string">'[reversalUser]'), class=class="hl-string">"hl-comment"># Placeholder for user field
                class="hl-string">'JournalEntryType': journal.get(class="hl-string">'type'),
                class="hl-string">'CompanyCode': journal.get(class="hl-string">'companyCode'),
                class="hl-string">'JournalEntryAmount': journal.get(class="hl-string">'totalDebit'),
                class="hl-string">'JournalEntryStatus': class="hl-string">'Reversed',
                class="hl-string">'RejectionReason': None
            })

        if journal.get(class="hl-string">'reconciliationId'): class=class="hl-string">"hl-comment"># Assuming this indicates reconciliation
            events.append({
                class="hl-string">'JournalEntryId': journal_id,
                class="hl-string">'ActivityName': class="hl-string">'Journal Entry Reconciled',
                class="hl-string">'EventTime': journal.get(class="hl-string">'[reconciliationCertifiedDate]'), class=class="hl-string">"hl-comment"># Placeholder for certified date
                class="hl-string">'UserName': journal.get(class="hl-string">'[reconciliationCertifier]'), class=class="hl-string">"hl-comment"># Placeholder for certifier user
                class="hl-string">'JournalEntryType': journal.get(class="hl-string">'type'),
                class="hl-string">'CompanyCode': journal.get(class="hl-string">'companyCode'),
                class="hl-string">'JournalEntryAmount': journal.get(class="hl-string">'totalDebit'),
                class="hl-string">'JournalEntryStatus': journal.get(class="hl-string">'status'),
                class="hl-string">'RejectionReason': None
            })
        class=class="hl-string">"hl-comment"># Introduce a small delay to respect API rate limits
        time.sleep(0.1)

    if not events:
        print(class="hl-string">"No events were generated. Please check your date range and API access.")
        return

    class=class="hl-string">"hl-comment"># 3. Create DataFrame and save to CSV
    print(class="hl-string">"Transforming data and saving to CSV...")
    df = pd.DataFrame(events)

    class=class="hl-string">"hl-comment"># Add metadata columns
    df[class="hl-string">'SourceSystem'] = class="hl-string">'BlackLine'
    df[class="hl-string">'LastDataUpdate'] = last_data_update
    
    class=class="hl-string">"hl-comment"># Ensure required columns are present
    final_columns = [
        class="hl-string">'JournalEntryId', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate',
        class="hl-string">'UserName', class="hl-string">'JournalEntryType', class="hl-string">'CompanyCode', class="hl-string">'JournalEntryAmount', class="hl-string">'JournalEntryStatus', class="hl-string">'RejectionReason'
    ]
    for col in final_columns:
        if col not in df.columns:
            df[col] = None
            
    df = df[final_columns] class=class="hl-string">"hl-comment"># Order columns

    output_filename = class="hl-string">'blackline_journal_entry_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()

¿Listo para comenzar?

Aproveche este Template para agilizar la preparación de sus datos y obtener información valiosa sobre su proceso de Record to Report - Journal Entry. Comience hoy su camino hacia una mayor eficiencia y cumplimiento.

Volver a la guía de mejora Descargar Template

Optimice hoy la eficiencia de Record to Report Journal Entry

Reduzca un 30 % el tiempo del ciclo de Journal Entry y consiga cierres más rápidos y precisos.

Inicie su prueba gratuita

No necesita tarjeta de crédito • Configuración en minutos

Su Template de datos de Record to Report - Journal Entry

Su Template de datos de Record to Report - Journal Entry

Del registro al informe: atributos del asiento contable

Del registro al informe: actividades del asiento contable

Guías de extracción

Exportación del informe Journal Entry & Services de BlackLine

Pasos

Configuración

a Consulta de ejemplo python

Extracción mediante script de Python a través de la API REST de BlackLine

Pasos

Configuración

a Consulta de ejemplo python

¿Listo para comenzar?

Optimice hoy la eficiencia de Record to Report Journal Entry

Su Template de datos de Record to Report - Journal Entry

Su Template de datos de Record to Report - Journal Entry

Del registro al informe: atributos del asiento contable

Del registro al informe: actividades del asiento contable

Guías de extracción

Exportación del informe Journal Entry & Services de BlackLine

Pasos

Configuración

a Consulta de ejemplo python

Extracción mediante script de Python a través de la API REST de BlackLine

Pasos

Configuración

a Consulta de ejemplo python

¿Listo para comenzar?

Optimice hoy la eficiencia de Record to Report Journal Entry

Valoramos su privacidad