> Mejora Continua de Procesos > Del Pedido al Cobro Facturación > Salesforce Sales Cloud > Plantilla de Datos

Su Plantilla de Datos de Del Pedido al Cobro - Facturación

Salesforce Sales Cloud

Atributos de Del Pedido al Cobro - Facturación (20) Actividades de Del Pedido al Cobro - Facturación (13) Guías de Extracción (3)

Su Plantilla de Datos de Del Pedido al Cobro - Facturación

Esta plantilla proporciona una visión general completa de los atributos de datos y actividades esenciales necesarios para analizar eficazmente su proceso de Del Pedido al Cobro - Facturación. Describe la información específica a recopilar para su registro de eventos, junto con una guía práctica sobre cómo extraer estos datos. Utilice este recurso para agilizar sus iniciativas de Process Mining y obtener información valiosa.

Atributos recomendados para recopilar
Actividades clave para el seguimiento
Guía de Extracción

¿Nuevo en registros de eventos? Aprenda cómo crear un registro de eventos para Process Mining.

Descargar Plantilla

Atributos de Del Pedido al Cobro - Facturación

Estos son los campos de datos recomendados para incluir en su registro de eventos para un análisis integral de Del Pedido al Cobro - Facturación, asegurando que se capture toda la información crítica.

3 Requerido 5 Recomendado 12 Opcional

	Nombre	Descripción
	Hora del Evento EventTime	La marca de tiempo que indica cuándo ocurrió una actividad específica.
Descripción Este atributo proporciona la fecha y hora de cada actividad, lo cual es crucial para el orden cronológico y el análisis de rendimiento. Los timestamps establecen la secuencia de events y permiten el cálculo de las duraciones entre ellos. En el análisis de procesos, el Tiempo de Event se utiliza para calcular todas las métricas basadas en el tiempo, incluyendo tiempos de ciclo, tiempos de espera y duraciones de actividades específicas. Es la base para KPI como el 'Tiempo Promedio del Ciclo de Factura' y el DSO, y alimenta dashboards como 'Tiempo del Ciclo de Aprobación de Facturas' y 'Rendimiento de la Conciliación de Pagos'. Por qué es importante Este timestamp es crítico para secuenciar correctamente los events y calcular todas las métricas de rendimiento, como los tiempos de ciclo y las duraciones, que son clave para identificar retrasos. Dónde obtener Estos datos a menudo provienen de campos de `timestamp` generados por el sistema como `CreatedDate` o `LastModifiedDate` en el objeto Factura o registros de Tarea/Event relacionados. Ejemplos 2023-04-15T10:00:00Z2023-04-16T14:30:00Z2023-05-20T09:05:12Z
	Nombre de la Actividad ActivityName	El nombre del event de negocio específico que ocurrió en el proceso de facturación.
Descripción Este atributo describe el paso o hito que se ha alcanzado dentro del ciclo de vida de la factura, como 'Factura Generada' o 'Pago Recibido'. Estas actividades forman los nodos en el mapa de procesos. El análisis de la secuencia del Nombre de la Actividad es fundamental para Process Mining. Revela el flujo de proceso real, permitiendo la comparación con el proceso diseñado. Se utiliza para identificar desviaciones, cuellos de botella entre pasos específicos y bucles de retrabajo, respaldando directamente dashboards como 'Retrabajo y Errores del Proceso de Facturación' y 'Informe de Violación de Cumplimiento de Facturación'. Por qué es importante Define los pasos del proceso, formando la columna vertebral del mapa de procesos y permitiendo el análisis del flujo de trabajo, cuellos de botella y desviaciones. Dónde obtener Esto se deriva típicamente de cambios en el campo Status en el objeto Factura o de registros en objetos relacionados como Tarea o Event, que rastrean acciones específicas. Ejemplos Factura GeneradaFactura AprobadaFactura Enviada al ClientePago Recibido
	Número de Factura InvoiceNumber	El identificador único para cada factura, que sirve como identificador principal del case para el proceso de facturación.
Descripción El Número de Factura es el atributo central que agrupa todas las actividades de facturación relacionadas en un solo case. Cada número representa un documento de facturación distinto enviado a un cliente. En el análisis de Process Mining, este atributo permite el seguimiento de extremo a extremo del ciclo de vida de una factura, desde su generación hasta el pago final y el cierre. Es esencial para construir el mapa de procesos y calcular KPI a nivel de case como el 'Tiempo Promedio del Ciclo de Factura' y los 'Días de Venta Pendientes (DSO)'. Analizar los procesos por Número de Factura ayuda a identificar cuellos de botella, bucles de retrabajo y desviaciones de cumplimiento para instancias de facturación individuales. Por qué es importante Esta es la clave esencial para vincular todos los events de facturación relacionados, permitiendo una vista completa de extremo a extremo del proceso de facturación para cada transacción única. Dónde obtener Esta es típicamente la clave primaria del objeto Factura en Salesforce Sales Cloud, a menudo representada por InvoiceNumber o un campo de ID único similar. Ejemplos INV-00582INV-01934INV-10345
	Departamento de Facturación BillingDepartment	El departamento o equipo responsable de la actividad de facturación.
Descripción Este atributo especifica el grupo funcional, como 'Cuentas por Cobrar' u 'Operaciones de Ventas', al que pertenece el usuario responsable. Esto se deriva típicamente del perfil o rol del usuario en Salesforce. Analizar el rendimiento por departamento es crucial para comprender la propiedad del proceso e identificar problemas sistémicos dentro de equipos específicos. Se utiliza en los dashboards de 'Rendimiento de la Conciliación de Pagos' y 'Carga de Trabajo y Rendimiento del Equipo de Facturación' para comparar la eficiencia y la utilización de recursos en diferentes áreas funcionales. Por qué es importante Esto permite el análisis de rendimiento a nivel de equipo o departamento, ayudando a identificar cuellos de botella específicos del grupo, limitaciones de recursos o brechas de capacitación. Dónde obtener Esta información se almacena usualmente en el objeto Usuario en Salesforce, en campos como `Department` o `Role.Name`. Ejemplos Cuentas por CobrarOperaciones financierasEquipo de Cobranzas
	Estado de la Factura InvoiceStatus	El estado actual de la factura en su ciclo de vida.
Descripción Este atributo refleja el estado actual de la factura, por ejemplo, 'Draft', 'Awaiting Approval', 'Sent', 'Paid' o 'Void'. Proporciona una instantánea de dónde se encuentra la factura en el proceso en un momento dado. Invoice Status es una dimensión crítica para el filtrado y la segmentación. Permite a los analistas centrarse en cohortes específicas de facturas, como todas las facturas que actualmente esperan pago o todas las facturas que fueron rechazadas. Esto ayuda a priorizar el trabajo y a analizar las características de las facturas que se estancan en ciertas etapas. Por qué es importante Proporciona una instantánea clara del estado actual de una factura, permitiendo filtrar y analizar casos abiertos, cerrados o problemáticos. Dónde obtener Este es típicamente un campo de lista de selección estándar llamado Status en el objeto Factura en Salesforce. Ejemplos En Espera de AprobaciónAprobadoEnviado al ClientePagadoCancelado
	Fecha de Vencimiento de Pago PaymentDueDate	La fecha límite en la que el cliente debe pagar la factura.
Descripción Este atributo especifica la fecha límite de pago, según lo indicado en la factura. Se calcula en base a la fecha de la factura y las condiciones de pago acordadas. La Fecha de Vencimiento de Pago es un punto de datos crítico para la planificación financiera y la gestión de cobros. Es la base contra la cual se mide el rendimiento real de los pagos. Es esencial para calcular el KPI de 'Tasa de Pago a Tiempo' y para los dashboards que rastrean la puntualidad de los pagos, como la 'Tendencia de Días de Venta Pendientes (DSO)'. Por qué es importante Este es el punto de referencia para medir el rendimiento de los pagos, calcular el DSO y activar actividades de cobro como los recordatorios de pago. Dónde obtener Este es un campo de fecha estándar en el objeto Factura de Salesforce, a menudo llamado DueDate. Ejemplos 2023-05-152023-06-302023-07-01
	Monto Total de la Factura InvoiceTotalAmount	El valor monetario total de la factura.
Descripción Este atributo representa el importe total adeudado por el cliente por los bienes o servicios prestados. Es una métrica financiera clave asociada a cada case de factura. Analizar el Importe Total de la Factura ayuda a priorizar las facturas de alto valor y a comprender cómo el rendimiento del proceso difiere para transacciones pequeñas versus grandes. Puede usarse para segmentar el análisis en dashboards, por ejemplo, para ver si las facturas de mayor valor tienen tiempos de aprobación más largos o se pagan más tarde. Esto es importante para gestionar el riesgo financiero y centrar los esfuerzos de cobro de manera efectiva. Por qué es importante Esto permite el análisis del impacto financiero, ayudando a priorizar facturas de alto valor y a comprender cómo el valor monetario afecta el comportamiento del proceso, como los tiempos de aprobación o los retrasos en los pagos. Dónde obtener Este sería probablemente un campo de moneda estándar en el objeto Factura, posiblemente llamado GrandTotal o un campo de resumen similar. Ejemplos 5400.5012500.00850.75
	Usuario Responsable UserResponsible	El usuario o agente que realizó la actividad.
Descripción Este atributo identifica al usuario específico de Salesforce responsable de una actividad determinada, como aprobar una factura o registrar un pago. A menudo se vincula al usuario que modificó por última vez el registro o es propietario de la tarea. Analizar el proceso por Usuario Responsable es clave para comprender el rendimiento del equipo, la distribución de la carga de trabajo e identificar las necesidades de capacitación. Apoya directamente el dashboard 'Carga de Trabajo y Rendimiento del Equipo de Facturación' al permitir comparaciones de rendimiento y análisis de asignación de recursos. También ayuda en el análisis de causa raíz al investigar retrasos o errores. Por qué es importante Permite el análisis del rendimiento individual y del equipo, el equilibrio de la carga de trabajo y ayuda a identificar a los de mejor desempeño o a los usuarios que necesitan formación adicional. Dónde obtener Esto se puede encontrar en campos como `LastModifiedById` en el objeto Factura o `OwnerId` en objetos de Tarea o personalizados relacionados. Estos ID necesitarían unirse con el objeto Usuario para obtener el nombre del usuario. Ejemplos Alice JohnsonBob WilliamsCharlie Brown
	¿Es Retrabajo? IsRework	Un indicador calculado que muestra si una factura ha pasado por un ciclo de reelaboración.
Descripción Este atributo booleano se deriva durante el procesamiento de datos. Se establece en verdadero si la secuencia de actividades de una factura muestra evidencia de retrabajo, como volver a una etapa anterior después de pasarla (por ejemplo, 'Factura Corregida' después de 'Factura Aprobada'). Este indicador es crítico para identificar y cuantificar rápidamente las ineficiencias del proceso. Impulsa directamente el KPI de 'Tasa de Retrabajo de Facturas' y el dashboard 'Retrabajo y Errores del Proceso de Facturación', permitiendo a los analistas aislar y examinar cases con bucles de retrabajo costosos y que consumen mucho tiempo. Por qué es importante Este indicador cuantifica directamente la ineficiencia del proceso al identificar cases con bucles de corrección, ayudando a identificar las fuentes de errores y a calcular el costo de la mala calidad. Dónde obtener Este atributo no está en el sistema de origen. Se calcula mediante la herramienta de Process Mining o en la capa ETL basándose en la secuencia de actividades para cada case. Ejemplos truefalse
	Condiciones de Pago PaymentTerms	Las condiciones acordadas para el pago de facturas, como 'Net 30' o 'Due on Receipt'.
Descripción Este atributo define las reglas que rigen cuándo y cómo debe pagarse una factura. A menudo, dicta el cálculo de la Fecha de Vencimiento de Pago y puede incluir disposiciones para descuentos por pronto pago. Analizar por Condiciones de Pago ayuda a comprender cómo los diferentes acuerdos afectan el comportamiento de pago. Es crucial para el dashboard de 'Utilización de Descuentos por Pronto Pago', que compara las fechas de pago con los términos para identificar oportunidades financieras perdidas. También proporciona contexto sobre por qué algunas facturas tienen ciclos de pago más largos o más cortos. Por qué es importante Proporciona contexto para las fechas límite de pago y es esencial para analizar el comportamiento de pago, el DSO y la efectividad de los programas de descuento por pronto pago. Dónde obtener Esta información probablemente se almacena en una lista de selección o campo de texto en el objeto Factura o en el objeto Cuenta asociado en Salesforce. Ejemplos Neto 30Neto 602% 10, Net 30Vencimiento al Recibo
	Días de Cobro Pendiente DaysSalesOutstanding	El número de días desde que se envió la factura hasta que se recibió el pago.
Descripción Los Días de Venta Pendientes (DSO) son una métrica financiera crítica que mide el número promedio de días que tarda una empresa en cobrar un pago después de realizar una venta. Se calcula como el tiempo entre el evento 'Factura Enviada al Cliente' y el evento 'Pago de Cliente Recibido'. Este KPI es un foco principal del proceso de Pedido a Cobro, y este atributo lo hace disponible para cada factura individual. Soporta directamente el dashboard de 'Tendencia de Días de Venta Pendientes (DSO)' y es esencial para monitorear y mejorar el flujo de efectivo. Por qué es importante Este es un KPI crucial para medir la efectividad del proceso de cobros y su impacto directo en el flujo de caja de la empresa. Dónde obtener Este es un atributo calculado. El cálculo es `(Timestamp('Customer Payment Received') - Timestamp('Invoice Sent to Customer'))`. Ejemplos 32 días58 días29 días
	Es Pago Atrasado IsLatePayment	Un indicador calculado que señala si el pago se recibió después de la fecha de vencimiento.
Descripción Este atributo booleano se deriva comparando el timestamp de 'Customer Payment Received' con la 'Payment Due Date'. Es verdadero si el pago fue tardío y falso en caso contrario. Este indicador simplifica el análisis del comportamiento de pago y la efectividad de los cobros. Es la base para el KPI de 'Tasa de Pago a Tiempo' y ayuda a segmentar a los clientes en pagadores a tiempo y tardíos para un análisis posterior. Proporciona un resultado binario claro para el rendimiento de pago en cada factura. Por qué es importante Esto proporciona una métrica clara de éxito para los cobros, apoyando directamente el KPI de 'Tasa de Pago a Tiempo' y permitiendo el análisis de los factores que contribuyen a los pagos tardíos. Dónde obtener Este atributo no está en el sistema de origen. Se calcula en la capa ETL o en la herramienta de Process Mining comparando la fecha de pago con el campo `PaymentDueDate`. Ejemplos truefalse
	Hora Fin del Evento EventEndTime	El timestamp que indica cuándo se completó una actividad.
Descripción Este atributo registra la hora de finalización de una actividad. Si bien muchas actividades en la facturación son events instantáneos donde la Hora de Inicio es igual a la Hora de Fin, algunas, como un paso de aprobación, pueden tener una duración medible. Tener una Hora de Fin permite el cálculo preciso del tiempo de procesamiento de la actividad, que es la duración durante la cual un agente o sistema trabaja activamente en una tarea. Ayuda a diferenciar entre el tiempo de trabajo activo y el tiempo de espera, proporcionando una visión más detallada de la eficiencia del proceso. Por qué es importante Permite el cálculo de tiempos precisos de procesamiento de actividades, distinguiendo el trabajo activo del tiempo de espera inactivo para un análisis de eficiencia más preciso. Dónde obtener Este a menudo no es un campo estándar. Puede que deba derivarse tomando la StartTime de la actividad subsiguiente en el case, o capturarse en un campo personalizado. Ejemplos 2023-04-15T10:05:00Z2023-04-16T14:32:10Z2023-05-20T09:05:12Z
	Moneda de la Factura InvoiceCurrency	El código de moneda para el importe de la factura, como USD o EUR.
Descripción Este atributo indica la moneda en la que se denomina la factura. Es particularmente importante para organizaciones que operan en múltiples países. Este campo proporciona un contexto esencial para cualquier análisis financiero. Permite la agregación correcta de valores monetarios y la comparación de métricas de proceso en diferentes zonas monetarias. Es un filtro necesario al analizar los KPI financieros para evitar mezclar diferentes monedas. Por qué es importante Proporciona el contexto necesario para todos los valores monetarios, asegurando un análisis e informes financieros precisos, especialmente en operaciones multinacionales. Dónde obtener Este es típicamente el campo estándar `CurrencyIsoCode`, disponible en instancias de Salesforce con multi-moneda habilitada. Ejemplos USDEURGBPJPY
	Nombre del Cliente CustomerName	El nombre del cliente o cuenta a la que se factura.
Descripción Este atributo identifica al cliente o empresa a quien se emite la factura. Típicamente, se vincula desde el registro de Cuenta asociado en Salesforce. Analizar el proceso por cliente es esencial para comprender los comportamientos específicos del cliente e identificar problemas que pueden estar afectando a cuentas clave. Puede revelar si ciertos clientes pagan constantemente tarde, requieren más retrabajo o tienen ciclos de aprobación complejos. Esta información ayuda en la gestión de las relaciones con los clientes y en la adaptación de las estrategias de cobro. Por qué es importante Permite un análisis centrado en el cliente para identificar patrones, como qué clientes pagan con frecuencia tarde o requieren más correcciones de factura, mejorando la gestión de relaciones con el cliente. Dónde obtener Esto se obtiene del campo `Account.Name`, vinculado a través de una relación de búsqueda desde el objeto Factura al objeto Cuenta. Ejemplos ABC Corporation`Global Tech Inc.`Innovate Solutions LLC
	País de Facturación BillingCountry	El país especificado en la dirección de facturación de la factura.
Descripción Este atributo captura el país de la dirección de facturación del cliente. Es una dimensión geográfica clave para segmentar los datos del proceso. Analizar el proceso de facturación por país es esencial para identificar variaciones regionales en el rendimiento, el cumplimiento y el comportamiento del cliente. Puede revelar si ciertos países tienen ciclos de pago más largos, diferentes tasas de retrabajo o requisitos regulatorios específicos que impactan el proceso. Esto apoya la armonización global de procesos y los esfuerzos de optimización localizados. Por qué es importante Permite un análisis geográfico para identificar variaciones regionales en el rendimiento, los requisitos de cumplimiento y los comportamientos de pago. Dónde obtener Esto forma parte del campo compuesto de dirección estándar en el objeto Factura, típicamente BillingCountry. Ejemplos EE. UU.AlemaniaJapónBrazil
	Propietario de la Cuenta AccountOwner	El representante de ventas o gerente de cuenta responsable de la cuenta del cliente.
Descripción Este atributo identifica al propietario interno de la relación con el cliente. Típicamente es el vendedor o gerente de cuenta asignado a la Cuenta en Salesforce. Aunque no está directamente involucrado en la facturación, el Propietario de la Cuenta puede ser una dimensión relevante para el análisis. Los problemas en el proceso de facturación pueden afectar la relación con el cliente, y este atributo ayuda a conectar los datos de rendimiento del proceso con el lado comercial del negocio. Puede usarse para ver si las cuentas gestionadas por ciertos propietarios experimentan más problemas de facturación. Por qué es importante Vincula el rendimiento del proceso de facturación con el responsable de la relación comercial, lo que ayuda a entender el impacto en el negocio de los errores o retrasos en la facturación. Dónde obtener Este es el campo `Owner.Name` del objeto Cuenta, que está relacionado con la Factura. Ejemplos David MillerSophia GarciaJames Wilson
	Source System SourceSystem	Identifica el sistema de donde se originaron los `datos`.
Descripción Este atributo especifica la aplicación fuente donde se generaron los datos del event. Para este proceso, típicamente será 'Salesforce Sales Cloud'. En entornos con múltiples sistemas integrados, este campo es crucial para el linaje de datos y la resolución de problemas. Ayuda a comprender el contexto de los datos y a asegurar que los events de diferentes sistemas se fusionen e interpreten correctamente dentro de la herramienta de Process Mining. Por qué es importante Proporciona un contexto crucial sobre el origen de los datos, lo cual es esencial para la gobernanza de datos, la validación y el análisis en entornos multi-sistema. Dónde obtener Este es típicamente un valor estático añadido durante el proceso de extracción, transformación y carga de datos (ETL) para etiquetar el origen del conjunto de datos. Ejemplos Salesforce Sales CloudSFSC
	Tiempo de Ciclo de la Factura InvoiceCycleTime	El tiempo total transcurrido desde la generación de la factura hasta su cierre.
Descripción Esta métrica calculada mide la duración completa del proceso de facturación para una sola factura. Se calcula típicamente como la diferencia de tiempo entre el event 'Factura Generada' y el event 'Factura Cerrada' o 'Pago Conciliado'. Este es un KPI primario para medir la eficiencia general del proceso de facturación. Se utiliza en el KPI de 'Tiempo Promedio del Ciclo de Factura' y en el dashboard 'Visión General del Ciclo de Facturación de Extremo a Extremo' para monitorear y comparar el rendimiento del proceso a lo largo del tiempo. Reducir este tiempo de ciclo puede llevar a una conversión de efectivo más rápida. Por qué es importante Este es un indicador clave de rendimiento que mide la eficiencia de extremo a extremo del proceso de facturación, impactando directamente el ciclo de conversión de efectivo. Dónde obtener Esta métrica no está en el sistema de origen. Se calcula mediante la herramienta de Process Mining restando el timestamp del primer event del timestamp del último event para cada case. Ejemplos 25 días 4 horas45 días y 12 horas60 días y 2 horas
	Última actualización de datos LastDataUpdate	`Timestamp` de la `última actualización de datos` del `sistema de origen`.
Descripción Este atributo indica cuándo se extrajeron por última vez los datos para el análisis de Process Mining de Salesforce Sales Cloud. Es un campo de metadatos aplicado a todo el conjunto de datos durante cada actualización. Este timestamp es vital para que los usuarios comprendan la actualidad del análisis. Les ayuda a saber si los dashboards y KPI que están viendo están actualizados, lo cual es crítico para tomar decisiones comerciales oportunas e informadas basadas en la información del proceso. Por qué es importante Informa a los usuarios sobre la puntualidad de los datos, asegurando que las decisiones se basen en una vista actual y relevante del proceso. Dónde obtener Este valor es generado y sellado en el conjunto de datos por la herramienta ETL o el pipeline de datos durante cada ejecución. Ejemplos 2023-10-27T02:00:00Z2023-10-28T02:00:00Z

Requerido Recomendado Opcional

Actividades de Del Pedido al Cobro - Facturación

Estos son los pasos y hitos clave del proceso a capturar en su registro de eventos para un descubrimiento de procesos y una evaluación de rendimiento precisos.

5 Recomendado 8 Opcional

	Actividad	Descripción
	Factura Aprobada	Un usuario autorizado ha revisado y aprobado la factura, confirmando su exactitud y su disposición para ser enviada al cliente. Este evento generalmente se captura cuando el estado de la factura cambia a 'Aprobada'.
Por qué es importante Este es un hito clave que delimita el resto del proceso de facturación. Los retrasos aquí crean importantes cuellos de botella, impactando el DSO y los tiempos de ciclo generales, lo cual se mide mediante el dashboard 'Tiempo del Ciclo de Aprobación de Facturas'. Dónde obtener Inferido de un cambio en el campo de estado del objeto Factura a 'Aprobada'. Si se utilizan Procesos de Aprobación de Salesforce, esto puede capturarse explícitamente del historial del objeto ProcessInstance. Capturar Cambio en el campo de estado de la factura a 'Aprobada' o finalización de un paso formal del proceso de aprobación. Tipo de evento inferred
	Factura Cerrada	El ciclo de vida de la factura está completo, ya que ha sido pagada y conciliada en su totalidad. Esta es la actividad final para una factura procesada con éxito y se registra típicamente mediante una actualización de estado.
Por qué es importante Esta actividad sirve como el punto final principal del proceso, permitiendo un cálculo preciso del tiempo de ciclo de extremo a extremo. Proporciona una definición clara de finalización para el análisis de procesos. Dónde obtener Inferido de la marca de tiempo cuando el campo de estado del objeto Factura se actualiza a 'Cerrada', 'Pagada en su Totalidad' o un estado terminal similar. Capturar Cambio en el campo de estado de la factura a un valor final 'Cerrada'. Tipo de evento inferred
	Factura Enviada al Cliente	La factura aprobada ha sido entregada oficialmente al cliente por correo electrónico, correo postal o un portal. Este event a menudo se captura mediante la cumplimentación de un campo 'Sent Date' o un cambio de estado a 'Sent'.
Por qué es importante Esto marca el inicio del período de cobro de pagos y es el punto de partida para calcular los Días de Venta Pendientes (DSO). Es un hito crítico para el seguimiento de la comunicación con el cliente y los plazos de pago. Dónde obtener Inferido de la población de un campo 'Fecha de Envío' en el objeto Factura o de una actualización de estado a 'Enviada'. También podría ser un evento explícito registrado en el Historial de Actividades si se envió a través de una herramienta de correo electrónico integrada. Capturar Timestamp cuando se completa un campo 'Sent_Date__c'. Tipo de evento inferred
	Factura Generada	Esta actividad marca la creación de un nuevo registro de factura dentro de Salesforce. Es el inicio oficial del proceso de facturación para una transacción específica y se activa típicamente después de que se cumple un pedido o se alcanza un hito contractual. El event se captura desde el timestamp de creación del registro de factura.
Por qué es importante Este es el event de inicio principal para el proceso de facturación. Analizar el tiempo desde este punto hasta el pago ayuda a medir el tiempo de ciclo general Del Pedido al Cobro e identificar retrasos iniciales en la entrada de datos. Dónde obtener Este event se captura desde la fecha de creación (campo CreatedDate) del objeto personalizado de Factura o un objeto similar que represente la factura en Salesforce. Capturar Timestamp de creación del registro del objeto de factura. Tipo de evento explicit
	Pago de cliente recibido	El cliente ha realizado un pago contra la factura y los fondos han sido recibidos. Esto se registra típicamente creando un registro de 'Payment' relacionado y vinculándolo a la factura.
Por qué es importante Este es el hito más importante en la parte del proceso de cobro de efectivo. Es el punto final para el cálculo del DSO y significa la recepción exitosa de ingresos. Dónde obtener Capturado de la fecha de creación de un registro de objeto personalizado 'Pago' relacionado con el objeto Factura. También podría inferirse de un cambio de estado de la factura a 'Pagada'. Capturar Creación de un registro de Pago relacionado. Tipo de evento explicit
	Efectivo Aplicado/Conciliado	El pago recibido ha sido totalmente conciliado y aplicado contra la factura específica en el sistema, cerrando la cuenta por cobrar. Esto se captura mediante un cambio de estado final en el registro de pago o factura.
Por qué es importante Esto marca el paso final en el ciclo de conversión de efectivo. El dashboard de 'Rendimiento de la Conciliación de Pagos' se basa en esta actividad para medir la eficiencia del equipo financiero en la aplicación de efectivo. Dónde obtener Inferido de un cambio de estado en la Factura o un objeto de Pago relacionado a un estado final como 'Conciliado' o 'Aplicado'. Capturar Cambio en el estado de la factura o pago a 'Conciliado'. Tipo de evento inferred
	Factura Cancelada por Incobrable	Se ha tomado la decisión de cancelar la deuda, y la factura se cierra sin el pago completo. Esto representa un final alternativo y fallido del proceso de facturación.
Por qué es importante El seguimiento de las bajas contables ayuda a cuantificar la pérdida de ingresos e identificar clientes o situaciones que conducen a deudas incobrables. Es una ruta de excepción crítica para monitorear la salud financiera. Dónde obtener Inferido de la marca de tiempo cuando el campo de estado del objeto Factura se actualiza a 'Cancelada por Incobrable' o 'Cancelada - Deuda Incobrable'. Capturar Cambio en el campo de estado de la factura a 'Cancelada por Incobrable'. Tipo de evento inferred
	Factura Corregida	Representa una corrección o actualización manual de una factura después de que fue rechazada o se encontró un error. Esto a menudo se infiere cuando el estado de una factura revierte a un estado anterior, como de 'Rechazada' a 'Borrador'.
Por qué es importante Identificar los ciclos de corrección es crucial para medir el KPI 'Tasa de Reelaboración de Facturas'. Grandes volúmenes de correcciones indican problemas en el proceso inicial de generación de facturas que conducen a retrasos. Dónde obtener Inferido del seguimiento del historial de campo al detectar un cambio de estado de un valor de etapa posterior (por ejemplo, 'Rechazada', 'Aprobada') a un valor de etapa anterior (por ejemplo, 'Borrador', 'En Progreso'). Capturar El estado de la factura retrocede en el flujo del proceso. Tipo de evento inferred
	Factura enviada para aprobación	La factura ha sido finalizada y enviada para revisión interna antes de ser enviada al cliente. Esta actividad se captura típicamente mediante un cambio en el campo de estado del registro de la factura, por ejemplo, de 'Draft' a 'Pending Approval'.
Por qué es importante El seguimiento de esta actividad ayuda a aislar el tiempo transcurrido en la cola de aprobación. Es un primer paso crítico para calcular el KPI 'Tiempo Promedio de Aprobación de Facturas'. Dónde obtener Inferido del seguimiento del historial de campo en el objeto Factura cuando un campo de estado se actualiza a un valor como 'Enviada para Aprobación' o 'En Revisión'. Capturar Cambio en el campo de estado de la factura a 'Pendiente de Aprobación'. Tipo de evento inferred
	Factura Rechazada	Un aprobador ha rechazado la factura, generalmente debido a errores o discrepancias, lo que requiere que se corrija y se vuelva a enviar. Esto se captura mediante un cambio de estado en el registro de la factura a 'Rechazada'.
Por qué es importante Esta actividad significa retrabajo e ineficiencia del proceso. Analizar la frecuencia de los rechazos ayuda a identificar fuentes comunes de error y respalda el análisis de causa raíz para el dashboard 'Retrabajo y Errores del Proceso de Facturación'. Dónde obtener Inferido de un cambio en el campo de estado del objeto Factura a 'Rechazada'. Estos datos también pueden encontrarse en los comentarios dentro de un historial de Proceso de Aprobación formal. Capturar Cambio en el campo de estado de la factura a 'Rechazada'. Tipo de evento inferred
	Fecha de Vencimiento de Pago Alcanzada	Este es un event calculado que representa el momento en que el pago de la factura vence según sus condiciones de pago. No es una acción del usuario, sino que se deriva de los datos de la factura.
Por qué es importante Esta actividad proporciona un punto de referencia crítico para analizar el comportamiento de pago y medir el KPI de 'Tasa de Pago a Tiempo'. Ayuda a diferenciar entre pagos a tiempo y pagos tardíos. Dónde obtener Este es un event calculado. Se deriva comparando el timestamp actual con el campo 'Due Date' en el objeto Factura. No existe como un event almacenado en Salesforce. Capturar Calculado comparando la fecha actual con el campo Fecha de Vencimiento de la factura. Tipo de evento calculated
	Pago Registrado en el Libro Mayor	El pago recibido ha sido registrado formalmente en el sistema de contabilidad financiera o libro mayor de la empresa. Esto puede capturarse mediante una actualización de estado en el registro de pago o factura después de que se ejecute una integración.
Por qué es importante Esta actividad separa la recepción del pago de la conciliación financiera. El tiempo entre la recepción y el registro del pago puede resaltar retrasos en los procesos contables internos. Dónde obtener Inferido de un cambio en el campo de estado del objeto Pago o Factura a un valor como 'Contabilizado' o 'Exportado a ERP', a menudo actualizado mediante una integración de API. Capturar Cambio en el estado de pago o factura a 'Contabilizado'. Tipo de evento inferred
	Recordatorio de Pago Emitido	Se ha enviado una comunicación al cliente para recordarle un pago próximo o vencido. Esto a menudo se registra como un registro de Actividad (Tarea o Correo Electrónico) específico vinculado a la factura.
Por qué es importante El seguimiento de los recordatorios ayuda a evaluar la efectividad de las estrategias de cobro. Es esencial para el dashboard 'Efectividad del Recordatorio de Pago' y el KPI 'Tasa de Activación de Recordatorios de Pago'. Dónde obtener Capturado de la creación de un registro de Actividad (Tarea o Correo Electrónico) relacionado con el objeto Factura, donde el asunto o tipo indica que es un recordatorio de pago. Capturar Creación de un registro de Tarea o Correo electrónico relacionado con un tipo/asunto específico. Tipo de evento explicit

Recomendado Opcional

Guías de Extracción

Cómo obtener sus `datos` de `Salesforce Sales Cloud`

Pasos

Verificación de requisitos previos: Asegúrese de tener los permisos necesarios en Salesforce, incluyendo "Ejecutar informes", "Crear y personalizar informes" y "Exportar informes". Verifique que el Seguimiento del historial de campo esté habilitado para los campos de estado clave en sus objetos Factura y Pago. Para ello, navegue a Configuración > Gestor de objetos, encuentre el objeto relevante, vaya a Campos y Relaciones, y haga clic en "Configurar seguimiento de historial".
Definir estrategia de informes: Este proceso requiere la creación de múltiples informes porque las actividades se originan a partir de diferentes registros o eventos (por ejemplo, creación de facturas, cambios de estado, pagos relacionados). Creará un informe separado para cada fuente distinta y luego combinará los resultados externamente.
Crear informe para creaciones de registros: Comience con los eventos más sencillos. Cree un informe para 'Factura Generada' y 'Pago de Cliente Recibido'. Navegue a la pestaña Informes y haga clic en "Nuevo informe". Elija un tipo de informe que incluya su objeto Factura (por ejemplo, "Facturas") o el objeto Pago. Agregue columnas correspondientes a los atributos del registro de eventos. Para la actividad 'Factura Generada', la CreatedDate del registro de la factura será el EventTime.
Crear informe para historial de campo: Para capturar cambios de estado como 'Factura Enviada para Aprobación', 'Factura Aprobada', 'Factura Rechazada' y 'Factura Corregida', cree un informe basado en el tipo de informe "Historial de Facturas". Este tipo de informe especial expone los cambios rastreados por el Seguimiento del historial de campo. Filtrará este informe para los cambios en el campo Status.
Crear informe para eventos basados en fechas: Para eventos como 'Factura Enviada al Cliente' o 'Fecha de Vencimiento de Pago Alcanzada', cree un informe sobre el objeto Factura. Utilice los campos de fecha en sí mismos, como Sent_Date__c o Payment_Due_Date__c, como el EventTime. Debe filtrar los registros donde estas fechas no sean nulas.
Crear informe para actividades relacionadas: Para eventos como 'Recordatorio de Pago Emitido', necesita un informe que vincule Actividades (Tareas o Eventos) a Facturas. Utilice un tipo de informe como "Actividades con facturas" o uno personalizado que cree. Filtre las actividades con un asunto o tipo específico que indique un recordatorio.
Agregar columnas estándar a todos los informes: En cada informe que construya, asegúrese de agregar columnas que puedan mapearse a la estructura de registro de eventos requerida: InvoiceNumber, un campo para el EventTime (como CreatedDate o la fecha del cambio de campo), UserResponsible (como LastModifiedById), y otros atributos recomendados.
Exportar informes a CSV: Ejecute cada informe individualmente. Desde la pantalla de resultados del informe, use el menú desplegable para seleccionar "Exportar" y elija el formato "Solo detalles" con una extensión .csv. Repita esto para todos los informes que creó.
Combinar y transformar datos: Abra los archivos CSV exportados en un programa de hoja de cálculo o utilice una herramienta de preparación de datos. Para cada archivo, agregue una nueva columna llamada ActivityName y rellénela con la actividad específica que representa (por ejemplo, "Factura Generada" para todas las filas del primer informe). Mapee las columnas de origen (por ejemplo, Factura: Fecha de Creación) a los encabezados estándar del registro de eventos (EventTime).
Crear registro de eventos final: Consolide todos los datos transformados de los archivos CSV individuales en un único archivo maestro. Asegúrese de que los encabezados de las columnas sean exactamente InvoiceNumber, ActivityName, EventTime, UserResponsible, etc. Este archivo unificado es su registro de eventos final.
Formato final: Guarde el archivo consolidado como un CSV con codificación UTF-8. El archivo ahora está listo para ser cargado en ProcessMind.

Configuración

Tipos de informes: Es probable que necesite múltiples tipos de informes personalizados para unir objetos principales como Cuenta con objetos secundarios y de tercer nivel como Factura, Pago y Actividad. Cree estos en Configuración > Tipos de informes.
Seguimiento del historial de campo: Esto es crucial. Para el objeto Factura, habilite el seguimiento del historial para cualquier campo Status. Sin esto, no podrá capturar actividades de cambio de estado como 'Aprobado' o 'Rechazado'. El historial no se rastrea de forma retroactiva.
Filtros de datos: Aplique siempre un filtro de fecha a sus informes para mantener el volumen de datos manejable. Una buena práctica es filtrar la fecha de creación del objeto principal para los últimos 3 a 6 meses (por ejemplo, Factura: Fecha de Creación es igual a ÚLTIMOS 180 DÍAS).
Servicio de Exportación de Datos: Como alternativa a la ejecución de informes individuales, puede utilizar el Servicio de Exportación de Datos nativo (Configuración > Exportación de Datos). Este servicio exporta todos los datos de su organización de forma semanal o mensual. Esto proporciona una copia de seguridad completa, pero requiere un post-procesamiento significativo para filtrar, unir y transformar los datos en un registro de eventos.
Permisos de usuario: El usuario que realiza la extracción necesita acceso de lectura a todos los objetos relevantes (por ejemplo, Cuenta, Pedido, Invoice__c, Payment__c, Actividad) y campos, además de permisos para crear y exportar informes.

a Consulta de ejemplo config

// This is a configuration guide for building multiple Salesforce reports.
// The data from these separate CSV exports must be manually combined and transformed into a single event log.

// Report 1: Invoice Generated
// Report Type: Invoices (or your custom invoice object report type)
// Filters: 
// 1. Created Date GREATER OR EQUAL [Start Date]
// 2. Created Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Invoice Generated' (static text) -> ActivityName
// - Created Date -> EventTime
// - Created By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 2: Invoice Status Changes (Submitted, Approved, Rejected, Corrected, Closed, Written Off)
// Report Type: Invoice History (or your custom object's history report type)
// Filters:
// 1. Edit Date GREATER OR EQUAL [Start Date]
// 2. Edit Date LESS OR EQUAL [End Date]
// 3. Field/Event EQUALS 'Status' (or the name of your status field)
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - New Value (transformed*) -> ActivityName 
// - Edit Date -> EventTime
// - Edited By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - New Value -> InvoiceStatus
// - [Invoice Total Amount] -> InvoiceTotalAmount
// - [Invoice Payment Due Date] -> PaymentDueDate
// *Transformation Logic for ActivityName: 
//   - IF New Value = 'Pending Approval' THEN 'Invoice Submitted for Approval'
//   - IF New Value = 'Approved' THEN 'Invoice Approved'
//   - IF New Value = 'Rejected' THEN 'Invoice Rejected'
//   - IF New Value = 'Draft' AND Old Value = 'Rejected' THEN 'Invoice Corrected'
//   - IF New Value = 'Closed' THEN 'Invoice Closed'
//   - IF New Value = 'Written Off' THEN 'Invoice Written Off'

// Report 3: Invoice Sent to Customer
// Report Type: Invoices
// Filters:
// 1. [Sent Date Field] NOT EQUAL TO "" (not null)
// 2. [Sent Date Field] GREATER OR EQUAL [Start Date]
// 3. [Sent Date Field] LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Invoice Sent to Customer' (static text) -> ActivityName
// - [Sent Date Field] -> EventTime
// - Last Modified By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 4: Payment Due Date Reached
// Report Type: Invoices
// Filters:
// 1. Payment Due Date NOT EQUAL TO "" (not null)
// 2. Payment Due Date GREATER OR EQUAL [Start Date]
// 3. Payment Due Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Payment Due Date Reached' (static text) -> ActivityName
// - Payment Due Date -> EventTime
// - 'System' (static text) -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 5: Payment Reminder Issued
// Report Type: Activities with Invoices (or similar custom report type)
// Filters:
// 1. Task or Event Subject CONTAINS 'Payment Reminder'
// 2. Created Date GREATER OR EQUAL [Start Date]
// 3. Created Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice: Invoice Number -> InvoiceNumber
// - 'Payment Reminder Issued' (static text) -> ActivityName
// - Created Date -> EventTime
// - Assigned To -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - [Invoice Status Field] -> InvoiceStatus
// - [Invoice Total Amount] -> InvoiceTotalAmount
// - [Invoice Payment Due Date] -> PaymentDueDate

// Report 6: Customer Payment Received & Status Changes (Posted, Applied)
// Report Type: Payments with Invoices (or similar custom report type)
// This report combines multiple events from the Payment record.
// Filters:
// 1. Payment: Created Date GREATER OR EQUAL [Start Date]
// 2. Payment: Created Date LESS OR EQUAL [End Date]
// Part A: Payment Received
// Columns to Export & Map:
// - Invoice: Invoice Number -> InvoiceNumber
// - 'Customer Payment Received' (static text) -> ActivityName
// - Payment: Created Date -> EventTime
// - Payment: Created By -> UserResponsible
// Part B: Payment Posted and Applied (Requires exporting and transforming multiple rows for the same payment if status changes)
// You may need a separate Payment History Report, similar to Report 2.
// Assuming a simple status field on the Payment for this example:
//   - IF Payment Status = 'Posted' THEN 'Payment Posted to Ledger'
//   - IF Payment Status = 'Applied' THEN 'Cash Applied/Reconciled'

Pasos

Requisitos previos y Configuración: Asegúrese de tener Python 3.6 o superior instalado en su sistema. Instale las bibliotecas necesarias ejecutando el siguiente comando en su terminal: pip install simple-salesforce pandas. También necesitará su nombre de usuario, contraseña y token de seguridad de Salesforce. Para obtener su token de seguridad, inicie sesión en Salesforce, vaya a su configuración personal y encuentre la opción 'Restablecer mi token de seguridad'.
Habilitar el seguimiento del historial de campo: Inicie sesión en su organización de Salesforce como administrador. Navegue a Configuración, luego a Gestor de objetos. Encuentre su objeto Factura principal, por ejemplo, Invoice__c, y vaya a 'Campos y Relaciones'. Haga clic en 'Configurar seguimiento de historial'. Habilite el seguimiento para el campo que representa el estado de la factura, por ejemplo, Status__c. Repita este proceso para su objeto Pago, por ejemplo, Payment__c, y su campo de estado correspondiente.
Descargar y Configurar el Script: Guarde el script de Python proporcionado en un archivo llamado extract_invoices.py. Abra el archivo en un editor de texto y actualice los valores de marcador de posición en la sección 'Credenciales y Configuración de Salesforce'. Debe proporcionar su SF_USERNAME, SF_PASSWORD, SF_SECURITY_TOKEN y SF_INSTANCE_URL. Ajuste las variables START_DATE y END_DATE para definir el período de extracción.
Personalizar Nombres de Objetos y Campos: Revise cuidadosamente las consultas SOQL dentro del script. El script utiliza nombres de marcador de posición como Invoice__c, Payment__c, Status__c, Total_Amount__c, etc. Debe reemplazar estos marcadores de posición con los nombres de API reales de los objetos y campos utilizados en su instancia de Salesforce para la facturación y el cobro.
Ejecutar el Script de Extracción: Abra un terminal o símbolo del sistema, navegue al directorio donde guardó el script y ejecútelo usando el comando: python extract_invoices.py. El script se conectará a la API de Salesforce, ejecutará las consultas y procesará los datos.
Monitorear el Progreso del Script: El script imprimirá mensajes de estado en la consola a medida que obtiene y procesa datos para cada tipo de actividad. Dependiendo del volumen de datos y sus límites de API, esto puede llevar algún tiempo. Esté atento a cualquier mensaje de error que pueda indicar credenciales o nombres de API incorrectos.
Revisar el Archivo de Salida: Una vez que el script se complete exitosamente, generará un archivo llamado salesforce_billing_event_log.csv en el mismo directorio. Abra este archivo CSV con un programa de hoja de cálculo para revisar su contenido y verificar que contiene los datos esperados.
Preparar para Carga: El archivo CSV generado está estructurado con las columnas requeridas: InvoiceNumber, ActivityName y EventTime, junto con otros atributos recomendados. Este archivo está listo para ser cargado directamente en la herramienta de Process Mining sin formato adicional.

Configuración

Credenciales de Salesforce: Debe proporcionar su nombre de usuario, contraseña y token de seguridad de Salesforce. El token de seguridad es necesario para el acceso a la API desde fuera de los rangos de IP de confianza de su organización.
URL de la instancia de Salesforce: Especifique el dominio de su instancia de Salesforce, como su_instancia.my.salesforce.com. Si está utilizando un sandbox, la URL será diferente, por ejemplo, test.salesforce.com.
Filtros de rango de fechas: El script incluye las variables START_DATE y END_DATE. Se recomienda comenzar con un rango de fechas más pequeño, como 3-6 meses, para gestionar el volumen de datos y mantenerse dentro de los límites de la API. Estas fechas filtran la consulta inicial para las fechas de creación de facturas.
Nombres de API de objetos y campos: El script está construido con nombres de API de marcador de posición para objetos y campos, por ejemplo, Invoice__c y Status__c. Debe reemplazar estos con los nombres de API exactos de su modelo de datos de Salesforce. Estos se pueden encontrar en Configuración de Salesforce en Gestor de objetos.
Requisitos previos para el seguimiento: La precisión del registro de eventos, especialmente para los cambios de estado, depende enteramente de que el Seguimiento del historial de campo de Salesforce esté habilitado para los campos relevantes antes de que ocurrieran las transacciones. Si no estaba habilitado, los cambios históricos no se capturarán.
Límites de llamadas a la API: Salesforce impone límites de gobernador en el número de llamadas a la API que puede realizar en un período de 24 horas. Para conjuntos de datos muy grandes, considere ejecutar la extracción en lotes de rangos de fechas más pequeños o programarla durante las horas de menor actividad para evitar alcanzar estos límites.

a Consulta de ejemplo python

import pandas as pd
from simple_salesforce import Salesforce
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Salesforce Credentials and Settings ---
class=class="hl-string">"hl-comment"># IMPORTANT: Replace all placeholder values with your actual Salesforce information.
SF_USERNAME = class="hl-string">'[your_salesforce_username]'
SF_PASSWORD = class="hl-string">'[your_salesforce_password]'
SF_SECURITY_TOKEN = class="hl-string">'[your_salesforce_security_token]' class=class="hl-string">"hl-comment"># Append this to your password if required
SF_INSTANCE_URL = class="hl-string">'https://[your_instance].my.salesforce.com' class=class="hl-string">"hl-comment"># e.g., na1.salesforce.com

class=class="hl-string">"hl-comment"># --- Extraction Period ---
START_DATE = class="hl-string">'2023-01-01T00:00:00Z'
END_DATE = class="hl-string">'2023-12-31T23:59:59Z'

class=class="hl-string">"hl-comment"># --- Object and Field API Name Placeholders ---
class=class="hl-string">"hl-comment"># Replace these with the actual API names from your Salesforce org.
INVOICE_OBJECT = class="hl-string">'Invoice__c'
INVOICE_NUMBER_FIELD = class="hl-string">'Name'
INVOICE_STATUS_FIELD = class="hl-string">'Status__c'
INVOICE_TOTAL_AMOUNT_FIELD = class="hl-string">'Total_Amount__c'
INVOICE_DUE_DATE_FIELD = class="hl-string">'Due_Date__c'

PAYMENT_OBJECT = class="hl-string">'Payment__c'
PAYMENT_INVOICE_LOOKUP_FIELD = class="hl-string">'Invoice__c' class=class="hl-string">"hl-comment"># Lookup field from Payment to Invoice
PAYMENT_STATUS_FIELD = class="hl-string">'Status__c'

class=class="hl-string">"hl-comment"># --- Main Script ---
def main():
    print(class="hl-string">"Connecting to Salesforce...")
    sf = Salesforce(username=SF_USERNAME, password=SF_PASSWORD, security_token=SF_SECURITY_TOKEN, instance_url=SF_INSTANCE_URL)
    print(class="hl-string">"Connection successful.")

    all_events = []

    class=class="hl-string">"hl-comment"># 1. Get base Invoice data
    print(class="hl-string">"Fetching base invoice data...")
    soql_invoices = fclass="hl-string">"""
        SELECT Id, {INVOICE_NUMBER_FIELD}, CreatedDate, CreatedById, LastModifiedById, 
               {INVOICE_STATUS_FIELD}, {INVOICE_TOTAL_AMOUNT_FIELD}, {INVOICE_DUE_DATE_FIELD}
        FROM {INVOICE_OBJECT}
        WHERE CreatedDate >= {START_DATE} AND CreatedDate <= {END_DATE}
    """
    invoices_data = sf.query_all(soql_invoices)[class="hl-string">'records']
    df_invoices = pd.DataFrame(invoices_data).drop(columns=[class="hl-string">'attributes'])
    invoice_ids = class="hl-string">"','".join(df_invoices[class="hl-string">'Id'].tolist())

    class=class="hl-string">"hl-comment"># Activity: Invoice Generated & Payment Due Date Reached
    print(class="hl-string">"Processing 'Invoice Generated' and 'Payment Due Date Reached' events...")
    generated_events = df_invoices.copy()
    generated_events[class="hl-string">'ActivityName'] = class="hl-string">'Invoice Generated'
    generated_events[class="hl-string">'EventTime'] = pd.to_datetime(generated_events[class="hl-string">'CreatedDate']).dt.tz_localize(None)
    generated_events[class="hl-string">'UserResponsible'] = generated_events[class="hl-string">'CreatedById']
    all_events.append(generated_events)

    due_date_events = df_invoices[df_invoices[INVOICE_DUE_DATE_FIELD].notna()].copy()
    due_date_events[class="hl-string">'ActivityName'] = class="hl-string">'Payment Due Date Reached'
    due_date_events[class="hl-string">'EventTime'] = pd.to_datetime(due_date_events[INVOICE_DUE_DATE_FIELD]).dt.tz_localize(None)
    due_date_events[class="hl-string">'UserResponsible'] = None class=class="hl-string">"hl-comment"># System-generated event
    all_events.append(due_date_events)

    class=class="hl-string">"hl-comment"># 2. Get Invoice Status Changes from Field History
    print(class="hl-string">"Fetching invoice status changes...")
    soql_invoice_history = fclass="hl-string">"""
        SELECT ParentId, Field, OldValue, NewValue, CreatedDate, CreatedById
        FROM {INVOICE_OBJECT}History
        WHERE ParentId IN ('{invoice_ids}') AND Field = '{INVOICE_STATUS_FIELD}'
    """
    invoice_history_data = sf.query_all(soql_invoice_history)[class="hl-string">'records']
    if invoice_history_data:
        df_invoice_history = pd.DataFrame(invoice_history_data).drop(columns=[class="hl-string">'attributes'])
        df_invoice_history = df_invoice_history.merge(df_invoices[[class="hl-string">'Id', INVOICE_NUMBER_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=class="hl-string">'ParentId', right_on=class="hl-string">'Id')
        df_invoice_history[class="hl-string">'EventTime'] = pd.to_datetime(df_invoice_history[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df_invoice_history[class="hl-string">'UserResponsible'] = df_invoice_history[class="hl-string">'CreatedById']

        class=class="hl-string">"hl-comment"># Map status changes to Activity Names
        status_map = {
            (class="hl-string">'Draft', class="hl-string">'Pending Approval'): class="hl-string">'Invoice Submitted for Approval',
            (class="hl-string">'Pending Approval', class="hl-string">'Approved'): class="hl-string">'Invoice Approved',
            (class="hl-string">'Pending Approval', class="hl-string">'Rejected'): class="hl-string">'Invoice Rejected',
            (class="hl-string">'Rejected', class="hl-string">'Draft'): class="hl-string">'Invoice Corrected',
            (class="hl-string">'Approved', class="hl-string">'Sent'): class="hl-string">'Invoice Sent to Customer',
            (class="hl-string">'Approved', class="hl-string">'Closed'): class="hl-string">'Invoice Closed',
            (class="hl-string">'Sent', class="hl-string">'Closed'): class="hl-string">'Invoice Closed',
            (class="hl-string">'Approved', class="hl-string">'Written Off'): class="hl-string">'Invoice Written Off'
        }
        df_invoice_history[class="hl-string">'ActivityName'] = df_invoice_history.apply(lambda row: status_map.get((str(row[class="hl-string">'OldValue']), str(row[class="hl-string">'NewValue']))), axis=1)
        df_invoice_history.rename(columns={class="hl-string">'NewValue': INVOICE_STATUS_FIELD}, inplace=True)
        all_events.append(df_invoice_history.dropna(subset=[class="hl-string">'ActivityName']))

    class=class="hl-string">"hl-comment"># 3. Get Payment Reminders from Tasks
    print(class="hl-string">"Fetching payment reminder tasks...")
    soql_tasks = fclass="hl-string">"""
        SELECT WhatId, ActivityDate, CreatedById, CreatedDate
        FROM Task
        WHERE WhatId IN ('{invoice_ids}') AND Subject LIKE '%Payment Reminder%'
    """
    task_data = sf.query_all(soql_tasks)[class="hl-string">'records']
    if task_data:
        df_tasks = pd.DataFrame(task_data).drop(columns=[class="hl-string">'attributes'])
        df_tasks = df_tasks.merge(df_invoices[[class="hl-string">'Id', INVOICE_NUMBER_FIELD, INVOICE_STATUS_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=class="hl-string">'WhatId', right_on=class="hl-string">'Id')
        df_tasks[class="hl-string">'ActivityName'] = class="hl-string">'Payment Reminder Issued'
        df_tasks[class="hl-string">'EventTime'] = pd.to_datetime(df_tasks[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df_tasks[class="hl-string">'UserResponsible'] = df_tasks[class="hl-string">'CreatedById']
        all_events.append(df_tasks)

    class=class="hl-string">"hl-comment"># 4. Get Payment Data
    print(class="hl-string">"Fetching payment data...")
    soql_payments = fclass="hl-string">"""
        SELECT Id, {PAYMENT_INVOICE_LOOKUP_FIELD}, CreatedDate, CreatedById, LastModifiedById, {PAYMENT_STATUS_FIELD}
        FROM {PAYMENT_OBJECT}
        WHERE {PAYMENT_INVOICE_LOOKUP_FIELD} IN ('{invoice_ids}')
    """
    payment_data = sf.query_all(soql_payments)[class="hl-string">'records']
    if payment_data:
        df_payments = pd.DataFrame(payment_data).drop(columns=[class="hl-string">'attributes'])
        df_payments = df_payments.merge(df_invoices[[class="hl-string">'Id', INVOICE_NUMBER_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=PAYMENT_INVOICE_LOOKUP_FIELD, right_on=class="hl-string">'Id', suffixes=(class="hl-string">'_payment', class="hl-string">'_invoice'))
        payment_ids = class="hl-string">"','".join(df_payments[class="hl-string">'Id_payment'].tolist())
        
        class=class="hl-string">"hl-comment"># Activity: Customer Payment Received
        payment_received_events = df_payments.copy()
        payment_received_events[class="hl-string">'ActivityName'] = class="hl-string">'Customer Payment Received'
        payment_received_events[class="hl-string">'EventTime'] = pd.to_datetime(payment_received_events[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        payment_received_events[class="hl-string">'UserResponsible'] = payment_received_events[class="hl-string">'CreatedById']
        all_events.append(payment_received_events)
        
        class=class="hl-string">"hl-comment"># 5. Get Payment Status Changes
        print(class="hl-string">"Fetching payment status changes...")
        soql_payment_history = fclass="hl-string">"""
            SELECT ParentId, Field, OldValue, NewValue, CreatedDate, CreatedById
            FROM {PAYMENT_OBJECT}History
            WHERE ParentId IN ('{payment_ids}') AND Field = '{PAYMENT_STATUS_FIELD}'
        """
        payment_history_data = sf.query_all(soql_payment_history)[class="hl-string">'records']
        if payment_history_data:
            df_payment_history = pd.DataFrame(payment_history_data).drop(columns=[class="hl-string">'attributes'])
            df_payment_history = df_payment_history.merge(df_payments[[class="hl-string">'Id_payment', INVOICE_NUMBER_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=class="hl-string">'ParentId', right_on=class="hl-string">'Id_payment')
            df_payment_history[class="hl-string">'EventTime'] = pd.to_datetime(df_payment_history[class="hl-string">'CreatedDate']).dt.tz_localize(None)
            df_payment_history[class="hl-string">'UserResponsible'] = df_payment_history[class="hl-string">'CreatedById']

            payment_status_map = {
                (class="hl-string">'Received', class="hl-string">'Posted'): class="hl-string">'Payment Posted to Ledger',
                (class="hl-string">'Posted', class="hl-string">'Reconciled'): class="hl-string">'Cash Applied/Reconciled'
            }
            df_payment_history[class="hl-string">'ActivityName'] = df_payment_history.apply(lambda row: payment_status_map.get((str(row[class="hl-string">'OldValue']), str(row[class="hl-string">'NewValue']))), axis=1)
            df_payment_history.rename(columns={class="hl-string">'NewValue': INVOICE_STATUS_FIELD}, inplace=True)
            all_events.append(df_payment_history.dropna(subset=[class="hl-string">'ActivityName']))

    class=class="hl-string">"hl-comment"># --- Final Assembly ---
    print(class="hl-string">"Assembling final event log...")
    final_df = pd.concat(all_events, ignore_index=True)

    class=class="hl-string">"hl-comment"># Standardize column names
    final_df.rename(columns={
        INVOICE_NUMBER_FIELD: class="hl-string">'InvoiceNumber',
        INVOICE_STATUS_FIELD: class="hl-string">'InvoiceStatus',
        INVOICE_TOTAL_AMOUNT_FIELD: class="hl-string">'InvoiceTotalAmount',
        INVOICE_DUE_DATE_FIELD: class="hl-string">'PaymentDueDate'
    }, inplace=True)

    class=class="hl-string">"hl-comment"># Select and order columns for the final event log
    required_cols = {
        class="hl-string">'InvoiceNumber': None,
        class="hl-string">'ActivityName': None,
        class="hl-string">'EventTime': None,
        class="hl-string">'UserResponsible': None,
        class="hl-string">'InvoiceStatus': None,
        class="hl-string">'InvoiceTotalAmount': None,
        class="hl-string">'PaymentDueDate': None
    }
    for col in required_cols:
        if col not in final_df.columns:
            final_df[col] = required_cols[col]
    
    class=class="hl-string">"hl-comment"># We cannot extract Billing Department directly from this model, so we will add it as an empty column
    final_df[class="hl-string">'BillingDepartment'] = None

    final_df = final_df[list(required_cols.keys()) + [class="hl-string">'BillingDepartment']]

    class=class="hl-string">"hl-comment"># Sort by case and event time
    final_df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'], inplace=True)

    class=class="hl-string">"hl-comment"># Save to CSV
    output_filename = class="hl-string">'salesforce_billing_event_log.csv'
    final_df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%S.%f')
    print(fclass="hl-string">"Event log saved to {output_filename}")

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

Pasos

Verificación de requisitos previos: Asegúrese de tener los permisos necesarios en Salesforce, incluyendo "Ejecutar informes", "Crear y personalizar informes" y "Exportar informes". Verifique que el Seguimiento del historial de campo esté habilitado para los campos de estado clave en sus objetos Factura y Pago. Para ello, navegue a Configuración > Gestor de objetos, encuentre el objeto relevante, vaya a Campos y Relaciones, y haga clic en "Configurar seguimiento de historial".
Definir estrategia de informes: Este proceso requiere la creación de múltiples informes porque las actividades se originan a partir de diferentes registros o eventos (por ejemplo, creación de facturas, cambios de estado, pagos relacionados). Creará un informe separado para cada fuente distinta y luego combinará los resultados externamente.
Crear informe para creaciones de registros: Comience con los eventos más sencillos. Cree un informe para 'Factura Generada' y 'Pago de Cliente Recibido'. Navegue a la pestaña Informes y haga clic en "Nuevo informe". Elija un tipo de informe que incluya su objeto Factura (por ejemplo, "Facturas") o el objeto Pago. Agregue columnas correspondientes a los atributos del registro de eventos. Para la actividad 'Factura Generada', la CreatedDate del registro de la factura será el EventTime.
Crear informe para historial de campo: Para capturar cambios de estado como 'Factura Enviada para Aprobación', 'Factura Aprobada', 'Factura Rechazada' y 'Factura Corregida', cree un informe basado en el tipo de informe "Historial de Facturas". Este tipo de informe especial expone los cambios rastreados por el Seguimiento del historial de campo. Filtrará este informe para los cambios en el campo Status.
Crear informe para eventos basados en fechas: Para eventos como 'Factura Enviada al Cliente' o 'Fecha de Vencimiento de Pago Alcanzada', cree un informe sobre el objeto Factura. Utilice los campos de fecha en sí mismos, como Sent_Date__c o Payment_Due_Date__c, como el EventTime. Debe filtrar los registros donde estas fechas no sean nulas.
Crear informe para actividades relacionadas: Para eventos como 'Recordatorio de Pago Emitido', necesita un informe que vincule Actividades (Tareas o Eventos) a Facturas. Utilice un tipo de informe como "Actividades con facturas" o uno personalizado que cree. Filtre las actividades con un asunto o tipo específico que indique un recordatorio.
Agregar columnas estándar a todos los informes: En cada informe que construya, asegúrese de agregar columnas que puedan mapearse a la estructura de registro de eventos requerida: InvoiceNumber, un campo para el EventTime (como CreatedDate o la fecha del cambio de campo), UserResponsible (como LastModifiedById), y otros atributos recomendados.
Exportar informes a CSV: Ejecute cada informe individualmente. Desde la pantalla de resultados del informe, use el menú desplegable para seleccionar "Exportar" y elija el formato "Solo detalles" con una extensión .csv. Repita esto para todos los informes que creó.
Combinar y transformar datos: Abra los archivos CSV exportados en un programa de hoja de cálculo o utilice una herramienta de preparación de datos. Para cada archivo, agregue una nueva columna llamada ActivityName y rellénela con la actividad específica que representa (por ejemplo, "Factura Generada" para todas las filas del primer informe). Mapee las columnas de origen (por ejemplo, Factura: Fecha de Creación) a los encabezados estándar del registro de eventos (EventTime).
Crear registro de eventos final: Consolide todos los datos transformados de los archivos CSV individuales en un único archivo maestro. Asegúrese de que los encabezados de las columnas sean exactamente InvoiceNumber, ActivityName, EventTime, UserResponsible, etc. Este archivo unificado es su registro de eventos final.
Formato final: Guarde el archivo consolidado como un CSV con codificación UTF-8. El archivo ahora está listo para ser cargado en ProcessMind.

Configuración

Tipos de informes: Es probable que necesite múltiples tipos de informes personalizados para unir objetos principales como Cuenta con objetos secundarios y de tercer nivel como Factura, Pago y Actividad. Cree estos en Configuración > Tipos de informes.
Seguimiento del historial de campo: Esto es crucial. Para el objeto Factura, habilite el seguimiento del historial para cualquier campo Status. Sin esto, no podrá capturar actividades de cambio de estado como 'Aprobado' o 'Rechazado'. El historial no se rastrea de forma retroactiva.
Filtros de datos: Aplique siempre un filtro de fecha a sus informes para mantener el volumen de datos manejable. Una buena práctica es filtrar la fecha de creación del objeto principal para los últimos 3 a 6 meses (por ejemplo, Factura: Fecha de Creación es igual a ÚLTIMOS 180 DÍAS).
Servicio de Exportación de Datos: Como alternativa a la ejecución de informes individuales, puede utilizar el Servicio de Exportación de Datos nativo (Configuración > Exportación de Datos). Este servicio exporta todos los datos de su organización de forma semanal o mensual. Esto proporciona una copia de seguridad completa, pero requiere un post-procesamiento significativo para filtrar, unir y transformar los datos en un registro de eventos.
Permisos de usuario: El usuario que realiza la extracción necesita acceso de lectura a todos los objetos relevantes (por ejemplo, Cuenta, Pedido, Invoice__c, Payment__c, Actividad) y campos, además de permisos para crear y exportar informes.

a Consulta de ejemplo config

// This is a configuration guide for building multiple Salesforce reports.
// The data from these separate CSV exports must be manually combined and transformed into a single event log.

// Report 1: Invoice Generated
// Report Type: Invoices (or your custom invoice object report type)
// Filters: 
// 1. Created Date GREATER OR EQUAL [Start Date]
// 2. Created Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Invoice Generated' (static text) -> ActivityName
// - Created Date -> EventTime
// - Created By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 2: Invoice Status Changes (Submitted, Approved, Rejected, Corrected, Closed, Written Off)
// Report Type: Invoice History (or your custom object's history report type)
// Filters:
// 1. Edit Date GREATER OR EQUAL [Start Date]
// 2. Edit Date LESS OR EQUAL [End Date]
// 3. Field/Event EQUALS 'Status' (or the name of your status field)
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - New Value (transformed*) -> ActivityName 
// - Edit Date -> EventTime
// - Edited By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - New Value -> InvoiceStatus
// - [Invoice Total Amount] -> InvoiceTotalAmount
// - [Invoice Payment Due Date] -> PaymentDueDate
// *Transformation Logic for ActivityName: 
//   - IF New Value = 'Pending Approval' THEN 'Invoice Submitted for Approval'
//   - IF New Value = 'Approved' THEN 'Invoice Approved'
//   - IF New Value = 'Rejected' THEN 'Invoice Rejected'
//   - IF New Value = 'Draft' AND Old Value = 'Rejected' THEN 'Invoice Corrected'
//   - IF New Value = 'Closed' THEN 'Invoice Closed'
//   - IF New Value = 'Written Off' THEN 'Invoice Written Off'

// Report 3: Invoice Sent to Customer
// Report Type: Invoices
// Filters:
// 1. [Sent Date Field] NOT EQUAL TO "" (not null)
// 2. [Sent Date Field] GREATER OR EQUAL [Start Date]
// 3. [Sent Date Field] LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Invoice Sent to Customer' (static text) -> ActivityName
// - [Sent Date Field] -> EventTime
// - Last Modified By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 4: Payment Due Date Reached
// Report Type: Invoices
// Filters:
// 1. Payment Due Date NOT EQUAL TO "" (not null)
// 2. Payment Due Date GREATER OR EQUAL [Start Date]
// 3. Payment Due Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Payment Due Date Reached' (static text) -> ActivityName
// - Payment Due Date -> EventTime
// - 'System' (static text) -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 5: Payment Reminder Issued
// Report Type: Activities with Invoices (or similar custom report type)
// Filters:
// 1. Task or Event Subject CONTAINS 'Payment Reminder'
// 2. Created Date GREATER OR EQUAL [Start Date]
// 3. Created Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice: Invoice Number -> InvoiceNumber
// - 'Payment Reminder Issued' (static text) -> ActivityName
// - Created Date -> EventTime
// - Assigned To -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - [Invoice Status Field] -> InvoiceStatus
// - [Invoice Total Amount] -> InvoiceTotalAmount
// - [Invoice Payment Due Date] -> PaymentDueDate

// Report 6: Customer Payment Received & Status Changes (Posted, Applied)
// Report Type: Payments with Invoices (or similar custom report type)
// This report combines multiple events from the Payment record.
// Filters:
// 1. Payment: Created Date GREATER OR EQUAL [Start Date]
// 2. Payment: Created Date LESS OR EQUAL [End Date]
// Part A: Payment Received
// Columns to Export & Map:
// - Invoice: Invoice Number -> InvoiceNumber
// - 'Customer Payment Received' (static text) -> ActivityName
// - Payment: Created Date -> EventTime
// - Payment: Created By -> UserResponsible
// Part B: Payment Posted and Applied (Requires exporting and transforming multiple rows for the same payment if status changes)
// You may need a separate Payment History Report, similar to Report 2.
// Assuming a simple status field on the Payment for this example:
//   - IF Payment Status = 'Posted' THEN 'Payment Posted to Ledger'
//   - IF Payment Status = 'Applied' THEN 'Cash Applied/Reconciled'

Su Plantilla de Datos de Del Pedido al Cobro - Facturación

Su Plantilla de Datos de Del Pedido al Cobro - Facturación

Atributos de Del Pedido al Cobro - Facturación

Actividades de Del Pedido al Cobro - Facturación

Guías de Extracción

Salesforce Report Builder y Data Export Service

Pasos

Configuración

a Consulta de ejemplo config

Script de Python usando la API REST de Salesforce

Pasos

Configuración

a Consulta de ejemplo python

Extracción con Herramienta ETL a través de Conector Preconstruido de Salesforce

Pasos

Configuración

a Consulta de ejemplo config

¿Listo para comenzar?

Pagos Más Rápidos: Optimice la Facturación O2C Ahora

Su Plantilla de Datos de Del Pedido al Cobro - Facturación

Su Plantilla de Datos de Del Pedido al Cobro - Facturación

Atributos de Del Pedido al Cobro - Facturación

Actividades de Del Pedido al Cobro - Facturación

Guías de Extracción

Salesforce Report Builder y Data Export Service

Pasos

Configuración

a Consulta de ejemplo config

Script de Python usando la API REST de Salesforce

Pasos

Configuración

a Consulta de ejemplo python

Extracción con Herramienta ETL a través de Conector Preconstruido de Salesforce

Pasos

Configuración

a Consulta de ejemplo config

Valoramos su privacidad

¿Listo para comenzar?

Pagos Más Rápidos: Optimice la Facturación O2C Ahora