Endpoint del conector NetSuite en Jitterbit Design Studio

Introducción

Antes de crear operaciones de NetSuite en Jitterbit usando el Conector NetSuite, debes configurar al menos un endpoint de NetSuite.

Cada endpoint representa la URL y las credenciales de inicio de sesión para una cuenta específica de NetSuite. La creación del endpoint permite que Jitterbit acceda a la cuenta para realizar las operaciones solicitadas. Si tu organización utiliza múltiples cuentas de NetSuite, necesitarás crear un endpoint para cada cuenta.

Otras formas de conectarse a NetSuite desde Design 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 una fuente o destino HTTP
• Usar un método de servicio web
• Usar el controlador JDBC de Oracle NetSuite con una fuente o destino de base de datos

Requisitos previos

Para usar correctamente el Conector NetSuite de Jitterbit en integraciones de NetSuite, se deben cumplir estos criterios:

• Jitterbit ha verificado soporte para la versión WSDL 2025.2 de NetSuite. NetSuite admite las seis versiones más recientes de su WSDL en todo momento. Por lo tanto, recomendamos que la instancia de NetSuite use una de estas versiones de WSDL:

  • 2025.2
  • 2025.1
  • 2024.2
  • 2024.1
  • 2023.2
  • 2023.1

  Jitterbit ha verificado soporte previo para versiones WSDL más antiguas disponibles de 2017.1 a 2022.2, que ya no son compatibles con NetSuite. Las versiones WSDL más antiguas se encuentran en la documentación oficial de NetSuite. Aunque estas versiones siguen siendo técnicamente disponibles, usar cualquier WSDL con más de un año de antigüedad es una práctica desaconsejada, y recomendamos encarecidamente que actualices a una versión WSDL compatible.

• 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 URL de WSDL específica de la cuenta de NetSuite.

• Las versiones WSDL de NetSuite 2021.2 a 2025.2 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.
• NetSuite WSDLs hasta 2018.2 requieren Harmony Cloud o agentes privados versión 9.9 o posterior.

• Para usar autenticación basada en tokens (TBA):

  • Debes estar usando SuiteTalk versión 2015.2 o posterior.

  • Debes tener TBA habilitado para tu cuenta de NetSuite.

  • Para configurar un nuevo endpoint de TBA, debes estar usando Jitterbit Design Studio y versiones de Agent 9.2 o posterior.

  • Para convertir un endpoint SSO existente para usar TBA, debes estar usando Jitterbit Design Studio versión 9.3.1 o posterior y versiones de Agent 9.2 o posterior.

Deprecación de servicios web SOAP de NetSuite

Crear un punto final

Dentro de tu proyecto en Jitterbit Studio, hay varias formas de iniciar un nuevo punto final de NetSuite:

• Ve a Archivo > Nuevo > Conectores > Nuevo punto final de NetSuite.
• En el árbol de la izquierda bajo Conectores, haz clic derecho en la categoría NetSuite y luego selecciona Nuevo punto final de NetSuite.
• En el árbol de la izquierda bajo Conectores, haz doble clic en la categoría NetSuite, luego haz clic derecho en Nuevo punto final de NetSuite y selecciona Nuevo punto final de NetSuite.
• En la barra de herramientas superior, haz clic en el icono del conector (pieza de rompecabezas naranja) . En la ventana emergente, selecciona NetSuite y luego selecciona Punto final de NetSuite.

Seleccionar tipo de autenticación

En la primera pantalla del asistente de punto final de NetSuite, elige cómo deseas que Jitterbit se autentique con tu instancia de NetSuite utilizando las credenciales proporcionadas en la siguiente pantalla. Cada opción se explica a continuación.

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

  Precaución

  Con el tipo de autenticación SSO, los usuarios de Jitterbit cuya suscripción a NetSuite se limita a un único hilo de procesamiento pueden experimentar problemas de rendimiento. Estos usuarios deben utilizar TBA. Los usuarios de NetSuite con una licencia de SuiteCloud Plus pueden utilizar cualquiera de los dos tipos de autenticación, ya que este tipo de licencia permite una mayor concurrencia de hilos.

  Advertencia

  Aquellos que utilizan autenticación de dos factores de NetSuite (TFA o 2FA) no deben utilizar el tipo de autenticación SSO. Hacerlo puede causar que tu punto final de NetSuite falle. En su lugar, utiliza TBA.

• TBA: TBA (Autenticación basada en tokens) está disponible para aquellos que utilizan Jitterbit Design Studio y versiones de Agent 9.2 y posteriores. En Jitterbit, el uso de TBA facilita el uso de múltiples hilos de procesamiento, lo que resuelve los problemas de rendimiento que pueden experimentar los usuarios de NetSuite limitados por su suscripción a NetSuite.

  Nota

  Aquellos que utilizan autenticación de dos factores de NetSuite (TFA o 2FA) en NetSuite deben utilizar TBA con Harmony.

Ingresar credenciales

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

SSO

Ingresa las credenciales de SSO para tu nuevo punto final de NetSuite. A continuación se proporciona un ejemplo. Cada opción configurable se explica de la siguiente manera.

• Nombre: Ingresa un nombre apropiado para tu nuevo endpoint de NetSuite. Si estás creando endpoints para múltiples cuentas de NetSuite, es una buena idea distinguirlos aquí por nombre.

• Cuenta: Ingresa el ID de cuenta de NetSuite asociado con tu cuenta de NetSuite.

  Nota

  Si estás utilizando el entorno sandbox de NetSuite, ahora se indica mediante el ID de cuenta de NetSuite. Por ejemplo, el ID de cuenta puede tener anexado _SB1, _SB2, etc.

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

  Puedes encontrar más información en la documentación de NetSuite About Sandbox Accounts on the NetSuite Domain.

• Correo electrónico: Ingresa la dirección de correo electrónico que utilizas para iniciar sesión en tu cuenta de NetSuite.

• Rol del Centro de Clientes: Marca esta casilla si estás utilizando el rol Centro de Clientes de NetSuite para controlar permisos.

• Contraseña: Ingresa la contraseña que utilizas para iniciar sesión en tu cuenta de NetSuite.

• URL de Descarga de WSDL: Ingresa la URL específica de la cuenta del WSDL de NetSuite utilizada por la instancia de NetSuite. Jitterbit admite las versiones de WSDL enumeradas en Requisitos previos anteriormente en esta página. Las instrucciones para obtener la URL de WSDL específica de la cuenta se proporcionan en URL de WSDL específica de la cuenta de NetSuite.

• ID de aplicación: Opcionalmente, ingresa tu ID de aplicación si NetSuite te ha emitido uno. Si no es así, deja este campo en blanco.

  Consejo

  Para generar un nuevo ID de aplicación para Jitterbit o para localizar uno que ya existe, consulta Getting a NetSuite application ID.

• Tiempo de espera de llamada: Opcionalmente, ingresa el valor de tiempo de espera de llamada en segundos, si deseas que el valor de tiempo de espera sea menor que la configuración del agente.

  Nota

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

TBA

Para obtener los valores necesarios para esta pantalla, debes haber habilitado TBA para tu cuenta de NetSuite. Después de configurar TBA en NetSuite, ingresa las credenciales de TBA para tu nuevo endpoint de NetSuite. A continuación se proporciona un ejemplo. Cada opción configurable se explica de la siguiente manera.

• Nombre: Ingresa un nombre apropiado para tu nuevo endpoint de NetSuite. Si estás creando endpoints para múltiples cuentas de NetSuite, es una buena idea distinguirlos aquí por nombre.

• Cuenta: Ingresa el ID de cuenta de NetSuite asociado con tu cuenta de NetSuite.

  Nota

  Si estás utilizando el entorno sandbox de NetSuite, ahora se indica mediante el ID de cuenta de NetSuite. Por ejemplo, el ID de cuenta puede tener anexado _SB1, _SB2, etc.

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

  Puedes encontrar más información en la documentación de NetSuite About Sandbox Accounts on the NetSuite Domain.

• URL de Descarga de WSDL: Ingresa la URL específica de la cuenta del WSDL de NetSuite utilizada por la instancia de NetSuite. Jitterbit admite las versiones de WSDL enumeradas en Requisitos previos anteriormente en esta página. Las instrucciones para obtener la URL de WSDL específica de la cuenta se proporcionan en URL de WSDL específica de la cuenta de NetSuite.

• Consumer Key y Consumer Secret: Ingresa los valores de Consumer Key y Consumer Secret de NetSuite obtenidos de NetSuite. Para obtener instrucciones sobre cómo obtener estos valores, consulta Habilitar TBA en NetSuite.

• Token Key y Token Secret: Ingresa los valores de Token ID y Token Secret de NetSuite obtenidos de NetSuite. Para obtener instrucciones sobre cómo obtener estos valores, consulta Habilitar TBA en NetSuite.

  Precaución

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

• Signature Algorithm: Utiliza el menú desplegable para seleccionar el algoritmo de firma que se utilizará para firmar la solicitud, ya sea HMAC-SHA1 o HMAC-SHA256. El algoritmo de firma determina cómo se cifra la carga útil.

  Nota

  NetSuite ha dejado de usar HMAC-SHA1 como método de firma válido en favor de HMAC-SHA256 a partir de estas versiones:

  • Cuentas de no producción: NetSuite versión 2021.2 y posteriores.
  • Cuentas de producción: NetSuite versión 2023.1 y posteriores.

  La desaprobación de HMAC-SHA1 es independiente de la versión de WSDL que especifiques en la configuración del endpoint de NetSuite.

  Advertencia

  Si actualmente utilizas HMAC-SHA1, te recomendamos cambiar el algoritmo de firma a HMAC-SHA256 lo antes posible para evitar problemas con tus integraciones. Para obtener más información y pasos para cambiar el algoritmo de firma, consulta Desaprobación de HMAC-SHA1 en NetSuite.

• Call Time Out: Opcionalmente, ingresa el valor de tiempo de espera de la llamada en segundos, si deseas que el valor de tiempo de espera sea menor que la configuración del agente.

  Nota

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

• Retry on Recoverable Exception (etiquetado como Enable Retry Option en las versiones 10.36 y 10.37): Esta opción está presente en las versiones 10.36 y posteriores de Design Studio, y es funcional solo cuando se utiliza un entorno asociado con un grupo de agentes privados cuyos agentes son versión 10.24 o posteriores. Su comportamiento depende de la versión del agente privado. Cuando se selecciona, esta configuración se utiliza para reintentar una solicitud rechazada a NetSuite cuando se cumple cualquiera de estos criterios:

  • Agentes privados 10.24 y posteriores: Se alcanza el límite de gobernanza de NetSuite para solicitudes concurrentes y se devuelve el error WS_REQUEST_BLOCKED.
  • 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 verificar los límites de concurrencia de tu cuenta de NetSuite, en la interfaz de usuario de NetSuite, ve a Setup > Integration > Integration Governance. Para obtener más información, consulta la documentación de NetSuite sobre Límites de gobernanza de concurrencia basados en niveles de servicio y licencias de SuiteCloud Plus.

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

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

  Selecciona la casilla de verificación Retry on Recoverable Exception para habilitar opciones de configuración adicionales:

  

  • Maximum Number of Retries (etiquetado como Max Retry en las versiones 10.36 y 10.37): Ingresa el número de veces (máximo de 5 reintentos) que se reenviará una solicitud rechazada a NetSuite. 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 operaciones. Además, el agente privado registrará cada reintento en el archivo de registro jitterbit-agent.log.

Cada reintento se trata como parte de la misma ejecución de operación, donde solo aparece un único registro en el registro de operaciones. Las condiciones On Success u On Failure configuradas para ejecutar operaciones descendentes se activan según el estado final de la operación después de reintentar hasta el número máximo de reintentos.

• Retry Interval: Ingresa el número de segundos (máximo de 5 segundos) a esperar entre reintentos de envío de una solicitud rechazada a NetSuite.

Verificar credenciales (sso)

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

• Si es exitoso, se creará tu nuevo endpoint de NetSuite. La pantalla de configuración del endpoint se abrirá en la vista principal de Studio. Puedes volver a la pantalla de configuración en cualquier momento haciendo doble clic en el endpoint en el árbol de la izquierda bajo Connectors > NetSuite > NetSuite Endpoints.
• Si no es exitoso, aparecerá un mensaje indicando un problema con las credenciales. Aún puedes elegir crear el endpoint y modificar las credenciales más tarde.

Editar o probar un endpoint

Después de crear tu endpoint, puedes volver a la pantalla de configuración en cualquier momento haciendo doble clic en el endpoint en el árbol de la izquierda bajo Connectors > NetSuite > NetSuite Endpoints.

SSO

Para el tipo de autenticación SSO, la pantalla de configuración se verá similar a la siguiente.

• Name: Renombra tu endpoint de NetSuite existente. Si estás creando endpoints para múltiples cuentas de NetSuite, es una buena idea distinguirlas aquí por nombre.

• Passport: Esta sección contiene la información ingresada cuando se creó el endpoint. La Account y el Email se enumeran aquí. También puedes editar los campos Wsdl Download Url, Application ID opcional y Call Time Out aquí. Estos campos son los mismos que se describieron anteriormente en esta página.

• Convert to TBA: Esta opción está disponible en Design Studio versión 9.3.1 y posteriores.

  Haz clic en el botón Convert to TBA para abrir una ventana emergente e ingresar credenciales para cambiar el tipo de autenticación de SSO a TBA. El valor utilizado para cada campo se documenta anteriormente en esta página bajo Enter credentials en la sección TBA.

  

• Edit Credentials: Haz clic en el botón Edit Credentials para editar la configuración de Account, Email, Password o Customer Center Role. Estas opciones son las mismas que se describieron anteriormente en esta página.

• Test Connection: Haz clic en el botón Test Connection para verificar la conexión a tu cuenta de NetSuite. Un mensaje indicará si la conexión es exitosa. Si la conexión no es exitosa, asegúrate de cumplir con los requisitos previos y verifica nuevamente los valores que proporcionaste en esta pantalla. Si recibes un error al probar la conexión, consulta la información de solución de problemas.

TBA

Para el tipo de autenticación TBA, la configuración se verá similar a la siguiente.

• Name: Renombra tu endpoint de NetSuite existente. Si estás creando endpoints para múltiples cuentas de NetSuite, es una buena idea distinguirlas aquí por nombre.
• TBA Passport: Esta sección contiene la información ingresada cuando se creó el endpoint. Puedes editar cualquiera de los campos disponibles de la configuración original, como se describe anteriormente en esta página.
• Test Connection: Haz clic en el botón Test Connection para verificar la conexión a tu cuenta de NetSuite. Un mensaje indicará si la conexión es exitosa. Si la conexión no es exitosa, asegúrate de cumplir con los requisitos previos y verifica nuevamente los valores que proporcionaste en esta pantalla. Si recibes un error al probar la conexión, consulta la información de solución de problemas.