> Mejora continua de procesos > Cuentas por cobrar > NetSuite > Template de datos

Su Template de datos de cuentas por cobrar

NetSuite

Atributos de cuentas por cobrar (22) Actividades de cuentas por cobrar (13) Guías de extracción (3)

Su Template de datos de cuentas por cobrar

Esta plantilla ofrece un modelo completo para mapear su ciclo de facturación y cobros en NetSuite. Describe los atributos y las actividades de proceso esenciales para crear un registro de eventos de alta calidad y garantizar la visibilidad necesaria para optimizar su flujo de caja. Al seguir esta guía, puede simplificar la preparación de sus datos y avanzar más rápido hacia la reducción de los días de ventas pendientes de cobro.

Atributos esenciales de NetSuite para un análisis profundo
Hitos estandarizados para el seguimiento de actividades de cuentas por cobrar
Guía estratégica de extracción para sistemas NetSuite

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

Descargar Template

Atributos de cuentas por cobrar

La siguiente tabla enumera los campos de datos y los atributos dimensionales recomendados necesarios para ofrecer una visión completa de los ciclos de vida de sus facturas en NetSuite.

5 Obligatorio 7 Recomendado 10 Opcional

	Nombre	Descripción
	Actividad Activity	El evento o la acción específica realizada en la factura.
Descripción Este atributo representa el nombre del paso del proceso, como «Invoice Created», «Payment Applied» o «Dispute Opened». En NetSuite, normalmente se obtiene del campo `type` de la transacción para los eventos de creación, o de la tabla `SystemNote` para los cambios de estado y las modificaciones. Es fundamental para Process Mining, ya que define los nodos del mapa de procesos. Al analizar la secuencia de estas actividades, los analistas pueden identificar cuellos de botella, bucles, como la gestión repetida de disputas, y desviaciones de la ruta estándar. Por qué es importante Define los pasos del Workflow y permite construir el grafo del proceso. Dónde obtenerlo Derivado de «type» de Transaction o de «field»/«value» de SystemNote Ejemplos Factura creadaPago recibidoNota de crédito emitidaDisputa abierta
	Marca de tiempo del evento DateCreated	La fecha y hora exactas en que tuvo lugar la actividad.
Descripción Este atributo registra el momento exacto en que tuvo lugar un evento. Para la creación de la factura, corresponde al campo `datecreated` de la tabla Transaction. Para las actualizaciones posteriores, corresponde a la marca de tiempo de las tablas `SystemNote` o `Message`. Las marcas de tiempo precisas son fundamentales para calcular los tiempos de ciclo, como el tiempo medio del ciclo de factura a cobro y el plazo de emisión de facturas. Permiten ordenar correctamente los eventos e identificar retrasos entre pasos específicos del proceso. Por qué es importante Esencial para ordenar eventos y calcular métricas de duración entre los pasos del proceso. Dónde obtenerlo Transacción «datecreated» o SystemNote «date» Ejemplos 2023-10-15T08:30:00Z2023-10-15T14:45:22Z2023-11-01T09:00:00Z
	Número de factura TranId	Número de referencia único asignado a la factura en NetSuite.
Descripción Este atributo actúa como identificador principal del caso para el proceso de cuentas por cobrar. En NetSuite, el campo `tranid` suele contener el número de documento, por ejemplo, INV-10023, visible para usuarios y clientes. Vincula todos los eventos posteriores, como pagos, disputas y abonos, con una obligación financiera específica. En el análisis, este identificador se utiliza para agrupar eventos individuales en un único caso de proceso. Permite visualizar de principio a fin el ciclo de pedido a cobro y es esencial para combinar datos de distintas tablas de NetSuite, como `Transacción`, `TransactionLine` y `SystemNote`. Por qué es importante Es la clave fundamental para realizar el seguimiento del ciclo de vida de una cuenta por cobrar y calcular los tiempos de ciclo. Dónde obtenerlo Tabla Transaction, campo «tranid» Ejemplos INV-2023-001INV-998822CM-4022JE-10023
	Sistema de origen SourceSystem	El sistema de registro del que se extrajeron los datos.
Descripción Este atributo identifica el origen de los datos, que en este contexto es «NetSuite». En entornos con varios sistemas, donde los datos de cuentas por cobrar pueden combinarse con los de un CRM o un sistema bancario externo, este campo garantiza la trazabilidad. Permite a los analistas filtrar o segmentar la vista del proceso por fuente de datos cuando se analizan varios ERP simultáneamente. Normalmente es un valor estático que se añade durante el proceso de extracción y transformación. Por qué es importante Proporciona el linaje de los datos y el contexto necesario en implementaciones de Process Mining con varios sistemas. Dónde obtenerlo Valor estático «NetSuite» Ejemplos NetSuiteNetSuite ERPNetSuite OneWorld
	Última actualización de datos LastDataUpdate	La marca de tiempo de la extracción o de la última actualización de los datos.
Descripción Este atributo indica cuándo se tomó la instantánea de datos de NetSuite. Se utiliza para determinar la actualidad del análisis y calcular la antigüedad de los casos abiertos con respecto a la fecha del análisis. En los Dashboards, ayuda a comprender si se están consultando datos en tiempo real o una extracción histórica. Actúa como punto de referencia para calcular las duraciones abiertas actuales de las facturas que aún no se han compensado. Por qué es importante Garantiza la transparencia sobre la actualidad de los datos y ayuda a calcular las duraciones en curso de los casos abiertos. Dónde obtenerlo Hora del sistema en la extracción Ejemplos 2023-12-01T00:00:00Z2023-12-02T12:00:00Z
	Departamento Department	El departamento interno responsable de la transacción.
Descripción Este atributo se corresponde con el segmento `department` de NetSuite e indica qué área funcional, por ejemplo, Ventas, Servicios o TI, generó la factura. Permite analizar el rendimiento de las cuentas por cobrar entre distintas funciones. Al segmentar los datos por departamento, los analistas pueden identificar si determinadas áreas operativas tienden a presentar ciclos de facturación más lentos o tasas de disputa más elevadas, lo que facilita mejoras específicas del proceso. Por qué es importante Identifica a los responsables internos del proceso y muestra diferencias en la eficiencia de facturación. Dónde obtenerlo Tabla Transaction, campo «department» Ejemplos Servicios profesionalesVentas de softwareGestión de entregas de hardware
	Estado de la factura Status	El estado actual de la factura en el sistema.
Descripción Este atributo refleja el estado de la transacción en NetSuite, como «Open», «Paid In Full» o «Pending Approval». Normalmente se obtiene del campo `status` o `statusRef`. Mientras que el atributo Actividad registra el historial de lo ocurrido, este atributo proporciona una instantánea del estado actual. Es esencial para filtrar el panel de riesgo de cobro de importes elevados y mostrar únicamente los elementos abiertos y vencidos. Por qué es importante Proporciona visibilidad inmediata sobre los casos cerrados y los que requieren atención. Dónde obtenerlo Tabla Transaction, campo «status» Ejemplos Pagado en su totalidadAbiertoPendiente de aprobación
	Fecha de vencimiento DueDate	La fecha en la que se espera recibir el pago según las condiciones acordadas.
Descripción Este atributo contiene la fecha de vencimiento programada de la factura, que se encuentra en el campo `duedate` de NetSuite. Es la referencia para determinar si un pago se realiza a tiempo o con retraso. Es la variable principal para calcular los días medios fuera de plazo e identificar el riesgo de cobro de importes elevados. Comparar esta fecha con la `DateCreated` del evento de pago revela el alcance de los retrasos y ayuda a medir el cumplimiento de las condiciones de crédito. Por qué es importante Es el punto de referencia para todos los cálculos de antigüedad, vencimiento y cumplimiento. Dónde obtenerlo Tabla Transaction, campo «duedate» Ejemplos 2023-11-152023-12-012024-01-30
	Importe de la factura TotalAmount	El valor financiero total de la factura.
Descripción Este atributo representa el importe total de la factura, que normalmente se encuentra en el campo `foreignTotal` o `total` de la tabla Transaction de NetSuite. Representa el valor que debe cobrar la empresa al cliente. Esta métrica se utiliza para analizar el flujo de valor en el proceso de cuentas por cobrar, priorizar los cobros de mayor importe y calcular KPI como el valor pendiente de disputas. Permite filtrar los casos por nivel financiero para centrar los esfuerzos de optimización en las transacciones de mayor impacto. Por qué es importante Es fundamental para cuantificar el impacto financiero de las ineficiencias del proceso y priorizar los cobros. Dónde obtenerlo Tabla Transaction, campo «foreignTotal» o «total» Ejemplos 1500.00250.5010000.00
	Nombre del cliente Entity	El nombre del cliente o la entidad asociada a la factura.
Descripción Este atributo identifica al cliente responsable de pagar la factura. En NetSuite, se vincula con la tabla `Entity` (registro de cliente). Es fundamental para todos los análisis centrados en clientes. Los analistas utilizan este campo para segmentar el rendimiento por cliente e identificar a quienes pagan tarde con frecuencia, generan disputas o se apartan de las condiciones de pago estándar. Sirve de apoyo a los Dashboards Monitor de cumplimiento de condiciones de crédito y Rendimiento de agentes de cobro. Por qué es importante Permite segmentar el rendimiento del proceso según el comportamiento y el perfil de riesgo del cliente. Dónde obtenerlo Tabla Transaction, campo «entity» (se une con la tabla Entity/Customer) Ejemplos Acme CorpGlobex CorporationSoylent Corp
	Representante de ventas SalesRep	El representante de ventas asociado a la factura.
Descripción Este atributo identifica al representante de ventas responsable de la cuenta o la transacción. En NetSuite, suele corresponder al campo `salesrep` del registro de la transacción. Se utiliza para relacionar problemas de facturación o notas de crédito con determinados representantes de ventas. Por ejemplo, el panel de notas de crédito y pérdida de ingresos lo utiliza para comprobar si algunos representantes presentan tasas más elevadas de ajustes posteriores a la facturación, lo que puede indicar problemas de calidad en etapas anteriores del proceso comercial. Por qué es importante Relaciona los problemas posteriores de cuentas por cobrar con los responsables del proceso comercial en etapas anteriores. Dónde obtenerlo Tabla Transaction, campo «salesrep» Ejemplos John SmithSarah ConnorKyle Reese
	Unidad de negocio Subsidiary	La filial o unidad de negocio a la que pertenece la factura.
Descripción En entornos NetSuite OneWorld, este atributo identifica la entidad jurídica o filial específica que emitió la factura. Permite comparar el rendimiento entre distintas sucursales o divisiones de la empresa. Este atributo es compatible con el panel de eficiencia del envío de facturas, ya que permite a los usuarios profundizar en unidades de negocio específicas. Ayuda a determinar si los problemas del proceso son sistémicos en toda la organización o están localizados en determinadas unidades operativas. Por qué es importante Es fundamental para comparar el rendimiento entre distintas entidades de la organización. Dónde obtenerlo Tabla Transaction, campo «subsidiary» Ejemplos Oeste de EE. UU.Operaciones de EMEAVentas de APAC
	Agente de cobro CollectionAgent	El usuario responsable de las actividades de cobro de esta factura.
Descripción Este atributo identifica al empleado que gestiona las actividades de cobro de la factura. Puede ser la misma persona que el representante de ventas o un especialista dedicado de cuentas por cobrar. A menudo se encuentra en un campo personalizado o se obtiene del usuario que registra las actividades de «Payment Reminder». Este atributo alimenta el panel de rendimiento de los agentes de cobro, lo que permite a los responsables comparar el rendimiento del equipo de cobros e identificar necesidades de formación o desequilibrios en la carga de trabajo. Por qué es importante Permite evaluar el rendimiento individual de los miembros del equipo de cobros. Dónde obtenerlo SystemNotes «nombre» en actividades de cobro o campo personalizado Ejemplos Agent SmithEspecialista de facturación AEquipo de cobros 1
	Categoría de producto Class	La categoría o clase de los bienes o servicios vendidos.
Descripción Este atributo se corresponde con el segmento `class` de NetSuite. Clasifica la fuente de ingresos, por ejemplo, Hardware o Consultoría. Comprender la combinación de productos es fundamental para el análisis. Permite analizar el panel de notas de crédito y pérdida de ingresos para comprobar si determinadas líneas de productos presentan más devoluciones o errores de facturación que otras. Por qué es importante Segmenta el rendimiento del proceso según el tipo de producto o servicio vendido. Dónde obtenerlo Tabla Transaction, campo «class» Ejemplos Ingresos por licenciasServicios de consultoríaHardware
	Código de moneda Currency	La moneda en la que se emitió la factura.
Descripción Este atributo especifica el código de moneda ISO, por ejemplo, USD o EUR, de la transacción y se encuentra en el campo `currency` de NetSuite. Es necesario para gestionar correctamente los entornos multidivisa. Aunque suele ser un campo de fondo, es fundamental al agregar `TotalAmount` para garantizar que las distintas monedas no se sumen incorrectamente sin conversión. También aporta contexto para interpretar las variaciones regionales del rendimiento. Por qué es importante Esencial para realizar agregaciones financieras correctas en organizaciones globales. Dónde obtenerlo Tabla Transaction, campo «currency» Ejemplos USDEURGBP
	Condiciones de pago Terms	Las condiciones de pago acordadas para la factura.
Descripción Este atributo especifica las condiciones de pago asignadas a la factura, como «Net 30» o «Due on Receipt». Se encuentra en el campo `terms` del registro Transaction. Estos datos se utilizan para calcular la fecha de pago prevista y analizar si los clientes con condiciones flexibles pagan de forma más fiable que aquellos con condiciones estrictas. Ayudan a revisar las políticas de crédito y a comprender la referencia del KPI de días medios fuera de plazo. Por qué es importante Define el comportamiento esperado y el SLA del ciclo de pago del cliente. Dónde obtenerlo Tabla Transaction, campo «terms» Ejemplos Neto 30Neto 60Vencimiento al recibir2 % a 10, neto 30
	Días de vencimiento DaysOverdue	El número de días que una factura abierta ha superado su fecha de vencimiento.
Descripción Este atributo calculado representa la diferencia entre `DueDate` y la fecha actual del análisis, o la fecha de pago si el caso está cerrado. Proporciona una métrica continua para el análisis de antigüedad. Es el principal impulsor de los intervalos de antigüedad, por ejemplo, 30-60 o 60-90, utilizados en el panel de riesgo de cobro de importes elevados. Permite identificar de inmediato los retrasos más críticos del sistema. Por qué es importante Métrica estándar para evaluar la gravedad de los retrasos en los pagos. Dónde obtenerlo Calculado: (fecha actual - DueDate) Ejemplos 150-5
	Está en disputa IsDisputed	Indicador que señala si la factura está actualmente en disputa o lo estuvo alguna vez.
Descripción Este atributo booleano indica si la factura ha pasado por un proceso de disputa. Se obtiene de la presencia de actividades relacionadas con disputas o de un indicador de estado específico en el registro de la factura. Actúa como filtro fundamental para el análisis del ciclo de vida de las disputas y ayuda a separar las facturas «problemáticas» de las facturas «sin incidencias» al calcular la tasa de cobro en el primer intento. Por qué es importante Separa los casos complejos de los casos estándar que siguen la ruta prevista. Dónde obtenerlo Calculado según la presencia de la actividad «Dispute Opened» Ejemplos truefalse
	Fecha de promesa de pago PromiseDate	La fecha en la que el cliente se ha comprometido a enviar el pago.
Descripción Este atributo registra la fecha en la que un cliente se comprometió a pagar una factura vencida, normalmente tras la gestión de un agente de cobro. En NetSuite, suele almacenarse en el registro «Phone Call» o en un campo personalizado del cuerpo de Transaction. Esta fecha es esencial para el panel de cumplimiento de las promesas de pago. Al comparar la fecha prometida con la fecha de pago real, la organización puede medir la fiabilidad de los compromisos de los clientes y la eficacia de las llamadas de cobro. Por qué es importante Mide la fiabilidad de los compromisos de los clientes y la eficacia de los cobros. Dónde obtenerlo Registro Task/Phone Call o campo personalizado Ejemplos 2023-11-202023-12-05
	Motivo de la disputa DisputeReason	El código o la descripción del motivo por el que una factura está en disputa.
Descripción Este atributo registra el motivo específico por el que un cliente se ha negado a pagar o ha solicitado una corrección. En NetSuite, suele corresponder a un campo personalizado o a un registro «Case» específico vinculado a la factura. Es fundamental para el panel de análisis del ciclo de vida de las disputas. Agrupar por motivo de disputa ayuda a identificar causas raíz, como «Pricing Error», «Damaged Goods» o «Missing PO», que requieren correcciones sistémicas en etapas anteriores para evitar futuras pérdidas de ingresos. Por qué es importante Identifica las causas raíz de los impagos y del trabajo administrativo innecesario. Dónde obtenerlo Support Case vinculado o campo personalizado del cuerpo de Transaction Ejemplos Precio incorrectoMercancía no recibidaError fiscal
	Nota de la factura Memo	Notas o descripciones adjuntas a la cabecera de la factura.
Descripción Este atributo contiene la descripción de texto libre o la nota introducida en la factura y se encuentra en el campo `memo`. A menudo incluye notas manuales sobre gestiones especiales o acuerdos con el cliente. El análisis de texto de este campo puede revelar motivos no estructurados de retrasos o disputas que los campos estructurados no detectan. Añade contexto cualitativo a los datos cuantitativos del proceso. Por qué es importante Proporciona contexto y datos cualitativos sobre la transacción. Dónde obtenerlo Tabla Transaction, campo «memo» Ejemplos Tarifa de servicio de octubreCorrección de la factura n.º 1002Se aplicaron condiciones de pago especiales
	Región Location	La ubicación o región asociada a la transacción.
Descripción En NetSuite, el campo `location` suele representar un almacén, una oficina o una región geográfica. Este atributo asigna dicho campo a un concepto regional para el análisis. Se utiliza en la vista general del rendimiento del DSO para identificar diferencias regionales en los comportamientos de pago. Ayuda a determinar si los problemas de cobro son globales o están aislados en determinados territorios. Por qué es importante Permite segmentar geográficamente el rendimiento de las cuentas por cobrar. Dónde obtenerlo Tabla Transaction, campo «location» Ejemplos Almacén de NorteaméricaOficina de LondresSingapur

Obligatorio Recomendado Opcional

Actividades de cuentas por cobrar

Estos son los pasos críticos del proceso y los hitos transaccionales que deben capturarse en su registro de eventos para modelar con precisión su flujo de cobros.

6 Recomendado 7 Opcional

	Actividad	Descripción
	Factura aprobada	Transición del estado de la factura de Pending Approval a Open. Se captura supervisando las notas del sistema o los registros históricos del Workflow asociados a la factura.
Por qué es importante Indica el tiempo de procesamiento interno antes de facturar al cliente. Los retrasos en esta etapa alargan el tiempo total del ciclo sin aportar valor al cliente. Dónde obtenerlo System Notes: filtre el campo 'status' cuando cambie de 'Pending Approval' a 'Open'. Recopilar Compare el campo de estado antes y después Tipo de evento inferred
	Factura creada	Creación inicial del registro de factura en el sistema. Se captura en la tabla Transaction cuando el tipo de registro es Invoice.
Por qué es importante Marca el inicio del ciclo de cuentas por cobrar y establece la base para calcular la antigüedad de saldos. Es esencial para calcular el tiempo del ciclo de facturación a cobro. Dónde obtenerlo Tabla Transaction: campo 'trandate' o 'datecreated' para registros de tipo 'CustInvc'. Recopilar Se registra cuando se ejecuta la transacción Invoice Tipo de evento explicit
	Factura enviada	Acción de enviar la factura al cliente por correo electrónico, correo postal o fax. Se captura consultando los registros Message vinculados a la transacción Invoice específica.
Por qué es importante Es fundamental para el KPI de plazo de emisión de facturas. Identificar los retrasos en esta etapa revela cuellos de botella administrativos que impiden cobrar a tiempo. Dónde obtenerlo Tabla Messages: una mediante el ID de transacción, donde 'authoremail' es interno y 'recipientemail' es externo. Recopilar Se registra cuando se ejecuta la transacción Email Tipo de evento explicit
	Factura liquidada	Cambio final del estado de la factura a 'Paid In Full'. Sirve como estado final del proceso para los casos completados correctamente.
Por qué es importante Es necesario para calcular el tiempo medio del ciclo de facturación a cobro. Distingue los elementos abiertos de los cerrados en las variantes del proceso. Dónde obtenerlo System Notes: cambio de estado del registro Invoice a 'Paid In Full'. Recopilar Compare el campo de estado antes y después Tipo de evento inferred
	Nota de crédito emitida	Creación de una transacción Credit Memo aplicada a la factura. Reduce el saldo pendiente y suele indicar una devolución o un error de facturación.
Por qué es importante Visualiza la fuga de ingresos. La emisión frecuente de notas de crédito sugiere fallos sistémicos del proceso de ventas o entrega. Dónde obtenerlo Tabla Transaction: tipo de registro 'CustCred' aplicado al ID de la factura mediante 'appliedtotransaction'. Recopilar Se registra cuando se ejecuta la transacción Credit Memo Tipo de evento explicit
	Pago completo recibido	Aplicación de un Customer Payment que reduce el saldo de la factura a cero. Marca el final efectivo del esfuerzo de cobro.
Por qué es importante Marca de tiempo principal para calcular los días de ventas pendientes de cobro y la media de días más allá de las condiciones. Representa la realización efectiva de los ingresos. Dónde obtenerlo Tabla Transaction: tipo 'CustPymt' aplicado a Invoice cuando el 'status' resultante de Invoice pasa a ser 'Paid In Full'. Recopilar Se registra cuando se ejecuta la transacción Payment Tipo de evento explicit
	Caso de disputa abierto	Inicio de una disputa relacionada con la factura, que suele inferirse a partir de un Support Case vinculado o de un estado personalizado específico. Esto detiene el flujo de cobro estándar.
Por qué es importante Es clave para el Dashboard de análisis del ciclo de vida de las disputas. Un volumen elevado indica problemas de calidad en las etapas iniciales de la entrega o la facturación. Dónde obtenerlo Registro Support Case: relaciónelo con Transaction cuando la categoría sea 'Billing Dispute' o cuando el estado de Transaction cambie a 'Disputed'. Recopilar Compare el campo de estado o la creación del registro vinculado Tipo de evento inferred
	Deuda incobrable cancelada	Eliminación del saldo de la factura mediante un Journal Entry o un tipo específico de Credit Memo para importes incobrables. Representa un fallo del proceso de cobro.
Por qué es importante Separa los ingresos no cobrados de los cobros realizados correctamente en el análisis. Es importante para comprender la verdadera eficiencia del cobro. Dónde obtenerlo Journal Entry o Credit Memo: filtre por cuentas del libro mayor específicas, como 'Bad Debt Expense', vinculadas a la factura. Recopilar Se deriva del uso de la cuenta del libro mayor Tipo de evento inferred
	Disputa resuelta	Conclusión de un caso de disputa, que devuelve la factura a un estado cobrable o da lugar a un crédito. Se captura cuando el estado del Support Case vinculado cambia a Closed.
Por qué es importante Es necesario para calcular el tiempo medio de resolución de disputas. Los tiempos de resolución prolongados afectan negativamente a los días de ventas pendientes de cobro y a la satisfacción del cliente. Dónde obtenerlo Registro Support Case: campo 'dateclosed' para los casos vinculados a la factura. Recopilar Compare el campo de estado antes y después Tipo de evento inferred
	Extracto bancario cotejado	Conciliación de la transacción de pago con el feed del extracto bancario. Se captura mediante el historial de 'Match Bank Data' o de conciliación.
Por qué es importante Registra la tasa de conciliación bancaria automatizada. Los retrasos en esta etapa ocultan la posición real de efectivo e indican fricciones manuales en las operaciones administrativas. Dónde obtenerlo Estado de Transaction: compruebe si el estado de la transacción Payment cambia a 'Deposited' o aparece marcada como reconciliada. Recopilar Compare el campo de estado antes y después Tipo de evento inferred
	Pago parcial registrado	Aplicación de un Customer Payment que reduce el saldo de la factura, pero no lo liquida por completo. Se captura en la tabla Transaction Line.
Por qué es importante Permite analizar el flujo del proceso de pagos parciales. Identifica un flujo de efectivo fragmentado y a clientes con dificultades de liquidez. Dónde obtenerlo Tabla Transaction: tipo 'CustPymt' aplicado a Invoice cuando 'amountremaining' > 0 en Invoice. Recopilar Se registra cuando se ejecuta la transacción Payment Tipo de evento explicit
	Promesa de pago recibida	Registro que indica que el cliente se ha comprometido a pagar en una fecha determinada. Normalmente se captura en User Notes o en un paquete especializado de gestión de cobros.
Por qué es importante Registra el KPI de cumplimiento de las promesas de pago. Ayuda a distinguir entre clientes colaboradores y clientes que requieren una escalación. Dónde obtenerlo Registro Note: análisis de texto para 'PTP' o 'Promise', o campos específicos de una Collections SuiteApp. Recopilar Se deriva del análisis de texto de las notas Tipo de evento inferred
	Recordatorio de pago enviado	Correo electrónico o carta de cobro generados y enviados al cliente por un pago vencido. Se captura mediante los registros del módulo Dunning Letters o los registros Message vinculados a la factura.
Por qué es importante Mide el esfuerzo necesario para cobrar efectivo y la eficacia de las estrategias de cobro. Es esencial para el Dashboard de eficacia de los recordatorios de cobro. Dónde obtenerlo Registro Message o Dunning Bundle Log: compruebe asuntos específicos, como 'Reminder' u 'Overdue'. Recopilar Se deriva de los patrones del asunto del mensaje Tipo de evento inferred

Recomendado Opcional

Guías de extracción

Cómo obtener sus datos de NetSuite

Pasos

Requisitos previos: Asegúrese de que la función 'SuiteAnalytics Workbook' esté habilitada y de tener permisos para acceder a Transacciones, System Notes, Messages y Support Cases.
Acceda a SuiteAnalytics: Vaya a Analytics > Workbooks > New Workbook.
Seleccione el registro raíz: Elija Transacción como tipo de registro raíz. Este registro sirve como referencia para los datos financieros.
Estrategia del conjunto de datos: Debido a la necesidad de extraer diversas actividades (Approvals, Messages, Disputes) en un único registro de eventos 'as-is', un solo conjunto de datos combinado en la interfaz generará filas anchas (producto cartesiano). El enfoque experto recomendado consiste en utilizar la capacidad SuiteQL subyacente de SuiteAnalytics. Puede ejecutar la consulta proporcionada a continuación mediante la interfaz 'SuiteAnalytics Connect' (ODBC/JDBC) o un paquete 'SuiteQL Query Tool' dentro de la interfaz.
Ejecute la consulta: Copie el script completo de SuiteQL proporcionado en la sección 'Query'. Sustituya el marcador {{LastDataUpdate}} por la marca de tiempo de su extracción y {{StartDate}} por la fecha de inicio del análisis (por ejemplo, '2023-01-01').
Verifique las columnas: Asegúrese de que todas las columnas proyectadas (TranId, Activity, DateCreated, etc.) estén presentes en el conjunto de resultados.
Exporte los datos: Ejecute la consulta y exporte los resultados a CSV.
Formato: Abra el CSV. Asegúrese de que la columna 'DateCreated' tenga el formato YYYY-MM-DD HH:MM:SS. Compruebe que 'TotalAmount' no contenga símbolos de moneda, sino únicamente valores numéricos.
Validación: Compruebe que un único ID de factura (TranId) aparezca varias veces con distintos valores de 'Actividad' (por ejemplo, Created, Approved, Payment Received).
Ingesta: Cargue el CSV en ProcessMind. Asigne 'TranId' a Case ID, 'Activity' a Activity Name y 'DateCreated' a Timestamp.

Configuración

SuiteAnalytics Connect: Debe estar habilitado en Enable Features > Analytics para ejecutar externamente consultas UNION complejas.
Permisos: El usuario necesita acceso de tipo 'View' a Transactions, System Notes, Support Cases y Messages.
Filtrado por fecha: Se recomienda un intervalo móvil de 12 meses. Las extracciones históricas grandes pueden agotar el tiempo de espera; verifique los límites de filas (NetSuite suele limitar los resultados a entre 5.000 y 100.000 filas según la interfaz; se recomienda ODBC para obtener todo el historial).
Contexto de subsidiaria: Si utiliza una cuenta OneWorld, asegúrese de que el usuario tenga acceso a todas las subsidiarias objetivo o filtre por t.subsidiary.
Rendimiento: La tabla SystemNote es muy grande. Para garantizar el rendimiento, es obligatorio filtrar por recordtype y date.

a Consulta de ejemplo sql

/* SuiteQL Query for Accounts Receivable Process Mining */
/* Combined Event Log Extraction */

/* 1. Invoice Created */
SELECT
  t.tranid AS TranId,
  'Invoice Created' AS Activity,
  TO_CHAR(t.trandate, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  t.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  t.duedate AS DueDate,
  s.name AS Subsidiary,
  emp.entityid AS SalesRep,
  t.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction t
  LEFT JOIN Customer c ON t.entity = c.id
  LEFT JOIN Subsidiary s ON t.subsidiary = s.id
  LEFT JOIN Employee emp ON t.salesrep = emp.id
WHERE
  t.type = 'CustInvc'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 2. Invoice Approved (via System Notes) */
SELECT
  t.tranid AS TranId,
  'Invoice Approved' AS Activity,
  TO_CHAR(sn.date, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  t.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  t.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  t.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction t
  JOIN SystemNote sn ON sn.recordid = t.id
  LEFT JOIN Customer c ON t.entity = c.id
  LEFT JOIN Subsidiary s ON t.subsidiary = s.id
WHERE
  t.type = 'CustInvc'
  AND sn.recordtypeid = -30 /* Transaction Record Type */
  AND sn.standardfield = 'STATUS'
  AND sn.oldvalue = 'Pending Approval'
  AND sn.newvalue = 'Open'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 3. Invoice Dispatched / 4. Payment Reminder (via Messages) */
SELECT
  t.tranid AS TranId,
  CASE 
    WHEN m.subject LIKE '%Reminder%' THEN 'Payment Reminder Sent'
    ELSE 'Invoice Dispatched'
  END AS Activity,
  TO_CHAR(m.messagedate, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  t.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  t.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  t.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction t
  JOIN Message m ON m.transaction = t.id
  LEFT JOIN Customer c ON t.entity = c.id
  LEFT JOIN Subsidiary s ON t.subsidiary = s.id
WHERE
  t.type = 'CustInvc'
  AND (m.subject LIKE '%Invoice%' OR m.subject LIKE '%Reminder%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 5. Dispute Opened / 6. Dispute Resolved (via Support Cases) */
SELECT
  t.tranid AS TranId,
  CASE 
    WHEN sc.status = 'Closed' THEN 'Dispute Resolved'
    ELSE 'Dispute Case Opened'
  END AS Activity,
  TO_CHAR(sc.createddate, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  t.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  t.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  t.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction t
  JOIN SupportCase sc ON sc.custevent_linked_invoice = t.id /* Adjust custom field name */
  LEFT JOIN Customer c ON t.entity = c.id
  LEFT JOIN Subsidiary s ON t.subsidiary = s.id
WHERE
  t.type = 'CustInvc'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 7. Promise to Pay (via Notes) */
SELECT
  t.tranid AS TranId,
  'Promise to Pay Received' AS Activity,
  TO_CHAR(n.notedate, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  t.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  t.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  t.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction t
  JOIN Note n ON n.transaction = t.id
  LEFT JOIN Customer c ON t.entity = c.id
  LEFT JOIN Subsidiary s ON t.subsidiary = s.id
WHERE
  t.type = 'CustInvc'
  AND (n.title LIKE '%Promise%' OR n.note LIKE '%Promise%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 8. Credit Memo Issued */
/* Logic: Find Credit Memos applied to the Invoice */
SELECT
  inv.tranid AS TranId,
  'Credit Memo Issued' AS Activity,
  TO_CHAR(cm.trandate, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  cm.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  inv.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  inv.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction inv
  JOIN NextTransactionLineLink ntll ON ntll.previousdoc = inv.id
  JOIN Transaction cm ON ntll.nextdoc = cm.id
  LEFT JOIN Customer c ON inv.entity = c.id
  LEFT JOIN Subsidiary s ON inv.subsidiary = s.id
WHERE
  inv.type = 'CustInvc'
  AND cm.type = 'CustCred'
  AND inv.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 9. Partial Payment / 10. Full Payment Received */
SELECT
  inv.tranid AS TranId,
  CASE
    WHEN (inv.foreigntotal - py.foreigntotal) <= 0 THEN 'Full Payment Received'
    ELSE 'Partial Payment Posted'
  END AS Activity,
  TO_CHAR(py.trandate, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  py.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  inv.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  inv.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction inv
  JOIN NextTransactionLineLink ntll ON ntll.previousdoc = inv.id
  JOIN Transaction py ON ntll.nextdoc = py.id
  LEFT JOIN Customer c ON inv.entity = c.id
  LEFT JOIN Subsidiary s ON inv.subsidiary = s.id
WHERE
  inv.type = 'CustInvc'
  AND py.type = 'CustPymt'
  AND inv.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 11. Bad Debt Written Off */
SELECT
  t.tranid AS TranId,
  'Bad Debt Written Off' AS Activity,
  TO_CHAR(je.trandate, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  t.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  t.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  t.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction t
  JOIN NextTransactionLineLink ntll ON ntll.previousdoc = t.id
  JOIN Transaction je ON ntll.nextdoc = je.id
  LEFT JOIN Customer c ON t.entity = c.id
  LEFT JOIN Subsidiary s ON t.subsidiary = s.id
WHERE
  t.type = 'CustInvc'
  AND je.type = 'Journal'
  AND (je.memo LIKE '%Bad Debt%' OR je.memo LIKE '%Write Off%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 13. Invoice Cleared */
SELECT
  t.tranid AS TranId,
  'Invoice Cleared' AS Activity,
  TO_CHAR(sn.date, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  t.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  t.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  'Paid In Full' AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction t
  JOIN SystemNote sn ON sn.recordid = t.id
  LEFT JOIN Customer c ON t.entity = c.id
  LEFT JOIN Subsidiary s ON t.subsidiary = s.id
WHERE
  t.type = 'CustInvc'
  AND sn.standardfield = 'STATUS'
  AND sn.newvalue = 'Paid In Full'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

Pasos

Requisitos previos y permisos: Asegúrese de tener un rol con permisos de 'SuiteAnalytics Connect' o 'SuiteQL'. Necesitará un Token ID y un Token Secret válidos para la autenticación mediante REST o una conexión configurada con un controlador ODBC.
Comprenda el esquema: Esta extracción utiliza las tablas Transacción, TransactionLine, SystemNote, Message, Nota y SupportCase. NetSuite almacena los cambios históricos de campos, como las actualizaciones de Estado, en SystemNote, que resulta fundamental para obtener las marcas de tiempo de las aprobaciones y los cambios de estado.
Identifique el alcance: Determine la filial, el intervalo de fechas y los tipos de registro específicos, normalmente 'CustInvc' para las facturas, que necesita para el análisis.
Configure la consulta SuiteQL: La consulta proporcionada utiliza UNION ALL para combinar datos de distintas tablas en un único formato de registro de eventos. NetSuite SuiteQL no admite SQL procedimental complejo, por lo que la lógica se aplana en bloques de selección específicos para cada actividad.
Estrategia de ejecución: Ejecute la consulta mediante la API REST de NetSuite /services/rest/query/v1/suiteql o a través de ODBC. Debido al posible tamaño de la tabla SystemNote, se recomienda encarecidamente realizar la extracción en lotes particionados por trandate, por ejemplo, mes a mes.
Gestión de la paginación: La API REST de NetSuite suele limitar las respuestas a 1.000 filas. Debe implementar la gestión de desplazamiento o recorrer el encabezado 'Link' en el script de extracción para recuperar el conjunto de datos completo.
Transformación de datos: La consulta alinea todos los resultados con un esquema estándar (TranId, Activity, Date, etc.). Asegúrese de que las fechas tengan el formato ISO 8601 (YYYY-MM-DD THH:MM:SS) durante la exportación si la salida SQL sin procesar utiliza otra configuración regional.
Lógica de disputas y cobros: La consulta busca registros SupportCase vinculados al cliente y registros Nota para 'Promise to Pay'. Compruebe si su organización utiliza campos personalizados para estos indicadores en lugar de objetos estándar y ajuste las cláusulas WHERE según corresponda.
Validación: Compare el recuento de 'Invoice Created' del archivo extraído con una búsqueda guardada en NetSuite para el mismo periodo, a fin de comprobar que los datos estén completos.
Exportación final: Guarde el conjunto de datos resultante como archivo CSV. Asegúrese de que los encabezados coincidan con la lista 'Attributes to include' (TranId, Activity, DateCreated, etc.) antes de cargarlo en ProcessMind.

Configuración

Intervalo de fechas: Filtre por trandate en la tabla Transaction y por date en SystemNote. Para procesos activos, se recomienda un periodo móvil de 12 meses.
Filtro de subsidiaria: Es esencial en entornos con varias subsidiarias. Añada AND t.subsidiary = [Your Subsidiary ID] a todas las cláusulas WHERE.
Tipos de registro: La consulta se centra en CustInvc (Invoice), CustPymt (Payment), CustCred (Credit Memo) y Journal.
System Notes: Esta tabla es enorme. Para garantizar el rendimiento, es obligatorio filtrar por recordtype = 'invoice'.
Mapeo de estados: Los estados de NetSuite son identificadores internos, como 'A' y 'B'. La consulta utiliza BUILTIN.DF para obtener los nombres visibles, pero verifique que coincidan con las etiquetas localizadas de su interfaz.
Estrategia de unión: Utiliza uniones estándar sobre transaction.id. Asegúrese de que los vínculos 'Applied To' estén intactos para conservar el historial de pagos.

a Consulta de ejemplo sql

/* 1. Invoice Created */
SELECT
  t.tranid AS TranId,
  'Invoice Created' AS Activity,
  TO_CHAR(t.createddate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
WHERE
  t.recordtype = 'invoice'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 2. Invoice Approved (Detected via SystemNote status change to Open) */
SELECT
  t.tranid AS TranId,
  'Invoice Approved' AS Activity,
  TO_CHAR(sn.date, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN SystemNote sn ON sn.recordid = t.id
WHERE
  t.recordtype = 'invoice'
  AND sn.recordtypeid = -30 /* Invoice Record Type ID */
  AND sn.field = 'status'
  AND (sn.after LIKE '%Open%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 3. Invoice Dispatched (Email Sent) */
SELECT
  t.tranid AS TranId,
  'Invoice Dispatched' AS Activity,
  TO_CHAR(m.messagedate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN Message m ON m.transaction = t.id
WHERE
  t.recordtype = 'invoice'
  AND m.subject LIKE '%Invoice%'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 4. Payment Reminder Sent */
SELECT
  t.tranid AS TranId,
  'Payment Reminder Sent' AS Activity,
  TO_CHAR(m.messagedate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN Message m ON m.transaction = t.id
WHERE
  t.recordtype = 'invoice'
  AND (m.subject LIKE '%Reminder%' OR m.subject LIKE '%Overdue%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 5. Dispute Case Opened (Linked Support Case) */
SELECT
  t.tranid AS TranId,
  'Dispute Case Opened' AS Activity,
  TO_CHAR(sc.createddate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN SupportCase sc ON sc.company = t.entity
WHERE
  t.recordtype = 'invoice'
  AND sc.title LIKE '%Invoice%'
  AND sc.createddate >= t.createddate
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 6. Dispute Resolved */
SELECT
  t.tranid AS TranId,
  'Dispute Resolved' AS Activity,
  TO_CHAR(sc.lastmodifieddate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN SupportCase sc ON sc.company = t.entity
WHERE
  t.recordtype = 'invoice'
  AND sc.status = 'Closed'
  AND sc.title LIKE '%Invoice%'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 7. Promise to Pay Received */
SELECT
  t.tranid AS TranId,
  'Promise to Pay Received' AS Activity,
  TO_CHAR(n.notedate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN Note n ON n.transaction = t.id
WHERE
  t.recordtype = 'invoice'
  AND (n.note LIKE '%Promise to Pay%' OR n.note LIKE '%PTP%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 8. Credit Memo Issued */
SELECT
  t.tranid AS TranId,
  'Credit Memo Issued' AS Activity,
  TO_CHAR(link_t.createddate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN TransactionLine tl ON tl.doc = t.id
  JOIN Transaction link_t ON link_t.id = tl.transaction
WHERE
  t.recordtype = 'invoice'
  AND link_t.recordtype = 'creditmemo'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 9. Partial Payment Posted */
SELECT
  t.tranid AS TranId,
  'Partial Payment Posted' AS Activity,
  TO_CHAR(link_t.createddate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN TransactionLine tl ON tl.doc = t.id
  JOIN Transaction link_t ON link_t.id = tl.transaction
WHERE
  t.recordtype = 'invoice'
  AND link_t.recordtype = 'customerpayment'
  AND ABS(tl.foreignamount) < t.foreigntotal
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 10. Full Payment Received */
SELECT
  t.tranid AS TranId,
  'Full Payment Received' AS Activity,
  TO_CHAR(link_t.createddate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN TransactionLine tl ON tl.doc = t.id
  JOIN Transaction link_t ON link_t.id = tl.transaction
WHERE
  t.recordtype = 'invoice'
  AND link_t.recordtype = 'customerpayment'
  AND ABS(tl.foreignamount) >= (t.foreigntotal - 1.00) /* Approx check for full payment allowing small variance */
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 11. Bad Debt Written Off */
SELECT
  t.tranid AS TranId,
  'Bad Debt Written Off' AS Activity,
  TO_CHAR(link_t.createddate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN TransactionLine tl ON tl.doc = t.id
  JOIN Transaction link_t ON link_t.id = tl.transaction
WHERE
  t.recordtype = 'invoice'
  AND link_t.recordtype = 'journalentry'
  AND (link_t.memo LIKE '%Write off%' OR link_t.memo LIKE '%Bad Debt%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 12. Bank Statement Matched (via Payment Status) */
SELECT
  t.tranid AS TranId,
  'Bank Statement Matched' AS Activity,
  TO_CHAR(sn.date, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN TransactionLine tl ON tl.doc = t.id
  JOIN Transaction link_t ON link_t.id = tl.transaction
  JOIN SystemNote sn ON sn.recordid = link_t.id
WHERE
  t.recordtype = 'invoice'
  AND link_t.recordtype = 'customerpayment'
  AND sn.field = 'status'
  AND sn.after LIKE '%Deposited%'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 13. Invoice Cleared (Final Status) */
SELECT
  t.tranid AS TranId,
  'Invoice Cleared' AS Activity,
  TO_CHAR(sn.date, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN SystemNote sn ON sn.recordid = t.id
WHERE
  t.recordtype = 'invoice'
  AND sn.recordtypeid = -30
  AND sn.field = 'status'
  AND (sn.after LIKE '%Paid In Full%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

Pasos

Configure los requisitos previos y los permisos Asegúrese de tener acceso de administrador a la cuenta de NetSuite. Vaya a Setup, Company, Enable Features. En la pestaña SuiteTalk, asegúrese de que 'REST Web Services' esté habilitado. En Setup, Integration, Manage Integrations, cree una integración nueva llamada 'ProcessMining_Extractor'. Habilite 'Token-based Authentication' y desmarque 'TBA: Authorization Flow' si utiliza la generación de tokens estándar. Anote el Consumer Key y el Consumer Secret.
Genere los tokens de acceso Vaya a Manage Access Tokens. Cree un token nuevo para el rol de administrador o para un rol específico con permisos sobre Transacciones, System Notes y Lists. Copie el Token ID y el Token Secret. Ahora dispone de las cuatro claves necesarias para OAuth 1.0a.
Prepare el entorno de Python Asegúrese de que Python 3.x esté instalado. Instale las bibliotecas necesarias mediante pip: pip install requests requests-oauthlib pandas. Estas bibliotecas son necesarias para gestionar el intercambio de OAuth 1.0a y la manipulación de datos.
Configure los parámetros del script Abra el script de Python proporcionado. Sustituya los marcadores de posición de ACCOUNT_ID, CONSUMER_KEY, CONSUMER_SECRET, TOKEN_ID y TOKEN_SECRET por sus credenciales específicas. Establezca TARGET_START_DATE en el periodo histórico que desea analizar, por ejemplo, '2023-01-01'.
Comprenda la estrategia de la API El script utiliza el endpoint /query/v1/suiteql de la API REST de NetSuite. Aunque es posible recorrer los registros individualmente, utilizar SuiteQL mediante la API REST ofrece un rendimiento considerablemente mejor para Process Mining, ya que permite combinar las tablas Transaction, TransactionLine, Message y SystemNote en menos solicitudes HTTP.
Ejecute el script de extracción Ejecute el script desde el terminal o el IDE. El script realiza cinco pasadas de extracción distintas: una para el flujo principal de facturas, otra para los pagos, otra para los abonos, otra para los registros de comunicación (mensajes) y otra para los cambios de estado del sistema (registro de auditoría).
Supervise la ejecución El script muestra el progreso en la consola e indica el número de registros recuperados para cada tipo de actividad. Preste atención a los errores HTTP 400 o 500, que suelen indicar problemas de permisos o una sintaxis de SuiteQL incorrecta.
Transforme y combine los datos El script gestiona automáticamente la transformación de datos. Convierte el formato de fecha específico de NetSuite en una marca de tiempo ISO 8601 estándar. También normaliza nombres de campos como tranid a ID del caso y asigna tipos de transacción específicos a los nombres de actividad estandarizados definidos en los requisitos.
Gestione la lógica posterior al procesamiento El script incluye lógica para diferenciar entre 'Partial Payment Posted' y 'Full Payment Received' comparando el importe del pago aplicado con el total de la factura original. También infiere 'Invoice Cleared' a partir del cambio de estado final.
Verifique el archivo de salida Al finalizar, el script genera un archivo llamado netsuite_ar_event_log.csv. Ábralo para revisar las primeras filas. Compruebe que TranId esté rellenado y que DateCreated tenga el formato correcto.
Importe los datos en ProcessMind El CSV generado está preparado específicamente para ProcessMind. Asigne TranId a ID del caso, Actividad a Actividad y DateCreated a Marca de tiempo. Asegúrese de asignar Importe y Estado como atributos del caso.

Configuración

Método de autenticación: OAuth 1.0a (Token Based Authentication). Este es el estándar obligatorio de seguridad para la API REST de NetSuite.
Endpoint de la API: https://[AccountID].suitetalk.api.netsuite.com/services/rest/query/v1/suiteql. El endpoint SuiteQL se utiliza dentro de la arquitectura REST para permitir el filtrado y la unión complejos de System Notes.
Gobernanza de concurrencia: NetSuite aplica límites de concurrencia según su nivel de servicio, normalmente entre 5 y 20 hilos simultáneos. Este script se ejecuta correctamente en un solo hilo para evitar errores '429 Too Many Requests'.
Formato de fecha: NetSuite permite personalizar los formatos de fecha. El script presupone el formato ISO estándar o el formato estadounidense estándar; quizá deba ajustar el análisis de fechas si su instancia utiliza DMY.
Límites de consulta: SuiteQL devuelve un máximo de 1.000 filas por página. El script implementa un bucle while con lógica para gestionar los indicadores hasMore y los offsets o rangos necesarios para paginar conjuntos de datos grandes.
Permisos necesarios: El rol de usuario debe tener permisos de tipo 'View' para Invoice, Customer Payment, Credit Memo, Journal Entry, Support Case, Message y System Note.

a Consulta de ejemplo python

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

class=class="hl-string">"hl-comment"># === CONFIGURATION ===
class=class="hl-string">"hl-comment"># Replace these with your actual NetSuite credentials
ACCOUNT_ID = class="hl-string">'123456_SB1'  class=class="hl-string">"hl-comment"># Use hyphens for sandbox, e.g., 123456-sb1
CONSUMER_KEY = class="hl-string">'your_consumer_key'
CONSUMER_SECRET = class="hl-string">'your_consumer_secret'
TOKEN_ID = class="hl-string">'your_token_id'
TOKEN_SECRET = class="hl-string">'your_token_secret'
TARGET_START_DATE = class="hl-string">'2023-01-01'

class=class="hl-string">"hl-comment"># NetSuite REST API Base URL (Format account ID correctly for URL)
class=class="hl-string">"hl-comment"># For URL, usually lowercase and hyphens: 123456-sb1
NS_ACCOUNT_URL_PART = ACCOUNT_ID.lower().replace(class="hl-string">'_', class="hl-string">'-')
BASE_URL = fclass="hl-string">'https://{NS_ACCOUNT_URL_PART}.suitetalk.api.netsuite.com/services/rest/query/v1/suiteql'

class=class="hl-string">"hl-comment"># Authentication
auth = OAuth1(CONSUMER_KEY, CONSUMER_SECRET, TOKEN_ID, TOKEN_SECRET, realm=ACCOUNT_ID)
headers = {
    class="hl-string">'Prefer': class="hl-string">'transient',
    class="hl-string">'Content-Type': class="hl-string">'application/json'
}

class=class="hl-string">"hl-comment"># === HELPER FUNCTION ===
def run_suiteql(query):
    all_rows = []
    offset = 0
    limit = 1000
    has_more = True
    
    print(fclass="hl-string">"Executing Query starting with: {query[:50]}...")
    
    while has_more:
        class=class="hl-string">"hl-comment"># Note: Pagination in SuiteQL via REST often involves ROWNUM logic or limits
        class=class="hl-string">"hl-comment"># Standard REST paging links are preferred, but for SuiteQL body, we iterate logic
        class=class="hl-string">"hl-comment"># For simplicity in this script, we assume the query returns < 100k or we would implement ID-based iteration.
        class=class="hl-string">"hl-comment"># Ideally, we inject LIMIT/OFFSET if supported or filter by ID ranges.
        class=class="hl-string">"hl-comment"># Here we use a robust wrapper handling the class="hl-string">'items' response.
        
        class=class="hl-string">"hl-comment"># Adjust query for paging if necessary, or rely on requests if result set is small.
        class=class="hl-string">"hl-comment"># For production large scale, add class="hl-string">'AND rownum between X and Y' logic.
        
        payload = {class="hl-string">"q": query}
        response = requests.post(BASE_URL, auth=auth, headers=headers, json=payload)
        
        if response.status_code == 200:
            data = response.json()
            items = data.get(class="hl-string">'items', [])
            all_rows.extend(items)
            
            class=class="hl-string">"hl-comment"># Check for generic SuiteTalk pagination links
            if len(items) < limit:
                has_more = False
            else:
                class=class="hl-string">"hl-comment"># In strict SuiteQL, you must handle offset manually in SQL
                class=class="hl-string">"hl-comment"># For this script, we assume strict date filtering keeps batches manageable
                has_more = False class=class="hl-string">"hl-comment"># Preventing infinite loop in this demo template
        else:
            print(fclass="hl-string">"Error {response.status_code}: {response.text}")
            has_more = False
            
    return all_rows

class=class="hl-string">"hl-comment"># === EXTRACTION LOGIC ===

events = []

class=class="hl-string">"hl-comment"># 1. INVOICES (Created, Due Date, Attributes)
print(class="hl-string">"Extracting Invoices...")
q_invoices = fclass="hl-string">"""
    SELECT 
        t.tranid,
        'Invoice Created' as activity,
        TO_CHAR(t.trandate, 'YYYY-MM-DD HH24:MI:SS') as event_time,
        t.foreignTotal as amount,
        e.entityid as customer,
        t.duedate,
        s.name as subsidiary,
        emp.entityid as salesrep,
        t.status,
        d.name as department
    FROM 
        transaction t
        LEFT JOIN entity e ON t.entity = e.id
        LEFT JOIN subsidiary s ON t.subsidiary = s.id
        LEFT JOIN employee emp ON t.salesrep = emp.id
        LEFT JOIN department d ON t.department = d.id
    WHERE 
        t.recordtype = 'invoice'
        AND t.trandate >= TO_DATE('{TARGET_START_DATE}', 'YYYY-MM-DD')
"""
invoices = run_suiteql(q_invoices)
for row in invoices:
    events.append({
        class="hl-string">'TranId': row.get(class="hl-string">'tranid'),
        class="hl-string">'Activity': row.get(class="hl-string">'activity'),
        class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'),
        class="hl-string">'TotalAmount': row.get(class="hl-string">'amount'),
        class="hl-string">'Entity': row.get(class="hl-string">'customer'),
        class="hl-string">'DueDate': row.get(class="hl-string">'duedate'),
        class="hl-string">'Subsidiary': row.get(class="hl-string">'subsidiary'),
        class="hl-string">'SalesRep': row.get(class="hl-string">'salesrep'),
        class="hl-string">'Status': row.get(class="hl-string">'status'),
        class="hl-string">'Department': row.get(class="hl-string">'department'),
        class="hl-string">'SourceSystem': class="hl-string">'NetSuite'
    })

class=class="hl-string">"hl-comment"># 2. PAYMENTS (Partial, Full, Bank Match)
print(class="hl-string">"Extracting Payments...")
q_payments = fclass="hl-string">"""
    SELECT 
        inv.tranid as invoice_num,
        t.tranid as payment_ref,
        TO_CHAR(t.trandate, 'YYYY-MM-DD HH24:MI:SS') as event_time,
        tl.foreignAmount as payment_amt,
        inv.foreignTotal as invoice_total,
        t.status as payment_status
    FROM 
        transaction t
        JOIN transactionLine tl ON t.id = tl.transaction
        JOIN transaction inv ON tl.createdfrom = inv.id
    WHERE 
        t.recordtype = 'customerpayment'
        AND inv.recordtype = 'invoice'
        AND t.trandate >= TO_DATE('{TARGET_START_DATE}', 'YYYY-MM-DD')
"""
payments = run_suiteql(q_payments)
for row in payments:
    class=class="hl-string">"hl-comment"># Logic to distinguish Partial vs Full
    act = class="hl-string">'Partial Payment Posted'
    class=class="hl-string">"hl-comment"># Simple heuristic: if remaining amount is small or payment equals total
    class=class="hl-string">"hl-comment"># In a real scenario, we would check class="hl-string">'amountremaining' on the invoice
    try:
        if float(row.get(class="hl-string">'payment_amt', 0)) >= float(row.get(class="hl-string">'invoice_total', 0)):
            act = class="hl-string">'Full Payment Received'
    except:
        pass
        
    events.append({
        class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'),
        class="hl-string">'Activity': act,
        class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'),
        class="hl-string">'SourceSystem': class="hl-string">'NetSuite'
    })
    
    class=class="hl-string">"hl-comment"># Bank Match / Cleared Check
    class=class="hl-string">"hl-comment"># Assuming class="hl-string">'deposited' status or similar indicates bank matching
    if row.get(class="hl-string">'payment_status') == class="hl-string">'deposited':
        events.append({
            class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'),
            class="hl-string">'Activity': class="hl-string">'Bank Statement Matched',
            class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'), class=class="hl-string">"hl-comment"># Using payment date as proxy if match date unavailable
            class="hl-string">'SourceSystem': class="hl-string">'NetSuite'
        })

class=class="hl-string">"hl-comment"># 3. CREDIT MEMOS & BAD DEBT
print(class="hl-string">"Extracting Credit Memos...")
q_credits = fclass="hl-string">"""
    SELECT 
        inv.tranid as invoice_num,
        t.tranid as credit_ref,
        t.recordtype,
        TO_CHAR(t.trandate, 'YYYY-MM-DD HH24:MI:SS') as event_time,
        t.memo
    FROM 
        transaction t
        JOIN transactionLine tl ON t.id = tl.transaction
        JOIN transaction inv ON tl.createdfrom = inv.id
    WHERE 
        t.recordtype IN ('creditmemo', 'journalentry')
        AND inv.recordtype = 'invoice'
        AND t.trandate >= TO_DATE('{TARGET_START_DATE}', 'YYYY-MM-DD')
"""
credits = run_suiteql(q_credits)
for row in credits:
    act = class="hl-string">'Credit Memo Issued'
    if class="hl-string">'write off' in str(row.get(class="hl-string">'memo')).lower() or class="hl-string">'bad debt' in str(row.get(class="hl-string">'memo')).lower():
        act = class="hl-string">'Bad Debt Written Off'
        
    events.append({
        class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'),
        class="hl-string">'Activity': act,
        class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'),
        class="hl-string">'SourceSystem': class="hl-string">'NetSuite'
    })

class=class="hl-string">"hl-comment"># 4. MESSAGES (Dispatch, Reminders)
print(class="hl-string">"Extracting Messages...")
q_msgs = fclass="hl-string">"""
    SELECT 
        t.tranid as invoice_num,
        m.subject,
        TO_CHAR(m.messagedate, 'YYYY-MM-DD HH24:MI:SS') as event_time,
        m.authoremail
    FROM 
        message m
        JOIN transaction t ON m.transaction = t.id
    WHERE 
        t.recordtype = 'invoice'
        AND m.messagedate >= TO_DATE('{TARGET_START_DATE}', 'YYYY-MM-DD')
"""
msgs = run_suiteql(q_msgs)
for row in msgs:
    subj = str(row.get(class="hl-string">'subject')).lower()
    act = None
    if class="hl-string">'invoice' in subj and class="hl-string">'attached' in subj:
        act = class="hl-string">'Invoice Dispatched'
    elif class="hl-string">'reminder' in subj or class="hl-string">'overdue' in subj:
        act = class="hl-string">'Payment Reminder Sent'
        
    if act:
        events.append({
            class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'),
            class="hl-string">'Activity': act,
            class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'),
            class="hl-string">'SourceSystem': class="hl-string">'NetSuite'
        })

class=class="hl-string">"hl-comment"># 5. SUPPORT CASES (Disputes)
print(class="hl-string">"Extracting Support Cases...")
class=class="hl-string">"hl-comment"># Requires linking Case to Invoice (often custom field or text match)
class=class="hl-string">"hl-comment"># Here assuming generic link via Customer + Time logic or direct field if exists
class=class="hl-string">"hl-comment"># Using standard support case table
q_cases = fclass="hl-string">"""
    SELECT 
        c.casenumber,
        c.title,
        c.status,
        TO_CHAR(c.createddate, 'YYYY-MM-DD HH24:MI:SS') as create_time,
        TO_CHAR(c.lastmodifieddate, 'YYYY-MM-DD HH24:MI:SS') as close_time,
        t.tranid as invoice_num
    FROM 
        supportcase c
        JOIN transaction t ON c.company = t.entity -- Loose join by customer
    WHERE 
        t.recordtype = 'invoice'
        AND (c.title LIKE '%' || t.tranid || '%' OR c.incomingmessage LIKE '%' || t.tranid || '%')
        AND c.createddate >= TO_DATE('{TARGET_START_DATE}', 'YYYY-MM-DD')
"""
cases = run_suiteql(q_cases)
for row in cases:
    class=class="hl-string">"hl-comment"># Dispute Opened
    events.append({
        class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'),
        class="hl-string">'Activity': class="hl-string">'Dispute Case Opened',
        class="hl-string">'DateCreated': row.get(class="hl-string">'create_time'),
        class="hl-string">'SourceSystem': class="hl-string">'NetSuite'
    })
    class=class="hl-string">"hl-comment"># Dispute Resolved (if closed)
    if class="hl-string">'closed' in str(row.get(class="hl-string">'status')).lower():
        events.append({
            class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'),
            class="hl-string">'Activity': class="hl-string">'Dispute Resolved',
            class="hl-string">'DateCreated': row.get(class="hl-string">'close_time'),
            class="hl-string">'SourceSystem': class="hl-string">'NetSuite'
        })

class=class="hl-string">"hl-comment"># 6. SYSTEM NOTES (Approvals, Status Changes, Cleared)
print(class="hl-string">"Extracting System Notes...")
class=class="hl-string">"hl-comment"># This query can be heavy. Ensure proper filtering.
q_notes = fclass="hl-string">"""
    SELECT 
        t.tranid as invoice_num,
        sn.field,
        sn.oldvalue,
        sn.newvalue,
        TO_CHAR(sn.date, 'YYYY-MM-DD HH24:MI:SS') as event_time
    FROM 
        systemnote sn
        JOIN transaction t ON sn.recordid = t.id
    WHERE 
        sn.recordtypeid = -30 -- Transaction Record Type ID usually -30, verify in setup
        AND t.recordtype = 'invoice'
        AND sn.date >= TO_DATE('{TARGET_START_DATE}', 'YYYY-MM-DD')
"""
notes = run_suiteql(q_notes)
for row in notes:
    field = str(row.get(class="hl-string">'field')).lower()
    old_v = str(row.get(class="hl-string">'oldvalue')).lower()
    new_v = str(row.get(class="hl-string">'newvalue')).lower()
    
    if class="hl-string">'status' in field:
        if class="hl-string">'pending approval' in old_v and class="hl-string">'open' in new_v:
            events.append({class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'), class="hl-string">'Activity': class="hl-string">'Invoice Approved', class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'), class="hl-string">'SourceSystem': class="hl-string">'NetSuite'})
        elif class="hl-string">'paid in full' in new_v:
            events.append({class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'), class="hl-string">'Activity': class="hl-string">'Invoice Cleared', class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'), class="hl-string">'SourceSystem': class="hl-string">'NetSuite'})
            
    class=class="hl-string">"hl-comment"># Promise to Pay check (User Notes often appear in System Notes or separate Note table)
    class=class="hl-string">"hl-comment"># Assuming Note capture via System Note for context
    if class="hl-string">'note' in field: 
        events.append({class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'), class="hl-string">'Activity': class="hl-string">'Promise to Pay Received', class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'), class="hl-string">'SourceSystem': class="hl-string">'NetSuite'})

class=class="hl-string">"hl-comment"># === EXPORT ===
print(class="hl-string">"Generating CSV...")
df = pd.DataFrame(events)

class=class="hl-string">"hl-comment"># Deduplicate and Sort
df.drop_duplicates(inplace=True)
df[class="hl-string">'LastDataUpdate'] = datetime.now().isoformat()

class=class="hl-string">"hl-comment"># Save
df.to_csv(class="hl-string">'netsuite_ar_event_log.csv', index=False)
print(class="hl-string">"Done. File saved as netsuite_ar_event_log.csv")

¿Listo para empezar?

Comience su camino hacia un ciclo de caja más eficiente aplicando esta plantilla a su entorno de NetSuite. Nuestro equipo está disponible para ayudarle si necesita asistencia adicional con el mapeo de datos o la integración técnica.

Volver a la guía de mejora Descargar Template

Acelere ahora su ciclo de cuentas por cobrar en NetSuite

Reduzca su DSO entre 15 y 20 días y cierre hoy las brechas de flujo de caja.

Iniciar la prueba gratuita

No necesita tarjeta de crédito; configuración en 5 minutos

Su Template de datos de cuentas por cobrar

Su Template de datos de cuentas por cobrar

Atributos de cuentas por cobrar

Actividades de cuentas por cobrar

Guías de extracción

Exportación de datos de NetSuite SuiteAnalytics Workbook

Pasos

Configuración

a Consulta de ejemplo sql

Extracción de datos de transacciones mediante NetSuite SuiteQL

Pasos

Configuración

a Consulta de ejemplo sql

Script de extracción mediante la API REST de Python SuiteTalk

Pasos

Configuración

a Consulta de ejemplo python

¿Listo para empezar?

Acelere ahora su ciclo de cuentas por cobrar en NetSuite

Su Template de datos de cuentas por cobrar

Su Template de datos de cuentas por cobrar

Atributos de cuentas por cobrar

Actividades de cuentas por cobrar

Guías de extracción

Exportación de datos de NetSuite SuiteAnalytics Workbook

Pasos

Configuración

a Consulta de ejemplo sql

Extracción de datos de transacciones mediante NetSuite SuiteQL

Pasos

Configuración

a Consulta de ejemplo sql

Script de extracción mediante la API REST de Python SuiteTalk

Pasos

Configuración

a Consulta de ejemplo python

¿Listo para empezar?

Acelere ahora su ciclo de cuentas por cobrar en NetSuite

Valoramos su privacidad