Utilice NetSuite TBA en NetSuite Connector¶

Introducción¶

Esta página describe cómo utilizar la autenticación basada en token (TBA) utilizando el Conector NetSuite de Jitterbit. Antes de configurar TBA en Jitterbit, consulte las recomendaciones de Jitterbit para habilitar TBA en NetSuite.

Estas instrucciones asumen que ya está utilizando la autenticación SSO en un extremo NetSuite y desea cambiar el método de autenticación para usar TBA. Para obtener documentación completa sobre la configuración de un nuevo extremo TBA o SSO, consulte NetSuite Connector Extremo.

Para usar NetSuite Connector para convertir un extremo NetSuite existente configurado con autenticación SSO para usar TBA, siga los pasos en esta página:

1. Crear una copia de seguridad
2. Convertir a TBA
3. Probar el Extremo

Requisitos Previos¶

Para utilizar TBA con NetSuite Connector en Jitterbit, se deben cumplir estos criterios:

1. Debe tener la rol de permisos adecuada en su cuenta NetSuite.

2. Debe utilizar SuiteTalk versión 2015.2 o posterior.

3. Debe tener TBA habilitado para su cuenta NetSuite.

4. Debes utilizar Harmony Agents versión 9.2 o posterior y Design Studio versión 9.3.1 o posterior para convertir un extremo de SSO existente para usar TBA.

Crear una Copia de Seguridad¶

Primero, es posible que desees crear un Jitterpak para tener una copia de seguridad del proyecto si es necesario.

Convertir a TBA¶

Abra su extremo de NetSuite existente haciendo doble clic en el extremo en el árbol de la izquierda debajo de Conectores > NetSuite > Extremos de NetSuite.

En la configuración, haga clic en el botón Convertir a TBA.

En la ventana emergente, ingrese los valores que utilizará Jitterbit para autenticarse con su instancia de NetSuite usando TBA. Luego haga clic en Guardar.

• Cuenta: Ingrese el ID de cuenta de NetSuite asociado con su cuenta NetSuite. Para obtener instrucciones sobre cómo obtener este valor, consulte Habilitar TBA en NetSuite.

• URL de descarga de Wsdl: Ingrese la URL específica de la cuenta del WSDL de NetSuite utilizado por la instancia de NetSuite. Jitterbit admite las versiones WSDL enumeradas 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 NetSuite.

  Nota

  Inicialmente, se recomienda utilizar la misma versión de WSDL que su extremo SSO existente. Si necesita actualizar su WSDL, se recomienda hacerlo por separado. Este es un paso recomendado para solucionar problemas, de modo que si experimenta problemas se pueda determinar la causa.

• 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.

• Token Key y Token Secret: Introduzca los valores de NetSuite Token ID y Token Secret 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 zona de pruebas de NetSuite, cada vez que se actualice la zona de pruebas, 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 HMAC-SHA1 o HMAC-SHA256. El algoritmo de firma determina cómo se cifra la carga útil.

  Nota

  NetSuite ha dejado de utilizar 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 obsolescencia de HMAC-SHA1 es independiente de la versión de WSDL que especifique en la configuración del extremo NetSuite.

• Tiempo de espera de la llamada: Opcionalmente, ingrese el valor del tiempo de espera de la 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 NetSuite es de 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á presente en las versiones 10.36 y posteriores de Design Studio y solo funciona cuando se utiliza una ambiente asociado con un Grupo de Agentes Privados cuyos agentes sean la versión 10.24 o posterior. Su comportamiento depende de la versión de 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 simultáneas y aparece el error WS_REQUEST_BLOCKED es regresado.
  • 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 simultaneidad de su cuenta NetSuite, en la interfaz de usuario de NetSuite, vaya a Configuración > Integración > Gobierno de 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 surta efecto, la variable Jitterbit jitterbit.netsuite.async no debe estar configurado en true arriba en la cadena de la operación.

  Con Agentes Privados versión 10.23 o anterior, en Agentes en Nube, o si la variable asíncrona 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 el número de veces (máximo de 5 reintentos) que se realizará una solicitud rechazada. ser reenviado a NetSuite. Si la solicitud aún se rechaza 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 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 reintentar hasta el número máximo de reintentos.

  • Intervalo de reintento: Ingrese la cantidad de segundos (máximo de 5 segundos) que se deben esperar entre el reenvío de una solicitud rechazada a NetSuite.

Pruebe el Extremo¶

Después de crear su extremo, haga doble clic en el extremo en el árbol de la izquierda debajo de Conectores > NetSuite > NetSuite Extremos.

Luego haga clic en el botón Probar conexión para verificar la conexión a su cuenta NetSuite.

Un mensaje le indicará si la conexión se realizó correctamente. Si la conexión no se realiza correctamente, 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.

Después de haber probado con éxito su extremo NetSuite TBA, simplemente desplegar su proyecto para comenzar a usar TBA.