Configurare NetSuite
Configura la Token-Based Authentication (TBA) per collegare Order Invoicer a NetSuite
Prerequisiti
Prima di iniziare, assicurati che:
- Disponga di un account NetSuite attivo (produzione o sandbox)
- Disponga dell'accesso come amministratore al suo account NetSuite
- Le funzionalità SuiteTalk REST Web Services e Token-Based Authentication siano abilitate
Order Invoicer si collega a NetSuite tramite Token-Based Authentication (TBA / OAuth 1.0a). Dovrà quindi fornire cinque valori:
- Account ID (ad es.
1234567oppure1234567_SB1per una sandbox) - Consumer Key e Consumer Secret (da un record Integration)
- Token ID e Token Secret (da un Access Token)
Abilitare le funzionalità necessarie
Abilitare SuiteTalk REST e TBA
- Acceda a NetSuite con un account amministratore
- Vada su Setup → Company → Enable Features
- Nella scheda SuiteCloud, selezioni:
- ✅ REST Web Services
- ✅ Token-Based Authentication
- Salvi
Se queste opzioni non compaiono, verifichi che la sua licenza NetSuite includa SuiteCloud Plus. Contatti il suo rivenditore NetSuite se necessario.
Recuperare l'Account ID
Individuare l'Account ID
- Vada su Setup → Company → Company Information
- Prenda nota del valore del campo Account ID (ad es.
1234567in produzione,1234567_SB1per una sandbox)
L'Account ID viene utilizzato nell'URL dell'API (https://{accountId}.suitetalk.api.netsuite.com) e nella firma di ciascuna richiesta. Lo mantenga così com'è — Order Invoicer lo normalizza automaticamente.
Creare un record Integration
Il record Integration fornisce la coppia Consumer Key / Consumer Secret.
Creare l'Integration
- Vada su Setup → Integration → Manage Integrations → New
- Compili:
- Name:
Order Invoicer - State:
Enabled
- Name:
- Selezioni:
- ✅ Token-Based Authentication
- ❌ Deselezioni gli altri metodi (TBA: Authorization Flow, OAuth 2.0, User Credentials)
- Faccia clic su Save
Copiare la Consumer Key e la Consumer Secret
Dopo il salvataggio, NetSuite visualizza una sola volta:
- Consumer Key
- Consumer Secret
Copi immediatamente entrambi i valori e li conservi in un luogo sicuro.
Questi valori vengono visualizzati una sola volta. Se li perde, dovrà reimpostare l'Integration.
Creare un ruolo e un utente dedicati
Order Invoicer consiglia un utente dedicato con un ruolo minimo per limitare l'ambito dell'accesso.
Creare un ruolo
- Vada su Setup → Users/Roles → Manage Roles → New
- Compili Name:
Order Invoicer Integration - Nella scheda Permissions → Setup, aggiunga:
- ✅ Log in using Access Tokens (Full)
- ✅ REST Web Services (Full)
- ✅ User Access Tokens (Full)
- Nella scheda Permissions → Lists, aggiunga:
- ✅ Customers (Full)
- ✅ Items (View)
- ✅ Subsidiaries (View) — solo per gli account OneWorld
- Nella scheda Permissions → Transactions, aggiunga:
- ✅ Invoice (Full)
- ✅ Find Transaction (View)
- Faccia clic su Save
Assegnare il ruolo a un utente
- Vada su Setup → Users/Roles → Manage Users
- Selezioni o crei un utente dedicato (ad es.
order-invoicer@votre-domaine.com) - Nella scheda Access, aggiunga il ruolo
Order Invoicer Integration - Faccia clic su Save
L'utente non ha bisogno di accedere all'interfaccia NetSuite — l'Access Token agisce per suo conto.
Creare un Access Token
L'Access Token fornisce la coppia Token ID / Token Secret.
Generare il token
- Vada su Setup → Users/Roles → Access Tokens → New
- Selezioni:
- Application Name:
Order Invoicer(l'Integration creata in precedenza) - User: l'utente dedicato
- Role:
Order Invoicer Integration
- Application Name:
- Token Name:
Order Invoicer Token - Faccia clic su Save
Copiare il Token ID e il Token Secret
NetSuite visualizza una sola volta:
- Token ID
- Token Secret
Copi immediatamente entrambi.
Come per l'Integration, questi valori vengono visualizzati solo al momento della creazione. Se li perde, dovrà rigenerare l'Access Token.
Inserire le credenziali in Order Invoicer
Dal modulo di connessione NetSuite in Order Invoicer, compili i cinque campi:
| Campo | Valore |
|---|---|
| NetSuite Account ID | 1234567 oppure 1234567_SB1 |
| Consumer Key | dall'Integration |
| Consumer Secret | dall'Integration |
| Token ID | dall'Access Token |
| Token Secret | dall'Access Token |
Il connettore convalida automaticamente le sue credenziali effettuando una richiesta firmata all'API NetSuite.
Risoluzione dei problemi
Errore "Invalid credentials"
- Verifichi che i cinque valori siano stati copiati per intero, senza spazi iniziali o finali
- Account ID: se il suo account è una sandbox, il suffisso
_SB1(o_SB2, ecc.) è obbligatorio - Verifichi che l'Integration e l'Access Token siano nello stato Enabled (non revocati)
- Verifichi che il ruolo disponga delle autorizzazioni Log in using Access Tokens e REST Web Services
Errore "INSUFFICIENT_PERMISSION"
- Il ruolo assegnato all'utente non dispone delle autorizzazioni Customers (Full) o Invoice (Full)
- Aggiorni le autorizzazioni del ruolo e riprovi
Errore "INVALID_LOGIN_ATTEMPT"
- L'utente collegato al token è disabilitato o non ha più accesso al ruolo
- Verifichi la scheda Access dell'utente
Creazione della fattura rifiutata su un account OneWorld
- Gli account OneWorld richiedono un campo
subsidiaryobbligatorio su clienti e fatture - Questa prima versione di Order Invoicer non popola ancora questo campo — contatti la nostra assistenza per abilitare il mapping delle subsidiary
Riferimento API
Assistenza
Se incontra difficoltà:
- Consulti la sezione sulla risoluzione dei problemi qui sopra
- Consulti la documentazione ufficiale di NetSuite
- Contatti la nostra assistenza:
contact@orderinvoicer.com