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

НАКАЗУЮ:

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

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

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

 

В. о. Голови                                                                                  Сергій ЗВЯГІНЦЕВ

 

Наказ Державної митної служби України

05.12.2023 № 896 

(у редакції наказу Державної митної

служби України від 30.09.2025 № 1114) 

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

 

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

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

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

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

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

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

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

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

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

 

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

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

кожного типу запиту;

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

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

КЕП передається в тезі Signature.

 

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

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

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

 

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

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

кожного типу відповіді;

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

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

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

 

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

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

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

 

 

 

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

 

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

 

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

 

 

 

 

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

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

 

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

 

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

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

 

 

 

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

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

 

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

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

 

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

Тег		Опис			Примітка
GM039		Список гарантій
№	Тег	Опис	Тип/Розмір	Кардинальність	Примітка
1	GUA	Гарантії	GUA	*
Тег		Опис			Примітка
GUA		Гарантія
№	Тег	Опис	Тип/Розмір	Кардинальність	Примітка
1	GRN	GRN	Varchar(17)	1
2	GuaTyp	Тип документа	Varchar(2)	1	0 – Звільнення від гарантії 1 – Загальна гарантія 2 – Індивідуальна гарантія
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	Митниця відправлення	Varchar(8)	?
11	DesCusOffId	Митниця призначення	Varchar(8)	?
12	GuaTin	Обліковий номер гаранта	Varchar(17)	?
13	GuaNam	Найменування гаранта	Varchar(255)	?
14	TraTin	Обліковий номер суб’єкта процедури	Varchar(17)	?
15	TraNam	Найменування суб’єкта процедури	Varchar(255)	?

 

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

 

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

 

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

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

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

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

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

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

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

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

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

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

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

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

<GM015>

  <GuaIntNum>01/568-7.9/15897</GuaIntNum>

  <GuaTyp>1</GuaTyp>

  <DatAcc>20221025</DatAcc>

  <GuaAmo>0</GuaAmo> 

  <Cur>EUR</Cur>

  <PerOfRefAmo>100</PerOfRefAmo>

  <GuaTin>UA10023494714</GuaTin>

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

  <GuaCouCod>UA</GuaCouCod>

  <GuaPosCod>000000</GuaPosCod>

  <GuaCit>м. Київ</GuaCit>

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

  <GuaConPer>ТЕСТ</GuaConPer>

  <GuaConPho>+000000</GuaConPho>

  <GuaConMai>test@test.test</GuaConMai>

  <TraTin>UA10099999999</TraTin>

  <TraNam>ТЕСТ</TraNam>

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

  <TraCouCod>UA</TraCouCod>

  <TraPosCod>99999</TraPosCod>

  <TraCit>м. Київ</TraCit>

  <COULIM>

    <Cod>IS</Cod>

  </COULIM>

  <COULIM>

    <Cod>RS</Cod>

  </COULIM>

  <COULIM>

    <Cod>SM</Cod>

  </COULIM>

      </GM015>

 

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

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

<GM015>

  <GuaIntNum>01/568-7.9/15897</GuaIntNum>

  <GuaTyp>2</GuaTyp>

  <DatAcc>20221025</DatAcc>

  <GuaAmo>0</GuaAmo> 

  <Cur>EUR</Cur>

  <DepCusOffId>UA100160</DepCusOffId>

  <DesCusOffId>UA305020</DesCusOffId>

  <GuaTin>UA10023494714</GuaTin>

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

  <GuaCouCod>UA</GuaCouCod>

  <GuaPosCod>000000</GuaPosCod>

  <GuaCit>м. Київ</GuaCit>

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

  <GuaConPer>ТЕСТ</GuaConPer>

  <GuaConPho>+000000</GuaConPho>

  <GuaConMai>test@test.test</GuaConMai>

  <TraTin>UA10099999999</TraTin>

  <TraNam>ТЕСТ</TraNam>

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

  <TraCouCod>UA</TraCouCod>

  <TraPosCod>99999</TraPosCod>

  <TraCit>м. Київ</TraCit>

  <COULIM>

    <Cod>IS</Cod>

  </COULIM>

  <COULIM>

    <Cod>RS</Cod>

  </COULIM>

  <COULIM>

    <Cod>SM</Cod>

  </COULIM>

</GM015>

 

6.3.  GM096:

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

<GM096>

  <DatRej>20220525T121833</DatRej>

  <FUNERR>

    <ErrCod>1001003</ErrCod>

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

  </FUNERR>

  <FUNERR>

    <ErrCod>1001012</ErrCod>

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

  </FUNERR>

  <FUNERR>

    <ErrCod>1005002</ErrCod>

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

  </FUNERR>

</GM096>

 

6.4.  GM028:

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

<GM028>

  <DatAcc>20221210T122051</DatAcc>

  <GRN>21UA1200000000AC0</GRN>

</GM028>

 

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

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

<GM034>

  <TraTin>UA10099999999</TraTin>

  <DatAccFrom>20221025</DatAccFrom>

  <DatAccTo>20221026</DatAccTo>

</GM034>

 

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

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

<GM034>

  <GuaTin>UA10099999999</GuaTin>

  <DatAccFrom>20221025</DatAccFrom>

  <DatAccTo>20221026</DatAccTo>

</GM034>

 

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

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

<GM034>

  <TraTin>UA10099999999</TraTin>

  <GRN>21UA1200000000AC0</GRN>

</GM034>

 

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

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

<GM034>

  <GuaTin>UA10099999999</GuaTin>

  <GRN>21UA1200000000AC0</GRN>

</GM034>

 

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

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

<GM034>

  <TraTin>UA10099999999</TraTin>

  <GRN>21UA1200000000AC0</GRN>

  <DatUseFrom>20221025</DatUseFrom>

  <DatUseTo>20221026</DatUseTo>

</GM034>

 

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

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

<GM034>

  <GuaTin>UA10099999999</GuaTin>

  <GRN>21UA1200000000AC0</GRN>

  <DatUseFrom>20221025</DatUseFrom>

  <DatUseTo>20221026</DatUseTo>

</GM034>

 

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

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

<GM039>

<GUA>

<GRN>21UA1200000000AC0</GRN>

<GuaTyp>2</GuaTyp>

<GuaStat>VAL</GuaStat>

<DatAcc>20220101</DatAcc>

<RefAmo>13791</RefAmo>

<GuaAmo>13791</GuaAmo>

<Cur>EUR</Cur>

<DepCusOffId>UA205020</DepCusOffId>

<DesCusOffId>LV000210</DesCusOffId>

<GuaTin>UA10099999999</GuaTin>

<GuaNam>TEST</GuaNam>

<TraTin>UA10099999999</TraTin>

<TraNam>TEST</TraNam>

</GUA>

<GUA>

<GRN>21UA1200000000AC0</GRN>

<GuaTyp>1</GuaTyp>

<GuaStat>VAL</GuaStat>

<DatAcc>20220101</DatAcc>

<RefAmo>682500</RefAmo>

<PerOfRefAmo>50</PerOfRefAmo>

<GuaAmo>341250</GuaAmo>

<Cur>EUR</Cur>

<GuaTin> UA10099999999</GuaTin>

<GuaNam>TEST</GuaNam>

<TraTin> UA10099999999</TraTin>

<TraNam>TEST</TraNam>

</GUA>

 </GM039>

 

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

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

<GM039>

<USE>

<MRN>24UA20606000000000</MRN>

<DatUse>20240326</DatUse>

<DatRel>20240423</DatRel>

<DatArr>20240423</DatArr>

<Amo>13000.13</Amo>

<Cur>EUR</Cur>

</USE>

<USE>

<MRN>24UA20903000000000</MRN>

<DatUse>20240316</DatUse>

<DatRel>20240826</DatRel>

<DatArr>20240826</DatArr>

<Amo>10000.97</Amo>

<Cur>EUR</Cur>

</USE>

</GM039>