NetSuite konfigurieren
Richten Sie die Token-Based Authentication (TBA) ein, um Order Invoicer mit NetSuite zu verbinden
Voraussetzungen
Stellen Sie vor dem Beginn sicher, dass:
- Sie über ein aktives NetSuite-Konto verfügen (Produktion oder Sandbox)
- Sie über Administrator-Zugriff auf Ihr NetSuite-Konto verfügen
- Die Funktionen SuiteTalk REST Web Services und Token-Based Authentication aktiviert sind
Order Invoicer verbindet sich mit NetSuite über Token-Based Authentication (TBA / OAuth 1.0a). Sie müssen daher fünf Werte angeben:
- Account ID (z. B.
1234567oder1234567_SB1für eine Sandbox) - Consumer Key und Consumer Secret (aus einem Integration-Datensatz)
- Token ID und Token Secret (aus einem Access Token)
Die erforderlichen Funktionen aktivieren
SuiteTalk REST und TBA aktivieren
- Melden Sie sich mit einem Administratorkonto bei NetSuite an
- Gehen Sie zu Setup → Company → Enable Features
- Aktivieren Sie im Tab SuiteCloud:
- ✅ REST Web Services
- ✅ Token-Based Authentication
- Speichern Sie
Wenn diese Optionen nicht angezeigt werden, überprüfen Sie, ob Ihre NetSuite-Lizenz SuiteCloud Plus umfasst. Wenden Sie sich bei Bedarf an Ihren NetSuite-Reseller.
Ihre Account ID abrufen
Ihre Account ID finden
- Gehen Sie zu Setup → Company → Company Information
- Notieren Sie sich den Wert des Feldes Account ID (z. B.
1234567in der Produktion,1234567_SB1für eine Sandbox)
Die Account ID wird in der API-URL (https://{accountId}.suitetalk.api.netsuite.com) und in der Signatur jeder Anfrage verwendet. Belassen Sie sie unverändert – Order Invoicer normalisiert sie automatisch.
Einen Integration-Datensatz erstellen
Der Integration-Datensatz stellt das Paar Consumer Key / Consumer Secret bereit.
Die Integration erstellen
- Gehen Sie zu Setup → Integration → Manage Integrations → New
- Füllen Sie aus:
- Name:
Order Invoicer - State:
Enabled
- Name:
- Aktivieren Sie:
- ✅ Token-Based Authentication
- ❌ Deaktivieren Sie die anderen Methoden (TBA: Authorization Flow, OAuth 2.0, User Credentials)
- Klicken Sie auf Save
Den Consumer Key und das Consumer Secret kopieren
Nach dem Speichern zeigt NetSuite nur einmal an:
- Consumer Key
- Consumer Secret
Kopieren Sie beide Werte sofort und bewahren Sie sie an einem sicheren Ort auf.
Diese Werte werden nur einmal angezeigt. Wenn Sie sie verlieren, müssen Sie die Integration zurücksetzen.
Eine dedizierte Rolle und einen dedizierten Benutzer erstellen
Order Invoicer empfiehlt einen dedizierten Benutzer mit einer minimalen Rolle, um den Zugriffsumfang zu begrenzen.
Eine Rolle erstellen
- Gehen Sie zu Setup → Users/Roles → Manage Roles → New
- Füllen Sie Name aus:
Order Invoicer Integration - Fügen Sie im Tab Permissions → Setup hinzu:
- ✅ Log in using Access Tokens (Full)
- ✅ REST Web Services (Full)
- ✅ User Access Tokens (Full)
- Fügen Sie im Tab Permissions → Lists hinzu:
- ✅ Customers (Full)
- ✅ Items (View)
- ✅ Subsidiaries (View) — nur für OneWorld-Konten
- Fügen Sie im Tab Permissions → Transactions hinzu:
- ✅ Invoice (Full)
- ✅ Find Transaction (View)
- Klicken Sie auf Save
Die Rolle einem Benutzer zuweisen
- Gehen Sie zu Setup → Users/Roles → Manage Users
- Wählen oder erstellen Sie einen dedizierten Benutzer (z. B.
order-invoicer@votre-domaine.com) - Fügen Sie im Tab Access die Rolle
Order Invoicer Integrationhinzu - Klicken Sie auf Save
Der Benutzer muss sich nicht bei der NetSuite-Oberfläche anmelden – das Access Token handelt in seinem Namen.
Ein Access Token erstellen
Das Access Token stellt das Paar Token ID / Token Secret bereit.
Das Token generieren
- Gehen Sie zu Setup → Users/Roles → Access Tokens → New
- Wählen Sie aus:
- Application Name:
Order Invoicer(die zuvor erstellte Integration) - User: der dedizierte Benutzer
- Role:
Order Invoicer Integration
- Application Name:
- Token Name:
Order Invoicer Token - Klicken Sie auf Save
Die Token ID und das Token Secret kopieren
NetSuite zeigt nur einmal an:
- Token ID
- Token Secret
Kopieren Sie beide sofort.
Wie bei der Integration werden diese Werte nur bei der Erstellung angezeigt. Falls verloren, müssen Sie das Access Token neu generieren.
Ihre Anmeldedaten in Order Invoicer eingeben
Füllen Sie im NetSuite-Verbindungsformular in Order Invoicer die fünf Felder aus:
| Feld | Wert |
|---|---|
| NetSuite Account ID | 1234567 oder 1234567_SB1 |
| Consumer Key | aus der Integration |
| Consumer Secret | aus der Integration |
| Token ID | aus dem Access Token |
| Token Secret | aus dem Access Token |
Der Connector validiert Ihre Anmeldedaten automatisch, indem er eine signierte Anfrage an die NetSuite-API stellt.
Fehlerbehebung
Fehler „Ungültige Anmeldedaten“
- Überprüfen Sie, ob die fünf Werte vollständig und ohne führende oder abschließende Leerzeichen kopiert wurden
- Account ID: Wenn Ihr Konto eine Sandbox ist, ist das Suffix
_SB1(oder_SB2usw.) erforderlich - Überprüfen Sie, ob sich die Integration und das Access Token im Status Enabled befinden (nicht widerrufen)
- Überprüfen Sie, ob die Rolle über die Berechtigungen Log in using Access Tokens und REST Web Services verfügt
Fehler „INSUFFICIENT_PERMISSION“
- Die dem Benutzer zugewiesene Rolle verfügt nicht über die Berechtigungen Customers (Full) oder Invoice (Full)
- Aktualisieren Sie die Berechtigungen der Rolle und versuchen Sie es erneut
Fehler „INVALID_LOGIN_ATTEMPT“
- Der mit dem Token verknüpfte Benutzer ist deaktiviert oder hat keinen Zugriff mehr auf die Rolle
- Überprüfen Sie den Tab Access des Benutzers
Rechnungserstellung auf einem OneWorld-Konto abgelehnt
- OneWorld-Konten erfordern ein obligatorisches Feld
subsidiarybei Kunden und Rechnungen - Diese erste Version von Order Invoicer füllt dieses Feld noch nicht aus – wenden Sie sich an unseren Support, um das Subsidiary-Mapping zu aktivieren
API-Referenz
Support
Wenn Sie auf Schwierigkeiten stoßen:
- Sehen Sie sich den Abschnitt zur Fehlerbehebung oben an
- Konsultieren Sie die offizielle NetSuite-Dokumentation
- Kontaktieren Sie unseren Support:
contact@orderinvoicer.com