База знаний

Для ЭдоЛайт, Платформа ЭДО и Астрал.ЭДО установите один из плагинов подписи в браузере (достаточно того, которым пользуетесь): КриптоПро ЭЦП Browser plug-in (нужен также КриптоПро CSP на компьютере) или плагин Рутокен (устройство Рутокен должно быть подключено).

В хранилище должны быть действующие сертификаты ГОСТ с закрытым ключом (ГОСТ Р 34.10-2001 или ГОСТ Р 34.10-2012) — для операторов с браузерной подписью.

Организация должна иметь доступ к выбранному оператору ЭДО (СБИС, ЭдоЛайт / ГИС МТ, Платформа ЭДО, Астрал.ЭДО или Диадок) под указанными реквизитами и (при необходимости) сертификатом.

Для Диадок заранее получите доступ к API в Кабинете интегратора Контур: идентификатор приложения (client_id) и API-ключ (client_secret).

Откройте раздел Настройка подключений и добавьте источник типа «ЭдоЛайт» (или раскройте уже созданный).

Укажите ИНН организации-участника оборота.

Выберите тип плагина: КриптоПро или Рутокен — в зависимости от того, каким средством электронной подписи вы работаете.

В поле «Сертификат» выберите сертификат из списка. В списке отображаются только валидные ГОСТ-сертификаты с закрытым ключом, которые видит выбранный плагин. При необходимости нажмите кнопку обновления списка.

Нажмите «Проверка». DocExchange запросит ключ авторизации True API, подпишет его вашим сертификатом через выбранный плагин на этом компьютере и проверит доступ к API ЭДО.

Сохраните настройки коннекторов.

В Настройка подключений добавьте источник типа «Платформа ЭДО».

Укажите GID абонента ЭДО (идентификатор вида 2VO-…).

При работе с тестовым стендом включите «Тестовый стенд».

Выберите плагин КриптоПро или Рутокен и сертификат — так же, как для ЭдоЛайт.

Нажмите «Проверка»: DocExchange подпишет OAuth-запрос (ts + nonce) на вашем компьютере и обменяет подпись на Bearer-токен.

Сохраните настройки коннекторов.

В Настройка подключений добавьте источник типа «Астрал.ЭДО».

Укажите AbonentId — внутренний идентификатор абонента в Астрал.ЭДО (uuid). Его можно узнать в личном кабинете Астрал.ЭДО или у технической поддержки оператора.

Выберите плагин КриптоПро или Рутокен и сертификат — так же, как для ЭдоЛайт. Сертификат должен быть зарегистрирован в Астрал.ЭДО для доступа к интеграционному API.

Нажмите «Проверка»: DocExchange получит строку для подписи, подпишет её на вашем компьютере и обменяет подпись на токен доступа к API Астрал.ЭДО.

Сохраните настройки коннекторов.

В Настройка подключений добавьте источник типа «Диадок».

Укажите ClientId и ClientSecret (API-ключ) приложения из Кабинета интегратора Контур.

Получите доступ одним из способов:

• Refresh-токен — выпустите refresh-токен в Кабинете интегратора (режим для роботизированных приложений) и вставьте его в поле RefreshToken;
• Device Flow — нажмите «Войти (Device Flow)», откройте ссылку подтверждения, введите код на сайте Контур и дождитесь завершения входа; refresh-токен сохранится в настройках автоматически.

При работе с тестовой площадкой включите «Тестовая площадка (staging)».

Нажмите «Ящики», выберите нужный BoxId из списка организаций Диадок (или введите идентификатор ящика вручную).

Нажмите «Проверка»: DocExchange обновит access-токен по refresh-токену и проверит доступ к выбранному ящику.

Сохраните настройки коннекторов.

Откройте Входящие документы → ЭДО.

Укажите период «С» и «По»: выберите даты в календаре или введите вручную в формате дд.мм.гггг.

Нажмите «Получить». Документы загружаются из всех настроенных источников (СБИС, ЭдоЛайт, Платформа ЭДО, Астрал.ЭДО и Диадок). Для ЭдоЛайт, Платформа ЭДО и Астрал.ЭДО снова используется подпись через выбранный плагин (КриптоПро или Рутокен); токен авторизации может переиспользоваться в рамках текущей сессии браузера. Для Диадок используется сохранённый refresh-токен (плагин подписи не нужен).

При необходимости включите «Не отображать документы, недоступные к выгрузке» — останутся только документы с УПД, доступным к открытию.

Нажмите «Открыть» у нужной строки, чтобы просмотреть УПД, сопоставить номенклатуру и создать документ в системе-приёмнике.

«CryptoPro плагин недоступен» / плагин Рутокен недоступен — плагин не установлен, заблокирован браузером или не загрузился. Для Рутокен также проверьте, что устройство подключено. Установите нужный плагин и обновите страницу.

«Подпись невалидна» — проверьте, что выбран действующий сертификат организации, зарегистрированный у оператора ЭДО, и что закрытый ключ доступен (токен/носитель подключён, введён PIN при запросе).

Пустой список сертификатов — нет валидных ГОСТ с закрытым ключом в хранилище, либо выбранный плагин не видит сертификаты (для Рутокен — устройство не подключено).

Пустой список документов — за выбранный период во входящих нет документов, либо коннектор настроен на другие реквизиты (ИНН / GID / AbonentId / BoxId).

Ошибки входа Диадок (invalid_client, invalid_grant) — проверьте ClientId, ClientSecret и RefreshToken; при необходимости заново выпустите refresh-токен в Кабинете интегратора или повторите Device Flow. Убедитесь, что в кабинете выбран подходящий способ получения токенов (AuthorizationCode для выпуска refresh-токена, Device — для Device Flow).

«Время ожидания подтверждения Device Flow истекло» — подтвердите вход на сайте Контур быстрее или нажмите «Войти (Device Flow)» ещё раз.