Перейти к основному содержимому

GetOrganizationsByInnKpp

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

GET /GetOrganizationsByInnKpp

Параметры запроса

  • inn — ИНН организации.
  • kpp — КПП организации. Необязательное поле.
  • includeRelations — признак того, что нужно вернуть количество контрагентов, заинтересованных в сотрудничестве с организацией.

Заголовки запроса

Коды ответа

  • 200 — операция успешно завершена.
  • 400 — данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
  • 401 — в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.
  • 403 — запрос сделан от заблокированного клиента API.
  • 405 — используется неподходящий HTTP-метод.
  • 429 — превышено ограничение на количество запросов в единицу времени.
  • 500 — при обработке запроса возникла непредвиденная ошибка.

Тело ответа

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

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

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

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

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

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

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

{
"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-49dad7a7762",
"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,
"OrganizationType": "Juridical",
"IsOwner": false,
"Comment": ""
}
]
}

См. также

Инструкции:

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

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

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года