Акт завантаження на проміжному складі
Зверніть увагу, що поля в xml та json форматі відрізняються!
Опис полів XML
| № з/п | Параметр1 | Тип2 | Формат | Опис |
| UAECMR_ACT | M | Початок документа | ||
| I | ACT | M | (початок змісту документа) | |
| 1 | ExchangedDocumentContext | M | Технічні дані | |
| 1.1 | ram:SpecifiedTransactionID | M | int | Номер версії документа (транзакції) в ланцюгу підписання документів |
| 1.2.1 | ram:BusinessProcessSpecifiedDocumentContextParameter.ram:ID | M | string | код документа |
| 1.3.1 | ram:GuidelineSpecifiedDocumentContextParameter.ram:ID | M | unsignedByte | підтип документа |
| 2 | ExchangedDocument | M | Реквізити Акта | |
| 2.1 | ram:ID | M | string | номер документа |
| 2.2.1 | ram:IssueDateTime.udt:DateTime | M | datetime |
Дата і час складання Акта |
| 2.3 | ram:Remarks | O | string | Інші примітки |
| 2.4 | ram:IncludedNote | O | Номер товарно-транспортної накладної, до якої складається акт. Номер документа-підстави (ТТН); має відповідати номеру документа ExchangedDocument.ID еТТН | |
| 2.4.1 | ram:ContentCode | O | string | Ідентифікатор: * |
| 2.4.2 | ram:Content | O | string | Значення ідентифікатора (ttnNumber) |
Ідентифікатор:
* vehicle_length (сплюсована довжина транпортного засобу / автопоїзда в метрах
* vehicle_width (максимальна ширина транпортного засобу / автопоїзда в метрах
* vehicle_height (максимальна висота транпортного засобу / автопоїзда в метрах
* gross_vehicle_weight_with_cargo (загальна маса транпортного засобу / автопоїзда з вантажем в кілограмах
* vehicle_storage_address (Місце, де зберігається автомобіль)
2.4.3.1 ram:ContentCode.value M * Число (3)* Рядок
Значення ідентифікатора:
* для vehicle_length = Число
* для vehicle_width = Число
* для vehicle_height = Число
* для gross_vehicle_weight_with_cargo = Число
* для vehicle_storage_address = Рядок
2.4.4 ram:Content M string Код ролі учасника: вказується контрагентом з роллю «Перевізник» (CA). 2.5.1 ram:IssueLogisticsLocation.ram:Name M string Можливе тільки одне значення "Місце складання документу" 2.5.2 ram:IssueLogisticsLocation.ram:Description M string Опис (адреса) місця складання Акта 3 StoragePickupActPayload M* decimal при ram:TypeCode=DRIVER_GLN / TRADEPARTY_GLN * Серія та номер водійського посвідчення Водія (поле обов'язкове до заповнення). Заповнюється в форматі «3 заголовні кириличні літери + 6 цифр без пробілів», наприклад: DGJ123456, АБВ123456
* для ram:TypeCode=DRIVER_GLN - GLN Водія (поле опціональне до заповнення)
* для ram:TypeCode=TRADEPARTY_GLN - GLN Перевізника (поле обов'язкове до заповнення для відправника транзакції) 3.5.6.2 ram:TypeCode O string Код типу:
* DRIVER_GLN
* TRADEPARTY_GLN 3.5.6.3 ram:ID O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ 3.5.6.4 ram:TypeCode O string TRADEPARTY_UNZR 3.5.6.5 ram:ID O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ 3.5.6.6 ram:TypeCode O string DRIVER_UNZR 3.6 StorageLogisticsLocation M
[1] - елементи структури мають наступний вигляд:
-
параметрЗіЗначенням;
-
об’єктЗПараметрами;
-
масивОб’єктів;
-
жовтим фоном виділяються комірки, в яких відбувались останні зміни
- [2] - Під визначенням
колонкиколонки Тип полямається на увазі скорочене позначення: -
-
-
M (mandatory) — обов’язкові до заповнення поля;
-
O (optional) — необов’язкові (опціональні) до заповнення поля.
-
Опис полів JSON
| № з/п | Параметр1 | Тип2 | Формат | Опис |
| I | act | M | (початок змісту документа) | |
| 1 | documentContext | M | Технічні дані | |
| 1.1 | transactionID | M | int | Номер версії документа (транзакції) в ланцюгу підписання документів |
| 1.2.1 | documentCode.id | M | string | код документа |
| 1.3.1 | documentSubCode.id | M | unsignedByte | підтип документа |
| 2 | exchangedDocument | M | Реквізити Акта | |
| 2.1 | id | M | string | номер документа |
| 2.2.1 | issueDateTime.dateTime | M | datetime |
Дата і час складання Акта |
| 2.3 | remarks | O | string | Інші примітки |
| 2.4 | includedNote | O | Номер товарно-транспортної накладної, до якої складається акт. Номер документа-підстави (ТТН); має відповідати номеру документа ExchangedDocument.ID еТТН | |
| 2.4.1 | contentCode | O | string | Ідентифікатор: * |
| 2.4.2 | content | O | string | Значення ідентифікатора (ttnNumber) |
Ідентифікатор:
* vehicle_length (сплюсована довжина транпортного засобу / автопоїзда в метрах
* vehicle_width (максимальна ширина транпортного засобу / автопоїзда в метрах
* vehicle_height (максимальна висота транпортного засобу / автопоїзда в метрах
* gross_vehicle_weight_with_cargo (загальна маса транпортного засобу / автопоїзда з вантажем в кілограмах
* vehicle_storage_address (Місце, де зберігається автомобіль)
2.4.3.1 ram:ContentCode.value M * Число (3)* Рядок
Значення ідентифікатора:
* для vehicle_length = Число
* для vehicle_width = Число
* для vehicle_height = Число
* для gross_vehicle_weight_with_cargo = Число
* для vehicle_storage_address = Рядок
2.4.4 ram:Content M string Код ролі учасника: вказується контрагентом з роллю «Перевізник» (CA). 2.5.1 issueLogisticsLocation.name M string Можливе тільки одне значення "Місце складання документу" 2.5.2 issueLogisticsLocation.description M string Опис (адреса) місця складання Акта 3 storagePickupActPayload MTRADEPARTY_GLN 3.4.4.3 id O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ 3.4.4.4 typeCode O string TRADEPARTY_UNZR 3.5 carrierTradeParty M
* decimal при typeCode=DRIVER_GLN / TRADEPARTY_GLN Серія та номер водійського посвідчення Водія (поле обов’язкове до заповнення). Заповнюється в форматі «3 заголовні кириличні літери + 6 цифр без пробілів», наприклад: DGJ123456, АБВ123456
для typeCode=DRIVER_GLN - GLN Водія (поле опціональне до заповнення)
для typeCode=TRADEPARTY_GLN - GLN Перевізника (поле обов’язкове до заповнення для відправника транзакції) 3.5.6.2 typeCode O string Код типу:
DRIVER_GLN
TRADEPARTY_GLN 3.5.6.3 id O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ 3.5.6.4 typeCode O string TRADEPARTY_UNZR 3.5.6.5 id O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ 3.5.6.6 typeCode O string DRIVER_UNZR 3.6 storageLogisticsLocation M
укр.номери: має відповідати одному з патернів для автомобільних номерних знаків
єврономери: без валідації 3.7.2.1 affixedLogisticsSeals.id O string Номер пломби, якою проводилося пломбування автомобіля 3.7.3 settingTransportSettingTemperature O
14 - Причіп
17 - Напівпричіп 3.8.4.1 affixedLogisticsSeals.id O string Номер пломби, якою проводилося пломбування причіпа/напівпричіпа 3.8.5 settingTransportSettingTemperature O
[1] - елементи структури мають наступний вигляд:
-
параметрЗіЗначенням;
-
об’єктЗПараметрами;
-
масивОб’єктів;
-
жовтим фоном виділяються комірки, в яких відбувались останні зміни
- [2] - Під визначенням
колонкиколонки Тип полямається на увазі скорочене позначення: -
-
-
M (mandatory) — обов’язкові до заповнення поля;
-
O (optional) — необов’язкові (опціональні) до заповнення поля.
-
XML приклад
<?xml version="1.0" encoding="UTF-8"?>
<UAECMR_ACT xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:103"
xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:27"
xmlns:qdt="urn:un:unece:uncefact:data:standard:QualifiedDataType:103"
xmlns:uas="urn:ua:signatures:SignaturesExtensions:1">
<ACT>
<ExchangedDocumentContext>
<!-- Номер верії документа (транзакції) в ланцюгу підписання доументів -->
<ram:SpecifiedTransactionID>2</ram:SpecifiedTransactionID>
<ram:BusinessProcessSpecifiedDocumentContextParameter>
<ram:ID>urn:ua:e-transport.gov.ua:act:01</ram:ID>
</ram:BusinessProcessSpecifiedDocumentContextParameter>
<ram:GuidelineSpecifiedDocumentContextParameter>
<ram:ID>urn:ua:e-transport.gov.ua:act:01:storage_pickup:001</ram:ID>
</ram:GuidelineSpecifiedDocumentContextParameter>
</ExchangedDocumentContext>
<ExchangedDocument>
<!-- Номер документу HNUM -->
<ram:ID>123123</ram:ID>
<!-- Дата і час складання документу -->
<ram:IssueDateTime>
<udt:DateTime>2021-10-26T21:32:52+02:00</udt:DateTime>
</ram:IssueDateTime>
<ram:Remarks>
Інші замітки
</ram:Remarks>
<!-- Місце складання документу -->
<ram:IssueLogisticsLocation>
<ram:Name>Місце складання документу</ram:Name>
<ram:Description>79000, м.Львів, вул. Словацького, 1</ram:Description>
</ram:IssueLogisticsLocation>
</ExchangedDocument>
<StoragePickupActPayload>
<!-- Інформація про еТТН для якого складається даний акт -->
<PreviousAdministrativeReferencedDocument>
<ram:TypeCode>730</ram:TypeCode>
<!-- Номер е-ТТН (ettn.id) отриманий з ЦБД -->
<ram:ID>c5a2db34-5d96-11ec-a11f-dbe59d253156</ram:ID>
<ram:Remarks>
<!-- Base64 документу версії 1 -->
</ram:Remarks>
<ram:FormattedIssueDateTime>
<qdt:DateTimeString>2021-10-26T21:32:52+02:00</qdt:DateTimeString>
</ram:FormattedIssueDateTime>
<ram:AttachedSpecifiedBinaryFile>
<!-- document.id із ЦБД еТТН -->
<ram:ID>607cef34-5d8b-11ec-8f8b-c36339da6e6a</ram:ID>
<!-- document.url із ЦБД еТТН, лінк на обʼєкт у провайдера -->
<ram:URIID>http://shared.provider.url/607cef34-5d8b-11ec-8f8b-c36339da6e6a</ram:URIID>
<ram:MIMECode>application/xml</ram:MIMECode>
<!-- Розмір файлу, байт-->
<ram:SizeMeasure>2048</ram:SizeMeasure>
</ram:AttachedSpecifiedBinaryFile>
</PreviousAdministrativeReferencedDocument>
<!-- Інформація про акт розвантаження на проміжному складі.
Обовʼязково зазначається для цього типу актів -->
<PreviousAdministrativeReferencedDocument>
<ram:TypeCode>119</ram:TypeCode>
<!-- Номер е-ТТН (ettn.id) отриманий з ЦБД -->
<ram:ID>c5a2db34-5d96-11ec-a11f-dbe59d253156</ram:ID>
<ram:Remarks>
<!-- Base64 документу версії 1 -->
</ram:Remarks>
<ram:FormattedIssueDateTime>
<qdt:DateTimeString>2021-10-26T21:32:52+02:00</qdt:DateTimeString>
</ram:FormattedIssueDateTime>
<ram:AttachedSpecifiedBinaryFile>
<!-- document.id із ЦБД еТТН -->
<ram:ID>607cef34-5d8b-11ec-8f8b-c36339da6e6a</ram:ID>
<!-- document.url із ЦБД еТТН, лінк на обʼєкт у провайдера -->
<ram:URIID>http://shared.provider.url/607cef34-5d8b-11ec-8f8b-c36339da6e6a</ram:URIID>
<ram:MIMECode>application/xml</ram:MIMECode>
<!-- Розмір файлу, байт-->
<ram:SizeMeasure>2048</ram:SizeMeasure>
</ram:AttachedSpecifiedBinaryFile>
</PreviousAdministrativeReferencedDocument>
<!-- Інформація про попередній акт, у випадку наступної транзакції -->
<PreviousAdministrativeReferencedDocument>
<!-- Попередній документ, якщо поточний є наступною транзакцією контр-підписання -->
<ram:TypeCode>916</ram:TypeCode>
<!-- Відповідає ExchangedDocumentContext.SpecifiedTransactionID попередніх версій-->
<ram:ID>1</ram:ID>
<ram:Remarks>
<!-- Base64 документу версії 1 -->
</ram:Remarks>
<ram:FormattedIssueDateTime>
<qdt:DateTimeString>2021-10-26T21:32:52+02:00</qdt:DateTimeString>
</ram:FormattedIssueDateTime>
<ram:AttachedSpecifiedBinaryFile>
<!-- document.id із ЦБД еТТН -->
<ram:ID>607cef34-5d8b-11ec-8f8b-c36339da6e6a</ram:ID>
<!-- document.url із ЦБД еТТН, лінк на обʼєкт у провайдера -->
<ram:URIID>http://shared.provider.url/607cef34-5d8b-11ec-8f8b-c36339da6e6a</ram:URIID>
<ram:MIMECode>application/xml</ram:MIMECode>
<!-- Розмір файлу, байт-->
<ram:SizeMeasure>2048</ram:SizeMeasure>
</ram:AttachedSpecifiedBinaryFile>
</PreviousAdministrativeReferencedDocument>
<!-- Проміжний склад -->
<StorageTradeParty>
<ram:ID schemeAgencyID="ЄДРПОУ">12345678</ram:ID>
<ram:Name>ТОВ "Компанія проміжний склад"</ram:Name>
<ram:RoleCode>WH</ram:RoleCode>
</StorageTradeParty>
<!-- Перевізник -->
<CarrierTradeParty>
<ram:ID schemeAgencyID="ЄДРПОУ">12345678</ram:ID>
<ram:Name>ТОВ "Компанія перевізник"</ram:Name>
<ram:RoleCode>CA</ram:RoleCode>
</CarrierTradeParty>
<StorageLogisticsLocation>
<ram:ID schemeAgencyID="КАТОТТГ">UA800000000000</ram:ID>
<ram:Name>Головпоштампт м.Вінниця </ram:Name>
<ram:Description>вул. Соборна, 59, м. Вінниця, 21100</ram:Description>
</StorageLogisticsLocation>
<UtilizedLogisticsTransportEquipment>
<!-- Реєстраційний номер -->
<ram:ID>АА1234ВВ</ram:ID>
<ram:ApplicableNote>
<ram:ContentCode>BRAND</ram:ContentCode>
<ram:Content>Volvo</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
<ram:ContentCode>MODEL</ram:ContentCode>
<ram:Content>Truck</ram:Content>
</ram:ApplicableNote>
</UtilizedLogisticsTransportEquipment>
<PickupTransportEvent>
<ram:CertifyingTradeParty>
<ram:Name>Водій-механік</ram:Name>
<ram:RoleCode>DR</ram:RoleCode>
<ram:DefinedTradeContact>
<ram:PersonName>Петриченко Петро Петрович</ram:PersonName>
</ram:DefinedTradeContact>
<ram:SpecifiedGovernmentRegistration>
<ram:ID>Водійське посвічення №ВВ1234123/2 від 01.01.1200</ram:ID>
</ram:SpecifiedGovernmentRegistration>
</ram:CertifyingTradeParty>
<!-- Посада відповідальної експедитора -->
<ram:CertifyingTradeParty>
<ram:Name>Старший експедитор</ram:Name>
<ram:RoleCode>FW</ram:RoleCode>
<ram:DefinedTradeContact>
<ram:PersonName>Іванченко Іван Іванович</ram:PersonName>
</ram:DefinedTradeContact>
</ram:CertifyingTradeParty>
</PickupTransportEvent>
<StorageNotes>Опис причин складання акта</StorageNotes>
</StoragePickupActPayload>
<CertifyingPartyPayload>
<CertifyingTradeParty>
<ram:ID schemeAgencyID="РНОКПП">12345678</ram:ID>
<ram:Name>комірник</ram:Name>
<ram:RoleCode>WH</ram:RoleCode>
<ram:DefinedTradeContact>
<ram:PersonName>Петренко В.В.</ram:PersonName>
</ram:DefinedTradeContact>
</CertifyingTradeParty>
<CertifyingTradeParty>
<ram:ID schemeAgencyID="РНОКПП">12345678</ram:ID>
<ram:Name>Водій</ram:Name>
<ram:RoleCode>DR</ram:RoleCode>
<ram:DefinedTradeContact>
<ram:PersonName>Іваненко В.В.</ram:PersonName>
</ram:DefinedTradeContact>
</CertifyingTradeParty>
</CertifyingPartyPayload>
</ACT>
<UaSignatureStorage>
<VisualReferencedDocument>
<ram:TypeCode>916</ram:TypeCode>
<ram:Remarks><!--base64 графічного відображеня документу--></ram:Remarks>
</VisualReferencedDocument>
<Signature>
<SigningPartyRoleCode>WH</SigningPartyRoleCode>
<PartySignature>MIKAcgYJKoZIhvcNAQcCoIKAYzC...a2P7VAYGcRaZ5UI</PartySignature>
<Name>Клієнт ЮР-особа 104 (тестовий сертифікат)</Name>
<Position>комірник</Position>
<SpecifiedTaxRegistration>
<ram:ID>9999999999</ram:ID>
</SpecifiedTaxRegistration>
</Signature>
<Signature>
<SigningPartyRoleCode>CA</SigningPartyRoleCode>
<PartySignature>MIJ/BAYJKoZIhvcNAQcC...2P7VAYGcRaZ5UI</PartySignature>
<Name>Клієнт ФІЗ-особа 104 (тестовий сертифікат)</Name>
<Position>водій</Position>
<SpecifiedTaxRegistration>
<ram:ID>9999999999</ram:ID>
</SpecifiedTaxRegistration>
</Signature>
</UaSignatureStorage>
</UAECMR_ACT>
JSON приклад
{
"ram": "urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:103",
"udt": "urn:un:unece:uncefact:data:standard:UnqualifiedDataType:27",
"qdt": "urn:un:unece:uncefact:data:standard:QualifiedDataType:103",
"uas": "urn:ua:signatures:SignaturesExtensions:1",
"act": {
"documentContext": {
"transactionID": "0",
"documentCode": {
"id": "urn:ua:e-transport.gov.ua:act:01"
},
"documentSubCode": {
"id": "urn:ua:e-transport.gov.ua:act:01:storage_pickup:001"
}
},
"exchangedDocument": {
"id": "123123",
"issueDateTime": {
"dateTime": "2022-10-26T21:32:52+02:00"
},
"issueLogisticsLocation": {
"name": "Місце складання документу",
"description": "79000, м.Львів, вул. Словацького, 1"
},
"includedNote": []
},
"storagePickupActPayload": {
"previousAdministrativeReferencedDocuments": [
{
"typeCode": "730",
"id": "79bb3ebe-0439-4b53-8361-be6c70731d2c",
"formattedIssueDateTime": {
"dateTime": "2023-07-11T12:08:00.000Z"
}
},
{
"typeCode": "136",
"id": "79bb3ebe-0439-4b53-8361-682273105c",
"formattedIssueDateTime": {
"dateTime": "2023-07-11T12:08:00.000Z"
}
}
]
},
"storagePickupActPayload": {
"storageTradeParty": {
"id": {
"schemeAgencyID": "ЄДРПОУ",
"value": "86726491"
},
"name": "ТОВ \"ТЕСТ 5\"",
"roleCode": "WH",
"specifiedGovernmentRegistrations": [
{
"id": "9864065748137",
"typeCode": "TRADEPARTY_GLN"
}
]
},
"carrierTradeParty": {
"id": {
"schemeAgencyID": "ЄДРПОУ",
"value": "56543433"
},
"name": "ТОВ \"ТЕСТ 3\"",
"roleCode": "CA",
"tradeContact": {
"personName": "Петренко Петро Петрович",
"telephoneUniversalCommunication": {
"completeNumber": "0443332211"
},
"mobileTelephoneUniversalCommunication": {
"completeNumber": "0933332211"
},
"emailURIUniversalCommunication": {
"completeNumber": "ivan@yahoo.com"
}
},
"postalTradeAddress": {
"postCode": "01001",
"streetName": "вул.Хрещатик, 23",
"cityName": "Київ",
"countryID": "UA"
},
"taxRegistration": {
"id": "1234567890"
},
"specifiedGovernmentRegistrations": [
{
"id": "9864065748120",
"typeCode": "TRADEPARTY_GLN"
}
]
},
"storageLogisticsLocation": {
"id": {
"schemeAgencyID": "КАТОТТГ",
"value": "UA18040190010057814"
},
"name": "Склад в Житомирі",
"description": "79000, м.Житомир, вул. Гусака, 1"
},
"utilizedLogisticsTransportEquipment": [
{
"id": "АА2525ВВ",
"applicableNotes": [
{
"contentCode": "BRAND",
"content": "VOLVO"
},
{
"contentCode": "MODEL",
"content": "КЕ-578"
}
]
}
],
"pickupTransportEvent": {
"certifyingTradeParties": [
{
"id": {
"schemeAgencyID": "РНОКПП",
"value": "1010101013"
},
"name": "Водій",
"roleCode": "DR",
"tradeContact": {
"personName": "Петренко Петро Петрович"
}
}
]
},
"storageNotes": "Потрібно доставити вантаж отримувачу"
},
"certifyingPartyPayload": {
"certifyingTradeParty": [
{
"id": {
"schemeAgencyID": "РНОКПП",
"value": "4444444400"
},
"name": "Директор",
"roleCode": "WH",
"tradeContact": {
"personName": "Іванов Іван Іванович"
}
},
{
"id": {
"schemeAgencyID": "РНОКПП",
"value": "1010101013"
},
"name": "Директор",
"roleCode": "DR",
"tradeContact": {
"personName": "Петренко Петро Петрович"
}
}
]
}
}
}