GetOrganizationsByForeignTaxpayerCode
Возвращает данные организации по коду иностранного налогоплательщика.
GET /GetOrganizationsByForeignTaxpayerCode
Параметры запроса
foreignTaxpayerCode— код иностранного налогоплательщика.includeRelations— признак того, что нужно вернуть количество контрагентов, заинтересованных в сотрудничестве с организацией.
Заголовки запроса
Authorization— данные, необходимые для авторизации.
Коды ответа
200— операция успешно завершена.400— данные в запросе имеют неверный формат или отсутствуют обязательные параметры.401— в запросе отсутствует HTTP-заголовокAuthorizationили в этом заголовке содержатся некорректные авторизационные данные.403— запрос сделан от заблокированного клиента API.405— используется неподходящий HTTP-метод.429— превышено ограничение на количество запросов в единицу времени.500— при обработке запроса возникла непредвиденная ошибка.
Тело ответа
Тело ответа содержит список организаций с заданным кодом иностранного налогоплательщика, представленный структурой OrganizationList.
Примеры использования
Пример HTTP-запроса:
GET /GetOrganizationsByForeignTaxpayerCode?foreignTaxpayerCode={{foreignTaxpayerCode}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json
Пример тела ответа:
{
"Organizations": [
{
"OrgIdGuid": "407bc39c-f08f-4dd0-871e-25a09734826d",
"OrgId": "407bc39c-f08f-4dd0-871e-25a09734826d",
"Inn": "9984161385",
"Kpp": "",
"FullName": "Общество с ограниченной ответственностью \"Предприятие\"",
"ShortName": "ООО \"Предприятие\"",
"JoinedDiadocTreaty": true,
"Boxes": [
{
"BoxId": "6aef00f1c0ce45cc9140c663cbaa8ccd@diadoc.ru",
"BoxIdGuid": "6aef00f1-c0ce-45cc-9140-c663cbaa8ccd",
"Title": "ООО \"Предприятие\"",
"Organization": null,
"InvoiceFormatVersion": "v5_02",
"EncryptedDocumentsAllowed": false
}
],
"Ogrn": "",
"FnsParticipantId": "KAZ161240011918",
"Address": {
"RussianAddress": null,
"ForeignAddress": {
"Country": "398",
"Address": ""
},
"AddressCode": "",
"GarAddress": null
},
"FnsRegistrationDate": "",
"Departments": [],
"IfnsCode": "",
"IsPilot": false,
"IsActive": true,
"IsTest": false,
"IsBranch": false,
"IsRoaming": true,
"IsEmployee": false,
"InvitationCount": 0,
"SearchCount": 0,
"Sociability": "CounteragentsOnly",
"LiquidationDate": "",
"CertificateOfRegistryInfo": "",
"IsForeign": true,
"HasCertificateToSign": true,
"OrganizationType": "UnknownOrganizationType",
"IsOwner": false,
"ForeignInformation": {
"ForeignTaxpayerCode": "161240011918",
"IdentificationOfStatus": "ЮЛ",
"OtherInformation": ""
},
"ReadyForEpdStatus": "UndefinedEpdStatus",
"Comment": ""
}
]
}
См. также
Инструкции:
Методы для работы с организациями:
- GetBox — возвращает данные ящика по указанному идентификатору
- GetMyOrganizations — возвращает список организаций, в которых пользователь является сотрудником
- GetOrCreateRoamingOrganizationByFnsParticipantId — находит или создает роуминговую организацию по идентификатору участника ЭДО
- GetOrganization — возвращает данные организации по указанному идентификатору
- GetOrganizationFeatures — возвращает список дополнительных функций организации
- GetOrganizationsByInnKpp — возвращает данные организации по ИНН
- GetOrganizationsByInnList (V2) — возвращает список организаций и их статус партнерства по списку ИНН
- GetOrganizationsByForeignTaxpayerCode — возвращает данные организации по коду иностранного налогоплательщика
- GetResolutionRoutes — возвращает список всех неудаленных включенных маршрутов согласования для указанного ящика
- Register — находит или создает в Диадоке организацию по сертификату и добавляет владельца сертификата в сотрудники этой организации
- RegisterConfirm — подтверждает владение закрытым ключом сертификата для регистрации в организацию
- SearchFnsParticipants — ищет участников ЭДО в роуминге по ИНН, КПП или идентификатору участника ЭДО
- SendFnsRegistrationMessage — отправляет заявление участника ЭДО для указанного ящика