.png)
ДЕРЖАВНА МИТНА СЛУЖБА УКРАЇНИ
НАКАЗ
| 05.06.2025 | N 500 |
|---|
Про затвердження Специфiкацiї структури та
формату електронних повiдомлень для обмiну
даними мiж пiдприємствами та Держмитслужбою щодо
митних декларацiй, поданих таким пiдприємством
або вiд iменi такого пiдприємства та оформлених
митними органами
Вiдповiдно до частини четвертої статтi 311 Митного кодексу України, абзацiв другого та третього частини четвертої статтi 452, пунктiв 29, 33 частини четвертої статтi 19 Закону України "Про центральнi органи виконавчої влади", пiдпункту 49 пункту 4, пiдпунктiв 5, 8 пункту 5, пунктiв 8, 9, пiдпунктiв 25, 29 пункту 11 Положення про Державну митну службу України, затвердженого постановою Кабiнету Мiнiстрiв України вiд 06 березня 2019 року N 227, з метою гармонiзацiї вiдомостей, що надаються Державною митною службою України пiдприємствам для обмiну iнформацiєю щодо митних декларацiй, поданих таким пiдприємством або вiд iменi такого пiдприємства та оформлених митними органами, наказую:
1. Затвердити Специфiкацiю структури та формату електронних повiдомлень для обмiну даними мiж пiдприємствами та Держмитслужбою щодо митних декларацiй, поданих таким пiдприємством або вiд iменi такого пiдприємства та оформлених митними органами, що додається.
2. Департаменту з питань цифрового розвитку, цифрових трансформацiй i цифровiзацiї (Iгор Смiрнов) забезпечити оприлюднення цього наказу на вебпорталi Держмитслужби.
3. Контроль за виконанням цього наказу покласти на заступника Голови з питань цифрового розвитку, цифрових трансформацiй i цифровiзацiї Олега Нiколайчука.
| В. о. Голови | Сергiй ЗВЯГIНЦЕВ |
| ЗАТВЕРДЖЕНО Наказ Державної митної служби України 05 червня 2025 року N 500 |
Специфiкацiя структури та формату електронних повiдомлень для обмiну даними мiж пiдприємствами та Держмитслужбою щодо митних декларацiй, поданих таким пiдприємством або вiд iменi такого пiдприємства та оформлених митними органами
1. Загальнi питання
Iнформацiйний обмiн може здiйснюватися через:
1) SOAP вебсервiс, розмiщений за адресою: https://sw2.customs.gov.ua/AskCustoms.asmx. Назва вебметоду - AskCustoms1.
Специфiкацiю набору гармонiзованих вiдомостей для надання через єдиний державний iнформацiйний веб-портал "Єдине вiкно для мiжнародної торгiвлi", затверджену наказом Мiнiстерства фiнансiв України вiд 30.07.2019 N 327;
2) REST API вебсервiс, розмiщений за адресою: https://sw4.customs.gov.ua/AskCustomsR1.
Тип HTTP-запиту - POST;
3) REST API with token вебсервiс, розмiщений за адресою: https://sw4.customs.gov.ua/AskCustomsR2
Тип HTTP-запиту - POST.
2. Формат запиту (SOAP)
2.1. Запит мiстить iнформацiю згiдно з таблицею 1.
Таблиця 1. Формат запиту
| N | Тег | Тип та розмiр | Обов'язковiсть | Примiтка |
|---|---|---|---|---|
| 1 | MessageBody | byte[] | Так | Тiло запиту |
| 2 | MessageType | string(128) | Так | Тип запиту: UA.SFS.REQ.60.1 - запит перелiку оформлених митних декларацiй (МД) UA.SFS.REQ.61.1 - запит на отримання МД в актуальному станi |
| 3 | MessageID | guid | Так | Iдентифiкатор запиту |
| 4 | Initiator | string(10) | Так | РНОКПП запитувача |
| 5 | SignCertificate | byte[] | Нi | Сертифiкат квалiфiкованої електронної печатки, якою пiдписано запит |
| 6 | Signature | byte[] | Так | Значення КЕП запиту |
| 7 | SessionKey | byte[] | Так | Зашифрований сесiйний ключ шифрування |
| 8 | CryptKeyID | guid | Так | 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дно до структури та формату, визначених нижче у вiдповiдних таблицях;
2) XML перетворюється на послiдовнiсть байт за допомогою кодування utf8;
3) XML стискується за допомогою алгоритму ZIP1;
____________
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 (SOAP)
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.60.1 - вiдповiдь на запит UA.SFS.REQ.60.1; UA.SFS.RSP.61.1 - вiдповiдь на запит UA.SFS.REQ.61.1 |
| 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дно до структури та формату, визначених нижче у вiдповiдних таблицях;
2) XML перетворюється на послiдовнiсть байт за допомогою кодування utf8;
3) XML стискується за допомогою алгоритму ZIP3;
____________
3 Дiя виконується, якщо це
визначено у форматi повiдомлення.
4) отримана послiдовнiсть байт пiдписуються технологiчним ключем Держмитслужби. Значення КЕП передається в тезi Signature;
5) стиснутий3 XML шифрується за допомогою алгоритму AES з використанням сесiйного ключа, запропонованого в запитi4; отримане значення записується в тег MessageBody.
____________
4 Дiя виконується, якщо
використовується шифрування.
4. Формат запиту (REST API)
4.1. Запит мiстить iнформацiю згiдно з таблицею 3.
Таблиця 3. Формат запиту
| N | Тег | Тип та розмiр | Обов'язковiсть | Примiтка |
|---|---|---|---|---|
| 1 | MessageType | string | Так | Тип запиту: UA.SFS.REQ.60.1 - запит перелiку оформлених митних декларацiй (МД) UA.SFS.REQ.61.1 - запит на отримання МД в актуальному станi |
| 2 | MessageBody | string | Так | Тiло запиту |
| 3 | Signature | string | Так | Значення КЕП запиту |
| 4 | SessionKey | string | Hi | Зашифрований сесiйний ключ шифрування та iнiцiалiзуючий вектор |
5. Формат вiдповiдi (REST API)
5.1. Вiдповiдь на запит мiстить iнформацiю згiдно з таблицею 4.
Таблиця 4. Формат вiдповiдi
| N | Тег | Тип та розмiр | Обов'язковiсть | Примiтка |
|---|---|---|---|---|
| 1 | MessageType | string | Нi | Тип вiдповiдi: UA.SFS.RSP.60.1 - вiдповiдь на запит UA.SFS.REQ.60.1; UA.SFS.RSP.61.1 - вiдповiдь на запит UA.SFS.REQ.61.1 |
| 2 | MessageBody | string | Так | Тiло запиту |
| 3 | Signature | string | Так | Значення КЕП вiдповiдi. У разi помилки або якщо вiдповiдь не потрiбна - вiдсутнiй |
6. Формат запиту (REST API with token)
6.1. Запит мiстить iнформацiю згiдно з таблицею 5.
Таблиця 5. Формат запиту
| N | Тег | Тип та розмiр | Обов'язковiсть | Примiтка |
|---|---|---|---|---|
| 1 | MessageType | string | Так | Тип запиту: UA.SFS.REQ.60.1 - запит перелiку оформлених митних декларацiй (МД) UA.SFS.REQ.61.1 - запит на отримання МД в актуальному станi |
| 2 | MessageBody | string | Так | Тiло запиту |
| 3 | Token | string | Так | Токен можна отримати в особистому кабiнетi в режимi Бiзнесу Моя акредитацiя |
7. Формат вiдповiдi (REST API with token)
7.1. Вiдповiдь на запит мiстить iнформацiю згiдно з таблицею 6.
Таблиця 6. Формат вiдповiдi
| N | Тег | Тип та розмiр | Обов'язковiсть | Примiтка |
|---|---|---|---|---|
| 1 | MessageType | string | Нi | Тип вiдповiдi: UA.SFS.RSP.60.1 - вiдповiдь на запит UA.SFS.REQ.60.1; UA.SFS.RSP.61.1 - вiдповiдь на запит UA.SFS.REQ.61.1 |
| 2 | MessageBody | string | Так | Тiло запиту |
8. Формат повiдомлень (MessageBody)
8.1. Формат повiдомлення запиту перелiку оформлених митних декларацiй (UA.SFS.REQ.60.1).
8.1.1. Повiдомлення мiстить iнформацiю згiдно з таблицею 7.
Таблиця 7. Формат запиту UA.SFS.REQ.60.1
| Тег | Опис | Примiтка | |||
|---|---|---|---|---|---|
| UA.SFS.REQ.60.1 | Запит перелiку оформлених митних декларацiй (МД) | Кореневий елемент XML документа | |||
| N | Тег | Опис | Тип/Розмiр | Кардинальнiсть5 | Примiтка |
| 1 | creation_date | Дата та час фактичного формування запиту | datetime | 1 | формат YYYYMMDDTHHMISS (символ "Т" - роздiльник) |
| 2 | cli_code | Код ЄДРПОУ/ДРФО | varchar(10) | 1 | |
| 3 | MRN | Унiкальний номер МД | varchar(18) | ? | Зазначається MRN або його частина Тiльки для МД, оформлених пiсля 01.10.2022 |
| 3 | date_begin | Початок дiапазону запиту | datetime | 1 | формат YYYYMMDDTHHMISS (символ "Т" - роздiльник) |
| 4 | date_end | Кiнець дiапазону запиту | datetime | 1 | формат YYYYMMDDTHHMISS (символ "Т" - роздiльник) |
| 5 | date_type | Тип дiапазону запиту | tinyint | 1 | 1 - Дата прийняття 2 - Дата модифiкацiї |
| 7 | status | Статус МД | char(l) | ? | R - оформлена; N - анульована; F - вiдкликана або вiдмовлена. Якщо не вказано пошук по здiйснюється по статусу R |
| 8 | ccd_01_01 | Лiтерний код напрямку перемiщення | varchar(3) | ? | Згiдно з Класифiкатором типiв декларацiй: ЕК - Вивезення; IМ - Ввезення; ТР - Транзит. Якщо не вказано пошук по всiх |
| 9 | ccd_01_02 | Код митного режиму | numeric(2,0) | ? | Згiдно з Класифiкатором митних режимiв |
| 10 | ccd_01_03 | Лiтерний код типу декларацiї | varchar(2) | ? | Згiдно з Класифiкатором типiв декларацiй |
| 11 | ccd_07_01 | Код мiсця митного оформлення | varchar(9) | ? | Згiдно з Класифiкатором Державної митної служби України, її територiальних органiв та їх структурних пiдроздiлiв |
| 12 | ccd_25_01 | Вид транспорту на кордонi | varchar(80) | ? | Згiдно з Класифiкатором видiв транспорту. Можуть зазначатися декiлька двосимвольних кодiв через кому (приклад - 30,31) Якщо не вказано пошук по всiх |
| 13 | ccd_26_01 | Вид транспорту в межах країни | varchar(80) | ? | Згiдно з Класифiкатором видiв транспорту. Можуть зазначатися декiлька двосимвольних кодiв через кому (приклад - 30,31) Якщо не вказано пошук по всiх |
____________
5 Кардинальнiсть: ? = (0,1); 1 = 1;
* = (0...n); + = (1...n).
8.2. Формат повiдомлення вiдповiдi на запит UA.SFS.REQ.60.1 (UA.SFS.RSP.60.1).
8.2.1. Вiдповiдь мiстить iнформацiю згiдно з таблицею 8.
Таблиця 8. Формат вiдповiдi UA.SFS.RSP.60.1
| Тег | Опис | Примiтка | |||
|---|---|---|---|---|---|
| UA.SFS.RSP.60.1 | Вiдомостi щодо результату опрацювання запиту перелiку оформлених МД | Кореневий елемент XML документа | |||
| Тег | Опис | Примiтка | |||
| md | Iнформацiя по митнiй декларацiї (МД) | * | |||
| N | Тег | Опис | Тип/Розмiр | Кардинальнiсть1 | Примiтка |
| 1 | guid | Глобальний iдентифiкатор МД | guid | 1 | |
| 2 | ccd_registered | Дата та час оформлення МД | datetime | ? | формат YYYYMMDDTHHMISS (символ "Т" - роздiльник) |
| 3 | MRN | Унiкальний номер МД | varchar(18) | 1 | Тiльки для МД, оформлених пiсля 01.10.2022 |
| 4 | ccd_07_01 | Номер МД (код митного органу) | varchar(9) | 1 | |
| 5 | ccd_07_02 | Номер МД (рiк) | numeric(4,0) | 1 | |
| 6 | ccd_07_03 | Номер МД (номер за порядком) | numeric(6,0) | 1 | |
| 7 | ccd_status | Статус МД | char(l) | 1 | |
| 8 | md_type | Тип МД | varchar(8) | 1 | |
| 11 | ccd_submitted | Дата прийняття МД до митного оформлення | datetime | 1 | формат YYYYMMDDTHHMISS (символ "Т" - роздiльник) |
| 12 | ccd_modified | Дата останнього змiнення МД | datetime | ? | формат YYYYMMDDTHHMISS (символ "Т" - роздiльник) Тiльки для МД зi статусами N - анульована або F- вiдкликана) |
| 13 | ccd_cancelled | Дата та час анулювання МД | datetime | ? | формат YYYYMMDDTHHMISS (символ "Т" - роздiльник) Тiльки для МД зi статусами N - анульована або F-вiдкликана) |
| 14* | trn_all | Транспортний засiб | varchar(100) | ? | |
____________
* тiльки якщо запит повертає до 100
записiв.
8.3. Формат повiдомлення запиту на отримання МД в актуальному станi (UA.SFS.REQ.61.1).
8.3.1. Повiдомлення мiстить iнформацiю згiдно з таблицею 9.
Таблиця 9. Формат запиту UA.SFS.REQ.61.1
| Тег | Опис | Примiтка | |||
|---|---|---|---|---|---|
| UA.SFS.REQ.61.1 | Запит на отримання МД в актуальному станi | Кореневий елемент XML документа | |||
| N | Тег | Опис | Тип/Розмiр | Кардинальнiсть1 | Примiтка |
| 1 | creation_date | Дата та час фактичного формування запиту | datetime | 1 | формат YYYYMMDDTHHMISS (символ "Т" - роздiльник) |
| 2 | cl_code | Код ЄДРПОУ/ДРФО | numeric(10,0) | 1 | |
| 3* | guid | Глобальний iдентифiкатор МД | guid | ? | |
| 4* | MRN | Унiкальний номер МД | varchar(18) | ? | Тiльки для МД, оформлених пiсля 01.10.2022 |
____________
* зазначається або Глобальний
iдентифiкатор МД (guid) або Унiкальний номер МД (MRN).
8.4. Формат повiдомлення вiдповiдi на запит UA.SFS.REQ.61.1 (UA.SFS.RSP.61.1).
8.4.1. Вiдповiдь мiстить iнформацiю згiдно iз Специфiкацiєю форматiв електронних повiдомлень автоматизованої системи митного оформлення (наказ Держмитслужби вiд 01.03.2013 N 61).
9. Приклади повiдомлень
9.1. UA.SFS.REQ.60.1 (запит SOAP)
<?xml version="1.0" encoding="utf8"?>
<UA.SFS.REQ.60.1>
<creation_date>20250529T100000</creation_date>
<cl_code>12345678</cl_code>
<MRN>25UA120000000123U7</MRN>
<date_begin>20250501T000000</date_begin>
<date_end>20250529T235959</date_end>
<date_type>1</date_type>
<status>R</status>
<ccd_01_01>ЕК</ccd_01_01>
<ccd_01_02>10</ccd_01_02>
<ccd_01_03>00</ccd_01_03>
<ccd_07_01>UA500001</ccd_07_01>
<ccd_25_01>30,31</ccd_25_01>
<ccd_26_01>30</ccd_26_01>
</UA.SFS.REQ.60.1>
9.2. UA.SFS.REQ.60.1 (запит REST API)
{
"UA.SFS.REQ.60.1":{
"creation_date": "20250529T100000",
"cl_code": "12345678",
"MRN": "25UA120000000123U7",
"date_begin": "20250501T000000",
"date_end": "20250529T235959",
"date_type": 1,
"status": "R",
"ccd_01_01": "ЕК",
"ccd_01_02": "10",
"ccd_01_03": "00",
"ccd_07_01": "UA500001",
"ccd_25_01": "30,31",
"ccd_26_01": "30"
}
}
9.3. UA.SFS.RSP.60.1 (вiдповiдь - SOAP)
<?xml version="1.0" encoding="utf8"?>
<UA.SFS.RSP.60.1>
<md>
<guid>550e8400-e29b-41d4-a716-446655440000</guid>
<ccd_registered>20250529T100000</ccd_registered>
<MRN>25UA120000012365U7</MRN>
<ccd_07_01>UA500001</ccd_07_01>
<ccd_07 02>2025</ccd_07_02>
<ccd_07_03>123456</ccd_07_03>
<ccd_status>R</ccd_status>
<md_type>ЕК1000</md_type>
<ccd_submitted>20250529T090000</ccd_submitted>
<ccd_modified>20250529T110000</ccd_modified>
<ccd_cancelled></ccd_cancelled>
<trn_all>AA1234BB</trn_all>
</md>
</UA.SFS.RSP.60.1>"
9.4. UA.SFS.RSP.60.1 (вiдповiдь - REST API)
{
"UA.SFS.RSP.60.1": {
"md": {
"guid": "550e8400-e29b-41d4-a716-446655440000",
"ccd_registered": "20250529T100000",
"MRN": "25UA120000012365U7",
"ccd_07_01": "UA500001",
"ccd_07_02": 2025,
"ccd_07_03": 123456,
"ccd_status": "R",
"md_type": "ЕК1000",
"ccd_submitted": "20250529T090000",
"ccd_modified": "20250529T110000",
"ccd_cancelled": "",
"trn_all": "AA1234BB"
}
}
}
9.5. UA.SFS.REQ.61.1 (запит - SOAP)
<?xml version="1.0" encoding="utf8"?>
<UA.SFS.REQ.61.1>
<creation_date>20250529T113000</creation_date>
<cl_code>1234567890</cl_code>
<guid>550e8400-e29b-41d4-a716-446655440000</guid>
<MRN>25UA120000012365U7</MRN>
</UA.SFS.REQ.61.1>
9.6. UA.SFS.REQ.61.1 (запит - REST API)
{
"UA.SFS.REQ.61.1": {
"creation_date": "20250529T113000",
"cl_code": "1234567890",
"guid": "550e8400-e29b-41d4-a716-446655440000",
"MRN": "25UA120000012365U7"
}
}
9.7. UA.SFS.RSP.61.1 (вiдповiдь - SOAP)
Специфiкацiя форматiв електронних повiдомлень автоматизованої системи митного оформлення (наказ Держмитслужби вiд 01.03.2013 N 61).
9.8. UA.SFS.RSP.61.1 (вiдповiдь - REST API)
Специфiкацiя форматiв електронних повiдомлень автоматизованої системи митного оформлення (наказ Держмитслужби вiд 01.03.2013 N 61).
10. Довiдники
Таблиця 10. Довiдники
| N | Назва довiдника | Посилання |
| 1 | Класифiкатор типiв декларацiй | https://zakon.rada.gov.ua/rada/show/v1011201-12#n34 |
| 2 | Класифiкатор митних режимiв | https://zakon.rada.gov.ua/rada/show/v1011201-12#n38 |
| 3 | Класифiкатор Державної митної служби України, її територiальних органiв та їх структурних пiдроздiлiв | https://zakon.rada.gov.ua/rada/show/v0495201-19#n104 |
| 4 | Класифiкатором видiв транспорту | https://zakon.rada.gov.ua/rada/show/v1011201-12#n58 |
