ДЕРЖАВНА МИТНА СЛУЖБА УКРАЇНИ

НАКАЗ

23.01.2024	N 91

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

Вiдповiдно до частини четвертої статтi 31¹ Митного кодексу України, пунктiв 29, 33 частини четвертої статтi 19 Закону України вiд 17 березня 2011 року N 3166-VI "Про центральнi органи виконавчої влади", пунктiв 8, 9, пiдпунктiв 25, 29 пункту 11 Положення про Державну митну службу України, затвердженого постановою Кабiнету Мiнiстрiв України вiд 06 березня 2019 року N 227, та з метою реалiзацiї положень Закону України вiд 10 серпня 2023 року N 3326-IX "Про внесення змiн до Митного кодексу України та iнших законiв України щодо протидiї незаконному обiгу тютюнових виробiв", постанови Кабiнету Мiнiстрiв України вiд 19 сiчня 2024 року N 55 "Про затвердження Порядку обмiну iнформацiєю мiж Державною прикордонною службою, Державною податковою службою, Державною митною службою та суб'єктами господарювання, що мають дозволи на вiдкриття та експлуатацiю магазинiв безмитної торгiвлi, щодо реквiзитiв паспортних документiв громадян - покупцiв алкогольних напоїв та тютюнових виробiв у магазинах безмитної торгiвлi" наказую:

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

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

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

В. о. Голови

Сергiй ЗВЯГIНЦЕВ

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

Специфiкац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дпис запитувача;

шифруються (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.39.1 (39 - код пов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йний ключ шифрування
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дно до структури та формату, визначених нижче у додатку;

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

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

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

5) стиснутий XML шифрується за допомогою алгоритму AES з використанням сесiйного ключа, отримане значення записується в тег 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.39.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дно до структури та формату, визначених нижче у додатку;

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

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

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

4.1. Формат повiдомлення запиту (UA.SFS.REQ.39.1). щодо факту перетину фiзичною особою державного кордону України в певний перiод часу, у визначеному пунктi пропуску.

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

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

Тег		Опис			Примiтка
UA.SFS.REQ.39.1		Запит щодо факту перетину фiзичною особою державного кордону України в певний перiод часу, у визначеному пунктi пропуску			Кореневий елемент XML документа
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть^[1]	Примiтка
1	creation_date	Дата та час фактичного формування запиту	DateTime	1	формат YYYYMMDDTHHMISS (символ "T" - роздiльник)
2	cust_code	Код мiсця митного оформлення	varchar(9)	1	Класифiкатор митних установ²
3	person_psp	Серiя та номер паспортного документа для виїзду за кордон	vatchar(20)	1
4	person_cnt	Країна видачи паспортного документа	varchar(2)	1	Класифiкатор країн Формат: XX - країна, яка видала закордонний паспорт

4.2. Формат повiдомлення вiдповiдi на запит UA.SFS.REQ.39.1 (UA.SFS.RSP.39.1).

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

Таблиця 4. Формат вiдповiдi UA.SFS.RSP.39.1

Тег		Опис			Примiтка
UA.SFS.RSP.39.1		Вiдомостi щодо результату опрацювання запиту на перетинання фiзичною особою кордону України			Кореневий елемент XML документа
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	creation_date	Дата та час фактичного формування вiдповiдi	DateTime	1	формат YYYYMMDDTHHMISS (символ "T" - роздiльник)
2	result	Результат опрацювання запиту	numeric(1)	1	Приклад вiдповiдi: 1 - Фiзична особа перетинала кордон України, за останнi 12 годин через зазначений у запитi пункт пропуску. 2 - Фiзична особа не перетинала кордон України. 3 - У Держмитслужбу не надходить iнформацiя вiд АДПСУ

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

5.1. UA.SFS.REQ.39.1 (запит)

<?xml version="1.0" encoding="utf8"?>

<UA.SFS.REQ.39.1>

<req_date>20231009T111248</req_date>

<cust_code>UA305060</cust_code>

<person_psp>AB123456</person_psp>

<person_cnt>UA</person_cnt>

</UA.SFS.REQ.39.1>

5.2. UA.SFS.RSP.39.1 (вiдповiдь)

<?xml version="1.0" encoding="utf8"?>

<UA.SFS.RSP.39.1>

<creation_date>20231016T101248 </creation_date>

</UA.SFS.RSP.39.1>"

Заступник директора Департаменту з питань цифрового розвитку, цифрових трансформацiй i цифровiзацiї

Iгор СМIРНОВ