Акт коригування
Зверніть увагу, поля в json та в xml форматі відрізняються!
Опис полів XML
| № з/п |
Параметр1 |
Тип2 |
Формат |
Опис |
|
UAECMR_ACT |
M |
|
Початок документа |
| I |
ACT |
M |
|
(початок змісту документа) |
| 1 |
ExchangedDocumentContext |
M |
|
Технічні дані |
| 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 (2021-12-13T14:19:23+02:00) |
Дата і час складання Акта |
| 2.3 |
ram:Remarks |
O |
string |
Інші примітки |
| 2.4 |
ram:IncludedNote |
O |
|
Номер товарно-транспортної накладної, до якої складається акт. Номер документа-підстави (ТТН); має відповідати номеру документа ExchangedDocument.ID еТТН |
| 2.4.1 |
ram:ContentCode |
O |
string |
Ідентифікатор:
* ttnNumber (номер ТТН)
|
2.4.2
ram:Content
O
string
Значення ідентифікатора (ttnNumber)
2.4.3
ram:ContentCode.listAgencyID
O
String
Ідентифікатор:
- transportation_max_temperature
(Максимальна температура під час перевезення)
- logger_return
(Повернення логера)
- logistic_unit_number_with_logger
(Номер логістичної одиниці з термологером)
- gps_number
(Номер GPS)
- logger_number
(Номер термологера)
- comment
(Коментар)
- reserve_number
(Номер резерву)
- vehicle_length
(сплюсована довжина транспортного засобу / автопоїзда в метрах (число))
- vehicle_width
(максимальна ширина транспортного засобу / автопоїзда в метрах (число))
- vehicle_height
(максимальна висота транспортного засобу / автопоїзда в метрах (число))
- gross_vehicle_weight_with_cargo (загальна маса транспортного засобу / автопоїзда з вантажем в кілограмах (число))
- vehicle_storage_address (Місце, де зберігається автомобіль)
2.4.23.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
OM
string
ЗначенняКод ідентифікатораролі (ttnNumber)учасника: залишається роль, яка була вказана у документі ТТН.
2.4.3
transportation_max_temperature
O
Максимальна температура під час перевезення
2.4.4
logger_return
O
Повернення логера
2.4.5
logistic_unit_number_with_logger
O
Номер логістичної одиниці з термологером
2.4.6
gps_number
O
Номер GPS
2.4.7
logger_number
O
Номер термологера
2.4.8
comment
O
Коментар
2.4.9
reserve_number
O
Номер резерву
2.4.10
vehicle_length
O
Cплюсована довжина транспортного засобу / автопоїзда в метрах
2.4.11
vehicle_width
O
Максимальна ширина транспортного засобу / автопоїзда в метрах
2.4.12
vehicle_height vehicle_height
O
Максимальна висота транспортного засобу / автопоїзда в метрах
2.4.13
gross_vehicle_weight_with_cargo
Загальна маса транспортного засобу / автопоїзда з вантажем в кілограмах
2.5.1
ram:IssueLogisticsLocation.ram:Name
M
string
Можливе тільки одне значення "Місце складання документу"
2.5.2
ram:IssueLogisticsLocation.ram:Description
M
string
Опис (адреса) місця складання Акта
3
AdjustmentActPayload
M
Зміст «Акта коригування»
3.1
PreviousAdministrativeReferencedDocument (TypeCode=730)
M
Інформація про е-ТТН, для якої складається акт
3.1.1
ram:TypeCode
M
decimal
Тип документа (730 - ТТН). Довідник кодів документів
3.1.2
ram:ID
M
string
Унікальний ідентифікатор (UUID) ТТН з ЦБД
3.1.3.1
ram:FormattedIssueDateTime.qdt:DateTimeString
M
datetime (2021-12-13T14:19:23+02:00)
Дата та час документа-підстави (ТТН); має відповідати даті документа ExchangedDocument.IssueDateTime еТТН
3.1.4
ram:AttachedSpecifiedBinaryFile
M
Дані е-ТТН, для якої складається акт
3.1.4.1
ram:ID
M
string
Ідентифікатор (guid) документа-підстави (ТТН); має відповідати document.id еТТН в ЦБД (значення ettnId з методу Отримання списку подій з ЦБД = значення external_doc_id Отримання мета-даних документа)
3.1.4.2
ram:URIID
O
string
посилання на документ
3.1.4.3
ram:MIMECode
O
string
MIME типізація
3.1.4.4
ram:SizeMeasure
O
long
розмір файлу в байтах
3.2
PreviousAdministrativeReferencedDocument
-/M
Інформація про попередній акт, у випадку наступної транзакції
3.2.1
ram:TypeCode
M
decimal
Тип документа. Довідник кодів документів
3.2.2
ram:ID
M
string
Номер документа-підстави (Акт); має відповідати номеру документа ExchangedDocument.ID Акта
3.2.3.1
ram:FormattedIssueDateTime.qdt:DateTimeString
M
datetime (2021-12-13T14:19:23+02:00)
Дата та час документа-підстави (Акта)
3.3
InitiatorTradeParty
M
Ініціатор акта (Замовник). Тут наведено приклад, коли ініціатором Акта є Замовник (який не є ні Вантажовідправником, ні Вантажоодержувачем) - в документа буде чотири сторони-підписувачі: Замовник, Вантажовідправник, Перевізник та Вантажоодержувач
3.3.1.1
ram:ID.schemeAgencyID
M
string
"ЄДРПОУ"/"РНОКПП"/"ПАСПОРТ" Замовника
3.3.1.2
ram:ID.value
M
string
Значення
3.3.2
ram:Name
M
string
Повне найменування Замовника (юридичної особи або ПІБ фізичної-особи підприємця), що проводить одержання (оприбуткування) перелічених в ТТН товарно-матеріальних цінностей
3.3.3
ram:RoleCode
M
string
Роль учасника (Замовник - OB). Довідник ролей
3.3.4
ram:DefinedTradeContact
O
Контакти відповідального представника
3.3.4.1
ram:PersonName
O
string
ПІБ
3.3.4.2.1
ram:TelephoneUniversalCommunication.ram:CompleteNumber
O
string
Основний телефон
3.3.4.3.1
ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber
O
string
Мобільний телефон
3.3.4.4.1
ram:EmailURIUniversalCommunication.ram:CompleteNumber
O
string
Електронна адреса
3.3.5
ram:PostalTradeAddress
O
Юридична адреса Замовника (правила заповнення адрес у Акті знаходиться за за посиланням)
3.3.5.1
ram:PostcodeCode
O
string
Індекс
3.3.5.2
ram:StreetName
M
string
Адреса (назва вулиці + номер будівлі)
3.3.5.3
ram:CityName
M
string
Місто (назва населеного пункту)
3.3.5.4
ram:CountryID
M
string
Країна (UA)
3.3.5.5
ram:CountrySubDivisionName
O
string
Область та район (за наявності)
3.3.6.1
ram:SpecifiedTaxRegistration.ram:ID
O
string
РНОКПП відповідальної особи
3.3.7
ram:SpecifiedGovernmentRegistration
M/O
GLN Замовника (блок обов'язковий до заповнення для відправника транзакції)
3.3.7.1
ram:ID
M/O
decimal
GLN Замовника (поле обов'язкове до заповнення для відправника транзакції)
3.3.7.2
ram:TypeCode
O
string
Код типу:
* TRADEPARTY_GLN
3.3.7.3
ram:ID
O
string
Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.3.7.4
ram:TypeCode
O
string
TRADEPARTY_UNZR
3.4
ConsignorTradeParty
M
Вантажовідправник
3.4.1.1
ram:ID.schemeAgencyID
M
string
"ЄДРПОУ"/"РНОКПП"/"ПАСПОРТ" Вантажовідправника
3.4.1.2
ram:ID.value
M
string
Значення
3.4.2
ram:Name
M
string
Повне найменування Вантажовідправника (юридичної особи або ПІБ фізичної-особи підприємця), що проводить відвантаження (списання) перелічених в ТТН товарно-матеріальних цінностей
3.4.3
ram:RoleCode
M
string
Роль учасника (Вантажовідправник - CZ). Довідник ролей
3.4.4
ram:DefinedTradeContact
O
Контакти відповідального представника
3.4.4.1
ram:PersonName
O
string
ПІБ
3.4.4.2.1
ram:TelephoneUniversalCommunication.ram:CompleteNumber
O
string
Основний телефон
3.4.4.3.1
ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber
O
string
Мобільний телефон
3.4.4.4.1
ram:EmailURIUniversalCommunication.ram:CompleteNumber
O
string
Електронна адреса
3.4.5
ram:PostalTradeAddress
O
Юридична адреса Вантажовідправника (правила заповнення адрес у Акті знаходиться за за посиланням)
3.4.5.1
ram:PostcodeCode
O
string
Індекс
3.4.5.2
ram:StreetName
M
string
Адреса (назва вулиці + номер будівлі)
3.4.5.3
ram:CityName
M
string
Місто (назва населеного пункту)
3.4.5.4
ram:CountryID
M
string
Країна (UA)
3.4.5.5
ram:CountrySubDivisionName
O
string
Область та район (за наявності)
3.4.6.1
ram:SpecifiedTaxRegistration.ram:ID
O
string
РНОКПП відповідальної особи
3.4.7
ram:SpecifiedGovernmentRegistration
M/O
GLN Вантажовідправника (блок обов'язковий до заповнення для відправника транзакції)
3.4.7.1
ram:ID
M/O
decimal
GLN Вантажовідправника (поле обов'язкове до заповнення для відправника транзакції)
3.4.7.2
ram:TypeCode
O
string
Код типу:
* TRADEPARTY_GLN
3.4.7.3
ram:ID
O
string
Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.4.7.4
ram:TypeCode
O
string
TRADEPARTY_UNZR
3.5
CarrierTradeParty
M
Перевізник
3.5.1.1
ram:ID.schemeAgencyID
M
string
"ЄДРПОУ"/"РНОКПП"/"ПАСПОРТ" Перевізника
3.5.1.2
ram:ID.value
M
string
Значення
3.5.2
ram:Name
M
string
Повне найменування Перевізника (юридичної особи або фізичної особи - підприємця) або прізвище, ім’я, по батькові фізичної особи, з яким вантажовідправник уклав договір на надання транспортних послуг
3.5.3
ram:RoleCode
M
string
Роль учасника (Перевізник - CA). Довідник ролей
3.5.4
ram:DefinedTradeContact
M
Контакти відповідального представника
3.5.4.1
ram:PersonName
M
string
ПІБ водія, що керуватиме ТЗ при перевезенні вантажу
3.5.4.2.1
ram:TelephoneUniversalCommunication.ram:CompleteNumber
O
string
Основний телефон
3.5.4.3.1
ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber
O
string
Мобільний телефон
3.5.4.4.1
ram:EmailURIUniversalCommunication.ram:CompleteNumber
O
string
Електронна адреса
3.5.5
ram:PostalTradeAddress
O
Юридична адреса Перевізника (правила заповнення адрес у Акті знаходиться за за посиланням)
3.5.5.1
ram:PostcodeCode
O
string
Індекс
3.5.5.2
ram:StreetName
M
string
Адреса (назва вулиці + номер будівлі)
3.5.5.3
ram:CityName
M
string
Місто (назва населеного пункту)
3.5.5.4
ram:CountryID
M
string
Країна (UA)
3.5.5.5
ram:CountrySubDivisionName
O
string
Область та район (за наявності)
3.5.6.1
ram:SpecifiedTaxRegistration.ram:ID
M
string
РНОКПП відповідальної особи (водія)
3.5.7
ram:SpecifiedGovernmentRegistration
M
Посвідчення Водія / GLN Водія / GLN Перевізника
3.5.7.1
ram:ID
M/O
* string
* decimal при ram:TypeCode=DRIVER_GLN / TRADEPARTY_GLN
* Серія та номер водійського посвідчення Водія (поле обов'язкове до заповнення). Заповнюється в форматі «3 заголовні кириличні літери + 6 цифр без пробілів», наприклад: DGJ123456, АБВ123456
* для ram:TypeCode=DRIVER_GLN - GLN Водія (поле опціональне до заповнення)
* для ram:TypeCode=TRADEPARTY_GLN - GLN Перевізника (поле обов'язкове до заповнення для відправника транзакції)
3.5.7.2
ram:TypeCode
O
string
Код типу:
* DRIVER_GLN
* TRADEPARTY_GLN
3.5.7.3
ram:ID
O
string
Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.5.7.4
ram:TypeCode
O
string
TRADEPARTY_UNZR
3.5.7.5
ram:ID
O
string
Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.5.7.6
ram:TypeCode
O
string
DRIVER_UNZR
3.6
ConsigneeTradeParty
O
Новий Вантажоодержувач
3.6.1.1
ram:ID.schemeAgencyID
M
string
"ЄДРПОУ"/"РНОКПП"/"ПАСПОРТ" Вантажоодержувача
3.6.1.2
ram:ID.value
M
string
Значення
3.6.2
ram:Name
M
string
Повне найменування Вантажоодержувача
3.6.3
ram:RoleCode
M
string
Роль учасника (Вантажоодержувач - CN). Довідник ролей
3.6.4
ram:DefinedTradeContact
O
Контакти відповідального представника
3.6.4.1
ram:PersonName
O
string
ПІБ
3.6.4.2.1
ram:TelephoneUniversalCommunication.ram:CompleteNumber
O
string
Основний телефон
3.6.4.3.1
ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber
O
string
Мобільний телефон
3.6.4.4.1
ram:EmailURIUniversalCommunication.ram:CompleteNumber
O
string
Електронна адреса
3.6.5
ram:PostalTradeAddress
O
Юридична адреса Вантажоодержувача (юридична адреса юридичної особи або адреса реєстрації фізичної особи-підприємця) (правила заповнення адрес у Акті знаходиться за за посиланням)
3.6.5.1
ram:PostcodeCode
O
string
Індекс
3.6.5.2
ram:StreetName
M
string
Адреса (назва вулиці + номер будівлі)
3.6.5.3
ram:CityName
M
string
Місто (назва населеного пункту)
3.6.5.4
ram:CountryID
M
string
Країна (UA)
3.6.5.5
ram:CountrySubDivisionName
O
string
Область та район (за наявності)
3.6.6.1
ram:SpecifiedTaxRegistration.ram:ID
O
string
РНОКПП відповідальної особи Вантажоодержувача
3.6.7
ram:SpecifiedGovernmentRegistration
M
GLN Вантажоодержувача
3.6.7.1
ram:ID
M/O
decimal
GLN Вантажоодержувача (поле обов’язкове до заповнення для відправника транзакції)
3.6.7.2
ram:TypeCode
O
string
Код типу: TRADEPARTY_GLN
3.6.7.3
ram:ID
O
string
Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.6.7.4
ram:TypeCode
O
string
TRADEPARTY_UNZR
3.7
AdjustedSupplyChainConsignment
M
Таблиця коригувань
3.7.1
ram:ConsignorTradeParty
O
Вантажовідправник
3.7.1.1
ram:Name
M
string
Повне найменування Вантажовідправника (юридичної особи або ПІБ фізичної-особи підприємця), що проводить відвантаження (списання) перелічених в ТТН товарно-матеріальних цінностей
3.7.1.2
ram:DefinedTradeContact
O
Контакти відповідального представника
3.7.1.2.1
ram:PersonName
O
string
ПІБ
3.7.1.2.2.1
ram:TelephoneUniversalCommunication.ram:CompleteNumber
O
string
Основний телефон
3.7.1.2.3.1
ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber
O
string
Мобільний телефон
3.7.1.2.4.1
ram:EmailURIUniversalCommunication.ram:CompleteNumber
O
string
Електронна адреса
3.7.1.3
ram:PostalTradeAddress
O
Юридична адреса Вантажовідправника (правила заповнення адрес у Акті знаходиться за за посиланням)
3.7.1.3.1
ram:PostcodeCode
O
string
Індекс
3.7.1.3.2
ram:StreetName
M
string
Адреса (назва вулиці + номер будівлі)
3.7.1.3.3
ram:CityName
M
string
Місто (назва населеного пункту)
3.7.1.3.4
ram:CountryID
M
string
Країна (UA)
3.7.1.3.5
ram:CountrySubDivisionName
O
string
Область та район (за наявності)
3.7.1.4.1
ram:SpecifiedGovernmentRegistration.ram:ID
M/O
decimal
GLN Вантажовідправника (поле обов’язкове до заповнення для відправника транзакції)
3.7.1.4.2
ram:SpecifiedGovernmentRegistration.typeCode
O
string
Код типу:
TRADEPARTY_GLN
3.7.2
ram:ConsigneeTradeParty
O
Вантажоодержувач
3.7.2.1
ram:Name
M
string
Повне найменування Вантажоодержувача (юридичної особи або ПІБ фізичної-особи підприємця), що проводить одержання (оприбуткування) перелічених в ТТН товарно-матеріальних цінностей
3.7.2.2
ram:DefinedTradeContact
O
Контакти відповідального представника
3.7.2.2.1
ram:PersonName
O
string
ПІБ
3.7.2.2.2.1
ram:TelephoneUniversalCommunication.ram:CompleteNumber
O
string
Основний телефон
3.7.2.2.3.1
ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber
O
string
Мобільний телефон
3.7.2.2.4.1
ram:EmailURIUniversalCommunication.ram:CompleteNumber
O
string
Електронна адреса
3.7.2.3
ram:PostalTradeAddress
O
Юридична адреса Вантажоодержувача (правила заповнення адрес у Акті знаходиться за за посиланням)
3.7.2.3.1
ram:PostcodeCode
O
string
Індекс
3.7.2.3.2
ram:StreetName
M
string
Адреса (назва вулиці + номер будівлі)
3.7.2.3.3
ram:CityName
M
string
Місто (назва населеного пункту)
3.7.2.3.4
ram:CountryID
M
string
Країна (UA)
3.7.2.3.5
ram:CountrySubDivisionName
O
string
Область та район (за наявності)
3.7.2.4.1
ram:SpecifiedGovernmentRegistration.ram:ID
M/O
decimal
GLN Вантажоодержувача (поле обов’язкове до заповнення для відправника транзакції)
3.7.2.4.2
ram:SpecifiedGovernmentRegistration.typeCode
O
string
Код типу:
TRADEPARTY_GLN
3.7.3
ram:CarrierTradeParty
O
Перевізник
3.7.3.1
ram:Name
M
string
Повне найменування Перевізника (юридичної особи або фізичної особи - підприємця) або прізвище, ім’я, по батькові фізичної особи, з яким вантажовідправник уклав договір на надання транспортних послуг
3.7.3.2
ram:DefinedTradeContact
O
Контакти відповідального представника
3.7.3.2.1
ram:PersonName
M
string
ПІБ водія, що керуватиме ТЗ при перевезенні вантажу
3.7.3.2.2.1
ram:TelephoneUniversalCommunication.ram:CompleteNumber
O
string
Основний телефон
3.7.3.2.3.1
ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber
O
string
Мобільний телефон
3.7.3.2.4.1
ram:EmailURIUniversalCommunication.ram:CompleteNumber
O
string
Електронна адреса
3.7.3.3
ram:PostalTradeAddress
O
Юридична адреса Перевізника (правила заповнення адрес у Акті знаходиться за за посиланням)
3.7.3.3.1
ram:PostcodeCode
O
string
Індекс
3.7.3.3.2
ram:StreetName
M
string
Адреса (назва вулиці + номер будівлі)
3.7.3.3.3
ram:CityName
M
string
Місто (назва населеного пункту)
3.7.3.3.4
ram:CountryID
M
string
Країна (UA)
3.7.3.3.5
ram:CountrySubDivisionName
O
string
Область та район (за наявності)
3.7.3.4.1
ram:SpecifiedGovernmentRegistration.ram:ID
M/O
* string
* decimal при ram:TypeCode=DRIVER_GLN / TRADEPARTY_GLN
Серія та номер водійського посвідчення Водія (поле обов’язкове до заповнення). Заповнюється в форматі «3 заголовні кириличні літери + 6 цифр без пробілів», наприклад: DGJ123456, АБВ123456
для typeCode=DRIVER_GLN - GLN Водія (поле опціональне до заповнення)
для typeCode=TRADEPARTY_GLN - GLN Перевізника (поле обов’язкове до заповнення для відправника транзакції)
3.7.3.4.2
ram:SpecifiedGovernmentRegistration.typeCode
O
string
Код типу:
DRIVER_GLN
TRADEPARTY_GLN
3.7.4
ram:NotifiedTradeParty (роль - FW)
O
Експедитор
3.7.4.1.1
ram:ID.schemeAgencyID
M
string
ЄДРПОУ / РНОКПП Експедитора
3.7.4.1.2
ram:ID.value
M
string
Значення
3.7.4.2
ram:Name
M
string
Повне найменування Експедитора (юридичної особи або фізичної особи - підприємця) або прізвище, ім’я, по батькові фізичної особи, з яким вантажовідправник (замовник) уклав договір траспортного експедирування
3.7.4.3
ram:RoleCode
M
string
Роль учасника (Експедитор - FW). Довідник ролей
3.7.4.4
ram:DefinedTradeContact
O
Контакти відповідального представника
3.7.4.4.1
ram:PersonName
O
string
ПІБ
3.7.4.4.2.1
ram:TelephoneUniversalCommunication.ram:CompleteNumber
O
string
Основний телефон
3.7.4.4.3.1
ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber
O
string
Мобільний телефон
3.7.4.4.4.1
ram:EmailURIUniversalCommunication.ram:CompleteNumber
O
string
Електронна адреса
3.7.4.5
ram:PostalTradeAddress
O
Юридична адреса Експедитора (правила заповнення адрес у Акті знаходиться за за посиланням)
3.7.4.5.1
ram:PostcodeCode
O
string
Індекс
3.7.4.5.2
ram:StreetName
M
string
Адреса (назва вулиці + номер будівлі)
3.7.4.5.3
ram:CityName
M
string
Місто (назва населеного пункту)
3.7.4.5.4
ram:CountryID
M
string
Країна (UA)
3.7.4.5.5
ram:CountrySubDivisionName
O
string
Область та район (за наявності)
3.7.4.6.1
ram:SpecifiedTaxRegistration.ram:ID
O
string
РНОКПП відповідальної особи
3.7.4.7.1
ram:SpecifiedGovernmentRegistration.ram:ID
M/O
decimal
GLN Експедитора (поле обов’язкове до заповнення для відправника транзакції)
3.7.4.7.2
ram:SpecifiedGovernmentRegistration.typeCode
O
string
Код типу:
TRADEPARTY_GLN
3.7.5
ram:NotifiedTradeParty (роль - OB)
O
Замовник
3.7.5.1.1
ram:ID.schemeAgencyID
M
string
ЄДРПОУ / РНОКПП Замовника
3.7.5.1.2
ram:ID.value
M
string
Значення
3.7.5.2
ram:Name
M
string
Повне найменування Замовника (юридичної особи або фізичної особи - підприємця) або прізвище, ім’я, по батькові фізичної особи, що проводить оплату транспортної роботи і послуг
3.7.5.3
ram:RoleCode
M
string
Роль учасника (Замовник - OB). Довідник ролей
3.7.5.4
ram:DefinedTradeContact
O
Контакти відповідального представника
3.7.5.4.1
ram:PersonName
O
string
ПІБ
3.7.5.4.2.1
ram:TelephoneUniversalCommunication.ram:CompleteNumber
O
string
Основний телефон
3.7.5.4.3.1
ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber
O
string
Мобільний телефон
3.7.5.4.4.1
ram:EmailURIUniversalCommunication.ram:CompleteNumber
O
string
Електронна адреса
3.7.5.5
ram:PostalTradeAddress
O
Юридична адреса Замовника (правила заповнення адрес у Акті знаходиться за за посиланням)
3.7.5.5.1
ram:PostcodeCode
O
string
Індекс
3.7.5.5.2
ram:StreetName
M
string
Адреса (назва вулиці + номер будівлі)
3.7.5.5.3
ram:CityName
M
string
Місто (назва населеного пункту)
3.7.5.5.4
ram:CountryID
M
string
Країна (UA)
3.7.5.5.5
ram:CountrySubDivisionName
O
string
Область та район (за наявності)
3.7.5.6.1
ram:SpecifiedTaxRegistration.ram:ID
O
string
РНОКПП відповідальної особи
3.7.5.7.1
ram:SpecifiedGovernmentRegistration.ram:ID
M/O
decimal
GLN Замовника (поле обов’язкове до заповнення для відправника транзакції)
3.7.5.7.2
ram:SpecifiedGovernmentRegistration.typeCode
O
string
Код типу:
TRADEPARTY_GLN
3.7.6
ram:NotifiedTradeParty (роль - WD)
O
Проміжний склад
3.7.6.1.1
ram:ID.schemeAgencyID
M
string
ЄДРПОУ / РНОКПП Проміжного складу
3.7.6.1.2
ram:ID.value
M
string
Значення
3.7.6.2
ram:Name
M
string
Повне найменування Проміжного складу (Вантажовідправник/Перевізник/Експедитор/Вантажоодержувач/Товарний склад), що приймає від Перевізника на тимчасове зберігання вантаж
3.7.6.3
ram:RoleCode
M
string
Роль учасника (Проміжний склад - WD). Довідник ролей
3.7.6.4
ram:DefinedTradeContact
O
Контакти відповідального представника
3.7.6.4.1
ram:PersonName
O
string
ПІБ
3.7.6.4.2.1
ram:TelephoneUniversalCommunication.ram:CompleteNumber
O
string
Основний телефон
3.7.6.4.3.1
ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber
O
string
Мобільний телефон
3.7.6.4.4.1
ram:EmailURIUniversalCommunication.ram:CompleteNumber
O
string
Електронна адреса
3.7.6.5
ram:PostalTradeAddress
O
Юридична адреса Проміжного складу (правила заповнення адрес у Акті знаходиться за за посиланням)
3.7.6.5.1
ram:PostcodeCode
O
string
Індекс
3.7.6.5.2
ram:StreetName
M
string
Адреса (назва вулиці + номер будівлі)
3.7.6.5.3
ram:CityName
M
string
Місто (назва населеного пункту)
3.7.6.5.4
ram:CountryID
M
string
Країна (UA)
3.7.6.5.5
ram:CountrySubDivisionName
O
string
Область та район (за наявності)
3.7.6.6.1
ram:SpecifiedTaxRegistration.ram:ID
O
string
РНОКПП відповідальної особи
3.7.6.7.1
ram:SpecifiedGovernmentRegistration.ram:ID
M/O
decimal
GLN Проміжного складу (поле обов’язкове до заповнення для відправника транзакції)
3.7.6.7.2
ram:SpecifiedGovernmentRegistration.typeCode
O
string
Код типу:
TRADEPARTY_GLN
3.7.7
ram:NotifiedTradeParty (роль - COP)
O
Охоронна компанія
3.7.7.1.1
ram:ID.schemeAgencyID
M
string
ЄДРПОУ / РНОКПП Охоронної компанії
3.7.7.1.2
ram:ID.value
M
string
Значення
3.7.7.2
ram:Name
M
string
Повне найменування Охоронної компанії, що надає охоронні послуги вантажу під час перевезення
3.7.7.3
ram:RoleCode
M
string
Роль учасника (Охоронна компанія - COP). Довідник ролей
3.7.7.4
ram:DefinedTradeContact
O
Контакти відповідального представника
3.7.7.4.1
ram:PersonName
O
string
ПІБ представника Замовника, який уповноважений супроводжувати вантаж, що підлягає спеціальній охороні
3.7.8
ram:CarrierAcceptanceLogisticsLocation
O
Пункт навантаження
3.7.8.1.1
ram:ID.schemeAgencyID
M
string
КАТОТТГ пункту навантаження
3.7.8.1.2
ram:ID.value
M
string
Значення
3.7.8.2
ram:Name
M
string
Найменування пункту навантаження
3.7.8.3
ram:TypeCode
M
decimal
Тип операції: 10 - навантаження; 5 - розвантаження
3.7.8.4
ram:Description
M
string
Опис (адреса) пункту навантаження
3.7.8.5
ram:PhysicalGeographicalCoordinate
M
Географічні координати
3.7.8.5.1
ram:LatitudeMeasure
O
string
Географічні координати (Широта)
3.7.8.5.2
ram:LongitudeMeasure
O
string
Географічні координати (Довгота)
3.7.8.5.3.1
ram:SystemID.schemeAgencyID
M
string
GLN
3.7.8.5.3.2
ram:SystemID.value
M
decimal
Значення
3.7.9
ram:ConsigneeReceiptLogisticsLocation
O
Пункт розвантаження
3.7.9.1.1
ram:ID.schemeAgencyID
M
string
КАТОТТГ пункту розвантаження
3.7.9.1.2
ram:ID.value
M
string
Значення
3.7.9.2
ram:Name
M
string
Найменування пункту розвантаження
3.7.9.3
ram:TypeCode
M
decimal
Тип операції: 10 - навантаження; 5 - розвантаження
3.7.9.4
ram:Description
M
string
Опис (адреса) пункту розвантаження
3.7.9.5
ram:PhysicalGeographicalCoordinate
M
Географічні координати
3.7.9.5.1
ram:LatitudeMeasure
O
string
Географічні координати (Широта)
3.7.9.5.2
ram:LongitudeMeasure
O
string
Географічні координати (Довгота)
3.7.9.5.3.1
ram:SystemID.schemeAgencyID
M
string
GLN
3.7.9.5.3.2
ram:SystemID.value
M
decimal
Значення
3.7.10
ram:DeliveryTransportEvent
O
Розвантажувальні роботи
3.7.10.1
ram:ID
O
string
Порядковий номер події (події завжди нумеруються в порядку поступового зростання за принципом N+1)
3.7.10.2
ram:TypeCode
O
decimal
Тип операції (розвантаження=5, завантаження=10)
3.7.10.3
ram:Description
O
string
Опис
3.7.10.4.1
ram:ActualOccurrenceDateTime.udt:DateTime
O
datetime (2021-12-13T14:19:23+02:00)
Дата та час прибуття автомобіля на розвантаження
3.7.10.5.1
ram:ScheduledOccurrenceDateTime.udt:DateTime
O
datetime (2021-12-13T14:19:23+02:00)
Дата та час вибуття автомобіля з-під розвантаження
3.7.10.6.1
ram:ApplicableNote (з кодом DOWNTIME).ram:ContentCode
O
string
Код DOWNTIME
3.7.10.6.2
ram:ApplicableNote (з кодом DOWNTIME).ram:Content
O
unsignedByte
Час (години) простою під розвантаженням
3.7.11
ram:PickUpTransportEvent
M
Навантажувальні роботи
3.7.11.1
ram:ID
O
string
Порядковий номер події (події завжди нумеруються в порядку поступового зростання за принципом N+1)
3.7.11.2
ram:TypeCode
O
decimal
Тип операції (розвантаження=5, завантаження=10)
3.7.11.3
ram:Description
O
string
Опис
3.7.11.4.1
ram:ActualOccurrenceDateTime.udt:DateTime
O
datetime (2021-12-13T14:19:23+02:00)
Дата та час прибуття автомобіля під навантаження
3.7.11.5.1
ram:ScheduledOccurrenceDateTime.udt:DateTime
O
datetime (2021-12-13T14:19:23+02:00)
Дата та час вибуття автомобіля з-під навантаження
3.7.11.6.1
ram:ApplicableNote (з кодом DOWNTIME).ram:ContentCode
O
string
Код DOWNTIME
3.7.11.6.2
ram:ApplicableNote (з кодом DOWNTIME).ram:Content
O
unsignedByte
Час простою
3.7.12
ram:IncludedSupplyChainConsignmentItem
O
Відомості про вантаж
3.7.12.1.1
ram:GlobalID.schemeAgencyID
O
string (min 4 - max 10)
УКТЗЕД (код продукції)
3.7.12.1.2
ram:GlobalID.value
O
string
Значення
3.7.12.2.1
ram:NatureIdentificationTransportCargo.ram:Identification
O
string
Найменування вантажу
3.7.12.3.1
ram:ApplicableTransportDangerousGoods.ram:UNDGIdentificationCode
O
decimal
Клас небезпечних речовин, до якого віднесено вантаж (у разі перевезення небезпечних вантажів). Код UNDG, 0 - якщо не використовується
3.7.12.4.1
ram:AssociatedReferencedDocument.ram:TypeCode
O
decimal
Тип:
* код 150 - Накладна на переміщення (COMDOC_022)
* код 220 - Замовлення (ORDER)
* код 290 - Право на предʼявлення претензії
* код 335 - Заявка на транспортування (TRANSPORTATIONORDER/SUBDOCTYPE=1)
* код 350 - Акт приймання-передачі (DOCUMENTINVOICE з DocumentFunctionCode=APP)
* код 351 - Повідомлення про відвантаження (DESADV)
* код 361 - Цінова накладна (DOCUMENTINVOICE з DocumentFunctionCode=PRN)
* код 362 - Накладна за кількістю (DOCUMENTINVOICE з DocumentFunctionCode=TN)
* код 395 - Товарна накладна (COMDOC_027)
* код 441 - Маршрутний лист / рейс
* код 538 - Декларація виробника
* код 730 - Товарно-транспортна накладна (ТТН)
* код 770 - Підтвердження заявки на транспортування (TRANSPORTATIONORDER/SUBDOCTYPE=2)
(+довідник кодів документів МІУ )
3.7.12.4.2
ram:AssociatedReferencedDocument.ram:ID
O
string
Документи з вантажем. Номер документа, який водій отримує від вантажовідправника і передає вантажоодержувачеві разом з вантажем (товарні, залізничні накладні, сертифікати, свідоцтва тощо)
3.7.12.4.3
ram:AssociatedReferencedDocument.ram:Remarks
O
string
UUID супровідного документа
3.7.12.4.4
ram:AssociatedReferencedDocument.ram:FormattedIssueDateTime.qdt:DateTimeString
O
datetime
(2021-12-13T14:19:23+02:00)
Дата та час складання супровідного документа
3.7.12.5
ram:TransportLogisticsPackage
O
Транспортно-логістичний пакет. ВАЖЛИВО: в Україні дозволяється лише один LogisticsPackage для одного ConsignmentItem!
3.7.12.5.1
ram:ItemQuantity
O
decimal
Кількість місць, які визначаються за кожним найменуванням вантажу (це можуть бути ящики, кошики, мішки тощо; якщо вантаж упаковано на піддонах - вказують кількість піддонів)
3.7.12.5.2
ram:TypeCode
O
string
Вид пакування (Довідник видів упаковок)
3.7.12.5.3
ram:Type
O
string
Одиниця виміру для itemQuantity
3.7.12.5.4
ram:PhysicalLogisticsShippingMarks
O
Маркування
3.7.12.5.4.1
ram:Marking
O
string
Назва транспортної упаковки (вільна назва), в якій перевозиться вантаж
3.7.12.5.4.2.1
ram:BarcodeLogisticsLabel.ram:ID
O
string (max 128)
Штрихкод товару
3.7.12.6.1
ram:ApplicableNote (з кодом VENDOR_CODE).ram:ContentCode
O
string
Код VENDOR_CODE
3.7.12.6.2
ram:ApplicableNote (з кодом VENDOR_CODE).ram:Content
O
string
Артикул товару
3.7.12.7.1
ram:ApplicableNote (з кодом QUANTITY).ram:ContentCode
O
string
Код QUANTITY
3.7.12.7.2
ram:ApplicableNote (з кодом QUANTITY).ram:Content
O
string
Кількість товару
3.7.12.8.1
ram:ApplicableNote (з кодом URL).ram:ContentCode
O
string
Код URL
3.7.12.8.2
ram:ApplicableNote (з кодом URL).ram:Content
O
string
В полі можливо передавати посилання на опис товару (на каталог / сайт виробника чи продавця, т.п.)
3.7.12.9.1
ram:ApplicableNote (з кодом BASE_UOM).ram:ContentCode
O
string
Код BASE_UOM
3.7.12.9.2
ram:ApplicableNote (з кодом BASE_UOM).ram:Content
O
string
Одиниця виміру кількості товару для QUANTITY
3.7.12.10.1
ram:ApplicableNote (з кодом BUYER_CODE).ram:ContentCode
O
string
Код BUYER_CODE
3.7.12.10.2
ram:ApplicableNote (з кодом BUYER_CODE).ram:Content
O
string
Артикул покупця (використовується для ідентифікації товарної позиції при прийманні)
3.7.12.11.1
ram:ApplicableNote (з кодом PRICE_WITH_VAT).ram:ContentCode
O
string
Код PRICE_WITH_VAT
3.7.12.11.2
ram:ApplicableNote (з кодом PRICE_WITH_VAT).ram:Content
O
string
Ціна за одиницю з ПДВ
3.7.12.12.1
ram:ApplicableNote (з кодом SUM_WITHOUT_VAT).ram:ContentCode
O
string
Код SUM_WITHOUT_VAT
3.7.12.12.2
ram:ApplicableNote (з кодом SUM_WITHOUT_VAT).ram:Content
O
string
Загальна сума без ПДВ
3.7.12.13.1
ram:ApplicableNote (з кодом RETURN_TARE).ram:ContentCode
O
string
Код RETURN_TARE
3.7.12.13.2
ram:ApplicableNote (з кодом RETURN_TARE).ram:Content
O
string
Ознака «зворотня тара»
3.7.12.14.1
ram:ApplicableNote (з кодом NET_WEIGHT).ram:ContentCode
O
string
Код NET_WEIGHT
3.7.12.14.2
ram:ApplicableNote (з кодом NET_WEIGHT).ram:Content
O
string
Маса нетто
3.7.12.15.1
ram:ApplicableNote (з кодом RTP_QUANTITY).ram:ContentCode
O
string
Код RTP_QUANTITY
3.7.12.15.2
ram:ApplicableNote (з кодом RTP_QUANTITY).ram:Content
O
string
Кількість транспортної упаковки (використовується для обліку оборотної тари)
3.7.13
ram:DeliveryInstructions
O
Вид перевезень
3.7.13.1
ram:Description
O
string
Опис (вид роботи перевізника: за відрядним тарифом, за погодинним тарифом, за покілометровим тарифом, централізовані перевезення тощо)
3.7.13.2
ram:DescriptionCode
M
string
Код (TRANSPORTATION_TYPE)
3.8
InitiatorNotes
M
string
Короткий або повний опис причин складання акта (Замовник)
3.9
ConsignorNotes
O
string
Особливі відмітки / Інформація щодо незгоди зі змістом Акта (Вантажовідправник)
3.10
CarrierNotes
O
string
Особливі відмітки / Інформація щодо незгоди зі змістом Акта (Перевізник)
3.11
ConsigneeNotes
O
string
Особливі відмітки / Інформація щодо незгоди зі змістом Акта (Вантажоодержувач)
4
CertifyingPartyPayload
M
Інформація про відповідальних осіб
4.1
CertifyingTradeParty (RoleCode=ОВ)
M
Інформація про Замовника
4.1.1.1
ram:ID.schemeAgencyID
O
string
"РНОКПП"/"ПАСПОРТ"
4.1.1.2
ram:ID.value
O
decimal
Значення
4.1.2
ram:Name
M
string
Посада Замовника
4.1.3
ram:RoleCode
M
string
Роль учасника (Замовник - OB). Довідник ролей
4.1.4.1
ram:DefinedTradeContact.ram:PersonName
M
string
ПІБ Замовника
4.2
CertifyingTradeParty (RoleCode=CZ)
M
Інформація про відповідальних осіб Вантажовідправника
4.2.1.1
ram:ID.schemeAgencyID
O
string
"РНОКПП"/"ПАСПОРТ"
4.2.1.2
ram:ID.value
O
decimal
Значення
4.2.2
ram:Name
M
string
Посада відповідальної особи Вантажовідправника
4.2.3
ram:RoleCode
M
string
Роль учасника (Вантажовідправник - CZ). Довідник ролей
4.2.4.1
ram:DefinedTradeContact.ram:PersonName
M
string
ПІБ відповідальної особи Вантажовідправника
4.3
CertifyingTradeParty (RoleCode=CA)
M
Інформація про Перевізника
4.3.1.1
ram:ID.schemeAgencyID
O
string
"РНОКПП"/"ПАСПОРТ"
4.3.1.2
ram:ID.value
O
decimal
Значення
4.3.2
ram:Name
M
string
Посада Перевізника
4.3.3
ram:RoleCode
M
string
Роль учасника (Перевізник - CA). Довідник ролей
4.3.4.1
ram:DefinedTradeContact.ram:PersonName
M
string
ПІБ Перевізника
4.4
CertifyingTradeParty (RoleCode=CN)
O
Інформація про відповідальних осіб Вантажоодержувача
4.4.1.1
ram:ID.schemeAgencyID
O
string
"РНОКПП"/"ПАСПОРТ"
4.4.1.2
ram:ID.value
O
decimal
Значення
4.4.2
ram:Name
M
string
Посада відповідальної особи Вантажоодержувача
4.4.3
ram:RoleCode
M
string
Роль учасника (Вантажоодержувач - CN). Довідник ролей
4.4.4.1
ram:DefinedTradeContact.ram:PersonName
M
string
ПІБ відповідальної особи Вантажоодержувача
II
UaSignatureStorage
M
Підписи
5
Signature (SigningPartyRoleCode=OB)
M
КЕП Замовника
5.1
SigningPartyRoleCode
M
string
Роль підписанта (Замовник - OB). Довідник ролей
5.2
PartySignature
M
string
Підпис (base64 підпису p7s)
5.3
Name
M
string
ПІБ підписанта (Замовника)
5.4
Position
O
string
Посада підписанта (Замовника)
5.5.1
SpecifiedTaxRegistration.ram:ID
M
string
РНОКПП підписанта (Замовника)
6
Signature (SigningPartyRoleCode=CZ)
M
КЕП Вантажовідправника
6.1
SigningPartyRoleCode
M
string
Роль підписанта (Вантажовідправник - CZ). Довідник ролей
6.2
PartySignature
M
string
Підпис (base64 підпису p7s)
6.3
Name
M
string
ПІБ підписанта (відповідальної особи Вантажовідправника)
6.4
Position
O
string
Посада підписанта (відповідальної особи Вантажовідправника)
6.5.1
SpecifiedTaxRegistration.ram:ID
M
string
РНОКПП підписанта (відповідальної особи Вантажовідправника)
7
Signature (SigningPartyRoleCode=CA)
M
КЕП Перевізника
7.1
SigningPartyRoleCode
M
string
Роль підписанта (Перевізник - CA). Довідник ролей
7.2
PartySignature
M
string
Підпис (base64 підпису p7s)
7.3
Name
M
string
ПІБ підписанта (Перевізника)
7.4
Position
O
string
Посада підписанта (Перевізника)
7.5.1
SpecifiedTaxRegistration.ram:ID
M
string
РНОКПП підписанта (Перевізника)
8
Signature (SigningPartyRoleCode=CN)
M
КЕП Вантажоодержувача
8.1
SigningPartyRoleCode
M
string
Роль підписанта (Вантажоодержувач - CN). Довідник ролей
8.2
PartySignature
M
string
Підпис (base64 підпису p7s)
8.3
Name
M
string
ПІБ підписанта (відповідальної особи Вантажоодержувача)
8.4
Position
O
string
Посада підписанта (відповідальної особи Вантажоодержувача)
8.5.1
SpecifiedTaxRegistration.ram:ID
M
string
РНОКПП підписанта (відповідальної особи Вантажоодержувача)
[1] - елементи структури мають наступний вигляд:
- параметрЗіЗначенням;
- об’єктЗПараметрами;
- масивОб’єктів;
- жовтим фоном виділяються комірки, в яких відбувались останні зміни.
[2] - Під визначенням
колонки колонки Тип поля мається на увазі скорочене позначення:
Опис полів 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 (2021-12-13T14:19:23+02:00) |
Дата і час складання Акта |
| 2.3 |
remarks |
O |
string |
Інші примітки |
| 2.4 |
includedNote |
O |
|
Номер товарно-транспортної накладної, до якої складається акт. Номер документа-підстави (ТТН); має відповідати номеру документа ExchangedDocument.ID еТТН |
| 2.4.1 |
contentCoderam:ContentCode |
O |
string |
Ідентифікатор:
* ttnNumber ttnNumber (номер ТТН)
|
| 2.4.2 |
contentram:Content |
O |
string |
Значення ідентифікатора (ttnNumber) |
2.4.3
ram:ContentCode.listAgencyID
O
String
Ідентифікатор:
transportation_max_temperature (Максимальна температура під час перевезення)
logger_return (Повернення логера)
logistic_unit_number_with_logger (Номер логістичної одиниці з термологером)
gps_number (Номер GPS)
logger_number (Номер термологера)
comment (Коментар)
reserve_number (Номер резерву)
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
Код ролі учасника: залишається роль, яка була вказана у документі ТТН.
2.5.1
issueLogisticsLocation.name
M
string
Можливе тільки одне значення "Місце складання документу"
2.5.2
issueLogisticsLocation.description
M
string
Опис (адреса) місця складання Акта
3
adjustmentActPayload
M
Зміст «Акта коригування»
3.1
previousAdministrativeReferencedDocuments previousAdministrativeReferencedDocuments (TypeCode=730)
M
Інформація про е-ТТН, для якої складається акт
3.1.1
typeCode
M
decimal
Тип документа (730 - ТТН). Довідник кодів документів
3.1.2
id
M
string
Унікальний ідентифікатор (UUID) ТТН з ЦБД
3.1.3.1
formattedIssueDateTime.dateTime
M
datetime (2021-12-13T14:19:23+02:00)
Дата та час документа-підстави (ТТН); має відповідати даті документа ExchangedDocument.IssueDateTime еТТН
3.1.4
attachedSpecifiedBinaryFile
M
Дані е-ТТН, для якої складається акт
3.1.4.1
id
M
string
Ідентифікатор (guid) документа-підстави (ТТН); має відповідати document.id еТТН в ЦБД (значення ettnId з методу методу Отримання списку подій з ЦБД = значення external_doc_id external_doc_id Отримання мета-даних документа)
3.1.4.2
uriid
O
string
посилання на документ
3.1.4.3
MIMECode
O
string
MIME типізація
3.1.4.4
SizeMeasure
O
long
розмір файлу в байтах
3.2
previousAdministrativeReferencedDocuments
-/M
Інформація про попередній акт, у випадку наступної транзакції
3.2.1
typeCode
M
decimal
Тип документа. Довідник кодів документів
3.2.2
id
M
string
Номер документа-підстави (Акт); має відповідати номеру документа ExchangedDocument.ID Акта
3.2.3.1
formattedIssueDateTime.dateTime
M
datetime (2021-12-13T14:19:23+02:00)
Дата та час документа-підстави (Акта)
3.3
initiatorTradeParty
M
Ініціатор акта (Замовник). Тут наведено приклад, коли ініціатором Акта є Замовник (який не є ні Вантажовідправником, ні Вантажоодержувачем) - в документа буде чотири сторони-підписувачі: Замовник, Вантажовідправник, Перевізник та Вантажоодержувач
3.3.1.1
id.schemeAgencyID
M
string
"ЄДРПОУ"/"РНОКПП"/"ПАСПОРТ" Замовника
3.3.1.2
id.value
M
string
Значення
3.3.2
name
M
string
Повне найменування Замовника (юридичної особи або ПІБ фізичної-особи підприємця), що проводить одержання (оприбуткування) перелічених в ТТН товарно-матеріальних цінностей
3.3.3
roleCode
M
string
Роль учасника (Замовник - OB). Довідник ролей
3.3.4
tradeContact
O
Контакти відповідального представника
3.3.4.1
personName
O
string
ПІБ
3.3.4.2.1
telephoneUniversalCommunication.completeNumber
O
string
Основний телефон
3.3.4.3.1
mobileTelephoneUniversalCommunication.completeNumber
O
string
Мобільний телефон
3.3.4.4.1
emailURIUniversalCommunication.completeNumber
O
string
Електронна адреса
3.3.5
postalTradeAddress
O
Юридична адреса Замовника (правила заповнення адрес у Акті знаходиться за за посиланням)
3.3.5.1
postCode
O
string
Індекс
3.3.5.2
streetName
M
string
Адреса (назва вулиці + номер будівлі)
3.3.5.3
cityName
M
string
Місто (назва населеного пункту)
3.3.5.4
countryID
M
string
Країна (UA)
3.3.5.5
countrySubDivisionName
O
string
Область та район (за наявності)
3.3.6.1
taxRegistration.id
O
string
РНОКПП відповідальної особи
3.3.7
specifiedGovernmentRegistrations
M/O
GLN Замовника (блок обов'язковий до заповнення для відправника транзакції)
3.3.7.1
id
M/O
decimal
GLN Замовника (поле обов'язкове до заповнення для відправника транзакції)
3.3.7.2
typeCode
O
string
Код типу:
* TRADEPARTY_GLN
3.3.7.3
id
O
string
Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.3.7.4
typeCode
O
string
TRADEPARTY_UNZR
3.4
consignorTradeParty
M
Вантажовідправник
3.4.1.1
id.schemeAgencyID
M
string
"ЄДРПОУ"/"РНОКПП"/"ПАСПОРТ" Вантажовідправника
3.4.1.2
id.value
M
string
Значення
3.4.2
name
M
string
Повне найменування Вантажовідправника (юридичної особи або ПІБ фізичної-особи підприємця), що проводить відвантаження (списання) перелічених в ТТН товарно-матеріальних цінностей
3.4.3
roleCode
M
string
Роль учасника (Вантажовідправник - CZ). Довідник ролей
3.4.4
tradeContact
O
Контакти відповідального представника
3.4.4.1
personName
O
string
ПІБ
3.4.4.2.1
telephoneUniversalCommunication.completeNumber
O
string
Основний телефон
3.4.4.3.1
mobileTelephoneUniversalCommunication.completeNumber
O
string
Мобільний телефон
3.4.4.4.1
emailURIUniversalCommunication.completeNumber
O
string
Електронна адреса
3.4.5
postalTradeAddress
O
Юридична адреса Вантажовідправника (правила заповнення адрес у Акті знаходиться за за посиланням)
3.4.5.1
postCode
O
string
Індекс
3.4.5.2
streetName
M
string
Адреса (назва вулиці + номер будівлі)
3.4.5.3
cityName
M
string
Місто (назва населеного пункту)
3.4.5.4
countryID
M
string
Країна (UA)
3.4.5.5
countrySubDivisionName
O
string
Область та район (за наявності)
3.4.6.1
taxRegistration.id
O
string
РНОКПП відповідальної особи
3.4.7
specifiedGovernmentRegistrations
M/O
GLN Вантажовідправника (блок обов'язковий до заповнення для відправника транзакції)
3.4.7.1
id
M/O
decimal
GLN Вантажовідправника (поле обов'язкове до заповнення для відправника транзакції)
3.4.7.2
typeCode
O
string
Код типу:
* TRADEPARTY_GLN
3.4.7.3
id
O
string
Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.4.7.4
typeCode
O
string
TRADEPARTY_UNZR
3.5
carrierTradeParty
M
Перевізник
3.5.1.1
id.schemeAgencyID
M
string
"ЄДРПОУ"/"РНОКПП"/"ПАСПОРТ" Перевізника
3.5.1.2
id.value
M
string
Значення
3.5.2
name
M
string
Повне найменування Перевізника (юридичної особи або фізичної особи - підприємця) або прізвище, ім’я, по батькові фізичної особи, з яким вантажовідправник уклав договір на надання транспортних послуг
3.5.3
roleCode
M
string
Роль учасника (Перевізник - CA). Довідник ролей
3.5.4
tradeContact
M
Контакти відповідального представника
3.5.4.1
personName
M
string
ПІБ водія, що керуватиме ТЗ при перевезенні вантажу
3.5.4.2.1
telephoneUniversalCommunication.completeNumber
O
string
Основний телефон
3.5.4.3.1
mobileTelephoneUniversalCommunication.completeNumber
O
string
Мобільний телефон
3.5.4.4.1
emailURIUniversalCommunication.completeNumber
O
string
Електронна адреса
3.5.5
postalTradeAddress
O
Юридична адреса Перевізника (правила заповнення адрес у Акті знаходиться за за посиланням)
3.5.5.1
postCode
O
string
Індекс
3.5.5.2
streetName
M
string
Адреса (назва вулиці + номер будівлі)
3.5.5.3
cityName
M
string
Місто (назва населеного пункту)
3.5.5.4
countryID
M
string
Країна (UA)
3.5.5.5
countrySubDivisionName
O
string
Область та район (за наявності)
3.5.6.1
taxRegistration.id
M
string
РНОКПП відповідальної особи (водія)
3.5.7
specifiedGovernmentRegistrations
M
Посвідчення Водія / GLN Водія / GLN Перевізника
3.5.7.1
id
M/O
* string
* decimal при typeCode=DRIVER_GLN / TRADEPARTY_GLN
* Серія та номер водійського посвідчення Водія (поле обов'язкове до заповнення). Заповнюється в форматі «3 заголовні кириличні літери + 6 цифр без пробілів», наприклад: DGJ123456, АБВ123456
* для typeCode=DRIVER_GLN - GLN Водія (поле опціональне до заповнення)
* для typeCode=TRADEPARTY_GLN - GLN Перевізника (поле обов'язкове до заповнення для відправника транзакції)
3.5.7.2
typeCode
O
string
Код типу:
* DRIVER_GLN
* TRADEPARTY_GLN
3.5.7.3
id
O
string
Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.5.7.4
typeCode
O
string
TRADEPARTY_UNZR
3.5.7.5
id
O
string
Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.5.7.6
typeCode
O
string
DRIVER_UNZR
3.6
consigneeTradeParty
O
Вантажоодержувач
3.6.1.1
id.schemeAgencyID
M
string
"ЄДРПОУ"/"РНОКПП"/"ПАСПОРТ" Вантажоодержувача
3.6.1.2
id.value
M
string
Значення
3.6.2
name
M
string
Повне найменування Вантажоодержувача
3.6.3
roleCode
M
string
Роль учасника (Вантажоодержувач - CN). Довідник ролей
3.6.4
tradeContact
O
Контакти відповідального представника
3.6.4.1
personName
O
string
ПІБ
3.6.4.2.1
telephoneUniversalCommunication.completeNumber
O
string
Основний телефон
3.6.4.3.1
mobileTelephoneUniversalCommunication.completeNumber
O
string
Мобільний телефон
3.6.4.4.1
emailURIUniversalCommunication.completeNumber
O
string
Електронна адреса
3.6.5
postalTradeAddress
O
Юридична адреса Вантажоодержувача (юридична адреса юридичної особи або адреса реєстрації фізичної особи-підприємця) (правила заповнення адрес у Акті знаходиться за за посиланням)
3.6.5.1
postCode
O
string
Індекс
3.6.5.2
streetName
M
string
Адреса (назва вулиці + номер будівлі)
3.6.5.3
cityName
M
string
Місто (назва населеного пункту)
3.6.5.4
countryID
M
string
Країна (UA)
3.6.5.5
countrySubDivisionName
O
string
Область та район (за наявності)
3.6.6.1
specifiedTaxRegistration.id
O
string
РНОКПП відповідальної особи Вантажоодержувача
3.6.7
specifiedGovernmentRegistrations
M
GLN Вантажоодержувача
3.6.7.1
id
M/O
decimal
GLN Вантажоодержувача (поле обов’язкове до заповнення для відправника транзакції)
3.6.7.2
typeCode
O
string
Код типу:
TRADEPARTY_GLN
3.6.7.3
id
O
string
Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.6.7.4
typeCode
O
string
TRADEPARTY_UNZR
3.7
adjustedSupplyChainConsignment
M
Таблиця коригувань
3.7.1
consignor
O
Вантажовідправник
3.7.1.1
name
M
string
Повне найменування Вантажовідправника (юридичної особи або ПІБ фізичної-особи підприємця), що проводить відвантаження (списання) перелічених в ТТН товарно-матеріальних цінностей
3.7.1.2
tradeContact
O
Контакти відповідального представника
3.7.1.2.1
personName
O
string
ПІБ
3.7.1.2.2.1
telephoneUniversalCommunication.completeNumber
O
string
Основний телефон
3.7.1.2.3.1
mobileTelephoneUniversalCommunication.completeNumber
O
string
Мобільний телефон
3.7.1.2.4.1
emailURIUniversalCommunication.completeNumber
O
string
Електронна адреса
3.7.1.3
postalTradeAddress
O
Юридична адреса Вантажовідправника (правила заповнення адрес у Акті знаходиться за за посиланням)
3.7.1.3.1
postCode
O
string
Індекс
3.7.1.3.2
streetName
M
string
Адреса (назва вулиці + номер будівлі)
3.7.1.3.3
cityName
M
string
Місто (назва населеного пункту)
3.7.1.3.4
countryID
M
string
Країна (UA)
3.7.1.3.5
countrySubDivisionName
O
string
Область та район (за наявності)
3.7.1.4.1
specifiedGovernmentRegistrations.id
M/O
decimal
GLN Вантажовідправника (поле обов’язкове до заповнення для відправника транзакції)
3.7.1.4.2
specifiedGovernmentRegistrations.typeCode
O
string
Код типу:
TRADEPARTY_GLN
3.7.2
consignee
O
Вантажоодержувач
3.7.2.1
name
M
string
Повне найменування Вантажоодержувача (юридичної особи або ПІБ фізичної-особи підприємця), що проводить одержання (оприбуткування) перелічених в ТТН товарно-матеріальних цінностей
3.7.2.2
tradeContact
O
Контакти відповідального представника
3.7.2.2.1
personName
O
string
ПІБ
3.7.2.2.2.1
telephoneUniversalCommunication.completeNumber
O
string
Основний телефон
3.7.2.2.3.1
mobileTelephoneUniversalCommunication.completeNumber
O
string
Мобільний телефон
3.7.2.2.4.1
emailURIUniversalCommunication.completeNumber
O
string
Електронна адреса
3.7.2.3
postalTradeAddress
O
Юридична адреса Вантажоодержувача (правила заповнення адрес у Акті знаходиться за за посиланням)
3.7.2.3.1
postCode
O
string
Індекс
3.7.2.3.2
streetName
M
string
Адреса (назва вулиці + номер будівлі)
3.7.2.3.3
cityName
M
string
Місто (назва населеного пункту)
3.7.2.3.4
countryID
M
string
Країна (UA)
3.7.2.3.5
countrySubDivisionName
O
string
Область та район (за наявності)
3.7.2.4.1
specifiedGovernmentRegistrations.id
M/O
decimal
GLN Вантажоодержувача (поле обов’язкове до заповнення для відправника транзакції)
3.7.2.4.2
specifiedGovernmentRegistrations.typeCode
O
string
Код типу:
TRADEPARTY_GLN
3.7.3
carrier
O
Перевізник
3.7.3.1
name
M
string
Повне найменування Перевізника (юридичної особи або фізичної особи - підприємця) або прізвище, ім’я, по батькові фізичної особи, з яким вантажовідправник уклав договір на надання транспортних послуг
3.7.3.2
tradeContact
O
Контакти відповідального представника
3.7.3.2.1
personName
M
string
ПІБ водія, що керуватиме ТЗ при перевезенні вантажу
3.7.3.2.2.1
telephoneUniversalCommunication.completeNumber
O
string
Основний телефон
3.7.3.2.3.1
mobileTelephoneUniversalCommunication.completeNumber
O
string
Мобільний телефон
3.7.3.2.4.1
emailURIUniversalCommunication.completeNumber
O
string
Електронна адреса
3.7.3.3
postalTradeAddress
O
Юридична адреса Перевізника (правила заповнення адрес у Акті знаходиться за за посиланням)
3.7.3.3.1
postCode
O
string
Індекс
3.7.3.3.2
streetName
M
string
Адреса (назва вулиці + номер будівлі)
3.7.3.3.3
cityName
M
string
Місто (назва населеного пункту)
3.7.3.3.4
countryID
M
string
Країна (UA)
3.7.3.3.5
countrySubDivisionName
O
string
Область та район (за наявності)
3.7.3.4.1
specifiedGovernmentRegistrations.id
M/O
* string
* decimal при typeCode=DRIVER_GLN / TRADEPARTY_GLN
Серія та номер водійського посвідчення Водія (поле обов’язкове до заповнення). Заповнюється в форматі «3 заголовні кириличні літери + 6 цифр без пробілів», наприклад: DGJ123456, АБВ123456
для typeCode=DRIVER_GLN - GLN Водія (поле опціональне до заповнення)
для typeCode=TRADEPARTY_GLN - GLN Перевізника (поле обов’язкове до заповнення для відправника транзакції)
3.7.3.4.2
specifiedGovernmentRegistrations.typeCode
O
string
Код типу:
DRIVER_GLN
TRADEPARTY_GLN
3.7.4
notifiedTradeParties (роль - FW)
O
Експедитор
3.7.4.1.1
id.schemeAgencyID
M
string
ЄДРПОУ / РНОКПП Експедитора
3.7.4.1.2
id.value
M
string
Значення
3.7.4.2
name
M
string
Повне найменування Експедитора (юридичної особи або фізичної особи - підприємця) або прізвище, ім’я, по батькові фізичної особи, з яким вантажовідправник (замовник) уклав договір траспортного експедирування
3.7.4.3
roleCode
M
string
Роль учасника (Експедитор - FW). Довідник ролей
3.7.4.4
tradeContact
O
Контакти відповідального представника
3.7.4.4.1
personName
O
string
ПІБ
3.7.4.4.2.1
telephoneUniversalCommunication.completeNumber
O
string
Основний телефон
3.7.4.4.3.1
mobileTelephoneUniversalCommunication.completeNumber
O
string
Мобільний телефон
3.7.4.4.4.1
emailURIUniversalCommunication.completeNumber
O
string
Електронна адреса
3.7.4.5
postalTradeAddress
O
Юридична адреса Експедитора (правила заповнення адрес у Акті знаходиться за за посиланням)
3.7.4.5.1
postCode
O
string
Індекс
3.7.4.5.2
streetName
M
string
Адреса (назва вулиці + номер будівлі)
3.7.4.5.3
cityName
M
string
Місто (назва населеного пункту)
3.7.4.5.4
countryID
M
string
Країна (UA)
3.7.4.5.5
countrySubDivisionName
O
string
Область та район (за наявності)
3.7.4.6.1
taxRegistration.id
O
string
РНОКПП відповідальної особи
3.7.4.7.1
specifiedGovernmentRegistrations.id
M/O
decimal
GLN Експедитора (поле обов’язкове до заповнення для відправника транзакції)
3.7.4.7.2
specifiedGovernmentRegistrations.typeCode
O
string
Код типу:
TRADEPARTY_GLN
3.7.5
notifiedTradeParties (роль - OB)
O
Замовник
3.7.5.1.1
id.schemeAgencyID
M
string
ЄДРПОУ / РНОКПП Замовника
3.7.5.1.2
id.value
M
string
Значення
3.7.5.2
name
M
string
Повне найменування Замовника (юридичної особи або фізичної особи - підприємця) або прізвище, ім’я, по батькові фізичної особи, що проводить оплату транспортної роботи і послуг
3.7.5.3
roleCode
M
string
Роль учасника (Замовник - OB). Довідник ролей
3.7.5.4
tradeContact
O
Контакти відповідального представника
3.7.5.4.1
personName
O
string
ПІБ
3.7.5.4.2.1
telephoneUniversalCommunication.completeNumber
O
string
Основний телефон
3.7.5.4.3.1
mobileTelephoneUniversalCommunication.completeNumber
O
string
Мобільний телефон
3.7.5.4.4.1
emailURIUniversalCommunication.completeNumber
O
string
Електронна адреса
3.7.5.5
postalTradeAddress
O
Юридична адреса Замовника (правила заповнення адрес у Акті знаходиться за за посиланням)
3.7.5.5.1
postCode
O
string
Індекс
3.7.5.5.2
streetName
M
string
Адреса (назва вулиці + номер будівлі)
3.7.5.5.3
cityName
M
string
Місто (назва населеного пункту)
3.7.5.5.4
countryID
M
string
Країна (UA)
3.7.5.5.5
countrySubDivisionName
O
string
Область та район (за наявності)
3.7.5.6.1
taxRegistration.id
O
string
РНОКПП відповідальної особи
3.7.5.7.1
specifiedGovernmentRegistrations.id
M/O
decimal
GLN Замовника (поле обов’язкове до заповнення для відправника транзакції)
3.7.5.7.2
specifiedGovernmentRegistrations.typeCode
O
string
Код типу:
TRADEPARTY_GLN
3.7.6
notifiedTradeParties (роль - WD)
O
Проміжний склад
3.7.6.1.1
id.schemeAgencyID
M
string
ЄДРПОУ / РНОКПП Проміжного складу
3.7.6.1.2
id.value
M
string
Значення
3.7.6.2
name
M
string
Повне найменування Проміжного складу (Вантажовідправник/Перевізник/Експедитор/Вантажоодержувач/Товарний склад), що приймає від Перевізника на тимчасове зберігання вантаж
3.7.6.3
roleCode
M
string
Роль учасника (Проміжний склад - WD). Довідник ролей
3.7.6.4
tradeContact
O
Контакти відповідального представника
3.7.6.4.1
personName
O
string
ПІБ
3.7.6.4.2.1
telephoneUniversalCommunication.completeNumber
O
string
Основний телефон
3.7.6.4.3.1
mobileTelephoneUniversalCommunication.completeNumber
O
string
Мобільний телефон
3.7.6.4.4.1
emailURIUniversalCommunication.completeNumber
O
string
Електронна адреса
3.7.6.5
postalTradeAddress
O
Юридична адреса Проміжного складу (правила заповнення адрес у Акті знаходиться за за посиланням)
3.7.6.5.1
postCode
O
string
Індекс
3.7.6.5.2
streetName
M
string
Адреса (назва вулиці + номер будівлі)
3.7.6.5.3
cityName
M
string
Місто (назва населеного пункту)
3.7.6.5.4
countryID
M
string
Країна (UA)
3.7.6.5.5
countrySubDivisionName
O
string
Область та район (за наявності)
3.7.6.6.1
taxRegistration.id
O
string
РНОКПП відповідальної особи
3.7.6.7.1
specifiedGovernmentRegistrations.id
M/O
decimal
GLN Проміжного складу (поле обов’язкове до заповнення для відправника транзакції)
3.7.6.7.2
specifiedGovernmentRegistrations.typeCode
O
string
Код типу:
TRADEPARTY_GLN
3.7.7
notifiedTradeParties (роль - COP)
O
Охоронна компанія
3.7.7.1.1
id.schemeAgencyID
M
string
ЄДРПОУ / РНОКПП Охоронної компанії
3.7.7.1.2
id.value
M
string
Значення
3.7.7.2
name
M
string
Повне найменування Охоронної компанії, що надає охоронні послуги вантажу під час перевезення
3.7.7.3
roleCode
M
string
Роль учасника (Охоронна компанія - COP). Довідник ролей
3.7.7.4
tradeContact
O
Контакти відповідального представника
3.7.7.4.1
personName
O
string
ПІБ представника Замовника, який уповноважений супроводжувати вантаж, що підлягає спеціальній охороні
3.7.8
carrierAcceptanceLogisticsLocation
O
Пункт навантаження
3.7.8.1.1
id.schemeAgencyID
M
string
КАТОТТГ пункту навантаження
3.7.8.1.2
id.value
M
string
Значення
3.7.8.2
name
M
string
Найменування пункту навантаження
3.7.8.3
typeCode
M
decimal
Тип операції: 10 - навантаження; 5 - розвантаження
3.7.8.4
description
M
string
Опис (адреса) пункту навантаження
3.7.8.5
physicalGeographicalCoordinate
M
Географічні координати
3.7.8.5.1
latitudeMeasure
O
string
Географічні координати (Широта)
3.7.8.5.2
longitudeMeasure
O
string
Географічні координати (Довгота)
3.7.8.5.3.1
systemId.schemeAgencyID
M
string
GLN
3.7.8.5.3.2
systemId.value
M
decimal
Значення
3.7.9
consigneeReceiptLogisticsLocation
O
Пункт розвантаження
3.7.9.1.1
id.schemeAgencyID
M
string
КАТОТТГ пункту розвантаження
3.7.9.1.2
id.value
M
string
Значення
3.7.9.2
name
M
string
Найменування пункту розвантаження
3.7.9.3
typeCode
M
decimal
Тип операції: 10 - навантаження; 5 - розвантаження
3.7.9.4
description
M
string
Опис (адреса) пункту розвантаження
3.7.9.5
physicalGeographicalCoordinate
M
Географічні координати
3.7.9.5.1
latitudeMeasure
O
string
Географічні координати (Широта)
3.7.9.5.2
longitudeMeasure
O
string
Географічні координати (Довгота)
3.7.9.5.3.1
systemId.schemeAgencyID
M
string
GLN
3.7.9.5.3.2
systemId.value
M
decimal
Значення
3.7.10
deliveryTransportEvent
O
Розвантажувальні роботи
3.7.10.1
id
O
string
Порядковий номер події (події завжди нумеруються в порядку поступового зростання за принципом N+1)
3.7.10.2
typeCode
O
decimal
Тип операції (розвантаження=5, завантаження=10)
3.7.10.3
description
O
string
Опис
3.7.10.4.1
actualOccurrenceDateTime.dateTime
O
datetime (2021-12-13T14:19:23+02:00)
Дата та час прибуття автомобіля на розвантаження
3.7.10.5.1
scheduledOccurrenceDateTime.dateTime
O
datetime (2021-12-13T14:19:23+02:00)
Дата та час вибуття автомобіля з-під розвантаження
3.7.10.6.1
applicableNotes (з кодом DOWNTIME).contentCode
O
string
Код DOWNTIME
3.7.10.6.2
applicableNotes (з кодом DOWNTIME).content
O
unsignedByte
Час (години) простою під розвантаженням
3.7.11
pickUpTransportEvent
M
Навантажувальні роботи
3.7.11.1
id
O
string
Порядковий номер події (події завжди нумеруються в порядку поступового зростання за принципом N+1)
3.7.11.2
typeCode
O
string
Тип операції (розвантаження=5, завантаження=10)
3.7.11.3
description
O
string
Опис
3.7.11.4.1
actualOccurrenceDateTime.dateTime
O
datetime (2021-12-13T14:19:23+02:00)
Дата та час прибуття автомобіля під навантаження
3.7.11.5.1
scheduledOccurrenceDateTime.dateTime
O
datetime (2021-12-13T14:19:23+02:00)
Дата та час вибуття автомобіля з-під навантаження
3.7.11.6.1
applicableNotes (з кодом DOWNTIME).contentCode
O
string
Код DOWNTIME
3.7.11.6.2
applicableNotes (з кодом DOWNTIME).content
O
unsignedByte
Час простою
3.7.12
includedSupplyChainConsignmentItems
O
Відомості про вантаж
3.7.12.1.1
globalID.schemeAgencyID
O
string (min 4 - max 10)
УКТЗЕД (код продукції)
3.7.12.1.2
globalID.value
O
string
Значення
3.7.12.2.1
natureIdentificationTransportCargo.identification
O
string
Найменування вантажу
3.7.12.3.1
applicableTransportDangerousGoods.UNDGIdentificationCode
O
decimal
Клас небезпечних речовин, до якого віднесено вантаж (у разі перевезення небезпечних вантажів). Код UNDG, 0 - якщо не використовується
3.7.12.4.1
associatedReferencedDocuments.typeCode
O
decimal
Тип:
* код 150 - Накладна на переміщення (COMDOC_022)
* код 220 - Замовлення (ORDER)
* код 290 - Право на предʼявлення претензії
* код 335 - Заявка на транспортування (TRANSPORTATIONORDER/SUBDOCTYPE=1)
* код 350 - Акт приймання-передачі (DOCUMENTINVOICE з DocumentFunctionCode=APP)
* код 351 - Повідомлення про відвантаження (DESADV)
* код 361 - Цінова накладна (DOCUMENTINVOICE з DocumentFunctionCode=PRN)
* код 362 - Накладна за кількістю (DOCUMENTINVOICE з DocumentFunctionCode=TN)
* код 395 - Товарна накладна (COMDOC_027)
* код 441 - Маршрутний лист / рейс
* код 538 - Декларація виробника
* код 730 - Товарно-транспортна накладна (ТТН)
* код 770 - Підтвердження заявки на транспортування (TRANSPORTATIONORDER/SUBDOCTYPE=2)
(+довідник кодів документів МІУ )
3.7.12.4.2
associatedReferencedDocuments.id
O
string
Документи з вантажем. Номер документа, який водій отримує від вантажовідправника і передає вантажоодержувачеві разом з вантажем (товарні, залізничні накладні, сертифікати, свідоцтва тощо)
3.7.12.4.3
associatedReferencedDocuments.remarks
O
string
UUID супровідного документа
3.7.12.4.4
associatedReferencedDocuments.formattedIssueDateTime.dateTime
O
datetime
(2021-12-13T14:19:23+02:00)
Дата та час складання супровідного документа
3.7.12.5
transportLogisticsPackage
O
Транспортно-логістичний пакет. ВАЖЛИВО: в Україні дозволяється лише один LogisticsPackage для одного ConsignmentItem!
3.7.12.5.1
itemQuantity
O
decimal
Кількість місць, які визначаються за кожним найменуванням вантажу (це можуть бути ящики, кошики, мішки тощо; якщо вантаж упаковано на піддонах - вказують кількість піддонів)
3.7.12.5.2
typeCode
O
string
Вид пакування (Довідник видів упаковок)
3.7.12.5.3
type
O
string
Одиниця виміру для itemQuantity
3.7.12.5.4
physicalLogisticsShippingMarks
O
Маркування
3.7.12.5.4.1
marking
O
string
Назва транспортної упаковки (вільна назва), в якій перевозиться вантаж
3.7.12.5.4.2.1
barcodeLogisticsLabel.id
O
string (max 128)
Штрихкод товару
3.7.12.6.1
applicableNotes (з кодом VENDOR_CODE).contentCode
O
string
Код VENDOR_CODE
3.7.12.6.2
applicableNotes (з кодом VENDOR_CODE).content
O
string
Артикул товару
3.7.12.7.1
applicableNotes (з кодом QUANTITY).contentCode
O
string
Код QUANTITY
3.7.12.7.2
applicableNotes (з кодом QUANTITY).content
O
string
Кількість товару
3.7.12.8.1
applicableNotes (з кодом URL).contentCode
O
string
Код URL
3.7.12.8.2
applicableNotes (з кодом URL).content
O
string
В полі можливо передавати посилання на опис товару (на каталог / сайт виробника чи продавця, т.п.)
3.7.12.9.1
applicableNotes (з кодом BASE_UOM).contentCode
O
string
Код BASE_UOM
3.7.12.9.2
applicableNotes (з кодом BASE_UOM).content
O
string
Одиниця виміру кількості товару для QUANTITY
3.7.12.10.1
applicableNotes (з кодом BUYER_CODE).contentCode
O
string
Код BUYER_CODE
3.7.12.10.2
applicableNotes (з кодом BUYER_CODE).content
O
string
Артикул покупця (використовується для ідентифікації товарної позиції при прийманні)
3.7.12.11.1
applicableNotes (з кодом PRICE_WITH_VAT).contentCode
O
string
Код PRICE_WITH_VAT
3.7.12.11.2
applicableNotes (з кодом PRICE_WITH_VAT).content
O
string
Ціна за одиницю з ПДВ
3.7.12.12.1
applicableNotes (з кодом SUM_WITHOUT_VAT).contentCode
O
string
Код SUM_WITHOUT_VAT
3.7.12.12.2
applicableNotes (з кодом SUM_WITHOUT_VAT).content
O
string
Загальна сума без ПДВ
3.7.12.13.1
applicableNotes (з кодом RETURN_TARE).contentCode
O
string
Код RETURN_TARE
3.7.12.13.2
applicableNotes (з кодом RETURN_TARE).content
O
string
Ознака «зворотня тара»
3.7.12.14.1
applicableNotes applicableNotes (з кодом NET_WEIGHT).contentCode
O
string
Код NET_WEIGHT
3.7.12.14.2
applicableNotes applicableNotes (з кодом NET_WEIGHT).content
O
string
Маса нетто
3.7.12.15.1
applicableNotes (з кодом RTP_QUANTITY).contentCode
O
string
Код RTP_QUANTITY
3.7.12.15.2
applicableNotes (з кодом RTP_QUANTITY).content
O
string
Кількість транспортної упаковки (використовується для обліку оборотної тари)
3.7.13
deliveryInstructions
O
Вид перевезень
3.7.13.1
description
O
string
Опис (вид роботи перевізника: за відрядним тарифом, за погодинним тарифом, за покілометровим тарифом, централізовані перевезення тощо)
3.7.13.2
descriptionCode
M
string
Код (TRANSPORTATION_TYPE)
3.8
initiatorNotes
M
string
Короткий або повний опис причин складання акта (Замовник)
3.9
consignorNotes
O
string
Особливі відмітки / Інформація щодо незгоди зі змістом Акта (Вантажовідправник)
3.10
carrierNotes
O
string
Особливі відмітки / Інформація щодо незгоди зі змістом Акта (Перевізник)
3.11
consigneeNotes
O
string
Особливі відмітки / Інформація щодо незгоди зі змістом Акта (Вантажоодержувач)
4
certifyingPartyPayload
M
Інформація про відповідальних осіб
4.1
certifyingTradeParty certifyingTradeParty (RoleCode=ОВ)
M
Інформація про Замовника
4.1.1.1
id.schemeAgencyID
O
string
"РНОКПП"/"ПАСПОРТ"
4.1.1.2
id.value
O
decimal
Значення
4.1.2
name
M
string
Посада Замовника
4.1.3
roleCode
M
string
Роль учасника (Замовник - OB). Довідник ролей
4.1.4.1
tradeContact.personName
M
string
ПІБ Замовника
4.2
certifyingTradeParty (RoleCode=CZ)
M
Інформація про відповідальних осіб Вантажовідправника
4.2.1.1
id.schemeAgencyID
O
string
"РНОКПП"/"ПАСПОРТ"
4.2.1.2
id.value
O
decimal
Значення
4.2.2
name
M
string
Посада відповідальної особи Вантажовідправника
4.2.3
roleCode
M
string
Роль учасника (Вантажовідправник - CZ). Довідник ролей
4.2.4.1
tradeContact.personName
M
string
ПІБ відповідальної особи Вантажовідправника
4.3
certifyingTradeParty (RoleCode=CA)
M
Інформація про Перевізника
4.3.1.1
id.schemeAgencyID
O
string
"РНОКПП"/"ПАСПОРТ"
4.3.1.2
id.value
O
decimal
Значення
4.3.2
name
M
string
Посада Перевізника
4.3.3
roleCode
M
string
Роль учасника (Перевізник - CA). Довідник ролей
4.3.4.1
tradeContact.personName
M
string
ПІБ Перевізника
4.4
certifyingTradeParty y (RoleCode=CN)
O
Інформація про відповідальних осіб Вантажоодержувача
4.4.1.1
id.schemeAgencyID
O
string
"РНОКПП"/"ПАСПОРТ"
4.4.1.2
id.value
O
decimal
Значення
4.4.2
name
M
string
Посада відповідальної особи Вантажоодержувача
4.4.3
roleCode
M
string
Роль учасника (Вантажоодержувач - CN). Довідник ролей
4.4.4.1
tradeContact.personName
M
string
ПІБ відповідальної особи Вантажоодержувача
II
signatureStorage
M
Підписи
5
signatures signatures (SigningPartyRoleCode=OB)
M
КЕП Замовника
5.1
signingPartyRoleCode
M
string
Роль підписанта (Замовник - OB). Довідник ролей
5.2
partySignature
M
string
Підпис (base64 підпису p7s)
5.3
name
M
string
ПІБ підписанта (Замовника)
5.4
position
O
string
Посада підписанта (Замовника)
5.5.1
specifiedTaxRegistration.id
M
string
РНОКПП підписанта (Замовника)
6
signatures signatures (SigningPartyRoleCode=CZ)
M
КЕП Вантажовідправника
6.1
signingPartyRoleCode
M
string
Роль підписанта (Вантажовідправник - CZ). Довідник ролей
6.2
partySignature
M
string
Підпис (base64 підпису p7s)
6.3
name
M
string
ПІБ підписанта (відповідальної особи Вантажовідправника)
6.4
position
O
string
Посада підписанта (відповідальної особи Вантажовідправника)
6.5.1
specifiedTaxRegistration.id
M
string
РНОКПП підписанта (відповідальної особи Вантажовідправника)
7
signatures signatures (SigningPartyRoleCode=CA)
M
КЕП Перевізника
7.1
signingPartyRoleCode
M
string
Роль підписанта (Перевізник - CA). Довідник ролей
7.2
partySignature
M
string
Підпис (base64 підпису p7s)
7.3
name
M
string
ПІБ підписанта (Перевізника)
7.4
position
O
string
Посада підписанта (Перевізника)
7.5.1
specifiedTaxRegistration.id
M
string
РНОКПП підписанта (Перевізника)
8
signatures signatures (SigningPartyRoleCode=CN)
M
КЕП Вантажоодержувача
8.1
signingPartyRoleCode
M
string
Роль підписанта (Вантажоодержувач - CN). Довідник ролей
8.2
partySignature
M
string
Підпис (base64 підпису p7s)
8.3
name
M
string
ПІБ підписанта (відповідальної особи Вантажоодержувача)
8.4
position
O
string
Посада підписанта (відповідальної особи Вантажоодержувача)
8.5.1
specifiedTaxRegistration.id
M
string
РНОКПП підписанта (відповідальної особи
[1] - елементи структури мають наступний вигляд:
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:adjustment: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>
<AdjustmentActPayload>
<!-- Інформація про еТТН для якого складається даний акт -->
<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>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>
<!-- Замовник -->
<InitiatorTradeParty>
<ram:ID schemeAgencyID="ЄДРПОУ">12345678</ram:ID>
<ram:Name>ТОВ "Компанія відправник"</ram:Name>
<ram:RoleCode>CZ</ram:RoleCode>
</InitiatorTradeParty>
<!-- Перевізник -->
<CarrierTradeParty>
<ram:ID schemeAgencyID="ЄДРПОУ">12345678</ram:ID>
<ram:Name>ТОВ "Компанія перевізник"</ram:Name>
<ram:RoleCode>CA</ram:RoleCode>
</CarrierTradeParty>
<!-- Отримувач -->
<ConsigneeTradeParty>
<ram:ID schemeAgencyID="ЄДРПОУ">12345678</ram:ID>
<ram:Name>ТОВ "Компанія Отримувач"</ram:Name>
<ram:RoleCode>CN</ram:RoleCode>
</ConsigneeTradeParty>
<AdjustedSupplyChainConsignment>
<ram:PickUpTransportEvent>
<ram:ScheduledOccurrenceDateTime>
<udt:DateTime>2021-10-26T23:00:00+02:00</udt:DateTime>
</ram:ScheduledOccurrenceDateTime>
</ram:PickUpTransportEvent>
<ram:DeliveryInstructions>
<ram:Description>Реквізит "Вид перевезень" у товарно-транспортній накладній передбачає зазначення виду роботи перевізника за відрядним тарифом, за погодинним тарифом, за покілометровим тарифом, централізовані перевезення тощо</ram:Description>
<ram:DescriptionCode>TRANSPORTATION_TYPE</ram:DescriptionCode>
</ram:DeliveryInstructions>
</AdjustedSupplyChainConsignment>
<InitiatorNotes>Короткий або повний опис причин складання Акта</InitiatorNotes>
<ConsignorNotes>Інформація щодо незгоди зі змістом Акта</ConsignorNotes>
<CarrierNotes>Інформація щодо незгоди зі змістом Акта</CarrierNotes>
<ConsigneeNotes>Інформація щодо незгоди зі змістом Акта</ConsigneeNotes>
</AdjustmentActPayload>
<CertifyingPartyPayload>
<CertifyingTradeParty>
<ram:ID schemeAgencyID="РНОКПП">12345678</ram:ID>
<ram:Name>Комірник</ram:Name>
<ram:RoleCode>CN</ram:RoleCode>
<ram:DefinedTradeContact>
<ram:PersonName>Петренко В.В.</ram:PersonName>
</ram:DefinedTradeContact>
</CertifyingTradeParty>
<CertifyingTradeParty>
<ram:ID schemeAgencyID="РНОКПП">12345678</ram:ID>
<ram:Name>Водій</ram:Name>
<ram:RoleCode>CA</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>CN</SigningPartyRoleCode>
<PartySignature>MIKAcgY...YGcRaZ5UI</PartySignature>
<Name>Клієнт ЮР-особа 104 (тестовий сертифікат)</Name>
<Position>комірник</Position>
<SpecifiedTaxRegistration>
<ram:ID>9999999999</ram:ID>
</SpecifiedTaxRegistration>
</Signature>
<Signature>
<SigningPartyRoleCode>CA</SigningPartyRoleCode>
<PartySignature>MIJ/BAY...0bBHXxctRcUTM3gr0n0PeiCdigK/Gh0wk48/LNQM5j9c5U1a2P7VAYGcRaZ5UI</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",
"act": {
"documentContext": {
"transactionID": "0",
"documentCode": {
"id": "urn:ua:e-transport.gov.ua:act:01"
},
"documentSubCode": {
"id": "urn:ua:e-transport.gov.ua:act:01:adjustment:001"
}
},
"exchangedDocument": {
"id": "123123",
"issueDateTime": {
"dateTime": "2022-10-26T21:32:52+02:00"
},
"issueLogisticsLocation": {
"name": "Місце складання документу",
"description": "79000, м.Львів, вул. Словацького, 1"
},
"includedNote": []
},
"adjustmentActPayload": {
"previousAdministrativeReferencedDocuments": [
{
"typeCode": "730",
"id": "004edd76-e217-4d73-be16-769896530f16",
"formattedIssueDateTime": {
"dateTime": "2023-07-18T19:17:00.000Z"
}
}
],
"initiatorTradeParty": {
"id": {
"schemeAgencyID": "ЄДРПОУ",
"value": "85854949"
},
"name": "ТОВ \"ТЕСТ 3\"",
"roleCode": "CN"
},
"specifiedGovernmentRegistrations": [
{
"id": "9864065738701",
"typeCode": "TRADEPARTY_GLN"
}
],
"carrierTradeParty": {
"id": {
"schemeAgencyID": "ЄДРПОУ",
"value": "85854949"
},
"name": "ТОВ \"ТЕСТ 2\"",
"roleCode": "CA"
},
"consignorTradeParty": {
"id": {
"schemeAgencyID": "ЄДРПОУ",
"value": "85854949"
},
"name": "ТОВ \"ТЕСТ\"",
"roleCode": "CZ"
},
"adjustedSupplyChainConsignment": {
"includedSupplyChainConsignmentItems": [
{
"sequenceNumeric": "1",
"natureIdentificationTransportCargo": {
"identification": "Датчики руху автоматизовані"
}
}
]
},
"initiatorNotes": "Помилки в найменувані товару"
},
"certifyingPartyPayload": {
"certifyingTradeParty": [
{
"id": {
"schemeAgencyID": "РНОКПП",
"value": "1234567890"
},
"name": "Бухгалтер",
"roleCode": "CN",
"tradeContact": {
"personName": "Бухгалтер Тестового Постачальника"
}
}
]
}
}
}
Ваша пробна версія Premium закінчилася
Ваша пробна версія Premium закінчилася
Ваша пробна версія Premium закінчилася