Requisitos previos del conector de NetSuite para Jitterbit 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 usar 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, recomendamos 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 de WSDL heredadas están listadas en la documentación oficial de NetSuite. Aunque estas versiones siguen estando técnicamente disponibles, usar cualquier WSDL que tenga más de un año es una práctica desaconsejada, y recomendamos encarecidamente que actualice a una versión de WSDL soportada.

  Nota

  Al actualizar el WSDL en la conexión de NetSuite, tenga en cuenta que simplemente cambiar la URL hará que todas las operaciones que utilizan las actividades del conector fallen en tiempo de ejecución, ya que las transformaciones aún utilizan el WSDL antiguo. Para actualizar correctamente, siga los pasos descritos en Cambiar la versión de WSDL.

• 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 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.
• Las versiones de 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 descarga 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, navegue a Personalización > Scripting > Scripts > Nuevo para abrir la página de Subir archivo de script:

   

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

   

   Especifique la siguiente información:

   

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

3. Seleccione el script recién subido, haga clic en Crear registro de script, y haga clic en Suitelet si se le solicita abrir la página de Script. Especifique la siguiente información:

   

   1. Ingrese un nombre para el registro en el campo Nombre. Aunque la interfaz de usuario marca Tipos de complementos personalizados como obligatorio, se puede ignorar.
   2. Navegue a la pestaña Despliegues del registro. Ingrese un título en el campo Título y establezca el campo Estado en Publicado.
   3. Haga clic en Agregar y haga clic en Guardar.

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

   

   1. Selecciona los roles internos necesarios para el acceso a la búsqueda guardada bajo 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 de 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.