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

Быстрый старт

Ниже описан простой пример отправки неформализованного документа через систему Диадок из тестовой в тестовую организацию.

Чтобы отправить документ, выполните следующие шаги:

  1. Подготовьте две тестовые организации:
    1. Создайте два тестовых ящика с помощью формы.
    2. Добавьте ящики в контрагенты друг к другу с помощью веб-интерфейса Диадока.
  2. Авторизуйтесь в системе и получите авторизационный токен: этот токен в дальнейшем нужно будет передавать в заголовке Authorization при вызове каждого метода. Подробнее об использовании токена — на странице Авторизация.
  3. Получите идентификатор ящика организации-отправителя с помощью метода GetMyOrganizations.
  4. Получите идентификатор ящика организации-контрагента с помощью метода GetCounteragents (V3).
  5. Подготовьте документ на отправку и подпишите его тестовой подписью: для этого заполните структуру DocumentAttachment и укажите признак SignedContent.SignWithTestSignature. Обратите внимание, что API Диадока не создает файл подписи, его нужно сгенерировать самостоятельно. Также для некоторых типов документов нужно самостоятельно заполнить метаданные. Алгоритм по работе с формализованными и неформализованными документами описан на странице Алгоритм работы с документами.
  6. Отправьте документ: для этого заполните структуру MessageToPost, добавьте в нее информацию о документе в структуре DocumentAttachment и отправьте с помощью метода PostMessage (V3). Инструкция по отправке документа приведена на странице Отправка сообщения с документом.
  7. Проверьте статус отправленного документа с помощью метода GetDocument (V3).
  8. Отслеживайте состояние документа с помощью ленты событий.

Пример (C#)

var diadocApi = new DiadocApi(
clientId,
apiUrl,
crypt,
clientSecret,
oidcBaseUrl = null);
// oidcBaseUrl - необязательный параметр: если его не указать, то по умолчанию будет identity.kontur.ru

// Получение токена доступа при помощи токена обновления
var accessToken = diadocApi.AuthenticateWithOidc(refreshToken);
diadocApi.UseOidc();

// Получение идентификатора ящика отправителя
var organizationList = diadocApi.GetMyOrganizations(accessToken);
var organizations = organizationList.Organizations;
var myOrgBoxIds = organizations.Select(org => org.Boxes.First().BoxId);

// Получение идентификатора ящика получателя
string counteragentStatus = null;
string afterIndexKey = null;
var counteragentList = diadocApi.GetCounteragents(accessToken, myOrgId, counteragentStatus, afterIndexKey);
var counteragents = counteragentList.Counteragents;
var myCounteragentOrgBoxIds = counteragents.Select(c => c.Organization.Boxes.First().BoxId);

// Подготовка документа

// Заполнение содержимого документа
string NonformalizedDocumentPath = @"<путь_к_файлу>"; // путь к файлу, который нужно отправить
var content = File.ReadAllBytes(NonformalizedDocumentPath); // бинарное содержимое файла

// Заполнение информации о документе в структуре DocumentAttachment
var documentAttachment = new DocumentAttachment
{
TypeNamedId = "nonformalized",

SignedContent = new SignedContent
{
Content = content,
SignWithTestSignature = true
},

Comment = "Текстовый комментарий к документу",
CustomDocumentId = "Строковый идентификатор учетной системы",

Metadata =
{
new MetadataItem
{
Key = "FileName",
Value = Path.GetFileNameWithoutExtension(NonformalizedDocumentPath)
}
}
};

// Заполнение информации о документе в MessageToPost
var messageToPost = new MessageToPost
{
FromBoxId = myOrgBoxIds,
ToBoxId = myCounteragentOrgBoxIds
};

messageToPost.DocumentAttachments.Add(documentAttachment);

// Отправка документа
var response = diadocApi.PostMessage(accessToken, messageToPost);
var responseDocument = response.Entities.FirstOrDefault(e => string.IsNullOrEmpty(e.ParentEntityId)); // т.к. у документа нет "родительских сущностей"

// Проверка статуса
var document = diadocApi.GetDocument(accessToken, myOrgBoxIds, response.MessageId, responseDocument.EntityId);
var status = document.DocflowStatus.PrimaryStatus;
Console.WriteLine("Сообщение отправлено, статус: " + status);

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

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

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