МIНIСТЕРСТВО ФIНАНСIВ УКРАЇНИ

НАКАЗ

30.07.2019	N 327

Про затвердження Специфiкацiї набору гармонiзованих вiдомостей для надання через єдиний державний iнформацiйний веб-портал "Єдине вiкно для мiжнародної торгiвлi"

     Вiдповiдно до частини шостої статтi 33¹ Митного кодексу України, з метою гармонiзацiї вiдомостей, що надаються Державнiй фiскальнiй службi державними органами, установами та органiзацiями, уповноваженими на здiйснення дозвiльних або контрольних функцiй щодо перемiщення товарiв, транспортних засобiв комерцiйного призначення через митний кордон України, наказую:

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

     2. Департаменту митної полiтики Мiнiстерства фiнансiв України в установленому порядку забезпечити:

     оприлюднення цього наказу;

     його систематичний перегляд.

     3. Державнiй фiскальнiй службi України забезпечити розмiщення на офiцiйному веб-сайтi iнформацiї про специфiкацiю набору гармонiзованих вiдомостей.

     4. Цей наказ набирає чинностi з моменту його оприлюднення.

     5. Контроль за виконанням цього наказу залишаю за собою та покладаю на в. о. Голови Державної фiскальної служби України Гутенка Д. В.

Мiнiстр

О. Маркарова

 

ЗАТВЕРДЖЕНО Наказ Мiнiстерства фiнансiв України 30 липня 2019 року N 327

СПЕЦИФ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йний веб-портал "Єдине вiкно для мiжнародної торгiвлi" державними органами, установами та органiзацiями, уповноваженими на здiйснення дозвiльних або контрольних функцiй щодо перемiщення товарiв, транспортних засобiв комерцiйного призначення через митний кордон України (далi - Вiдомостi документiв).

     2. Вiдомостi документiв отримуються ДФС через SOAP веб-сервiс, розмiщений за адресою: http://sw2.sfs.gov.ua/AskCustoms.asmx. Назва веб-методу - AskCustomsl.

     3. Запити (Request) пiдлягають:

     пiдписуванню квалiфiкованим електронним пiдписом чи печаткою iнiцiатора (ДСТУ);

     шифруванню (AES) сеансовим ключем, який пропонує iнiцiатор запиту i який зашифрований на технологiчний ключ ДФС (RSA).

     4. Вiдповiдi (Response):

     пiдписуються технологiчним квалiфiкованим електронним пiдписом чи печаткою ДФС (ДСТУ);

     шифруються тим самим сеансовим ключем.

II. Формат запиту

     1. Запит мiстить iнформацiю згiдно з таблицею "Формат запиту".

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

N	Тег	Тип та розмiр	Обов'язковiсть	Примiтка
1	MessageBody	byte[]	Так	Тiло запиту
2	MessageType	string(128)	Так	UA.SFS.REQ.N.V, де N - тип запиту згiдно з Довiдником, починаючи з 1, V - номер версiї
3	MessageID	guid	Так	Iдентифiкатор запиту
4	Initiator	string(10)	Так	РНОКПП запитувача
5	SignCertificate	byte[]	Нi	Сертифiкат ключа, яким пiдписано запит. Обов'язкове, якщо пiдпис не мiстить сертифiката
6	Signature	byte[]	Так	Значення ЕЦП запиту
7	SessionKey	byte[]	Так	Зашифрований сесiйний ключ шифрування
8	CryptKeyID	guid	Так	Iдентифiкатор ключа ДФС, на який зашифровано повiдомлення*

____________
     * Використовується такий iдентифiкатор ключа ДФС: 3faf09b8-5b24-4534-b382-9960dca30544.

     Зазначений iдентиф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. Тiло запиту формується таким чином:

     1) формується XML, який мiстить данi згiдно з таблицями 1 або 2, наведеними в додатку до цiєї Специфiкацiї, залежно вiд типу документа. Для вiдомостей документiв використовується тип запиту - 8, версiя - 1;

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

     3) отримана послiдовнiсть байт пiдписується ключем запитувача. Значення квалiфiкованого електронного пiдпису чи печатки передається в тезi signature;

     4) генерується випадковий сеансовий ключ для алгоритму AES;

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

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

Директор Департаменту митної полiтики

О. Москаленко

 

Додаток до Специфiкацiї форматiв гармонiзованих вiдомостей для надання через єдиний державний iнформацiйний веб-портал "Єдине вiкно для мiжнародної торгiвлi" (пiдпункт 1 пункту 2 роздiлу II)

Структура даних повiдомлення (тiло запиту)

Таблиця 1. Дозвiльнi документи

Тег		Опис			Примiтка
pd_documents		загальна iнформацiя про дозвiл
N	тег	опис	тип/розмiр	кардинальнiсть*	примiтка
1	pd_doc_code	Тип документа	smallint	1	Коди узгоджуються з ДФС для кожного типу документа
2	pd_doc__num	Номер документа	varchar(50)	1
3	pd_doc_date	Дата документа	datetime	1
4	pd_agency_post	Посада особи, що видала документ	varchar(500)	1
5	pd_agency_username	ПIБ особи, що видала документ	varchar(120)	1
6	pd_agency_unit	Пiдроздiл, що видав документ	varchar(500)	1
7	pd_cancel_reason	Причина скасування	text	?
8	pd_cancellor	Хто скасував документ	varchar(128)	?
9	pd_cancelled	Дата скасування	datetime	?
10	pd_expiration_date	Строк дiї документа	datetime	?
11	pd_status	Статус	char(1)	1	W - в роботi (неактивний) R-активований N - анульований (скасований, видалений)
12	pd_clients	Клiєнти	pd_clients	*
13	pd_doc_gap	Додатковi вiдомостi про документ	pd_doc_gap	*
14	pd_goods	Товари	pd_goods	*
Тег		Опис			Примiтка
pd_clients		клiєнти
N	тег	опис	тип/розмiр	кардинальнiсть*	примiтка
1	cli_type	Тип клiєнта	tinyint	1	Коди узгоджуються з ДФС для кожного типу документа
2	cli_cnt_code	Код країни клiєнта	varchar(2)	1
3	cli_code	Код згiдно з ЄДРПОУ клiєнта	varchar(10)	?	Вiдсутнiй для iноземних компанiй
4	cli_name	Назва клiєнта	varchar(500)	1
5	cli_adr	Адреса клiєнта	varchar(500)	?
Тег		Опис			Примiтка
pd_doc_gap		додатковi вiдомостi про документ
N	тег	опис	тип/розмiр	кардинальнiсть*	примiтка
1	dg_code	Код	smallint	1	Коди узгоджуються з ДФС для кожного типу документа
2	dg_value	Значення	varchar(max)	1
Тег		Опис			Примiтка
pd_goods		товари
N	тег	опис	тип/розмiр	кардинальнiсть*	примiтка
1	g_order_num	Номер товару за порядком	smallint	1
2	g_code	Код товару згiдно з УКТЗЕД	varchar(10)	?
3	g_name	Назва товару мовою оригiналу	text	1
4	g_int_code	Додатковий код	varchar(50)	?
5	g_count	Кiлькiсть	numeric(20,3)	1
6	g_unit	Одиниця вимiру	numeric(4,0)	1	Коди узгоджуються з ДФС для кожного типу документа
7	pd_goods_gap	Додатковi вiдомостi про товари	pd_goods_gap	*
Тег		Опис			Примiтка
pd_goods_gap		додатковi вiдомостi про товари
N	тег	опис	тип/розмiр	кардинальнiсть*	примiтка
1	gg_code	Код	smallint	1	Коди узгоджуються з ДФС для кожного типу документа
2	gg_value	Значення	nvarchar(max)	1

Таблиця 2. Заборони та обмеження

Тег		Опис			Примiтка
ban_documents		загальна iнформацiя про дозвiл
N	тег	опис	тип/розмiр	кардинальнiсть*	примiтка
1	ban_doc_code	Код заборони	smallint	1	Коди узгоджуються з ДФС для кожного типу документа
2	ban_indoc_num	Номер рiшення введення в дiю	varchar(50)	1
3	ban_indoc_date	Дата рiшення введення в дiю	datetime	1
4	ban_outdoc_num	Номер рiшення скасування	varchar(50)	?
5	ban_outdoc_date	Дата рiшення скасування	datetime	?
6	ban_goods_desc	Назва продукцiї	text	1
7	ban_status	Статус	char(l)	1	W - в роботi (неактивний)  R - активований  N - анульований (скасований, видалений)
8	ban_agency_userpost	Посада особи, що видала заборону	varchar(500)	1
9	ban_agency_username	ПIБ особи, що видала заборону	varchar(128)	1
10	ban_agency_unit	Пiдроздiл, що видав заборону	varchar(500)	1
11	ban_cancellor	Хто видалив заборону	varchar(128)	?
12	ban_cancel_reason	Причина видалення	text	?
13	ban_cancelled	Дата видалення	datetime	?
Тег		Опис			Примiтка
pd_doc_gap		додатковi вiдомостi про документ
N	тег	опис	тип/розмiр	кардинальиiсть*	примiтка
1	dg_code	Код	smallint	1	Коди узгоджуються з ДФС для кожного типу документа
2	dg_value	Значення	varchar(max)	1
Тег		Опис			Примiтка
ban_goods		товари
N	тег	опис	тип/розмiр	кардинальнiсть*	опис
1	g_code	Код	varchar(10)	?

____________
     * Кардинальнiсть:
     0 = не використовується
     ? = (0.1);
     1 = 1;
     * = (0...);
     + = (1...).