Saltar al contenido

Conexión a NetSuite

Introducción

Una conexión a NetSuite, creada utilizando el conector de NetSuite, establece acceso a NetSuite. Una vez que se configura una conexión, se pueden crear instancias de actividades de NetSuite asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Nota

Este conector admite la Política de Re-autenticación al Cambiar política de organización. Si está habilitada, un cambio en la Cuenta, Clave del Consumidor o Clave del Token en esta conexión requiere que los usuarios vuelvan a ingresar el Secreto del Consumidor y el Secreto del Token para la conexión.

Crear o editar una conexión a NetSuite

Se crea una nueva conexión a NetSuite utilizando el conector de NetSuite desde una de estas ubicaciones:

Una conexión a NetSuite existente se puede editar desde estas ubicaciones:

Configurar una conexión de NetSuite

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de NetSuite se describe a continuación.

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú con las variables existentes de las que elegir.

  • Nombre de la conexión: Ingrese un nombre para identificar la conexión de NetSuite. El nombre debe ser único para cada conexión de NetSuite y no debe contener barras diagonales (/) ni dos puntos (:). Este nombre también se utiliza para identificar el punto final de NetSuite, que se refiere tanto a una conexión específica como a sus actividades.

  • Cuenta: Ingrese el ID de cuenta de NetSuite asociado con la cuenta de NetSuite que desea utilizar. Las cuentas asociadas con un entorno de sandbox de NetSuite pueden indicarse con un sufijo como SB1, SB2, etc.

  • 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 de WSDL enumeradas en prerrequisitos de NetSuite. Las instrucciones para obtener la URL de WSDL específica de la cuenta se proporcionan en Usar una URL de WSDL específica de la cuenta de NetSuite.

  • Clave del consumidor y Secreto del consumidor: Ingrese los valores de Clave del consumidor y Secreto del consumidor de NetSuite. Si utilizó el paquete de registro de integración proporcionado por Jitterbit (ver prerrequisitos de NetSuite), utilice los siguientes valores:

    • Clave de consumidor: 768b136f26ea98b957e7dd2e87bad89077ca2ec484a0cb72c5a8e1b003627213

    • Secreto de consumidor: 0dbf3d5e3c2d2ff72ef1a8e8d564d5786da2f60006ad97a00246d7ce924c8b51

    Si creaste el registro de integración de otra manera, sigue los pasos descritos en Reunir valores para usar NetSuite TBA para obtener los valores a utilizar.

  • Clave de token y Secreto de token: Ingresa el ID de token y los valores de secreto de token obtenidos de NetSuite. Para instrucciones sobre cómo obtener estos valores, consulta Reunir valores para usar NetSuite TBA.

    Precaución

    Si estás utilizando una cuenta de sandbox de NetSuite, cada vez que se actualiza el sandbox, necesitas crear nuevos tokens.

  • Algoritmo de firma: El algoritmo de firma HMAC-SHA256 se utiliza para firmar la solicitud y no se puede cambiar. 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 especifiques en la configuración de la conexión de NetSuite.

  • Tiempo de espera de llamada: 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 predeterminada del agente.

    Nota

    La configuración predeterminada del agente para el tiempo de espera de las llamadas de NetSuite es de 300 segundos. Para agentes privados, este valor predeterminado se puede cambiar en la sección [Connectorsinfo] del archivo de configuración del agente privado.

  • Reintentar en excepción recuperable: Esta configuración es funcional solo cuando se utiliza un entorno 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 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 de 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 expandir opciones de configuración adicionales.

    • Número máximo de reintentos: 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 considera parte de la misma ejecución de operación, donde solo aparece un único registro en el registro de operaciones. Cualquier acción de operación 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 (segundos): Ingrese el número de segundos (máximo de 5 segundos) para esperar entre el reenvío de una solicitud rechazada a NetSuite.

  • Configuraciones opcionales: Haga clic para expandir configuraciones opcionales adicionales:

  • Habilitar la paginación de NetSuite: Seleccione para habilitar el soporte para tipos de registros de NetSuite con más de 1,000 campos personalizados. Esta opción requiere agentes versión 11.52 o posterior.

    -   **Límite de paginación de NetSuite:** Ingrese el número de campos personalizados a soportar, hasta un máximo de `2000`. El valor predeterminado es `1000`.

  • Probar: Haga clic para verificar la conexión utilizando las credenciales proporcionadas.

    Precaución

    Si recibe un error relacionado con el centro de datos al probar la conexión, es posible que necesite usar una URL WSDL diferente. Para más información, consulte error del centro de datos de NetSuite.

  • Guardar cambios: Haga clic para guardar y cerrar la configuración de la conexión.

  • Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.

  • Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje le pide que confirme que desea eliminar la conexión.

Próximos pasos

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulte Menús de acciones en Conceptos básicos del conector.

Después de configurar una conexión de NetSuite, puede configurar una o más actividades de NetSuite asociadas con esa conexión para ser utilizadas ya sea como una fuente para proporcionar datos a una operación o como un destino para consumir datos en una operación, o puede usar la conexión de NetSuite dentro de un script.

Configurar actividades

Estos tipos de actividad están disponibles:

  • Buscar: Recupera registros existentes de NetSuite y está destinado a ser utilizado como una fuente para proporcionar datos en una operación.

  • Crear: Crea nuevos registros en NetSuite y está destinado a ser utilizado como un objetivo en una operación.

  • Actualizar: Actualiza registros existentes en NetSuite y está destinado a ser utilizado como un objetivo en una operación.

  • Obtener lista: Recupera una lista de registros existentes basados en ID de NetSuite y está destinado a ser utilizado como un objetivo en una operación.

  • Upsert: Tanto actualiza registros existentes como crea nuevos registros en NetSuite y está destinado a ser utilizado como un objetivo en una operación.

  • Eliminar: Elimina registros en NetSuite y está destinado a ser utilizado como un objetivo en una operación.

Usar conexiones de NetSuite en scripts

Las conexiones de NetSuite se pueden referenciar en un script utilizando funciones de script que utilizan un netSuiteOrg como parámetro. Para más información, consulta Usar funciones de NetSuite.