Державна митна служба України
Про затвердження Специфікації структури та формату електронних повідомлень для обміну даними між Держмитслужбою та портовими операторами про доручення на навантаження
Про затвердження Специфікації структури та формату електронних повідомлень
для обміну даними між Держмитслужбою та портовими операторами про доручення на навантаження та статуси доручення на навантаження
Відповідно до частини четвертої статті 31¹ Митного кодексу України, пунктів 29, 33 частини четвертої статті 19 Закону України «Про центральні органи виконавчої влади», підпункту 49 пункту 4, підпунктів 5, 8 пункту 5, пункту 9, підпунктів 25, 29 пункту 11 Положення про Державну митну службу України, затвердженого постановою Кабінету Міністрів України від 06 березня 2019 року № 227, з урахуванням Порядку виконання митних формальностей на морському та річковому транспорті, затвердженого наказом Міністерства фінансів України від 10 березня 2015 року № 308, зареєстрованим в Міністерстві юстиції України 30 квітня 2015 року за № 486/26931, з метою обміну даними між Держмитслужбою та портовими операторами,
НАКАЗУЮ:
1. Затвердити Специфікацію структури та формату електронних повідомлень для обміну даними між Держмитслужбою та портовими операторами про доручення на навантаження та статуси доручення на навантаження, що додається.
2. Департаменту з питань цифрового розвитку, цифрових трансформацій і цифровізації (Аліна Брендак) забезпечити оприлюднення цього наказу на вебпорталі Держмитслужби.
3. Контроль за виконанням цього наказу покласти на заступника Голови з питань цифрового розвитку, цифрових трансформацій і цифровізації Олега Ніколайчука.
В. о. Голови
Сергій ЗВЯГІНЦЕВ
ЗАТВЕРДЖЕНО
Наказ Державної митної служби України
03.04.2025 № 316
СПЕЦИФІКАЦІЯ
структури та формату електронних повідомлень
для обміну даними між Держмитслужбою та портовими операторами про доручення на навантаження та статуси доручення на навантаження
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.59.1 (59 – код повідомлення 1 – версія ) |
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.59.1 (59 – код повідомлення, 1 – версія) |
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.59.1) стосовна отримання інформації щодо доручення на навантаження та змінам статусів:
4.1.1. запит містить інформацію згідно з таблицею 3.
Таблиця 3. Формат запиту UA.SFS.REQ.59.1
Тег |
Опис |
Примітка |
||||||
UA.SFS.REQ.59.1 |
Запит на отримання інформації |
Кореневий елемент XML документу |
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардина-льність[5] |
Примітка |
|
||
1 |
cli_code |
Код ЄДРПОУ запитувача |
varchar(8) |
1 |
|
|
||
2 |
creation_date |
Дата формування запиту |
datetime |
1 |
yyyyMMddTHHmmss |
|
||
3 |
req_type |
Тип запиту |
varchar(1) |
1 |
1 – Отримання з черги інформації про зміну статусу доручення на навантаження 2 – Отримання списку змін статусів доручень за вказаний період 3 – Отримання доручення на навантаження за MRN |
|
||
4 |
date_begin |
Початкова дата періода для запиту статусів |
datetime |
? |
yyyyMMdd Обов’язкове, при req_type=2, інакше – не використовується |
|
||
5 |
date_end |
Кінцева дата періода для запиту статусів |
datetime |
? |
yyyyMMdd Обов’язкове, при req_type=2, інакше – не використовується |
|
||
6 |
mrn |
Номер доручення на навантаження |
varchar(18) |
? |
Обов’язкове, при req_type=3, інакше - не використовується |
|
||
4.2. Формат повідомлення відповіді на запит UA.SFS.REQ.59.1 (UA.SFS.RSP.59.1):
4.2.1. успішна відповідь містить інформацію згідно з таблицею 4. Повідомлення стискується за допомогою алгоритму ZIP.
Таблиця 4. Формат успішної відповіді UA.SFS.RSP.59.1
Тег |
Опис |
Примітка |
||||||
UA.SFS.RSP.59.1 |
Відомості щодо результату запиту |
Кореневий елемент XML документа |
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
UA525C |
Дозвіл на навантаження |
UA525C |
* |
Не використовується, якщо req_type=3 Містить не більше одного елемента, при req_type=1 Не використовується, якщо req_type=1 та черга порожня |
|
||
2 |
UA522C |
Відмова у митному оформленні |
UA522C |
* |
|
|||
3 |
UA561C |
Направлення на митний огляд |
UA561C |
* |
|
|||
4 |
UA507C |
Доручення на навантаження |
UA507C |
? |
Обов’язкове, при req_type=3, інакше – не використовується |
|
||
Тег |
Опис |
Примітка |
||||||
UA525C |
Дозвіл на навантаження |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
CustomsOfficeOfExitActual |
Місце оформлення |
CustomsOfficeOfExitActual |
1 |
|
|
||
2 |
ExportOperation |
|
ExportOperation |
1 |
|
|
||
3 |
ControlResult |
|
ControlResult |
1 |
|
|
||
Тег |
Опис |
Примітка |
||||||
UA522C |
Відмова у митному оформленні |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
CustomsOfficeOfExitActual |
Місце оформлення |
CustomsOfficeOfExitActual |
1 |
|
|
||
2 |
ExportOperation |
|
ExportOperation |
1 |
|
|
||
3 |
ControlResult |
|
ControlResult |
1 |
|
|
||
Тег |
Опис |
Примітка |
||||||
UA561C |
Направлення на митний огляд |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
CustomsOfficeOfExitActual |
Місце оформлення |
CustomsOfficeOfExitActual |
1 |
|
|
||
2 |
ExportOperation |
|
ExportOperation |
1 |
|
|
||
3 |
TypeOfControls |
Вид контролю |
TypeOfControls |
1 |
|
|
||
4 |
ControlResult |
|
ControlResult |
1 |
|
|
||
Тег |
Опис |
Примітка |
||||||
CustomsOfficeOfExitActual |
Місце оформлення |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
referenceNumber |
Код митного органу |
varchar(8) |
1 |
Класифікатор Державної митної служби України, її територіальних органів та їх структурних підрозділів |
|
||
Тег |
Опис |
Примітка |
||||||
ExportOperation |
|
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
MRN |
Номер доручення на навантаження |
varchar(18) |
1 |
|
|
||
2 |
exitRejectionMotivation |
Обґрунтування відмови |
varchar(MAX) |
? |
Може використовуватись в UA522C, інакше – не використовується |
|
||
Тег |
Опис |
Примітка |
||||||
TypeOfControls |
Вид контролю |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
type |
Тип контролю |
varchar(2) |
1 |
10 – Документальний контроль 40 – Огляд 50 – Інше |
|
||
2 |
text |
Примітка |
varchar(MAX) |
? |
|
|
||
Тег |
Опис |
Примітка |
||||||
ControlResult |
|
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
date |
Дата рішення |
date |
1 |
yyyy-MM-dd
|
|
||
4.3. Формат повідомлення UA507C згідно з таблицею 5.
Таблиця 5. Формат UA507C
Тег |
Опис |
Примітка |
||||||
UA507C |
Доручення на навантаження |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
CustomsOfficeOfExitActual |
Місце оформлення |
CustomsOfficeOfExitActual |
1 |
|
|
||
2 |
ActiveBorderTransportMeans |
Судно |
ActiveBorderTransportMeans |
1 |
|
|
||
3 |
ExportOperation |
|
ExportOperation |
1 |
|
|
||
4 |
Authorisation |
Авторизації |
Authorisation |
* |
|
|
||
5 |
TransportEquipment |
Контейнери |
TransportEquipment |
* |
|
|
||
6 |
Party |
Особи |
Party |
+ |
Допустимі ролі: AP, RE, TR, NI Особа з ролью AP – обов’язкова |
|
||
7 |
Consignment |
Партії товарів |
Consignment |
* |
|
|
||
Тег |
Опис |
Примітка |
||||||
CustomsOfficeOfExitActual |
Місце оформлення |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
referenceNumber |
Код митного органу |
varchar(8) |
1 |
Класифікатор Державної митної служби України, її територіальних органів та їх структурних підрозділів |
|
||
Тег |
Опис |
Примітка |
||||||
ActiveBorderTransportMeans |
Судно |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
identificationNumber |
Номер ІМО |
number(9) |
1 |
|
|
||
2 |
name |
Назва |
varchar(70) |
1 |
|
|
||
3 |
nationality |
Держава прапора |
varchar(2) |
1 |
|
|
||
Тег |
Опис |
Примітка |
||||||
ExportOperation |
|
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
LRN |
LRN |
varchar(200) |
? |
Номер, присвоєний документу заявником при його видачі |
|
||
2 |
MRN |
Номер доручення на навантаження |
varchar(18) |
1 |
|
|
||
Тег |
Опис |
Примітка |
||||||
Authorisation |
Авторизація |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
sequenceNumber |
Порядковий номер в рамках батьківського елемента |
int |
1 |
Починається з 1 |
|
||
2 |
referenceNumber |
Номер авторизації |
varchar(32) |
1 |
|
|
||
Тег |
Опис |
Примітка |
||||||
TransportEquipment |
Контейнер |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
sequenceNumber |
Порядковий номер в рамках батьківського елемента |
int |
1 |
Починається з 1 |
|
||
2 |
containerIdentificationNumber |
Номер контейнера |
varchar(26) |
1 |
|
|
||
3 |
typeOfContainer |
Тип контейнера |
varchar(3) |
? |
Класифікатор типів контейнерів |
|
||
4 |
supplType |
Тип постачальника |
varchar(1) |
? |
1 – вантажовідправник 2 – перевізник |
|
||
5 |
filling |
Ознака заповненості |
varchar(3) |
? |
LCL – частковий FCL – повний E – порожній |
|
||
6 |
Seal |
Пломби |
Seal |
* |
|
|
||
7 |
GoodsReference |
Посилання на товари |
GoodsReference |
* |
|
|
||
Тег |
Опис |
Примітка |
||||||
Seal |
Пломба |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
sequenceNumber |
Порядковий номер в рамках батьківського елемента |
int |
1 |
Починається з 1 |
|
||
2 |
identifier |
Номер пломби |
varchar(20) |
1 |
|
|
||
3 |
sealer |
Пломбування здійснено |
varchar(2) |
1 |
AA – консолідатор; AB – невідомо; AC – карантинне агентство; CA – відправник; CU – митниця; SH – перевізник; TO – оператор термінала |
|
||
Тег |
Опис |
Примітка |
||||||
GoodsReference |
Посилання на товар |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
sequenceNumber |
Порядковий номер в рамках батьківського елементу |
int |
1 |
Починається з 1 |
|
||
2 |
declarationGoodsItemNumber |
Порядковий номер товару в рамках заяви |
int |
1 |
Відповідає declarationGoodsItemNumber в GoodsItem |
|
||
Тег |
Опис |
Примітка |
||||||
Party |
Особа |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
sequenceNumber |
Порядковий номер в рамках батьківського елемента |
int |
1 |
Починається з 1 |
|
||
2 |
identificationNumber |
Реєстраційний номер облікової картки платника податків\код згідно з ЄДРПОУ |
number(10,0) |
? |
Обов’язкове при role = AP або role = RE або role = NI |
|
||
3 |
name |
Назва |
varchar(70) |
1 |
|
|
||
4 |
Address |
Адреса |
Address |
? |
|
|
||
5 |
ContactPerson |
Контактна особа |
ContactPerson |
? |
|
|
||
6 |
role |
Роль |
varchar(2) |
1 |
AP – заявник RE – представник TR – перевізник NI – портовий оператор CZ – відправник CN – одержувач |
|
||
Тег |
Опис |
Примітка |
||||||
ContactPerson |
Контактна особа |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
name |
ПІБ |
varchar(70) |
1 |
|
|
||
2 |
phoneNumber |
Номер телефону |
varchar(35) |
1 |
|
|
||
3 |
eMailAddress |
|
varchar(256) |
? |
|
|
||
Тег |
Опис |
Примітка |
||||||
Consignment |
Партія товарів |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
sequenceNumber |
Порядковий номер в рамках батьківського елемента |
int |
1 |
Починається з 1 |
|
||
2 |
MRN |
MRN партії товарів |
varchar(18) |
1 |
|
|
||
3 |
referenceNumberUCR |
Unique Consignment Reference Number |
varchar(35) |
? |
|
|
||
4 |
LocationOfGoods |
Місцезнаходження товарів |
LocationOfGoods |
* |
|
|
||
5 |
TransportDocument |
Документи до партії товарів |
TransportDocument |
* |
|
|
||
6 |
Party |
Особи |
Party |
+ |
Допустимі ролі: CZ, CN Особи з ролью CZ, CN – обов’язкові |
|
||
7 |
GoodsItem |
Товари |
GoodsItem |
+ |
|
|
||
Тег |
Опис |
Примітка |
||||||
GoodsItem |
Товар |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
declarationGoodsItemNumber |
Порядковий номер товару в рамках заяви |
int |
1 |
Починається з 1 |
|
||
2 |
referenceNumberUCR |
Unique Consignment Reference Number |
varchar(35) |
? |
|
|
||
3 |
Commodity |
Товар |
Commodity |
1 |
|
|
||
4 |
TransportDocument |
Документи до товару |
TransportDocument |
* |
|
|
||
5 |
Packaging |
Пакування |
Packaging |
* |
|
|
||
Тег |
Опис |
Примітка |
||||||
Commodity |
Товар |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
descriptionOfGoods |
Назва товару |
varchar(MAX) |
1 |
|
|
||
2 |
code |
Код товару |
varchar(10) |
1 |
Код товару згідно з УКТЗЕД |
|
||
3 |
GoodsMeasure |
Кількість товару |
GoodsMeasure |
1 |
|
|
||
Тег |
Опис |
Примітка |
||||||
GoodsMeasure |
Кількість товару |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
grossMass |
Маса брутто |
number(16,6) |
1 |
|
|
||
2 |
netMass |
Маса нетто |
number(16,6) |
? |
|
|
||
3 |
unit |
Одиниці виміру |
int |
? |
Класифікатор одиниць вимірювання та обліку, що використовуються у процесі оформлення митних декларацій |
|
||
4 |
quantity |
Кількість |
number(16,6) |
? |
|
|
||
5 |
currency |
Валюта |
varchar(3) |
1 |
Перелік кодів валют для статистичних цілей |
|
||
6 |
invoiceAmount |
Вартість у валюті |
number(18,2) |
1 |
|
|
||
Тег |
Опис |
Примітка |
||||||
Packaging |
Пакування |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
sequenceNumber |
Порядковий номер в рамках батьківського елемента |
int |
1 |
Починається з 1 |
|
||
2 |
typeOfPackages |
Код пакування |
char(2) |
1 |
Класифікатор видів упаковок |
|
||
3 |
numberOfPackages |
Кількість місць |
int |
? |
|
|
||
4 |
shippingMarks |
Маркування |
varchar(512) |
? |
|
|
||
Тег |
Опис |
Примітка |
||||||
TransportDocument |
Документ |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
sequenceNumber |
Порядковий номер в рамках батьківського елемента |
int |
1 |
Починається з 1 |
|
||
2 |
type |
Тип документа |
varchar(4) |
1 |
Класифікатор документів, сертифікатів, дозволів та додаткової інформації |
|
||
3 |
referenceNumber |
Номер документа |
varchar(50) |
1 |
|
|
||
Тег |
Опис |
Примітка |
||||||
LocationOfGoods |
Місцезнаходження товару |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
sequenceNumber |
Порядковий номер в рамках батьківського елемента |
int |
1 |
Починається з 1 |
|
||
2 |
typeOfLocation |
Тип місця |
char(1) |
1 |
A – визначене B – авторизоване C – підтверджене D – інші |
|
||
3 |
qualifierOfIdentification |
Кваліфікатор ідентифікації місця |
char(1) |
1 |
T, U, V, W, X, Y, Z |
|
||
4 |
UNLocode |
ЛОКОД |
varchar(4) |
? |
Обов’язкове при qualifierOfIdentification = U |
|
||
5 |
authorisationNumber |
Номер авторизації |
varchar(35) |
? |
Обов’язкове при qualifierOfIdentification = Y |
|
||
6 |
CustomsOffice |
Митниця |
CustomsOffice |
? |
Обов’язкове при qualifierOfIdentification = V |
|
||
7 |
GNSS |
Координати |
GNSS |
? |
Обов’язкове при qualifierOfIdentification = W |
|
||
8 |
EconomicOperator |
EORI |
EconomicOperator |
? |
Обов’язкове при qualifierOfIdentification = X |
|
||
9 |
Address |
Адреса |
Address |
? |
Обов’язкове при qualifierOfIdentification = Z |
|
||
10 |
PostcodeAddress |
Поштовий індекс |
PostcodeAddress |
? |
Обов’язкове при qualifierOfIdentification = T |
|
||
11 |
ContactPerson |
Контактна особа |
ContactPerson |
? |
|
|
||
Тег |
Опис |
Примітка |
||||||
CustomsOffice |
Митниця |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
referenceNumber |
Код митного органу |
varchar(8) |
1 |
Класифікатор Державної митної служби України, її територіальних органів та їх структурних підрозділів |
|
||
Тег |
Опис |
Примітка |
||||||
GNSS |
Координати |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
latitude |
Широта |
varchar(17) |
1 |
|
|
||
2 |
longitude |
Довгота |
varchar(17) |
1 |
|
|
||
Тег |
Опис |
Примітка |
||||||
EconomicOperator |
EORI |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
identificationNumber |
Номер EORI |
varchar(17) |
1 |
|
|
||
Тег |
Опис |
Примітка |
||||||
Address |
Адреса |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
streetAndNumber |
Вулиця та номер будинку |
nvarchar(70) |
? |
|
|
||
2 |
postcode |
Поштовий індекс |
varchar(17) |
? |
|
|
||
3 |
city |
Населений пункт |
nvarchar(50) |
? |
|
|
||
4 |
country |
Країна |
char(2) |
? |
Перелік кодів країн світу для статистичних цілей (код альфа-2) |
|
||
Тег |
Опис |
Примітка |
||||||
PostcodeAddress |
Поштовий індекс |
|
||||||
№ |
Тег |
Опис |
Тип/Розмір |
Кардинальність |
Примітка |
|
||
1 |
houseNumber |
Номер будинку |
varchar(17) |
? |
|
|
||
2 |
postcode |
Поштовий індекс |
varchar(17) |
1 |
|
|
||
3 |
country |
Країна |
char(2) |
1 |
Перелік кодів країн світу для статистичних цілей (код альфа-2) |
|
||
5. Приклади повідомлень
5.1. UA.SFS.REQ.59.1 (req_type=1)
<?xml version="1.0" encoding="windows-1251"?>
<UA.SFS.REQ.59.1>
<cli_code>12345678</cli_code>
<creation_date>20250125T210000</creation_date>
<req_type>1</req_type>
</UA.SFS.REQ.59.1>
5.2. UA.SFS.REQ.59.1 (req_type=2)
<?xml version="1.0" encoding="windows-1251"?>
<UA.SFS.REQ.59.1>
<cli_code>12345678</cli_code>
<creation_date>20250125T210000</creation_date>
<req_type>2</req_type>
<date_begin>20250122</date_begin>
<date_end>20250123</date_end>
</UA.SFS.REQ.59.1>
5.3. UA.SFS.REQ.59.1 (req_type=3)
<?xml version="1.0" encoding="windows-1251"?>
<UA.SFS.REQ.59.1>
<cli_code>12345678</cli_code>
<creation_date>20250125T210000</creation_date>
<req_type>3</req_type>
<mrn>25UA120000000000F0</mrn>
</UA.SFS.REQ.59.1>
5.4. UA.SFS.RSP.59.1 (req_type=1)
<?xml version="1.0" encoding="windows-1251"?>
<UA.SFS.RSP.59.1>
<UA525C>
<CustomsOfficeOfExitActual>
<referenceNumber>UA120000</referenceNumber>
</CustomsOfficeOfExitActual>
<ExportOperation>
<MRN>25UA120000000000F0</MRN>
</ExportOperation>
<ControlResult>
<date>2025-01-20</date>
</ControlResult>
</UA525C>
</UA.SFS.RSP.59.1>
5.5. UA.SFS.RSP.59.1 (req_type=2)
<?xml version="1.0" encoding="windows-1251"?>
<UA.SFS.RSP.59.1>
<UA561C>
<CustomsOfficeOfExitActual>
<referenceNumber>UA120000</referenceNumber>
</CustomsOfficeOfExitActual>
<ExportOperation>
<MRN>25UA120000000000F0</MRN>
</ExportOperation>
<TypeOfControls>
<type>10</type>
<text>text</text>
</TypeOfControls>
<ControlResult>
<date>2025-01-20</date>
</ControlResult>
</UA561C>
<UA522C>
<CustomsOfficeOfExitActual>
<referenceNumber>UA120000</referenceNumber>
</CustomsOfficeOfExitActual>
<ExportOperation>
<MRN>25UA120000000000F0</MRN>
<exitRejectionMotivation>Rejection Motivation</exitRejectionMotivation>
</ExportOperation>
<ControlResult>
<date>2025-01-21</date>
</ControlResult>
</UA522C>
</UA.SFS.RSP.59.1>
5.6. UA.SFS.RSP.59.1 (req_type=3)
<?xml version="1.0" encoding="windows-1251"?>
<UA.SFS.RSP.59.1>
<UA507C>
<CustomsOfficeOfExitActual>
<referenceNumber>UA120000</referenceNumber>
</CustomsOfficeOfExitActual>
<ActiveBorderTransportMeans>
<identificationNumber>9999999</identificationNumber>
<name>Ship Name</name>
<nationality>UA</nationality>
</ActiveBorderTransportMeans>
<ExportOperation>
<MRN>25UA120000000000F0</MRN>
</ExportOperation>
<Consignment>
<MRN>24UA100000000000U0</MRN>
<sequenceNumber>1</sequenceNumber>
<LocationOfGoods>
<sequenceNumber>1</sequenceNumber>
<typeOfLocation>D</typeOfLocation>
<qualifierOfIdentification>V</qualifierOfIdentification>
<CustomsOffice>
<referenceNumber>UA120000</referenceNumber>
</CustomsOffice>
<ContactPerson>
<name>TEST</name>
<phoneNumber>0000000</phoneNumber>
<eMailAddress>test@test.test</eMailAddress>
</ContactPerson>
</LocationOfGoods>
<GoodsItem>
<declarationGoodsItemNumber>1</declarationGoodsItemNumber>
<Packaging>
<sequenceNumber>1</sequenceNumber>
<typeOfPackages>8A</typeOfPackages>
<numberOfPackages>21</numberOfPackages>
<shippingMarks>Тест</shippingMarks>
</Packaging>
<Commodity>
<descriptionOfGoods>Тест</descriptionOfGoods>
<code>3207408500</code>
<GoodsMeasure>
<grossMass>22.00000000</grossMass>
<netMass>21.00000000</netMass>
<currency>EUR</currency>
<invoiceAmount>19.8000</invoiceAmount>
</GoodsMeasure>
</Commodity>
</GoodsItem>
<TransportDocument>
<type>0380</type>
<referenceNumber>00-00-00</referenceNumber>
<sequenceNumber>1</sequenceNumber>
</TransportDocument>
<TransportDocument>
<type>0730</type>
<referenceNumber>00-00-00</referenceNumber>
<sequenceNumber>2</sequenceNumber>
</TransportDocument>
<TransportDocument>
<type>3007</type>
<referenceNumber>00-00-00</referenceNumber>
<sequenceNumber>3</sequenceNumber>
</TransportDocument>
<Party>
<sequenceNumber>1</sequenceNumber>
<identificationNumber>00000000</identificationNumber>
<name>ТЕСТ</name>
<Address>
<streetAndNumber>вул. Тестова, буд. 0</streetAndNumber>
<postcode>00000</postcode>
<city>Тест</city>
<country>UA</country>
</Address>
<role>CZ</role>
</Party>
<Party>
<sequenceNumber>2</sequenceNumber>
<name>TEST</name>
<Address>
<streetAndNumber>Test</streetAndNumber>
<postcode>00000</postcode>
<country>CZ</country>
</Address>
<role>CN</role>
</Party>
</Consignment>
<Consignment>
<MRN>24UA100000000000U1</MRN>
<sequenceNumber>2</sequenceNumber>
<LocationOfGoods>
<sequenceNumber>1</sequenceNumber>
<typeOfLocation>D</typeOfLocation>
<qualifierOfIdentification>V</qualifierOfIdentification>
<CustomsOffice>
<referenceNumber>UA120000</referenceNumber>
</CustomsOffice>
<ContactPerson>
<name>TEST</name>
<phoneNumber>0000000</phoneNumber>
<eMailAddress>test@test.test</eMailAddress>
</ContactPerson>
</LocationOfGoods>
<GoodsItem>
<declarationGoodsItemNumber>2</declarationGoodsItemNumber>
<Packaging>
<sequenceNumber>1</sequenceNumber>
<typeOfPackages>8A</typeOfPackages>
<numberOfPackages>1</numberOfPackages>
<shippingMarks>Тест</shippingMarks>
</Packaging>
<Commodity>
<descriptionOfGoods>Тест</descriptionOfGoods>
<code>2508100000</code>
<GoodsMeasure>
<grossMass>20.00000000</grossMass>
<netMass>10.00000000</netMass>
<currency>EUR</currency>
<invoiceAmount>10.0000</invoiceAmount>
</GoodsMeasure>
</Commodity>
</GoodsItem>
<TransportDocument>
<type>4207</type>
<referenceNumber>00-00-00</referenceNumber>
<sequenceNumber>1</sequenceNumber>
</TransportDocument>
<TransportDocument>
<type>7012</type>
<referenceNumber>00-00-00</referenceNumber>
<sequenceNumber>2</sequenceNumber>
</TransportDocument>
<Party>
<sequenceNumber>1</sequenceNumber>
<identificationNumber>00000000</identificationNumber>
<name>ТЕСТ</name>
<Address>
<streetAndNumber>вул. Тестова, буд. 0</streetAndNumber>
<postcode>00000</postcode>
<city>Тест</city>
<country>UA</country>
</Address>
<role>CZ</role>
</Party>
<Party>
<sequenceNumber>2</sequenceNumber>
<name>TEST</name>
<Address>
<streetAndNumber>Test</streetAndNumber>
<postcode>00000</postcode>
<country>CZ</country>
</Address>
<role>CN</role>
</Party>
</Consignment>
<Party>
<sequenceNumber>1</sequenceNumber>
<identificationNumber>00000000</identificationNumber>
<name>ТЕСТ</name>
<Address>
<streetAndNumber>вул. Тестова, буд. 0</streetAndNumber>
<postcode>00000</postcode>
<city>Тест</city>
<country>UA</country>
</Address>
<role>AP</role>
</Party>
<Party>
<sequenceNumber>2</sequenceNumber>
<identificationNumber>00000000</identificationNumber>
<name>ТЕСТ</name>
<Address>
<streetAndNumber>вул. Тестова, буд. 0</streetAndNumber>
<postcode>00000</postcode>
<city>Тест</city>
<country>UA</country>
</Address>
<role>RE</role>
</Party>
<ExportOperation />
</UA507C>
</UA.SFS.RSP.59.1>
2. Довідники
Таблиця 6. Довідники
№ |
Назва довідника |
Посилання |
1 |
Класифікатор Державної митної служби України, її територіальних органів та їх структурних підрозділів |
https://zakon.rada.gov.ua/rada/show/v0495201-19#n104 |
2 |
Класифікатор типів контейнерів |
https://zakon.rada.gov.ua/rada/show/v1011201-12#n82 |
3 |
Класифікатор одиниць вимірювання та обліку, що використовуються у процесі оформлення митних декларацій |
https://zakon.rada.gov.ua/rada/show/v1011201-12#n123 |
4 |
Перелік кодів валют для статистичних цілей |
https://zakon.rada.gov.ua/rada/show/v0033832-20#n14 |
5 |
Класифікатор видів упаковок |
https://zakon.rada.gov.ua/rada/show/v1011201-12#n62 |
6 |
Класифікатор документів, сертифікатів, дозволів та додаткової інформації |
https://zakon.rada.gov.ua/rada/show/v1011201-12#n74 |
7 |
Перелік кодів країн світу для статистичних цілей |
https://zakon.rada.gov.ua/rada/show/v0032832-20#n14 |
Директор Департаменту
з питань цифрового розвитку,
цифрових трансформацій і цифровізації Аліна БРЕНДАК
[1] Дія виконується, якщо це визначено у форматі повідомлення.
[2] Дія виконується, якщо використовується шифрування
[4] Дія виконується, якщо використовується шифрування
[5] Кардинальність: ? = (0,1); 1 = 1; * = (0…n); + = (1…n).