Extremo del conector NetSuite
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 para 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 cuenta.
Otras formas de conectarse a NetSuite mediante 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 versión 2023.2. NetSuite es compatible las seis versiones más recientes de su WSDL en cualquier momento. Por lo tanto, recomendamos que la instancia de NetSuite utilice una de estas versiones de WSDL:
- 2024.2
- 2024.1
- 2023.2
- 2023.1
- 2022.2
- 2022.1
Jitterbit ha verificado el soporte previo para versiones WSDL más antiguas disponibles, 2017.1 a 2021.2, que ya no son compatibles con NetSuite. Versiones WSDL más antiguas se encuentran en la documentación oficial de NetSuite. Aunque estas versiones siguen estando disponibles técnicamente, no se recomienda utilizar WSDL de más de un año de antigüedad y recomendamos encarecidamente que actualice a una versión de WSDL compatible.
-
La URL del WSDL debe proporcionarse en el formato de una URL del WSDL específica de la cuenta. Las instrucciones para obtener la URL del WSDL se proporcionan en URL del WSDL específica de la cuenta de NetSuite.
- NetSuite WSDL 2021.2, 2022.1, 2022.2, 2023.1, 2023.2, 2024.1 y 2024.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.
- 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 la versión 2015.2 o posterior de SuiteTalk.
-
Debe tener TBA habilitado para su cuenta de NetSuite.
-
Para configurar un nuevo extremo 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 Agentes versión 9.2 o posterior.
-
Consejo
Para obtener información adicional, consulte la siguiente documentación de NetSuite:
- Integración de NetSuite – SuiteTalk (servicios web)
- NetSuite – Gestión de usuarios y roles
- NetSuite – Introducción a la autenticación basada en tokens
Crear un extremo
Nota
Si aún no está familiarizado con Jitterbit, consulte Comenzar 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.
Seleccione el tipo de autenticación
En la primera pantalla del asistente de extremo de NetSuite, elija cómo desea que Jitterbit se autentique con su 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 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 el tipo de autenticación SSO, los usuarios de Jitterbit cuya suscripción a NetSuite está limitada a un único hilo de procesamiento pueden experimentar problemas con el 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
Quienes utilicen la autenticación de dos factores (TFA o 2FA) de NetSuite no deberían utilizar el tipo de autenticación SSO. Si lo hacen, es posible que su extremo de NetSuite falle. En su lugar, utilice TBA.
-
TBA: TBA (Autenticación basada en token) está disponible para quienes usan Jitterbit Design Studio y Agente versiones 9.2 y versiones 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 a NetSuite.
Nota
Quienes utilicen la autenticación de dos factores (TFA o 2FA) de NetSuite deben utilizar TBA con Harmony. Obtenga más información en Autenticación basada en token de NetSuite 2018.2.
Ingresar credenciales
Haga clic en Siguiente para continuar. Las siguientes pantallas dependen de si ha seleccionado SSO o TBA.
SSO
Ingrese las credenciales de SSO para su nuevo extremo de NetSuite. A continuación, se proporciona un ejemplo. A continuación, se explica cada opción configurable.
-
Nombre: Ingrese un nombre apropiado para su nuevo extremo de NetSuite. Si está creando extremos para varias cuentas de NetSuite, es una buena idea distinguirlos aquí por nombre.
-
Cuenta: Ingrese el ID de cuenta de NetSuite asociada a su cuenta de NetSuite.
Nota
Si está utilizando 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 la ID de cuenta, la casilla de verificación Sandbox se ha eliminado en Design Studio versiones 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: Ingrese la URL específica de la cuenta del WSDL de NetSuite que utiliza la instancia de NetSuite. Jitterbit admite las versiones de WSDL que se enumeran en Requisitos previos anteriormente en esta página. Las instrucciones para obtener la URL WSDL específica de la cuenta se proporcionan en URL WSDL específica de la cuenta de NetSuite.
-
ID de la aplicación: Opcionalmente, ingrese su ID de aplicación, si NetSuite le ha emitido una. 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, ingrese el valor del tiempo de espera de llamada en segundos, si desea que el valor del tiempo de espera sea menor que el valor 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, ingrese las credenciales de TBA para su nuevo extremo de NetSuite. A continuación, se proporciona un ejemplo. A continuación, se explica cada opción configurable.
-
Nombre: Ingrese un nombre apropiado para su nuevo extremo de NetSuite. Si está creando extremos para varias cuentas de NetSuite, es una buena idea distinguirlos aquí por nombre.
-
Cuenta: Ingrese el ID de cuenta de NetSuite asociada a su cuenta de NetSuite.
Nota
Si está utilizando 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 la ID de cuenta, la casilla de verificación Sandbox se ha eliminado en Design Studio versiones 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: Ingrese la URL específica de la cuenta del WSDL de NetSuite que utiliza la instancia de NetSuite. Jitterbit admite las versiones de WSDL que se enumeran en Requisitos previos anteriormente en esta página. Las instrucciones para obtener la URL WSDL específica de la cuenta se proporcionan en URL WSDL específica de la cuenta de NetSuite.
-
Clave de consumidor y Secreto de consumidor: ingrese los valores de Clave de consumidor y 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: ingrese los valores de ID de token de NetSuite y Secreto de token obtenidos de NetSuite. Para obtener instrucciones sobre cómo obtener estos valores, consulte Habilitar TBA en NetSuite.
Precaución
Si está utilizando una cuenta 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 utilizará para firmar la solicitud, uno de los siguientes: 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 a 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.
-
Tiempo de espera de llamada: Ingrese opcionalmente el valor del tiempo de espera de llamada en segundos, si desea que el valor del 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 300 segundos.
-
Retry on Recoverable Exception (etiquetado 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 solo funciona cuando se utiliza un ambiente asociado con un grupo de agentes privados cuyos agentes son de la versión 10.24 o posterior. 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 alcanzó el límite de gobernanza de NetSuite para solicitudes simultáneas y aparece 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 verificar 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 basados en niveles de servicio y licencias de SuiteCloud Plus.
Para que esta configuración tenga efecto, la variable Jitterbit
jitterbit.netsuite.async
No debe configurarse entrue
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 (etiquetado como Reintento máximo en las versiones 10.36 y 10.37): Ingrese la cantidad 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 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 la 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 según el 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) a esperar entre el reenvío de una solicitud rechazada a NetSuite.
- Agentes privados 10.24 y posteriores: Se alcanzó el límite de gobernanza de NetSuite para solicitudes simultáneas y aparece el error
Verificar credenciales (sso)
Nota
Este paso no está disponible para TBA. En cambio, quienes utilicen TBA pueden verificar las credenciales mediante 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 operación se realiza correctamente, se creará el 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 se puede realizar la operación, aparecerá un mensaje indicando que hay un problema con las credenciales. Aún puede optar por 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 el tipo de autenticación SSO, la pantalla de configuración será similar a la que se muestra a continuación.
-
Nombre: Cambie el nombre de su extremo de NetSuite existente. Si está creando extremos para varias cuentas de NetSuite, es una buena idea distinguirlos aquí por nombre.
-
Pasaporte: Esta sección contiene la información ingresada cuando se creó el extremo. La Cuenta y el Correo se enumeran aquí. También puede editar los campos URL de descarga de Wsdl y ID de aplicación y Tiempo de espera de llamada opcionales aquí. 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 en la que podrá ingresar las credenciales para cambiar el tipo de autenticación de SSO a TBA. El valor utilizado para cada campo se encuentra documentado anteriormente en esta página en Ingresar credenciales 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 se describen 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 exitosa. Si la conexión no es exitosa, asegúrese de cumplir con los requisitos previos 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.
- Nombre: Cambie el nombre de su extremo de NetSuite existente. Si está creando extremos para varias cuentas de NetSuite, es una buena idea distinguirlos aquí por nombre.
- TBA Passport: Esta sección contiene la información ingresada cuando se creó el extremo. Puede editar cualquiera de los campos disponibles en la configuración original, como se describe 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 exitosa. Si la conexión no es exitosa, asegúrese de cumplir con los requisitos previos 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.