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

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

 

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

Інформаційний обмін може здійснюватися через:

1) SOAP вебсервіс, розміщений за адресою: https://sw2.customs.gov.ua/AskCustoms.asmx. Назва вебметоду – AskCustoms1.

Специфікацію набору гармонізованих відомостей для надання через єдиний державний інформаційний веб-портал «Єдине вікно для міжнародної торгівлі», затверджену наказом Міністерства фінансів України від 30.07.2019 № 327;

 

2) REST API вебсервіс, розміщений за адресою: https://sw4.customs.gov.ua/AskCustomsR1.

Тип HTTP-запиту – POST;

 

3) REST API with token вебсервіс, розміщений за адресою: https://sw4.customs.gov.ua/AskCustomsR2

Тип HTTP-запиту – POST.

 

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

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

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

 

№	Тег	Тип та розмір	Обов’язковість	Примітка
1	MessageBody	byte[]	Так	Тіло запиту
2	MessageType	string(128)	Так	Тип запиту: UA.SFS.REQ.60.1 – запит переліку оформлених митних декларацій (МД) UA.SFS.REQ.61.1 – запит на отримання МД в актуальному стані
3	MessageID	guid	Так	Ідентифікатор запиту
4	Initiator	string(10)	Так	РНОКПП запитувача
5	SignCertificate	byte[]	Ні	Сертифікат кваліфікованої електронної печатки, якою підписано запит
6	Signature	byte[]	Так	Значення КЕП запиту
7	SessionKey	byte[]	Так	Зашифрований сесійний ключ шифрування
8	CryptKeyID	guid	Так	Ідентифікатор ключа Держмитслужби, на який зашифровано повідомлення*

 

*На сьогодні використовується такий ідентифікатор ключа Держмитслужби: 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 перетворюється на послідовність байт за допомогою кодування Windows-1251;

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.       Формат відповіді (SOAP)

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

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

 

№	Тег	Тип та розмір	Обов’язковість	Примітка
1	MessageBody	byte[]	Ні	Тіло відповіді. У разі помилки або якщо відповідь не потрібна – відсутнє
2	MessageType	string(128)	Так	Тип відповіді: UA.SFS.RSP.60.1 – відповідь на запит UA.SFS.REQ.60.1; UA.SFS.RSP.61.1 – відповідь на запит UA.SFS.REQ.61.1
3	SignCertificate	byte[]	Ні	Сертифікат ключа, яким підписано відповідь. Тільки якщо підпис не містить сертифіката. У разі помилки або якщо відповідь не потрібна – відсутній
4	Signature	byte[]	Ні	Значення КЕП відповіді. У разі помилки або якщо відповідь не потрібна – відсутній
5	ErrorNumber	numeric(5)	Так	Код помилки. Якщо запит оброблено без помилки – 0
6	ErrorMessage	string(2000)	Ні	Текст помилки – при її наявності
7	MessageID	guid	Так	Ідентифікатор запиту

 

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

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

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

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

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

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

 

4.       Формат запиту (REST API)

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

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

 

№	Тег	Тип та розмір	Обов’язковість	Примітка
1	MessageType	string	Так	Тип запиту: UA.SFS.REQ.60.1 – запит переліку оформлених митних декларацій (МД) UA.SFS.REQ.61.1 – запит на отримання МД в актуальному стані
2	MessageBody	string	Так	Тіло запиту
3	Signature	string	Так	Значення КЕП запиту
4	SessionKey	string	Hi	Зашифрований сесійний ключ шифрування та ініціалізуючий вектор

 

5.       Формат відповіді (REST API)

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

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

 

№	Тег	Тип та розмір	Обов’язковість	Примітка
1	MessageType	string	Ні	Тип відповіді: UA.SFS.RSP.60.1 – відповідь на запит UA.SFS.REQ.60.1; UA.SFS.RSP.61.1 – відповідь на запит UA.SFS.REQ.61.1
2	MessageBody	string	Так	Тіло запиту
3	Signature	string	Так	Значення КЕП відповіді. У разі помилки або якщо відповідь не потрібна – відсутній

 

6.       Формат запиту (REST API with token)

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

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

 

№	Тег	Тип та розмір	Обов’язковість	Примітка
1	MessageType	string	Так	Тип запиту: UA.SFS.REQ.60.1 – запит переліку оформлених митних декларацій (МД) UA.SFS.REQ.61.1 – запит на отримання МД в актуальному стані
2	MessageBody	string	Так	Тіло запиту
3	Token	string	Так	Токен можна отримати в особистому кабінеті в режимі Бізнесу Моя акредитація

 

7.       Формат відповіді (REST API with token)

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

 

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

 

№	Тег	Тип та розмір	Обов’язковість	Примітка
1	MessageType	string	Ні	Тип відповіді: UA.SFS.RSP.60.1 – відповідь на запит UA.SFS.REQ.60.1; UA.SFS.RSP.61.1 – відповідь на запит UA.SFS.REQ.61.1
2	MessageBody	string	Так	Тіло запиту

 

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

8.1. Формат повідомлення запиту переліку оформлених митних декларацій (UA.SFS.REQ.60.1).

8.1.1. Повідомлення містить інформацію згідно з таблицею 7.

Таблиця 7. Формат запиту UA.SFS.REQ.60.1

 

Тег		Опис				Примітка
UA.SFS.REQ.60.1		Запит переліку оформлених митних декларацій (МД)				Кореневий елемент XML документа
№	Тег	Опис	Тип/Розмір	Кардина-льність[5]	Примітка
1	creation_date	Дата та час фактичного формування запиту	datetime	1	формат YYYYMMDDTHHMISS (символ «Т» – роздільник)
2	cli_code	Код ЄДРПОУ/ДРФО	varchar(10)	1
3	MRN	Унікальний номер МД	varchar(18)	?	Зазначається MRN або його частина Тільки для МД, оформлених після 01.10.2022
3	date_begin	Початок діапазону запиту	datetime	1	формат YYYYMMDDTHHMISS (символ «Т» – роздільник)
4	date_end	Кінець діапазону запиту	datetime	1	формат YYYYMMDDTHHMISS (символ «Т» – роздільник)
5	date_type	Тип діапазону запиту	tinyint	1	1 – Дата прийняття 2 – Дата модифікації
7	status	Статус МД	char(l)	?	R – оформлена; N – анульована; F – відкликана або відмовлена. Якщо не вказано пошук по здійснюється по статусу R
8	ccd_01_01	Літерний код напрямку переміщення	varchar(3)	?	Згідно з Класифікатором типів декларацій: ЕК – Вивезення; ІМ – Ввезення; ТР – Транзит. Якщо не вказано пошук по всіх
9	ccd_01_02	Код митного режиму	numeric(2,0)	?	Згідно з Класифікатором митних режимів
10	ccd_01_03	Літерний код типу декларації	varchar(2)	?	Згідно з Класифікатором типів декларацій
11	ccd_07_01	Код місця митного оформлення	varchar(9)	?	Згідно з Класифікатором Державної митної служби України, її територіальних органів та їх структурних підрозділів
12	ccd_25_01	Вид транспорту на кордоні	varchar(80)	?	Згідно з Класифікатором видів транспорту. Можуть зазначатися декілька двосимвольних кодів  через кому (приклад – 30,31) Якщо не вказано пошук по всіх
13	ccd_26_01	Вид транспорту в межах країни	varchar(80)	?	Згідно з Класифікатором видів транспорту. Можуть зазначатися декілька двосимвольних кодів  через кому (приклад – 30,31) Якщо не вказано пошук по всіх

 

8.2. Формат повідомлення відповіді на запит UA.SFS.REQ.60.1 (UA.SFS.RSP.60.1).

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

Таблиця 8. Формат відповіді UA.SFS.RSP.60.1

 

Тег		Опис			Примітка
UA.SFS.RSP.60.1		Відомості щодо результату опрацювання запиту переліку оформлених МД			Кореневий елемент XML документа
Тег		Опис			Примітка
md		Інформація по митній декларації (МД)		*
№	Тег	Опис	Тип/Розмір	Кардинальність1	Примітка
1	guid	Глобальний ідентифікатор МД	guid	1
2	ccd_registered	Дата та час оформлення МД	datetime	?	формат YYYYMMDDTHHMISS (символ «Т» – роздільник)
3	MRN	Унікальний номер МД	varchar(18)	1	Тільки для МД, оформлених після 01.10.2022
4	ccd_07_01	Номер МД (код митного органу)	varchar(9)	1
5	ccd_07_02	Номер МД (рік)	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 (символ «Т» - роздільник)
12	ccd_modified	Дата останнього змінення МД	datetime	?	формат YYYYMMDDTHHMISS (символ «Т» – роздільник) Тільки для МД зі статусами N – анульована або F– відкликана)
13	ccd_cancelled	Дата та час анулювання МД	datetime	?	формат YYYYMMDDTHHMISS (символ «Т» – роздільник) Тільки для МД зі статусами N – анульована або F– відкликана)
14*	trn_all	Транспортний засіб	varchar(100)	?

*   тільки якщо запит повертає до 100 запиcів.

 

8.3. Формат повідомлення запиту на отримання МД в актуальному стані (UA.SFS.REQ.61.1).

8.3.1. Повідомлення містить інформацію згідно з таблицею 9.

Таблиця 9. Формат запиту UA.SFS.REQ.61.1

 

Тег		Опис				Примітка
UA.SFS.REQ.61.1		Запит на отримання МД в актуальному стані				Кореневий елемент XML документа
№	Тег	Опис	Тип/Розмір	Кардина-льність1	Примітка
1	creation_date	Дата та час фактичного формування запиту	datetime	1	формат YYYYMMDDTHHMISS (символ «Т» – роздільник)
2	cli_code	Код ЄДРПОУ/ДРФО	numeric(10,0)	1
3*	guid	Глобальний ідентифікатор МД	guid	?
4*	MRN	Унікальний номер МД	varchar(18)	?	Тільки для МД, оформлених після 01.10.2022

*зазначається або Глобальний ідентифікатор МД (guid) або Унікальний номер МД (MRN).

 

8.4. Формат повідомлення відповіді на запит UA.SFS.REQ.61.1 (UA.SFS.RSP.61.1).

 

8.4.1. Відповідь містить інформацію згідно із Специфікацією форматів електронних повідомлень автоматизованої системи митного оформлення (наказ Держмитслужби від 01.03.2013 № 61).

 

 

 

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

9.1. UA.SFS.REQ.60.1 (запит SOAP)

<?xml version="1.0" encoding="windows-1251"?>

<UA.SFS.REQ.60.1>

            <creation_date>20250529T100000</creation_date>

            <cli_code>12345678</cli_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",

    "cli_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 (відповідь - SOAP)

<?xml version="1.0" encoding="windows-1251"?>

<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 (відповідь - 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="windows-1251"?>

<UA.SFS.REQ.61.1>

            <creation_date>20250529T113000</creation_date>

            <cli_code>1234567890</cli_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",

    "cli_code": "1234567890",

    "guid": "550e8400-e29b-41d4-a716-446655440000",

    "MRN": "25UA120000012365U7"

  }

}

 

9.7. UA.SFS.RSP.61.1 (відповідь - SOAP)

Специфікація форматів електронних повідомлень автоматизованої системи митного оформлення (наказ Держмитслужби від 01.03.2013 № 61).

 

9.8. UA.SFS.RSP.61.1 (відповідь - REST API)

Специфікація форматів електронних повідомлень автоматизованої системи митного оформлення (наказ Держмитслужби від 01.03.2013 № 61).

 

10.    Довідники

Таблиця 10. Довідники