GetOrganizationsByForeignTaxpayerCode

Возвращает данные организации по коду иностранного налогоплательщика.

GET /GetOrganizationsByForeignTaxpayerCode

Query Parameters:

• foreignTaxpayerCode – код иностранного налогоплательщика.

• 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.

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

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

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

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

{
    "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"
        }
    ]
}

---

См. также

Инструкции:

• Трансграничный электронный документооборот

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

• GetBox — возвращает данные ящика по указанному идентификатору

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

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

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

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

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

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

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

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

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

• SendFnsRegistrationMessage — отправляет заявление участника ЭДО для указанного ящика