--- title: "Роля за Payhawk в NetSuite за администратори - Payhawk Help Center" slug: "authenticating-to-oracle-netsuite-with-a-custom-role" description: "Вижте минималните разрешения в NetSuite за персонализирана роля за Payhawk SuiteApp, как да създадете и зададете ролята и да отстраните грешки с разрешенията." updated: 2026-11-13T08:41:16Z published: 2026-11-13T08:41:16Z 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. # Удостоверяване в Oracle NetSuite с персонализирана роля В тази статия са изброени минималните разрешения в NetSuite, необходими за персонализирана роля за използване на RESTlets на Payhawk SuiteApp. SuiteApp вече не изисква ролята Администратор – може да се използва всяка роля с достъп за удостоверяване чрез токен (TBA) и разрешенията, изброени по-долу. ## Справочна документация - [Документация за разрешенията](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_N326485.html) – общ преглед и файл за изтегляне [NetSuitePermissionsUsage.xls](https://system.netsuite.com/core/media/media.nl?id=457595427&c=NLCORP&h=ka92WVqy8jC7TwBWowHI-TQdnY1wrOwpnd4ogvcz1V6MeRID&_xt=.xls) - [Имена и идентификатори на разрешения](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/chapter_N3236764.html) – пълна таблица с идентификатори за SuiteScript - [Съображения за ролите и разрешенията за API](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_0320025211.html) – специфични изисквания за API - [Нива на достъп за разрешения](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_N326341.html) – определения за None / View / Create / Edit / Full (Без достъп / Преглед / Създаване / Редактиране / Пълен достъп) - [Персонализиране или създаване на роли в NetSuite](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_N285937.html) – ръководство стъпка по стъпка ## Създаване на персонализирана роля За да създадете специална роля за интеграцията с Payhawk, следвайте стъпките: 1. В Oracle NetSuite отидете на `Setup -> Users/Roles -> Manage Roles -> New`. 2. Дайте име на ролята, например **Интеграция с Payhawk**. 3. В записа на ролята отметнете **Web Services Only Role** (Роля само за уеб услуги) (препоръчително – предотвратява влизането в потребителския интерфейс с тази роля). 4. Добавете изброените по-долу разрешения в подразделите на „Permissions“ (Разрешения) (Setup, Transactions, Lists) (настройка, транзакции, списъци). 5. Запазете ролята. 6. Възложете ролята на потребителя: `Lists -> Employees -> [User] -> Access -> Roles`. ## Разрешения ### Транзакции **Страница на ролята** → **Permissions** (Разрешения) → подраздел **Transactions** (Транзакции) | Разрешение | Ниво | | --- | --- | | Bills (Фактури) | Full (Пълен достъп) | | Deposit (Депозит) | Create (Създаване) | | Enter Vendor Credits (Въвеждане на кредитни известия от доставчик) | Full (Пълен достъп) | | Expense Report (Отчет за разходи) | Full (Пълен достъп) | | Find Transaction (Намиране на транзакция) | View (Преглед) | | Make Journal Entry (Създаване на счетоводна статия) | Full (Пълен достъп) | | Pay Bills (Плащане на фактури) | Full (Пълен достъп) | | Purchase Order (Поръчка за покупка) | Full (Пълен достъп) | ### Отчети **Страница на ролята** → **Permissions** (Разрешения) → подраздел **Reports** (Отчети) | Разрешение | Ниво | | --- | --- | | Cash Flow Statement (Отчет за паричните потоци) | View (Преглед) | ### Списъци **Страница на ролята** → **Permissions** (Разрешения) → подраздел **Lists** (Списъци) | Разрешение | Ниво | | --- | --- | | Accounts (Сметки) | Full (Пълен достъп) | | Amortization Schedules (Амортизационни планове) | View (Преглед) | | Classes (Класове) | View (Преглед) | | Currency (Валута) | Full (Пълен достъп) | | Custom GL lines Plug-in Audit Log (Одитен дневник на добавката за персонализирани редове в главната книга) | View (Преглед) | | Customers (Клиенти) | View (Преглед) | | Departments (Отдели) | View (Преглед) | | Documents and Files (Документи и файлове) | Full (Пълен достъп) | | Employee Record (Запис на служител) | Full (Пълен достъп) | | Employees (Служители) | Full (Пълен достъп) | | Items (Артикули) | View (Преглед) | | Locations (Местоположения) | View (Преглед) | | Projects (Проекти) | View (Преглед) | | Subsidiaries (Дъщерни дружества) | View (Преглед) | | Tax Records (Данъчни записи) | View (Преглед) | | Vendors (Доставчици) | Full (Пълен достъп) | ### Настройка **Страница на ролята** → **Permissions** (Разрешения) → подраздел **Setup** (Настройка) | Разрешение | Ниво | | --- | --- | | Accounting Preferences (Счетоводни предпочитания) | Full (Пълен достъп) | | Company Information (Информация за компанията) | Full (Пълен достъп) | | Custom Body Fields (Персонализирани полета за основен текст) | View (Преглед) | | Custom Column Fields (Персонализирани полета за колони) | View (Преглед) | | Custom Entity Fields (Персонализирани полета за дружества) | View (Преглед) | | Custom Fields (Персонализирани полета) | View (Преглед) | | Custom Item Fields (Персонализирани полета за артикули) | View (Преглед) | | Custom Lists (Персонализирани списъци) | View (Преглед) | | Custom Record Types (Персонализирани типове записи) | View (Преглед) | | Custom Segments (Персонализирани сегменти) | View (Преглед) | | Custom Transaction Fields (Персонализирани полета за транзакции) | View (Преглед) | | Custom Transaction Forms (Персонализирани формуляри за транзакции) | View (Преглед) | | Log in using Access Tokens (Влизане с токени за достъп) | Full (Пълен достъп) | | Manage Accounting Periods (Управление на счетоводни периоди) | View (Преглед) | | Manage Tax Reporting Periods (Управление на периоди за данъчна отчетност) | Full (Пълен достъп) | | Other Custom Fields (Други персонализирани полета) | View (Преглед) | | SuiteScript | View (Преглед) | | REST Web Services (Уеб услуги REST) | Full (Пълен достъп) | | User Access Tokens (Потребителски токени за достъп) | Full (Пълен достъп) | ![Настройки на разрешенията за Transactions, Reports, Lists, Setup и Custom Record (Транзакции, Отчети, Списъци, Настройка и Персонализиран запис).](https://storage.googleapis.com/payhawk-cdn/Adm%3AIntegrations%3ANetSuite/authenticating_1.png) ### Глобални потребителски разрешения | Разрешение | Ниво | | --- | --- | | Access Token Management (Управление на токени за достъп) | Full (Пълен достъп) | | Entity-Subsidiary Relationship (Връзка между дружество и дъщерно дружество) | Full (Пълен достъп) | | SuiteSignOn | Full (Пълен достъп) | ![Интерфейсът показва Global Permissions (Глобални разрешения) и различни нива на достъп за потребителските роли.](https://storage.googleapis.com/payhawk-cdn/Adm%3AIntegrations%3ANetSuite/authenticating_2.png) ## Бележки за разработчици > [!WARNING] > **Общи крайни точки**: `records-restlet` и `suiteql-restlet` са общи крайни точки, които имат достъп до всякакъв тип записи. Ролята трябва да има разрешения за всеки тип запис, заявяван чрез тях. Ако дадено разрешение липсва, тези крайни точки ще върнат структурирана грешка. - **Обратна съвместимост:** SuiteApp продължава да работи с ролята Администратор. Не са необходими промени за съществуващи връзки, използващи Администратор. - **Пълна справка за разрешенията:** За пълно разбиране на всички последици от разрешенията, изтеглете официалния [NetSuitePermissionsUsage.xls](https://system.netsuite.com/core/media/media.nl?id=457595427&c=NLCORP&h=ka92WVqy8jC7TwBWowHI-TQdnY1wrOwpnd4ogvcz1V6MeRID&_xt=.xls). ## Отстраняване на неизправности **Диагностика**: Проверете одитната следа на влизанията в `Setup -> Users/Roles -> View Login Audit Trail`. Добавете колоните *Detail* (Детайл), *Token-based Access Token Name* (Име на токен за достъп чрез токен) и *Token-based Application Name* (Име на приложение за достъп чрез токен), за да видите подробни причини за неуспех. **INSUFFICIENT_PERMISSION / insufficient-permissions** Тази грешка означава, че удостоверяването чрез TBA е успешно, но ролята няма разрешения за конкретния запис или операция. `records-restlet` и `suiteql-restlet` връщат структурирана грешка: ```plaintext { "errors": [{ "code": "insufficient-permissions", "message": "..." }] } ``` Добавете липсващото разрешение от таблиците по-горе. В съобщението за грешка обикновено е посочен типа запис, за който е необходим достъп. **Permission_denied** Тази грешка на ниво TBA означава, че ролята или потребителският обект не може да се използва. Проверете дали: 1. Ролята е активна (не е деактивирана). 2. Потребителят не е деактивирал ролята на страницата си **View My Roles** (Преглед на моите роли). 3. На ролята са възложени разрешения за TBA.