Extremo del conector NetSuite en Jitterbit Design Studio

Introducción

Antes de poder crear operaciones de NetSuite en Jitterbit utilizando el Conector de NetSuite, debe configurar al menos un extremo de NetSuite.

Cada extremo representa la URL y las credenciales de inicio de sesión de una cuenta específica de NetSuite. La creación del extremo permite a Jitterbit acceder a la cuenta para realizar las operaciones solicitadas. Si su organización utiliza varias cuentas de NetSuite, deberá crear un extremo para cada una.

Otras formas de conectarse a NetSuite usando Jitterbit Studio incluyen llamar a un RESTlet, usar un método de servicio web o usar el controlador JDBC de Oracle NetSuite:

Llamar a un RESTlet desde una fuente de archivo local
Llamar a un RESTlet desde un origen o destino HTTP
Utilizando un método de servicio web
Uso del controlador JDBC de Oracle NetSuite con una fuente o destino de base de datos

Prerrequisitos

Para utilizar con éxito el conector Jitterbit NetSuite para integraciones de NetSuite, se deben cumplir estos criterios:

Jitterbit ha verificado su compatibilidad con NetSuite WSDL hasta la versión 2025.1. NetSuite es compatible 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.1
- 2024.2
- 2024.1
- 2023.2
- 2023.1
- 2022.2
Jitterbit ha verificado el soporte previo para versiones WSDL más antiguas disponibles, de 2017.1 a 2022.1, que ya no son compatibles con NetSuite. Versiones WSDL anteriores se encuentran en la documentación oficial de NetSuite. Aunque estas versiones siguen estando disponibles técnicamente, se desaconseja el uso de WSDL con más de un año de antigüedad, y recomendamos encarecidamente actualizar a una versión compatible.

La URL del WSDL debe proporcionarse en el formato de una URL específica de la cuenta. Las instrucciones para obtener la URL del WSDL se encuentran en URL del WSDL específica de la cuenta de NetSuite. - Las versiones WSDL de NetSuite 2021.2 a 2025.1 requieren Harmony Cloud o agentes privados versión 10.33 o posterior. - NetSuite WSDL 2020.2 y 2021.1 requieren Harmony Cloud o agentes privados versión 10.26 o posterior. - NetSuite WSDL 2020.1 requiere Harmony Cloud o agentes privados versión 10.18 o posterior. - NetSuite WSDL 2019.1 y 2019.2 requieren Harmony Cloud o agentes privados versión 10.4 o posterior. - Los WSDL de NetSuite hasta 2018.2 requieren Harmony Cloud o agentes privados versión 9.9 o posterior. - Para utilizar la autenticación basada en token (TBA): - Debe utilizar SuiteTalk versión 2015.2 o posterior.

- Debe tener TBA habilitado para su cuenta de NetSuite.

- Para configurar un nuevo extremo de TBA, debe utilizar Jitterbit Design Studio y Agente versiones 9.2 o posteriores.

- Para convertir un extremo SSO existente para usar TBA, debe utilizar Jitterbit Design Studio versión 9.3.1 o posterior y Agents versión 9.2 o posterior.

Consejo

Para obtener información adicional, consulte la siguiente documentación de NetSuite:

Crear un extremo

Nota

Si aún no está familiarizado con Jitterbit, consulte Comenzando o Design Studio para obtener información detallada sobre cómo utilizar el producto.

Dentro de su proyecto dentro de Jitterbit Studio, hay varias formas de iniciar un nuevo extremo de NetSuite:

Vaya a Archivo > Nuevo > Conectores > Nuevo Extremo de NetSuite.
En el árbol de la izquierda, debajo de Conectores, haga clic derecho en la categoría NetSuite y luego seleccione Nuevo Extremo de NetSuite.
En el árbol de la izquierda, debajo de Conectores, haga doble clic en la categoría NetSuite, luego haga clic derecho en Nuevo Extremo de NetSuite y seleccione Nuevo Extremo de NetSuite.
En la barra de herramientas superior, haga clic en el ícono del conector (pieza de rompecabezas naranja) . En la ventana emergente, seleccione NetSuite y, a continuación, seleccione NetSuite Extremo.

Seleccionar el tipo de autenticación

En la primera pantalla del asistente de extremo de NetSuite, seleccione cómo desea que Jitterbit se autentique con su instancia de NetSuite usando las credenciales proporcionadas en la siguiente pantalla. Cada opción se explica a continuación.

adjunto

SSO: SSO (inicio de sesión único) es el método tradicional utilizado por Jitterbit para la autenticación con NetSuite y está disponible en todas las versiones de Harmony donde el conector de NetSuite está disponible. NetSuite ha dejado de usar el tipo de autenticación SSO y ya no es compatible con las versiones 2020.1 y posteriores de NetSuite WSDL. Ahora se recomienda que todos los usuarios utilicen TBA.

Precaución

Con la autenticación SSO, los usuarios de Jitterbit cuya suscripción a NetSuite esté limitada a un solo hilo de procesamiento podrían experimentar problemas de rendimiento. Estos usuarios deberían usar TBA. Los usuarios de NetSuite con una licencia de SuiteCloud Plus pueden usar cualquiera de los dos tipos de autenticación, ya que esta permite una mayor concurrencia de hilos.

Advertencia

Quienes utilicen la autenticación de dos factores (TFA o 2FA) de NetSuite no deben usar el tipo de autenticación SSO. Esto podría provocar un fallo en su extremo de NetSuite. En su lugar, utilice TBA.
TBA: TBA (Autenticación basada en token) está disponible para quienes utilizan Jitterbit Design Studio y Agente versiones 9.2 y posteriores. En Jitterbit, el uso de TBA facilita el uso de múltiples subprocesos de procesamiento, lo que resuelve los problemas de rendimiento que pueden experimentar los usuarios de NetSuite limitados por su suscripción.

Nota

Quienes utilizan la autenticación de dos factores (TFA o 2FA) de NetSuite deben usar TBA con Harmony.

Ingresar credenciales

Haga clic en Siguiente para continuar. Las siguientes pantallas dependen de si ha seleccionado SSO o TBA.

SSO

Introduzca las credenciales de inicio de sesión único (SSO) para su nuevo extremo de NetSuite. A continuación, se muestra un ejemplo. Cada opción configurable se explica a continuación.

adjunto

Nombre: Ingrese un nombre apropiado para su nuevo extremo de NetSuite. Si crea extremos para varias cuentas de NetSuite, conviene distinguirlos aquí por su nombre.
Cuenta: Ingrese el ID de cuenta de NetSuite asociado con su cuenta de NetSuite.

Nota

Si utiliza el ambiente sandbox de NetSuite, esto ahora se indica mediante el ID de cuenta de NetSuite. Por ejemplo, el ID de cuenta puede ir acompañado de _SB1, _SB2, etc.

Debido a que NetSuite ya no utiliza una URL de sandbox independiente y ahora el sandbox se indica mediante el ID de cuenta, la casilla de verificación Sandbox se ha eliminado en Design Studio versión 9.2 y posteriores.

Puede encontrar más información en la documentación de NetSuite Acerca de las cuentas Sandbox en el dominio de NetSuite.
Correo: Ingrese la dirección de correo que utiliza para iniciar sesión en su cuenta de NetSuite.
Rol del Centro de atención al cliente: Marque esta casilla si está utilizando el rol del Centro de atención al cliente de NetSuite para controlar los permisos.
Contraseña: Ingrese la contraseña que utiliza para iniciar sesión en su cuenta de NetSuite.
URL de descarga de WSDL: Introduzca la URL específica de la cuenta del WSDL de NetSuite utilizado por la instancia de NetSuite. Jitterbit admite las versiones de WSDL que se indican en Requisitos más arriba en esta página. Las instrucciones para obtener la URL WSDL específica de la cuenta se encuentran en URL WSDL específica de la cuenta de NetSuite.

ID de la aplicación: Si lo desea, introduzca su ID de aplicación, si NetSuite le ha asignado uno. De lo contrario, deje este campo en blanco.

Consejo

Para generar un nuevo ID de aplicación para Jitterbit o para localizar uno que ya exista, consulte Cómo obtener un ID de aplicación de NetSuite.
Tiempo de espera de llamada: Opcionalmente, introduzca el tiempo de espera de llamada en segundos si desea que sea menor que el configurado por el agente.

Nota

La configuración predeterminada del agente para el tiempo de espera de las llamadas de NetSuite es 300 segundos.

Por confirmar

Para obtener los valores necesarios para esta pantalla, debe tener TBA habilitado para su cuenta de NetSuite después de configurar TBA en NetSuite, introduzca las credenciales de TBA para su nuevo extremo de NetSuite. A continuación, se muestra un ejemplo. Cada opción configurable se explica a continuación.

Credenciales del asistente de extremo TBA

Nombre: Ingrese un nombre apropiado para su nuevo extremo de NetSuite. Si crea extremos para varias cuentas de NetSuite, conviene distinguirlos aquí por su nombre.
Cuenta: Ingrese el ID de cuenta de NetSuite asociado con su cuenta de NetSuite.

Nota

Si utiliza el ambiente sandbox de NetSuite, esto ahora se indica mediante el ID de cuenta de NetSuite. Por ejemplo, el ID de cuenta puede ir acompañado de _SB1, _SB2, etc.

Debido a que NetSuite ya no utiliza una URL de sandbox independiente y ahora el sandbox se indica mediante el ID de cuenta, la casilla de verificación Sandbox se ha eliminado en Design Studio versión 9.2 y posteriores.

Puede encontrar más información en la documentación de NetSuite Acerca de las cuentas Sandbox en el dominio de NetSuite.
URL de descarga de WSDL: Introduzca la URL específica de la cuenta del WSDL de NetSuite utilizado por la instancia de NetSuite. Jitterbit admite las versiones de WSDL que se indican en Requisitos más arriba en esta página. Las instrucciones para obtener la URL WSDL específica de la cuenta se encuentran en URL WSDL específica de la cuenta de NetSuite.
Clave de consumidor y Secreto de consumidor: Introduzca los valores de la clave de consumidor y el secreto de consumidor de NetSuite obtenidos de NetSuite. Para obtener instrucciones sobre cómo obtener estos valores, consulte Habilitar TBA en NetSuite.
Clave de token y Secreto de token: Introduzca los valores de ID de token y Secreto de token de NetSuite obtenidos de NetSuite. Para obtener instrucciones sobre cómo obtener estos valores, consulte Habilitar TBA en NetSuite.

Precaución

Si está utilizando una cuenta de sandbox de NetSuite, cada vez que se actualice el sandbox, deberá crear nuevos tokens.

Algoritmo de firma: Utilice el menú desplegable para seleccionar el algoritmo de firma que se usará para firmar la solicitud: HMAC-SHA1 o HMAC-SHA256. El algoritmo de firma determina cómo se cifra la carga útil.
Nota

NetSuite ha dejado obsoleto HMAC-SHA1 como método de firma válido en favor de HMAC-SHA256 a partir de estas versiones:
- Cuentas que no son de producción: NetSuite versión 2021.2 y posteriores.
- Cuentas de producción: NetSuite versión 2023.1 y posteriores.
La desuso de HMAC-SHA1 es independiente de la versión de WSDL que especifique en la configuración del extremo de NetSuite.

Advertencia

Si actualmente utiliza HMAC-SHA1, le recomendamos cambiar el algoritmo de firma a HMAC-SHA256 lo antes posible para evitar problemas con sus integraciones. Para obtener más información y los pasos para cambiar el algoritmo de firma, consulte Desuso de HMAC-SHA1 de NetSuite.
Tiempo de espera de llamada: Opcionalmente, introduzca el tiempo de espera de llamada en segundos si desea que sea menor que el configurado por el agente.

Nota

La configuración predeterminada del agente para el tiempo de espera de las llamadas de NetSuite es 300 segundos.
Reintentar en caso de excepción recuperable (etiquetado como Habilitar opción de reintento en las versiones 10.36 y 10.37): Esta opción está disponible en Design Studio 10.36 y posteriores, y solo funciona cuando se utiliza un ambiente asociado a un grupo de agentes privados cuyos agentes sean de la versión 10.24 o posterior. Su comportamiento depende de la versión del agente privado. Al seleccionarse, esta configuración se utiliza para reintentar una solicitud rechazada a NetSuite cuando se cumple alguno de estos criterios:
- Agentes privados 10.24 y posteriores: Se alcanzó el límite de gobernanza de NetSuite para solicitudes simultáneas y se muestra el error WS_REQUEST_BLOCKED se devuelve.
- Agentes privados 10.36 y posteriores: NetSuite no devuelve una respuesta en el plazo esperado y se produce una excepción de tiempo de espera.
Para consultar los límites de concurrencia de su cuenta de NetSuite, en la interfaz de usuario de NetSuite, vaya a Configuración > Integración > Gobernanza de la integración. Para obtener más información, consulte la documentación de NetSuite sobre Límites de gobernanza de concurrencia según los niveles de servicio y las licencias de SuiteCloud Plus.

Para que esta configuración surta efecto, la variable Jitterbit jitterbit.netsuite.async no debe no estar configurado en true arriba en la cadena de la operación.

Con agentes privados versión 10.23 o anterior, en agentes en la nube, o si la variable asincrónica Jitterbit está habilitada, esta configuración se ignorará.

Seleccione la casilla de verificación Reintentar en caso de excepción recuperable para habilitar opciones de configuración adicionales:
- Número máximo de reintentos (denominado Reintento máximo en las versiones 10.36 y 10.37): Ingrese el número de veces (máximo de 5 reintentos) que se reenviará a NetSuite una solicitud rechazada. Si la solicitud sigue siendo rechazada después del número máximo de reintentos, se devolverá una excepción con un mensaje de error en el registro de operación. Además, el agente privado registrará cada reintento en el jitterbit-agent.log archivo de registro.
  
  Cada reintento se trata como parte de la misma ejecución de operación, donde solo aparece un único registro en el registro de operación. Cualquier condición En caso de éxito o En caso de error configurada para ejecutar operaciones abajo en la cadena se activa en función del estado final de la operación después de volver a intentarlo hasta el número máximo de reintentos.
- Intervalo de reintento: Ingrese la cantidad de segundos (máximo de 5 segundos) que debe esperar entre el reenvío de una solicitud rechazada a NetSuite.

Verificar credenciales (sso)

Nota

Este paso no está disponible para TBA. En su lugar, quienes usan TBA pueden verificar sus credenciales con el botón Probar conexión, como se describe en la siguiente sección, Editar o probar un extremo.

Solo para el tipo de autenticación SSO, al hacer clic en Finalizar, Jitterbit verificará las credenciales proporcionadas.

Si la configuración se completa correctamente, se creará su nuevo extremo de NetSuite. La pantalla de configuración del extremo se abrirá en la vista principal de Studio. Puede volver a la pantalla de configuración en cualquier momento haciendo doble clic en el extremo en el árbol de la izquierda, en Conectores > NetSuite > Extremos de NetSuite. Si no tiene éxito, aparecerá un mensaje indicando un problema con las credenciales. Puede crear el extremo y modificar las credenciales más tarde.

Editar o probar un extremo

Una vez creado el extremo, puede volver a la pantalla de configuración en cualquier momento haciendo doble clic en el extremo en el árbol de la izquierda, en Conectores > NetSuite > Extremos de NetSuite.

SSO

Para la autenticación SSO, la pantalla de configuración será similar a la que se muestra a continuación.

attachment

Nombre: Cambie el nombre de su extremo de NetSuite. Si crea extremos para varias cuentas de NetSuite, conviene distinguirlos aquí por su nombre.
Pasaporte: Esta sección contiene la información ingresada al crear el extremo. Aquí se listan la Cuenta y el Correo. También puede editar aquí los campos URL de descarga WSDL y, opcionalmente, el ID de la aplicación y el Tiempo de espera de llamada. Estos campos son los mismos que los descritos anteriormente en esta página.
Convertir a TBA: Esta opción está disponible en Design Studio versión 9.3.1 y posteriores.

Haga clic en el botón Convertir a TBA para abrir una ventana emergente donde podrá ingresar las credenciales para cambiar el tipo de autenticación de SSO a TBA. El valor de cada campo se encuentra en la sección Ingresar credenciales de esta página) en el TBA sección.
Editar credenciales: Haga clic en el botón Editar credenciales para editar la configuración de Cuenta, Correo, Contraseña o Rol en el Centro de Atención al Cliente. Estas opciones son las mismas que las descritas anteriormente en esta página.
Probar conexión: Haga clic en el botón Probar conexión para verificar la conexión a su cuenta de NetSuite. Un mensaje le indicará si la conexión es correcta. Si no es correcta, asegúrese de cumplir con los prerrequisitos y vuelva a verificar los valores que proporcionó en esta pantalla. Si recibe un error al probar la conexión, consulte información de solución de problemas.

Por confirmar

Para el tipo de autenticación TBA, la configuración será similar a la que se muestra a continuación.

configuración del extremo TBA

Nombre: Cambie el nombre de su extremo de NetSuite. Si crea extremos para varias cuentas de NetSuite, conviene distinguirlos aquí por su nombre.
Pasaporte por determinar: Esta sección contiene la información ingresada al crear el extremo. Puede editar cualquiera de los campos disponibles en la configuración original, como se describe más arriba en esta página.
Probar conexión: Haga clic en el botón Probar conexión para verificar la conexión a su cuenta de NetSuite. Un mensaje le indicará si la conexión es correcta. Si no es correcta, asegúrese de cumplir con los prerrequisitos y vuelva a verificar los valores que proporcionó en esta pantalla. Si recibe un error al probar la conexión, consulte información de solución de problemas.