Skip to main content

Правила заповнення «e-TTH» для мережі «МЕТРО»

Товарно-транспортна накладна (ТТН) є одним із ключових документів у документообігу між контрагентами. Для коректного формування та обробки ТТН під час обміну документами з мережею «МЕТРО» необхідно дотримуватись правил заповнення окремих полів документа.

1. Загальні правила

1. Наявність документа-підстави

У процесі обміну документами з мережею «МЕТРО» використовується документ «Транспортна накладна».

При формуванні ТТН інформація про документ-підставу «Транспортна накладна» обов’язково має бути зазначена у блоці «Супровідні документи».

У XML-структурі цей блок визначається як AssociatedReferencedDocument.

Поля та правила заповнення:

  • TypeCode— код типу документа-підстави:
    • 780 — «Транспортна накладна» (DOCUMENTINVOICE_TNN);
  •  ID— номер документа-підстави;
  • Remarks— UUID документа-підстави на платформі EDIN (опційно);
  • DateTimeString— дата та час документа-підстави.

Номер і дата документа-підстави у блоці AssociatedReferencedDocument мають відповідати номеру та даті, зазначеним у самому документі-підставі.

XML-приклад:

<ram:AssociatedReferencedDocument>
    <ram:TypeCode>780</ram:TypeCode>
    <ram:ID>GK_40409997_AN12</ram:ID>
    <ram:Remarks>4b39d-656-4d88-bc5d-c5c6879613c9</ram:Remarks>
    <ram:FormattedIssueDateTime>
        <qdt:DateTimeString>2025-01-15T12:00:00+02:00</qdt:DateTimeString>
    </ram:FormattedIssueDateTime>
</ram:AssociatedReferencedDocument>
1.2. Заповнення GLN компаній-учасників ТТН

При формуванні ТТН для кожного учасника документообігу необхідно зазначати GLN у відповідному блоці «_____TradeParty».

Інформація про GLN вноситься до блоку SpecifiedGovernmentRegistration.

Поля та правила заповнення:

  • ID — GLN компанії-учасника;
  • TypeCode — значення TRADEPARTY_GLN.

GLN у ТТН та документі-підставі мають збігатися.
GLN учасників заповнюється у відповідних блоках:
 - GLN відправника (Sender) — у блоці ConsignorTradeParty;
 - GLN отримувача (Recipient) — у блоках ConsigneeTradeParty та ConsigneeReceiptLogisticsLocation.

XML-приклад:

<ram:ConsignorTradeParty>
    <ram:ID schemeAgencyID="ЄДРПОУ">3211129</ram:ID>
    <ram:Name>ТОВ "ТЕСТ"</ram:Name>
    <ram:RoleCode>CZ</ram:RoleCode>
    <ram:PostalTradeAddress>
        <ram:PostcodeCode>01168</ram:PostcodeCode>
        <ram:StreetName>вул. Барабашова</ram:StreetName>
        <ram:CityName>Харків</ram:CityName>
        <ram:CountryID>UA</ram:CountryID>
        <ram:CountrySubDivisionName>Харківська</ram:CountrySubDivisionName>
    </ram:PostalTradeAddress>
    <ram:SpecifiedGovernmentRegistration>
        <ram:ID>4820062440004</ram:ID>
        <ram:TypeCode>TRADEPARTY_GLN</ram:TypeCode>
    </ram:SpecifiedGovernmentRegistration>
</ram:ConsignorTradeParty>
1.3. Додаткові умови та перевірки ТТН при роботі з мережею «МЕТРО»

Під час формування та відправки ТТН необхідно враховувати такі умови:

  • у ТТН заборонено зазначати інформацію про вартість товарів. Поля «Ціна з ПДВ», «Ціна без ПДВ», «Сума з ПДВ» та «Сума без ПДВ» мають залишатися порожніми;
  • Вантажовідправнику заборонено надсилати ТТН з однаковим номером більше одного разу протягом календарного року.

В XML-структурі поля, пов’язані з вартістю товарів, визначаються такими тегами:

  • IncludedSupplyChainConsignmentItem.ApplicableNote.Content — з кодом PRICE_WITH_VAT;
  • IncludedSupplyChainConsignmentItem.TariffQuantity;
  • IncludedSupplyChainConsignmentItem.InvoiceAmount;
  • IncludedSupplyChainConsignmentItem.ApplicableNote.Content — з кодом SUM_WITHOUT_VAT.
1.4. Дефолтна логіка обробки документів

Для коректного визначення зв’язків між документами та правильної обробки ТТН зі сторони мережі «МЕТРО» необхідно дотримуватись правил заповнення документа, наведених вище.

Якщо необхідні дані відсутні, до ТТН застосовується дефолтна логіка обробки:

  • якщо не вказано документ-підставу, ТТН буде оброблена в системі EDIN, але через неможливість визначити відповідний пакет документів для неї буде створено новий пакет;
  • якщо не вказано GLN вантажовідправника та/або вантажоотримувача, пошук документа-підстави здійснюватиметься в межах основного GLN компанії. Якщо відповідний пакет документів не знайдено, для ТТН буде створено новий пакет.

Основний GLN — унікальний GLN компанії на платформі EDIN, який використовується для документів, що потребують підпису КЕП. Основний GLN створюється автоматично під час реєстрації на платформі EDI Network.

2. Додавання даних з COMDOC 027 до «Акта розбіжностей про вантаж»

Для мережі «МЕТРО» реалізовано можливість під час створення «Акта розбіжностей про вантаж» на підставі ТТН доповнювати його табличну частину даними з COMDOC 027 («Товарна накладна»). Це дозволяє зафіксувати розбіжності не лише на рівні палети, а й щодо окремих товарних позицій.

Для додавання товарних позицій з «Товарної накладної» необхідно відкрити відповідну ТТН та в блоці «Ланцюжок документів» натиснути «Створити документ» → «Акт розбіжностей про вантаж».

Якщо «Акт розбіжностей про вантаж» уже створено, додати дані з «Товарної накладної» можна у відкритому документі за допомогою «Додаткові дії» → «Доповнити з товарної накладної».

Снимок экрана 2026-08-19 в 12.08.34.png

Зображення 1 — Додавання даних з «Товарної накладної» до «Акта розбіжностей про вантаж».

Після вибору відповідної дії відкривається вікно «Оберіть позиції з розбіжностями», у якому відображаються товарні позиції з COMDOC 027. Для кожної позиції доступна інформація про найменування, артикул та SSCC-код палети.

Користувач може вибрати всю палету (SSCC) або окремі товарні позиції:

  • при виборі палети SSCC автоматично вибираються всі товари, що входять до цієї палети;
  • при виборі окремої товарної позиції до табличної частини Акта додається лише вибраний товар.

Після вибору необхідних позицій натисніть «Додати». Вибрані позиції будуть додані до табличної частини «Акта розбіжностей про вантаж».

Снимок экрана 2026-08-19 в 12.09.49.png

Зображення 2 — Вибір товарних позицій з «Товарної накладної».

Після додавання позицій користувач може редагувати, видаляти або доповнювати табличну частину Акта відповідно до стандартної логіки роботи з документом.

Подальше підписання та відправка «Акта розбіжностей про вантаж» виконуються за стандартною процедурою.

Детальніше про загальний процес створення «Акта розбіжностей про вантаж» можна переглянути в окремій інструкції.

3. Зміни згідно з наказом №1332

3.1. Новий блок «Відомості про транспортний засіб»

У ТТН необхідно зазначити інформацію про транспортний засіб, який бере участь у перевезенні.

Інформація вноситься до поля «Відомості про транспортний засіб (автомобіль / автопоїзд / комбінований транспортний засіб)», яке у структурі ТТН представлено блоком ram:IncludedNote.

Поля та правила заповнення:

  • Довжина — загальна довжина автопоїзда, яка вимірюється від переднього бампера автомобіля до заднього бампера останнього автомобіля, причепа або напівпричепа. Значення зазначається в метрах.
    • ram:ContentCode.listAgencyIDvehicle_length;
    • ram:ContentCode.value — числове значення;
    • ram:Content — код ролі учасника CZ.
  • Ширина (максимальна) — максимальна ширина автопоїзда в метрах.
    • ram:ContentCode.listAgencyIDvehicle_width;
    • ram:ContentCode.value — числове значення;
    • ram:Content — код ролі учасника CZ.
  • Висота (максимальна) — максимальна висота автопоїзда в метрах.
    • ram:ContentCode.listAgencyIDvehicle_height;
    • ram:ContentCode.value — числове значення;
    • ram:Content — код ролі учасника CZ.
  • Загальна маса з вантажем — загальна маса транспортного засобу відповідно до технічного паспорта та маси вантажу з урахуванням тари або загальна маса за результатами зважування.
    • ram:ContentCode.listAgencyIDgross_vehicle_weight_with_cargo;
    • ram:ContentCode.value — числове значення;
    • ram:Content — код ролі учасника CZ.

XML-приклад:

<ExchangedDocument>
    <ram:IncludedNote>
        <ram:ContentCode listAgencyID="vehicle_length">11.32</ram:ContentCode>
        <ram:Content>CZ</ram:Content>
    </ram:IncludedNote>
    <ram:IncludedNote>
        <ram:ContentCode listAgencyID="vehicle_width">3.3</ram:ContentCode>
        <ram:Content>CZ</ram:Content>
    </ram:IncludedNote>
    <ram:IncludedNote>
        <ram:ContentCode listAgencyID="vehicle_height">25</ram:ContentCode>
        <ram:Content>CZ</ram:Content>
    </ram:IncludedNote>
    <ram:IncludedNote>
        <ram:ContentCode listAgencyID="gross_vehicle_weight_with_cargo">3322</ram:ContentCode>
        <ram:Content>CZ</ram:Content>
    </ram:IncludedNote>
</ExchangedDocument>
3.2. Нові поля для блоку «Загальні дані»

У ТТН зазначається загальна інформація про вантаж, що перевозиться.

Дані вносяться до блоків SpecifiedSupplyChainConsignment та IncludedNote у полях «Маса брутто», «Загальна сума з ПДВ», «Сума ПДВ» та «Кількість місць».

Поля та правила заповнення блоку SpecifiedSupplyChainConsignment.

  • Маса брутто — загальна маса брутто вантажу в кілограмах.
    • ram:GrossWeightMeasure.unitCodeKGM;
    • ram:GrossWeightMeasure.value — числове значення.
  • Усього відпущено на загальну суму з ПДВ — загальна сума з ПДВ у гривнях.
    • ram:AssociatedInvoiceAmount.currencyIDUAH;
    • ram:AssociatedInvoiceAmount.value — числове значення.
  • Кількість місць — загальна кількість місць вантажу.
    • ram:ConsignmentItemQuantity — числове значення.

XML-приклад:

<ram:GrossWeightMeasure unitCode="KGM">3</ram:GrossWeightMeasure>
<ram:AssociatedInvoiceAmount currencyID="UAH">4</ram:AssociatedInvoiceAmount>
<ram:ConsignmentItemQuantity>4</ram:ConsignmentItemQuantity>

Поля та правила заповнення блоку IncludedNote.

  • Сума ПДВ (числове значення):
    • ram:ContentCode.listAgencyIDvatAmount;
    • ram:ContentCode.value — числове значення;
    • ram:Content — код ролі учасника CZ.
  • Сума ПДВ (прописом):
    • ram:ContentCode.listAgencyIDvatAmount_text;
    • ram:ContentCode.value — текстове значення;
    • ram:Content — код ролі учасника CZ.
  • Маса брутто (прописом):
    • ram:ContentCode.listAgencyIDgrossWeightMeasure_text;
    • ram:ContentCode.value — текстове значення;
    • ram:Content — код ролі учасника CZ.
  • Усього відпущено на загальну суму з ПДВ (прописом):
    • ram:ContentCode.listAgencyIDassociatedInvoiceAmount_text;
    • ram:ContentCode.value — текстове значення;
    • ram:Content — код ролі учасника CZ.
  • Кількість місць (прописом):
    • ram:ContentCode.listAgencyIDconsignmentItemQuantity_text;
    • ram:ContentCode.value — текстове значення;
    • ram:Content — код ролі учасника CZ.

XML-приклад:

<ExchangedDocument>
    <ram:IncludedNote>
        <ram:ContentCode listAgencyID="vatAmount">2332</ram:ContentCode>
        <ram:Content>CZ</ram:Content>
    </ram:IncludedNote>
    <ram:IncludedNote>
        <ram:ContentCode listAgencyID="consignmentItemQuantity_text">чотири</ram:ContentCode>
        <ram:Content>CZ</ram:Content>
    </ram:IncludedNote>
    <ram:IncludedNote>
        <ram:ContentCode listAgencyID="grossWeightMeasure_text">три цілих</ram:ContentCode>
        <ram:Content>CZ</ram:Content>
    </ram:IncludedNote>
    <ram:IncludedNote>
        <ram:ContentCode listAgencyID="associatedInvoiceAmount_text">чотири грн 0 коп</ram:ContentCode>
        <ram:Content>CZ</ram:Content>
    </ram:IncludedNote>
</ExchangedDocument>
3.3. Нові поля для блоку «Відомості про вантаж»

У ТТН додано нові поля для зазначення відомостей про вантаж у блоці: IncludedSupplyChainConsignmentItem

  • «Ідентифікаційний номер тварини, від якої отримано сировину»;
  • «Вид тварини»;
  • «Температурний режим транспортування».

Поля та правила заповнення:

  • Ідентифікаційний номер тварини, від якої отримано сировину:
    • ram:ApplicableNote.contentCodeANIMAL_ID;
    • ram:ApplicableNote.content — значення.
  • Вид тварини:
    • ram:ApplicableNote.contentCodeANIMAL_TYPE;
    • ram:ApplicableNote.content — значення.
  • Мінімальна температура транспортування:
    • ram:ApplicableNote.contentCodeTRANSPORTATION_MIN_TEMPERATURE;
    • ram:ApplicableNote.content — значення.
  • Максимальна температура транспортування:
    • ram:ApplicableNote.contentCodeTRANSPORTATION_MAX_TEMPERATURE;
    • ram:ApplicableNote.content — значення.

XML-приклад:

<ram:ApplicableNote>
    <ram:ContentCode>ANIMAL_ID</ram:ContentCode>
    <ram:Content>Ідентифікаційний номер тварини, від якої отримано сировину</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
    <ram:ContentCode>ANIMAL_TYPE</ram:ContentCode>
    <ram:Content>Вид тварини</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
    <ram:ContentCode>TRANSPORTATION_MIN_TEMPERATURE</ram:ContentCode>
    <ram:Content>-22</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
    <ram:ContentCode>TRANSPORTATION_MAX_TEMPERATURE</ram:ContentCode>
    <ram:Content>+23</ram:Content>
</ram:ApplicableNote>
3.4. Нове поле «Код УНЗР»

УНЗР (унікальний номер запису в Єдиному державному демографічному реєстрі) — ідентифікатор, який присвоюється громадянам України під час оформлення ID-картки або закордонного паспорта.

Код УНЗР вноситься до ТТН на рівні блоків  _____TradeParty у блоці SpecifiedGovernmentRegistration для всіх учасників документа та окремо для водія, якщо значення доступне.

Поля та правила заповнення:

Для компанії:

  • ID — код УНЗР, якщо він наявний. Формат: ХХХХХХХХ-ХХХХХ;
  • TypeCode—TRADEPARTY_UNZR.

Для водія:

  • ID— код УНЗР, якщо він наявний. Формат: ХХХХХХХХ-ХХХХХ;
  •  TypeCode—DRIVER_UNZR.

XML-приклад:

<ram:CarrierTradeParty>
    <ram:ID schemeAgencyID="ЄДРПОУ">AA111111</ram:ID>
    <ram:Name>Мій Вантажовідправник</ram:Name>
    <ram:RoleCode>CA</ram:RoleCode>
    <ram:PostalTradeAddress>
        <ram:PostcodeCode>993564</ram:PostcodeCode>
        <ram:StreetName>вул. Нічна, б. 2</ram:StreetName>
        <ram:CityName>с. Дніпровське</ram:CityName>
        <ram:CountryID>UA</ram:CountryID>
        <ram:CountrySubDivisionName>Чернігівська обл., Чернігівський р-н</ram:CountrySubDivisionName>
    </ram:PostalTradeAddress>
    <ram:SpecifiedGovernmentRegistration>
        <ram:ID>9864065745518</ram:ID>
        <ram:TypeCode>TRADEPARTY_GLN</ram:TypeCode>
    </ram:SpecifiedGovernmentRegistration>
    <ram:SpecifiedGovernmentRegistration>
        <ram:ID>19940112-35121</ram:ID>
        <ram:TypeCode>TRADEPARTY_UNZR</ram:TypeCode>
    </ram:SpecifiedGovernmentRegistration>
    <ram:SpecifiedGovernmentRegistration>
        <ram:ID>19940113-35120</ram:ID>
        <ram:TypeCode>DRIVER_UNZR</ram:TypeCode>
    </ram:SpecifiedGovernmentRegistration>
</ram:CarrierTradeParty>

у XML-прикладі залишено тільки дані, що стосуються УНЗР та GLN; окремий DRIVER_GLN не додається, оскільки він не є частиною опису нового поля «Код УНЗР».