GetOrganizationsByInnKpp

Возвращает данные организации по ИНН.

GET /GetOrganizationsByInnKpp

Query Parameters:

• inn – ИНН организации.

• kpp – КПП организации. Необязательное поле.

• includeRelations – признак того, что нужно вернуть количество контрагентов, заинтересованных в сотрудничестве с организацией.

Request Headers:

• Authorization – данные, необходимые для авторизации. В заголовке нужно передать DiadocAuth ddauth_api_client_id.

Status Codes:

• 200 OK – операция успешно завершена.

• 400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.

• 401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.

• 405 Method Not Allowed – используется неподходящий HTTP-метод.

• 500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

Response Body:

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

Если параметр kpp отсутствует в строке запроса, метод вернет список ящиков всех организаций с заданным ИНН.

Метод может вернуть несколько организаций с одинаковыми ИНН и КПП. Это возможно, если организация является роуминговой: организация с определенными ИНН и КПП зарегистрирована в Диадоке и организация с такими же данными обслуживается другим оператором ЭДО, при этом для нее в Диадоке создано представление.

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

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

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

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

{
    "Organizations": [
        {
            "OrgIdGuid": "9e255d17-f8ce-4bfa-99cf-aa2ce0f4114b",
            "OrgId": "9e255d17-f8ce-4bfa-99cf-aa2ce0f4114b",
            "Inn": "9208773000",
            "Kpp": "920801000",
            "FullName": "Общество с ограниченной ответственностью \"Предприятие\"",
            "ShortName": "ООО \"Предприятие\"",
            "JoinedDiadocTreaty": true,
            "Boxes": [
                {
                    "BoxId": "0ff0804922e14450b23449dad7a7762@diadoc.ru",
                    "BoxIdGuid": "0ff08049-22e1-4450-b234-49dad7a77625",
                    "Title": "ООО \"Предприятие\"",
                    "InvoiceFormatVersion": "v5_02",
                    "EncryptedDocumentsAllowed": false
                }
            ],
            "Ogrn": "9045162480277",
            "FnsParticipantId": "2BM-920801001-920801001-201910290427107624171",
            "Address": {
                "RussianAddress": {
                    "ZipCode": "920459",
                    "Region": "92",
                    "City": "Вологда",
                    "Street": "ул Речная",
                    "Building": "3",
                    "Apartment": "9/1"
                },
                "AddressCode": ""
            },
            "Departments": [],
            "IfnsCode": "9210",
            "IsPilot": false,
            "IsActive": false,
            "IsTest": false,
            "IsBranch": false,
            "IsRoaming": false,
            "IsEmployee": false,
            "InvitationCount": 0,
            "SearchCount": 0,
            "Sociability": "AllOrganizations",
            "IsForeign": false,
            "HasCertificateToSign": false
        }
    ]
}

---

См. также

Инструкции:

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

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

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

• GetOrganization — возвращает данные организации по указанному идентификатору

• GetOrganizationFeatures — возвращает список дополнительных функций организации

• GetOrganizationsByInnKpp — возвращает данные организации по ИНН

• GetOrganizationsByInnList (V2) — возвращает список организаций и их статус партнерства по списку ИНН

• GetResolutionRoutes — возвращает список всех неудаленных включенных маршрутов согласования для указанного ящика

• Register — находит или создает в Диадоке организацию по сертификату и добавляет владельца сертификата в сотрудники этой организации

• RegisterConfirm — подтверждает владение закрытым ключом сертификата для регистрации в организацию