GetOrganizationsByInnKpp

Метод 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, или в этом заголовке отсутствует параметр ddauth_api_client_id, или переданный в нем ключ разработчика не зарегистрирован в Диадоке.

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

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

Response Body:

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

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

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