Данные контрагентов

Диадок позволяет работать с данными контрагентов: получать о них информацию и статус партнерства, запрашивать доступные сертификаты для шифрования, выполнять поиск.

Получение информации о контрагенте

Чтобы получить информацию о контрагенте и статус партнерства с ним, используйте метод GetCounteragent (V3).

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

GET /V3/GetCounteragent?myBoxId={{myBoxId}}&counteragentBoxId={{counteragentBoxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json; charset=utf-8

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

{
    "LastEventTimestamp": "2024-08-06T12:36:38.8979088Z",
    "Organization": {
        "OrgIdGuid": "72c3b5bf-3a9f-4fb5-a3ef-112cb2b3a8dc",
        "OrgId": "72c3b5bf-3a9f-4fb5-a3ef-112cb2b3a8dc",
        "Inn": "9147414342",
        "Kpp": "757645784",
        "FullName": "Ромашка",
        "ShortName": "Ромашка",
        "JoinedDiadocTreaty": true,
        "Boxes": [
            {
                "BoxId": "2a208d032a604f6491b1b7aad54cfaf3@diadoc.ru",
                "BoxIdGuid": "2a208d03-2a60-4f64-91b1-b7aad54cfaf3",
                "Title": "Ромашка",
                "InvoiceFormatVersion": "v5_02",
                "EncryptedDocumentsAllowed": false
            }
        ],
        "Ogrn": "9130523523154",
        "FnsParticipantId": "2BM-9147414342-757645784-202407101104400484330",
        "Address": {
            "RussianAddress": {
                "ZipCode": "620142",
                "Region": "66",
                "City": "Екатеринбург",
                "Street": "Сажинская",
                "Building": "11"
            },
            "AddressCode": ""
        },
        "Departments": [
            {
                "DepartmentId": "00000000-0000-0000-0000-000000000000",
                "ParentDepartmentId": "",
                "Name": "Головное подразделение",
                "Abbreviation": "ГП",
                "Address": {
                    "RussianAddress": {
                        "Region": ""
                    },
                    "AddressCode": ""
                },
                "IsDisabled": false
            }
        ],
        "IfnsCode": "6174",
        "IsPilot": false,
        "IsActive": true,
        "IsTest": false,
        "IsBranch": false,
        "IsRoaming": false,
        "IsEmployee": false,
        "InvitationCount": 0,
        "SearchCount": 0,
        "Sociability": "AllOrganizations",
        "IsForeign": false,
        "HasCertificateToSign": true,
        "OrganizationType": "Juridical",
        "IsOwner": false
    },
    "CurrentStatus": "IsMyCounteragent",
    "LastEventTimestampTicks": 638585445988979088,
    "MessageToCounteragent": "Примите приглашение к сотрудничеству",
    "InvitationDocumentId": {
        "MessageId": "215a68d5-28a0-4c6a-b9ec-cdba1530fd49",
        "EntityId": "ad810ad2-8d4f-4fd9-9321-5359dfc0a37a"
    },
    "CounteragentGroupId": "ecd591dd-b56f-4178-ab4a-8a5532f231f7"
}

Получить ленту событий по изменению отношений с контрагентом можно с помощью метода GetCounteragentEvents (V1). Подробнее в инструкции Лента событий по контрагентам.

Получение сертификатов контрагента

Если вы хотите отправить контрагенту зашифрованный документ, вам нужно выбрать сертификат, на который будет зашифрован этот документ. Для этого вы можете получить все сертификаты контрагента и выбрать из них подходящий.

Организация может запросить список сертификатов контрагента только если у нее включена возможность отправки зашифрованных документов. Эта возможность указана в поле Organization.Box.EncryptedDocumentsAllowed.

Чтобы получить сертификаты контрагента, используйте метод GetCounteragentCertificates (V2).

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

GET /V2/GetCounteragentCertificates?myBoxId={{myBoxId}}&counteragentBoxId={{counteragentBoxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json; charset=utf-8

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

{
    "Certificates": [
        {
            "RawCertificateData": "MIIIyjCCCHegAwIBAgIRAdD...Brfw=="
        }
    ]
}

Поиск контрагентов

Найти контрагентов вне списка контрагентов можно с помощью методов для поиска организаций:

• GetOrganizationsByInnKpp — возвращает организации с указанными ИНН и КПП.

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

• GetBox — по идентификатору ящика возвращает информацию об организации, которой он принадлежит.

• GetOrganization — по идентификатору организации возвращает принадлежащий ей ящик и ее данные: например, ИНН, КПП, название и т.п.