> Mejora continua de procesos > Gestión de crédito y cobros > NetSuite > Template de datos

Su Template de datos para la gestión de crédito y los cobros

NetSuite

Atributos de gestión de crédito y cobros (21) Actividades de gestión de crédito y cobros (13) Guías de extracción (2)

Su Template de datos para la gestión de crédito y los cobros

Este Template ofrece una guía completa para recopilar los datos adecuados y analizar su proceso de gestión de crédito y cobros. Detalla los atributos y las actividades esenciales, junto con indicaciones prácticas para la extracción, para ayudarle a empezar rápidamente. Si sigue estas recomendaciones, podrá optimizar sus datos para obtener información útil sobre el proceso y mejorarlo.

Atributos recomendados para recopilar
Actividades clave que debe supervisar
Indicaciones para extraer datos de NetSuite

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

Descargar Template

Atributos de gestión de crédito y cobros

Estos son los campos de datos recomendados que debe incluir en su registro de eventos para analizar exhaustivamente su proceso de gestión de crédito y cobros.

3 Obligatorio 5 Recomendado 13 Opcional

	Nombre	Descripción
	Hora del evento EventTime	Marca de tiempo que indica cuándo tuvo lugar la actividad.
Descripción Este atributo captura la fecha y hora exactas de cada actividad del proceso. Es fundamental para todos los análisis basados en el tiempo, incluido el cálculo de tiempos de ciclo, duraciones y tiempos de espera entre pasos. En NetSuite, esta marca de tiempo suele corresponder a la fecha de creación o de última modificación del registro o la nota del sistema correspondiente. Por qué es importante Permite calcular todas las métricas de rendimiento relacionadas con el tiempo, como los tiempos de ciclo y los cuellos de botella, que son fundamentales para analizar la eficiencia. Dónde obtenerlo Se obtiene de los campos de fecha de distintos registros. Por ejemplo, la 'Date Created' de un registro Invoice para 'Invoice Generated' o la marca de tiempo de una System Note para los cambios de estado. Ejemplos 2023-01-15T10:00:00Z2023-02-01T14:30:00Z2023-02-15T09:05:00Z
	Nombre de la actividad ActivityName	Nombre de la actividad empresarial que tuvo lugar en un momento concreto.
Descripción Este atributo describe un paso o evento específico del proceso de crédito y cobros, como 'Invoice Generated', 'Payment Received' o 'Dispute Registered'. Analizar la secuencia y frecuencia de estas actividades es el núcleo de Process Mining, ya que revela el flujo real del proceso, sus desviaciones y sus cuellos de botella. Por qué es importante Este atributo constituye la base del mapa de procesos y permite visualizar y analizar el flujo del proceso. Dónde obtenerlo Este campo suele derivarse de los cambios de estado de los registros de transacciones, como Invoice o Customer Payment, o de registros relacionados, como notas del sistema, registros personalizados de actividades de cobro o tareas de CRM. Ejemplos Factura generadaRecordatorio de vencimiento enviadoPago recibidoFactura cancelada por incobrable
	Número de factura InvoiceNumber	Identificador único de cada factura del cliente.
Descripción El número de factura actúa como identificador principal del caso y vincula de forma única todas las actividades relacionadas con una cuenta por cobrar específica. Esto permite analizar de forma integral todo el ciclo de vida, desde la creación de la factura y las acciones posteriores de gestión crediticia hasta su pago final o resolución mediante actividades de cobro. En NetSuite, normalmente corresponde al Transaction ID cuando el tipo de transacción es 'Invoice'. Por qué es importante Es la clave esencial para seguir el recorrido de una factura desde su generación hasta su liquidación y permite analizar el proceso de principio a fin. Dónde obtenerlo Normalmente es el campo 'Transaction ID' (ID interno: tranid) del registro Invoice en NetSuite. Ejemplos INV0012345INV0054321INV0098765
	Estado de la factura InvoiceStatus	Estado actual de la factura en su ciclo de vida.
Descripción Indica el estado actual de la factura, como 'Open', 'Paid In Full' u 'Overdue'. Resulta útil para filtrar y analizar únicamente las facturas activas o problemáticas. El Dashboard 'Overdue Invoices Aging and Status' utiliza este atributo para ofrecer una visión de las cuentas por cobrar pendientes. Por qué es importante Permite filtrar y centrar el análisis en etapas específicas del ciclo de vida de la factura, como facturas abiertas, vencidas o impugnadas. Dónde obtenerlo Corresponde al campo 'Status' (ID interno: status) del registro de transacción Invoice. Ejemplos AbiertaPagada en su totalidadVencida
	Fecha de vencimiento DueDate	Fecha límite para pagar la factura.
Descripción La fecha de vencimiento es la fecha acordada contractualmente para el pago. Constituye la referencia para determinar si un pago se realiza a tiempo o está vencido. Este atributo es esencial para calcular KPI como la 'On-Time Payment Rate' y activar actividades de cobro cuando se supera la fecha. Por qué es importante Actúa como referencia principal para medir la puntualidad de los pagos y es fundamental para calcular los días de retraso y supervisar el cumplimiento de las condiciones de pago. Dónde obtenerlo Es el campo 'Due Date' (ID interno: duedate) del registro de transacción Invoice. Ejemplos 2023-02-142023-03-312023-04-15
	ID del cliente CustomerId	Identificador único del cliente asociado a la factura.
Descripción Este atributo vincula una factura con una entidad de cliente específica en NetSuite. Es esencial para segmentar los datos y analizar el rendimiento del proceso en distintos clientes o grupos de clientes. Por ejemplo, permite analizar el comportamiento de pago o las tasas de disputa de cuentas estratégicas frente a pequeñas empresas. Por qué es importante Permite realizar análisis centrados en el cliente y ayuda a identificar qué clientes se retrasan con frecuencia, presentan disputas o siguen procesos no estándar. Dónde obtenerlo Es el campo 'Customer' (ID interno: entity) del registro de transacción Invoice. Ejemplos CUST001CUST002CUST003
	Importe de la factura InvoiceAmount	Valor monetario total de la factura.
Descripción Representa el importe total pendiente de pago de la factura. Es un atributo financiero fundamental que se utiliza en casi todos los análisis, como la identificación del impacto financiero de los pagos atrasados o el análisis de cancelaciones por incobrabilidad en facturas de alto valor. Proporciona el contexto necesario para priorizar los esfuerzos de cobro. Por qué es importante Aporta contexto financiero al proceso y permite analizarlo según el valor monetario, por ejemplo, priorizando el cobro de facturas vencidas de alto importe. Dónde obtenerlo Es el campo 'Amount (Total)' (ID interno: total) del registro de transacción Invoice. Ejemplos 1500.00250.5012500.75
	Segmento de clientes CustomerSegment	Clasificación del cliente, por ejemplo, por tamaño, sector o región.
Descripción Customer Segment clasifica a los clientes en grupos relevantes, como 'Enterprise', 'SMB' o 'Public Sector'. Este atributo es fundamental para el Dashboard 'Collection Strategy Performance by Segment', ya que permite comparar la eficacia de distintos enfoques de cobro entre estos segmentos. También ayuda a adaptar las estrategias a los comportamientos específicos de cada grupo. Por qué es importante Permite realizar análisis específicos para determinar si ciertos problemas del proceso o comportamientos de pago se concentran en determinados grupos de clientes. Dónde obtenerlo A menudo es un campo personalizado del registro Customer en NetSuite. Los datos deben combinarse desde el registro Customer con la transacción Invoice. Ejemplos Empresa grandeEmpresa medianaSMB
	Condiciones de pago PaymentTerms	Condiciones de pago acordadas con el cliente para la factura.
Descripción Este atributo especifica las condiciones en las que el cliente debe pagar una factura, como 'Net 30' o 'Net 60'. Es la base para calcular la fecha de vencimiento de la factura y resulta fundamental para el Dashboard 'Payment Terms Compliance and Deviations', que analiza si los clientes cumplen las condiciones acordadas. Por qué es importante Proporciona la base contractual de los calendarios de pago y es esencial para analizar el cumplimiento e identificar desviaciones que afectan al flujo de caja. Dónde obtenerlo Es el campo 'Terms' (ID interno: terms) del registro de transacción Invoice. Ejemplos Neto a 30 díasNeto a 60 díasVencimiento al recibir
	Días de retraso DaysOverdue	Número de días que han transcurrido desde la fecha de vencimiento de una factura.
Descripción Esta métrica calculada mide el número de días entre la fecha de vencimiento de la factura y la fecha actual, para facturas abiertas, o la fecha de pago. Es un KPI fundamental para los cobros y se utiliza en el Dashboard 'Overdue Invoices Aging and Status' para categorizar y priorizar los esfuerzos de cobro. Un valor igual o inferior a cero indica que la factura no está vencida. Por qué es importante Mide directamente la gravedad de los retrasos en los pagos y es una métrica clave para los informes de antigüedad y la priorización de las actividades de cobro. Dónde obtenerlo Se calcula durante la transformación de datos: (fecha actual o fecha de pago) - fecha de vencimiento. Ejemplos 1532090
	Está automatizado IsAutomated	Indicador que señala si una actividad fue realizada automáticamente por un sistema.
Descripción Este atributo booleano especifica si una actividad fue ejecutada por un flujo de trabajo automatizado o por un usuario. Por ejemplo, la actividad 'Overdue Reminder Sent' puede estar automatizada, mientras que 'Collection Call Made' es manual. Es esencial para el Dashboard 'Manual Activity Frequency and Impact', ya que permite cuantificar los niveles de automatización e identificar oportunidades para automatizar más actividades. Por qué es importante Ayuda a cuantificar el nivel de automatización del proceso y respalda las iniciativas destinadas a reducir el esfuerzo manual y mejorar la eficiencia. Dónde obtenerlo Es un atributo derivado del tipo de actividad o del usuario que la realizó. Por ejemplo, si el usuario es un usuario 'SYSTEM' designado, la actividad se marca como automatizada. Ejemplos truefalse
	ID de usuario UserId	Identificador del usuario que realizó la actividad.
Descripción Identifica al empleado o usuario del sistema responsable de una actividad concreta, como contabilizar un pago o realizar una llamada de cobro. Esto permite analizar la distribución de la carga de trabajo, el rendimiento del equipo y las necesidades de formación. En las actividades automatizadas, puede tratarse del ID de un usuario del sistema. Por qué es importante Permite analizar el rendimiento por usuario o equipo, comprender la distribución de la carga de trabajo e identificar dónde se producen intervenciones manuales. Dónde obtenerlo Se obtiene de campos como 'Created By', 'Modified By' o un campo específico 'Owner' de las transacciones o registros relacionados, como el registro Phone Call de las llamadas de cobro. Ejemplos j.doea.smithSYSTEM
	Motivo de la disputa DisputeReason	Motivo indicado para la disputa de una factura por parte del cliente.
Descripción Cuando un cliente impugna una factura, este atributo registra el motivo, como 'Incorrect Pricing', 'Damaged Goods' o 'Duplicate Billing'. Es fundamental para los Dashboards 'Invoice Dispute Resolution Time' e 'Invoice Write-Off Root Cause Analysis', ya que permite comprender por qué se producen las disputas e identificar patrones que puedan corregirse para evitar problemas futuros. Por qué es importante Ayuda a identificar las causas raíz de las disputas de los clientes y proporciona información para mejorar procesos anteriores, como el cumplimiento de pedidos o la precisión de la facturación. Dónde obtenerlo Probablemente es un campo personalizado del registro Invoice o un registro personalizado relacionado que se utiliza para realizar el seguimiento de los casos de disputa. No es un campo estándar de NetSuite. Ejemplos Cantidad incorrectaDiferencia de precioMercancía dañada
	Nombre del agente de cobro CollectorName	Nombre del agente de cobro asignado a la factura.
Descripción Identifica al agente de cobro o recurso específico responsable de gestionar una factura vencida. Esto permite analizar el rendimiento del equipo de cobros, comprender la distribución de la carga de trabajo y evaluar la eficacia de cada agente. También respalda KPI como 'Collections Contact Success Rate'. Por qué es importante Permite medir el rendimiento y equilibrar la carga de trabajo del equipo de cobros, vinculando las actividades de cobro con personas concretas. Dónde obtenerlo A menudo es un campo personalizado del registro Customer o Invoice. Algunos paquetes de NetSuite para cobros incorporan esta funcionalidad. Ejemplos Alice JohnsonRobert WilliamsSin asignar
	Pago realizado a tiempo IsOnTimePayment	Indicador que señala si el pago se recibió en la fecha de vencimiento o antes.
Descripción Este atributo booleano calculado comprueba si la actividad «Pago recibido» tuvo lugar en la fecha de vencimiento de la factura o antes. Simplifica el cálculo del KPI «Tasa de pagos a tiempo» y facilita el filtrado y el análisis de pagos puntuales y atrasados. Proporciona un resultado binario claro sobre el rendimiento de los pagos. Por qué es importante Proporciona una métrica binaria sencilla para evaluar el cumplimiento de las condiciones de pago, lo que facilita el cálculo y la comparación de la tasa de pagos a tiempo. Dónde obtenerlo Se calcula durante la transformación de datos: TRUE si (fecha de pago <= fecha de vencimiento); de lo contrario, FALSE. Ejemplos truefalse
	País Country	País de la dirección de facturación del cliente.
Descripción Este atributo indica el país asociado a la dirección de facturación del cliente en la factura. Se utiliza para analizar las variaciones geográficas en el comportamiento de pago, la eficacia de los cobros y las tasas de disputa. Esto puede ayudar a adaptar las estrategias de cobro a regiones específicas y comprender el impacto de las condiciones económicas locales. Por qué es importante Permite segmentar geográficamente el proceso y puede poner de manifiesto diferencias regionales en el comportamiento de pago o la eficiencia del proceso. Dónde obtenerlo Se obtiene de los datos de 'Billing Address' de la transacción Invoice, que normalmente se heredan del registro Customer. Ejemplos USAAlemaniaJapón
	Retraso en el registro del pago PaymentPostingLag	Tiempo transcurrido entre la recepción de un pago y su registro en el sistema.
Descripción Esta duración calculada mide el retraso entre la actividad «Pago recibido» (cuando se reciben los fondos) y la actividad «Pago registrado» (cuando el pago se aplica a la factura en NetSuite). Es una métrica clave para el Dashboard «Análisis del retraso en el registro de pagos», ya que pone de manifiesto las ineficiencias internas en la aplicación de cobros que pueden distorsionar la visibilidad del efectivo. Por qué es importante Pone de manifiesto los retrasos internos en la aplicación de cobros, que pueden afectar a la precisión de los informes financieros y al estado de las cuentas de los clientes. Dónde obtenerlo Se calcula en la herramienta de Process Mining: Timestamp('Payment Posted') - Timestamp('Payment Received'). Ejemplos 1 día4 horas3 días
	Sistema de origen SourceSystem	Sistema del que se extrajeron los datos.
Descripción Identifica el sistema de origen de los datos de eventos. En esta vista del proceso, el valor será siempre 'NetSuite', pero se trata de un atributo obligatorio para la gobernanza de datos y para distinguir las fuentes de datos en un entorno con varios sistemas. Por qué es importante Garantiza la trazabilidad y el linaje de los datos, aspectos importantes para su validación y gobernanza, especialmente en entornos con varios sistemas integrados. Dónde obtenerlo Es un valor estático ('NetSuite') que se añade durante el proceso de transformación de datos. Ejemplos NetSuite
	Tiempo del ciclo de factura a cobro InvoiceToCashCycleTime	Tiempo total desde la generación de la factura hasta la liquidación final.
Descripción Esta métrica calculada mide la duración total desde la actividad «Factura generada» hasta la actividad «Factura liquidada». Representa el rendimiento integral del proceso de crédito y cobros. El análisis de este KPI ayuda a identificar retrasos sistémicos y proporciona una medida general de la velocidad del flujo de caja. Por qué es importante Se trata de un KPI crítico y de alto nivel que mide la eficiencia general de todo el proceso de factura a cobro. Dónde obtenerlo Es un cálculo a nivel de caso realizado en la herramienta de Process Mining: Timestamp('Invoice Settled') - Timestamp('Invoice Generated'). Ejemplos 32 días45 días91 días
	Última actualización de datos LastDataUpdate	Marca de tiempo de la última actualización de datos desde el sistema de origen.
Descripción Este atributo indica cuándo se extrajeron y actualizaron por última vez los datos de este proceso en la herramienta de Process Mining. Ayuda a los usuarios a conocer la actualidad de los datos que analizan y garantiza que tomen decisiones basadas en información vigente. Por qué es importante Proporciona transparencia sobre la actualidad de los datos y permite saber hasta qué punto está actualizada el análisis del proceso. Dónde obtenerlo Este valor se genera y se incorpora al conjunto de datos en el momento de la extracción. Ejemplos 2023-10-27T02:00:00Z
	Unidad de negocio BusinessUnit	Unidad de negocio o filial asociada a la transacción.
Descripción Representa la unidad de negocio, el departamento o la filial específica que emitió la factura. En las cuentas NetSuite OneWorld, normalmente corresponde al campo 'Subsidiary'. Permite segmentar el análisis del proceso por distintas partes de la organización, comparar el rendimiento e identificar problemas específicos de cada división. Por qué es importante Permite comparar el rendimiento del proceso entre distintas unidades organizativas y revelar variaciones que pueden requerir enfoques de gestión diferentes. Dónde obtenerlo En NetSuite OneWorld, es el campo 'Subsidiary'. En otras cuentas, puede ser 'Department' o 'Class', según la configuración. Ejemplos Oeste de EE. UU.Servicios EMEAProductos APAC

Obligatorio Recomendado Opcional

Actividades de gestión de crédito y cobros

Estos son los pasos cruciales y los hitos del proceso que debe capturar en su registro de eventos para descubrir con precisión y optimizar su Workflow de cobros.

5 Recomendado 8 Opcional

	Actividad	Descripción
	Factura cancelada por incobrable	Final no satisfactorio del ciclo de vida de la factura, en el que la deuda se considera incobrable y se elimina de las cuentas por cobrar. Se captura cuando se aplica a la factura un asiento contable por deuda incobrable.
Por qué es importante Este es un punto final crítico de fallo. Analizar las rutas que conducen a cancelaciones por incobrabilidad ayuda a identificar debilidades en la política crediticia y la estrategia de cobro y, en última instancia, a reducir la deuda incobrable. Dónde obtenerlo Se infiere a partir de la aplicación de un 'Journal Entry' a la factura, cuando el asiento corresponde específicamente a una cancelación por deuda incobrable. También puede utilizarse un estado personalizado. Recopilar Utilice la fecha del Journal Entry de cancelación por incobrabilidad aplicado a la factura. Tipo de evento inferred
	Factura generada	Marca la creación oficial del registro de la factura en el sistema. Este evento se captura a partir de la fecha de creación de la transacción Invoice en NetSuite y sirve como punto de inicio del ciclo de vida de la factura.
Por qué es importante Este es el evento de inicio principal del proceso Invoice-to-Cash. Es esencial para calcular métricas clave como los días de ventas pendientes de cobro (DSO) y el tiempo total de ciclo de Invoice-to-Cash. Dónde obtenerlo Este es un evento explícito capturado a partir de la fecha de creación del registro de la transacción Invoice en NetSuite, en la tabla Transaction, donde Type es 'Invoice'. Recopilar Utilice la marca de tiempo de creación del registro de la transacción Invoice. Tipo de evento explicit
	Factura liquidada	La finalización satisfactoria del ciclo de vida de la factura, en la que el saldo pendiente se reduce a cero mediante pagos y créditos aplicados. Se infiere cuando el estado de la factura cambia a 'Paid In Full'.
Por qué es importante Este es el evento final satisfactorio principal del proceso. Constituye el último dato necesario para calcular el tiempo de ciclo de Invoice-to-Cash de principio a fin. Dónde obtenerlo Se infiere a partir del cambio del campo 'Status' de la transacción Invoice a 'Paid In Full'. La marca de tiempo puede tomarse de la fecha del pago final o de la nota de crédito que cerró la factura. Recopilar Marca de tiempo de la última aplicación de pago que establece el estado 'Paid In Full'. Tipo de evento inferred
	Pago recibido	Este evento marca el momento en que se crea un pago del cliente y se aplica a una factura. Es un hito fundamental que se captura directamente del registro de transacción Customer Payment en NetSuite.
Por qué es importante Esta actividad es esencial para calcular el DSO y la tasa de pagos puntuales. Señala la recepción del efectivo y constituye una medida clave del éxito de los cobros. Dónde obtenerlo Se captura a partir de la fecha de creación del registro de transacción 'Customer Payment'. La sublista 'Apply' de este registro vincula el pago con una o varias facturas. Recopilar Utilice la fecha de transacción del registro Customer Payment. Tipo de evento explicit
	Vencimiento de la fecha límite de pago	Evento calculado que se produce cuando la fecha actual supera la fecha de vencimiento de la factura sin que esta se haya pagado por completo. Señala la transición de la factura del estado 'current' al estado 'overdue'.
Por qué es importante Este evento es un desencadenante fundamental para todas las actividades de cobro. Analizar el tiempo transcurrido después de este evento es clave para comprender la eficiencia de los cobros y la eficacia de la gestión de cobros. Dónde obtenerlo Este es un evento calculado. Se obtiene comparando la fecha actual con el campo 'Due Date' del registro de la transacción Invoice. La marca de tiempo del evento es la propia fecha de vencimiento. Recopilar La marca de tiempo corresponde al valor del campo 'Due Date' de la factura. Tipo de evento calculated
	Disputa registrada	Indica que un cliente ha impugnado formalmente la factura, lo que pausa el proceso de cobro estándar. Normalmente se infiere a partir del cambio del campo de estado de la factura al estado 'Disputed'.
Por qué es importante Este evento es el punto de inicio para medir el tiempo de resolución de disputas. Identificar las disputas frecuentes puede revelar problemas subyacentes en el proceso de facturación o ventas. Dónde obtenerlo Se infiere a partir de un registro del sistema o de un cambio con marca de tiempo del campo personalizado 'Invoice Status' a un valor como 'Disputed' o 'In Dispute'. Recopilar Marca de tiempo en la que se actualiza un campo de estado para reflejar una disputa. Tipo de evento inferred
	Disputa resuelta	Marca la resolución de la disputa de un cliente, lo que permite reanudar el proceso de cobro o liquidar la factura. Se infiere cuando el estado de la factura cambia de 'Disputed' a un estado activo.
Por qué es importante Este es el punto final para medir el tiempo de ciclo de resolución de disputas. Resolver las disputas de forma eficiente es fundamental para mantener la satisfacción del cliente y acelerar el flujo de caja. Dónde obtenerlo Se infiere a partir de un registro del sistema o de un cambio con marca de tiempo del campo personalizado 'Invoice Status' de 'Disputed' a un valor como 'Open' o 'Resolved'. Recopilar Marca de tiempo en la que se actualiza un campo de estado para mostrar la resolución. Tipo de evento inferred
	Factura enviada al cliente	Representa el momento en que la factura se comunica al cliente, normalmente por correo electrónico. A menudo se infiere a partir de los registros del sistema que realizan el seguimiento de las comunicaciones salientes relacionadas con la transacción Invoice.
Por qué es importante El seguimiento de esta actividad ayuda a identificar retrasos entre la creación de la factura y la notificación al cliente, que pueden afectar a los plazos de pago. También proporciona información sobre la eficiencia del proceso de comunicación de facturación. Dónde obtenerlo Se infiere a partir de la fecha de un correo electrónico enviado desde el registro de la factura, disponible en la subpestaña Communication > Messages de la transacción Invoice. Recopilar Utilice la marca de tiempo del registro 'Message' vinculado a la factura. Tipo de evento inferred
	Gestión de cobros iniciada	Representa el inicio de un proceso formal de gestión de cobros para una factura vencida, que puede incluir varios pasos. Se captura cuando se asigna un nivel de cobro específico a la factura.
Por qué es importante El seguimiento del inicio de la gestión formal de cobros ayuda a medir el cumplimiento y la eficacia de este proceso. Es un hito clave para analizar cómo influyen las distintas estrategias de cobro en el comportamiento de pago. Dónde obtenerlo Se infiere a partir de la fecha en que el campo 'Dunning Level' de la factura o del registro del cliente se establece por primera vez en un estado de cobro distinto de cero o inicial. Recopilar Identifique la marca de tiempo en la que cambia el campo Dunning Level. Tipo de evento inferred
	Llamada de cobro realizada	Actividad manual de cobro en la que un agente contacta con el cliente por teléfono. Este evento se captura a partir de los registros de actividad Phone Call creados por usuarios en el módulo CRM de NetSuite.
Por qué es importante Esta actividad ayuda a cuantificar el esfuerzo manual del proceso de cobro. Analizar su frecuencia y tasa de éxito es importante para optimizar la asignación de recursos y la automatización. Dónde obtenerlo Se captura a partir de la fecha de creación de un registro de actividad 'Phone Call' cuyo registro relacionado es el cliente y cuyo mensaje incluye el número de factura. Recopilar Utilice la marca de tiempo del registro de actividad Phone Call de CRM. Tipo de evento explicit
	Nota de crédito emitida	Representa la creación de una nota de crédito que se aplica a la factura, a menudo para corregir un error o como parte de la resolución de una disputa. Se trata de una transacción explícita en NetSuite.
Por qué es importante La emisión frecuente de notas de crédito puede indicar problemas sistémicos, como errores de precios o problemas de envío. Analizar su frecuencia ayuda a identificar las causas raíz de las fugas de ingresos. Dónde obtenerlo Este es un evento explícito capturado a partir de la fecha de creación del registro de transacción Credit Memo vinculado a la factura original. Recopilar Utilice la marca de tiempo de creación de la transacción Credit Memo. Tipo de evento explicit
	Pago contabilizado	Representa la fecha en la que el impacto financiero del pago se registra oficialmente en el libro mayor. Se captura a partir de la fecha de contabilización de la transacción Customer Payment.
Por qué es importante El tiempo transcurrido entre 'Payment Received' y 'Payment Posted' revela retrasos administrativos. Analizar esta demora es importante para garantizar una información financiera precisa y puntual. Dónde obtenerlo Se captura a partir del 'Posting Period' o de la fecha de transacción del impacto en el libro mayor de la transacción 'Customer Payment'. Recopilar Utilice la fecha de contabilización en el libro mayor de la transacción Customer Payment. Tipo de evento explicit
	Recordatorio de vencimiento enviado	Se envía al cliente un primer recordatorio, a menudo automatizado, sobre una factura vencida. Esta actividad suele capturarse a partir de la creación de una carta de cobro o de un evento de comunicación registrado en el módulo de gestión de cobros de NetSuite.
Por qué es importante Esta actividad es el primer paso del proceso de gestión de cobros. Analizar su frecuencia y su impacto en los pagos ayuda a evaluar la eficacia de los esfuerzos iniciales de cobro. Dónde obtenerlo Se captura a partir de la fecha de creación de un registro 'Dunning Letter' asociado a la factura y generado por NetSuite Dunning SuiteApp. Recopilar Utilice la marca de tiempo de creación del registro Dunning Letter. Tipo de evento explicit

Recomendado Opcional

Guías de extracción

Cómo obtener sus datos de NetSuite

Pasos

Inicie sesión en NetSuite: Acceda a su cuenta de NetSuite con un rol que tenga permisos para crear y ejecutar Saved Searches, así como para consultar los registros de transacciones y actividades necesarios, como Invoice, Customer Payment y Phone Call.
Vaya a Saved Searches: Diríjase a Reports > Saved Searches > All Saved Searches > New. Deberá repetir este proceso para crear varias búsquedas independientes, una por cada tipo de evento.
Cree la búsqueda base de facturas: Empiece creando una búsqueda para el evento «Invoice Generated». Seleccione «Transaction» como tipo de búsqueda. Esta búsqueda capturará la creación de la factura.
Defina los criterios de búsqueda: En la subpestaña «Criteria», configure los siguientes filtros:
- Type es Invoice.
- Main Line es true. Así obtendrá un registro por factura, no uno por cada línea.
- Date Created se encuentra dentro del periodo de análisis deseado, por ejemplo, los últimos 6 meses.
Defina los resultados de la búsqueda: En la subpestaña «Results», añada las columnas necesarias para el registro de eventos. Utilice etiquetas personalizadas que coincidan con los nombres de atributos requeridos, como InvoiceNumber. Use fórmulas para establecer el campo ActivityName. Las correspondencias detalladas de campos se proporcionan en la sección de consultas.
Cree búsquedas para otros eventos: Siguiendo las configuraciones de la sección de consultas, cree búsquedas guardadas independientes para otras actividades, como Payments, Credit Memos, Collection Calls y cambios de estado. Estas pueden utilizar otros tipos de registro, como «Phone Call», o requerir búsquedas en «System Notes».
Ejecute y exporte las búsquedas: Ejecute cada búsqueda guardada por separado. En la página de resultados, haga clic en el icono «Export - CSV» para descargar los datos. Asigne a cada archivo un nombre descriptivo, como invoice_generated.csv o payment_received.csv.
Genere los eventos «Payment Due Date Passed»: Este evento específico no se exporta directamente. Debe calcularlo después de exportar los datos. En la herramienta de manipulación de datos que prefiera, como Python, Power Query o una herramienta ETL, cree una fila para cada factura que aún no se haya pagado por completo, con ActivityName como «Payment Due Date Passed» y EventTime como DueDate más un día.
Combine los archivos exportados: Utilice una herramienta externa para apilar todos los archivos CSV exportados en un único archivo maestro. Asegúrese de que los encabezados de columna sean idénticos en todos los archivos antes de combinarlos.
Dé formato a los datos finales: Revise el archivo CSV combinado. Compruebe que EventTime tenga un formato de marca de tiempo coherente, como YYYY-MM-DD HH:MI:SS, y que todas las columnas requeridas, InvoiceNumber, ActivityName y EventTime, estén presentes en cada fila.
Cargue los datos en ProcessMind: El archivo CSV final y combinado ya está listo para cargarse como registro de eventos.

Configuración

Requisitos previos: Se necesita un rol de usuario con permisos para crear, editar y exportar Saved Searches. También es necesario acceder a los siguientes tipos de registro: Transacción para Facturas, pagos y notas de crédito; Phone Call u otros registros de actividades de CRM; y System Notes.
Tipos de registro: Los principales tipos de registro utilizados en estas búsquedas son Transacción y Phone Call. El registro System Note también se utiliza para capturar cambios de estado y eventos de comunicación cuando no existen registros de transacciones directos.
Filtrado por intervalo de fechas: Para garantizar el rendimiento y gestionar el volumen de datos, aplique de forma coherente un filtro de fecha, como Date Created o Last Modified Date, en todas las búsquedas guardadas. Para el análisis inicial, se recomienda un periodo de datos de 3 a 6 meses.
Filtro Main Line: Al buscar registros de transacciones, utilice el criterio Main Line is true para aislar la información del nivel de encabezado. Esto evita duplicar eventos para cada línea de una factura o un pago.
Uso de fórmulas: Las fórmulas de NetSuite son esenciales para crear la columna estandarizada ActivityName. Los campos Formula (Text) permiten establecer de forma fija el nombre de la actividad de cada búsqueda, mientras que Formula (Date/Time) puede utilizarse para estandarizar los campos de marca de tiempo cuando sea necesario.
Límites de exportación: Tenga en cuenta que la exportación CSV desde la interfaz de NetSuite suele estar limitada a 100.000 filas por búsqueda. Para conjuntos de datos más grandes, puede que deba ejecutar las búsquedas en intervalos de fechas más pequeños o utilizar búsquedas programadas que envíen los resultados al File Cabinet.

a Consulta de ejemplo sql

/*
This configuration outlines the setup for multiple NetSuite Saved Searches. 
Each search is designed to extract a specific activity for the event log.
Create one Saved Search in the NetSuite UI for each block defined below.
*/

// Saved Search 1: Invoice Generated
{
  "SavedSearchName": "ProcessMind - Invoice Generated",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Generated'"},
    {"Column": "EventTime", "Field": "Date Created"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 2: Invoice Sent to Customer
{
  "SavedSearchName": "ProcessMind - Invoice Sent",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "System Notes : Field", "Operator": "is", "Value": "E-mailed"},
    {"Field": "System Notes : Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Sent to Customer'"},
    {"Column": "EventTime", "Field": "System Notes : Date"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Note: 'Payment Due Date Passed' is a calculated event, generated post-export.

// Saved Search 3: Overdue Reminder Sent & Dunning Procedure Initiated
{
  "SavedSearchName": "ProcessMind - Dunning Events",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "System Notes : Field", "Operator": "is", "Value": "[Your Dunning Status Field]"},
    {"Field": "System Notes : Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "CASE WHEN {systemnotes.newvalue} = '[Your First Dunning Level]' THEN 'Dunning Procedure Initiated' ELSE 'Overdue Reminder Sent' END"},
    {"Column": "EventTime", "Field": "System Notes : Date"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 4: Collection Call Made
{
  "SavedSearchName": "ProcessMind - Collection Calls",
  "RecordType": "Phone Call",
  "Criteria": [
    {"Field": "Transaction : Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Collection Call Made'"},
    {"Column": "EventTime", "Field": "Completed Date"},
    {"Column": "InvoiceNumber", "Field": "Transaction : Document Number"},
    {"Column": "CustomerId", "Field": "Company : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Company : Category"},
    {"Column": "InvoiceAmount", "Field": "Transaction : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Transaction : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Transaction : Status"}
  ]
}

// Saved Search 5: Dispute Registered & Resolved
{
  "SavedSearchName": "ProcessMind - Dispute Status",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "System Notes : Field", "Operator": "is", "Value": "Status"},
    {"Field": "System Notes : Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "CASE WHEN {systemnotes.newvalue} LIKE '%Disputed%' THEN 'Dispute Registered' WHEN {systemnotes.oldvalue} LIKE '%Disputed%' THEN 'Dispute Resolved' ELSE NULL END"},
    {"Column": "EventTime", "Field": "System Notes : Date"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 6: Credit Memo Issued
{
  "SavedSearchName": "ProcessMind - Credit Memos",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Credit Memo"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Applied To Transaction : Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Credit Memo Issued'"},
    {"Column": "EventTime", "Field": "Date Created"},
    {"Column": "InvoiceNumber", "Field": "Applied To Transaction : Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Applied To Transaction : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Applied To Transaction : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Applied To Transaction : Status"}
  ]
}

// Saved Search 7: Payment Received & Posted
{
  "SavedSearchName": "ProcessMind - Payments",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Customer Payment"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    // For 'Payment Received'
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Payment Received'"},
    {"Column": "EventTime", "Field": "Date Created"},
    // For 'Payment Posted'
    // {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Payment Posted'"},
    // {"Column": "EventTime", "Field": "[Your GL Posting Date Field]"},
    {"Column": "InvoiceNumber", "Field": "Applied To Transaction : Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Applied To Transaction : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Applied To Transaction : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Applied To Transaction : Status"}
  ]
}

// Saved Search 8: Invoice Settled
{
  "SavedSearchName": "ProcessMind - Invoice Settled",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Status", "Operator": "anyof", "Value": "Paid In Full"},
    {"Field": "Date Closed", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Settled'"},
    {"Column": "EventTime", "Field": "Date Closed"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 9: Invoice Written Off
{
  "SavedSearchName": "ProcessMind - Invoice Written Off",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Journal Entry"},
    {"Field": "Main Line", "Operator": "is", "Value": "false"},
    {"Field": "Account", "Operator": "is", "Value": "[Your Bad Debt Expense Account]"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Written Off'"},
    {"Column": "EventTime", "Field": "Date Created"},
    {"Column": "InvoiceNumber", "Field": "Created From : Document Number"},
    {"Column": "CustomerId", "Field": "Created From : Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Created From : Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Created From : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Created From : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Created From : Status"}
  ]
}

Pasos

Requisitos previos: Asegúrese de tener Python 3.6 o una versión posterior instalado en su sistema. También necesitará credenciales para NetSuite SuiteTalk, concretamente para Token Based Authentication (TBA), que incluyen Account ID, Consumer Key, Consumer Secret, Token ID y Token Secret. El rol de NetSuite asociado debe tener permisos para acceder a todos los registros necesarios, incluidos Transactions (Invoices, Payments y Credit Memos), CRM Activities (Phone Calls) y Customer records.
Instale las bibliotecas de Python: Abra la línea de comandos o el terminal e instale las bibliotecas de Python necesarias. Las principales son pandas para manipular datos, requests y requests_oauthlib para realizar llamadas a la API, o una biblioteca específica de NetSuite. pip install pandas requests requests_oauthlib
Configure la autenticación: En el script de Python proporcionado, localice la sección de credenciales. Introduzca de forma segura su Account ID, Consumer Key, Consumer Secret, Token ID y Token Secret de NetSuite en las variables de marcador de posición correspondientes. Se recomienda utilizar variables de entorno o un almacén seguro para gestionar estas credenciales, en lugar de escribirlas directamente en el código.
Configure los parámetros de extracción: En el script, defina las variables start_date y end_date para especificar el intervalo de tiempo de la extracción de datos. También puede ajustar el filtro subsidiary_id si necesita limitar la extracción a una filial concreta de NetSuite.
Comprenda la lógica del script: El script está estructurado para consultar por separado cada una de las 13 actividades requeridas. Cada consulta es una instrucción SuiteQL independiente que se envía al endpoint de la API REST de NetSuite. El script gestiona automáticamente la paginación de la API para recuperar todos los registros de cada consulta.
Ejecute el script de Python: Ejecute el script desde el terminal con el comando python your_netsuite_extraction_script.py. El script se conectará a NetSuite, ejecutará la serie de consultas y mostrará actualizaciones de estado en la consola mientras recupera los datos de cada actividad.
Combine y transforme los datos: Después de obtener los datos sin procesar de cada actividad, el script utiliza la biblioteca pandas para concatenar todos los resultados individuales en un único DataFrame unificado. Este DataFrame representa el registro de eventos.
Revise y guarde el registro de eventos: El script guardará el DataFrame final en un archivo CSV llamado netsuite_collections_event_log.csv. Abra este archivo para revisar que los datos sean completos y precisos.
Prepare la carga: Asegúrese de que el archivo CSV final incluya los encabezados de columna requeridos: InvoiceNumber, ActivityName y EventTime, junto con los atributos recomendados. El archivo ya está listo para cargarse en ProcessMind.

Configuración

Autenticación: El script utiliza la autenticación basada en tokens (TBA) de NetSuite. Debe proporcionar el Account ID, Consumer Key, Consumer Secret, Token ID y Token Secret. El rol asociado al token necesita acceso de lectura a los registros Transaction, Customer, Phone Call y Message.
Intervalo de fechas: Las variables start_date y end_date del script controlan el periodo de extracción. Para el análisis inicial, se recomienda un periodo de 3 a 6 meses para equilibrar el volumen de datos y el rendimiento.
Filtro de subsidiaria: Se incluye una variable subsidiary_id para filtrar los datos de una unidad de negocio específica. Si opera en un entorno con una sola subsidiaria, puede omitirla.
Endpoint de API: El script utiliza el endpoint de la API REST SuiteQL de NetSuite. Asegúrese de que esté habilitado para su cuenta (/services/rest/query/v1/suiteql).
Gestión de la paginación: El script incluye una función para gestionar automáticamente las respuestas paginadas de la API. page_size está establecido en 1000, el máximo permitido por la API, para reducir al mínimo el número de llamadas necesarias.
Campos personalizados: La extracción de 'Dispute Registered' y 'Dispute Resolved' presupone el uso de campos personalizados (custbody_dispute_date, custbody_dispute_resolved_date). Debe actualizar el script con los identificadores de campo reales utilizados en su instancia de NetSuite.

a Consulta de ejemplo python

import pandas as pd
import requests
from requests_oauthlib import OAuth1
import json
import os
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
class=class="hl-string">"hl-comment"># Best practice: Use environment variables instead of hardcoding credentials.
NS_ACCOUNT = os.getenv(class="hl-string">'NS_ACCOUNT', class="hl-string">'[Your NetSuite Account ID]')
NS_CONSUMER_KEY = os.getenv(class="hl-string">'NS_CONSUMER_KEY', class="hl-string">'[Your Consumer Key]')
NS_CONSUMER_SECRET = os.getenv(class="hl-string">'NS_CONSUMER_SECRET', class="hl-string">'[Your Consumer Secret]')
NS_TOKEN_ID = os.getenv(class="hl-string">'NS_TOKEN_ID', class="hl-string">'[Your Token ID]')
NS_TOKEN_SECRET = os.getenv(class="hl-string">'NS_TOKEN_SECRET', class="hl-string">'[Your Token Secret]')

class=class="hl-string">"hl-comment"># The base URL for the SuiteQL API endpoint
BASE_URL = fclass="hl-string">"https://{NS_ACCOUNT.replace('_', '-')}.suitetalk.api.netsuite.com/services/rest/query/v1/suiteql"

class=class="hl-string">"hl-comment"># --- Extraction Parameters ---
START_DATE = class="hl-string">'2023-01-01'
END_DATE = class="hl-string">'2023-12-31'
SUBSIDIARY_ID = class="hl-string">'[Your Subsidiary ID]' class=class="hl-string">"hl-comment"># Optional: filter by subsidiary

def execute_suiteql(query):
    class="hl-string">"""Executes a SuiteQL query and handles pagination."""
    all_results = []
    offset = 0
    limit = 1000

    oauth = OAuth1(
        client_key=NS_CONSUMER_KEY,
        client_secret=NS_CONSUMER_SECRET,
        resource_owner_key=NS_TOKEN_ID,
        resource_owner_secret=NS_TOKEN_SECRET,
        realm=NS_ACCOUNT,
        signature_method=class="hl-string">'HMAC-SHA256'
    )

    headers = {
        class="hl-string">'Content-Type': class="hl-string">'application/json',
        class="hl-string">'Prefer': class="hl-string">'transient'
    }

    while True:
        paginated_query = fclass="hl-string">"{query} LIMIT {limit} OFFSET {offset}"
        payload = json.dumps({class="hl-string">'q': paginated_query})
        
        try:
            response = requests.post(BASE_URL, headers=headers, data=payload, auth=oauth)
            response.raise_for_status() class=class="hl-string">"hl-comment"># Raise an exception for bad status codes
            data = response.json()
            
            if not data.get(class="hl-string">'items'):
                break

            all_results.extend(data[class="hl-string">'items'])
            
            if not data.get(class="hl-string">'hasMore', False):
                break
            
            offset += limit

        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"API Request Error: {e}")
            print(fclass="hl-string">"Response body: {response.text if 'response' in locals() else 'No response'}")
            return None

    return all_results

def main():
    class="hl-string">"""Main function to orchestrate the data extraction."""
    all_events = []
    
    class=class="hl-string">"hl-comment"># Common WHERE clause for filtering by date and subsidiary
    common_filter = fclass="hl-string">"WHERE T.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD') AND T.subsidiary = {SUBSIDIARY_ID}"

    class=class="hl-string">"hl-comment"># --- Define SuiteQL Queries for Each Activity ---
    queries = {
        class="hl-string">'Invoice Generated': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Invoice Generated' AS ActivityName,
                TO_CHAR(T.createdDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.createdDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Invoice Sent to Customer': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Invoice Sent to Customer' AS ActivityName,
                TO_CHAR(M.messageDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Message AS M ON T.id = M.transaction
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND M.emailed = 'T' AND M.messageDate IS NOT NULL
                AND M.messageDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Payment Due Date Passed': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Payment Due Date Passed' AS ActivityName,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD"T"23:59:59"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.status NOT IN ('CustInvc:B', 'CustInvc:A') -- Not Paid In Full or Pending Approval
                AND T.dueDate < CURRENT_DATE
                AND T.dueDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Overdue Reminder Sent': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Overdue Reminder Sent' AS ActivityName,
                TO_CHAR(M.messageDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Message AS M ON T.id = M.transaction
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND (M.subject LIKE '%Overdue%' OR M.subject LIKE '%Reminder%')
                AND M.messageDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Dunning Procedure Initiated': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Dunning Procedure Initiated' AS ActivityName,
                TO_CHAR(SL.systemNoteDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
                INNER JOIN SystemNote AS SL ON T.id = SL.recordId
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND SL.field = 'custbody_dunning_level' AND SL.oldValue IS NULL -- Assumes a custom dunning level field
                AND SL.systemNoteDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Collection Call Made': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Collection Call Made' AS ActivityName,
                TO_CHAR(PC.completedDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                PhoneCall AS PC
                INNER JOIN Transaction AS T ON PC.transaction = T.id
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND PC.title LIKE '%Collection%'
                AND PC.completedDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Dispute Registered': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Dispute Registered' AS ActivityName,
                TO_CHAR(T.custbody_dispute_date, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.custbody_dispute_date IS NOT NULL -- Assumes a custom dispute date field
                AND T.custbody_dispute_date BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Dispute Resolved': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Dispute Resolved' AS ActivityName,
                TO_CHAR(T.custbody_dispute_resolved_date, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.custbody_dispute_resolved_date IS NOT NULL -- Assumes a custom dispute resolved date field
                AND T.custbody_dispute_resolved_date BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Credit Memo Issued': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Credit Memo Issued' AS ActivityName,
                TO_CHAR(CM.trandate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                CM.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS CM
                INNER JOIN TransactionLine AS CML ON CM.id = CML.transaction
                INNER JOIN Transaction AS AppliedTo ON CML.appliedToTransaction = AppliedTo.id
                INNER JOIN Customer AS C ON CM.entity = C.id
            WHERE
                CM.type = 'CustCred' AND CM.voided = 'F' AND CM.subsidiary = {SUBSIDIARY_ID}
                AND AppliedTo.type = 'CustInvc'
                AND CM.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Payment Received': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Payment Received' AS ActivityName,
                TO_CHAR(P.trandate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                P.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS P
                INNER JOIN TransactionLine AS PL ON P.id = PL.transaction
                INNER JOIN Transaction AS AppliedTo ON PL.appliedToTransaction = AppliedTo.id
                INNER JOIN Customer AS C ON P.entity = C.id
            WHERE
                P.type = 'CustPymt' AND P.voided = 'F' AND P.subsidiary = {SUBSIDIARY_ID}
                AND AppliedTo.type = 'CustInvc'
                AND P.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Payment Posted': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Payment Posted' AS ActivityName,
                TO_CHAR(P.postingdate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                P.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS P
                INNER JOIN TransactionLine AS PL ON P.id = PL.transaction
                INNER JOIN Transaction AS AppliedTo ON PL.appliedToTransaction = AppliedTo.id
                INNER JOIN Customer AS C ON P.entity = C.id
            WHERE
                P.type = 'CustPymt' AND P.voided = 'F' AND P.subsidiary = {SUBSIDIARY_ID}
                AND AppliedTo.type = 'CustInvc' AND P.posting = 'T'
                AND P.postingdate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Invoice Settled': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Invoice Settled' AS ActivityName,
                TO_CHAR(T.lastModifiedDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.status = 'CustInvc:B' -- Paid In Full
                AND T.lastModifiedDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Invoice Written Off': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Invoice Written Off' AS ActivityName,
                TO_CHAR(JE.trandate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                JE.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS JE
                INNER JOIN TransactionLine AS JEL ON JE.id = JEL.transaction
                INNER JOIN Transaction AS AppliedTo ON JEL.entity = AppliedTo.entity -- A best-effort link via customer
                INNER JOIN Customer AS C ON JE.entity = C.id
            WHERE
                JE.type = 'Journal' AND JE.voided = 'F' AND JE.subsidiary = {SUBSIDIARY_ID}
                AND JEL.account = [Your Bad Debt Expense Account ID] -- Must configure your specific bad debt account
                AND AppliedTo.type = 'CustInvc'
                AND JE.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
                AND (JEL.memo LIKE '%' || AppliedTo.tranid || '%' OR JE.memo LIKE '%' || AppliedTo.tranid || '%') -- Best-effort link by checking memo field for invoice number
        """
    }

    for activity, query in queries.items():
        print(fclass="hl-string">"Fetching data for: {activity}...")
        results = execute_suiteql(query)
        if results:
            all_events.extend(results)
            print(fclass="hl-string">"  ...found {len(results)} events.")
        else:
            print(fclass="hl-string">"  ...no events found or an error occurred.")

    if not all_events:
        print(class="hl-string">"No data extracted. Exiting.")
        return

    class=class="hl-string">"hl-comment"># Convert to pandas DataFrame
    df = pd.DataFrame(all_events)
    
    class=class="hl-string">"hl-comment"># Data Cleaning and Formatting
    df[class="hl-string">'EventTime'] = pd.to_datetime(df[class="hl-string">'EventTime'])
    df = df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'])
    df.rename(columns=lambda c: class="hl-string">''.join(c.split()).capitalize(), inplace=True)
    
    class=class="hl-string">"hl-comment"># Save to CSV
    output_file = class="hl-string">'netsuite_collections_event_log.csv'
    df.to_csv(output_file, index=False)
    print(fclass="hl-string">"\nEvent log successfully saved to {output_file}")

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

¿Listo para empezar?

Utilice este Template para agilizar la preparación de sus datos y obtener información valiosa sobre su proceso de gestión de crédito y cobros. Empiece hoy su camino hacia un flujo de caja más sólido.

Volver a la guía de mejora Descargar Template

¡Comience hoy a optimizar el crédito y los cobros!

Descubra ineficiencias, reduzca el tiempo del ciclo un 30 % y mejore rápidamente su flujo de caja.

Inicie su prueba gratuita

No necesita tarjeta de crédito y puede configurarlo en pocos minutos.

Su Template de datos para la gestión de crédito y los cobros

Su Template de datos para la gestión de crédito y los cobros

Atributos de gestión de crédito y cobros

Actividades de gestión de crédito y cobros

Guías de extracción

Exportación de datos de Saved Searches e informes de NetSuite

Pasos

Configuración

a Consulta de ejemplo sql

Extracción con Python mediante servicios web de NetSuite SuiteTalk

Pasos

Configuración

a Consulta de ejemplo python

¿Listo para empezar?

¡Comience hoy a optimizar el crédito y los cobros!

Su Template de datos para la gestión de crédito y los cobros

Su Template de datos para la gestión de crédito y los cobros

Atributos de gestión de crédito y cobros

Actividades de gestión de crédito y cobros

Guías de extracción

Exportación de datos de Saved Searches e informes de NetSuite

Pasos

Configuración

a Consulta de ejemplo sql

Extracción con Python mediante servicios web de NetSuite SuiteTalk

Pasos

Configuración

a Consulta de ejemplo python

¿Listo para empezar?

¡Comience hoy a optimizar el crédito y los cobros!

Valoramos su privacidad