.png)
ДЕРЖАВНА МИТНА СЛУЖБА УКРАЇНИ
НАКАЗ
| 22.12.2025 | N 1874 |
|---|
Про затвердження Специфiкацiї структури та
формату електронних повiдомлень для обмiну
даними мiж Держмитслужбою та портовими
операторами щодо суднозаходiв
Вiдповiдно до частини четвертої статтi 311 Митного кодексу України, пунктiв 29, 33 частини четвертої статтi 19 Закону України "Про центральнi органи виконавчої влади", пiдпункту 49 пункту 4, пiдпунктiв 5, 8 пункту 5, пункту 9, пiдпунктiв 25, 29 пункту 11 Положення про Державну митну службу України, затвердженого постановою Кабiнету Мiнiстрiв України вiд 06 березня 2019 року N 227, з урахуванням Порядку виконання митних формальностей на морському та рiчковому транспортi, затвердженого наказом Мiнiстерства фiнансiв України вiд 10 березня 2015 року N 308, зареєстрованим в Мiнiстерствi юстицiї України 30 квiтня 2015 року за N 486/26931, з метою обмiну даними мiж Держмитслужбою та портовими операторами щодо суднозаходiв, наказую:
1. Затвердити Специфiкацiю структури та формату електронних повiдомлень для обмiну даними мiж Держмитслужбою та портовими операторами щодо суднозаходiв, що додається.
2. Департаменту з питань цифрового розвитку, цифрових трансформацiй i цифровiзацiї (Алiна Брендак) забезпечити оприлюднення цього наказу на вебпорталi Держмитслужби.
3. Контроль за виконанням цього наказу покласти на заступника Голови з питань цифрового розвитку, цифрових трансформацiй i цифровiзацiї Олега Нiколайчука.
| В. о. Голови | Сергiй ЗВЯГIНЦЕВ |
| ЗАТВЕРДЖЕНО Наказ Державної митної служби України 22.12.2025 N 187 |
СПЕЦИФIКАЦIЯ
структури та формату електронних повiдомлень для
обмiну даними мiж Держмитслужбою та портовими
операторами щодо суднозаходiв
1. Загальнi питання
Iнформацiйний обмiн здiйснюється через SOAP веб-сервiс, розмiщений за адресою: https://sw2.customs.gov.ua/AskCustoms.asmx.
Назва вебметоду - AskCustoms1.
Запити (Request):
накладається квалiфiкований електронний пiдпис запитувача;
опцiонально шифруються (AES) сесiйним ключем, який пропонує iнiцiатор запиту i який зашифрований на технологiчний ключ Держмитслужби (RSA).
Вiдповiдi (Response):
пiдписуються технологiчним КЕП Держмитслужби (ДСТУ);
шифруються тим самим сесiйним ключем.
2. Формат запиту
2.1. Запит мiстить iнформацiю згiдно з таблицею 1.
Таблиця 1. Формат запиту
| N | Тег | Тип та розмiр | Обов'язковiсть | Примiтка |
|---|---|---|---|---|
| 1 | MessageBody | byte[] | Так | Тiло запиту |
| 2 | MessageType | string(128) | Так | Тип запиту: UA.SFS.REQ.65.1 (65 - код повiдомлення 1 - версiя) |
| 3 | MessageID | guid | Так | Iдентифiкатор запиту |
| 4 | Initiator | string(10) | Так | РНОКПП iнiцiатора запиту |
| 5 | SignCertificate | byte[] | Нi | Сертифiкат квалiфiкованої електронної печатки, якою пiдписано запит |
| 6 | Signature | byte[] | Так | Значення КЕП запиту |
| 7 | SessionKey | byte[] | Нi | Зашифрований сесiйний ключ шифрування |
| 8 | CryptKeyID | guid | Нi | Iдентифiкатор ключа Держмитслужби, на який зашифровано сесiйний ключ* |
*На сьогоднi використовується такий iдентифiкатор ключа Держмитслужби: 3faf09b8-5b24-4534-b382-9960dca30544.
Вiн вiдповiдає такому публiчному ключу:
<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. Тiло запиту формується таким чином:
1) формується XML, який мiстить данi вiдповiдно до структури та формату, визначених у додатку;
2) XML перетворюється на послiдовнiсть байт за допомогою кодування UTF-8;
3) XML стискується за допомогою алгоритму ZIP[1];
____________
[1] Дiя виконується, якщо це
визначено у форматi повiдомлення
4) отримана послiдовнiсть байт пiдписується квалiфiкованим електронним пiдписом iнiцiатора запиту. Значення КЕП передається в тезi Signature;
5) генерується випадковий сесiйний ключ для алгоритму AES (довжина 256). Значення вектору iнiцiалiзацiї: { 31, 207, 4, 165, 229, 33, 19, 98, 240, 133, 189, 64, 176, 145, 77, 51 }[2];
____________
[2] Дiя виконується, якщо
використовується шифрування
6) ключ шифрується за допомогою алгоритму RSA, отримане значення записується в тег SessionKey2;
7) стиснутий1 XML шифрується за допомогою алгоритму AES з використанням сесiйного ключа2; отримане значення записується в тег MessageBody.
3. Формат вiдповiдi
3.1. Вiдповiдь на запит мiстить iнформацiю згiдно з таблицею 2.
Таблиця 2. Формат вiдповiдi
| N | Тег | Тип та розмiр | Обов'язковiсть | Примiтка |
|---|---|---|---|---|
| 1 | MessageBody | byte[] | Нi | Тiло вiдповiдi. В разi помилки або якщо вiдповiдь не потрiбна - вiдсутнє |
| 2 | MessageType | string(128) | Так | Тип вiдповiдi: UA.SFS.RSP.65.1 (65 - код повiдомлення, 1 - версiя) |
| 3 | SignCertificate | byte[] | Нi | Сертифiкат ключа, яким пiдписано вiдповiдь. Тiльки якщо пiдпис не мiстить сертифiката. В разi помилки або якщо вiдповiдь не потрiбна - вiдсутнiй |
| 4 | Signature | byte[] | Нi | Значення КЕП вiдповiдi. В разi помилки або якщо вiдповiдь не потрiбна - вiдсутнiй |
| 5 | ErrorNumber | numeric(5) | Так | Код помилки. Якщо запит оброблено без помилки - 0 |
| 6 | ErrorMessage | string(2000) | Нi | Текст помилки - при її наявностi |
| 7 | MessageID | guid | Так | Iдентифiкатор запиту |
3.2. Тiло вiдповiдi формується таким чином:
1) формується XML, який мiстить данi вiдповiдно до структури та формату, визначених у додатку;
2) XML перетворюється на послiдовнiсть байт за допомогою кодування UTF-8;
3) XML стискується за допомогою алгоритму ZIP;
4) отримана послiдовнiсть байт пiдписуються технологiчним ключем Держмитслужби. Значення КЕП передається в тезi Signature[3];
____________
[3] Дiя виконується, якщо це
визначено у форматi повiдомлення
5) стиснутий[4] XML шифрується за допомогою алгоритму AES з використанням сесiйного ключа, запропонованого в запитi; отримане значення записується в тег MessageBody.
____________
[4] Дiя виконується, якщо
використовується шифрування
4. Формат повiдомлень (MessageBody)
4.1 Формат повiдомлення запиту (UA.SFS.REQ.65.1) щодо iнформацiї про суднозахiд.
4.1.1 Повiдомлення мiстить iнформацiю згiдно з таблицею 3. Повiдомлення не стискується за допомогою алгоритму ZIP.
Таблиця 3. Формат UA.SFS.REQ.65.1
| Тег | Опис | Примiтка | |||
|---|---|---|---|---|---|
| UA.SFS.REQ.65.1 | Iнформацiя про суднозахiд | Кореневий елемент XML документу | |||
| N | Тег | Опис | Тип/Розмiр | Карди- нальнiсть [5] |
Примiтка |
| 1 | cli_code | Код ЄДРПОУ вiдправника повiдомлення | varchar(8) | 1 | |
| 2 | port_call | Код суднозаходу | varchar(20) | 1 | |
| 3 | port | Код порту | varchar(5) | 1 | UN/LOCODE |
| 4 | ship_imo | IMO судна | varchar(7) | ? | Обов'язкове при вiдсутностi ship_eni |
| 5 | ship_eni | ENI судна | varchar(15) | ? | Обов'язкове при вiдсутностi ship_imo |
| 6 | ship_mmsi | MMSI судна | varchar(9) | ? | |
| 7 | ship_name | Назва судна | nvarchar(70) | 1 | |
| 8 | ship_flag_state | Держава прапора судна | char(2) | 1 | alpha-2 |
| 9 | ship_type | Тип судна | varchar(4) | ? | UN/Recommendation 28 |
| 10 | purpose | Мета заходу | varchar(3) | ? | UN/EDIFACT codes 8025 |
| 11 | ship_owner_code | Код судновласника | varchar(20) | ? | |
| 12 | ship_owner_cnt | Країна судновласника | char(2) | ? | alpha-2 |
| 13 | ship_owner_name | Назва судновласника | nvarchar(200) | ? | |
| 14 | voyage_no | Номер рейсу | varchar(20) | ? | |
| 15 | estimated_weight | Запланована вага (кг) | number(18) | ? | |
| 16 | crew_count | Кiлькiсть членiв екiпажу | number(4) | ? | |
| 17 | estimated_date_arrival | Орiєнтовна дата прибуття | date | 1 | yyyyMMdd yyyyMMddTHHmmSS |
| 18 | estimated_date_departure | Орiєнтовна дата вибуття | date | ? | yyyyMMdd yyyyMMddTHHmmSS |
| 19 | actual_date_arrival | Фактична дата прибуття | date | ? | yyyyMMdd yyyyMMddTHHmmSS |
| 20 | actual_date_departure | Фактична дата вибуття | date | ? | yyyyMMdd yyyyMMddTHHmmSS |
| 21 | cancellation_date | Дата скасування | date | ? | yyyyMMdd yyyyMMddTHHmmSS |
| 22 | test | Ознака тестового повiдомлення | number(1) | ? | 1 - тeстове повiдомлення |
____________
[5] Кардинальнiсть: ? = (0,1); 1 =
1; * = (0…n); + = (1…n)
5. Приклади повiдомлень
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>
| Директор Департаменту з питань цифрового розвитку, цифрових трансформацiй i цифровiзацiї | Алiна БРЕНДАК |
