.png)
ДЕРЖАВНА МИТНА СЛУЖБА УКРАЇНИ
НАКАЗ
| 13.02.2026 | N 639 |
|---|
Про внесення зм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 Держмитслужби.
3. Контроль за виконанням цього наказу покласти на заступника Голови з питань цифрового розвитку, цифрових трансформацiй i цифровiзацiї Олега Нiколайчука.
| В. о. Голови | Сергiй ЗВЯГIНЦЕВ |
| ЗАТВЕРДЖЕНО Наказ Державної митної служби України 13.02.2026 N 639 |
Специф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) | Так | Тип вiдповiдi: UA.SFS.RSP.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дно до структури та формату, визначених нижче у Додатку;
2) XML перетворюється на послiдовнiсть байт за допомогою кодування utf8;
3) XML стискується за допомогою алгоритму ZIP[1];
____________
[1] Дiя виконується, якщо це
визначено у форматi повiдомлення.
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];
____________
[2] Дiя виконується, якщо
використовується шифрування
6) Ключ шифрується за допомогою алгоритму RSA, отримане значення записується в тег SessionKey2;
7) стиснутий1 XML шифрується за допомогою алгоритму AES з використанням сесiйного ключа2; отримане значення записується в тег MessageBody.
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дно до структури та формату, визначених нижче у Додатку;
2) XML перетворюється на послiдовнiсть байт за допомогою кодування utf8;
3) XML стискується за допомогою алгоритму ZIP[3];
____________
[3] Дiя виконується, якщо це
визначено у форматi повiдомлення
4) отримана послiдовнiсть байт пiдписуються технологiчним ключем Держмитслужби. Значення КЕП передається в тезi Signature;
5) стиснутий3 XML шифрується за допомогою алгоритму AES з використанням сесiйного ключа, запропонованого в запитi[4]; отримане значення записується в тег MessageBody.
____________
[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лей - UAH |
| 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льнення 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) | ? | |
| 7 | gtr_doc_type | Тип документу блокування | varchar(10) | ? | |
| 8 | gtr_doc_type_release | Тип документу звiльнення | varchar(10) | ? | |
| 9 | gtr_doc_status | Статус документу блокування | char(1) | ? | W - В роботi R - Оформлена F - Вiдмовлена G - Скасована N - Анульована D - Вилучена |
| 10 | gtr_doc_status_release | Статус документу звiльнення | char(1) | ? | |
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льнення 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) | ? | |
| 7 | gtr_doc_type | Тип документу блокування | varchar(10) | ? | |
| 8 | gtr_doc_type_release | Тип документу звiльнення | varchar(10) | ? | |
| 9 | gtr_doc_status | Статус документу блокування | char(1) | ? | W - В роботi R - Оформлена F - Вiдмовлена G - Скасована N - Анульована D - Вилучена |
| 10 | gtr_doc_status_release | Статус документу звiльнення | char(1) | ? | |
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>11111111</go_code>
<gd_cli_code>22222222</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>11111111</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>22222222</gd_cli_code>
</query>
5.5.2. Отримання списку гарантiй для гаранта
<?xml version="1.0" encoding="utf8"?>
<query version="1">
<go_code>11111111</go_code>
</query>
5.5.3. Отримання списку операцiй по гарантiї для суб'єкта
<?xml version="1.0" encoding="utf8"?>
<query version="1">
<gd_cli_code>22222222</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>22222222</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_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>22222222</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>
<gtr_doc_type>TS</gtr_doc_type>
<gtr_doc_type_release>IМ 51 ДЕ</gtr_doc_type_release>
<gtr_doc_status>R</gtr_doc_status>
<gtr_doc_status_release>R</gtr_doc_status_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>
<gtr_doc_type>TS</gtr_doc_type>
<gtr_doc_status>R</gtr_doc_status>
</transaction>
</transactions>
6. Довiдники
Таблиця 21. Довiдники
| N | Назва довiдника | Посилання |
| 1 | Перелiк кодiв валют для статистичних цiлей | https://zakon.rada.gov.ua/rada/show/v0033832-20#n14 |
