Requisitos previos del conector de NetSuite para Jitterbit Integration Studio

Introducción

Se deben cumplir ciertos requisitos previos para utilizar el conector de NetSuite, como se detalla a continuación.

Requisitos previos

Para configurar y utilizar un endpoint de NetSuite, se deben cumplir los siguientes requisitos previos:

• Se recomienda una versión del agente 11.30 o posterior.

  Nota

  Existen problemas al utilizar el objeto CustomRecord en una actividad de NetSuite Search con versiones anteriores del agente. Consulte detalles adicionales en las notas de la versión 11.26 y 11.30.

• La autenticación basada en tokens (TBA) debe estar habilitada en la cuenta de NetSuite utilizando el rol de permisos apropiado para permitir el acceso de Harmony a la instancia de NetSuite. Las instrucciones para habilitar TBA se proporcionan en Habilitar TBA en NetSuite.

• Se debe crear un registro de integración de NetSuite para Jitterbit. Jitterbit proporciona un paquete para crear el registro de integración. Para instalar el paquete, siga los pasos descritos en la documentación de NetSuite. Busque el paquete utilizando el nombre Jitterbit BFN Integrations - CRM o el ID 454951.
• Jitterbit ha verificado el soporte para hasta la versión 2025.2 del WSDL de NetSuite. NetSuite soporta las seis últimas versiones de su WSDL en cualquier momento. Por lo tanto, se recomienda que la instancia de NetSuite utilice una de estas versiones de WSDL:
  • 2025.2
  • 2025.1
  • 2024.2
  • 2024.1
  • 2023.2
  • 2023.1

Jitterbit ha verificado el soporte previo para versiones más antiguas de WSDL que ya no son soportadas por NetSuite. Las versiones heredadas de WSDL están listadas en la documentación oficial de NetSuite. Aunque estas versiones siguen estando técnicamente disponibles, usar cualquier WSDL de más de un año es una práctica desaconsejada, y recomendamos encarecidamente que se actualice a una versión de WSDL soportada.

• La URL de WSDL debe proporcionarse en el formato de una URL de WSDL específica de la cuenta. Las instrucciones para obtener la URL de WSDL se proporcionan en Usar una URL de WSDL específica de la cuenta de NetSuite.
• Las versiones de WSDL de NetSuite 2021.2 a 2025.2 requieren agentes de Harmony en la nube o privados versión 10.33 o posterior.
• Las versiones de WSDL de NetSuite 2020.2 y 2021.1 requieren agentes de Harmony en la nube o privados versión 10.26 o posterior.
• La versión de WSDL de NetSuite 2020.1 requiere agentes de Harmony en la nube o privados versión 10.18 o posterior.
• Las versiones de WSDL de NetSuite 2019.1 y 2019.2 requieren agentes de Harmony en la nube o privados versión 10.4 o posterior.
• Los WSDL de NetSuite hasta 2018.2 requieren agentes de Harmony en la nube o privados versión 9.9 o posterior.

Opcional: Limitar los campos del esquema de respuesta a las columnas de búsqueda guardadas

Para limitar los campos del esquema de respuesta de una actividad de búsqueda de NetSuite a las columnas de una búsqueda guardada, se requiere un script de Suitelet para obtener metadatos. Un script de Suitelet válido está disponible para descargar en la página de Descargas de Harmony, listado bajo Conectores.

/**
 * @author Jitterbit
 * @version 1.0.0.0
 * @NApiVersion 2.x
 * @NScriptType Suitelet
 * This Suitelet loads a saved search by its internal ID and returns the search columns.
 */

El script de Suitelet debe ser subido y desplegado para que su URL de ejecución sea accesible para el conector:

1. En el portal de NetSuite, navega a Personalización > Scripting > Scripts > Nuevo para abrir la página de Subir archivo de script:

   

2. Pasa el cursor sobre el menú desplegable Archivo de script y haz clic en el nuevo ícono + para abrir el diálogo de Archivo:

   

   Especifica la siguiente información:

   

   1. Adjuntar desde: Selecciona Computadora si no está seleccionado por defecto.
   2. Carpeta: Selecciona SuiteScripts si no está seleccionado por defecto.
   3. Seleccionar archivo: Selecciona el script de Suitelet obtenido de la página de Descargas de Harmony, listado bajo Conectores.
   4. Haz clic en Guardar para regresar a la página de Subir archivo de script.

3. Selecciona el script recién subido, haz clic en Crear registro de script, y haz clic en Suitelet si se te solicita abrir la página de Script. Especifica la siguiente información:

   

   1. Ingresa un nombre para el registro en el campo Nombre. Aunque la interfaz marca Tipos de complementos personalizados como obligatorio, se puede ignorar.
   2. Navega a la pestaña Despliegues del registro. Ingresa un título en el campo Título y establece el campo Estado en Publicado.
   3. Haz clic en Agregar y haz clic en Guardar.

4. Haz clic en Desplegar script para abrir la página de Despliegue de script. Especifica la siguiente información:

   

   1. Selecciona cualquier rol interno necesario para el acceso a la búsqueda guardada en Audiencia > Roles internos.
   2. Establece el campo Estado en Publicado.
   3. Haz clic en Guardar.

5. Haz clic derecho y copia la URL que ahora es visible en la página de Despliegue del Script:

   

Para completar la URL de ejecución que usarás con una actividad de búsqueda de NetSuite, agrega &searchid={{YourSavedSearchId}} a la URL copiada. {{YourSavedSearchId}} es el ID de la búsqueda guardada a la que deseas limitar los campos del esquema de respuesta.

Por ejemplo, una URL de ejecución válida se ve como https://account123.app.netsuite.com/app/site/hosting/scriptlet.nl?script=123&deploy=2&searchid=456789 cuando se utiliza una búsqueda guardada con un ID de 456789 en una instancia alojada en https://account123.app.netsuite.com.