Державна митна служба України
Про внесення змін до Специфікації структури та формату електронних повідомлень для обміну даними між Держмитслужбою та гарантами про операції з гарантіями
Відповідно до частини четвертої статті 31¹ Митного кодексу України, пунктів 29, 33 частини четвертої статті 19 Закону України «Про центральні органи виконавчої влади», пунктів 8, 9, підпункту 25 пункту 11 Положення про Державну митну службу України, затвердженого постановою Кабінету Міністрів України від 06 березня 2019 року № 227, наказу Міністерства фінансів України від 25 квітня 2023 року № 213 «Про деякі питання забезпечення сплати митних платежів», зареєстрованого в Міністерстві юстиції України 13 червня 2023 року за № 984/40040,
НАКАЗУЮ:
1.
Внести
зміни до Специфікації структури та формату електронних повідомлень для обміну
даними між Держмитслужбою та гарантами про операції з гарантіями, затвердженої наказом
Держмитслужби від 31.10.2023
№ 696, виклавши її у новій редакції, що додається.
2. Департаменту з питань цифрового розвитку, цифрових трансформацій і цифровізації (Ігор Смірнов) забезпечити оприлюднення цього наказу на вебпорталі Держмитслужби.
3. Контроль за виконанням цього наказу покласти на заступника Голови з питань цифрового розвитку, цифрових трансформацій і цифровізації Олега Ніколайчука.
В. о. Голови Сергій ЗВЯГІНЦЕВ
ЗАТВЕРДЖЕНО
Наказ Державної митної служби України
від 31.10.2023 № 696
(у редакції наказу Державної митної служби України
від . . 2025 № )
СПЕЦИФІКАЦІЯ
структури та формату електронних повідомлень
для обміну даними між Держмитслужбою та гарантами
про операції з гарантами
1. Загальні питання
Інформаційний обмін здійснюється через SOAP вебсервіс, розміщений за адресою: https://sw2.customs.gov.ua/AskCustoms.asmx. Назва вебметоду – AskCustoms1.
Запити (Request):
накладається кваліфікований електронний підпис запитувача;
опціонально шифруються (AES) сесійним ключем, який пропонує ініціатор запиту і який зашифрований на технологічний ключ Держмитслужби (RSA).
Відповіді (Response):
підписуються технологічним КЕП Держмитслужби (ДСТУ);
шифруються тим самим сесійним ключем.
2. Формат запиту
2.1. Запит містить інформацію згідно з таблицею 1.
Таблиця 1. Формат запиту
|
№ |
Тег |
Тип та розмір |
Обов’язковість |
Примітка |
|
1 |
MessageBody |
byte[] |
Так |
Тіло запиту |
|
2 |
MessageType |
string(128) |
Так |
Тип запиту: UA.SFS.REQ.xx.y (xx – код повідомлення y – версія) |
|
3 |
MessageID |
guid |
Так |
Ідентифікатор запиту |
|
4 |
Initiator |
string(10) |
Так |
ЄДРПОУ або РНОКПП ініціатора запиту |
|
5 |
SignCertificate |
byte[] |
Ні
|
Сертифікат кваліфікованої електронної печатки, якою підписано запит |
|
6 |
Signature |
byte[] |
Так |
Значення КЕП запиту |
|
7 |
SessionKey |
byte[] |
Ні
|
Зашифрований сесійний ключ шифрування |
|
8 |
CryptKeyID |
guid |
Ні
|
Ідентифікатор ключа Держмитслужби, на який зашифровано сесійний ключ* |
*На сьогодні використовується такий ідентифікатор ключа Держмитслужби: 3faf09b8-5b24-4534-b382-9960dca30544.
Він відповідає такому публічному ключу:
<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. Тіло запиту формується таким чином:
1) Формується XML, який містить дані відповідно до структури та формату, визначених нижче у відповідних таблицях;
2) XML перетворюється на послідовність байт за допомогою кодування Windows-1251;
3) XML стискується за допомогою алгоритму ZIP[1];
4) Отримана послідовність байт підписується кваліфікованим електронним підписом ініціатора запиту. Значення КЕП передається в тезі Signature;
5) Генерується випадковий сесійний ключ для алгоритму AES (довжина 256). Значення вектору ініціалізації: { 31, 207, 4, 165, 229, 33, 19, 98, 240, 133, 189, 64, 176, 145, 77, 51 }[2];
6) Ключ шифрується за допомогою алгоритму RSA, отримане значення записується в тег SessionKey2;
7) стиснутий1 XML шифрується за допомогою алгоритму AES з використанням сесійного ключа2; отримане значення записується в тег MessageBody.
3. Формат відповіді
3.1. Відповідь на запит містить інформацію згідно з таблицею 2.
Таблиця 2. Формат відповіді
|
№ |
Тег |
Тип та розмір |
Обов’язковість |
Примітка |
|
1 |
MessageBody |
byte[] |
Ні |
Тіло відповіді. У разі помилки або якщо відповідь не потрібна – відсутнє |
|
2 |
MessageType |
string(128) |
Так |
Тип відповіді: UA.SFS.RSP.xx.y (xx – код повідомлення, y – версія) |
|
3 |
SignCertificate |
byte[] |
Ні |
Сертифікат ключа, яким підписано відповідь. Тільки якщо підпис не містить сертифіката. У разі помилки або якщо відповідь не потрібна – відсутній |
|
4 |
Signature |
byte[] |
Ні |
Значення КЕП відповіді. У разі помилки або якщо відповідь не потрібна – відсутній |
|
5 |
ErrorNumber |
numeric(5) |
Так |
Код помилки. Якщо запит оброблено без помилки – 0 |
|
6 |
ErrorMessage |
string(2000) |
Ні |
Текст помилки – при її наявності |
|
7 |
MessageID |
guid |
Так |
Ідентифікатор запиту |
3.2. Тіло відповіді формується таким чином:
1) формується XML, який містить дані відповідно до структури та формату, визначених нижче у відповідних таблицях;
2) XML перетворюється на послідовність байт за допомогою кодування Windows-1251;
3) XML стискується за допомогою алгоритму ZIP[3];
4) отримана послідовність байт підписуються технологічним ключем Держмитслужби. Значення КЕП передається в тезі Signature;
5) стиснутий3 XML шифрується за допомогою алгоритму AES з використанням сесійного ключа, запропонованого в запиті[4]; отримане значення записується в тег MessageBody.
4. Формат повідомлень (MessageBody)
4.1. Формат повідомлення запиту (UA.SFS.REQ.51.1) щодо видачі гарантії.
4.1.1. Запит містить інформацію згідно з таблицею 3. Повідомлення не стискується за допомогою алгоритму ZIP.
Таблиця 3. Формат запиту UA.SFS.REQ.51.1
|
Тег |
Опис |
Примітка |
|||
|
guarantee |
Видача гарантії |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардина-льність[5] |
Примітка |
|
1 |
gd_type |
Тип гарантії |
tinyint |
1 |
1 – Гарантія за МКУ |
|
2 |
gd_subtype |
Тип гарантії |
varchar(2) |
1 |
1 – Загальна гарантія 2 – Індивідуальна гарантія |
|
3 |
go_code |
Код гаранта |
varchar(10) |
1 |
|
|
4 |
gd_cli_code |
Код суб’єкта процедури |
varchar(10) |
? |
Необов’язковий при індивідуальній гарантії для нерезидентів |
|
5 |
gd_cli_uori |
Обліковий номер суб’єкта процедури |
varchar(17) |
? |
Необов’язковий при індивідуальній гарантії для фізичних осіб |
|
6 |
gd_cli_name |
Назва суб’єкта процедури |
varchar(200) |
1 |
|
|
7 |
gd_lrn |
LRN |
varchar(200) |
? |
Номер, присвоєний документу гарантом при його видачі |
|
8 |
gd_doc_date |
Дата видачі гарантії |
date |
1 |
YYYYMMDD |
|
9 |
gd_doc_indate |
Дата початку дії гарантії |
date |
1 |
YYYYMMDD |
|
10 |
gd_doc_outdate |
Дата закінчення дії гарантії |
date |
1 |
YYYYMMDD |
|
11 |
gd_grn |
GRN |
varchar(17) |
? |
Обов’язковий, при внесенні змін до гарантії. При видачі гарантії – не використовується |
|
12 |
gd_cur |
Валюта гарантії |
varchar(3) |
1 |
Згідно з Переліком кодів валют для статистичних цілей |
|
13 |
gd_sum |
Сума гарантії |
number(18,2) |
1 |
|
|
14 |
gd_modes |
Коди митних процедур, щодо яких надано гарантію |
varchar(200) |
1 |
Коди митних процедур (UA01-UA14) розділені комою |
4.2. Формат повідомлення відповіді на запит UA.SFS.REQ.51.1 (UA.SFS.RSP.51.1)
4.2.1. Успішна відповідь містить інформацію згідно з таблицею 4. Повідомлення не стискується за допомогою алгоритму ZIP.
Таблиця 4. Формат успішної відповіді UA.SFS.RSP.51.1
|
Тег |
Опис |
Примітка |
|||
|
EdAction |
Відомості щодо результату про видачу гарантії |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
DocCode |
Код документа |
short |
1 |
|
|
2 |
DocInNum |
Вхідний номер документа |
varchar(50) |
1 |
|
|
3 |
DocInModified |
Дата модифікації документа |
datetime |
1 |
YYYYMMDDTHHmmss |
|
4 |
DocInId |
Ідентифікатор документа у вхідному файлі |
int |
1 |
|
|
5 |
DocNumber |
Присвоєний митницею номер документа |
varchar(17) |
1 |
GRN |
|
6 |
ActionCode |
Дія |
short |
1 |
|
|
7 |
ActionDate |
Момент обробки |
datetime |
1 |
YYYYMMDDTHHmmss |
|
8 |
UserName |
Особа, що обробила повідомлення |
varchar(128) |
1 |
|
|
9 |
OrgCode |
Код підрозділу митного оформлення |
number(10) |
1 |
|
|
10 |
OrgName |
Назва підрозділу митного оформлення |
varchar(128) |
1 |
|
4.2.2. Неуспішна відповідь містить інформацію згідно з таблицею 5. Повідомлення не стискується за допомогою алгоритму ZIP.
Таблиця 5. Формат неуспішної відповіді UA.SFS.RSP.51.1
|
Тег |
Опис |
Примітка |
|||
|
DocTestProt |
Список помилок |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
Error |
Помилка |
Error |
+ |
|
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
Text |
Текст |
text |
1 |
|
|
2 |
Level |
Рівень |
byte |
1 |
1 – 3 – помилка |
4.3. Формат повідомлення запиту (UA.SFS.REQ.52.1) щодо відкликання гарантії.
4.3.1. Запит містить інформацію згідно з таблицею 6. Повідомлення не стискується за допомогою алгоритму ZIP.
Таблиця 6. Формат запиту UA.SFS.REQ.52.1
|
Тег |
Опис |
Примітка |
|||
|
withdrawal |
Відкликання гарантії |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардина-льність |
Примітка |
|
1 |
gd_grn |
GRN |
varchar(17) |
1 |
GRN |
|
2 |
go_code |
Код гаранта |
varchar(10) |
1 |
Код гаранта |
4.4. Формат повідомлення відповіді на запит UA.SFS.REQ.52.1 (UA.SFS.RSP.52.1).
4.4.1. Успішна відповідь містить інформацію згідно з таблицею 7. Повідомлення не стискується за допомогою алгоритму ZIP.
Таблиця 7. Формат успішної відповіді UA.SFS.RSP.52.1
|
Тег |
Опис |
Примітка |
|||
|
EdAction |
Відомості щодо результату про відкликання гарантії |
Кореневий елемент XML документу |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
DocCode |
Код документа |
short |
1 |
|
|
2 |
DocInNum |
Вхідний номер документа |
varchar(50) |
1 |
|
|
3 |
DocInModified |
Дата модифікації документа |
datetime |
1 |
YYYYMMDDTHHmmss |
|
4 |
DocInId |
Ідентифікатор документа у вхідному файлі |
int |
1 |
|
|
5 |
DocNumber |
Присвоєний митницею номер документа |
varchar(17) |
1 |
GRN |
|
6 |
ActionCode |
Дія |
short |
1 |
|
|
7 |
ActionDate |
Момент обробки |
datetime |
1 |
YYYYMMDDTHHmmss |
|
8 |
UserName |
Особа, що обробила повідомлення |
varchar(128) |
1 |
|
|
9 |
OrgCode |
Код підрозділу митного оформлення |
number(10) |
1 |
|
|
10 |
OrgName |
Назва підрозділу митного оформлення |
varchar(128) |
1 |
|
4.4.2. Неуспішна відповідь містить інформацію згідно з таблицею 8. Повідомлення не стискується за допомогою алгоритму ZIP.
Таблиця 8. Формат неуспішної відповіді UA.SFS.RSP.52.1
|
Тег |
Опис |
Примітка |
|||
|
DocTestProt |
Список помилок |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
Error |
Помилка |
Error |
+ |
|
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
Text |
Текст |
text |
1 |
|
|
2 |
Level |
Рівень |
byte |
1 |
1 – 3 – помилка |
4.5. Формат повідомлення запиту (UA.SFS.REQ.55.1) щодо отримання списку гарантій для суб’єкта.
4.5.1. Запит містить інформацію згідно з таблицею 9. Повідомлення не стискується за допомогою алгоритму ZIP.
Таблиця 9. Формат запиту UA.SFS.REQ.55.1 щодо отримання списку гарантій для суб’єкта
|
Тег |
Опис |
Примітка |
|||
|
query |
Отримання списку гарантій для суб’єкта |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардина-льність |
Примітка |
|
1 |
gd_cli_code |
Код суб’єкта процедури |
varchar(10) |
1 |
|
|
2 |
gd_status |
Статус гарантії |
tinyint |
? |
0 – всі 1 – діючі (за замовчуванням) 2 – прийняті 3 – використані 4 – відкликані 5 – скасовані 6 – закінчено срок дії |
|
3 |
gd_doc_date_from |
Дата видачі гарантії (період) |
date |
? |
YYYYMMDD |
|
4 |
gd_doc_date_to |
date |
? |
YYYYMMDD |
|
4.6. Формат повідомлення відповіді на запит UA.SFS.REQ.55.1 (UA.SFS.RSP.55.1) щодо отримання списку гарантій для суб’єкта.
4.6.1. Успішна відповідь містить інформацію згідно з таблицею 10. Повідомлення стискується за допомогою алгоритму ZIP.
Таблиця 10. Формат успішної відповіді UA.SFS.RSP.55.1 щодо отримання списку гарантій для суб’єкта
|
Тег |
Опис |
Примітка |
|||
|
guarantees |
Список гарантій для суб’єкта |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардина-льність |
Примітка |
|
1 |
guarantee |
Гарантії |
guarantee |
* |
|
|
Тег |
Опис |
Примітка |
|||
|
guarantee |
Гарантія |
|
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардина-льність |
Примітка |
|
1 |
gd_type |
Тип гарантії |
tinyint |
1 |
1 – Гарантія за МКУ |
|
2 |
gd_subtype |
Тип гарантії |
varchar(2) |
1 |
0 – Звільнення від гарантії 1 – Загальна гарантія 2 – Індивідуальна гарантія |
|
3 |
go_code |
Код гаранта |
varchar(10) |
? |
|
|
4 |
gd_cli_code |
Код суб’єкта процедури |
varchar(10) |
? |
|
|
5 |
gd_cli_uori |
Обліковий номер суб’єкта процедури |
varchar(17) |
? |
Обліковий номер суб’єкта процедури в реєстрі осіб, що здійснює операції з товарами |
|
6 |
gd_cli_name |
Назва суб’єкта процедури |
varchar(200) |
1 |
|
|
7 |
gd_lrn |
LRN |
varchar(200) |
? |
Номер, присвоєний документу гарантом при його видачі |
|
8 |
gd_doc_date |
Дата видачі гарантії |
date |
1 |
YYYYMMDD |
|
9 |
gd_doc_indate |
Дата початку дії гарантії |
date |
1 |
YYYYMMDD |
|
10 |
gd_doc_outdate |
Дата закінчення дії гарантії |
date |
? |
YYYYMMDD |
|
11 |
gd_grn |
GRN |
varchar(17) |
1 |
|
|
12 |
gd_cur |
Валюта гарантії |
varchar(3) |
1 |
Згідно з Переліком кодів валют для статистичних цілей |
|
13 |
gd_sum |
Сума гарантії |
number(18,2) |
1 |
|
|
14 |
gd_modes |
Коди митних процедур, щодо яких надано гарантію |
varchar(200) |
1 |
Коди митних процедур (UA01-UA14), розділені комою |
|
15 |
ga_auth_type |
Тип авторизації |
int |
? |
1 – Використання загальної гарантії 2 – Використання загальної гарантії -50% 3 – Використання загальної гарантії -70% 4 – Звільнення від гарантії |
|
16 |
ga_auth_num |
Номер авторизації |
varchar(50) |
? |
|
|
17 |
gd_rest_sum |
Залишок |
number(18,2) |
1 |
|
|
18 |
gd_status |
Статус гарантії |
tinyint |
? |
Обов’язковий при gd_status запиту – 0 |
4.6.2. Неуспішна відповідь містить інформацію згідно з таблицею 11. Повідомлення стискується за допомогою алгоритму ZIP.
Таблиця 11. Формат неуспішної відповіді UA.SFS.RSP.55.1 щодо отримання списку гарантій для суб’єкта
|
Тег |
Опис |
Примітка |
|||
|
DocTestProt |
Список помилок |
Кореневий елемент XML документу |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
Error |
Помилка |
Error |
+ |
|
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
Text |
Текст |
text |
1 |
|
|
2 |
Level |
Рівень |
byte |
1 |
1 – 3 – помилка |
4.7. Формат повідомлення запиту (UA.SFS.REQ.55.1) щодо отримання списку операцій по гарантії для суб'єкта.
4.7.1. Запит містить інформацію згідно з таблицею 12. Повідомлення не стискується за допомогою алгоритму ZIP.
Таблиця 12. Формат запиту UA.SFS.REQ.55.1 щодо отримання списку операцій по гарантії для суб’єкта
|
Тег |
Опис |
Примітка |
|||
|
query |
Отримання списку операцій по гарантії для суб'єкта |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардина-льність |
Примітка |
|
1 |
gd_cli_code |
Код суб’єкта процедури |
varchar(10) |
1 |
|
|
2 |
gd_grn |
GRN |
varchar(17) |
1 |
|
|
3 |
gtr_date_from |
Дата операції (період) |
date |
1 |
YYYYMMDD |
|
4 |
gtr_date_to |
date |
1 |
YYYYMMDD |
|
4.8. Формат повідомлення відповіді на запит UA.SFS.REQ.55.1 (UA.SFS.RSP.55.1) щодо отримання списку операцій по гарантії для суб’єкта.
4.8.1. Успішна відповідь містить інформацію згідно з таблицею 13. Повідомлення стискується за допомогою алгоритму ZIP.
Таблиця 13. Формат успішної відповіді UA.SFS.RSP.55.1 щодо отримання списку операцій по гарантії для суб’єкта
|
Тег |
Опис |
Примітка |
|||
|
transactions |
Список операцій по гарантії для суб’єкта |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
transaction |
Операції по гарантії |
transaction |
* |
|
|
Тег |
Опис |
Примітка |
|||
|
transaction |
Операція по гарантії |
||||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
gtr_date |
Дата операції |
datetime |
1 |
YYYYMMDDTHHmmss |
|
2 |
gtr_type |
Тип операції |
tinyint |
1 |
1 – Блокування 2 – Вивільнення 3 – Часткове вивільнення 255 – Відміна блокування |
|
3 |
gtr_cur |
Валюта операції |
varchar(3) |
1 |
Згідно з Переліком кодів валют для статистичних цілей |
|
4 |
gtr_sum |
Сума операції |
number(18,2) |
1 |
|
|
5 |
gtr_doc_num |
Документ блокування |
varchar(50) |
? |
|
|
6 |
gtr_doc_num_release |
Документ звільнення |
varchar(50) |
? |
|
4.8.2. Неуспішна відповідь містить інформацію згідно з таблицею 14. Повідомлення стискується за допомогою алгоритму ZIP.
Таблиця 14. Формат неуспішної відповіді UA.SFS.RSP.55.1 щодо отримання списку операцій по гарантії для суб’єкта
|
Тег |
Опис |
Примітка |
|||
|
DocTestProt |
Список помилок |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
Error |
Помилка |
Error |
+ |
|
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
Text |
Текст |
text |
1 |
|
|
2 |
Level |
Рівень |
byte |
1 |
1 – 3 – помилка |
4.9. Формат повідомлення запиту (UA.SFS.REQ.55.1) щодо отримання списку гарантій для гаранта.
4.9.1. Запит містить інформацію згідно з таблицею 15. Повідомлення не стискується за допомогою алгоритму ZIP.
Таблиця 15. Формат запиту UA.SFS.REQ.55.1 щодо отримання списку гарантій для гаранта
|
Тег |
Опис |
Примітка |
|||
|
query |
Отримання списку гарантій для гаранта |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардина-льність |
Примітка |
|
1 |
go_ code |
Код гаранта |
varchar(10) |
1 |
|
|
2 |
gd_status |
Статус гарантії |
tinyint |
? |
0 – всі 1 – діючі (за замовчуванням) 2 – прийняті 3 – використані 4 – відкликані 5 – скасовані 6 – закінчено срок дії |
|
3 |
gd_doc_date_from |
Дата видачі гарантії (період) |
date |
? |
YYYYMMDD |
|
4 |
gd_doc_date_to |
date |
? |
YYYYMMDD |
|
4.10. Формат повідомлення відповіді на запит UA.SFS.REQ.55.1 (UA.SFS.RSP.55.1) щодо отримання списку гарантій для гаранта.
4.10.1. Успішна відповідь містить інформацію згідно з таблицею 16. Повідомлення стискується за допомогою алгоритму ZIP.
Таблиця 16. Формат успішної відповіді UA.SFS.RSP.55.1 щодо отримання списку гарантій для гаранта
|
Тег |
Опис |
Примітка |
|||
|
guarantees |
Список гарантій для гаранта |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардина-льність |
Примітка |
|
1 |
guarantee |
Гарантії |
guarantee |
* |
|
|
Тег |
Опис |
Примітка |
|||
|
guarantee |
Гарантія |
|
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардина-льність |
Примітка |
|
1 |
gd_type |
Тип гарантії |
tinyint |
1 |
1 – Гарантія за МКУ |
|
2 |
gd_subtype |
Тип гарантії |
varchar(2) |
1 |
0 – Звільнення від гарантії 1 – Загальна гарантія 2 – Індивідуальна гарантія |
|
3 |
go_code |
Код гаранта |
varchar(10) |
? |
|
|
4 |
gd_cli_code |
Код суб’єкта процедури |
varchar(10) |
? |
|
|
5 |
gd_cli_uori |
Обліковий номер суб’єкта процедури |
varchar(17) |
? |
Обліковий номер суб’єкта процедури в реєстрі осіб, що здійснює операції з товарами |
|
6 |
gd_cli_name |
Назва суб’єкта процедури |
varchar(200) |
1 |
|
|
7 |
gd_lrn |
LRN |
varchar(200) |
? |
Номер, присвоєний документу гарантом при його видачі |
|
8 |
gd_doc_date |
Дата видачі гарантії |
date |
1 |
YYYYMMDD |
|
9 |
gd_doc_indate |
Дата початку дії гарантії |
date |
1 |
YYYYMMDD |
|
10 |
gd_doc_outdate |
Дата закінчення дії гарантії |
date |
? |
YYYYMMDD |
|
11 |
gd_grn |
GRN |
varchar(17) |
1 |
|
|
12 |
gd_cur |
Валюта гарантії |
varchar(3) |
1 |
Згідно з Переліком кодів валют для статистичних цілей |
|
13 |
gd_sum |
Сума гарантії |
number(18,2) |
1 |
|
|
14 |
gd_modes |
Коди митних процедур, щодо яких надано гарантію |
varchar(200) |
1 |
Коди митних процедур (UA01-UA14) розділені комою |
|
15 |
ga_auth_type |
Тип авторизації |
int |
? |
1 – Використання загальної гарантії 2 – Використання загальної гарантії -50% 3 – Використання загальної гарантії -70% 4 – Звільнення від гарантії |
|
16 |
ga_auth_num |
Номер авторизації |
varchar(50) |
? |
|
|
17 |
gd_rest_sum |
Залишок |
number(18,2) |
1 |
|
|
18 |
gd_status |
Статус гарантії |
tinyint |
? |
Обов’язковий при gd_status запиту – 0 |
4.10.2. Неуспішна відповідь містить інформацію згідно з таблицею 17. Повідомлення стискується за допомогою алгоритму ZIP.
Таблиця 17. Формат неуспішної відповіді UA.SFS.RSP.55.1 щодо отримання списку гарантій для гаранта
|
Тег |
Опис |
Примітка |
|||
|
DocTestProt |
Список помилок |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
Error |
Помилка |
Error |
+ |
|
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
Text |
Текст |
text |
1 |
|
|
2 |
Level |
Рівень |
byte |
1 |
1 –3 - помилка |
4.11. Формат повідомлення запиту (UA.SFS.REQ.55.1) щодо отримання списку операцій по гарантії для гаранта.
4.11.1. Запит містить інформацію згідно з таблицею 18. Повідомлення не стискується за допомогою алгоритму ZIP.
Таблиця 18. Формат запиту UA.SFS.REQ.55.1 щодо отримання списку операцій по гарантії для гаранта
|
Тег |
Опис |
Примітка |
|||
|
query |
Отримання списку операцій по гарантії для гаранта |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардина-льність |
Примітка |
|
1 |
go_code |
Код гаранта |
varchar(10) |
1 |
|
|
2 |
gd_grn |
GRN |
varchar(17) |
1 |
|
|
3 |
gtr_date_from |
Дата операції (період) |
date |
1 |
YYYYMMDD |
|
4 |
gtr_date_to |
date |
1 |
YYYYMMDD |
|
4.12. Формат повідомлення відповіді на запит UA.SFS.REQ.55.1 (UA.SFS.RSP.55.1) щодо отримання списку операцій по гарантії для гаранта.
4.12.1. Успішна відповідь містить інформацію згідно з таблицею 19. Повідомлення стискується за допомогою алгоритму ZIP.
Таблиця 19. Формат успішної відповіді UA.SFS.RSP.55.1 щодо отримання списку операцій по гарантії для гаранта
|
Тег |
Опис |
Примітка |
|||
|
transactions |
Список операцій по гарантії для гаранта |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
transaction |
Операції по гарантії |
transaction |
* |
|
|
Тег |
Опис |
Примітка |
|||
|
transaction |
Операція по гарантії |
||||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
gtr_date |
Дата операції |
datetime |
1 |
YYYYMMDDTHHmmss |
|
2 |
gtr_type |
Тип операції |
tinyint |
1 |
1 – Блокування 2 – Вивільнення 3 – Часткове вивільнення 255 – Відміна блокування |
|
3 |
gtr_cur |
Валюта операції |
varchar(3) |
1 |
Згідно з Переліком кодів валют для статистичних цілей |
|
4 |
gtr_sum |
Сума операції |
number(18,2) |
1 |
|
|
5 |
gtr_doc_num |
Документ блокування |
varchar(50) |
? |
|
|
6 |
gtr_doc_num_release |
Документ звільнення |
varchar(50) |
? |
|
4.12.2. Неуспішна відповідь містить інформацію згідно з таблицею 20. Повідомлення стискується за допомогою алгоритму ZIP.
Таблиця 20. Формат неуспішної відповіді UA.SFS.RSP.55.1 щодо отримання списку операцій по гарантії для гаранта
|
Тег |
Опис |
Примітка |
|||
|
DocTestProt |
Список помилок |
Кореневий елемент XML документа |
|||
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
Error |
Помилка |
Error |
+ |
|
|
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
1 |
Text |
Текст |
text |
1 |
|
|
2 |
Level |
Рівень |
byte |
1 |
1 – 3 - помилка |
5. Приклади повідомлень
5.1. UA.SFS.REQ.51.1
<?xml version="1.0" encoding="windows-1251"?>
<guarantee version="1">
<gd_type>1</gd_type>
<gd_subtype>2</gd_subtype>
<go_code>01234567</go_code>
<gd_cli_code>02345671</gd_cli_code>
<gd_cli_uori>UA10022222222</gd_cli_uori>
<gd_cli_name>ТОВ Приклад</gd_cli_name>
<gd_lrn>UA0000000</gd_lrn>
<gd_doc_date>20231017</gd_doc_date>
<gd_doc_indate>20231017</gd_doc_indate>
<gd_doc_outdate>20331017</gd_doc_outdate>
<gd_cur>UAH</gd_cur>
<gd_sum>12345</gd_sum>
<gd_modes>UA02,UA07,UA12</gd_modes>
</guarantee>
5.2. UA.SFS.RSP.51.1
<?xml version="1.0" encoding="WINDOWS-1251"?>
<EdAction version="1">
<DocCode>127</DocCode>
<DocInNum>Б/Н</DocInNum>
<DocInModified>20231017T110345</DocInModified>
<DocInId>1</DocInId>
<DocNumber>23UA12001100000S4</DocNumber>
<ActionCode>1</ActionCode>
<ActionDate>20231017T110345</ActionDate>
<UserName>AskCustoms</UserName>
<OrgCode>141000000</OrgCode>
<OrgName>ДМІТС</OrgName>
</EdAction>
5.3. UA.SFS.REQ.52.1
<?xml version="1.0" encoding="windows-1251"?>
<withdrawal version="1">
<gd_grn>23UA12001100000S4</gd_grn>
<go_code>02143567</go_code>
</withdrawal>
5.4. UA.SFS.RSP.52.1
<?xml version="1.0" encoding="WINDOWS-1251"?>
<DocTestProt version="1">
<Error>
<Text>Гарант не діючий</Text>
<Level>3</Level>
</Error>
<Error>
<Text>Гарантію не знайдено</Text>
<Level>3</Level>
</Error>
</DocTestProt>
5.5. UA.SFS.REQ.55.1
5.5.1. Отримання списку гарантій для суб’єкта
<?xml version="1.0" encoding="WINDOWS-1251"?>
<query version="1">
<gd_cli_code>1234567890</gd_cli_code>
</query>
5.5.2. Отримання списку гарантій для гаранта
<?xml version="1.0" encoding="WINDOWS-1251"?>
<query version="1">
<go_code>01234567</go_code>
</query>
5.5.3. Отримання списку операцій по гарантії для суб’єкта
<?xml version="1.0" encoding="WINDOWS-1251"?>
<query version="1">
<gd_cli_code>01934267</gd_cli_code>
<gd_grn>23UA12001100000A5</gd_grn>
<gtr_date_from>20240101</gtr_date_from>
<gtr_date_to>20240115</gtr_date_to>
</query>
5.5.4. Отримання списку операцій по гарантії для гаранта
<?xml version="1.0" encoding="WINDOWS-1251"?>
<query version="1">
<go_code>11111111</go_code >
<gd_grn>23UA12001100000A5</gd_grn>
<gtr_date_from>20240101</gtr_date_from>
<gtr_date_to>20240115</gtr_date_to>
</query>
5.6. UA.SFS.RSP.55.1
5.6.1. Отримання списку гарантій для суб’єкта /гаранта
<?xml version="1.0" encoding="WINDOWS-1251"?>
<guarantees version="1">
<guarantee>
<gd_subtype>2</gd_subtype>
<go_code>11111111</go_code>
<gd_cli_code>1234567890</gd_cli_code>
<gd_cli_name>ФОП Приклад</gd_cli_name>
<gd_lrn>UA0000000</gd_lrn>
<gd_doc_date>20231017</gd_doc_date>
<gd_doc_indate>20231017</gd_doc_indate>
<gd_doc_outdate>20331017</gd_doc_outdate>
<gd_grn>23UA12001100000A5</gd_grn>
<gd_cur>UAH</gd_cur>
<gd_sum>12345</gd_sum>
<gd_modes>UA02,UA07,UA12</gd_modes>
</guarantee>
<guarantee>
<gd_type>1</gd_type>
<gd_subtype>2</gd_subtype>
<go_code>11111111</go_code>
<gd_cli_code>01234567</gd_cli_code>
<gd_cli_uori>UA10022222222</gd_cli_uori>
<gd_cli_name>ТОВ Приклад</gd_cli_name>
<gd_lrn>UA0000001</gd_lrn>
<gd_doc_date>20231017</gd_doc_date>
<gd_doc_indate>20231017</gd_doc_indate>
<gd_doc_outdate>20331017</gd_doc_outdate>
<gd_grn>23UA12001100000S4</gd_grn>
<gd_cur>UAH</gd_cur>
<gd_sum>12345</gd_sum>
<gd_modes>UA02,UA07,UA12</gd_modes>
</guarantee>
</guarantees>
5.6.2. Отримання списку операцій по гарантії для суб’єкта/гаранта
<?xml version="1.0" encoding="WINDOWS-1251"?>
<transactions version="1">
<transaction>
<gtr_date>20240122T142318</gtr_date>
<gtr_type>2</gtr_type>
<gtr_cur>UAH</gtr_cur>
<gtr_sum>12345.67</gtr_sum>
<gtr_doc_num>24UA500500000001U1</gtr_doc_num>
<gtr_doc_num_release>24UA500500010003U9</gtr_doc_num_release>
</transaction>
<transaction>
<gtr_date>20240122T103116</gtr_date>
<gtr_type>1</gtr_type>
<gtr_cur>UAH</gtr_cur>
<gtr_sum>12345.67</gtr_sum>
<gtr_doc_num>24UA500500000001U1</gtr_doc_num>
</transaction>
</transactions>
6. Довідники
Таблиця 21. Довідники
|
№ |
Назва довідника |
Посилання |
|
1 |
Перелік кодів валют для статистичних цілей |
https://zakon.rada.gov.ua/rada/show/v0033832-20#n14 |
Заступник директора Департаменту
з питань цифрового розвитку, цифрових
трансформацій і цифровізації Ігор СМІРНОВ
[1] Дія виконується, якщо це визначено у форматі повідомлення.
[2] Дія виконується, якщо використовується шифрування.
[4] Дія виконується, якщо використовується шифрування.
[5] Кардинальність: ? = (0,1); 1 = 1; * = (0…n); + = (1…n).