Autenticarse en Oracle NetSuite con un rol personalizado

Este artículo enumera los permisos mínimos de NetSuite necesarios para que un rol personalizado pueda usar los RESTlets de la SuiteApp de Payhawk. La SuiteApp ya no requiere el rol de administrador: puede usarse cualquier rol que tenga acceso a la autenticación basada en tokens (TBA) y los permisos que se indican a continuación.

Documentación de referencia

• Documentación de permisos: resumen  archivo descargable NetSuitePermissionsUsage.xls

• Nombres e ID de permisos: tabla completa de ID para SuiteScript

• Roles y consideraciones sobre permisos para API: requisitos específicos de la API

• Niveles de acceso para permisos: definiciones de Ninguno / Ver / Crear / Editar / Completo

• Personalizar o crear roles de NetSuite: guía paso a paso

Crear un rol personalizado

Para crear un rol específico para la integración con Payhawk, sigue estos pasos:

1. En Oracle NetSuite, ve a Configuración > Usuarios/Roles > Gestionar roles > Nuevo.

2. Asigna un nombre al rol, por ejemplo, Integración con Payhawk.

3. En el registro del rol, marca Rol solo para servicios web (recomendado: evita el inicio de sesión en la interfaz de usuario con este rol).

4. Añade los permisos indicados que se indican a continuación en las subpestañas de Permisos (Configuración, Transacciones, Listas).

5. Guarda el rol.

6. Asigna el rol al usuario: Listas > Empleados > [Usuario] > Acceso > Roles.

Permisos

Transacciones

Página del rol → Permisos → subpestaña Transacciones

Informes

Página del rol → Permisos → subpestaña Informes

Listas

Página del rol → Permisos → subpestaña Listas

Configuración

Página del rol → Permisos → subpestaña Configuración

Permisos globales del usuario

Notas para desarrolladores

Endpoints genéricos: records-restlet y suiteql-restlet son endpoints genéricos que pueden acceder a cualquier tipo de registro. El rol debe tener permisos para cada tipo de registro consultado a través de ellos. Si falta algún permiso, estos endpoints devolverán un error estructurado.

• Compatibilidad con versiones anteriores: la SuiteApp sigue funcionando con el rol de administrador. No se requieren cambios para las conexiones existentes que utilizan Administrador.

• Referencia completa de permisos: para comprender todas las implicaciones de los permisos de NetSuite, descarga el archivo oficial NetSuitePermissionsUsage.xls.

Solución de problemas

Diagnóstico: consulta el registro de auditoría de inicio de sesión en Configuración > Usuarios/Roles > Ver registro de auditoría de inicio de sesión. Añade las columnas Detalle, Nombre del token de acceso basado en tokens y Nombre de la aplicación basada en tokens para ver los motivos detallados de los errores.

INSUFFICIENT_PERMISSION / insufficient-permissions (permisos insuficientes)

Este error significa que la autenticación TBA se realizó correctamente, pero el rol no tiene permisos para el registro u operación específicos. records-restlet y suiteql-restlet devuelven un error estructurado:

{ "errors": [{ "code": "insufficient-permissions", "message": "..." }] }

Añade el permiso que falte de las tablas anteriores. El mensaje de error suele indicar el tipo de registro al que se necesita acceso.

Permission_denied (permiso denegado)

Este error a nivel de TBA significa que no se puede utilizar el rol o la entidad de usuario. Verifica que:

1. El rol está activo (no deshabilitado).

2. El usuario no ha marcado el rol como inactivo en su página Ver mis roles.

3. El rol tiene asignados permisos de TBA.