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