Інше (FTP, AS2, SOAP)

FTP/FTPS/FTP over SSL

Менеджер EDIN формує запит на технічну підтримку (для ввімкнення FTP, створення користувачів/GLN і т.і.). Після ввімкнення для користувача (за Логіном) доступу до FTP на пошту, закріплену за Логіном, автоматично надсилаються дані доступу до FTP сервера. Менеджер або спеціаліст технічної підтримки надає користувачу (Вам) опис та специфікації до бажаних документів (посилання на wiki і т.п.). Менеджер формує запит на відділ Інтеграції для консультації з налаштування та реалізації вивантаження документів (за потреби). Також менеджер може продати інтеграційний модуль і в такому випадку потрібна задача на налаштування модуля з обліковою системою клієнта. Отримавши доступ та виконавши налаштування Вашої облікової системи, Ви зможете вивантажувати документи в XML форматі в теку Outbox. Вхідні для Вас документи будуть надходити в теку Inbox. Ви також можете вивантажувати документи з конкретною назвою файлу.

Структура сервера:

Примітки щодо використання:

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

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

Увага, в іменах файлів для завантаження повинні використовуватися тільки цифри, латинські літери і символи «&», «_», «-» чи «.».

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

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

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

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

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

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

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

Платформа EDIN також підтримує FTPS з’єднання, для цього використовується порт: 990.

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

Підключення обміну через AS2

Менеджер EDIN формує запит на відділ Інтеграції для налаштування з Вами каналу зв’язку (попередньо Ви маєте має надати параметри з’єднання). Відділ Інтеграції сумісно з адміністраторами системи налаштовують з’єднання, каталоги, скрипти обробки. Менеджер формує запит на відділ Інтеграції для консультації з налаштування та реалізації вивантаження документів (за потреби). Після успішного налаштування каналу зв’язку, виконавши налаштування облікової системи, Ви зможете вивантажувати документи в XML форматі в теку Outbox. Вхідні для Вас документи будуть надходити в теку Inbox. Ви також можете вивантажувати документи з конкретною назвою файлу.

Конфігурація AS2
Таблиця 1 - pyAS2 configuration

AS2 рішення

pyAS2

Провайдер AS2

EDIN

Операційна система

CentOS

AS2 Identifier (AS2_ID)

Production: EDIN;

Test: EDIN_TEST
Таблиця 2 - Параметри передачі даних

Опис

Значення

Коментар
 

Передача даних в EDIN

  

URL for AS2 connection

https://as2-v2.edin.ua/as2/HttpReceiver

URL (Encoding set applied)

Port

80, 443

Required for firewall

Transport

https, http

http recommended

Basic HTTP authentication

No

  
 

Передача даних з EDIN

  

Transport

https, http

https port 443; http port 80 - recommended
Таблиця 3 - AS2 Сертифікування

Опис

Значення

Type of certificate

Сертифікат виданий центром сертифікації

Certificate validity period

RSA Encryption

Type of public key

2048 bit

Encryption algorithm

3DES

Notification method

Synchronous

Certification type

Signed detached encrypted

Algorithm used for the electronic signature

SHA1, SHA256

Compression of documents

No

Сертифікати використовуються при передачі повідомлень (даних) по AS2 каналам для їх шифрування та підписання, а також для підключення по протоколу https.

SOAP API

Даний розділ описує інтеграцію з платформою EDIN через SOAP API.

WSDL схема для роботи з FTPEX по SOAP: https://soap.edin.ua/soap/service.wsdl

SOAP API

Отримання списку доступних файлів (getList)

WSDL схема для роботи з FTPEX по SOAP: https://soap.edin.ua/soap/service.wsdl

Параметри, які потрібно передати: логін і MD5 пароля (дані, які були видані користувачу при підключенні до платформи електронного документообігу) (MD5 генератор http://www.danstools.com/md5-hash-generator/).

У відповідь отримуємо список імен файлів, які на даний момент доступні користувачеві.

Приклад відповіді:

<result>
           <errorCode>0</errorCode>
           <list>status_20150924144604_4679904.xml</list>
           <list>status_20150924144604_7259532.xml</list>
           <list>status_20150924144604_4784911.xml</list>
   ...
   ...
   <list>status_20151005123023_686803070.xml</list>
           <list>order_20151005132435_707890630.xml</list>
 </result>

Можливі помилки:

Повний запит і відповідь сервера по цьому методу можна завантажити за наступними посиланнями:

getList_request2.xml

getList_response2.xml

SOAP API

Отримання кількох документів (пошук) (getDocuments)

WSDL схема для роботи з FTPEX по SOAP: https://soap.edin.ua/soap/service.wsdl

Параметри, які потрібно передати: логін, MD5 пароля і конкретні імена файлів (імена файлів повертає getList)

У відповідь отримуємо код відповіді сервера (0 - успішна обробка), а також закодований в base64 zip архів із затребуваними файлами.

Приклад запиту:

<soap:getDocumentsRequest>
   <!--Optional:-->
   <user>
      <!--Optional:-->
      <login>login</login>
      <!--Optional:-->
      <pass>parol</pass>
   </user>
   <!--Zero or more repetitions:-->
   <fileName>hello.xml</fileName>
  <fileName>musician.xml</fileName>
</soap:getDocumentsRequest>

Приклад відповіді:

<result>
   <errorCode>0</errorCode>
 <content>UEsDBBQACAgIAD...AAAA</content>
</result>

Можливі помилки:

Повний запит і відповідь сервера по цьому методу можна завантажити за наступними посиланнями:

getDocumentsResponse2.xml

getDocumentsRequest2.xml

SOAP API

Отримання конкретного файлу (getDoc)

WSDL схема для роботи з FTPEX по SOAP: https://soap.edin.ua/soap/service.wsdl

Параметри, які потрібно передати: логін, MD5 пароля і конкретне ім’я файлу (імена файлів повертає getList)

У відповідь отримуємо конкретний файл у вигляді BASE-64 рядка.

Приклад відповіді:

<result>
          <errorCode>0</errorCode>
          <content>PFN0YXR1cz4KI...4KPC9TdGF0dXM+</content>
</result>

Вміст поля <content> перекладається в XML подання шляхом розшифровки BASE-64 (в результаті виходить тіло XML файлу).

Можливі помилки:

Повний запит і відповідь сервера по цьому методу можна завантажити за наступними посиланнями:

getDoc_request2.xml

getDoc_response2.xml

SOAP API

Передача конкретного файлу (sendDoc)

WSDL схема для роботи з FTPEX по SOAP: https://soap.edin.ua/soap/service.wsdl

Параметри, які потрібно передати: логін, MD5 пароля, конкретне ім’я файлу і тіло файлу в вигляді BASE-64 рядка.

У відповідь отримуємо код відповіді сервера (0 - успішна передача).

Приклад відповіді:

<result>
           <errorCode>0</errorCode>
</result>

Можливі помилки:

Повний запит і відповідь сервера по цьому методу можна завантажити за наступними посиланнями:

sendDoc_request2.xml

sendDoc_response2.xml

SOAP API

Архівування документа (видалення конкретного файлу з сервера) (archiveDoc)

WSDL схема для роботи з FTPEX по SOAP: https://soap.edin.ua/soap/service.wsdl

Параметри, які потрібно передати: логін, MD5 пароля і конкретне ім’я файлу (імена файлів повертає getList)

У відповідь отримуємо код відповіді сервера (0 - успішна обробка).

Приклад відповіді:

<result>
           <errorCode>0</errorCode>
</result>

Можливі помилки:

Повний запит і відповідь сервера по цьому методу можна завантажити за наступними посиланнями:

archiveDoc_request2.xml

archiveDoc_response2.xml

SOAP API

Масове архівування документів (видалення файлів з сервера) (archiveDocuments)

WSDL схема для роботи з FTPEX по SOAP: https://soap.edin.ua/soap/service.wsdl

Параметри, які потрібно передати: логін, MD5 пароля і конкретне ім’я файлу (імена файлів повертає getList)

У відповідь отримуємо код відповіді сервера (0 - успішна обробка).

Приклад запиту:

<soap:archiveDocumentsRequest>
   <!--Optional:-->
   <user>
      <!--Optional:-->
      <login>login</login>
      <!--Optional:-->
      <pass>parol</pass>
   </user>
   <!--Zero or more repetitions:-->
       <fileName>hello.xml</fileName>
     <fileName>musician.xml</fileName>
</soap:archiveDocumentsRequest>

Приклад відповіді:

<result>
           <errorCode>0</errorCode>
</result>

Можливі помилки:

Повний запит і відповідь сервера по цьому методу можна завантажити за наступними посиланнями:

archiveDocumentsRequest2.xml

archiveDocumentsResponse2.xml