Centro de soporte de Workiva

Con el conector de Autenticación por token de NetSuite®, puedes utilizar los comandos en cadena para interactuar con NetSuite. Por ejemplo, con este conector, puedes:

• Descargar archivos de NetSuite.
• Enumerar las búsquedas guardadas en NetSuite
• Recuperar datos sobre un registro estándar de NetSuite o una búsqueda guardada.

Nota: Este conector ha sido creado por Workiva y conecta con un sistema de terceros. Aunque nuestro equipo de asistencia puede ayudarte a configurar este conector dentro de tu espacio de trabajo, no podemos solucionar ni ayudar de ningún otro modo con los problemas que se originen fuera de la plataforma Workiva.

Requisitos previos

Para habilitar la conexión, el conector utiliza la API REST de NetSuite. Para configurar el conector, necesitarás:

• NetSuite, con autenticación basada en token (TBA) activado
• El ID de la cuenta de NetSuite a la que conectarse

  Nota: Para ver el ID de tu cuenta en NetSuite, selecciona Configuración, Integraciones, Preferencias de Servicios Web. El ID también suele aparecer en la primera cadena de la URL, justo antes de app.netsuite.com.

• Un registro de integración y un token de acceso creados en NetSuite para el conector.
• La clave y el secreto del consumidor del registro de integración

  Nota: Si no tienes el secreto o la clave del consumidor, edita el registro de integración y restablece sus credenciales.

• El ID y el secreto del token de acceso. Si no tienes el ID o la contraseña del token de acceso, tendrás que crear un nuevo token.

Nota: Para interactuar con un RESTlet de NetSuite utilizando la autenticación OAuth 2.0, utiliza en su lugar un conector de solicitudes HTTP.

Activar la integración en NetSuite

Para que el conector pueda interactuar con NetSuite, necesita autenticación basada en token (TBA) y su propio registro de integración.

Paso 1. Habilitar los servicios web SOAP y la autenticación basada en token

Para habilitar los servicios web SOAP y TBA para NetSuite:

1. En NetSuite, selecciona Configuración, Empresa, Habilitar funciones.
2. En la pestaña SuiteCloud , en SuiteScript, selecciona Cliente SuiteScript y Servidor SuiteScript.
   
3. Debajo de SuiteTalk (Servicios web), selecciona Servicios web SOAP.
   
4. Debajo de Gestionar autenticación, selecciona Autenticación basada en token.
5. Haz clic en Guardar.

Paso 2. Crear un registro de integración

Después de activar la TBA, crea un registro de integración para el conector:

1. En NetSuite, selecciona Configuración, Integraciones, Gestionar integraciones, Nueva.
2. Para ayudar a identificar la integración, introduce un nombre que sea único y una descripción, como Integración de Workiva.
   
3. En Autenticación, selecciona Autenticación basada en token, y borra TBA: Flujo de Autorización.
4. Haz clic en Guardar, y guarda la clave de consumidor y el secreto desde la página de confirmación.

Tecla: La clave y el secreto del consumidor aparecen solo en la página de confirmación del registro de integración. Asegúrate de registrar estos valores para las propiedades del conector, y trátalos como una Contraseña.

Etapa 3. Crear un rol de integración

Por motivos de seguridad, crea un rol dedicado en NetSuite para gestionar tus integraciones:

1. Selecciona Configuración, Usuarios/Roles, Gestionar roles, Nuevo.
   
2. Debajo de General, introduce un nombre que sea único para ayudar a identificar el rol, como Integración Workiva/NetSuite.
3. Debajo de Autenticación, selecciona Rol solo servicios web para permitir que el rol se conecte solo a la API de NetSuite, y no inicie sesión en NetSuite directamente.
4. Debajo de Permisos, añade los permisos para habilitar la integración, como Permisos de nivel completo para todas las Transacciones pertinentes, Informes, y Listas en NetSuite.
5. En la pestaña Configuración en Permisos, añade permisos de Nivel completo para:
   
   • Servicios web SOAP
   • Establecer empresa
   • Autenticación basada en tokens:
     • Para que el rol solo se autentique mediante tokens de acceso, Iniciar sesión utilizando tokens de acceso
     • Para que el rol pueda crear y revocar sus propios tokens de acceso, Tokens de acceso de usuario.
       
     
6. Haz clic en Guardar.

Etapa 4. Asigna el rol al usuario de integración.

Después de crear el rol de integración, asígnalo al usuario de integración del conector:

1. En NetSuite, selecciona Configuración, Usuarios/Roles, Gestionar usuarios.
2. Selecciona o crea el usuario de integración para el conector.
   

   Nota: Recomendamos un usuario distinto para cada conector o integración.

3. Debajo, en Roles, asigna el rol de integración al usuario.

Etapa 5. Crea el token de acceso del usuario de integración

Para crear un token de acceso para el usuario de integración:

1. En NetSuite, selecciona Configuración, Usuarios/Roles, Fichas de acceso, Nuevo.
2. Haz clic en Nuevo token de acceso.
   
3. En Nombre de la aplicación, selecciona el registro de integración.
4. En Usuario, selecciona el usuario de integración.
5. En Rol, selecciona el rol de integración.
6. Haz clic en Guardar.
7. Anota el ID y el secreto creados para el token; los necesitarás para las propiedades del conector.

   Nota: Por motivos de seguridad, el identificador y el secreto solo aparecen cuando se crea el código de acceso. Trátalos como tratarías una contraseña. Si no tienes el identificador o el secreto del token para las propiedades del conector, crea un nuevo token para el usuario de la integración.

Establece el conector de Autenticación por Token de NetSuite

Nota: Para que el conector esté disponible para su uso en las cadenas de tu organización, un administrador de seguridad de la organización primero lo habilita desde Configuración.

1. En el Generador de cadenas, haz clic en Conexiones  compare_arrows y, a continuación, en Crear en la parte superior derecha.
2. En Conector Conexión, selecciona Autenticación por token de NetSuite y el CloudRunner predeterminado.
   
3. Introduce un nombre que sea único y una descripción para ayudar a identificar la conexión.
4. En Propiedades, ingresa los detalles de la conexión:
   
   

   Propiedad	Detalles
   ID de cuenta	Introduce el ID de la cuenta NetSuite a la que conectarte.
   Clave del consumidor	Introduce la clave del consumidor para el registro de integración del conector.
   Secreto del consumidor	Introduce el secreto de la propiedad Consumer Key.
   Identificación de token	Introduce el ID del token de acceso del conector.
   Token secreto	Introduce el secreto de la propiedad Token ID.
   Caja de arena	Para conectarte a una cuenta NetSuite de sandbox, marca esta casilla.

   Nota: Todas las credenciales confidenciales se cifran automáticamente y se almacenan con un cifrado Advanced Encryption Standard (AES)-256.

5. Selecciona los entornos para utilizar la conexión y haz clic en Guardar.
6. Para evaluar la conexión, crea y ejecuta una cadena con el comando del conector Crear lista de búsquedas guardadas, y comprueba que devuelve un resultado válido.

Solución de problemas

Campos personalizados

Ten en cuenta que la API de NetSuite no puede devolver campos personalizados. Como alternativa, Preparación de los datos puede crear transformaciones que imiten la lógica de un campo personalizado de Netsuite.

Conexiones

Si falla la conexión a NetSuite:

• Comprueba el ID de cuenta introducido para el conector. Para ver el ID de cuenta en NetSuite, selecciona Configuración, Integraciones, Preferencias de Servicios Web. El ID también suele aparecer justo antes de app.netsuite.com en la URL.
• Verifica la clave de consumidor y el secreto del registro de integración del conector. Si es necesario, edita el registro de integración y restablece sus credenciales para crear una nueva clave de consumidor y un nuevo secreto.
• Verifica el ID y el secreto del token de acceso del conector. Si es necesario, crea un nuevo token para el conector.