НТФ "Інтес"

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

НАКАЗ

30.09.2025	N 1114

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

Вiдповiдно до Конвенцiї про процедуру спiльного транзиту, Закону України вiд 30 серпня 2022 року N 2555-IX "Про приєднання України до Конвенцiї про процедуру спiльного транзиту", пунктiв 29, 33 частини четвертої статтi 19, частини першої статтi 23 Закону України "Про центральнi органи виконавчої влади", пункту 9, пiдпунктiв 25, 29 пункту 11 Положення про Державну митну службу України, затвердженого постановою Кабiнету Мiнiстрiв України вiд 06 березня 2019 року N 227, та з метою розширення iнформацiйного обмiну мiж Держмитслужбою, гарантами та суб'єктами процедури про операцiї з гарантiями для цiлей спiльного транзиту, наказую:

1. Внести змiни до Специфiкацiї "Вебсервiс Держмитслужби обмiну митною iнформацiєю", затвердженої наказом Держмитслужби вiд 05.12.2023 N 896 "Про електронну реєстрацiю гарантiй для цiлей спiльного транзиту iз застосуванням електронної транзитної системи фази 5 (NCTS P5)", виклавши її у новiй редакцiї, що додається.

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

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

В. о. Голови

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

ЗАТВЕРДЖЕНО
Наказ Державної митної служби України
05 грудня 2023 року N 896
(у редакцiї наказу Державної митної служби України
вiд 30 вересня 2025 року N 1114)

Специфiкацiя вебсервiс Держмитслужби обмiну митною iнформацiєю

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

Iнформацiйний обмiн здiйснюється через SOAP вебсервiс, розмiщений за адресою http://sw2.customs.gov.ua/Ncts5G.asmx. Назва вебметоду - GMS.

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

пiдписуванню КЕП iнiцiатора (ДСТУ).

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

пiдписуються технологiчним КЕП Держмитслужби (ДСТУ).

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

2.1. Запит мiстить таку iнформацiю:

N	Тег	Тип та розмiр	Обов'язковiсть	Примiтка
1	MessageType	string(128)	Так	Тип запиту згiдно з Довiдником типiв запитiв та вiдповiдей на них
2	MessageBody	byte[]	Так	Тiло запиту
3	MessageID	Guid	Так	Iдентифiкатор запиту
4	Initiator	string(10)	Так	ЄДРПОУ запитувача
5	Signature	byte[]	Так	Значення КЕП запиту

2.2. Тiло запиту формується таким чином:

1) формується XML, який мiстить данi. Формат визначається окремо для кожного типу запиту;

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

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

3. Формат вiдповiдi

3.1. Вiдповiдь на запит мiстить таку iнформацiю:

N	Тег	Тип та розмiр	Обов'язковiсть	Примiтка
1	MessageBody	byte[]	Нi	Тiло вiдповiдi. У разi помилки або якщо вiдповiдь не потрiбна - вiдсутнє
2	MessageTypeResponse	string(128)	Так	Тип вiдповiдi згiдно з Довiдником типiв запитiв та вiдповiдей на них
3	MessageTypeRequest	string(128)	Нi	Тип запиту згiдно з Довiдником типiв запитiв та вiдповiдей на них
4	Signature	byte[]	Нi	Значення КЕП вiдповiдi. У разi помилки або якщо вiдповiдь не потрiбна - вiдсутнiй
5	ErrorNumber	number(5)	Так	Код помилки. Якщо запит оброблено без помилки - 0
6	ErrorMessage	string(2000)	Нi	Текст помилки - за її наявностi
7	RequestRegNo	number(20)	Так	Реєстрацiйний номер запиту

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

1) формується XML, який мiстить данi. Формат визначається окремо для кожного типу вiдповiдi;

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

3) отримана послiдовнiсть байт пiдписуються ключем Держмитслужби.

Значення КЕП передається в тезi Signature.

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

4.1. Формат запиту GM015:

Тег		Опис			Примiтка
GM015		Реєстрацiя зобов'язання
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	GuaIntNum	Номер документа	Varchar(20)	?	Номер, присвоєний документу гарантом при його видачi
2	GuaTyp	Тип документа	Varchar(2)	1	1 - загальна гарантiя 2 - iндивiдуальна гарантiя
3	DatAcc	Дата видачi зобов'язання	Date	1	YYYYMMDD
4	GuaAmo	Сума зобов'язання	Number(16,2)	1	бiльше нуля
5	Cur	Валюта	Varchar(3)	1	Згiдно з Класифiкатором валют - EUR
6	PerOfRefAmo	Частка забезпечення базової суми	Number(3)	?	Можливi значення: 100/50/30, обов'язкова, якщо GuaTyp = 1, iнакше - не використовується
7	DepCusOffId	Митниця вiдправлення (код)	Varchar(8)	?	Згiдно з Класифiкатором митних органiв, обов'язкова, якщо GuaTyp = 2, iнакше - не використовується
8	DesCusOffId	Митниця призначення (код)	Varchar(8)	?	Згiдно з Класифiкатором митних органiв, обов'язкова, якщо GuaTyp = 2, iнакше - не використовується
9	GuaTin	Облiковий номер гаранта	Varchar(17)	1	Облiковий номер гаранта в реєстрi осiб, що здiйснює операцiї з товарами, Держмитслужби
10	GuaNam	Найменування гаранта	Varchar(35)	1
11	GuaCouCod	Країна гаранта	Varchar(2)	1	ISO alpha-2 код країни
12	GuaPosCod	Поштовий iндекс гаранта	Varchar(9)	1
13	GuaCit	Мiсто гаранта	Varchar(35)	1
14	GuaStrAndNum	Адреса гаранта	Varchar(35)	1
15	GuaConPer	Контактна особа гаранта	Varchar(35)	?
16	GuaConPho	Контактний телефон гаранта	Varchar(35)	?
17	GuaConMai	Контактний email гаранта	Varchar(70)	?
18	TraTin	Облiковий номер суб'єкта процедури	Varchar(17)	1	Облiковий номер суб'єкта процедури в реєстрi осiб, що здiйснюють операцiї з товарами, Держмитслужби
19	TraNam	Найменування суб'єкта процедури	Varchar(35)	1
20	TraCouCod	Країна суб'єкта процедури	Varchar(2)	1	ISO alpha-2 код країни
21	TraPosCod	Поштовий iндекс суб'єкта процедури	Varchar(9)	1
22	TraCit	Мiсто суб'єкта процедури	Varchar(35)	1
23	TraStrAndNum	Адреса суб'єкта процедури	Varchar(35)	1
24	COULIM	Країни, поза ЄС, для яких чиннiсть гарантiї обмежена	COULIM	*
Тег		Опис			Примiтка
COULIM		Країна, для якої чиннiсть гарантiї обмежена
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	Cod	Код країни	Varchar(2)	1	ISO alpha-2 код країни Можливi значення: AD/CH/GB/IS/MK/NO/RS/SM/TR

4.2. Формати вiдповiдей на запит GM015:

Тег		Опис			Примiтка
GM028		Реєстрацiя успiшна
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	DatAcc	Дата та час прийняття зобов'язання	DateTime	1	Дата та час фактичного прийняття зобов'язання, формат YYYYMMDDTHHmmSS (символ "T" - роздiльник)
2	GRN	Згенерований номер гарантiї (GRN)	Varchar(17)	1

Тег		Опис			Примiтка
GM096		Реєстрацiя не успiшна
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	DatRej	Дата та час фактичного формування вiдповiдi	DateTime	1	Дата та час фактичного формування вiдповiдi, формат YYYYMMDDTHHmmSS (символ "T" - роздiльник)
2	FUNERR	Функцiональнi помилки	FUNERR	+
Тег		Опис			Примiтка
FUNERR		Функцiональна помилка
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	ErrCod	Код помилки	Number(9)	1
2	ErrDes	Опис помилки	Varchar(MAX)	1

4.3. Формат запиту GM034:

4.3.1. Отримання списку гарантiй для суб'єкта

Тег		Опис			Примiтка
GM034		Отримання списку гарантiй для суб'єкта
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	TraTin	Облiковий номер суб'єкта процедури	Varchar(17)	1	Облiковий номер суб'єкта процедури в реєстрi осiб, що здiйснюють операцiї з товарами, Держмитслужби
2	DatAccFrom	Дата прийняття зобов'язання (з - до)	Date	?	YYYYMMDD Обов'язковi, якщо GRN не вказано
3	DatAccTo	Дата прийняття зобов'язання (з - до)	Date	?	YYYYMMDD Обов'язковi, якщо GRN не вказано
4	GRN	GRN	Varchar(17)	?	Обов'язкова, якщо перiод DatAcc не вказано

4.3.2. Отримання списку використань по гарантiї для суб'єкта

Тег		Опис			Примiтка
GM034		Отримання списку використань по гарантiї для суб'єкта
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	TraTin	Облiковий номер суб'єкта процедури	Varchar(17)	1	Облiковий номер суб'єкта процедури в реєстрi осiб, що здiйснюють операцiї з товарами, Держмитслужби
2	GRN	GRN	Varchar(17)	1
3	DatUseFrom	Дата використання (з - до)	Date	1	YYYYMMDD
4	DatUseTo	Дата використання (з - до)	Date	1	YYYYMMDD

4.3.3. Отримання списку гарантiй для гаранта

Тег		Опис			Примiтка
GM034		Отримання списку гарантiй для гаранта
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	GuaTin	Облiковий номер гаранта	Varchar(17)	1	Облiковий номер гаранта в реєстрi осiб, що здiйснюють операцiї з товарами, Держмитслужби
2	DatAccFrom	Дата прийняття зобов'язання (з - до)	Date	?	YYYYMMDD Обов'язковi, якщо GRN не вказано
3	DatAccTo	Дата прийняття зобов'язання (з - до)	Date	?	YYYYMMDD Обов'язковi, якщо GRN не вказано
4	GRN	GRN	Varchar(17)	?	Обов'язкова, якщо перiод DatAcc не вказано

4.3.4. Отримання списку використань по гарантiї для гаранта

Тег		Опис			Примiтка
GM034		Отримання списку використань по гарантiї для гаранта
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	GuaTin	Облiковий номер гаранта	Varchar(17)	1	Облiковий номер гаранта в реєстрi осiб, що здiйснюють операцiї з товарами, Держмитслужби
2	GRN	GRN	Varchar(17)	1
3	DatUseFrom	Дата використання (з - до)	Date	1	YYYYMMDD
4	DatUseTo	Дата використання (з - до)	Date	1	YYYYMMDD

4.4. Формати вiдповiдей на запит GM034:

Тег		Опис			Примiтка
GM039		Список гарантiй
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	GUA	Гарантiї	GUA	*
Тег		Опис			Примiтка
GUA		Гарантiя
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	GRN	GRN	Varchar(17)	1
2	GuaTyp	Тип документа	Varchar(2)	1	0 - Звiльнення вiд гарантiї 1 - Загальна гарантiя 2 - Iндивiдуальна гарантiя
3	GuaStat	Стасус	Varchar(3)	1	VAL - робоча INV - не робоча
4	DatAcc	Дата прийняття	Date	1	YYYYMMDD
5	DatCan	Дата скасування	Date	?	YYYYMMDD
6	RefAmo	Базова сума	Number(16,2)	?
7	PerOfRefAmo	Частка забезпечення базової суми	Number(3)	?
8	GuaAmo	Сума зобов'язання	Number(16,2)	?
9	Cur	Валюта	Varchar(3)	?
10	DepCusOffId	Митниця вiдправлення	Varchar(8)	?
11	DesCusOffId	Митниця призначення	Varchar(8)	?
12	GuaTin	Облiковий номер гаранта	Varchar(17)	?
13	GuaNam	Найменування гаранта	Varchar(255)	?
14	TraTin	Облiковий номер суб'єкта процедури	Varchar(17)	?
15	TraNam	Найменування суб'єкта процедури	Varchar(255)	?

Тег		Опис			Примiтка
GM039		Список використань по гарантiї
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	USE	Використання	USE	*
Тег		Опис			Примiтка
USE		Використання
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	MRN	MRN	Varchar(17)	1
2	DatUse	Дата використання	Date	1	YYYYMMDD
3	DatRel	Дата вивiльнення	Date	?	YYYYMMDD
4	DatCan	Дата скасування	Date	?	YYYYMMDD
5	DatArr	Дата прибуття	Date	?	YYYYMMDD
6	Amo	Зарезервованя сума	Number(16,2)	?
7	Cur	Валюта	Varchar(3)	?

Тег		Опис			Примiтка
GM096		Операцiя не успiшна
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	DatRej	Дата та час фактичного формування вiдповiдi	DateTime	1	Дата та час фактичного формування вiдповiдi, формат YYYYMMDDTHHmmSS (символ "T" - роздiльник)
2	FUNERR	Функцiональнi помилки	FUNERR	+
Тег		Опис			Примiтка
FUNERR		Функцiональна помилка
N	Тег	Опис	Тип/Розмiр	Кардинальнiсть	Примiтка
1	ErrCod	Код помилки	Number(9)	1
2	ErrDes	Опис помилки	Varchar(MAX)	1

5. Тестування

5.1. Тестове повiдомлення GM015

Тестовим повiдомленням GM015 вважається повiдомлення, яке вiдповiдає таким властивостям:

значення тегу GuaAmo - 0;

значення тегу TraNam - ТЕСТ.

5.2. Тестова вiдповiдь GM028

Тестовою вiдповiддю GM028 вважається вiдповiдь, яке вiдповiдає таким властивостям:

початок значення тегу GRN - TEST.

Тестова вiдповiдь може надсилатися лише у вiдповiдь на тестове повiдомлення.

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

6.1. GM015 (для загальної гарантiї):

<?xml version="1.0" encoding="UTF-8"?>

<GM015>

<GuaNam>ТЕСТГАРАНТ</GuaNam>

<GuaStrAndNum>вул. Тестова 99</GuaStrAndNum>

<TraStrAndNum>вул. Тестова 99</TraStrAndNum>

</COULIM>

</COULIM>

</COULIM>

</GM015>

6.2. GM015 (для iндивiдуальної гарантiї):

<?xml version="1.0" encoding="UTF-8"?>

<GM015>

<GuaNam>ТЕСТГАРАНТ</GuaNam>

<GuaStrAndNum>вул. Тестова 99</GuaStrAndNum>

<TraStrAndNum>вул. Тестова 99</TraStrAndNum>

</COULIM>

</COULIM>

</COULIM>

</GM015>

6.3. GM096:

<?xml version="1.0" encoding="UTF-8"?>

<GM096>

<ErrDes>Вiдсутня дата видачi зобов'язання</ErrDes>

</FUNERR>

<ErrDes>Вiдсутнiй код митницi вiдправлення </ErrDes>

</FUNERR>

<ErrDes>Не вiрний код митницi призначення</ErrDes>

</FUNERR>

</GM096>

6.4. GM028:

<?xml version="1.0" encoding="UTF-8"?>

<GM028>

</GM028>

6.5. GM034 (Отримання списку гарантiй для суб'єкта):

<?xml version="1.0" encoding="UTF-8"?>

<GM034>

</GM034>

6.6. GM034 (Отримання списку гарантiй для гаранта):

<?xml version="1.0" encoding="UTF-8"?>

<GM034>

</GM034>

6.7. GM034 (Отримання iнформiцiї по гарантiї для суб'єкта):

<?xml version="1.0" encoding="UTF-8"?>

<GM034>

</GM034>

6.8. GM034 (Отримання iнформацiї по гарантiї для гаранта):

<?xml version="1.0" encoding="UTF-8"?>

<GM034>

</GM034>

6.9. GM034 (Отримання списку використань по гарантiї для суб'єкта):

<?xml version="1.0" encoding="UTF-8"?>

<GM034>

</GM034>

6.10. GM034 (Отримання списку використань по гарантiї для гаранта):

<?xml version="1.0" encoding="UTF-8"?>

<GM034>

</GM034>

6.11. GM039 (Список гарантiй):

<?xml version="1.0" encoding="UTF-8"?>

<GM039>

<GUA>

</GUA>

<GUA>

</GUA>

</GM039>

6.12. GM039 (Список використань по гарантiї):

<?xml version="1.0" encoding="UTF-8"?>

<GM039>

<USE>

</USE>

<USE>

</USE>

</GM039>

Ви є тут

Головне меню

Навігатор ЗЕД

Інформаційна підтримка