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

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

NetSuite

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

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

Este Template ofrece una guía completa para recopilar los datos adecuados y analizar el proceso de gestión del crédito y los cobros. Describe los atributos y las actividades esenciales, junto con indicaciones prácticas para extraer los datos, para que pueda empezar rápidamente. Si sigue estas recomendaciones, podrá preparar los datos para realizar un análisis útil del proceso e identificar mejoras.

Atributos recomendados para recopilar
Actividades clave que debe registrar
Instrucciones para extraer datos de NetSuite

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

Descargar Template

Atributos de gestión del crédito y los cobros

Estos son los campos de datos recomendados para incluir en el Registro de eventos y analizar a fondo el proceso de gestión del crédito y los 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 registra la fecha y hora exactas de cada actividad del proceso. Es fundamental para todos los análisis basados en el tiempo, incluidos los cálculos de tiempos de ciclo, duraciones y esperas entre pasos. En NetSuite, esta marca de tiempo suele corresponder a la fecha de creación o de última modificación del registro pertinente o de la nota del sistema. 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, fundamentales para analizar la eficiencia. Dónde obtenerlo Se obtiene de los campos de fecha de distintos registros. Por ejemplo, de 'Date Created' en un registro Invoice para 'Factura generada', o de 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 de negocio que tuvo lugar en un momento determinado.
Descripción Este atributo describe un paso o evento específico del proceso de gestión del crédito y cobros, como 'Factura generada', 'Pago recibido' o 'Disputa registrada'. Analizar la secuencia y la frecuencia de estas actividades es la base de Process Mining, ya que permite conocer 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 (por ejemplo, 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 pago vencido enviadoPago recibidoFactura castigada
	Número de factura InvoiceNumber	Identificador único de cada factura de cliente.
Descripción El número de factura es el identificador principal del caso y vincula de forma única todas las actividades relacionadas con una cuenta por cobrar específica. Esto permite analizar todo su ciclo de vida, desde la creación de la factura y las acciones posteriores de gestión del crédito hasta el pago o la resolución mediante gestiones de cobro. En NetSuite, suele corresponder 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 emisión hasta su liquidación y analizar el proceso de principio a fin. Dónde obtenerlo Suele ser 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 'Abierta', 'Pagada en su totalidad' o 'Vencida'. Permite filtrar y analizar las facturas que siguen activas o presentan problemas. El Dashboard 'Antigüedad y estado de las facturas vencidas' utiliza este atributo para ofrecer una vista de las cuentas por cobrar pendientes. Por qué es importante Permite filtrar el análisis y centrarse en etapas específicas del ciclo de vida de la factura, como las facturas abiertas, vencidas o en disputa. Dónde obtenerlo Corresponde al campo 'Status' (ID interno: status) del registro de la 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 de pago acordada en el contrato. Sirve de referencia para determinar si un pago se realiza a tiempo o está vencido. Este atributo es esencial para calcular KPI como la 'Tasa de pagos puntuales' y activar las gestiones de reclamación una vez vencida la factura. Por qué es importante Es la referencia principal para medir la puntualidad de los pagos y resulta clave para calcular los días de atraso y supervisar el cumplimiento de las condiciones de pago. Dónde obtenerlo Es el campo 'Due Date' (ID interno: duedate) del registro de la 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 entre distintos clientes o grupos. Por ejemplo, permite comparar el comportamiento de pago o las tasas de disputa de las cuentas estratégicas con los de las pequeñas empresas. Por qué es importante Permite analizar los procesos desde la perspectiva del cliente y detectar quiénes suelen pagar tarde, presentar disputas o seguir procesos no estándar. Dónde obtenerlo Es el campo 'Customer' (ID interno: entity) del registro de la transacción Invoice. Ejemplos CUST001CUST002CUST003
	Importe de la factura InvoiceAmount	Valor monetario total de la factura.
Descripción Indica el importe total pendiente de pago de la factura. Es un atributo financiero clave para casi todos los análisis, como medir el impacto económico de los pagos atrasados o analizar los castigos de facturas de alto valor. Aporta contexto esencial para priorizar las gestiones de cobro. Por qué es importante Aporta contexto financiero al proceso y permite analizarlo según el valor monetario, por ejemplo, para priorizar el cobro de facturas vencidas de alto valor. Dónde obtenerlo Es el campo 'Amount (Total)' (ID interno: total) del registro de la transacción Invoice. Ejemplos 1500.00250.5012500.75
	Segmento de clientes CustomerSegment	Clasificación del cliente, por ejemplo, según su tamaño, sector o región.
Descripción El segmento de clientes agrupa a los clientes en categorías útiles (por ejemplo, 'Empresas', 'Pymes' o 'Sector público'). Este atributo es fundamental para el Dashboard 'Rendimiento de la estrategia de cobro por segmento', ya que permite comparar la eficacia de distintos enfoques de cobro en cada segmento. También ayuda a adaptar las estrategias al comportamiento 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 EmpresasEmpresas medianasSMB
	Condiciones de pago PaymentTerms	Condiciones de pago acordadas con el cliente para la factura.
Descripción Este atributo especifica las condiciones en las que se espera que el cliente pague una factura, como '30 días netos' o '60 días netos'. Sirve de base para calcular la fecha de vencimiento y es fundamental para el Dashboard 'Cumplimiento y desviaciones de las condiciones de pago', que analiza si los clientes respetan las condiciones acordadas. Por qué es importante Establece la base contractual de los calendarios de pago y es esencial para analizar el cumplimiento y detectar desviaciones que afectan al flujo de caja. Dónde obtenerlo Es el campo 'Terms' (ID interno: terms) del registro de la transacción Invoice. Ejemplos 30 días netos60 días netosVencimiento al recibir la factura
	Días de atraso DaysOverdue	Número de días que han transcurrido desde el vencimiento de una factura.
Descripción Esta métrica calculada mide los días transcurridos entre la fecha de vencimiento de la factura y la fecha actual, si sigue pendiente, o la fecha de pago. Es un KPI fundamental para los cobros y se utiliza en el Dashboard «Antigüedad y estado de las facturas vencidas» para clasificar y priorizar las gestiones 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 gestiones de cobro. Dónde obtenerlo Se calcula durante la transformación de datos: (fecha actual o fecha de pago) - fecha de vencimiento. Ejemplos 1532090
	Es automatizada IsAutomated	Indicador que señala si un sistema realizó una actividad automáticamente.
Descripción Este atributo booleano indica si un flujo de trabajo automatizado o una persona usuaria ejecutó la actividad. Por ejemplo, el envío de un recordatorio de vencimiento podría automatizarse, mientras que una llamada de cobro sería manual. Este dato es esencial para el Dashboard «Frecuencia e impacto de las actividades manuales», que permite cuantificar el nivel de automatización e identificar oportunidades para ampliarla. Por qué es importante Ayuda a cuantificar el nivel de automatización del proceso y respalda las iniciativas para reducir el trabajo manual y mejorar la eficiencia. Dónde obtenerlo Este atributo se deriva del tipo de actividad o de la persona usuaria que la realizó. Por ejemplo, si la actividad la realizó un usuario designado como «SYSTEM», 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. Permite analizar la distribución de la carga de trabajo y el rendimiento del equipo, así como detectar necesidades de formación. En las actividades automatizadas, puede corresponder al ID de un usuario del sistema. Por qué es importante Permite analizar el rendimiento por usuario o equipo, comprender cómo se distribuye la carga de trabajo y detectar dónde se realizan intervenciones manuales. Dónde obtenerlo Se obtiene de campos como 'Creado por', 'Modified By' o un campo 'Owner' específico de las transacciones o los registros relacionados (por ejemplo, el registro Phone Call de las llamadas de cobro). Ejemplos j.doea.smithSYSTEM
	Motivo de la disputa DisputeReason	Motivo indicado por el cliente para disputar una factura.
Descripción Cuando un cliente disputa una factura, este atributo registra el motivo, como 'Precio incorrecto', 'Mercancía dañada' o 'Facturación duplicada'. Es fundamental para los Dashboards 'Tiempo de resolución de disputas de facturas' y 'Análisis de las causas de fondo de los castigos de facturas', ya que permite entender por qué surgen las disputas y detectar patrones que pueden corregirse para evitar problemas futuros. Por qué es importante Ayuda a identificar las causas de fondo de las disputas de los clientes y aporta la información necesaria para mejorar procesos anteriores, como la preparación de pedidos o la precisión de la facturación. Dónde obtenerlo Probablemente sea un campo personalizado del registro Invoice o de un registro personalizado relacionado que se utiliza para hacer seguimiento de los casos de disputa. No es un campo estándar de NetSuite. Ejemplos Cantidad incorrectaDiscrepancia en el 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 responsable de gestionar una factura vencida. Permite analizar el rendimiento del equipo de cobros y comprender cómo se distribuye la carga de trabajo y qué eficacia tiene cada agente. Sirve de apoyo para KPI como la 'Tasa de éxito de los contactos de cobro'. 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 puntual 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 «Porcentaje de pagos puntuales» y facilita el filtrado y el análisis de los pagos puntuales y atrasados. El resultado es claro y binario. Por qué es importante Ofrece una métrica sencilla y binaria para evaluar el cumplimiento de las condiciones de pago y facilita el cálculo y la comparación del porcentaje de pagos puntuales. 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	El 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 diferencias geográficas en el comportamiento de pago, la eficacia de los cobros y las tasas de disputas. Esta información puede ayudar a adaptar las estrategias de cobro a cada región y a comprender el impacto de las condiciones económicas locales. Por qué es importante Permite segmentar el proceso por ubicación geográfica y detectar diferencias regionales en el comportamiento de pago o la eficiencia del proceso. Dónde obtenerlo Este dato proviene de los detalles de «Billing Address» de la transacción Invoice, que normalmente se heredan del registro del cliente. 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 «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 flujo de caja. Por qué es importante Pone de manifiesto los retrasos internos en la aplicación de cobros, que pueden afectar la precisión de los informes financieros y el estado de las cuentas de los clientes. Dónde obtenerlo Se calcula en la herramienta de Process Mining: Timestamp('Pago registrado') - Timestamp('Pago recibido'). 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 siempre será 'NetSuite', pero es un atributo obligatorio para la gobernanza de datos y para distinguir las fuentes en entornos con varios sistemas. Por qué es importante Garantiza la trazabilidad y el linaje de los datos, aspectos importantes para validarlos y gestionarlos, especialmente en entornos con varios sistemas integrados. Dónde obtenerlo Es un valor estático ('NetSuite') que se añade durante la transformación de los datos. Ejemplos NetSuite
	Tiempo de ciclo de factura a cobro InvoiceToCashCycleTime	Tiempo total desde la generación de la factura hasta su liquidación final.
Descripción Esta métrica calculada mide el tiempo transcurrido entre las actividades «Factura generada» y «Factura liquidada». Representa el rendimiento integral del proceso de gestión del crédito y cobros. Analizar este KPI ayuda a identificar retrasos sistémicos y ofrece una medida general de la velocidad del flujo de caja. Por qué es importante Este KPI clave ofrece una medida general de la eficiencia de todo el proceso, desde la factura hasta el cobro. Dónde obtenerlo Se calcula para cada caso en la herramienta de Process Mining: Timestamp('Factura liquidada') - Timestamp('Factura generada'). Ejemplos 32 días45 días91 días
	Última actualización de los 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 saber si los datos analizados están actualizados y permite tomar decisiones con información vigente. Por qué es importante Ofrece transparencia sobre la vigencia de los datos y permite saber qué tan actualizados están los análisis del proceso. Dónde obtenerlo Este valor se genera y se añade al conjunto de datos durante la extracción. Ejemplos 2023-10-27T02:00:00Z
	Unidad de negocio BusinessUnit	La unidad de negocio o filial asociada a la transacción.
Descripción Representa la unidad de negocio, el departamento o la filial que emitió la factura. En las cuentas de NetSuite OneWorld, suele corresponder al campo «Subsidiary». Permite segmentar el análisis del proceso por las distintas áreas de la organización, comparar su rendimiento e identificar problemas específicos de cada división. Por qué es importante Permite comparar el rendimiento del proceso entre distintas unidades de la organización e identificar variaciones que podrían requerir diferentes enfoques de gestión. Dónde obtenerlo En NetSuite OneWorld, corresponde al campo «Subsidiary». En otras cuentas, puede ser «Department» o «Class», según la configuración. Ejemplos Oeste de EE. UU.Servicios de EMEAProductos de APAC

Obligatorio Recomendado Opcional

Actividades de gestión del crédito y los cobros

Estos son los pasos y los hitos clave del proceso que debe registrar en el Registro de eventos para descubrir y optimizar con precisión el flujo de trabajo de cobros.

5 Recomendado 8 Opcional

	Actividad	Descripción
	Factura castigada	Indica que el ciclo de vida de la factura termina sin éxito: la deuda se considera incobrable y se elimina de las cuentas por cobrar. Se registra cuando se aplica a la factura un asiento contable por deuda incobrable.
Por qué es importante Este es un punto final crítico de fracaso. Analizar las rutas que llevan al castigo de deuda ayuda a detectar deficiencias en la política crediticia y la estrategia de cobro, y a reducir la deuda incobrable. Dónde obtenerlo Se infiere de la aplicación de un 'Journal Entry' a la factura, cuando el asiento corresponde específicamente al castigo de una deuda incobrable. También puede utilizarse un estado personalizado. Capturar Utilice la fecha del asiento contable de castigo aplicado a la factura. Tipo de evento inferred
	Factura generada	Indica la creación oficial del registro de la factura en el sistema. Este evento se obtiene de la fecha de creación de la transacción de factura en NetSuite y marca el inicio de su ciclo de vida.
Por qué es importante Este es el evento de inicio principal del proceso de factura a cobro. Es esencial para calcular métricas clave como los días pendientes de cobro (DSO) y el tiempo de ciclo total de factura a cobro. Dónde obtenerlo Este evento explícito se obtiene de la fecha de creación del registro de la transacción de factura en NetSuite (tabla Transaction, donde Type es 'Invoice'). Capturar Utilice la marca de tiempo de creación del registro de la transacción de factura. Tipo de evento explicit
	Factura liquidada	Indica que el ciclo de vida de la factura ha concluido correctamente: el saldo pendiente se reduce a cero mediante pagos y los créditos aplicados. Se infiere cuando el estado de la factura cambia a 'Paid In Full'.
Por qué es importante Este es el evento de fin principal del proceso cuando se completa correctamente. Es el último dato necesario para calcular el tiempo de ciclo integral de factura a cobro. Dónde obtenerlo Se infiere cuando el campo 'Status' de la transacción de factura cambia a 'Paid In Full'. La marca de tiempo puede corresponder a la fecha del último pago o nota de crédito que liquidó la factura. Capturar 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 indica cuándo se crea un pago del cliente y se aplica a una factura. Es un hito clave que se obtiene directamente del registro de la transacción Customer Payment en NetSuite.
Por qué es importante Esta actividad es fundamental para calcular los días pendientes de cobro (DSO) y la tasa de pagos puntuales. Indica la recepción del dinero y es una medida clave del éxito de los cobros. Dónde obtenerlo Se obtiene de la fecha de creación del registro de la transacción 'Customer Payment'. La sublista 'Apply' de este registro vincula el pago con una o varias facturas. Capturar Utilice la fecha de la transacción del registro Customer Payment. Tipo de evento explicit
	Vencimiento de la fecha de pago	Evento calculado que se produce cuando la fecha actual supera la fecha de vencimiento de la factura y esta aún no se ha pagado por completo. Indica que la factura pasa del estado 'vigente' al estado 'vencido'.
Por qué es importante Este evento es un desencadenante clave de todas las actividades de cobro. Analizar el tiempo transcurrido desde este momento es fundamental para entender la eficiencia de los cobros y de las reclamaciones de pago. Dónde obtenerlo Este es un evento calculado. Se obtiene al comparar la fecha actual con el campo 'Due Date' del registro de la transacción de factura. La marca de tiempo del evento es la propia fecha de vencimiento. Capturar La marca de tiempo corresponde al valor del campo 'Due Date' de la factura. Tipo de evento calculated
	Disputa registrada	Indica que el cliente ha presentado una disputa formal sobre la factura, lo que detiene el proceso de cobro habitual. Suele inferirse cuando el campo de estado de la factura cambia al estado 'Disputed'.
Por qué es importante Este evento marca el inicio de la medición del tiempo de resolución de disputas. Detectar disputas frecuentes puede revelar problemas de fondo en los procesos de facturación o ventas. Dónde obtenerlo Se infiere de un registro del sistema o de un cambio con marca de tiempo en un campo personalizado 'Invoice Status' a un valor como 'Disputed' o 'In Dispute'. Capturar Marca de tiempo en que se actualiza un campo de estado para indicar una disputa. Tipo de evento inferred
	Disputa resuelta	Indica que se resolvió la disputa del 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. Resolverlas con eficiencia es fundamental para mantener la satisfacción del cliente y acelerar el flujo de caja. Dónde obtenerlo Se infiere de un registro del sistema o de un cambio con marca de tiempo en un campo personalizado 'Invoice Status' de 'Disputed' a un valor como 'Open' o 'Resolved'. Capturar Marca de tiempo en que se actualiza un campo de estado para indicar que la disputa se resolvió. Tipo de evento inferred
	Factura enviada al cliente	Indica cuándo se comunicó la factura al cliente, normalmente por correo electrónico. Suele inferirse a partir de los registros del sistema que registran las comunicaciones salientes relacionadas con la transacción de factura.
Por qué es importante El seguimiento de esta actividad ayuda a detectar retrasos entre la creación de la factura y el aviso al cliente, que pueden afectar los plazos de pago. También permite evaluar la eficiencia de las comunicaciones de facturación. Dónde obtenerlo Se infiere de la fecha de un correo electrónico enviado desde el registro de la factura, en la subpestaña Communication > Messages de la transacción de factura. Capturar Utilice la marca de tiempo del registro 'Message' vinculado a la factura. Tipo de evento inferred
	Inicio del procedimiento de reclamación	Indica el inicio de un proceso formal de reclamación o cobro de una factura vencida, que puede incluir varios pasos. Se registra cuando se asigna un nivel de reclamación específico a la factura.
Por qué es importante El seguimiento del inicio de las reclamaciones formales permite medir el cumplimiento y la eficacia del proceso. Es un hito clave para analizar cómo influyen las distintas estrategias de reclamación en los pagos. Dónde obtenerlo Se infiere de la fecha en que el campo 'Dunning Level' de la factura o del registro del cliente se establece por primera vez en un valor distinto de cero o en un estado inicial de reclamación. Capturar Identifique la marca de tiempo en que cambia el campo Dunning Level. Tipo de evento inferred
	Llamada de cobro realizada	Actividad manual de cobro en la que un agente se comunica con el cliente por teléfono. Este evento se obtiene de los registros de actividad Phone Call creados por usuarios en el módulo CRM de NetSuite.
Por qué es importante Esta actividad permite cuantificar el esfuerzo manual dedicado a los cobros. Analizar su frecuencia y tasa de éxito es importante para optimizar la asignación de recursos y la automatización. Dónde obtenerlo Se obtiene de la fecha de creación de un registro de actividad 'Phone Call' cuyo registro relacionado es el cliente y cuyo mensaje hace referencia al número de factura. Capturar Utilice la marca de tiempo del registro de actividad Phone Call de CRM. Tipo de evento explicit
	Nota de crédito emitida	Indica la creación de una nota de crédito aplicada a la factura, a menudo para corregir un error o como parte de la resolución de una disputa. En NetSuite, corresponde a una transacción explícita.
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 cuándo se producen ayuda a identificar las causas de fondo de las pérdidas de ingresos. Dónde obtenerlo Este evento explícito se obtiene de la fecha de creación del registro de la transacción Credit Memo vinculado a la factura original. Capturar Utilice la marca de tiempo de creación de la transacción Credit Memo. Tipo de evento explicit
	Pago contabilizado	Indica la fecha en que el efecto financiero del pago se registra oficialmente en el libro mayor. Se obtiene de la fecha de contabilización de la transacción Customer Payment.
Por qué es importante El tiempo transcurrido entre 'Pago recibido' y 'Pago contabilizado' revela retrasos administrativos. Analizar esta demora es importante para garantizar que la información financiera sea precisa y oportuna. Dónde obtenerlo Se obtiene del campo 'Posting Period' o de la fecha de la transacción en el impacto en el libro mayor de la transacción 'Customer Payment'. Capturar Utilice la fecha de contabilización en el libro mayor de la transacción Customer Payment. Tipo de evento explicit
	Recordatorio de pago vencido enviado	Se envía al cliente un primer recordatorio, a menudo automatizado, sobre una factura vencida. Esta actividad suele registrarse al crear una carta de reclamación o un evento de comunicación en el módulo de reclamaciones de NetSuite.
Por qué es importante Esta actividad es el primer paso del proceso de reclamación de pagos. Analizar su frecuencia y su efecto en los pagos ayuda a evaluar la eficacia de las primeras gestiones de cobro. Dónde obtenerlo Se obtiene de la fecha de creación de un registro 'Dunning Letter' asociado a la factura y generado por NetSuite Dunning SuiteApp. Capturar 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 permita crear y ejecutar búsquedas guardadas, así como consultar los registros de transacciones y actividades necesarios (por ejemplo, Factura, Pago de cliente y Llamada telefónica).
Vaya a Búsquedas guardadas: Seleccione Reports > Saved Searches > All Saved Searches > New. Repita este proceso para crear varias búsquedas distintas, una por cada tipo de evento.
Cree la búsqueda base de facturas: Empiece por crear una búsqueda para el evento «Factura emitida». Seleccione «Transacción» 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», establezca los siguientes filtros:
- Tipo es Factura.
- Main Line es true. Así obtendrá un registro por factura, no uno por cada línea.
- Date Created corresponde al periodo que desea analizar, por ejemplo, los últimos 6 meses.
Defina los resultados de 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 (por ejemplo, InvoiceNumber). Use fórmulas para asignar un valor al campo ActivityName. En la sección de consultas encontrará las correspondencias detalladas entre campos.
Cree búsquedas para otros eventos: Siga las configuraciones de la sección de consultas y cree búsquedas guardadas independientes para otras actividades, como pagos, notas de crédito, llamadas de cobro y cambios de estado. Algunas pueden utilizar otros tipos de registro, como «Phone Call», o requerir una búsqueda 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 (por ejemplo, invoice_generated.csv, payment_received.csv).
Genere los eventos «Fecha de vencimiento del pago superada»: Este evento no se exporta directamente; debe calcularse 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. Asigne a ActivityName el valor «Fecha de vencimiento del pago superada» y a EventTime la fecha de vencimiento (DueDate) más un día.
Combine los archivos exportados: Utilice una herramienta externa para unir todos los archivos CSV exportados en un único archivo maestro. Antes de combinarlos, compruebe que todos tengan los mismos encabezados de columna.
Dé formato final a los datos: Revise el archivo CSV combinado. Compruebe que EventTime tenga un formato de marca de tiempo uniforme (por ejemplo, YYYY-MM-DD HH:MI:SS) y que todas las filas incluyan las columnas requeridas (InvoiceNumber, ActivityName, EventTime).
Cargue los datos en ProcessMind: El archivo CSV 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 búsquedas guardadas. También se requiere acceso a estos tipos de registro: Transacción (para facturas, pagos y notas de crédito), Phone Call (u otros registros de actividad de CRM) y System Notes.
Tipos de registro: Los principales tipos de registro utilizados en estas búsquedas son Transaction y Phone Call. También se utiliza el registro System Note para capturar cambios de estado y eventos de comunicación cuando no hay registros de transacción directos disponibles.
Filtro por intervalo de fechas: Para mantener un buen rendimiento y controlar el volumen de datos, aplique siempre un filtro de fecha (por ejemplo, Date Created o Last Modified Date) a todas las búsquedas guardadas. Para el análisis inicial, se recomienda utilizar datos de un período de 3 a 6 meses.
Filtro Main Line: Al buscar registros de transacciones, utilice el criterio Main Line is true para obtener la información de nivel de encabezado. Así evitará duplicar los eventos por cada partida 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 asignar un nombre de actividad fijo a cada búsqueda, y puede usar Formula (Date/Time) para estandarizar los campos de marca de tiempo, si es necesario.
Límites de exportación: Tenga en cuenta que la exportación de CSV desde la interfaz de NetSuite suele estar limitada a 100.000 filas por búsqueda. Para conjuntos de datos más grandes, puede ejecutar las búsquedas en intervalos de fechas más cortos o programarlas para que envíen los resultados al File Cabinet.

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: Compruebe que tenga Python 3.6 o una versión posterior instalado en su sistema. También necesitará credenciales de NetSuite SuiteTalk para la autenticación basada en tokens (TBA): ID de cuenta, Consumer Key, Consumer Secret, Token ID y Token Secret. El rol de NetSuite asociado debe tener permisos para acceder a todos los registros necesarios, incluidas las transacciones (facturas, pagos y notas de crédito), las actividades de CRM (llamadas telefónicas) y los registros de clientes.
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 y requests y requests_oauthlib para realizar llamadas a la API. También puede utilizar 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 el ID de cuenta, Consumer Key, Consumer Secret, Token ID y Token Secret de NetSuite en las variables correspondientes. Se recomienda gestionar estas credenciales con variables de entorno o un almacén seguro, en lugar de escribirlas directamente en el código.
Configure los parámetros de extracción: Defina las variables start_date y end_date en el script para especificar el intervalo de extracción de datos. También puede ajustar el filtro subsidiary_id si necesita limitar la extracción a una filial específica de NetSuite.
Comprenda la lógica del script: El script consulta 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á las consultas y mostrará actualizaciones de estado en la consola mientras recupera los datos de cada actividad.
Combine y transforme los datos: Después de recuperar los datos sin procesar de cada actividad, el script utiliza la biblioteca pandas para concatenar todos los resultados en un único DataFrame. 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 el archivo para comprobar que los datos estén completos y sean precisos.
Prepare los datos para cargarlos: Compruebe que el archivo CSV final incluya los encabezados de columna requeridos: InvoiceNumber, ActivityName y EventTime, además de 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 ID de cuenta, 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 período de extracción. Para el análisis inicial, se recomienda un período de 3 a 6 meses, a fin de equilibrar el volumen de datos y el rendimiento.
Filtro por filial: La variable subsidiary_id permite filtrar los datos de una unidad de negocio específica. Si su entorno tiene una sola filial, puede omitir este filtro.
Endpoint de la API: El script utiliza el endpoint de la API REST SuiteQL de NetSuite. Compruebe que esté habilitado en 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. El valor de page_size es 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 «Disputa registrada» y «Disputa resuelta» presupone el uso de los campos personalizados custbody_dispute_date y custbody_dispute_resolved_date. Actualice el script con los ID de campo que utiliza su instancia de NetSuite.

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()

¿Todo listo para empezar?

Utilice este Template para simplificar la preparación de los datos y obtener información útil sobre el proceso de gestión del crédito y los cobros. Empiece hoy a mejorar el flujo de caja.

Volver a la guía de mejora

Descargar Template

¡Comience hoy a optimizar la gestión del crédito y los cobros!

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

Comience su prueba gratuita

No se requiere tarjeta de crédito; la configuración lleva solo unos minutos.

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

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

Atributos de gestión del crédito y los cobros

Actividades de gestión del crédito y los cobros

Guías de extracción

Exportación de datos de búsquedas guardadas e informes de NetSuite

Pasos

Configuración

Consulta de ejemplo sql

Extracción con Python mediante los servicios web de NetSuite SuiteTalk

Pasos

Configuración

Consulta de ejemplo python

¿Todo listo para empezar?

¡Comience hoy a optimizar la gestión del crédito y los cobros!