Державна митна служба України
Про внесення змін до Специфікації «Вебсервіс Держмитслужби обміну митною інформацією» для обміну даними про операції з гарантіями для цілей спільного транзиту
Відповідно до Конвенції про процедуру спільного транзиту, Закону України від 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. Контроль за виконанням цього наказу покласти на заступника Голови з питань цифрового розвитку, цифрових трансформацій і цифровізації Олега Ніколайчука.
В. о. Голови Сергій ЗВЯГІНЦЕВ
Специфікація
вебсервіс
Держмитслужби обміну митною інформацією
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>