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.

Importante

Oracle está descontinuando gradualmente los puntos finales del servicio web SOAP de NetSuite. La última versión planificada del servicio web SOAP (2025.2) se admite hasta 2028.

Si bien no se requiere ninguna acción inmediata si está utilizando el punto final de la versión 2025.2, es posible conectarse a los servicios web REST de SuiteTalk con el conector HTTP v2 para actualizarse antes de la línea de tiempo de Oracle.

Para más información, consulte preguntas sobre la línea de tiempo de eliminación de SOAP de NetSuite y la guía de actualización de servicios web SOAP de NetSuite a servicios web REST.

Crear o editar una conexión a NetSuite

Una nueva conexión de NetSuite se crea utilizando el conector de NetSuite desde una de estas ubicaciones:

Una conexión de 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ú que enumera 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 inclinadas (/) 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: Ingresa el ID de cuenta de NetSuite asociado con la cuenta de NetSuite que deseas utilizar. Las cuentas asociadas con un entorno de sandbox de NetSuite pueden estar indicadas con un sufijo como SB1, SB2, etc.

  • URL de descarga de WSDL: Ingresa la URL específica de la cuenta de NetSuite del WSDL utilizado por la instancia de NetSuite. Jitterbit admite las versiones de WSDL listadas 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 de consumidor y Secreto de consumidor: Ingresa los valores de Clave de consumidor y Secreto de consumidor de NetSuite. Si utilizaste el paquete de registro de integración proporcionado por Jitterbit (ver prerrequisitos de NetSuite), utiliza 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 los valores de ID de token y Secreto de token de NetSuite 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 actualice el sandbox, necesitarás crear nuevos tokens.

  • Algoritmo de firma: Se utiliza el algoritmo de firma HMAC-SHA256 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 la 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 cualquiera 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 tu cuenta de NetSuite, en la interfaz de usuario de NetSuite, ve a Configuración > Integración > Gobernanza de Integración. Para más información, consulta 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 la versión 10.23 o anterior de agentes privados, 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 enviará nuevamente 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) que se esperará entre el reenvío de una solicitud rechazada a NetSuite.

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

    • Habilitar 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 versiones de agentes 11.52 o posteriores.

      • 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 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 pedirá que confirme que desea descartar los cambios.

  • Eliminar: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulta Dependencias de componentes, eliminación y remoción). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Siguientes 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, consulta Menús de acciones en Conceptos básicos del conector.

Después de configurar una conexión de NetSuite, puedes configurar una o más actividades de NetSuite asociadas con esa conexión para ser utilizadas ya sea como fuente para proporcionar datos a una operación o como destino para consumir datos en una operación, o puedes 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 fuente para proporcionar datos en una operación.

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

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

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

  • Upsert: Tanto actualiza registros existentes como crea nuevos registros en NetSuite y está destinado a ser utilizado como destino 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.