Конфигурация ЭДО
Описание ниже сверено с исходниками ecos-edi:1.14.0. Настройки поставляются отдельными конфигурационными артефактами приложения. Их значения могут быть переопределены в установленном экземпляре Citeck.
Идентификаторы ящиков, источники данных и авторизационные данные задаются в конфигурациях ящиков. Пример: Настройка получения событий с ящиком Контур.Диадок. При использовании инструкции учитывайте версию механизма конфигурации ящиков.
Основные настройки обработки документов
Таблица описывает основные параметры подписи, фильтрации событий и обработки печатных форм. Она не является полным перечнем конфигурации микросервиса. В столбце «Поставляемое значение» указано значение из артефакта приложения.
Параметр |
Описание |
Поставляемое значение |
|---|---|---|
|
Определяет данные, подготавливаемые для электронной подписи: |
|
|
Определяет, допускается ли событие к обработке при отсутствии контрагента. В режиме |
|
|
При |
|
|
При |
|
Для splitLsdfDocflowByLegalEntities и allowGenerateLsdfPrintFormsAsyncOnFail используйте логические значения true и false. Хотя артефакты поставляют true, при отсутствии значения в соответствующем поле конфигурационного сервиса его метод возвращает false.
Фильтрация событий по контрагенту
Поиск выполняется через EcosCounterpartyService.findCounterpartyWithSourceId с учётом ссылки на синхронизацию. Если задан пользовательский источник counterpartySourceId, поиск сначала выполняется в нём. При отсутствии результата используется поиск по идентификатору ящика контрагента, типу провайдера и активности записи ЭДО.
Значение BOX_ID сравнивается без учёта регистра. Любое другое значение не включает ограничение по наличию контрагента; при пустом или отсутствующем значении используется ALL. Внутренний пакет определяется по признаку counterpartyId.attributes.internal и проходит этот фильтр независимо от режима.
В обработчике событий фильтр не ограничен отдельной проверкой входящего направления. Режим ALL снимает только ограничение по наличию контрагента: успешная загрузка документа также зависит от последующей обработки.
Отложенная генерация печатных форм
Для современного хранилища документ помечается атрибутом ediDocInfo:needUpdatePrintForm. В режиме legacy/Alfresco используется атрибут eint:needUpdatePrintForm.
В микросервис входит штатная задача UpdatePrintFormJob. Она регистрируется при запуске приложения и использует настройку ecos.job.update-print-form.cron. Поставляемое cron-выражение 0 0/3 * * * * задаёт запуск каждые три минуты; окружение может переопределить расписание.
Задача выбирает до 100 записей типа edi-document с ediDocInfo:needUpdatePrintForm=true за проход. После успешного сохранения ПФ флаг снимается. При результатах NOT_YET_GENERATED и UNKNOWN_ERROR документ остаётся для повторной обработки; при других ошибках типа PrintFormGenerationException повторная генерация отключается.
Предупреждение
При использовании отложенной генерации проверьте работу штатной задачи и её расписание. Её выборка рассчитана на edi-document с атрибутом ediDocInfo:needUpdatePrintForm. Для документов legacy/Alfresco с атрибутом eint:needUpdatePrintForm требуется отдельно проверить наличие совместимого обработчика.