---
title: "Oracle NetSuite: eigene Rolle für die Verwaltung - Payhawk Help Center"
slug: "authenticating-to-oracle-netsuite-with-a-custom-role"
description: "Sehen Sie die Mindestberechtigungen einer benutzerdefinierten Rolle in Oracle NetSuite für die Payhawk SuiteApp, wie Sie die Rolle anlegen und Fehler beheben."
updated: 2026-10-20T07:44:39Z
published: 2026-10-20T07:44:39Z
canonical: "payhawk.com/authenticating-to-oracle-netsuite-with-a-custom-role"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://payhawk.com/help/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentifizierung bei Oracle NetSuite mit einer benutzerdefinierten Rolle

In diesem Artikel sind die minimal erforderlichen NetSuite-Berechtigungen aufgeführt, damit eine benutzerdefinierte Rolle die Payhawk SuiteApp RESTlets verwenden kann. Die SuiteApp erfordert nicht mehr die Administrator-Rolle – jede Rolle mit Zugriff auf Token-basierte Authentifizierung (TBA) und den unten aufgeführten Berechtigungen kann verwendet werden.

## Referenzdokumentation

- [Dokumentation zu Berechtigungen](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_N326485.html) – Übersicht herunterladbare [NetSuitePermissionsUsage.xls](https://system.netsuite.com/core/media/media.nl?id=457595427&c=NLCORP&h=ka92WVqy8jC7TwBWowHI-TQdnY1wrOwpnd4ogvcz1V6MeRID&_xt=.xls)
- [Berechtigungsnamen und -IDs](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/chapter_N3236764.html) – vollständige ID-Tabelle für SuiteScript
- [Überlegungen zu Rollen und Berechtigungen für APIs](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_0320025211.html) – API-spezifische Anforderungen
- [Zugriffslevel für Berechtigungen](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_N326341.html) – Definitionen für Keine / Anzeigen / Erstellen / Bearbeiten / Voll
- [NetSuite-Rollen anpassen oder erstellen](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_N285937.html) – Schritt-für-Schritt-Anleitung

## Erstellen einer benutzerdefinierten Rolle

Um eine dedizierte Rolle für die Payhawk-Integration zu erstellen, gehen Sie wie folgt vor:

1. Gehen Sie in Oracle NetSuite zu `Setup -> Users/Roles -> Manage Roles -> New`.
2. Benennen Sie die Rolle, zum Beispiel **Payhawk-Integration**.
3. Aktivieren Sie im Rollen-Datensatz die Option **Nur Webdiensten zugeordnete Rolle** (empfohlen – verhindert die Anmeldung über die Benutzeroberfläche mit dieser Rolle).
4. Fügen Sie die unten aufgeführten Berechtigungen in den jeweiligen Untertabs Berechtigungen (Einrichtung, Transaktionen, Listen) hinzu.
5. Rolle speichern.
6. Weisen Sie dem Benutzer die Rolle zu: `Listen -> Mitarbeiter -> [Benutzer] -> Zugriff -> Rollen`.

## Berechtigungen

### Transaktionen

Seite „Rolle“ → Berechtigungen → Unterregister „Transaktionen“

| Berechtigung | Level |
| --- | --- |
| Rechnungen | Vollständig |
| Einzahlung | Erstellen |
| Lieferantengutschriften eingeben | Vollständig |
| Spesenabrechnung | Vollständig |
| Transaktion finden | Anzeigen |
| Journaleintrag erstellen | Vollständig |
| Rechnungen bezahlen | Vollständig |
| Bestellung | Vollständig |

### Berichte

Rollen-Seite → Berechtigungen → Unterregisterkarte „Berichte“

| Berechtigung | Level |
| --- | --- |
| Kapitalflussrechnung | Anzeigen |

### Listen

Rollen-Seite → Berechtigungen → Unterregisterkarte „Listen“

| Berechtigung | Level |
| --- | --- |
| Konten | Vollständig |
| Tilgungspläne | Anzeigen |
| Kurse | Anzeigen |
| Währung | Vollständig |
| Benutzerdefinierte GL-Zeilen Plug-in‑Auditprotokoll | Anzeigen |
| Kunden | Anzeigen |
| Abteilungen | Anzeigen |
| Dokumente und Dateien | Vollständig |
| Mitarbeiterakte | Vollständig |
| Mitarbeiter | Vollständig |
| Posten | Anzeigen |
| Standorte | Anzeigen |
| Projekte | Anzeigen |
| Tochtergesellschaften | Anzeigen |
| Steuerunterlagen | Anzeigen |
| Anbieter | Vollständig |

### Einrichtung

Seite „Rolle“ → Berechtigungen → Unterregisterkarte „Einrichtung“

| Berechtigung | Level |
| --- | --- |
| Buchhaltungseinstellungen | Vollständig |
| Unternehmensinformationen | Vollständig |
| Benutzerdefinierte Body-Felder | Anzeigen |
| Benutzerdefinierte Spaltenfelder | Anzeigen |
| Benutzerdefinierte Entitätsfelder | Anzeigen |
| Benutzerdefinierte Felder | Anzeigen |
| Benutzerdefinierte Artikelfelder | Anzeigen |
| Benutzerdefinierte Listen | Anzeigen |
| Benutzerdefinierte Recordtypen | Anzeigen |
| Benutzerdefinierte Segmente | Anzeigen |
| Benutzerdefinierte Transaktionsfelder | Anzeigen |
| Benutzerdefinierte Transaktionsformulare | Anzeigen |
| Anmeldung mit Zugriffstoken | Vollständig |
| Buchungsperioden verwalten | Siehe |
| Steuerberichtszeiträume verwalten | Vollständig |
| Weitere benutzerdefinierte Felder | Anzeigen |
| SuiteScript | Anzeigen |

![Berechtigungseinstellungen für Transaktionen, Berichte, Listen, Setup und benutzerdefinierte Datensatzoptionen.](https://storage.googleapis.com/payhawk-cdn/Adm%3AIntegrations%3ANetSuite/authenticating_1.png)

### Globale Benutzerberechtigungen

| Berechtigung | Level |
| --- | --- |
| Verwaltung von Zugriffstokens | Vollständig |
| Beziehung zwischen Unternehmen und Tochtergesellschaft | Vollständig |
| SuiteSignOn | Vollständig |

![Die Benutzeroberfläche zeigt globale Berechtigungen und verschiedene Zugriffsebenen für Benutzerrollen an.](https://storage.googleapis.com/payhawk-cdn/Adm%3AIntegrations%3ANetSuite/authenticating_2.png)

## Hinweise für Entwickler

> [!WARNING]
> **Generische Endpunkte**: Die `records-restlet` und `suiteql-restlet` sind generische Endpunkte, die auf jeden beliebigen Record-Typ zugreifen können. Die Rolle muss über Berechtigungen für jeden Record-Typ verfügen, der über sie abgefragt wird. Fehlt eine Berechtigung, geben diese Endpunkte einen strukturierten Fehler zurück.

- **Abwärtskompatibilität:** Die SuiteApp funktioniert weiterhin mit der Rolle Administrator. Für bestehende Verbindungen, die Administrator verwenden, sind keine Änderungen erforderlich.
- **Vollständige Berechtigungsreferenz:** Für ein umfassendes Verständnis aller NetSuite-Berechtigungsauswirkungen laden Sie die offizielle Datei [NetSuitePermissionsUsage.xls](https://system.netsuite.com/core/media/media.nl?id=457595427&c=NLCORP&h=ka92WVqy8jC7TwBWowHI-TQdnY1wrOwpnd4ogvcz1V6MeRID&_xt=.xls) herunter.

## Fehlersuche

**Diagnose**: Überprüfen Sie das Login-Audit-Protokoll unter `Setup -> Users/Roles -> View Login Audit Trail`. Fügen Sie die Spalten *Detail*, *Token-based Access Token Name* und *Token-based Application Name* hinzu, um detaillierte Fehlerursachen zu sehen.

**UNZUREICHENDE BERECHTIGUNG / insufficient-permissions**

Dieser Fehler bedeutet, dass die TBA-Authentifizierung erfolgreich war, die Rolle jedoch nicht über die erforderlichen Berechtigungen für den jeweiligen Datensatz oder Vorgang verfügt. Die `records-restlet`- und `suiteql-restlet`-Skripte geben einen strukturierten Fehler zurück:

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

Fügen Sie die fehlende Berechtigung aus den obigen Tabellen hinzu. In der Fehlermeldung wird normalerweise der Datensatztyp genannt, für den ein Zugriff erforderlich ist.

**Zugriff_verweigert**

Dieser Fehler auf TBA-Ebene bedeutet, dass die Rollen- oder Benutzerentität nicht verwendbar ist. Prüfen Sie Folgendes:

1. Die Rolle ist aktiv (nicht deaktiviert).
2. Der Benutzer hat die Rolle auf seiner Seite **Meine Rollen anzeigen** nicht inaktiv gesetzt.
3. Der Rolle sind TBA-Berechtigungen zugewiesen.