Visma Horizon¶

• Table of contents
• Visma Horizon
• 01 Полное оригинальное руководство
• 02 Что это покрывает
• 03 Настройка со стороны Docura
• 04 Настройка в Horizon
  • 01 Контрольный список перед первым импортом
• 05 Получение документов (импорт из Docura)
  • 01 Ручной импорт
  • 02 Автоматический импорт (запланированное задание)
  • 03 После импорта
  • 04 Примечания
• 06 Отправка документов (экспорт в Docura)
  • 01 Шаги экспорта
  • 02 Поля, отображаемые после экспорта
  • 03 Примечания
• 07 Автоматическое обновление статусов
  • 01 Конфигурация
  • 02 Рекомендуемый интервал
  • 03 Как работает обновление статуса

01 Полное оригинальное руководство¶

Полные оригинальные инструкции (на латышском языке, со скриншотами) опубликованы Visma по адресу:

community.visma.com — Docura integrācija preču kustības dokumentu apmaiņai

Unlock02 Что это покрывает¶

Visma Horizon предлагает прямую интеграцию с Docura для обмена торговыми документами между поставщиками и их клиентами, использующими Horizon. Соединение использует прямую связь REST API с Docura — локальные папки файлов или промежуточные службы не требуются.

Интеграция поддерживает три потока:

1. Импорт входящих документов из Docura в Horizon (ORDER)
2. Экспорт исходящих документов из Horizon в Docura (INVOICE)
3. Автоматическое обновление статуса для экспортированных документов

Unlock03 Настройка со стороны Docura¶

Перед подключением Horizon убедитесь:

1. Компания зарегистрирована в Docura. Пошаговая инструкция — на вики-странице Регистрация в EDI-Web — зарегистрируйтесь на app.docura.net, подтвердите адрес электронной почты, найдите или создайте свою организацию и возьмите ClientID и Client secret (API key) в своём профиле
2. Получены адрес API и ключ API — служба поддержки Docura высылает их по запросу (через чат или по электронной почте)
3. Все торговые партнёры, ещё не подключённые к Docura, добавлены в сеть обмена

04 Настройка в Horizon¶

1. Перейдите в Система → Обмен данными → Соединения EDI API
2. Создайте новое соединение EDI API Docura
3. Введите Адрес API и Ключ API (оба обязательны; Имя пользователя необязательно)
4. Нажмите Тест — Horizon проверит соединение и сообщит об ошибке, если данные неверны

01 Контрольный список перед первым импортом¶

1. В записях о клиентах заполнен регистрационный номер или ILN (GLN)
2. В записях о продуктах зарегистрированы штрих-коды EAN
3. В записях о складах указан адрес доставки с ILN
4. Соединение EDI API Docura добавлено и протестировано

05 Получение документов (импорт из Docura)¶

Расположение: Система → Обмен данными → Импорт документов

Horizon периодически запрашивает новые документы из Docura самостоятельно — ручная обработка файлов не требуется.

01 Ручной импорт¶

Система → Обмен данными → Импорт документов → Новый документ

При создании записи импорта укажите:

1. Подключение — подключение Docura EDI API
2. Базовый тип документа и Тип документа — определяет, какой целевой документ создает Horizon

Ситуация	Результат
Создается новая запись импорта	Импортируются только документы Docura, еще не отмеченные как полученные
Целевой документ уже завершен	Повторное создание невозможно

02 Автоматический импорт (запланированное задание)¶

Местоположение: Система → Настройки → Автоматизированные задания → Импорт документов EDI из промежуточного слоя

Поле	Обязательно	Значения
Соединение	Да	Ранее созданное соединение EDI API Docura
Тип документа	Да	ORDER
Целевой документ	Да	Конкретный тип документа для создания

03 После импорта¶

1. Horizon автоматически создает целевой документ
2. Исходный XML-файл сохраняется как для записи импорта, так и для целевого документа
3. Docura помечает документ как полученный (READ=Y) — он больше не появится при последующем импорте

04 Примечания¶

1. Если целевой документ уже завершен, его невозможно повторно создать из записи импорта
2. Для повторного импорта откройте документ на портале Docura (по ссылке с портала EDI) и выберите Получить снова
3. Перед повторным созданием убедитесь, что исходная причина ошибки (данные клиента, склада или продукта) была исправлена в Horizon

06 Отправка документов (экспорт в Docura)¶

Исходящие документы (СЧЕТ-ФАКТУРА) могут быть отправлены в Docura непосредственно из списков Horizon одним действием — без ручной подготовки XML.

Местоположение:

1. Документы → Логистика → Заказы → Действия → Экспорт списка → Соединение с EDI API
2. Документы → Склад → Список счетов-фактур → Действия → Экспорт списка → Соединение с EDI API

Это действие появляется в меню только после того, как настроено хотя бы одно соединение с EDI API.

01 Шаги экспорта¶

Шаг	Описание
1. Выбор документа	Если в списке ничего не выбрано, экспортируется документ под курсором. Если выбрано несколько строк, отправляются все еще не экспортированные документы.
2. Выбор соединения	При одном соединении оно используется автоматически. При нескольких открывается диалоговое окно; Horizon запоминает последний выбор.
3. Проверка аутентификации	Соединение с API проверяется перед отправкой. Если оно недействительно, документы не отправляются.
4. Подготовка XML	Horizon подготавливает XML-файл для каждого документа с информацией заголовка, позициями и вложениями.
5. Отправка	XML отправляется в Docura API. Возвращается ID подтверждения или сообщение об ошибке; прогресс отображается в реальном времени.
6. Обновление документа	Horizon сохраняет соединение, ID оператора, время экспорта и статус Отправлено. Это регистрируется как событие экспорта через EDI API.

02 Поля, отображаемые после экспорта¶

Поле	Описание
Соединение EDI API	Какое соединение использовалось для экспорта
Статус экспорта EDI	Отправлено во время экспорта, позже обновляется на Обработано или Ошибка
Код ошибки EDI	Идентификатор сообщения, присвоенный Docura
Сообщение об ошибке EDI	Текст ошибки или предупреждения от Docura
Ссылка на портал EDI	Прямая ссылка на документ на портале Docura

03 Примечания¶

1. Уже экспортированные документы автоматически пропускаются при выборе строк — это предотвращает дублирование
2. Не отправляйте один и тот же документ дважды в течение короткого времени — Docura обрабатывает документы асинхронно и может не обнаружить дубликат
3. Поля статуса экспорта EDI заполняются автоматически и не предназначены для ручного редактирования

07 Автоматическое обновление статусов¶

После экспорта Horizon автоматически запрашивает у Docura и обновляет статусы документов — ручная проверка на портале не требуется.

Местоположение: Система → Настройки → Автоматические задания → Получение статуса документов экспорта EDI API

Unlock01 Конфигурация¶

Поле	Обязательно	Значения
Соединение	Да	Ранее созданное соединение EDI API
Тип документа	Нет	Все типы, INVOICE или ORDER

02 Рекомендуемый интервал¶

Horizon запрашивает у Docura изменения за последние 24 часа каждый раз при запуске задания.

1. Минимум: каждые 10 минут (более частые проверки создают излишнюю нагрузку)
2. Оптимально: раз в час
3. Максимум: не реже одного раза в 24 часа

Внимание: если задание не запускается более 24 часов, любые изменения Docura за этот период не будут получены Horizon.

03 Как работает обновление статуса¶

Результат Docura	Статус Horizon	Объяснение
Нет ошибок	Обработано	Документ успешно доставлен получателю. При наличии предупреждения оно сохраняется в поле сообщения об ошибке EDI.
Присутствует флаг ошибки	Ошибка	Документ не дошел до получателя.

Задание обновляет документ только тогда, когда что-то фактически изменилось — ненужные события не регистрируются. Каждое реальное изменение записывается как событие изменения статуса EDI API с точным списком обновленных полей.