Корпоративное API: Создать представителя в Астрал.Доверенность | Помощь Астрал
Техподдержка:
8 (800) 551-80-36

Техподдержка
Отдел продаж
8 (800) 600-36-51

moscow@astral.ru
График работы

Астрал.Доверенность: Создать представителя

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

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

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

Описание

POST/corporate-api/v1/representative-templates

Данный метод позволяет создать представителя организации. 

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

-

Request body

{
  "representativeType": "Organization",
  "organizationName": "string",
  "inn": "string",
  "kpp": "string",
  "ogrn": "string",
  "name": "string",
  "surname": "string",
  "patronymic": "string",
  "birthDate": "2025-07-29T12:10:30.022Z",
  "innIndividual": "string",
  "snils": "string",
  "citizenshipType": "Russian",
  "citizenshipCountryCode": "string",
  "position": "string",
  "documentType": "string",
  "numberSeries": "string",
  "dateOfIssue": "2025-07-29T12:10:30.022Z",
  "issuerName": "string",
  "issuerCode": "string"
}

Заполнение:

Ниже указано для каких типов представителей какой параметр заполняется

ПараметрЗначениеrepresentativeType=OrganizationrepresentativeType=IndividualEntrepreneurrepresentativeType=PrivatePerson
representativeTypeтип представителязаполняется обязательнозаполняется обязательнозаполняется обязательно
organizationNameнаименование организации заполняется обязательноне заполняетсяне заполняется
innИНН организациизаполняется обязательнозаполняется обязательнозаполняется обязательно
kppКППзаполняется обязательноне заполняетсяне заполняется
ogrnОГРНзаполняется обязательнозаполняется обязательноне заполняется
nameИмязаполняется по желаниюзаполняется обязательнозаполняется обязательно
surnameФамилиязаполняется по желаниюзаполняется обязательнозаполняется обязательно
patronymicОтчествозаполняется по желаниюзаполняется по желаниюзаполняется по желанию
birthDateдата рождениязаполняется по желаниюзаполняется обязательнозаполняется обязательно
innIndividualИНН заполняется по желаниюне заполняетсяне заполняется
snilsСНИЛСзаполняется по желаниюзаполняется обязательнозаполняется обязательно

citizenshipType*

*перечень  см. в справочнике значений атрибутов

вид гражданстване заполняетсязаполняется по желаниюзаполняется по желанию

citizenshipCountryCode

согласно https://classifikators.ru/oksm

код страныне заполняетсязаполняется по желаниюзаполняется по желанию
positionдолжностьне заполняетсяне заполняетсязаполняется по желанию

documentType

см перечень в разделе ReferenceInformation

тип документа, удостоверяющего личностьзаполняется по желаниюзаполняется по желаниюзаполняется по желанию
numberSeriesсерия и номерзаполняется по желаниюзаполняется по желаниюзаполняется по желанию
dateOfIssueдата выдачизаполняется по желаниюзаполняется по желаниюзаполняется по желанию
issuerNameкем выданзаполняется по желаниюзаполняется по желаниюзаполняется по желанию
issuerCodeкод подразделениязаполняется по желаниюзаполняется по желаниюзаполняется по желанию

Ответ

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

Success

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "displayName": "string",
  "representativeType": "Organization",
  "inn": "string",
  "kpp": "string",
  "ogrn": "string",
  "name": "string",
  "surname": "string",
  "patronymic": "string",
  "birthDate": "2025-07-29T15:53:21.602Z",
  "innIndividual": "string",
  "snils": "string",
  "citizenshipType": "Russian",
  "citizenshipCountry": {
    "code": "string",
    "name": "string"
  },
  "position": "string",
  "documentType": {
    "code": "string",
    "name": "string"
  },
  "numberSeries": "string",
  "dateOfIssue": "2025-07-29T15:53:21.602Z",
  "issuerName": "string",
  "issuerCode": "string",
  "updateDate": "2025-07-29T15:53:21.602Z"
}

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

  • id - идентификатор представителя
  • displayName - наименование представителя
    • для Organization - наименование организации
    • для IndividualEntrepreneur - склейка ФИО
    • для PrivatePerson - склейка ФИО

  • representativeType - тип представителя

  • inn - ИНН представителя

  • kpp - КПП представителя

  • ogrn - ОГРН организации или ИП

  • name - имя

  • surname - фамилия

  • patronymic - отчество

  • birthDate - дата рождения

  • innIndividual - ИНН ЕИО организации

  • snils - СНИЛС

  • citizenshipType - тип гражданства

  • citizenshipCountry - страна гражданства

    • code - код страны

    • name - наименование

  • position - должность

  • documentType - тип документа, удостоверяющего личность

    • code - код документа

    • name - наименование документа

  • numberSeries - серия и номер

  • dateOfIssue - дата выдачи

  • issuerName - кем выдан

  • issuerCode - код подразделения

  • updateDate - дата создания/обновления представителя

Пример запроса

/corporate-api/v1/representative-templates

{
  "representativeType": "PrivatePerson",
  "inn": "969058776216",
  "name": "Булгаков",
  "surname": "Иван",
  "patronymic": "Васильевич",
  "birthDate": "2000-07-29T15:53:21.521Z",
  "snils": "143-183-968 66",
  "citizenshipType": "Foreign",
  "citizenshipCountryCode": "558",
  "position": "стажер",
  "documentType": "21",
  "numberSeries": "2345 567898",
  "dateOfIssue": "2023-07-29T15:53:21.521Z",
  "issuerName": "УФМС",
  "issuerCode": "000-000"
}

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

{
    "name": "Булгаков",
    "surname": "Иван",
    "patronymic": "Васильевич",
    "birthDate": "2000-07-29T15:53:21.521+00:00",
    "snils": "143-183-968 66",
    "citizenshipType": "Foreign",
    "citizenshipCountry": {
        "code": "558",
        "name": "НИКАРАГУА"
    },
    "position": "стажер",
    "documentType": {
        "code": "21",
        "name": "Паспорт гражданина Российской Федерации"
    },
    "numberSeries": "2345 567898",
    "dateOfIssue": "2023-07-29T15:53:21.521+00:00",
    "issuerName": "УФМС",
    "issuerCode": "000-000",
    "updateDate": "2025-07-29T16:10:56.462813+00:00",
    "id": "59a41f23-b67e-4993-a784-5ad7a4f96812",
    "displayName": "Иван Булгаков Васильевич",
    "representativeType": "PrivatePerson",
    "inn": "969058776216"
}

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

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

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