GetOrganizationsByInnList (V2)
Возвращает список организаций и их статус партнерства по списку ИНН.
- POST /V2/GetOrganizationsByInnList
- Query Parameters:
myBoxId – идентификатор ящика организации, для которого нужно получить статус контрагентов.
- Request Headers:
Authorization – данные, необходимые для авторизации.
- Request Body:
Тело запроса должно содержать структуру
GetOrganizationsByInnListRequest:message GetOrganizationsByInnListRequest { repeated string InnList = 1; }
InnList— список ИНН организаций.
- Status Codes:
200 OK – операция успешно завершена.
400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
401 Unauthorized – в запросе отсутствует HTTP-заголовок
Authorizationили в этом заголовке содержатся некорректные авторизационные данные.402 Payment Required – у указанного ящика закончилась подписка на API.
403 Forbidden – доступ к ящику с предоставленным авторизационным токеном запрещен.
405 Method Not Allowed – используется неподходящий HTTP-метод.
500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.
- Response Body:
Тело ответа содержит структуру GetOrganizationsByInnListResponse.
Если при вызове метода не передать параметр строки запроса myBoxId, то в теле ответа вернется структура GetOrganizationsByInnListResponse, где для вложенной структуры OrganizationWithCounteragentStatus значение поля CounteragentStatus для всех организаций будет равно NotInCounteragentList.
Примеры использования
Пример HTTP-запроса:
POST /V2/GetOrganizationsByInnList?myBoxId={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json; charset=utf-8
Пример тела запроса:
{
"InnList" :
[
"2572107000",
"0879699000",
"4417678000"
]
}
Пример тела ответа:
{
"Organizations": [
{
"Organization": {
"OrgIdGuid": "42e386dc-2905-4765-9c9e-dd905ca20197",
"OrgId": "42e386dc-2905-4765-9c9e-dd905ca20197",
"Inn": "2572107000",
"Kpp": "490901000",
"FullName": "Общество с ограниченной ответственностью \"Продавцы\"",
"ShortName": "ООО \"ПРОДАВЦЫ\"",
"JoinedDiadocTreaty": true,
"Boxes": [
{
"BoxId": "ad232c42d3124675878b4a60307530a2@diadoc.ru",
"BoxIdGuid": "ad232c42-d312-4675-878b-4a60307530a2",
"Title": "ООО \"ПРОДАВЦЫ\"",
"InvoiceFormatVersion": "v5_02",
"EncryptedDocumentsAllowed": false
}
],
"Ogrn": "2158366672935",
"FnsParticipantId": "2BM-2572107160-490901001-201910290427107624171",
"Address": {
"RussianAddress": {
"ZipCode": "685512",
"Region": "25",
"City": "Тверь",
"Street": "ул Ленина",
"Building": "3",
"Apartment": "9"
},
"AddressCode": ""
},
"Departments": [],
"IfnsCode": "4910",
"IsPilot": false,
"IsActive": false,
"IsTest": false,
"IsBranch": false,
"IsRoaming": false,
"IsEmployee": false,
"InvitationCount": 0,
"SearchCount": 0,
"Sociability": "AllOrganizations",
"IsForeign": false,
"HasCertificateToSign": false
},
"CounteragentStatus": "NotInCounteragentList",
"LastEventTimestampTicks": 0
},
{
"Organization": {
"OrgIdGuid": "3e6bf75d-5994-4006-b7be-16eb3ff34e8c",
"OrgId": "3e6bf75d-5994-4006-b7be-16eb3ff34e8c",
"Inn": "0879699000",
"Kpp": "500101000",
"FullName": "Общество с ограниченной ответственностью \"Комфорт\"",
"ShortName": "ООО \"КОМФОРТ\"",
"JoinedDiadocTreaty": true,
"Boxes": [
{
"BoxId": "c848c38cbba24fb888303b986f3fa353@diadoc.ru",
"BoxIdGuid": "c848c38c-bba2-4fb8-8830-3b986f3fa353",
"Title": "ООО \"КОМФОРТ\"",
"InvoiceFormatVersion": "v5_02",
"EncryptedDocumentsAllowed": false
}
],
"Ogrn": "5110574500977",
"FnsParticipantId": "2BM-0879699153-772201001-201802140845001411171",
"Address": {
"RussianAddress": {
"ZipCode": "113780",
"Region": "08",
"Street": "ул Октябрьская",
"Building": "9а",
"Block": "7",
"Apartment": "Эт 5 Пом I Ком 5"
},
"AddressCode": ""
},
"Departments": [],
"IfnsCode": "7722",
"IsPilot": false,
"IsActive": false,
"IsTest": false,
"IsBranch": false,
"IsRoaming": false,
"IsEmployee": false,
"InvitationCount": 0,
"SearchCount": 0,
"Sociability": "AllOrganizations",
"IsForeign": false,
"HasCertificateToSign": false
},
"CounteragentStatus": "NotInCounteragentList",
"LastEventTimestampTicks": 0
},
{
"Organization": {
"OrgIdGuid": "800e19d4-8446-4cbf-95f7-466c7ead7cb4",
"OrgId": "800e19d4-8446-4cbf-95f7-466c7ead7cb4",
"Inn": "4417678000",
"Kpp": "757645000",
"FullName": "Агентство",
"ShortName": "Агентство",
"JoinedDiadocTreaty": true,
"Boxes": [
{
"BoxId": "40fcffc2e1504a27ac6d13a67f2d83aa@diadoc.ru",
"BoxIdGuid": "40fcffc2-e150-4a27-ac6d-13a67f2d83aa",
"Title": "Агентство",
"InvoiceFormatVersion": "v5_02",
"EncryptedDocumentsAllowed": true
}
],
"Ogrn": "9130523523154",
"FnsParticipantId": "2BM-4417678580-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": false,
"InvitationCount": 0,
"SearchCount": 0,
"Sociability": "AllOrganizations",
"IsForeign": false,
"HasCertificateToSign": true
},
"CounteragentStatus": "IsMyCounteragent",
"LastEventTimestampTicks": 638585445988979088,
"MessageToCounteragent": "Примите приглашение к сотрудничеству",
"InvitationDocumentId": {
"MessageId": "215a68d5-28a0-4c6a-b9ec-cdba1530fd49",
"EntityId": "ad810ad2-8d4f-4fd9-9321-5359dfc0a37a"
},
"CounteragentGroupId": "00000000-0000-0000-0000-000000000000"
}
]
}
См. также
- Инструкции:
- Методы для работы с организациями:
GetMyOrganizations — возвращает список организаций, к которым пользователь имеет доступ
GetOrganization — возвращает данные организации по указанному идентификатору
GetOrganizationFeatures — возвращает список дополнительных функций организации
GetOrganizationsByInnKpp — возвращает данные организации по ИНН
GetOrganizationsByInnList (V2) — возвращает список организаций и их статус партнерства по списку ИНН
GetResolutionRoutes — возвращает список всех неудаленных включенных маршрутов согласования для указанного ящика
Register — находит или создает в Диадоке организацию по сертификату и добавляет владельца сертификата в сотрудники этой организации
RegisterConfirm — подтверждает владение закрытым ключом сертификата для регистрации в организацию
- Устаревшие версии метода: