GetMyOrganizations

Возвращает список организаций, к которым пользователь имеет доступ.

GET /GetMyOrganizations

Query Parameters:

autoRegister – признак того, что нужно регистрировать пользователя в организацию из сертификата. Пользователь будет зарегистрирован, если в ящике нет действующего администратора и активных пользователей. По умолчанию имеет значение true.

Request Headers:

Authorization – данные, необходимые для авторизации.

Status Codes:

200 OK – операция успешно завершена.
401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.
405 Method Not Allowed – используется неподходящий HTTP-метод.
409 Conflict – превышено количество запросов в день.
500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

Response Body:

Тело ответа содержит список всех организаций, к которым пользователь имеет доступ, представленный структурой OrganizationList.

Если организации нет в Диадоке и пользователь авторизовался с помощью сертификата КЭП, то метод зарегистрирует новую организацию на основе информации из сертификата и ЕГРЮЛ/ЕГРИП. Информация об организации вернется в ответе вместе со списком ящиков, к которым у пользователя уже есть доступ.

Если в организации нет действующего администратора и активных пользователей, то метод по умолчанию зарегистрирует пользователя в организации и назначит ему права администратора. Регистрация произойдет только в том случае, если выполняются условия авторегистрации. Чтобы пользователь не был зарегистрирован, укажите признак autoRegister = false — этом случае будет зарегистрирована только организация.

Обратите внимание, что каждый пользователь может сделать не более 3 запросов на регистрацию в ящик в день. При выполнении очередной попытки регистрации сверх этого количества метод вернет ошибку 409 (Conflict).

Если организация уже есть в Диадоке, метод с признаком autoRegister = false вернет информацию об организации из сертификата без повторной регистрации.

Если у пользователя нет сертификата, метод вернет в теле ответа только список организаций, к которым у пользователя есть доступ.

Примеры использования

Пример HTTP-запроса:

GET /GetMyOrganizations HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json; charset=utf-8

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

{
    "Organizations": [
        {
            "OrgIdGuid": "f5758a05-63d1-435e-bc49-79a801d7c275",
            "OrgId": "f5758a05-63d1-435e-bc49-79a801d7c275",
            "Inn": "1839264655",
            "Kpp": "732644841",
            "FullName": "Организация 1",
            "ShortName": "Организация 1",
            "JoinedDiadocTreaty": true,
            "Boxes": [
                {
                    "BoxId": "09ae254c5cd0408284de7ccb46d86f82@diadoc.ru",
                    "BoxIdGuid": "09ae254c-5cd0-4082-84de-7ccb46d86f82",
                    "Title": "Организация 1",
                    "InvoiceFormatVersion": "v5_02",
                    "EncryptedDocumentsAllowed": true
                }
            ],
            "Ogrn": "3071205010489",
            "FnsParticipantId": "2BM-1839264655-732644841-202407101103418496883",
            "Address": {
                "RussianAddress": {
                    "ZipCode": "987654",
                    "Region": "66",
                    "City": "Екатеринбург",
                    "Street": "Павлодарская",
                    "Building": "17"
                },
                "AddressCode": ""
            },
            "FnsRegistrationDate": "05.12.2024",
            "Departments": [
                {
                    "DepartmentId": "6d710055-9b5d-4bc0-ba2f-9e54adda034e",
                    "ParentDepartmentId": "00000000-0000-0000-0000-000000000000",
                    "Name": "Дочернее подразделение",
                    "Abbreviation": "ДП",
                    "Address": {
                        "RussianAddress": {
                            "Region": ""
                        },
                        "AddressCode": ""
                    },
                    "IsDisabled": false
                },
                {
                    "DepartmentId": "b651ed54-04d8-4ca8-99b5-960fba733147",
                    "ParentDepartmentId": "00000000-0000-0000-0000-000000000000",
                    "Name": "Подразделение 1",
                    "Abbreviation": "П1",
                    "Address": {
                        "RussianAddress": {
                            "Region": ""
                        },
                        "AddressCode": ""
                    },
                    "IsDisabled": false
                },
                {
                    "DepartmentId": "32cb2cd3-ed3a-403a-b220-7dfd59c757db",
                    "ParentDepartmentId": "00000000-0000-0000-0000-000000000000",
                    "Name": "Подразделение 2",
                    "Abbreviation": "П2",
                    "Address": {
                        "RussianAddress": {
                            "Region": ""
                        },
                        "AddressCode": ""
                    },
                    "IsDisabled": false
                }
            ],
            "IfnsCode": "4312",
            "IsPilot": false,
            "IsActive": true,
            "IsTest": false,
            "IsBranch": false,
            "IsRoaming": false,
            "IsEmployee": true,
            "InvitationCount": 0,
            "SearchCount": 0,
            "Sociability": "AllOrganizations",
            "IsForeign": false,
            "HasCertificateToSign": true
        },
        {
            "OrgIdGuid": "72c3b5bf-3a9f-4fb5-a3ef-112cb2b3a8dc",
            "OrgId": "72c3b5bf-3a9f-4fb5-a3ef-112cb2b3a8dc",
            "Inn": "6596035297",
            "Kpp": "757645784",
            "FullName": "Организация 2",
            "ShortName": "Организация 2",
            "JoinedDiadocTreaty": true,
            "Boxes": [
                {
                    "BoxId": "1f208d032a604f6491b1b7aad54cfaf3@diadoc.ru",
                    "BoxIdGuid": "1f208d03-2a60-4f64-91b1-b7aad54cfaf3",
                    "Title": "Организация 2",
                    "InvoiceFormatVersion": "v5_02",
                    "EncryptedDocumentsAllowed": true
                }
            ],
            "Ogrn": "9130523523154",
            "FnsParticipantId": "2BM-6596035297-757645784-202407101104400484330",
            "Address": {
                "RussianAddress": {
                    "ZipCode": "620142",
                    "Region": "66",
                    "City": "Екатеринбург",
                    "Street": "Сажинская",
                    "Building": "11"
                },
                "AddressCode": ""
            },
            "FnsRegistrationDate": "05.12.2024",
            "Departments": [],
            "IfnsCode": "6174",
            "IsPilot": false,
            "IsActive": true,
            "IsTest": false,
            "IsBranch": false,
            "IsRoaming": false,
            "IsEmployee": true,
            "InvitationCount": 0,
            "SearchCount": 0,
            "Sociability": "AllOrganizations",
            "IsForeign": false,
            "HasCertificateToSign": true
        }
    ]
}

См. также

Инструкции:

Работа с организациями

Методы для работы с организациями:

GetMyOrganizations — возвращает список организаций, к которым пользователь имеет доступ
GetOrganization — возвращает данные организации по указанному идентификатору
GetOrganizationFeatures — возвращает список дополнительных функций организации
GetOrganizationsByInnKpp — возвращает данные организации по ИНН
GetOrganizationsByInnList (V2) — возвращает список организаций и их статус партнерства по списку ИНН
GetResolutionRoutes — возвращает список всех неудаленных включенных маршрутов согласования для указанного ящика
Register — находит или создает в Диадоке организацию по сертификату и добавляет владельца сертификата в сотрудники этой организации
RegisterConfirm — подтверждает владение закрытым ключом сертификата для регистрации в организацию