Корпоративное API: Справочник полномочий в Астрал.Доверенность | Помощь Астрал
Техподдержка:
Отдел продаж
График работы

Астрал.Доверенность: Справочник полномочий

Автор Прошин Алексей

Автор: Прошин Алексей

13.08.2025
6
Из статьи вы узнаете:

Описание

У каждого формата доверенности свой отдельный справочник полномочий.

GET/corporate-api/v1/reference-information/authorities

Данный метод позволяет получить набор полномочий для разных форматов доверенностей. Используется при заполнении объектов empowerment и empowermentList при создании доверенности, а также объекта codes при создании шаблона полномочий.

Входные параметры

Наименование параметраТип параметраЗначениеДополнительно

relationshipType 

string

 B2B, B2G, Unified, SFR

одно из значений

codes

array[string]

Фильтр по выбранным кодам

Необязательный параметр

search

string

Строка поиска по краткому названиюНеобязательный параметр

offset

integer($int32)

Отступ

Необязательный параметр

count

integer($int32)

Количество

Необязательный параметр, если не указать, то вернется не более 10

takeDisabled

boolean

Включать ли в ответ полномочия, которые больше не действуют

Принимает значения:

  • true
  • false

Необязательный параметр

по умолчанию takeDisabled = false

Ответ

КодЗначениеДополнительно
200

Success

{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "code": "string",
      "relationshipType": "B2B",
      "contents": "string",
      "groupCode": "string",
      "disabled": true,
      "name": "string",
      "parentCode": "string"
    }
  ],
  "meta": {
    "totalCount": 0
  }
}

Возвращаются данные полномочия, содержащие следующие значения:

  • data- массив полномочий
    • id - идентификатор полномочий
    • code - код полномочия (который нужно передать при заполнении параметра code доверенности)
    • relationshipType - формат полномочий
    • contents - наименование полномочий
    • groupCode - код группы полномочий (отсутствует у B2B, B2G, SFR полномочий)
    • disabled - является ли полномочие актуальным
      • true - полномочие неактуально
      • false - полномочие актуально
    • name - наименование родительского полномочия (есть только у SFR)
    • parentCode - код родительского полномочия (есть только у SFR)
  • meta- служебная информация
    • totalCount- общее число полномочий согласно параметрам запроса

Пример запроса (SFR)

/corporate-api/v1/reference-information/authorities?relationshipType=SFR

Пример ответа

{
    "data": [
        {
            "code": "FSS_000000",
            "relationshipType": "SFR",
            "contents": "Все полномочия классификатора",
            "disabled": false,
            "name": "Все",
            "id": "96d4669c-39ed-4f7b-b6c4-2d7abd1fbd39"
        },
.........
        {
            "code": "FSS_000010",
            "relationshipType": "SFR",
            "contents": "Подписание ЭД со стороны Страхователя рамках ПОВЭД",
            "disabled": false,
            "name": "Страхователь.ПОВЭД",
            "parentCode": "FSS_000002",
            "id": "862b310b-79d7-41d8-bcd3-ee3307bc6490"
        }
    ],
    "meta": {
        "totalCount": 119
    }
}

Пример запроса (Unified)

/corporate-api/v1/reference-information/authorities?relationshipType=Unified

Пример ответа

{
    "data": [
        {
            "code": "2_FNS02",
            "relationshipType": "Unified",
            "contents": "Представлять налоговую декларацию, другую отчетность",
            "groupCode": "99cfd179-fb15-4fa6-a6d5-843e7005ee4e",
            "disabled": false,
            "name": "",
            "parentCode": "",
            "id": "1d14f0a7-fad2-4e00-bfaf-a7a85aaae349"
        },
........        
        {
            "code": "2_FNS17",
            "relationshipType": "Unified",
            "contents": "Подписывать заявление на зачет/возврат налога",
            "groupCode": "99cfd179-fb15-4fa6-a6d5-843e7005ee4e",
            "disabled": false,
            "name": "",
            "parentCode": "",
            "id": "d3c64942-27a8-469e-b5a4-52dbc7b5cefb"
        }
    ],
    "meta": {
        "totalCount": 345
    }
}

Комментарии для сайта Cackle
Получите электронную подпись для работы на госпорталах, для участия в торгах и ЭДО

Хотите разобраться
в сервисах Астрал?

Подробные инструкции,
решения проблем
и ответы на вопросы
в Базе знаний

autohello-finger