Configurar NetSuite
Configure la autenticación basada en tokens (TBA) para conectar Order Invoicer a NetSuite
Requisitos previos
Antes de comenzar, asegúrese de que:
- Dispone de una cuenta de NetSuite activa (producción o sandbox)
- Tiene acceso de administrador a su cuenta de NetSuite
- Las funciones SuiteTalk REST Web Services y Token-Based Authentication están habilitadas
Order Invoicer se conecta a NetSuite mediante autenticación basada en tokens (TBA / OAuth 1.0a). Por lo tanto, deberá proporcionar cinco valores:
- Account ID (p. ej.
1234567o1234567_SB1para un sandbox) - Consumer Key y Consumer Secret (de un registro Integration)
- Token ID y Token Secret (de un Access Token)
Habilite las funciones necesarias
Habilite SuiteTalk REST y TBA
- Inicie sesión en NetSuite con una cuenta de administrador
- Vaya a Setup → Company → Enable Features
- En la pestaña SuiteCloud, marque:
- ✅ REST Web Services
- ✅ Token-Based Authentication
- Guarde
Si estas opciones no aparecen, compruebe que su licencia de NetSuite incluye SuiteCloud Plus. Póngase en contacto con su distribuidor de NetSuite si es necesario.
Recupere su Account ID
Localice su Account ID
- Vaya a Setup → Company → Company Information
- Anote el valor del campo Account ID (p. ej.
1234567en producción,1234567_SB1para un sandbox)
El Account ID se utiliza en la URL de la API (https://{accountId}.suitetalk.api.netsuite.com) y en la firma de cada solicitud. Manténgalo tal cual: Order Invoicer lo normaliza automáticamente.
Cree un registro Integration
El registro Integration proporciona el par Consumer Key / Consumer Secret.
Cree la Integration
- Vaya a Setup → Integration → Manage Integrations → New
- Rellene:
- Name:
Order Invoicer - State:
Enabled
- Name:
- Marque:
- ✅ Token-Based Authentication
- ❌ Desmarque los demás métodos (TBA: Authorization Flow, OAuth 2.0, User Credentials)
- Haga clic en Save
Copie el Consumer Key y el Consumer Secret
Después de guardar, NetSuite muestra una sola vez:
- Consumer Key
- Consumer Secret
Copie ambos valores de inmediato y guárdelos en un lugar seguro.
Estos valores solo se muestran una vez. Si los pierde, tendrá que reiniciar la Integration.
Cree un rol y un usuario dedicados
Order Invoicer recomienda un usuario dedicado con un rol mínimo para limitar el alcance del acceso.
Cree un rol
- Vaya a Setup → Users/Roles → Manage Roles → New
- Rellene Name:
Order Invoicer Integration - En la pestaña Permissions → Setup, añada:
- ✅ Log in using Access Tokens (Full)
- ✅ REST Web Services (Full)
- ✅ User Access Tokens (Full)
- En la pestaña Permissions → Lists, añada:
- ✅ Customers (Full)
- ✅ Items (View)
- ✅ Subsidiaries (View) — solo para cuentas OneWorld
- En la pestaña Permissions → Transactions, añada:
- ✅ Invoice (Full)
- ✅ Find Transaction (View)
- Haga clic en Save
Asigne el rol a un usuario
- Vaya a Setup → Users/Roles → Manage Users
- Seleccione o cree un usuario dedicado (p. ej.
order-invoicer@votre-domaine.com) - En la pestaña Access, añada el rol
Order Invoicer Integration - Haga clic en Save
El usuario no necesita iniciar sesión en la interfaz de NetSuite: el Access Token actúa en su nombre.
Cree un Access Token
El Access Token proporciona el par Token ID / Token Secret.
Genere el token
- Vaya a Setup → Users/Roles → Access Tokens → New
- Seleccione:
- Application Name:
Order Invoicer(la Integration creada anteriormente) - User: el usuario dedicado
- Role:
Order Invoicer Integration
- Application Name:
- Token Name:
Order Invoicer Token - Haga clic en Save
Copie el Token ID y el Token Secret
NetSuite muestra una sola vez:
- Token ID
- Token Secret
Copie ambos de inmediato.
Al igual que con la Integration, estos valores solo se muestran en el momento de la creación. Si los pierde, tendrá que regenerar el Access Token.
Introduzca sus credenciales en Order Invoicer
Desde el formulario de conexión de NetSuite en Order Invoicer, rellene los cinco campos:
| Campo | Valor |
|---|---|
| NetSuite Account ID | 1234567 o 1234567_SB1 |
| Consumer Key | de la Integration |
| Consumer Secret | de la Integration |
| Token ID | del Access Token |
| Token Secret | del Access Token |
El conector valida automáticamente sus credenciales realizando una solicitud firmada a la API de NetSuite.
Resolución de problemas
Error «Credenciales no válidas»
- Compruebe que los cinco valores se copiaron por completo, sin espacios al principio ni al final
- Account ID: si su cuenta es un sandbox, el sufijo
_SB1(o_SB2, etc.) es obligatorio - Compruebe que la Integration y el Access Token están en estado Enabled (no revocados)
- Compruebe que el rol tiene los permisos Log in using Access Tokens y REST Web Services
Error «INSUFFICIENT_PERMISSION»
- El rol asignado al usuario no tiene los permisos Customers (Full) o Invoice (Full)
- Actualice los permisos del rol e inténtelo de nuevo
Error «INVALID_LOGIN_ATTEMPT»
- El usuario vinculado al token está deshabilitado o ya no tiene acceso al rol
- Compruebe la pestaña Access del usuario
Creación de factura rechazada en una cuenta OneWorld
- Las cuentas OneWorld requieren un campo
subsidiaryobligatorio en los clientes y las facturas - Esta primera versión de Order Invoicer aún no rellena este campo: póngase en contacto con nuestro soporte para habilitar el mapeo de subsidiarias
Referencia de la API
Soporte
Si tiene dificultades:
- Consulte la sección de resolución de problemas anterior
- Consulte la documentación oficial de NetSuite
- Póngase en contacto con nuestro soporte:
contact@orderinvoicer.com