Как настроить интеграцию 1С и ЭТРАН: практический гайд

Интеграция 1С с АС ЭТРАН нужна грузоотправителям, грузополучателям и экспедиторам, которые оформляют перевозочные документы по железной дороге и не хотят вручную дублировать данные из учётной системы в личный кабинет ЭТРАН. Типовой сценарий: в 1С оформляется реализация или перемещение, а накладная, заявка ГУ-12 или электронный акт автоматически передаются в ЭТРАН и подписываются электронной подписью.

Единого «коробочного» модуля обмена от фирмы «1С» не существует: интеграцию строят либо через типовой обмен XML-файлами (механизм, который поддерживает сама АС ЭТРАН), либо через программный интерфейс АСУ ЭТРАН API (веб-сервисы), либо с помощью готовых отраслевых решений и обработок от партнёров. Выбор зависит от объёма документов, требований к оперативности и бюджета.

Перед началом работ убедитесь, что у организации есть действующий доступ в АС ЭТРАН (Центр фирменного транспортного обслуживания РЖД), оформленная электронная подпись, зарегистрированная в системе, и договор на электронный документооборот. Без этих условий техническая настройка обмена бессмысленна — документы просто не будут приняты.

Что нужно подготовить до начала настройки

Интеграция начинается не с кода, а с организационных условий. Проверьте наличие: учётной записи в АС ЭТРАН с правами на подготовку и подписание документов, квалифицированной электронной подписи (УКЭП), зарегистрированной в системе, и заключённого соглашения об электронном документообороте с РЖД. Если какого-то пункта нет, сначала решите вопрос через ЦФТО.

Со стороны 1С потребуется: актуальная конфигурация (УТ 11, ERP, КА или отраслевое решение), права администратора для установки расширений и настройки регламентных заданий, а также сервер или рабочее место, где будет работать обмен — с доступом в интернет и установленным криптопровайдером (КриптоПро CSP или аналог, совместимый с требованиями ЭТРАН).

Выбор способа интеграции: файл, API или готовое решение

Существует три рабочих подхода. Первый — обмен XML-файлами: 1С выгружает документ в формате, согласованном с ЭТРАН, файл подписывается и передаётся через личный кабинет или специализированный клиент. Это самый простой вариант для малого документооборота, но он требует ручных действий или отдельного автоматизирующего ПО.

Второй подход — прямая интеграция через программный интерфейс АСУ ЭТРАН (веб-сервисы). 1С обращается к сервису напрямую, передаёт документы, получает статусы обработки и подписанные ответные документы. Это самый оперативный и масштабируемый вариант, но он требует разработки и согласования доступа к API с оператором системы.

Третий вариант — готовые модули и обработки от партнёров-интеграторов, которые уже реализовали обмен и поддерживают его при изменении форматов. Это оптимально, когда нет собственных разработчиков, а форматы ЭТРАН периодически меняются.

Настройка обмена XML-файлами из 1С

Для файлового обмена в 1С создаётся обработка выгрузки, которая формирует XML по структуре, принятой в ЭТРАН для конкретного вида документа (перевозочная накладная, заявка на перевозку, акты). Структуру XML запросите у ЦФТО или возьмите из документации к вашему договору ЭДО — форматы для разных документов отличаются.

Практическая последовательность: создайте в 1С регистр или подсистему «Документы ЭТРАН», где фиксируется связь учётного документа с выгруженным файлом и его статусом. Настройте выгрузку по кнопке из карточки документа, а при большом объёме — регламентное задание, которое пакетно формирует файлы по проведённым документам за период.

Подписание файлов выполняется средствами криптопровайдера. В 1С это можно реализовать через встроенные механизмы работы с электронной подписью (подсистема «Электронная подпись» в БСП) либо внешним вызовом утилиты криптопровайдера. Подписанный файл загружается в ЭТРАН, после чего в личном кабинете проверяется статус приёма.

1. 1
   Получите у ЦФТО актуальные XSD-схемы или образцы XML для нужных документов
2. 2
   Разработайте или настройте обработку выгрузки XML из 1С
3. 3
   Настройте подписание файла сертификатом УКЭП на рабочем месте обмена
4. 4
   Загрузите тестовый файл в ЭТРАН и проверьте статус приёма
5. 5
   Настройте регламентное задание для пакетной выгрузки и журнал статусов

Интеграция через веб-сервисы АСУ ЭТРАН

При интеграции через API обмен происходит без файловой прослойки: 1С формирует сообщение, подписывает его и отправляет в веб-сервис, после чего опрашивает сервис о результате обработки. Доступ к программному интерфейсу и его описание запрашиваются у оператора — без официального согласования подключение невозможно.

В 1С работа с веб-сервисом строится через HTTPСоединение или WS-ссылки. Типовая схема: фоновое задание берёт очередь документов к отправке, формирует запрос, подписывает, отправляет и записывает идентификатор транзакции. Второе задание с периодичностью в несколько минут опрашивает статусы и обновляет состояния в учётной системе.

Соединение = Новый HTTPСоединение("api.etran.example", 443, , , , 60, Новый ЗащищенноеСоединениеOpenSSL);
Запрос = Новый HTTPЗапрос("/documents");
Запрос.УстановитьТелоИзСтроки(ТелоXML);
Ответ = Соединение.ОтправитьДляОбработки(Запрос);
Если Ответ.КодСостояния = 200 Тогда
    ЗаписатьСтатусДокумента(Документ, "Принят в обработку");
КонецЕсли;

Обратите внимание на идемпотентность: при сетевом сбое повторная отправка не должна создавать дубль документа в ЭТРАН. Используйте уникальные номера документов и проверяйте статус перед повторной отправкой, а не отправляйте «вслепую».

Подписание документов и работа с электронной подписью

Электронная подпись — самое частое место сбоев. Сертификат должен быть действующим, установленным в хранилище той учётной записи ОС, под которой работает обмен, и зарегистрированным в ЭТРАН именно для того лица, от которого подписываются документы. При серверном обмене подписание выполняется на сервере 1С, и сертификат должен быть доступен там.

Если подписание выполняет регламентное задание, убедитесь, что закрытый ключ доступен без интерактивного ввода пароля (или пароль хранится в защищённом виде и подставляется программно). Иначе задание будет завершаться ошибкой криптографии, причём в журнале регистрации это часто выглядит как невразумительный сбой.

Проверка результата и типовые ошибки

После настройки проведите контрольный цикл на тестовом документе: выгрузка, подписание, передача, получение статуса, получение подписанного ответного документа. Успешный признак — документ виден в личном кабинете ЭТРАН со статусом «принят», а в 1С зафиксирована связь и актуальное состояние.

Ограничения и когда нужен специалист

Самостоятельно разумно настраивать файловый обмен при небольшом документообороте и наличии специалиста 1С в штате. Прямую интеграцию через API, многофирменный учёт, обработку отказов и расхождений лучше поручать разработчику с опытом именно ЭТРАН — специфика форматов и регламентов РЖД существенно влияет на сроки.

Учтите, что форматы документов и правила ЭДО периодически обновляются. Заложите в эксплуатацию процедуру контроля: ответственный следит за уведомлениями ЦФТО, а при смене форматов обмен тестируется на копии базы до включения в продуктиве.

Частые вопросы