Описание ecos-edi-kontur
Библиотека ecos-edi-kontur обеспечивает интеграцию с сервисами Контур.Диадок и Контур.EDI. Maven-координаты: ru.citeck.ecos:ecos-edi-kontur.
Описание ниже сверено с исходниками версии 2.8.1, использующей ecos-edi-commons:3.8.0.
Документация сервисов:
Веб-интерфейсы сервисов:
Настройка подключения
Для Диадока и Контур.EDI создаются отдельные конфигурации ящиков и синхронизаций. В конфигурации ящика выберите провайдера Контур (KONTUR) и заполните параметры подключения:
Параметр |
Контур.Диадок |
Контур.EDI |
|---|---|---|
Источник данных ( |
Базовый URL API Диадока. |
Базовый URL API Контур.EDI. |
Авторизационные данные ( |
Credentials с заполненными |
Credentials с заполненными |
Идентификатор ящика ( |
Обязателен. |
Обязателен. |
Ключ разработчика ( |
Обязателен. |
Обязателен. |
GLN ( |
В этом пути подключения не используется. |
Обязателен дополнительно к остальным параметрам. |
Пример настройки: Настройка получения событий с ящиком Контур.Диадок. При использовании инструкции учитывайте версию механизма конфигурации в вашем экземпляре Citeck.
Выбор сервиса для синхронизации событий
В версии 2.8.1 обычная синхронизация событий выбирает сервис по URL источника данных. Диспетчер KonturEventsSyncService читает URL из атрибута config.url записи, указанной в datasourceRef, и выполняет проверки в следующем порядке:
Если URL содержит
diadocбез учёта регистра, запускается синхронизация с Диадоком.Иначе, если исходный URL содержит строчную подстроку
edi, запускается синхронизация с Контур.EDI. Эта проверка учитывает регистр.Если ни одно условие не выполнено, выбрасывается
IllegalArgumentException.
Если URL содержит обе подстроки, приоритет имеет Диадок. Прокси-адрес без распознаваемых подстрок не пройдёт эту проверку. Не меняйте регистр URL целиком для обхода ограничения: путь URL может быть чувствителен к регистру.
Это правило относится к обычной синхронизации событий. Метод точечной синхронизации pointWiseSync в этой версии делегирует запрос в Диадок без выбора сервиса по URL.
Версии конфигурации ящиков
Библиотека сохраняет два механизма чтения конфигурации:
v1 — устаревший
KonturBoxInfoProvider: URL читается изconfig.urlисточника данных, идентификатор ящика — изourId.attributes.boxId, аdevKeyиgln— изspecialInfo.v2 —
KonturBoxInfoDataProvider: конфигурации получаются черезEdiBoxDataService, URL — черезEdiDatasourceService, аboxId,devKeyиglnхранятся в отдельных полях конфигурации ящика.
При поиске подключения к API библиотека сначала обращается к механизму v1, затем, если конфигурация не найдена, — к v2. При этом диспетчер обычной синхронизации событий в версии 2.8.1 продолжает читать config.url напрямую. Используйте конфигурацию, совместимую с версией библиотеки и микросервиса, в котором она подключена.