ДЕРЖАВНА МИТНА СЛУЖБА УКРАЇНИ
НАКАЗ
23.01.2024 | N 91 |
---|
Про затвердження Специфiкацiї структури та
формату електронних повiдомлень для обмiну
даними мiж Держмитслужбою та магазинами
безмитної торгiвлi
Вiдповiдно до частини четвертої статтi 311 Митного кодексу України, пункт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катор митних установ2 |
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>
<result>1</result>
</UA.SFS.RSP.39.1>"
Заступник директора Департаменту з питань цифрового розвитку, цифрових трансформацiй i цифровiзацiї | Iгор СМIРНОВ |