Skip to main content

FTP/FTPS/FTP over SSL

Менеджер EDIN формує запит до технічної підтримки на увімкнення FTP, створення користувачів, GLN тощо. Після активації доступу, на електронну адресу, прив’язану до логіну користувача, автоматично надсилаються реквізити для підключення до FTP-сервера.

Менеджер або спеціаліст технічної підтримки надає користувачу опис і специфікації до потрібних документів (наприклад, посилання на документацію на wiki).

За потреби менеджер формує запит до відділу Інтеграції для консультації щодо налаштувань або реалізації вивантаження документів. Якщо клієнт придбав інтеграційний модуль, додатково створюється завдання на налаштування модуля з обліковою системою клієнта.

Після отримання доступу та налаштування облікової системи, користувач може:

  • вивантажувати документи у форматі XML до каталогу /outbox/;

  • отримувати вхідні документи з каталогу /inbox/;

  • за необхідності — вивантажувати документи з конкретною назвою файлу.

Структура сервера:
  • inbox/ - каталог з вхідними документами

  • cinbox/ - каталог для вхідних документів зі спеціальними налаштуваннями

  • outbox/ - каталог для вихідних документів

  • coutbox/ - каталог для вихідних документів зі спеціальними налаштуваннями

  • error/ - каталог для документів з помилками, які не були оброблені системою

  • reports/ - каталог для спеціальних вихідних документів, сформованих для ДФС

  • transit/ - службовий каталог, який використовується системою для проміжного зберігання або обробки

Особливості використання:

Якщо ви використовуєте формат обміну даними EDIN, то робочими папками є /outbox/ та /inbox/. Якщо ж використовується інший, попередньо погоджений формат обміну, то слід використовувати папки /coutbox/ та /cinbox/.

За замовчуванням файли, які ви відправляєте, з’являються у веб-інтерфейсі системи у вкладці «Чернетки», однак вони не відправляються автоматично до роздрібної мережі.
Для налаштування автоматичної відправки необхідно надіслати письмовий запит на адресу: integration@edin.ua.

В іменах файлів, які завантажуються, дозволено використовувати лише цифри, латинські літери, а також символи: «&», «_», «-» та «.».

Новий формат імені файлів Комерційних документів (COMDOC) на FTP приходить у 2-х варіаціях:

  1. Якщо документ відправлено з web інтерфейсу, наприклад:

comdoc_20210113093935_6d90825f-6743-490f-80f6-9e63565566ba_007.p7s, де:

  • comdoc - тип документа;

  • 20210113093935 - дата та час обробки файлу платформою EDI Network;

  • 6d90825f-6743-490f-80f6-9e63565566ba - doc id документу на платформі EDI Network;

  • 007 - підтип Комерційного документа (COMDOC);

  • p7s - розширення файлу.

  1. Якщо документ відправлено інтегровано (з облікової системи), наприклад:

comdoc_20210113093935_6d90825f-6743-490f-80f6-9e63565566ba_450966903100000155349_007.p7s, де:

  • comdoc - тип документа;

  • 20210113093935 - дата та час обробки файлу платформою EDI Network;

  • 6d90825f-6743-490f-80f6-9e63565566ba - doc id документу на платформі EDI Network;

  • 450966903100000155349 - номера документа без спеціальних символів;

  • 007 - підтип Комерційного документа (COMDOC).


Новий формат імені файлів EDI документів:

desadv_20201229162503_16560359-a263-4f36-99e5-2e3f7ae1aa2e.xml, де:

  • desadv - тип документа;

  • 20201229162503 - дата та час обробки файлу платформою EDI Network;

  • 16560359-a263-4f36-99e5-2e3f7ae1aa2e - doc id документу на платформі EDI Network;

  • xml - розширення файлу.


Платформа EDIN також підтримує FTPS з’єднання, використовуючи такий тип з’єднання, порт буде: 990

FTPS (File Transfer Protocol + SSL, або FTP / SSL) - розширення широко використовуваного протоколу передачі даних FTP, яке додає підтримку для криптографічних протоколів рівнів транспортної безпеки та захищених сокетів.