Про затвердження Специфікації структури та формату електронних повідомлень для обміну даними між Держмитслужбою та портовими операторами щодо суднозаходів

Відповідно до частини четвертої статті 31¹ Митного кодексу України, пунктів 29, 33 частини четвертої статті 19 Закону України «Про центральні органи виконавчої влади», підпункту 49 пункту 4, підпунктів 5, 8 пункту 5, пункту 9, підпунктів 25, 29 пункту 11 Положення про Державну митну службу України, затвердженого постановою Кабінету Міністрів України від 06 березня 2019 року № 227, з урахуванням Порядку виконання митних формальностей на морському та річковому транспорті, затвердженого наказом Міністерства фінансів України від 10 березня 2015 року № 308, зареєстрованим в Міністерстві юстиції України 30 квітня 2015 року за № 486/26931, з метою обміну даними між Держмитслужбою та портовими операторами щодо суднозаходів,

НАКАЗУЮ:

1.   Затвердити Специфікацію структури та формату електронних повідомлень для обміну даними між Держмитслужбою та портовими операторами щодо суднозаходів, що додається.

2.   Департаменту з питань цифрового розвитку, цифрових трансформацій і цифровізації (Аліна Брендак) забезпечити оприлюднення цього наказу на вебпорталі Держмитслужби.

3.   Контроль за виконанням цього наказу покласти на заступника Голови з питань цифрового розвитку, цифрових трансформацій і цифровізації Олега Ніколайчука.

В. о. Голови                                                                           Сергій ЗВЯГІНЦЕВ

ЗАТВЕРДЖЕНО
Наказ Державної митної служби України 

СПЕЦИФІКАЦІЯ

структури та формату електронних повідомлень

для обміну даними між Держмитслужбою та портовими операторами

щодо суднозаходів

1.       Загальні питання

Інформаційний обмін здійснюється через SOAP веб-сервіс, розміщений за адресою: https://sw2.customs.gov.ua/AskCustoms.asmx.

Назва вебметоду – AskCustoms1.

Запити (Request):

накладається кваліфікований електронний підпис запитувача;

опціонально шифруються (AES) сесійним ключем, який пропонує ініціатор запиту і який зашифрований на технологічний ключ Держмитслужби (RSA).

Відповіді (Response):

підписуються технологічним КЕП Держмитслужби (ДСТУ);

шифруються тим самим сесійним ключем.

2.       Формат запиту

2.1.     Запит містить інформацію згідно з таблицею 1.

Таблиця 1. Формат запиту

*На сьогодні використовується такий ідентифікатор ключа Держмитслужби: 3faf09b8-5b24-4534-b382-9960dca30544.

Він відповідає такому публічному ключу:

<RSAKeyValue><Modulus>uJU/Ccqro+Tysmta1GQ2fZznfJ1bF+lgQmmNnCa1jsVbiA04bvWVyxSRCOBLLwdnpS+PESlg7c3/HqGcjjlhJ5zUPaM1yQF+qhRtaHT1uJDXiaP/ah0xpINQPfeGubst6mkXg3laae+TnbUQSnqV7+jaBV8/CE6+LsJY+0JFq4YmYsCsp8HCxqSbI/+87tY/Pesb2GfMdXx041VZB2DVQnJuUzQjWq+JxMjZSBbG2vSdTjWrIsFepZFOOYBQPTrqrC044V4VbaJVssaP9EO1I6ogI1gA6uzUMyVAEjCE0kkUpZv5wTjFOOkrn+RFovZofFQmxaCgFE6sNSwTd7MyWQ==</Modulus><Exponent>AQAB</Exponent></RSAKeyValue>.

2.2.     Тіло запиту формується таким чином:

1)      формується XML, який містить дані відповідно до структури та формату, визначених у додатку;

2)      XML перетворюється на послідовність байт за допомогою кодування UTF-8;

3)      XML стискується за допомогою алгоритму ZIP^[1];

4)      отримана послідовність байт підписується кваліфікованим електронним підписом ініціатора запиту. Значення КЕП передається в тезі Signature;

5)      генерується випадковий сесійний ключ для алгоритму AES (довжина 256). Значення вектору ініціалізації: { 31, 207, 4, 165, 229, 33, 19, 98, 240, 133, 189, 64, 176, 145, 77, 51 }[2];

6)      ключ шифрується за допомогою алгоритму RSA, отримане значення записується в тег SessionKey²;

7)      стиснутий¹ XML шифрується за допомогою алгоритму AES з використанням сесійного ключа²; отримане значення записується в тег MessageBody.

3.       Формат відповіді

3.1.     Відповідь на запит містить інформацію згідно з таблицею 2.

Таблиця 2. Формат відповіді

3.2.     Тіло відповіді формується таким чином:

1)           формується XML, який містить дані відповідно до структури та формату, визначених у додатку;

2)           XML перетворюється на послідовність байт за допомогою кодування UTF-8;

3)           XML стискується за допомогою алгоритму ZIP;

4)           отримана послідовність байт підписуються технологічним ключем Держмитслужби. Значення КЕП передається в тезі Signature[3];

5)           стиснутий[4] XML шифрується за допомогою алгоритму AES з використанням сесійного ключа, запропонованого в запиті; отримане значення записується в тег MessageBody.

4.       Формат повідомлень (MessageBody)

4.1        Формат повідомлення запиту (UA.SFS.REQ.65.1) щодо інформації про суднозахід.

4.1.1 Повідомлення містить інформацію згідно з таблицею 3. Повідомлення не стискується за допомогою алгоритму ZIP.

Таблиця 3. Формат UA.SFS.REQ.65.1

5.       Приклади повідомлень

5.1   UA.SFS.REQ.65.1

<?xml version="1.0" encoding="utf-8"?>

<UA.SFS.REQ.65.1>

  <cli_code>12345678</cli_code>

  <port_call>UAODS-2025-00123</port_call>

  <port>UAODS</port>

  <ship_imo>2323231</ship_imo>

  <ship_name>Тестовий</ship_name>

  <ship_flag_state>SK</ship_flag_state>

  <estimated_date_arrival>20251201</estimated_date_arrival>

</UA.SFS.REQ.65.1>

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

з питань цифрового розвитку,

цифрових трансформацій і цифровізації                                     Аліна БРЕНДАК