---
title: "Oracle NetSuite: aangepaste rol voor beheerders - Payhawk Help Center"
slug: "authenticating-to-oracle-netsuite-with-a-custom-role"
description: "Bekijk de minimale Oracle NetSuite-machtigingen die een aangepaste rol nodig heeft voor de Payhawk SuiteApp, hoe je de rol maakt en toewijst en fouten oplost."
updated: 2026-10-20T07:44:41Z
published: 2026-10-20T07:44:41Z
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.

# Verifiëren bij Oracle NetSuite met een aangepaste rol

In dit artikel staat welke machtigingen iemand met een aangepaste rol binnen Netsuite minimaal nodig heeft om de Payhawk SuiteApp RESTlets te gebruiken. Hiervoor is het niet meer per se nodig dat je de Beheerder-rol hebt. Elke rol met toegang tot Token-Based Authentication (TBA) en de machtigingen hieronder kan ervoor worden gebruikt.

## Documentatie ter referentie

- [Documentatie voor machtigingen](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_N326485.html) — overzicht downloadbaar bestand [NetSuitePermissionsUsage.xls](https://system.netsuite.com/core/media/media.nl?id=457595427&c=NLCORP&h=ka92WVqy8jC7TwBWowHI-TQdnY1wrOwpnd4ogvcz1V6MeRID&_xt=.xls)
- [Namen en -ID's van de machtigingen](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/chapter_N3236764.html) — tabel met alle ID's voor SuiteScript
- [Overwegingen op het gebied van rollen en machtigingen voor API’s](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_0320025211.html) — specifieke vereisten voor API's
- [Toegangsniveaus voor machtigingen](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_N326341.html) — definities van Geen / Bekijken / Aanmaken / Bewerken / Volledig
- [NetSuite-rollen aanpassen of aanmaken](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_N285937.html) — stapsgewijze handleiding

## Een aangepaste rol maken

Zo maak je een speciale rol voor de Payhawk-integratie:

1. Ga in Oracle NetSuite naar `Instellen -> Gebruikers/Rollen-> Rollen beheren -> Nieuw`.
2. Geef de rol een naam, bijvoorbeeld **Payhawk-integratie**.
3. Schakel op het roldocument **Alleen webservicerol** in (aanbevolen – voorkomt dat deze rol kan inloggen in de UI).
4. Voeg de onderstaande machtigingen toe onder de subtabbladen Machtigingen (Instellingen, Transacties, Lijsten).
5. Sla de rol op.
6. Wijs de rol toe aan de gebruiker: `Lijsten -> Medewerkers -> [Gebruiker] -> Toegang -> Rollen`.

## Machtigingen

### Transacties

Rollenpagina → Machtigingen → Subtabblad Transacties

| Machtiging | Niveau |
| --- | --- |
| Facturen | Volledig |
| Storten | Aanmaken |
| Leverancierskredieten invoeren | Volledig |
| Onkostenrapport | Volledig |
| Transactie zoeken | Bekijken |
| Journaalpost aanmaken | Volledig |
| Rekeningen betalen | Volledig |
| Inkooporder | Volledig |

### Rapporten

Rollenpagina → Machtigingen → Subtabblad Rapporten

| Machtiging | Niveau |
| --- | --- |
| Afschrift kasstroom | Bekijken |

### Lijsten

Rollenpagina → Machtigingen → Subtabblad Lijsten

| Machtiging | Niveau |
| --- | --- |
| Rekeningen | Volledig |
| Afschrijvingsschema | Bekijken |
| Lessen | Bekijken |
| Valuta | Volledig |
| Auditlogboek plug‑in aangepaste grootboekregels | Bekijken |
| Klanten | Bekijken |
| Afdelingen | Bekijken |
| Documenten en bestanden | Volledig |
| Medewerkersdossier | Volledig |
| Medewerkers | Volledig |
| Artikelen | Bekijken |
| Locaties | Bekijken |
| Projecten | Bekijken |
| Dochterondernemingen | Bekijken |
| Belastinggegevens | Bekijken |
| Leveranciers | Volledig |

### Instellingen

Rollenpagina → Machtigingen → Subtabblad Instellingen

| Machtiging | Niveau |
| --- | --- |
| Boekhoudvoorkeuren | Volledig |
| Bedrijfsinformatie | Volledig |
| Zelfgekozen inhoudsvelden | Bekijken |
| Zelfgekozen kolomvelden | Bekijken |
| Zelfgekozen entiteitsvelden | Bekijken |
| Zelfgekozen velden | Bekijken |
| Zelfgekozen artikelvelden | Bekijken |
| Zelfgekozen lijsten | Bekijken |
| Zelfgekozen recordtypen | Bekijken |
| Zelfgekozen segmenten | Bekijken |
| Zelfgekozen transactievevelden | Bekijken |
| Zelfgekozen transactieformulieren | Bekijken |
| Inloggen met toegangstokens | Volledig |
| Boekhoudperiodes beheren | Bekijken |
| Perioden voor belastingaangifte beheren | Volledig |
| Andere zelfgekozen velden | Bekijken |
| SuiteScript | Bekijken |

![Machtigingsinstellingen voor transacties, rapporten, lijsten, setup en aangepaste recordopties.](https://storage.googleapis.com/payhawk-cdn/Adm%3AIntegrations%3ANetSuite/authenticating_1.png)

### Globale gebruikersmachtigingen

| Machtiging | Niveau |
| --- | --- |
| Beheer van toegangstokens | Volledig |
| Relatie tussen entiteit en dochteronderneming | Volledig |
| SuiteSignOn | Volledig |

![De interface toont globale machtigingen en verschillende toegangsniveaus voor gebruikersrollen.](https://storage.googleapis.com/payhawk-cdn/Adm%3AIntegrations%3ANetSuite/authenticating_2.png)

## Notities voor ontwikkelaars

> [!WARNING]
> **Algemene endpoints**: De `records-restlet` en `suiteql-restlet` zijn algemene endpoints die toegang kunnen krijgen tot elk type record. De rol moet machtigingen hebben voor elk recordtype dat via deze endpoints wordt opgevraagd. Als een machtiging ontbreekt, geven deze endpoints een gestructureerde foutmelding terug.

- **Backward compatibility:** De SuiteApp blijft werken met de rol Beheerder. Bestaande verbindingen die Beheerder gebruiken, hoeven niet gewijzigd te worden.
- **Volledige referentie van machtigingen:** Download het officiële bestand [NetSuitePermissionsUsage.xls](https://system.netsuite.com/core/media/media.nl?id=457595427&c=NLCORP&h=ka92WVqy8jC7TwBWowHI-TQdnY1wrOwpnd4ogvcz1V6MeRID&_xt=.xls) zodat je precies weet wat alle NetSuite-machtigingen inhouden.

## Probleemoplossing

**Diagnose**: Controleer Inloggen Auditproces via `Instellingen -> Gebruikers/Rollen -> Inloggen Auditproces bekijken`. Voeg de kolommen *detail*, *Naam token voor toegang met token* en *Naam toepassing op basis van token* toe om te bekijke wat precies de redenen van de fouten zijn.

**ONVOLDOENDE MACTHIGINGEN / insufficient-permissions**

Deze fout betekent dat TBA‑authenticatie is gelukt, maar dat de rol geen machtigingen heeft voor het specifieke record of de specifieke bewerking. De `records-restlet` en `suiteql-restlet` geven dan een gestructureerde foutmelding terug:

```plaintext
{ "errors": [{ "code": "onvoldoende-machtigingen", "message": "..." }] }
```

Voeg de ontbrekende machtiging toe uit de tabellen hierboven. De foutmelding noemt meestal het type record dat toegang nodig heeft.

**Toestemming_geweigerd**

Deze TBA-fout betekent dat de rol- of gebruikersentiteit niet bruikbaar is. Controleer:

1. Of de rol actief is (niet uitgeschakeld).
2. Of de gebruiker de rol niet inactief gemaakt heeft op de pagina **Mijn rollen bekijken**.
3. TBA-machtigingen zijn toegewezen aan de rol.