Extremo del Conector NetSuite¶

Introducción¶

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

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

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 fuente o destino HTTP
• Usando un Método de Servicio Web
• Utilizar el controlador JDBC de Oracle NetSuite con un Origen o destino de la base de datos

Requisitos Previos¶

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

• Jitterbit ha verificado la compatibilidad con NetSuite WSDL versión 2023.2. NetSuite admite 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:

  • 2024.1
  • 2023.2
  • 2023.1
  • 2022.2
  • 2022.1
  • 2021.2

  Jitterbit ha verificado la compatibilidad anterior con las versiones anteriores de WSDL disponibles, 2017.1 a 2021.1, que ya no son soportadas por NetSuite. Versiones WSDL anteriores se enumeran en la documentación oficial de NetSuite. Aunque estas versiones siguen técnicamente disponibles, se desaconseja el uso de cualquier WSDL con más de un año de antigüedad y le recomendamos encarecidamente que actualice a una versión de 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 WSDL se proporcionan en URL WSDL específica de la cuenta NetSuite.

• NetSuite WSDL 2021.2, 2022.1, 2022.2, 2023.1, 2023.2 y 2024.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 NetSuite.

  • Para configurar un nuevo extremo TBA, debe utilizar Harmony Design Studio y Agente versiones 9.2 o posteriores.

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

• Integración NetSuite – SuiteTalk (servicios web)
• NetSuite – Gestión de usuarios y aplicaciones Funciones
• NetSuite : introducción a la autenticación basada en tokens

Crear un Extremo¶

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

• Vaya a Archivo > Nuevo > Conectores > Nuevo Extremo de NetSuite.
• En el árbol de la izquierda debajo de Conectores, haga clic con el botón derecho en la categoría NetSuite y luego seleccione Nuevo Extremo de NetSuite.
• En el árbol de la izquierda bajo Conectores, haga doble clic en la categoría NetSuite, luego haga clic derecho en Nuevo NetSuite Extremo y seleccione Nuevo NetSuite Extremo.
• En la barra de herramientas superior, haga clic en el icono del conector (pieza de rompecabezas naranja) . En la ventana emergente, seleccione NetSuite, luego 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 NetSuite Connector está disponible. NetSuite ha dejado de utilizar 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 deberían utilizar TBA. Los usuarios de NetSuite con una licencia SuiteCloud Plus pueden utilizar cualquier tipo de autenticación, ya que este tipo de licencia permite una mayor concurrencia de subprocesos.

  Advertencia

  Aquellos que usan la autenticación de dos factores NetSuite (TFA o 2FA) no deben usar el tipo de autenticación SSO. Hacerlo puede provocar que falle su extremo NetSuite. En su lugar, utilice TBA.

• TBA: TBA (autenticación basada en token) está disponible para quienes usan Harmony Design Studio y Agente versiones 9.2 y después. En Jitterbit, el uso de TBA facilita el uso de múltiples subprocesos de procesamiento, resolviendo así los problemas de rendimiento que pueden experimentar los usuarios de NetSuite limitados por su suscripción a NetSuite.

  Nota

  Aquellos que usan la autenticación de dos factores NetSuite (TFA o 2FA) en NetSuite deben usar 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 NetSuite. A continuación se proporciona un ejemplo. Cada opción configurable se explica a continuación.

• Nombre: Ingrese un nombre apropiado para su nuevo extremo NetSuite. Si está creando extremos para varias cuentas de NetSuite, es una buena idea distinguirlas aquí por su nombre.

• Cuenta: Ingrese el ID de la cuenta NetSuite asociada con su cuenta NetSuite.

  Nota

  Si está utilizando el ambiente sandbox de NetSuite, esto ahora se indica mediante el ID de cuenta de NetSuite. Por ejemplo, al ID de la cuenta se le puede agregar _SB1, _SB2, etc.

  Debido a que NetSuite ya no utiliza una URL de zona de pruebas separada y la zona de pruebas ahora se indica mediante ID de cuenta, la casilla de verificación de Zona de pruebas se eliminó en Design Studio versiones 9.2 y después.

  Puede encontrar más información en la documentación de NetSuite Acerca de las cuentas Sandbox en el dominio NetSuite.

• Correo: Ingrese la dirección de correo que utiliza para iniciar sesión en su cuenta NetSuite.

• Rol del Centro de Atención al Cliente: Marque esta casilla si está utilizando la 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 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.

• ID de aplicación: Opcionalmente, ingrese su ID de aplicación, si NetSuite le ha emitido uno. En caso contrario, deje este campo en blanco.

  Consejo

  Para generar una nueva ID de aplicación para Jitterbit o para localizar una que ya existe, consulte Obtener una ID de aplicación NetSuite.

• Tiempo de espera de 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.

por Confirmar¶

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

• Nombre: Ingrese un nombre apropiado para su nuevo extremo NetSuite. Si está creando extremos para varias cuentas de NetSuite, es una buena idea distinguirlas aquí por su nombre.

• Cuenta: Ingrese el ID de la cuenta NetSuite asociada con su cuenta NetSuite.

  Nota

  Si está utilizando el ambiente sandbox de NetSuite, esto ahora se indica mediante el ID de cuenta de NetSuite. Por ejemplo, al ID de la cuenta se le puede agregar _SB1, _SB2, etc.

  Debido a que NetSuite ya no utiliza una URL de zona de pruebas separada y la zona de pruebas ahora se indica mediante ID de cuenta, la casilla de verificación de Zona de pruebas se eliminó en Design Studio versiones 9.2 y después.

  Puede encontrar más información en la documentación de NetSuite Acerca de las cuentas Sandbox en el dominio 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.

• 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 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 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 excepción recuperable (etiquetado 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 un ambiente asociado con un Grupo de Agentes Privados cuyos agentes tienen 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 rechazará una solicitud. 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 operación ejecutada, 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.

Verificar Credenciales (sso)¶

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

• Si tiene éxito, se creará su nuevo extremo 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 bajo Conectores > NetSuite > NetSuite Extremos.
• Si no tiene éxito, aparecerá un mensaje indicando un problema con las credenciales. Aún puede optar por crear el extremo y modificar las credenciales más adelante.

Editar o Probar un Extremo¶

Después de crear su 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 > NetSuite Extremos.

SSO¶

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

• Nombre: Cambie el nombre de su extremo NetSuite existente. Si está creando extremos para varias cuentas de NetSuite, es una buena idea distinguirlas aquí por su 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 Wsdl Download Url y los campos opcionales Application ID y Call Time Out 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 después.

  Haga clic en el botón Convertir a TBA para abrir una ventana emergente e ingresar las credenciales para cambiar el tipo de autenticación de SSO a TBA. El valor utilizado para cada campo está 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 las configuraciones de Cuenta, Correo, Contraseña o Función del 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 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.

por Confirmar¶

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

• Nombre: Cambie el nombre de su extremo NetSuite existente. Si está creando extremos para varias cuentas de NetSuite, es una buena idea distinguirlas aquí por su nombre.
• Pasaporte TBA: 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 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 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.