Интеграция без разработки полноценного API-клиента

Коннектор для интеграции ЭТрН и ЭПД с учетной системой

Настройте управляемый обмен перевозочными документами через XML-файлы, каталоги или согласованный файловый транспорт. Учетная система передает исходные данные и получает идентификаторы, статусы и результаты обработки.

  • для ERP, TMS, WMS и собственных учетных систем;
  • пакетная загрузка и массовая обработка документов;
  • меньше разработки по сравнению с прямой API-интеграцией.

Задать вопрос: +7 950 951-2-159 · admin@roccos.ru

Когда подходит коннектор

Коннектор занимает промежуточное место между ручной работой в веб-интерфейсе и индивидуальной разработкой по API.

Данные уже есть в учете

Заказы, рейсы, контрагенты и грузы хранятся в ERP, TMS, WMS или собственной системе и не должны вводиться повторно.

Есть файловый обмен

Учетная система умеет формировать XML или другие согласованные файлы и забирать результаты из каталогов.

API-разработка избыточна

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

Нужна пакетная обработка

Документы формируются по расписанию или большими группами, а сотрудники контролируют только исключения.

Система нестандартная

Готового модуля для учетной системы нет, но можно реализовать выгрузку и загрузку файлов по спецификации.

Важен быстрый запуск

Файловый проект может быть проще прямой интеграции, если процесс укладывается в поддерживаемые сценарии.

Название «коннектор» не гарантирует поддержку всех ЭПД и всех операций. До публикации коммерческих обещаний и до внедрения подтвердите конкретное решение, форматы, документы, титулы, протоколы и правила подписания.

Какие задачи можно автоматизировать

Набор возможностей фиксируется в техническом задании и проверяется на тестовом обмене.

Загрузка XML

Прием файлов с данными для создания документов или отдельных титулов по согласованной структуре.

Файловый обмен

Обработка входных и выходных каталогов с разделением успешных операций, ошибок и архива.

FTP или SFTP

Передача файлов через согласованный сервер с учетом требований к доступу, шифрованию и журналированию.

Синхронизация статусов

Возврат идентификаторов, событий, результатов проверки и текущего состояния документа в учетную систему.

Массовая обработка

Пакетное формирование, отправка или обновление документов без открытия каждой карточки вручную.

Автоматическая отправка

Передача документов после успешных проверок по правилам, определенным для организации и вида операции.

Как устроен файловый обмен

Типовая схема использует входные файлы, очередь обработки и возврат результата.

  1. 1. Учетная система готовит данныеERP, TMS или WMS выбирает заказ, рейс и сведения для электронного документа
  2. 2. Формируется входной файлданные выгружаются в XML или иной поддерживаемый формат с уникальным внутренним идентификатором
  3. 3. Файл передается коннекторучерез локальный или сетевой каталог, FTP, SFTP либо другой согласованный канал
  4. 4. Коннектор проверяет и обрабатывает файлвыполняется техническая проверка, создание операции и передача данных в сервис
  5. 5. Выполняется подписание и отправкаавтоматически или после предусмотренного подтверждения уполномоченным сотрудником
  6. 6. Возвращается результатучетная система получает идентификатор, статус, сообщение об ошибке или файл результата
  7. 7. Статусы обновляютсяпоследующие события других участников регулярно синхронизируются с внутренним объектом

Что предусмотреть в структуре обмена

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

Входящие файлы

Отдельный каталог для новых заданий с ограничениями по расширению, размеру и кодировке.

Успешная обработка

Результаты с идентификатором документа, временем операции и текущим статусом.

Ошибки

Отдельный поток с кодом, понятным описанием и ссылкой на исходное задание.

Архив

Сохранение обработанных файлов для аудита, диагностики и защиты от повторной отправки.

Идентификаторы

Внутренний номер должен однозначно связывать файл, документ, заказ и результат.

Версии форматов

Нужно фиксировать поддерживаемые схемы и порядок перехода на обновленную версию.

Именование

Правила имен файлов не должны допускать конфликтов при параллельной обработке.

Срок хранения

Для технических файлов и журналов задаются отдельные правила очистки и архивирования.

Документы и операции

Для каждого вида ЭПД составляется отдельная матрица поддержки.

ЭТрН

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

Заказ-заявка

Передача условий перевозки, получение ответных действий и связь с последующей ЭТрН.

Экспедиторские документы

Поручение и расписки включаются только после подтверждения форматов и доступных операций.

ЭПЛ

Путевой лист требует специфических участников, показателей и событий, которые проверяются отдельно.

Для каждого документа проверьте: создание всех нужных титулов, подписание, отправку, входящие действия, отмену или исправление, статусы, печатные формы и выгрузку полного документооборота.

Как организовать подписание и отправку

Автоматизация не должна обходить полномочия и контроль юридически значимых действий.

Ручное подтверждение

Коннектор создает документ, а сотрудник проверяет его и подписывает в доступном интерфейсе.

Автоматический сценарий

Отправка выполняется по заданному правилу, если формат, данные, сертификат и полномочия прошли проверки.

Смешанный режим

Типовые документы проходят автоматически, а исключения и операции с повышенным риском направляются сотруднику.

  • определите подписанта для каждого титула и организации;
  • проверьте сертификаты и машиночитаемые доверенности;
  • задайте перечень автоматических и ручных операций;
  • запретите отправку при критичных расхождениях;
  • сохраняйте сведения о пользователе, времени и результате действия;
  • предусмотрите замещение подписанта и остановку автоматического обмена.

Обработка ошибок и повторных попыток

Надежная интеграция должна управляемо обрабатывать сбои без потери и дублирования документов.

Ошибка формата

Файл не соответствует схеме, содержит недопустимые значения или обязательные поля не заполнены.

Ошибка справочника

Не найден контрагент, адрес, транспорт, водитель или соответствие внутреннего кода.

Ошибка полномочий

Нет подходящего сертификата, МЧД, права пользователя или доступа к организации.

Технический сбой

Недоступен сервер, каталог, сеть или внешний сервис; задание должно перейти в контролируемую очередь повторов.

Дубликат

Повторная передача того же задания не должна создавать второй документ без явного основания.

Зависший статус

Если событие долго не обновляется, система формирует уведомление ответственному сотруднику.

Сравнение способов подключения

Коннектор подходит не всем процессам. Иногда проще использовать готовый модуль или API.

Готовый модуль

Выбирайте для поддерживаемой учетной системы, если сотрудники должны работать с ЭПД прямо в ее интерфейсе.

Интеграция с 1С

Коннектор

Подходит для файлового или пакетного обмена, когда учетная система умеет выгружать и принимать данные.

API

Нужно для нестандартной логики, событийного обмена в реальном времени и полного управления пользовательским сценарием.

Интеграция по API

Этапы подключения коннектора

Работы начинаются с описания обмена и заканчиваются контролем первых рабочих документов.

  1. Обследованиеучетная система, роли, документы, объемы, инфраструктура и требования безопасности
  2. Матрица поддержкивиды ЭПД, титулы, операции, подписи, статусы и ограничения
  3. Спецификация файловформаты, версии схем, каталоги, именование, идентификаторы и ответы
  4. Настройка транспорталокальный обмен, сетевой ресурс, FTP, SFTP или другой подтвержденный канал
  5. Настройка учетной системывыгрузка заданий, загрузка результатов и отображение статусов
  6. Тестированиеуспешные операции, ошибки, дубли, повторные попытки и большие пакеты
  7. Запускмониторинг очередей, поддержка пользователей и корректировка правил

Чек-лист готовности

Ответы помогут понять, подойдет ли файловая интеграция вашему процессу.

□ Система определена

Известны ERP, TMS, WMS или собственное решение и его возможности.

□ Документы перечислены

Зафиксированы виды ЭПД и необходимые титулы.

□ Формат согласован

Определены XML-схемы, версии и обязательные поля.

□ Канал выбран

Подтвержден каталог, FTP, SFTP или иной транспорт.

□ Идентификаторы заданы

Документ однозначно связан с заказом и результатом.

□ Подписание описано

Понятны ручные и автоматические действия.

□ Статусы сопоставлены

Учетная система умеет принимать и показывать события.

□ Ошибки обрабатываются

Есть очередь, уведомления и повторные попытки.

□ Дубли исключены

Повторный файл не создает лишний документ.

□ Нагрузка проверена

Известен объем файлов и пиковая интенсивность.

□ Безопасность согласована

Настроены доступы, шифрование и журналы.

□ Тест пройден

Проверен полный маршрут с контрагентом.

Частые вопросы о коннекторе для ЭПД

Что такое коннектор для обмена ЭПД?

Это интеграционное решение, которое связывает учетную систему с сервисом через готовый механизм обмена и помогает автоматизировать работу без разработки полноценного API-клиента с нуля.

Чем коннектор отличается от API?

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

Можно ли передавать ЭТрН в XML?

Файловый сценарий может использовать XML поддерживаемого формата. До запуска проверяются версия схемы, обязательные реквизиты, правила именования и формат результата.

Поддерживается ли FTP или SFTP?

Такие протоколы могут использоваться в конкретном проекте. Фактическую поддержку и требования безопасности нужно подтвердить для выбранного решения.

Можно ли автоматически отправлять документы?

Да, если сценарий, полномочия и решение это поддерживают. Для каждого титула определяют, нужна ли ручная проверка или допустима автоматическая отправка.

Как возвращаются статусы?

Коннектор передает идентификаторы, результаты, статусы и ошибки через согласованный выходной поток, а учетная система связывает их с исходным заказом или рейсом.

Подходит ли коннектор для массовой обработки?

Да, пакетный обмен является одним из основных сценариев. Нужно проверить производительность, очереди, дубли, повторные попытки и частичные ошибки.

Какие виды ЭПД поддерживаются?

Поддержка ЭТрН, заказов-заявок, ЭПЛ и экспедиторских документов подтверждается отдельно для конкретной версии решения.

Подобрать коннектор для обмена ЭПД

Расскажите об учетной системе, документах и предпочтительном способе обмена. Проверим применимость решения и состав работ.

Отвечаем в рабочее время: ПН–ВС, 09:00–18:00.

Связаться напрямую

Телефон
+7 950 951-2-159
E-mail
admin@roccos.ru
Время работы
ПН–ВС, 09:00–18:00

Для первичной оценки подготовьте название системы, пример входного файла, список документов, объем и требования к автоматической отправке.