Usar TBA de NetSuite en el conector de NetSuite en Jitterbit Design Studio

Introducción

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

Estas instrucciones suponen que ya está utilizando autenticación SSO en un punto final de NetSuite y desea cambiar el método de autenticación para usar TBA. Para obtener la documentación completa sobre cómo configurar un nuevo punto final TBA o SSO, consulte punto final del conector de NetSuite.

Para usar el Conector de NetSuite para convertir un punto final existente de NetSuite configurado con autenticación SSO a TBA, siga los pasos en esta página:

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

Requisitos previos

Para usar TBA con el Conector de NetSuite en Jitterbit, se deben cumplir los siguientes criterios:

1. Debe tener el rol de permisos apropiado en su cuenta de NetSuite.

2. Debe estar utilizando la versión 2015.2 o posterior de SuiteTalk.

3. Debe tener TBA habilitado para su cuenta de NetSuite.

4. Debe estar utilizando versiones de agentes de Jitterbit 9.2 o posteriores y la versión 9.3.1 o posterior de Design Studio para convertir un punto final SSO existente a 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

Abre tu endpoint de NetSuite existente haciendo doble clic en el endpoint en el árbol a la izquierda bajo Conectores > NetSuite > Endpoints de NetSuite.

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

En la ventana emergente, ingresa los valores que se utilizarán para que Jitterbit se autentique con tu instancia de NetSuite usando TBA. Luego haz clic en Guardar.

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

• Url de descarga de Wsdl: Ingresa la URL específica de la cuenta del WSDL de NetSuite utilizado 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 del WSDL específica de la cuenta se proporcionan en URL de WSDL específica de la cuenta de NetSuite.

  Nota

  Inicialmente, se recomienda usar la misma versión de WSDL que tu endpoint SSO existente. Si necesitas actualizar tu WSDL, se recomienda hacerlo por separado. Este es un paso recomendado para fines de solución de problemas, de modo que si experimentas problemas, se pueda determinar la causa.

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

• Token Key y Token Secret: Ingrese los valores de Token ID y Token Secret de NetSuite obtenidos de NetSuite. Para 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, necesitará crear nuevos tokens.

• Signature Algorithm: Use 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 descontinuado HMAC-SHA1 como un método de firma válido a favor de HMAC-SHA256 a partir de estas versiones:

  • Cuentas No Productivas: Versión 2021.2 de NetSuite y posteriores.
  • Cuentas Productivas: Versión 2023.1 de NetSuite y posteriores.

  La descontinuación de HMAC-SHA1 es independiente de qué versión de WSDL especifique en la configuración del endpoint de NetSuite.

  Advertencia

  Si actualmente está utilizando HMAC-SHA1, recomendamos cambiar el algoritmo de firma a HMAC-SHA256 lo antes posible para evitar problemas con sus integraciones. Para más información y pasos para cambiar el algoritmo de firma, consulte Descontinuación de HMAC-SHA1 en NetSuite.

• Call Time Out: Opcionalmente, ingrese el valor de tiempo de espera de la llamada en segundos, si desea 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 a 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 privado 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 alguno 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 tiempo esperado y ocurre 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 Integración. Para 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 de Jitterbit jitterbit.netsuite.async no debe estar configurada como true antes de la operación.

Con agentes privados en la versión 10.23 o anteriores, en agentes en la nube, o si la variable asíncrona de Jitterbit está habilitada, esta configuración será ignorada.

Seleccione la casilla Reintentar en Excepción Recuperable para habilitar opciones de configuración adicionales:

• Número Máximo de Reintentos (etiquetado como Max Retry en las versiones 10.36 y 10.37): Ingrese el número de veces (máximo de 5 reintentos) que se volverá a enviar 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. Cualquier condición de En Éxito o En Fallo configurada para ejecutar operaciones posteriores 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 el número de segundos (máximo de 5 segundos) que se debe esperar entre el reenvío de una solicitud rechazada a NetSuite.

Prueba el endpoint

Después de crear tu endpoint, haz doble clic en el endpoint en el árbol a la izquierda bajo Conectores > NetSuite > Endpoints de NetSuite.

Luego, haz clic en el botón Probar conexión 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 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.

Después de haber probado con éxito tu endpoint TBA de NetSuite, simplemente despliega tu proyecto para comenzar a usar TBA.