Мережа «АТБ»

ТОВ "АТБ-МАРКЕТ"

Документообіг з мережею «АТБ» на платформі EDI Network 2.0: «Міжнародні поставки». Інструкція Постачальника

Документообіг з мережею «АТБ» на платформі EDI Network 2.0: «Міжнародні поставки». Інструкція Постачальника

Схема документообігу «Міжнародні поставки»

Ця інструкція описує порядок електронного документообігу між мережею АТБ та постачальниками в межах міжнародних поставок на платформі EDI Network 2.0.

У процесі документообігу використовуються такі документи:

Загальну схему обміну документами:

Снимок экрана 2026-06-08 в 15.33.22.png

Зображення 1 – Загальна схема документообігу для міжнародних поставок з мережею АТБ

На схемі відображено послідовність обміну електронними документами між мережею АТБ та постачальником у межах процесу міжнародних поставок. Документообіг передбачає передачу замовлення, підтвердження замовлення, повідомлення про відвантаження, рахунку та універсального документа.

Вхід на платформу

Для початку роботи з системою необхідно виконати вхід на платформу EDIN.

Детальна інструкція з авторизації доступна за посиланням: Авторизація в системі.

Формування «Підтвердження замовлення» (ORDRSP) на підставі вхідного «Замовлення» (ORDER)

Після отримання від мережі АТБ документа «Замовлення» (ORDERS) постачальнику необхідно сформувати документ «Підтвердження замовлення» (ORDRSP). Документ використовується для підтвердження готовності до поставки замовленої продукції та містить інформацію щодо фактичної кількості товару, що буде поставлена.

Під час формування документа «Підтвердження замовлення» (ORDRSP) необхідно обрати валюту документа із випадаючого списку. Доступні такі значення: гривня, євро та долар США.

Снимок экрана 2026-06-08 в 16.02.46.png

Зображення 1 – Вибір валюти в документі «Підтвердження замовлення» (ORDRSP)

Зверніть увагу, що підтверджена кількість товарної позиції не може перевищувати кількість, зазначену в документі «Замовлення» (ORDERS). Усі зміни щодо товарних позицій необхідно попередньо узгоджувати з мережею АТБ.

Детальніше про процес створення, заповнення та відправки документа «Підтвердження замовлення» (ORDRSP) дивіться за посиланням.

Формування «Повідомлення про відвантаження» (DESADV)

Документ «Повідомлення про відвантаження» (DESADV) використовується для інформування мережі АТБ про фактичне відвантаження товару. Формування документа можливе як на підставі «Замовлення» (ORDERS), так і на підставі «Підтвердження замовлення» (ORDRSP).

Під час створення документа більшість реквізитів автоматично заповнюється на підставі документа-джерела. Дані, перенесені із «Замовлення» (ORDERS), заповнюються автоматично та недоступні до редагування.

Зверніть увагу, що кількість товару, яка постачається, не може перевищувати кількість, зазначену в документі «Замовлення» (ORDERS). Усі зміни щодо товарних позицій необхідно попередньо узгоджувати з мережею АТБ.

Після відправлення документ автоматично потрапляє до теки «Надіслані» та відображається в ланцюжку документів разом із пов’язаними документами документообігу.

Детальніше про процес створення, заповнення та відправки документа «Повідомлення про відвантаження» (DESADV) дивіться за посиланням.

Формування «Рахунку» (INVOICE)

Документ «Рахунок» (INVOICE) використовується для узгодження цін та виставлення рахунку на оплату. Формування документа можливе як на підставі «Замовлення» (ORDERS), так і на підставі «Підтвердження замовлення» (ORDRSP).

Під час створення документа необхідно перевірити коректність автоматично заповнених даних, вказати валюту рахунку, ставку ПДВ, реквізити накладної та дату доставки. Для міжнародних поставок дані в блоці «Інформація про постачальника» автоматично заповнюються на підставі інформації з GLN відправника та за потреби можуть бути відредаговані.

Усі зміни за товарними позиціями виконуються лише після узгодження з мережею АТБ.

Детальніше про процес створення, заповнення та відправки документа «Рахунок» (INVOICE) дивіться за посиланням.

Формування «Універсального документа» (CONDRA) на підставі відправленого «Повідомлення про відвантаження» (DESADV)

Детальніше про процес створення, заповнення та відправки документа Універсального документа» (CONDRA) дивіться за посиланням.

Документообіг з мережею «АТБ» на платформі EDI Network 2.0: «Міжнародні поставки». Інструкція Постачальника

Формування «Універсального документа» (CONDRA) на підставі відправленого «Повідомлення про відвантаження» (DESADV)

Для формування «Універсального документа» (CONDRA) на підставі «Повідомлення про відвантаження» (DESADV) необхідно:

  1. Перейдіть у теку «Надіслані» (Зображення 1, Покажчик 1).
  2. За потреби скористайтеся рядком пошуку (Зображення 1, Покажчик 2).
  3. Оберіть документ «Повідомлення про відвантаження» (DESADV), на підставі якого необхідно створити «Універсальний документ» (CONDRA) (Зображення 1, Покажчик 3).

Снимок экрана 2026-06-09 в 17.08.05.png

Зображення 1 – Вибір документа «Повідомлення про відвантаження» (DESADV) для створення «Універсального документа» (CONDRA)

Після відкриття документа «Повідомлення про відвантаження» створіть «Універсальний документ» за допомогою кнопки «Універсальний документ» (Зображення 2, Покажчик 1):

Снимок экрана 2026-06-09 в 17.16.58.png

Зображення 2 – Створення «Універсального документа» (CONDRA) на підставі документа «Повідомлення про відвантаження» (DESADV)

У відкритій формі «Універсального документа» перевірте коректність автоматично заповнених даних та заповніть обов’язкові поля, позначені символом (*) (Зображення 3):

Снимок экрана 2026-06-09 в 17.20.29.png

Зображення 3 – Форма «Універсального документа» (CONDRA) для перевірки та заповнення даних

Особливості заповнення полів Універсального документа

За допомогою кнопки «Оберіть файл» можливо додати супровідні документи у форматі PDF, наприклад сертифікати або інші вкладення. Для цього натисніть кнопку «Оберіть файл» (Зображення 4, Покажчик 1), виберіть необхідний файл (Зображення 4, Покажчик 2) та натисніть кнопку «Відкрити» (Зображення 4, Покажчик 3):

Снимок экрана 2026-06-09 в 17.32.08.png

Зображення 4 – Додавання файлу до «Універсального документа» (CONDRA)

Один документ може містити не більше 10 файлів у форматах:
PDF, JPG, JPEG, PNG, BMP, DOC, DOCX, XLS, XLSX, PPT, PPTX, CSV, TXT, XML, P7S.
Попередній перегляд недоступний для файлів у форматах CSV та P7S.
Розмір кожного файлу не повинен перевищувати 5 МБ.

Після додавання файлів у правому верхньому куті кожного файлу відображається його порядковий номер від загальної кількості доданих файлів. Для перегляду всіх доданих файлів використовуйте кнопки навігації (Зображення 5, Покажчик 1), а для видалення непотрібного файлу скористайтеся кнопкою видалення (Зображення 5, Покажчик 2).

Снимок экрана 2026-06-09 в 17.50.20.png

Зображення 5 – Перегляд та видалення доданих файлів.

Для доданих файлів доступний попередній перегляд їх вмісту:

  1. Змінювати масштаб перегляду (Зображення 6, Покажчик 1);
  2. Використовувати навігацію сторінками документа (Зображення 6, Покажчик 2);
  3. Друкувати файл (Зображення 6, Покажчик 3);
  4. Завантажувати файл на локальний носій (Зображення 6, Покажчик 4);
  5. Видаляти файл (Зображення 6, Покажчик 5).

Кнопка друку доступна лише для файлів у форматах PDF, JPG (JPEG), PNG та BMP.

Снимок экрана 2026-06-09 в 18.03.46.png

Зображення 6 – Попередній перегляд доданого файлу

Після внесення всіх необхідних даних до документа натисніть кнопку «Зберегти» (Зображення 7, Покажчик 1), а потім кнопку «Відправити» (Зображення 7, Покажчик 2).

Снимок экрана 2026-06-09 в 18.10.40.png

Зображення 7 – Збереження та відправлення «Універсального документа» (CONDRA)

Після відправлення «Універсальний документ» (CONDRA) автоматично надсилається Одержувачу та відображається в журналі документів зі статусом відправленого документа. За потреби Одержувач може створити у відповідь «Універсальний документ» (CONDRA) із запропонованими правками та коментарями.

Документообіг з мережею «АТБ». Інструкція для Постачальника

Документообіг з мережею «АТБ». Інструкція для Постачальника

Схема документообігу

Документообіг з мережею «АТБ». Інструкція для Постачальника

Постачання товару в ТОВ «АТБ-Маркет»

Документообіг з мережею «АТБ». Інструкція для Постачальника

Постачання товару в ТОВ «АТБ-Маркет» з поставкою через логістичного оператора ТОВ «Логістик Юніон»

Документообіг з мережею «АТБ» на платформі EDI Network 2.0: «Розподільчі центри». Інструкція для Постачальника

Документообіг з мережею «АТБ» на платформі EDI Network 2.0: «Розподільчі центри». Інструкція для Постачальника

Схема документообігу

Документообіг з мережею «АТБ» на платформі EDI Network 2.0: «Розподільчі центри». Інструкція для Постачальника

Формування «Підтвердження замовлення» (ORDRSP) у відповідь на вхідне «Замовлення» (ORDER). Сторона Постачальника

Документообіг з мережею «АТБ» на платформі EDI Network 2.0: «Розподільчі центри». Інструкція для Постачальника

Формування «Повідомлення про відвантаження» (DESADV). Сторона Постачальника

Документообіг з мережею «АТБ» на платформі EDI Network 2.0: «Розподільчі центри». Інструкція для Постачальника

Формування «Інструкції про повернення» (RETINS). Сторона Постачальника

Документообіг з мережею «АТБ» на платформі EDI Network 2.0: «Магазини»

Документообіг з мережею «АТБ» на платформі EDI Network 2.0: «Магазини»

Схема документообігу

Документообіг з мережею «АТБ» на платформі EDI Network 2.0: «Магазини»

Формування «Повідомлення про відвантаження» у відповідь на вхідне «Замовлення» (ORDER). Сторона Постачальника

XML Специфікації документів для роботи з «АТБ»

XML Специфікації документів для роботи з «АТБ»

XML специфікації електронних документів

API по роботі з квитанціями COMDOC документів!

У специфікаціях представлено опис полів XML-документів, які застосовуються в електронному обміні даними при роботі з мережею «АТБ» на платформі EDIN за схемою:

Снимок экрана 2026-06-08 в 10.24.48.png

Зображення 1 – Схема документообігу між мережею АТБ та Постачальником на платформі EDI Network 2.0.

XML Специфікації документів для роботи з «АТБ»

Замовлення (ORDER)

Замовлення (ORDER) на поставку відправляє покупець постачальнику, вказуючи штрих-код продукту, його опис, замовлену кількість, ціну та іншу необхідну інформацію.

Опис полів

Назва поля

Тип 1

Формат

Опис

ORDER

   

Початок документа

DOCUMENTNAME

M

Число позитивне

Назва документа (220 -замовлення)

NUMBER

M

Рядок (50)

Номер замовлення

DATE

M

Дата (РРРР-ММ-ДД)

Дата документа

ACTION

О

« 4 »,« 5 »,« 27 »,« 29 »

4 - поставка змінена, 5 - заміна документа, 29 - поставка прийнята, 27 - поставка не прийнята

EXCHANGE_SCHEMA_TYPE

O

 

лише для Фоззі: схема документообігу: 0-звичайна, 1-особлива

VERSION

O

Число позитивне (1-99)

Версія замовлення

PROMO

O

« 0 »,« 1 »

Акція: 0 - немає, 1 - є

DELIVERYDATE

M

Дата (РРРР-ММ-ДД)

Дата поставки

DELIVERYTIME

O

Час (год: хв)

Час поставки

SHIPMENTDATE

O

Дата (РРРР-ММ-ДД)

Дата відвантаження

SHIPMENTTIME

O

Час (год: хв)

Час відвантаження

CAMPAIGNNUMBER

O

Рядок (70)

Номер договору на поставку

CAMPAIGNNUMBERDATE

O

Дата (РРРР-ММ-ДД)

Дата договору

CURRENCY

M

Рядок (3)

Тризначний код валюти (наприклад, UAH, RUB, USD, EUR, MDL, BYR)

TRANSPORTQUANTITY

O

Число позитивне

Кількість машин

ORDERREFERENCENUMBER

 

Рядок (16)

Унікальний номер замовлення для відстеження

EXCISEDOCUMENT

O

« 0 »,« 1 »

Акцизний електронний документ (АЕД): 0 - Ні; 1 - Так

LIMES

   

Деталі транспорту (початок блоку)

LIMESNAME

O

Рядок (70)

Назва рампи

DATEFROM

O

Дата (РРРР-ММ-ДД)

Дата прибуття транспорту

TIMEFROM

O

Час (год: хв)

Час прибуття транспорту

DATETO

O

Дата (РРРР-ММ-ДД)

Дата закінчення відвантаження

TIMETO

O

Час (год: хв)

Час закінчення відвантаження

LIMES

   

Деталі транспорту (закінчення блоку)

VAT

O

Число позитивне

Ставка ПДВ,%

TRANSPORTATIONTYPES

O

Рядок (35)

Вид транспортування

TRANSPORTATIONMEANS

O

Рядок (70)

Транспортний засіб

TRANSPORTATIONCONDITION

O

Рядок (70)

Умови транспортування

TRANSPORTATIONPAYMENTTYPE

O

Рядок (35)

Тип оплати доставки (Умови оплати)

TRANSPORTATIONROUTE

O

Рядок (70)

Маршрут доставки

BLANKETORDERNUMBER

O

Рядок (35)

Номер бланкового замовлення

INFOCODED

O

Рядок (35)

Інфокод

DOCTYPE

O

Рядок (1)

Тип документа:

  • O - оригінал,

  • R - заміна,

  • D - видалення,

  • F - фіктивність замовлення,

  • PO - попереднє замовлення,

  • OS - замовлення на послугу / маркетинг

CORRNUMBER

     

SUPORDER

O

Рядок (35)

Номер замовлення постачальника

KDKNUM

O

Рядок (35)

Номер загального замовлення КДК

ORDRTYPE

O

Рядок (35)

Тип замовлення

INFO

O

Рядок (70)

Вільний текст

PREORDER

O

 

Попередні замовлення (початок блоку)

PREORDERNUM

O

Рядок (10)

Номер першого Попереднього замовлення (тег може бути використаний декілька разів)

PREORDER

O

 

Попередні замовлення (закінчення блоку)

EARLIESTDELIVERYDATE

O

Дата (РРРР-ММ-ДД)

Поставка не раніше зазначеної дати

LATESTDELIVERYDATE

O

Дата (РРРР-ММ-ДД)

Поставка не пізніше зазначеної дати

HEAD

   

Початок основного блоку

SUPPLIER

M

Число (13)

GLN постачальника

BUYER

M

Число (13)

GLN покупця

BUYERCODE

O

Рядок (35)

Код покупця

BRANCHCODE

O

Рядок

Код філіалу (для Нова Лінія та ЕПІЦЕНТР К )

DELIVERYPLACE

M

Число (13)

GLN місця доставки

FINALRECIPIENT

O

Число (13)

GLN кінцевого консигнатора

ORDERPARTNER

O

Число (13)

GLN замовника

INVOICEPARTNER

O

Число (13)

GLN платника

SENDER

M

Число (13)

GLN відправника повідомлення

RECIPIENT

M

Число (13)

GLN одержувача повідомлення

CONSIGNEE

О

Число (13)

GLN вантажоодержувача

RECIPIENTCODE

O

Рядок (35)

Код отримувача

RECIPIENTNAME

O

Рядок (70)

Ім’я одержувача

INFO

O

Рядок (70)

Вільний текст

DISCOUNTVALUE

O

Число позитивне

Розмір знижки

RECIPIENTCONTACTFACE

O

Рядок (70)

Контактна особа

RECIPIENTPHONE

O

Рядок (35)

Телефон одержувача

RECIPIENTCITY

O

Рядок (35)

Місто одержувача

RECIPIENTADRESS

O

Рядок (70)

Адреса одержувача

EDIINTERCHANGEID

O

Рядок (70)

Номер транзакції

POSITION

   

Товарні позиції (початок блоку)

POSITIONNUMBER

M

Число позитивне

Номер товарної позиції

PRODUCT

M

Число (8, 10, 14)

Штрихкод продукту

PRODUCTIDSUPPLIER

O

Рядок (16)

Артикул в БД

PRODUCTIDBUYER

O

Рядок (16)

Артикул в БД покупця

BUYERPARTNUMBER

О

Рядок (16)

Внутрішній системний номер артикулу в БД покупця

ORDEREDQUANTITY

M

Число позитивне

Замовлена ​​кількість

QUANTITYOFCUINTU

О

Число позитивне

Кількість в упаковці

ORDERUNIT

О

Рядок (3)

Одиниці виміру

QUANTITYOFPACKS

О

Число позитивне

Кількість упаковок

ORDERPRICE

M

Число десяткове

Ціна продукту без ПДВ

PRICEWITHVAT

O

Число десяткове

Ціна продукту з ПДВ

AMOUNT

O

Число десяткове

Сума товару (без ПДВ)

AMOUNTWITHVAT

О

Число десяткове

Сума товару (з ПДВ)

VAT

O

Число десяткове

Ставка ПДВ,%

CLAIMEDDELIVERYDATE

O

Дата (РРРР-ММ-ДД)

Оголошена дата доставки

CLAIMEDDELIVERYTIME

O

Час (год: хв)

Оголошений час доставки

DELIVERYPLACE

О

Число (13)

GLN кінцевого місця доставки

INFOCODED

O

Рядок (35)

Інфокод

MINIMUMORDERQUANTITY

O

Число позитивне

Мінімальна замовлена кількість

MAXIMUMORDERQUANTITY

O

Число позитивне

Максимально допустима відвантажувана кількість

PRODUCTIONCODE

О

Рядок (16)

Код алкогольної продукції

POSITIONKGM

O

 

Всього кілограм по позиції

INFO

O

Рядок (90)

Вільний текст

COMPAIGNNUMBER

O

Рядок (70)

Номер постачальника

EARLIESTDELIVERYDATE

O

Дата (РРРР-ММ-ДД)

Поставка не раніше зазначеної дати

LATESTDELIVERYDATE

O

Дата (РРРР-ММ-ДД)

Поставка не пізніше зазначеної дати

LATESTDELIVERYTIME

O

Час (год: хв)

Поставка не пізніше зазначеного часу

CONDITIONSTATUS

О

Рядок (3)

Статус кондиції

PACKAGEID

O

Число позитивне

Ідентифікатор упаковки

CATEGORYNAME

O

Рядок (70)

Найменування категорії товару

BRENDNAME

O

Рядок (70)

Найменування бренду

GROUPNAME

   

Найменування групи товару

NOVELTY

O

 

Новинка

COUNTPIECESINBOX

O

Число позитивне

Кількість частин в упаковці

COUNTBOXESINLAYER

O

Число позитивне

Кількість упаковок на 1 рівні

COUNTPERPALLET

O

Число позитивне

Кількість на палеті

WEIGHT

O

Число десяткове

Вага

PALLETS

O

Число позитивне

Кількість палет

COUNTRYORIGIN

О

Рядок (2)

Країна виробник

CALIBRE

O

Число позитивне

Діаметр

PRICEWITHDISCOUNT

O

Число десяткове

Ціна з урахуванням знижки

BOXESCOUNT

O

Число позитивне

Кількість упаковок

CHARACTERISTIC

   

Характеристики (початок блоку)

SERVICEDESCRIPTION

О/M (обов’язковий тільки для Замовлення послуги - ORDER з полем DOCTYPE=OS)

Рядок (500)

Назва послуги

DESCRIPTION

О

Рядок (70)

Опис продукту

CHARACTERISTIC

   

Характеристики (закінчення блоку)

PACKING

   

Упаковка (початок блоку)

PACKINGTYPE

O

Рядок (3)

Тип упаковки

PACKINGQUANTITY

O

Число позитивне

Кількість упаковок

PACKINGUNIT

O

Число позитивне

Пакувальник

PACKING

   

Упаковка (закінчення блоку)

POSITION

   

Товарні позиції (закінчення блоку)

HEAD

   

Закінчення основного блоку

ORDER

   

Закінчення документа

[1] - елементи структури мають наступний вигляд:
  • параметрЗіЗначенням;

  • об’єктЗПараметрами;

  • масивОб’єктів;

  • жовтим фоном виділяються комірки, в яких відбувались останні зміни

[2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
  • M (mandatory) — обов’язкові до заповнення поля;

  • O (optional) — необов’язкові (опціональні) для заповнення поля.


За цим посиланням можна завантажити XML-Приклад ORDER.xml

За цим посиланням можна завантажити JSON-Приклад ORDER.json

XML Специфікації документів для роботи з «АТБ»

Підтвердження замовлення (ORDRSP)

Підтвердження замовлення (ORDRSP) відправляється у відповідь на прийнятий документ Замовлення (ORDER). Основною особливістю Підтвердження замовлення є уточнення про постачання по кожній товарній позиції: чи буде товар доставлений; чи змінилася кількість/ціна чи буде відмова від поставки товарної позиції

Опис полів

Назва поля

Тип 1

Формат

Опис

ORDRSP

   

Початок документа

NUMBER

M

Рядок (50)

Номер підтвердження замовлення

DATE

M

Дата (РРРР-ММ-ДД)

Дата документа

TIME

O

Час (год: хв)

Час створення документа

ORDERNUMBER

M

Рядок (50)

Номер замовлення

ORDERDATE

M

Дата (РРРР-ММ-ДД)

Дата замовлення

DELIVERYDATE

O

Дата (РРРР-ММ-ДД)

Дата доставки

DELIVERYTIME

O

Час (год: хв)

Час поставки

SPECIFICATIONNUMBER

O

Рядок (10)

Номер специфікації

SPECIFICATIONDATE

O

Дата (РРРР-ММ-ДД)

Дата специфікації

SHIPMENTDATE

O

Дата (РРРР-ММ-ДД)

Дата відвантаження

CURRENCY

M

Рядок (3)

Код валюти

LIMES

   

Деталі транспорту (початок блоку)

LIMESNAME

O

Рядок (70)

Назва рампи

DATEFROM

O

Дата (РРРР-ММ-ДД)

Дата прибуття транспорту

TIMEFROM

O

Час (год: хв)

Час прибуття транспорту

DATETO

O

Дата (РРРР-ММ-ДД)

Дата закінчення відвантаження

TIMETO

O

Час (год: хв)

Час закінчення відвантаження

LIMES

   

Деталі транспорту (початок блоку)

VAT

O

Число позитивне

Ставка ПДВ,%

ACTION

О

« 4 »,« 5 »,« 27 »,« 29 »

4 - поставка змінена, 5 - заміна документа, 29 - поставка прийнята, 27 - поставка не прийнята

TRANSPORTATIONPAYMENTTYPE

O

Рядок (30)

Умови оплати

TOTALPACKAGES

O

Число десяткове

Кількість упаковок / Упаковка

TOTALPACKAGESSPACE

O

Число десяткове

Кількість місць для упаковок

TRANSPORTQUANTITY

O

Число позитивне

Кількість машин

DOCTYPE

О

Рядок (1)

Тип документа:

  • O - оригінал

  • R - заміна

  • D - видалення

SUPORDER

O

Рядок (35)

Номер замовлення постачальника

KDKNUM

O

Рядок (35)

Номер загального замовлення КДК

ORDRTYPE

O

Рядок (35)

Тип замовлення

INFO

O

Рядок (70)

Вільний текст

REASONINFO

O

Рядок (70)

Додаткова інформація

CAMPAIGNNUMBER

O

Рядок (70)

Номер договору

HEAD

   

Початок основного блоку

BUYER

M

Число (13)

GLN покупця

BUYERCODE

O

Рядок (35)

Код покупця

SUPPLIER

M

Число (13)

GLN постачальника

DELIVERYPLACE

M

Число (13)

GLN місця доставки

FINALRECIPIENT

O

Число (13)

GLN кінцевого консигнатора

INVOICEPARTNER

O

Число (13)

GLN платника

SENDER

M

Число (13)

GLN відправника повідомлення

RECIPIENT

M

Число (13)

GLN одержувача повідомлення

CONSIGNEE

O

Число (13)

GLN вантажоодержувача

RECIPIENTCODE

O

Рядок (35)

Код отримувача

RECIPIENTNAME

O

Рядок (70)

Ім’я одержувача

RECIPIENTCONTACTFACE

O

Рядок (70)

Контактна особа

RECIPIENTPHONE

O

Рядок (35)

Телефон одержувача

RECIPIENTCITY

O

Рядок (35)

Місто одержувача

RECIPIENTADRESS

O

Рядок (70)

Адреса одержувача

DELIVERYTERMS

   

Терміни доставки (в днях)

EDIINTERCHANGEID

O

Рядок (70)

Номер транзакції (Унікальний номер, що генерується відправником)

POSITION

   

Товарні позиції (початок блоку)

POSITIONNUMBER

M

Число позитивне

Номер товарної позиції (Порядковий номер товарної позиції в документі (1, 2, 3, 4 … n))

PRODUCT

M

Число (8, 10, 14)

Штрих-код продукту

PRODUCTIDBUYER

O

Рядок (16)

Артикул в БД покупця

PRODUCTIDSUPPLIER

O

Рядок (16)

Артикул в БД постачальника

ORDRSPUNIT

O

Рядок (3)

Одиниці виміру

CUSTOMSTARIFFNUMBER

О

Число позитивне

Код УКТЗЕД для кожної позиції

DESCRIPTION

O

Рядок (70)

Опис продукту

MAXORDERPRICE

O

Число десяткове (18,2)

Максимальна роздрібна ціна (МРЦ)

PRICE

O

Число десяткове

Ціна продукту без ПДВ

PRICEWITHVAT

O

Число десяткове

Ціна продукту з ПДВ

DISCOUNT

О

Число позитивне

Знижка

VAT

O

Рядок (3)

Ставка ПДВ,%

EXPAIRYDATE

O/M

Рядок (30)

Гарантійний термін. Поле обов’язкове для клієнтів Модерн Експо

AMOUNT

O

Число десяткове

Сума товару без ПДВ

AMOUNTWITHVAT

O

Число десяткове

Сума товару з ПДВ

TAXAMOUNT

М

Число десяткове

ПДВ

QUANTITYOFCUINTU

O

Число позитивне

Кількість в упаковці

PRODUCTTYPE

M

« 1 »,« 2 »,« 3 »

1 - товар буде поставлений без змін, 2 - зміна замовленої кількості ,,, 3 - відмовлено в постачанні ,,,

ORDEREDQUANTITY

M

Число позитивне

Замовлена кількість

ACCEPTEDQUANTITY

M

Число позитивне

Наявна кількість

MINIMUMORDERQUANTITY

O

Число позитивне

Мінімальна замовлена кількість

MAXIMUMORDERQUANTITY

О

Число позитивне

Максимально допустима відвантажувана кількість

INFO

O

Рядок (70)

Вільний текст

CONDITIONSTATUS

О

Рядок (3)

Статус кондиції

PACKAGEID

O

Число позитивне

Ідентифікатор упаковки

COUNTRYORIGIN

О

Рядок (2)

Країна виробник

CALIBRE

О

Число позитивне

Калібр упаковки string (30)

PACKING

   

Упаковка (початок блоку)

PACKINGTYPE

O

Рядок (3)

Тип упаковки

PACKINGQUANTITY

O

Число позитивне

Кількість упаковок

PACKINGUNIT

O

Число позитивне

Пакувальник

PACKING

   

Упаковка (закінчення блоку)

POSITION

   

Товарні позиції (закінчення блоку)

HEAD

   

Закінчення основного блоку

ORDRSP

   

Закінчення документа

[1] - елементи структури мають наступний вигляд:
  • параметрЗіЗначенням;

  • об’єктЗПараметрами;

  • масивОб’єктів;

  • жовтим фоном виділяються комірки, в яких відбувались останні зміни

[2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
  • M (mandatory) — обов’язкові до заповнення поля;

  • O (optional) — необов’язкові (опціональні) для заповнення поля.


За цим посиланням можна завантажити XML-Приклад ORDRSP_example.xml

За цим посиланням можна завантажити JSON-Приклад ORDRSP.json

XML Специфікації документів для роботи з «АТБ»

Повідомлення про відвантаження (DESADV)

Повідомлення про відвантаження (DESADV) відправляє постачальник у відповідь на Замовлення (ORDER). При цьому постачальник може змінити кількість замовлених товарних позицій, що поставляються, дату і час поставки, додаткові відомості. Даний документ є аналогом товарно-транспортної накладної (ТТН)

Опис полів

Назва поля

Тип 1

Формат

Опис

DESADV

   

Початок документа

NUMBER

M

Рядок (50)

Номер повідомлення про відвантаження

DATE

M

Дата (РРРР-ММ-ДД)

Дата документа

VERSION

M

Ціле позитивне число (1-99)

Версія документа (на рівні одного ланцюжка документів). При заміні документа (номер документа зберігається) потрібно збільшувати значення на одиницю (n+1)

DELIVERYDATE

M

Дата (РРРР-ММ-ДД)

Дата поставки

DELIVERYTIME

O

Час (год: хв)

Час поставки

ORDERNUMBER

M

Рядок (50)

Номер замовлення

ORDERDATE

M

Дата (РРРР-ММ-ДД)

Дата замовлення

ORDRSPNUMBER

O

Рядок (16)

Номер підтвердження замовлення

ORDRSPDATE

O

Дата (РРРР-ММ-ДД)

Дата підтвердження замовлення

DELIVERYNOTENUMBER

O

Рядок (16)

Номер накладної

DELIVERYNOTEDATE

O

Дата (РРРР-ММ-ДД)

Дата накладної

RECIPTYPE

O

Рядок (1)

Доступні значення:

  • 0 - «Пряма поставка на АТБ» (за замовчуванням),

  • 1 - «Поставка зі складів Логістик Юніон».

INFO

O

Рядок (70)

Вільний текст

PAYMENTTERM

O

Дата (РРРР-ММ-ДД)

Кінцева дата оплати товару

SHIPMENTS

O

Рядок (1)

Перевезення

CAMPAIGNNUMBER

O

Рядок (70)

Номер договору на поставку

TRANSPORTERTYPE

O

Рядок (70)

Тип транспорту

TRANSPORTTYPE

О

Рядок (2, 3)

Тип транспортування: 20 - залізничний, 30 - дорожній, 40 - повітряний, 60 - спарений, 100 - кур’єрська служба

PACKAGEWEIGHT

O

Decimal (18,3) / Розділення крапкою

Вага по накладній

HEAD

   

Початок основного блоку

SUPPLIER

M

Число (13)

GLN постачальника

BUYER

M

Число (13)

GLN покупця

DELIVERYPLACE

M

Число (13)

GLN місця доставки

FINALRECIPIENT

O

Число (13)

GLN кінцевого консигнатора

SENDER

M

Число (13)

GLN відправника повідомлення

RECIPIENT

M

Число (13)

GLN одержувача повідомлення

EDIINTERCHANGEID

O

Рядок (70)

Номер транзакції

PACKINGSEQUENCE

   

Робота з товарними позиціями (початок блоку)

HIERARCHICALID

M

Число позитивне

Номер ієрархії упаковки

POSITION

   

Товарні позиції (початок блоку)

POSITIONNUMBER

M

Число позитивне

Номер товарної позиції

PRODUCT

M

Число (8, 10, 14)

Штрихкод продукту

PRODUCTIDSUPPLIER

O

Рядок (16)

Артикул в БД постачальника

IDPRODUCER

O

Рядок (8)

Код виробника

PRODUCTIDBUYER

O

Рядок (16)

Артикул в БД покупця

BUYERNUMBER

О

Число ціле (16)

Внутрішній системний номер артикулу в БД покупця

DELIVEREDQUANTITY

M

Число позитивне

кількість, що поставляється

DELIVEREDUNIT

O

Рядок (3)

Одиниці виміру

ORDEREDQUANTITY

O

Число позитивне

Замовлена кількість

ORDERUNIT

O

Рядок (3)

Одиниці виміру

AMOUNT

O

Число десяткове

Сума товару без ПДВ

AMOUNTWITHVAT

O

Число десяткове

Сума товару з ПДВ

CUSTOMSTARIFFNUMBER

O

Число (4-10)

Код УКТЗЕД / Номер державної митної декларації (ВМД)

ADVICEPRICE

O

Число ціле з трьома знаками після коми

Рекомендована ціна (державою)

PRICE

O

Число десяткове

Ціна продукту без ПДВ

PRICEWITHVAT

O

Число десяткове

Ціна продукту з ПДВ

TAXRATE

O/M

20/19/16/14/7/2/0

Ставка ПДВ (20%, 19%, 16%, 14%, 7%, 2%, 0%). Поле обовʼязкове при роботі з ЮЗД (Видатковою накладною (COMDOC_006) та Актом приймання-передачі (додаток 8) (COMDOC_032))

DESCRIPTION

O

Рядок (70)

Опис продукту

GOODDATE

O

Дата (РРРР-ММ-ДД)

Термін придатності

BRUTTOWEIGHT

O

Decimal (18,3) / Розділення крапкою

Вага брутто

POSITION

   

Товарні позиції (закінчення блоку)

PACKINGSEQUENCE

   

Робота з товарними позиціями (закінчення блоку)

HEAD

   

Закінчення основного блоку

BRANCH_UUID

O

Рядок (36)

UUID гілки поставки (автоматично заповнюється платформою EDIN 2.0); приклад значення: 7b6cc5d8-9e5d-1cf7-adc9-196836579863

DESADV

   

Закінчення документа

[1] - елементи структури мають наступний вигляд:
  • параметрЗіЗначенням;

  • об’єктЗПараметрами;

  • масивОб’єктів;

  • жовтим фоном виділяються комірки, в яких відбувались останні зміни

[2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
  • M (mandatory) — обов’язкові до заповнення поля;

  • O (optional) — необов’язкові (опціональні) для заповнення поля.


За цим посиланням можна завантажити XML-Приклад DESADV_example.xml

За цим посиланням можна завантажити JSON-Приклад DESADV.json

XML Специфікації документів для роботи з «АТБ»

Транспортні документи: ТТН + Акти

№ з/п Параметр² Тип¹ Формат Опис
  UAECMR M   Початок документа
I eCMR M   Початок змісту документа
1 ExchangedDocumentContext M   Технічні дані
1.1 ram:SpecifiedTransactionID M int Номер версії документа (транзакції) в ланцюгу підписання документів
1.2.1 ram:BusinessProcessSpecifiedDocumentContextParameter.ram:ID M string код типу документа = urn:ua:e-transport.gov.ua:ettn:01
1.3.1 ram:GuidelineSpecifiedDocumentContextParameter.ram:ID M string код підтипу документа:
* urn:ua:e-transport.gov.ua:ettn:01:generic:001 - generic (default)
* urn:ua:e-transport.gov.ua:ettn:01:milk:002
* urn:ua:e-transport.gov.ua:ettn:01:alcohol:003
* urn:ua:e-transport.gov.ua:ettn:01:spirit:004
* urn:ua:e-transport.gov.ua:ettn:01:highOctaneOxygenAdditives:005
* urn:ua:e-transport.gov.ua:ettn:01:oil:006
* urn:ua:e-transport.gov.ua:ettn:01:wood:007
* urn:ua:e-transport.gov.ua:ettn:01:bread:008
* urn:ua:e-transport.gov.ua:ettn:01:medicines:009
* urn:ua:e-transport.gov.ua:ettn:01:otherExcisableGoods:010
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:IncludedNote М   Додані записи
2.3.1.1 ram:ContentCode.listAgencyID M String Ідентифікатор:

* consignmentItemQuantity_text (кількість місць словами)
* grossWeightMeasure_text (масса бруто словами)
* associatedInvoiceAmount_text (усього відпущено на загальну суму словами)
* vatAmount (у тому числі ПДВ - число)
* vatAmount_text (у тому числі ПДВ - текст)
* vehicle_length (сплюсована довжина транпортного засобу / автопоїзда в метрах (число))
* vehicle_width (максимальна ширина транпортного засобу / автопоїзда в метрах (число))
* vehicle_height (максимальна висота транпортного засобу / автопоїзда в метрах (число))
* gross_vehicle_weight_with_cargo (загальна маса транпортного засобу / автопоїзда з вантажем в кілограмах (число))
2.3.1.2 ram:ContentCode.value M * Число (3)
* «Так» / «Ні»
* Рядок
Значення ідентифікатора:

* для consignmentItemQuantity_text = Рядок
* для grossWeightMeasure_text = Рядок
* для associatedInvoiceAmount_text = Рядок
* для vatAmount = Число
* для vatAmount_text = Рядок
* для vehicle_length = Число
* для vehicle_width = Число
* для vehicle_height = Число
* для gross_vehicle_weight_with_cargo = Число
2.3.2 ram:Content M string Код ролі учасника.

Ідентифікатори:
* consignmentItemQuantity_text
* grossWeightMeasure_text
* associatedInvoiceAmount_text
* vatAmount
* vatAmount_text
* vehicle_length
* vehicle_width
* vehicle_height
* gross_vehicle_weight_with_cargo вказуються контрагентом з роллю «Вантажовідправник» (CZ).
2.4.1 issueLogisticsLocation.ram:Name M string Можливе тільки одне значення "Місце складання документу"
2.4.2 issueLogisticsLocation.ram:Description M string Опис (адреса) місця складання ТТН
3 SpecifiedSupplyChainConsignment M   Інформація про перевезення
3.1.1 ram:GrossWeightMeasure.unitCode M string Вага брутто. Можливе тільки одне значення "KGM"
3.1.2 ram:GrossWeightMeasure.value M decimal Значення
3.2.1 ram:AssociatedInvoiceAmount.currencyID M string Тризначний код валюти (UAH)
3.2.2 ram:AssociatedInvoiceAmount.value M decimal Значення
3.3 ram:ConsignmentItemQuantity M decimal Загальна кількість місць вантажу (контейнерів)
3.4 ram: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 М   Юридична адреса Вантажовідправника
3.4.5.1 ram:PostcodeCode M 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 M string Область та район (за наявності)
3.4.6.1 ram:SpecifiedTaxRegistration.ram:ID O string РНОКПП відповідальної особи
3.4.7 ram:SpecifiedGovernmentRegistration M   GLN Вантажовідправника (блок обов'язковий до заповнення для відправника транзакції) / УНЗР (за наявності) Вантажовідправника
3.4.7.1 ram:ID M string GLN Вантажовідправника (поле обов'язкове до заповнення для відправника транзакції)
3.4.7.2 ram:TypeCode M string TRADEPARTY_GLN
3.4.7.3 ram:ID М/O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.4.7.4 ram:TypeCode М/O string TRADEPARTY_UNZR
3.5 ram:ConsigneeTradeParty 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 Роль учасника (Вантажоодержувач - CN). Довідник ролей
3.5.4 ram:DefinedTradeContact O   Контакти відповідального представника
3.5.4.1 ram:PersonName O 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 М   Юридична адреса Вантажоодержувача
3.5.5.1 ram:PostcodeCode M 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 M string Область та район (за наявності)
3.5.6.1 ram:SpecifiedTaxRegistration.ram:ID O string РНОКПП відповідальної особи
3.5.7 ram:SpecifiedGovernmentRegistration M   GLN Вантажоодержувача (блок обов'язковий до заповнення для відправника транзакції) / УНЗР (за наявності) Вантажоодержувача
3.5.7.1 ram:ID M string GLN Вантажоодержувача (поле обов'язкове до заповнення для відправника транзакції)
3.5.7.2 ram:TypeCode M string TRADEPARTY_GLN
3.5.7.3 ram:ID М/О string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.5.7.4 ram:TypeCode М/О string TRADEPARTY_UNZR
3.6 ram:CarrierTradeParty M   Перевізник
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 Роль учасника (Перевізник - CA). Довідник ролей
3.6.4 ram:DefinedTradeContact M   Контакти відповідального представника
3.6.4.1 ram:PersonName M 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 М   Юридична адреса Перевізника
3.6.5.1 ram:PostcodeCode M 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 M string Область та район (за наявності)
3.6.6.1 ram:SpecifiedTaxRegistration.ram:ID M string РНОКПП відповідальної особи (водія)
3.6.7 ram:SpecifiedGovernmentRegistration M   Посвідчення Водія, GLN Перевізника / GLN Водія / УНЗР (за наявності) Перевізника / УНЗР (за наявності) Водія
3.6.7.1 ram:ID M string Серія та номер водійського посвідчення Водія. Заповнюється в форматі «3 заголовні кириличні або латинські літери + 6 цифр без пробілів», наприклад: АБВ123456, DGJ123456
3.6.7.2 ram:ID M string GLN Перевізника (поле обов'язкове до заповнення для відправника транзакції)
3.6.7.3 ram:TypeCode M string TRADEPARTY_GLN
3.6.7.4 ram:ID О string GLN Водія
3.6.7.5 ram:TypeCode О string DRIVER_GLN
3.6.7.6 ram:ID М/O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.6.7.7 ram:TypeCode М/O string TRADEPARTY_UNZR
3.6.7.8 ram:ID М/O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.6.7.9 ram:TypeCode М/O string DRIVER_UNZR
3.7 ram:NotifiedTradeParty (роль - FW) O   Експедитор
3.7.1.1 ram:ID.schemeAgencyID M string "ЄДРПОУ"/"РНОКПП" Експедитора
3.7.1.2 ram:ID.value M string Значення
3.7.2 ram:Name M string Повне найменування Експедитора (юридичної особи або фізичної особи - підприємця) або прізвище, ім’я, по батькові фізичної особи, з яким вантажовідправник (замовник) уклав договір траспортного експедирування
3.7.3 ram:RoleCode M string Роль учасника (Експедитор - FW). Довідник ролей
3.7.4 ram:DefinedTradeContact O   Контакти відповідального представника
3.7.4.1 ram:PersonName O string ПІБ
3.7.4.2.1 ram:TelephoneUniversalCommunication.ram:CompleteNumber O string Основний телефон
3.7.4.3.1 ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber O string Мобільний телефон
3.7.4.4.1 ram:EmailURIUniversalCommunication.ram:CompleteNumber O string Електронна адреса
3.7.5 ram:PostalTradeAddress М   Юридична адреса Експедитора
3.7.5.1 ram:PostcodeCode M string Індекс
3.7.5.2 ram:StreetName M string Адреса (назва вулиці + номер будівлі)
3.7.5.3 ram:CityName M string Місто (назва населеного пункту)
3.7.5.4 ram:CountryID M string Країна (UA)
3.7.5.5 ram:CountrySubDivisionName M string Область та район (за наявності)
3.7.6.1 ram:SpecifiedTaxRegistration.ram:ID O string РНОКПП відповідальної особи
3.7.7 ram:SpecifiedGovernmentRegistration M   GLN Експедитора (блок обов'язковий до заповнення для відправника транзакції) / УНЗР (за наявності) Експедитора
3.7.7.1 ram:ID M string GLN Експедитора (поле обов'язкове до заповнення для відправника транзакції)
3.7.7.2 ram:TypeCode M string TRADEPARTY_GLN
3.7.7.3 ram:ID М/O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.7.7.4 ram:TypeCode М/O string TRADEPARTY_UNZR
3.8 ram:NotifiedTradeParty (роль - OB) M   Замовник
3.8.1.1 ram:ID.schemeAgencyID M string "ЄДРПОУ"/"РНОКПП" Замовника
3.8.1.2 ram:ID.value M string Значення
3.8.2 ram:Name M string Повне найменування Замовника (юридичної особи або фізичної особи - підприємця) або прізвище, ім’я, по батькові фізичної особи, що проводить оплату транспортної роботи і послуг
3.8.3 ram:RoleCode M string Роль учасника (Замовник - OB). Довідник ролей
3.8.4 ram:DefinedTradeContact O   Контакти відповідального представника
3.8.4.1 ram:PersonName O string ПІБ
3.8.4.2.1 ram:TelephoneUniversalCommunication.ram:CompleteNumber O string Основний телефон
3.8.4.3.1 ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber O string Мобільний телефон
3.8.4.4.1 ram:EmailURIUniversalCommunication.ram:CompleteNumber O string Електронна адреса
3.8.5 ram:PostalTradeAddress М   Юридична адреса Замовника
3.8.5.1 ram:PostcodeCode M string Індекс
3.8.5.2 ram:StreetName M string Адреса (назва вулиці + номер будівлі)
3.8.5.3 ram:CityName M string Місто (назва населеного пункту)
3.8.5.4 ram:CountryID M string Країна (UA)
3.8.5.5 ram:CountrySubDivisionName M string Область та район (за наявності)
3.8.6.1 ram:SpecifiedTaxRegistration.ram:ID O string РНОКПП відповідальної особи
3.8.7 ram:SpecifiedGovernmentRegistration M   GLN Замовника (блок обов'язковий до заповнення для відправника транзакції) / УНЗР (за наявності) Замовника
3.8.7.1 ram:ID М string GLN Замовника
3.8.7.2 ram:TypeCode М string TRADEPARTY_GLN
3.8.7.3 ram:ID М/O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.8.7.4 ram:TypeCode М/O string TRADEPARTY_UNZR
3.9 ram:NotifiedTradeParty (роль - WD) O   Проміжний склад
3.9.1.1 ram:ID.schemeAgencyID M string "ЄДРПОУ"/"РНОКПП" Проміжного складу
3.9.1.2 ram:ID.value M string Значення
3.9.2 ram:Name M string Повне найменування Проміжного складу (Вантажовідправник/Перевізник/Експедитор/Вантажоодержувач/Товарний склад), що приймає від Перевізника на тимчасове зберігання вантаж
3.9.3 ram:RoleCode M string Роль учасника (Проміжний склад - WD). Довідник ролей
3.9.4 ram:DefinedTradeContact O   Контакти відповідального представника
3.9.4.1 ram:PersonName O string ПІБ
3.9.4.2.1 ram:TelephoneUniversalCommunication.ram:CompleteNumber O string Основний телефон
3.9.4.3.1 ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber O string Мобільний телефон
3.9.4.4.1 ram:EmailURIUniversalCommunication.ram:CompleteNumber O string Електронна адреса
3.9.5 ram:PostalTradeAddress М   Юридична адреса Проміжного складу
3.9.5.1 ram:PostcodeCode M string Індекс
3.9.5.2 ram:StreetName M string Адреса (назва вулиці + номер будівлі)
3.9.5.3 ram:CityName M string Місто (назва населеного пункту)
3.9.5.4 ram:CountryID M string Країна (UA)
3.9.5.5 ram:CountrySubDivisionName M string Область та район (за наявності)
3.9.6.1 ram:SpecifiedTaxRegistration.ram:ID O string РНОКПП відповідальної особи
3.9.7 ram:SpecifiedGovernmentRegistration M   GLN Проміжного складу (блок обов'язковий до заповнення для відправника транзакції) / УНЗР (за наявності) Проміжного складу
3.9.7.1 ram:ID M string GLN Проміжного складу (поле обов'язкове до заповнення для відправника транзакції)
3.9.7.2 ram:TypeCode M string TRADEPARTY_GLN
3.9.7.3 ram:ID М/O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.9.7.4 ram:TypeCode М/O string TRADEPARTY_UNZR
3.10 ram:NotifiedTradeParty (роль - COP) O   Охоронна компанія
3.10.1.1 ram:ID.schemeAgencyID M string "ЄДРПОУ"/"РНОКПП" Охоронної компанії
3.10.1.2 ram:ID.value M string Значення
3.10.2 ram:Name M string Повне найменування Охоронної компанії, що надає охоронні послуги вантажу під час перевезення
3.10.3 ram:RoleCode M string Роль учасника (Охоронна компанія - COP). Довідник ролей
3.10.4 ram:DefinedTradeContact O   Контакти відповідального представника
3.10.4.1 ram:PersonName O string ПІБ представника Замовника, який уповноважений супроводжувати вантаж, що підлягає спеціальній охороні
3.10.5 ram:PostalTradeAddress М   Юридична адреса Перевізника
3.10.5.1 ram:PostcodeCode M string Індекс
3.10.5.2 ram:StreetName M string Адреса (назва вулиці + номер будівлі)
3.10.5.3 ram:CityName M string Місто (назва населеного пункту)
3.10.5.4 ram:CountryID M string Країна (UA)
3.10.5.5 ram:CountrySubDivisionName M string Область та район (за наявності)
3.10.6 ram:SpecifiedGovernmentRegistration M   GLN попереднього Учасника (блок обов'язковий до заповнення для відправника транзакції) / УНЗР (за наявності) попереднього Учасника
3.10.6.1 ram:ID М string GLN Охоронної Компанії (поле обов'язкове до заповнення для відправника транзакції)
3.10.6.2 ram:TypeCode М string TRADEPARTY_GLN
3.10.6.3 ram:ID М/O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.10.6.4 ram:TypeCode М/O string TRADEPARTY_UNZR
3.11 ram:NotifiedTradeParty (роль - CH) -/M   Новий Перевізник (додаєтсья в ТТН до старту життєвого циклу "Акту Перевантаження") - схема
3.11.1.1 ram:ID.schemeAgencyID M string "ЄДРПОУ"/"РНОКПП" нового Перевізника
3.11.1.2 ram:ID.value M string Значення
3.11.2 ram:Name M string Повне найменування нового Перевізника (юридичної особи або фізичної особи - підприємця) або прізвище, ім’я, по батькові фізичної особи, що проводить оплату транспортної роботи і послуг
3.11.3 ram:RoleCode M string Роль учасника (новий Перевізник - CH). Довідник ролей
3.11.4 ram:DefinedTradeContact O   Контакти відповідального представника
3.11.4.1 ram:PersonName O string ПІБ
3.11.4.2.1 ram:TelephoneUniversalCommunication.ram:CompleteNumber O string Основний телефон
3.11.4.3.1 ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber O string Мобільний телефон
3.11.4.4.1 ram:EmailURIUniversalCommunication.ram:CompleteNumber O string Електронна адреса
3.11.5 ram:PostalTradeAddress М   Юридична адреса нового Перевізника
3.11.5.1 ram:PostcodeCode M string Індекс
3.11.5.2 ram:StreetName M string Адреса (назва вулиці + номер будівлі)
3.11.5.3 ram:CityName M string Місто (назва населеного пункту)
3.11.5.4 ram:CountryID M string Країна (UA)
3.11.5.5 ram:CountrySubDivisionName M string Область та район (за наявності)
3.11.6.1 ram:SpecifiedTaxRegistration.ram:ID O string РНОКПП відповідальної особи
3.11.7 ram:SpecifiedGovernmentRegistration M   GLN нового Перевізника (блок обов'язковий до заповнення для відправника транзакції) / УНЗР (за наявності) нового Перевізника
3.11.7.1 ram:ID M string GLN нового Перевізника (поле обов'язкове до заповнення для відправника транзакції)
3.11.7.2 ram:TypeCode M string TRADEPARTY_GLN
3.11.7.3 ram:ID М/O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.11.7.4 ram:TypeCode М/O string TRADEPARTY_UNZR
3.11.7.5 ram:ID M string Серія та номер водійського посвідчення Водія. Заповнюється в форматі «3 заголовні кириличні або латинські літери + 6 цифр без пробілів», наприклад: АБВ123456, DGJ123456
3.11.7.6 ram:ID О string GLN Водія
3.11.7.7 ram:TypeCode О string DRIVER_GLN
3.11.7.8 ram:ID М/O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.11.7.9 ram:TypeCode М/O string DRIVER_UNZR
3.12 ram:NotifiedTradeParty (роль - CJ) -/M   Попередній Учасник (додаєтсья в ТТН після завершення життєвого циклу Акту).

Для "Акту Перевантаження" - це попередній Перевізник (позитивний флоу Акту) або новий Перевізник (негативний флоу Акту) - схема;

Для "Акту про заміну пункту призначення вантажу" - це попередній Вантажоодержувач
3.12.1.1 ram:ID.schemeAgencyID M string "ЄДРПОУ"/"РНОКПП" попереднього Учасника
3.12.1.2 ram:ID.value M string Значення
3.12.2 ram:Name M string Повне найменування попереднього Учасника (юридичної особи або фізичної особи - підприємця) або прізвище, ім’я, по батькові фізичної особи, що проводить оплату транспортної роботи і послуг
3.12.3 ram:RoleCode M string Роль учасника (попередній Учасник - CJ). Довідник ролей
3.12.4 ram:DefinedTradeContact O   Контакти відповідального представника
3.12.4.1 ram:PersonName O string ПІБ
3.12.4.2.1 ram:TelephoneUniversalCommunication.ram:CompleteNumber O string Основний телефон
3.12.4.3.1 ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber O string Мобільний телефон
3.12.4.4.1 ram:EmailURIUniversalCommunication.ram:CompleteNumber O string Електронна адреса
3.12.5 ram:PostalTradeAddress М   Юридична адреса попереднього Учасника
3.12.5.1 ram:PostcodeCode M string Індекс
3.12.5.2 ram:StreetName M string Адреса (назва вулиці + номер будівлі)
3.12.5.3 ram:CityName M string Місто (назва населеного пункту)
3.12.5.4 ram:CountryID M string Країна (UA)
3.12.5.5 ram:CountrySubDivisionName M string Область та район (за наявності)
3.12.6.1 ram:SpecifiedTaxRegistration.ram:ID O string РНОКПП відповідальної особи
3.12.7 ram:SpecifiedGovernmentRegistration M   GLN попереднього Учасника (блок обов'язковий до заповнення для відправника транзакції) / УНЗР (за наявності) попереднього Учасника
3.12.7.1 ram:ID М string GLN попереднього Учасника (поле обов'язкове до заповнення для відправника транзакції)
3.12.7.2 ram:TypeCode М string TRADEPARTY_GLN
3.12.7.3 ram:ID М/O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.12.7.4 ram:TypeCode М/O string TRADEPARTY_UNZR
3.12.7.5 ram:ID M string Серія та номер водійського посвідчення Водія. Заповнюється в форматі «3 заголовні кириличні або латинські літери + 6 цифр без пробілів», наприклад: АБВ123456, DGJ123456. (якщо попередній учасник був Перевізником)
3.12.7.6 ram:ID О string GLN Водія (якщо попередній учасник був Перевізником)
3.12.7.7 ram:TypeCode О string DRIVER_GLN (якщо попередній учасник був Перевізником)
3.12.7.8 ram:ID М/O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ. (якщо попередній учасник був Перевізником)
3.12.7.9 ram:TypeCode М/O string DRIVER_UNZR (якщо попередній учасник був Перевізником)
3.13 ram:CarrierAcceptanceLogisticsLocation M   Пункт навантаження
3.13.1.1 ram:ID.schemeAgencyID M string КАТОТТГ пункту навантаження
3.13.1.2 ram:ID.value M string Значення
3.13.2 ram:Name M string Найменування пункту навантаження
3.13.3 ram:TypeCode M decimal Тип операції: 10 - навантаження; 5 - розвантаження
3.13.4 ram:Description M string Опис (адреса) пункту навантаження
3.13.5 ram:PhysicalGeographicalCoordinate M   Географічні координати
3.13.5.1 ram:LatitudeMeasure O string Географічні координати (Широта)
3.13.5.2 ram:LongitudeMeasure O string Географічні координати (Довгота)
3.13.5.3.1 ram:SystemID.schemeAgencyID M string GLN
3.13.5.3.2 ram:SystemID.value M decimal Значення
3.14 ram:ConsigneeReceiptLogisticsLocation M   Пункт розвантаження
3.14.1.1 ram:ID.schemeAgencyID M string КАТОТТГ пункту розвантаження
3.14.1.2 ram:ID.value M string Значення
3.14.2 ram:Name M string Найменування пункту розвантаження
3.14.3 ram:TypeCode M decimal Тип операції: 10 - навантаження; 5 - розвантаження
3.14.4 ram:Description M string Опис (адреса) пункту розвантаження
3.14.5 ram:PhysicalGeographicalCoordinate M   Географічні координати
3.14.5.1 ram:LatitudeMeasure O string Географічні координати (Широта)
3.14.5.2 ram:LongitudeMeasure O string Географічні координати (Довгота)
3.14.5.3.1 ram:SystemID.schemeAgencyID M string GLN
3.14.5.3.2 ram:SystemID.value M decimal Значення
3.15 ram:AssociatedReferencedDocument (TypeCode=723) O   Супровідні документи на вантаж. Документ, що підтверджує охоронні послуги
3.15.1 ram:TypeCode M decimal Тип 723 - використовується при зазначенні документа, що підтверджує надання спеціальних охоронних послуг (довідник кодів документів МІУ + довідник внутрішніх кодів документів EDIN)
3.15.2 ram:ID M string Номер документа, згідно з яким представник Замовника уповноважений супроводжувати вантаж, який підлягає спеціальній охороні
3.15.3 ram:Remarks O string UUID супровідного документа
3.15.4.1 ram:FormattedIssueDateTime.qdt:DateTimeString O datetime
(2021-12-13T14:19:23+02:00)
Дата та час складання супровідного документа
3.16 ram:AssociatedReferencedDocument (TypeCode=290) O   Супровідні документи на вантаж. Запис про передачу права на пред’явлення претензії
3.16.1 ram:TypeCode M decimal Тип 290 - використовується при зазначенні передачі права предʼявлення претензії (довідник кодів документів МІУ + довідник внутрішніх кодів документів EDIN)
3.16.2 ram:ID O string Номер документа
3.16.3 ram:Remarks O string UUID супровідного документа
3.16.4.1 ram:FormattedIssueDateTime.qdt:DateTimeString O datetime
(2021-12-13T14:19:23+02:00)
Дата та час складання супровідного документа
3.17 ram:AssociatedReferencedDocument (TypeCode=916) O   Супровідні документи на вантаж. Коригуючі акти
3.17.1 ram:TypeCode M decimal Тип 916 - використовується при формуванні актів, для вказання попередньої транзакції поточного акту (довідник кодів документів МІУ + довідник внутрішніх кодів документів EDIN)
3.17.2 ram:ID M string Номер акта
3.17.3 ram:Remarks O string UUID супровідного документа
3.17.4.1 ram:FormattedIssueDateTime.qdt:DateTimeString O datetime
(2021-12-13T14:19:23+02:00)
Дата та час складання супровідного документа
3.18 ram:AssociatedReferencedDocument (TypeCode=220) М   Супровідні документи на вантаж. Замовлення
3.18.1 ram:TypeCode M decimal Тип 220 - заповнюється на основі замовлення, для якого формується ТТН
3.18.2 ram:ID M string Номер акта
3.18.3 ram:Remarks M string UUID супровідного документа
3.18.4.1 ram:FormattedIssueDateTime.qdt:DateTimeString M datetime
(2021-12-13T14:19:23+02:00)
Дата та час складання супровідного документа
3.19 ram:AssociatedReferencedDocument (TypeCode=351) M   Супровідні документи на вантаж. Повідомлення про відвантаження
3.19.1 ram:TypeCode M decimal Тип 351 - заповнюється на основі повідомлення про відвантаження, для якого створюється ТТН
3.19.2 ram:ID M string Номер акта
3.19.3 ram:Remarks M string UUID супровідного документа
3.19.4.1 ram:FormattedIssueDateTime.qdt:DateTimeString M datetime
(2021-12-13T14:19:23+02:00)
Дата та час складання супровідного документа
3.20 ram:AssociatedReferencedDocument (інші) O   Інші супровідні документи
3.20.1 ram:TypeCode O decimal Тип:

* код 290 - Право на предʼявлення претензії
* код 335 - Заявка на транспортування (TRANSPORTATIONORDER/SUBDOCTYPE=1)
* код 441 - Маршрутний лист / рейс
* код 770 - Підтвердження заявки на транспортування (TRANSPORTATIONORDER/SUBDOCTYPE=2)
3.20.2 ram:ID O string Номер документа
3.20.3 ram:Remarks O string UUID супровідного документа
3.20.4.1 ram:FormattedIssueDateTime.qdt:DateTimeString O datetime
(2021-12-13T14:19:23+02:00)
Дата та час складання супровідного документа
3.21 ram:DeliveryTransportEvent M   Розвантажувальні роботи
3.21.1.1 ram:ActualOccurrenceDateTime.udt:DateTime M datetime
(2021-12-13T14:19:23+02:00)
Дата та час прибуття автомобіля на розвантаження
3.21.2.1 ram:ScheduledOccurrenceDateTime.udt:DateTime M datetime
(2021-12-13T14:19:23+02:00)
Дата та час вибуття автомобіля з-під розвантаження
3.21.3 ram:CertifyingTradeParty (RoleCode=CN) M   Інформація про відповідальних осіб Вантажоодержувача
3.21.3.1.1 ram:ID.schemeAgencyID M string "РНОКПП" Вантажоодержувача
3.21.3.1.2 ram:ID.value M decimal Значення
3.21.3.2 ram:Name M string Посада матеріально відповідальної особи вантажоодержувача
3.21.3.3 ram:RoleCode M string Роль учасника (Вантажоодержувач - CN). Довідник ролей
3.21.3.4.1 ram:DefinedTradeContact.ram:PersonName M string ПІБ матеріально відповідальної особи вантажоодержувача
3.21.3.5.1 ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber O string Мобільний телефон
3.21.4 ram:CertifyingTradeParty (RoleCode=DR) O   Інформація про водія Перевізника
3.21.4.1.1 ram:ID.schemeAgencyID O string "РНОКПП" Водія
3.21.4.1.2 ram:ID.value O decimal Значення
3.21.4.2 ram:Name M string Посада водія, що здав вантаж
3.21.4.3 ram:RoleCode M string Роль учасника (Водій - DR). Довідник ролей
3.21.4.4.1 ram:DefinedTradeContact.ram:PersonName M string ПІБ водія, що здав вантаж
3.21.4.5.1 ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber O string Мобільний телефон
3.21.5 ram:CertifyingTradeParty (RoleCode=CA) O   Інформація про відповідальних осіб Перевізника
3.21.5.1.1 ram:ID.schemeAgencyID O string "РНОКПП" Перевізника
3.21.5.1.2 ram:ID.value O decimal Значення
3.21.5.2 ram:Name M string Посада відповідальної особи Перевізника
3.21.5.3 ram:RoleCode M string Роль учасника (Перевізник - CA). Довідник ролей
3.21.5.4.1 ram:DefinedTradeContact.ram:PersonName M string ПІБ відповідальної особи Перевізника
3.21.5.5.1 ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber O string Мобільний телефон
3.21.6 ram:CertifyingTradeParty (RoleCode=FW) O   Інформація про відповідальних осіб Експедитора
3.21.6.1.1 ram:ID.schemeAgencyID O string "РНОКПП" Експедитора
3.21.6.1.2 ram:ID.value O decimal Значення
3.21.6.2 ram:Name M string Посада відповідальної особи Експедитора
3.21.6.3 ram:RoleCode M string Роль учасника (Експедитор - FW). Довідник ролей
3.21.6.4.1 ram:DefinedTradeContact.ram:PersonName M string ПІБ відповідальної особи Експедитора
3.21.7.1 ram:ApplicableNote (з кодом GROSSWEIGHT).ram:ContentCode M string Код GROSSWEIGHT
3.21.7.2 ram:ApplicableNote (з кодом GROSSWEIGHT).ram:Content M decimal Маса брутто отриманого вантажу в місці розвантаження в кілограмах
3.21.8.1 ram:ApplicableNote (з кодом DOWNTIME).ram:ContentCode M string Код DOWNTIME
3.21.8.2 ram:ApplicableNote (з кодом DOWNTIME).ram:Content M unsignedByte Час (години) простою під розвантаженням
3.21.9.1 ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber O string Мобільний телефон
3.22 ram:PickUpTransportEvent М   Навантажувальні роботи
3.22.1.1 ram:ActualOccurrenceDateTime.udt:DateTime М datetime
(2021-12-13T14:19:23+02:00)
Дата та час прибуття автомобіля під навантаження
3.22.2.1 ram:ScheduledOccurrenceDateTime.udt:DateTime М datetime
(2021-12-13T14:19:23+02:00)
Дата та час вибуття автомобіля з-під навантаження
3.22.3 ram:CertifyingTradeParty (RoleCode=CZ) M   Інформація про відповідальних осіб Вантажовідправника
3.22.3.1.1 ram:ID.schemeAgencyID M string "РНОКПП" Вантажовідправника
3.22.3.1.2 ram:ID.value M decimal Значення
3.22.3.2 ram:Name M string Посада матеріально відповідальної особи, яка відпускає вантаж
3.22.3.3 ram:RoleCode M string Роль учасника (Вантажовідправник - CZ). Довідник ролей
3.22.3.4.1 ram:DefinedTradeContact.ram:PersonName M string ПІБ матеріально відповідальної особи, яка відпускає вантаж
3.22.3.5.1 ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber O string Мобільний телефон
3.22.4 ram:CertifyingTradeParty (RoleCode=DR) M   Інформація про водія Перевізника. Обов’язково має передаватись блок про Водія
3.22.4.1.1 ram:ID.schemeAgencyID O string "РНОКПП" Водія
3.22.4.1.2 ram:ID.value O decimal Значення
3.22.4.2 ram:Name M string Посада водія, що прийняв вантаж
3.22.4.3 ram:RoleCode M string Роль учасника (Водій - DR). Довідник ролей
3.22.4.4.1 ram:DefinedTradeContact.ram:PersonName M string ПІБ водія, що прийняв вантаж
3.22.4.5.1 ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber O string Мобільний телефон
3.22.5 ram:CertifyingTradeParty (RoleCode=CA) O   Інформація про відповідальних осіб Перевізника. Є можливість опційного підписання Перевізником, після підписання Водієм
3.22.5.1.1 ram:ID.schemeAgencyID O string "РНОКПП" Перевізника
3.22.5.1.2 ram:ID.value O decimal Значення
3.22.5.2 ram:Name M string Посада відповідальної особи Перевізника
3.22.5.3 ram:RoleCode M string Роль учасника (Перевізник - CA). Довідник ролей
3.22.5.4.1 ram:DefinedTradeContact.ram:PersonName M string ПІБ відповідальної особи Перевізника
3.22.5.5.1 ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber O string Мобільний телефон
3.22.6 ram:CertifyingTradeParty (RoleCode=FW) O   Інформація про відповідальних осіб Експедитора
3.22.6.1.1 ram:ID.schemeAgencyID O string "РНОКПП" Експедитора
3.22.6.1.2 ram:ID.value O decimal Значення
3.22.6.2 ram:Name M string Посада відповідальної особи Експедитора
3.22.6.3 ram:RoleCode M string Роль учасника (Експедитор - FW). Довідник ролей
3.22.6.4.1 ram:DefinedTradeContact.ram:PersonName M string ПІБ відповідальної особи Експедитора
3.22.7.1 ram:ApplicableNote (з кодом GROSSWEIGHT).ram:ContentCode M string Код GROSSWEIGHT
3.22.7.2 ram:ApplicableNote (з кодом GROSSWEIGHT).ram:Content M decimal Маса брутто зданого/отриманого вантажу в кілограмах
3.22.8.1 ram:ApplicableNote (з кодом DOWNTIME).ram:ContentCode M string Код DOWNTIME
3.22.8.2 ram:ApplicableNote (з кодом DOWNTIME).ram:Content M HH:MM Час простою. Якщо простою немає, то зазначати 00:00
3.22.8.3 ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber O string Мобільний телефон
3.23 ram:IncludedSupplyChainConsignmentItem M   Відомості про вантаж
3.23.1 ram:SequenceNumeric M int Порядковий номер рядка в таблиці
3.23.2.1 ram:InvoiceAmount.currencyID M string Загальна сума з ПДВ. Тризначний код валюти (UAH)
3.23.2.2 ram:InvoiceAmount.value M decimal Загальна сума з ПДВ. Значення
3.23.3.1 ram:GrossWeightMeasure.unitCode M string Маса брутто вантажу по кожному рядку в кг. Можливе тільки одне значення "KGM"
3.23.3.2 ram:GrossWeightMeasure.value M decimal Маса брутто вантажу по кожному рядку в кг. Значення
3.23.4.1 ram:TariffQuantity.unitCode M string Ціна без ПДВ за одиницю в грн. Це можуть бути як гривні на кілограм (грн./кг) так і гривні на ящик (грн./ящик) - залежить від зазначеної одиниці виміру. Код одиниці виміру («UAH»)
3.23.4.2 ram:TariffQuantity.value М decimal Значення
3.23.5.1 ram:GlobalID.schemeAgencyID O string (min 4 - max 10) УКТЗЕД (код продукції)
3.23.5.2 ram:GlobalID.value O string Значення
3.23.6.1 ram:NatureIdentificationTransportCargo.ram:Identification M string Найменування вантажу
3.23.7.1 ram:ApplicableTransportDangerousGoods.UNDGIdentificationCode O decimal Клас небезпечних речовин, до якого віднесено вантаж (у разі перевезення небезпечних вантажів). Код UNDG, 0 - якщо не використовується
3.23.8.1 ram:AssociatedReferencedLogisticsTransportEquipment.ram:ID O string Номер контейнера, в якому завантажено цей вантаж. Використовуєься опційно для контейнерих перевезень і має відповідати даним тегу ram:UtilizedLogisticsTransportEquipment
3.23.10 ram:TransportLogisticsPackage М   Транспортно-логістичний пакет. ВАЖЛИВО: в Україні дозволяється лише один LogisticsPackage для одного ConsignmentItem!
3.23.10.1 ram:ItemQuantity М decimal Кількість місць, які визначаються за кожним найменуванням вантажу (це можуть бути ящики, кошики, мішки тощо; якщо вантаж упаковано на піддонах - вказують кількість піддонів)
3.23.10.2 ram:TypeCode М string Вид пакування (Довідник видів упаковок)
3.23.10.3 ram:Type М string Одиниця виміру для ram:ItemQuantity
3.23.10.4 ram:PhysicalLogisticsShippingMarks O   Маркування
3.23.10.4.1 ram:Marking O string Назва транспортної упаковки (вільна назва), в якій перевозиться вантаж
3.23.10.4.2.1 ram:BarcodeLogisticsLabel.ram:ID O string (max 128) Штрихкод товару
3.23.11.1 ram:ApplicableNote (з кодом VENDOR_CODE).ram:ContentCode O string Код VENDOR_CODE
3.23.11.2 ram:ApplicableNote (з кодом VENDOR_CODE).ram:Content O string Артикул товару
3.23.12.1 ram:ApplicableNote (з кодом QUANTITY).ram:ContentCode М string Код QUANTITY
3.23.12.2 ram:ApplicableNote (з кодом QUANTITY).ram:Content М string Кількість товару
3.23.13.1 ram:ApplicableNote (з кодом URL).ram:ContentCode O string Код URL
3.23.13.2 ram:ApplicableNote (з кодом URL).ram:Content O string В полі можливо передавати посилання на опис товару (на каталог / сайт виробника чи продавця, т.п.)
3.23.14.1 ram:ApplicableNote (з кодом BASE_UOM).ram:ContentCode М string Код BASE_UOM
3.23.14.2 ram:ApplicableNote (з кодом BASE_UOM).ram:Content М string Одиниця виміру кількості товару для QUANTITY
3.23.15.1 ram:ApplicableNote (з кодом BUYER_CODE).ram:ContentCode М string Код BUYER_CODE
3.23.15.2 ram:ApplicableNote (з кодом BUYER_CODE).ram:Content М string Артикул покупця (використовується для ідентифікації товарної позиції при прийманні)
3.23.16.1 ram:ApplicableNote (з кодом PRICE_WITH_VAT).ram:ContentCode M string Код PRICE_WITH_VAT
3.23.16.2 ram:ApplicableNote (з кодом PRICE_WITH_VAT).ram:Content M string Ціна за одиницю з ПДВ
3.23.17.1 ram:ApplicableNote (з кодом SUM_WITHOUT_VAT).ram:ContentCode М string Код SUM_WITHOUT_VAT
3.23.17.2 ram:ApplicableNote (з кодом SUM_WITHOUT_VAT).ram:Content М string Загальна сума без ПДВ
3.23.18.1 ram:ApplicableNote (з кодом RETURN_TARE).ram:ContentCode O string Код RETURN_TARE
3.23.18.2 ram:ApplicableNote (з кодом RETURN_TARE).ram:Content O string Ознака «зворотня тара»
3.23.19.1 ram:ApplicableNote (з кодом KGM).ram:ContentCode O string Код NET_WEIGHT
3.23.19.2 ram:ApplicableNote (з кодом KGM).ram:Content O string Маса нетто
3.23.20.1 ram:ApplicableNote (з кодом RTP_TYPE).ram:ContentCode O string Код RTP_TYPE
3.23.20.2 ram:ApplicableNote (з кодом RTP_TYPE).ram:Content O string Тип транспортної упаковки, наприклад, контейнер
3.23.21.1 ram:ApplicableNote (з кодом RTP_NAME).ram:ContentCode O string Код RTP_NAME
3.23.21.2 ram:ApplicableNote (з кодом RTP_NAME).ram:Content O string Назва транспортної упаковки, наприклад, контейнер для перевезення сипучих речовин
3.23.22.1 ram:ApplicableNote (з кодом RTP_QUANTITY).ram:ContentCode O string Код RTP_QUANTITY
3.23.22.2 ram:ApplicableNote (з кодом RTP_QUANTITY).ram:Content O string Кількість транспортної упаковки (використовується для обліку оборотної тари)
3.23.23.1 ram:ApplicableNote (з кодом ANIMAL_ID).contentCode O string Код ANIMAL_ID
3.23.23.2 ram:ApplicableNote (з кодом ANIMAL_ID).content O string Ідентифікаційний номер тварини, від якої отримано сировину
3.23.24.1 ram:ApplicableNote (з кодом ANIMAL_TYPE).contentCode O string Код ANIMAL_TYPE
3.23.24.2 ram:ApplicableNote (з кодом ANIMAL_TYPE).content O string Вид тварини
3.23.25.1 ram:ApplicableNote (з кодом TRANSPORTATION_MIN_TEMPERATURE).contentCode O string Код TRANSPORTATION_MIN_TEMPERATURE
3.23.25.2 ram:ApplicableNote (з кодом TRANSPORTATION_MIN_TEMPERATURE).content O string Температурний режим транспортування (мін)
3.23.26.1 ram:ApplicableNote (з кодом TRANSPORTATION_MAX_TEMPERATURE).contentCode O string Код TRANSPORTATION_MAX_TEMPERATURE
3.23.26.2 ram:ApplicableNote (з кодом TRANSPORTATION_MAX_TEMPERATURE).content O string Температурний режим транспортування (макс)
3.24 ram:UtilizedLogisticsTransportEquipment M   Автомобіль
3.24.1 ram:ID M string Реєстраційний номер автомобіля згідно з техпаспортом

* укр.номери: має відповідати одному з патернів для автомобільних номерних знаків
* єврономери: без валідації
3.24.2.1 ram:AffixedLogisticsSeal.ram:ID O string Номер пломби, якою проводилося пломбування автомобіля
3.24.3 ram:SettingTransportSettingTemperature O   Інструкції з експлуатації
3.24.3.1 ram:MinimumValueMeasure O   Температурний режим, необхідний для перевезення вантажу. Мінімальне значення температури
3.24.3.1.1 unitCode O string код одиниці виміру (CEL)
3.24.3.1.2 value O string Значення
3.24.3.2 ram:MaximumValueMeasure O   Температурний режим, необхідний для перевезення вантажу. Максимальне значення температури
3.24.3.2.1 unitCode O string код одиниці виміру (CEL)
3.24.3.2.2 value O string Значення
3.24.4.1 ram:ApplicableNote (з кодом BRAND).ram:ContentCode M string Код BRAND
3.24.4.2 ram:ApplicableNote (з кодом BRAND).ram:Content M string Марка автомобіля згідно з техпаспортом
3.24.5.1 ram:ApplicableNote (з кодом MODEL).ram:ContentCode M string Код MODEL
3.24.5.2 ram:ApplicableNote (з кодом MODEL).ram:Content M string Модель автомобіля згідно з техпаспортом
3.24.6.1 ram:ApplicableNote (з кодом COLOR).ram:ContentCode O string Код COLOR
3.24.6.2 ram:ApplicableNote (з кодом COLOR).ram:Content O string Колір автомобіля згідно з техпаспортом
3.24.7.1 ram:ApplicableNote (з кодом TYPE).ram:ContentCode M string Код TYPE
3.24.7.2 ram:ApplicableNote (з кодом TYPE).ram:Content M string Тип автомобіля згідно з техпаспортом
3.25 ram:UtilizedLogisticsTransportEquipment (CategoryCode=TE) O   Причіп/напівпричіп
3.25.1 ram:ID M string Реєстраційний номер причіпа/напівпричіпа згідно з техпаспортом
3.25.2 ram:CategoryCode M string Тип TE - Причіп/напівпричіп
3.25.3 ram:CharacteristicCode M decimal Код визначення Причіп/напівпричіп:

* 14 - Причіп
* 17 - Напівпричіп
3.25.4.1 ram:AffixedLogisticsSeal.ram:ID O string Номер пломби, якою проводилося пломбування причіпа/напівпричіпа
3.25.5 ram:SettingTransportSettingTemperature O   Інструкції з експлуатації
3.25.5.1 ram:MinimumValueMeasure O   Температурний режим, необхідний для перевезення вантажу. Мінімальне значення температури
3.25.5.1.1 unitCode O string код одиниці виміру (CEL)
3.25.5.1.2 value O string Значення
3.25.5.2 ram:MaximumValueMeasure O   Температурний режим, необхідний для перевезення вантажу. Максимальне значення температури
3.25.5.2.1 unitCode O string код одиниці виміру (CEL)
3.25.5.2.2 value O string Значення
3.25.6.1 ram:ApplicableNote (з кодом BRAND).ram:ContentCode M string Код BRAND
3.25.6.2 ram:ApplicableNote (з кодом BRAND).ram:Content M string Марка причіпа/напівпричіпа згідно з техпаспортом
3.25.7.1 ram:ApplicableNote (з кодом MODEL).ram:ContentCode M string Код MODEL
3.25.7.2 ram:ApplicableNote (з кодом MODEL).ram:Content M string Модель причіпа/напівпричіпа згідно з техпаспортом
3.25.8.1 ram:ApplicableNote (з кодом COLOR).ram:ContentCode O string Код COLOR
3.25.8.2 ram:ApplicableNote (з кодом COLOR).ram:Content O string Колір причіпа/напівпричіпа згідно з техпаспортом
3.25.9.1 ram:ApplicableNote (з кодом TYPE).ram:ContentCode M string Код TYPE
3.25.9.2 ram:ApplicableNote (з кодом TYPE).ram:Content M string Тип причіпа/напівпричіпа згідно з техпаспортом
3.26 ram:UtilizedLogisticsTransportEquipment (CategoryCode=CN) O   Контейнер
3.26.1 ram:CategoryCode M string Тип CN - Контейнер
3.26.2 ram:CharacteristicCode M decimal Тип контейнера:

* 21 - 20-футовий
* 23 - 40-футовий
3.26.3 ram:ID M string Ідентифікаційний номер контейнера
3.26.4.1 ram:AffixedLogisticsSeal.ram:ID O string Номер пломби, якою проводилося пломбування контейнера
3.26.5 ram:SettingTransportSettingTemperature O   Інструкції з експлуатації
3.26.5.1 ram:MinimumValueMeasure O   Температурний режим, необхідний для перевезення вантажу. Мінімальне значення температури
3.26.5.1.1 unitCode O string код одиниці виміру (CEL)
3.26.5.1.2 value O string Значення
3.26.5.2 ram:MaximumValueMeasure O   Температурний режим, необхідний для перевезення вантажу. Максимальне значення температури
3.26.5.2.1 unitCode O string код одиниці виміру (CEL)
3.26.5.2.2 value O string Значення
3.27 ram:MainCarriageLogisticsTransportMovement O   Маршрутизація (проміжні пункти перевантаження). Заповнюється Перевізником
3.27.1 ram:ModeCode M string Код; доступні значення:
* 3 - для дорожніх перевезень
3.27.2 ram:SpecifiedTransportEvent M   Проміжне розвантаження
3.27.2.1 ram:ID M string Порядковий номер проміжного розвантаження події (події завжди нумеруються в порядку поступового зростання за принципом N+1)
3.27.2.2 ram:TypeCode M decimal Тип операції (розвантаження=5); завжди одне значення (5), оскільки використовується як планові пункти розвантаження
3.27.2.3 ram:Description O string Опис
3.27.2.4 ram:OccurrenceLogisticsLocation M   Місцезнаходження
3.27.2.4.1.1 ram:ID.schemeAgencyID M string Код КАТОТТГ складу тимчасового зберігання відповідно до Кодифікатора адміністративно-територіальних одиниць та територій територіальних громад
3.27.2.4.1.2 ram:ID.value M string Значення
3.27.2.4.2 ram:Name O string Найменування та адреса (Місцезнаходження складу)
3.27.2.4.3 ram:TypeCode M decimal Тип операції (розвантаження=5); завжди одне значення (5), оскільки використовується як планові пункти розвантаження
3.27.2.4.4 ram:Description O string Додаткова інформація складу тимчасового зберігання
3.27.2.5 ram:CertifyingTradeParty (RoleCode=WD) M   Юридична особа Проміжного складу
3.27.2.5.1.1 ram:ID.schemeAgencyID M string "ЄДРПОУ"/"РНОКПП" підприємства (Вантажовідправник/Перевізник/Експедитор/Вантажоодержувач/Товарний склад), що приймає від Перевізника на тимчасове зберігання вантаж
3.27.2.5.1.2 ram:ID.value M string Значення
3.27.2.5.2 ram:Name M string Повне найменування Проміжного складу (Вантажовідправник/Перевізник/Експедитор/Вантажоодержувач/Товарний склад), що приймає від Перевізника на тимчасове зберігання вантаж
3.27.2.5.3 ram:RoleCode M string Роль учасника (Проміжний склад - WD). Довідник ролей
3.27.2.5.4 ram:DefinedTradeContact O   Контакти відповідальні особи Проміжного складу
3.27.2.5.4.1 ram:PersonName O string ПІБ відповідальні особи Проміжного складу
3.27.2.5.4.2.1 ram:TelephoneUniversalCommunication.ram:CompleteNumber O string Основний телефон
3.27.2.5.4.3.1 ram:MobileTelephoneUniversalCommunication.ram:CompleteNumber O string Мобільний телефон
3.27.2.5.4.4.1 ram:EmailURIUniversalCommunication.ram:CompleteNumber O string Електронна адреса
3.27.2.5.5 ram:PostalTradeAddress М   Юридична адреса Проміжного складу (Вантажовідправник/Перевізник/Експедитор/Вантажоодержувач/Товарний склад), що приймає від Перевізника на тимчасове зберігання вантаж
3.27.2.5.5.1 ram:PostcodeCode M string Індекс
3.27.2.5.5.2 ram:StreetName M string Адреса (Назва вулиці + номер будівлі)
3.27.2.5.5.3 ram:CityName M string Місто (Назва населеного пункту)
3.27.2.5.5.4 ram:CountryID M string Країна (UA)
3.27.2.5.5.5 ram:CountrySubDivisionName M string Область та район (за наявності)
3.27.2.5.6 ram:SpecifiedTaxRegistration.ram:ID O string РНОКПП відповідальної особи
3.27.2.5.7 ram:SpecifiedGovernmentRegistration M   GLN Проміжного складу (Вантажовідправник/Перевізник/Експедитор/Вантажоодержувач/Товарний склад), що приймає від Перевізника на тимчасове зберігання вантаж (блок обов'язковий до заповнення для відправника транзакції) / УНЗР (за наявності) Проміжного складу (Вантажовідправник/Перевізник/Експедитор/Вантажоодержувач/Товарний склад), що приймає від Перевізника на тимчасове зберігання вантаж
3.27.2.5.7.1 ram:ID M string GLN Проміжного складу (Вантажовідправник/Перевізник/Експедитор/Вантажоодержувач/Товарний склад), що приймає від Перевізника на тимчасове зберігання вантаж (поле обов'язкове до заповнення для відправника транзакції)
3.27.2.5.7.2 ram:TypeCode М string TRADEPARTY_GLN
3.27.2.5.7.3 ram:ID М/O string Код УНЗР (за наявності) Формат: ХХХХХХХХ-ХХХХХ
3.27.2.5.7.4 ram:TypeCode М/O string TRADEPARTY_UNZR
3.28 ram:DeliveryInstructions M   Вид перевезень
3.28.1 ram:Description O string Опис (вид роботи перевізника):
* покілометровий тариф
* погодинний тариф
* відрядний тариф
* централізоване перевезення
* внутрішньоміське
* приміське
* міжміське
* міжнародне перевезення
* перевезення між складами (шатлінг)
* доставка до дистриб’ютора та ключових клієнтів
* перевезення збірного вантажу (пулінг)
* доставка продукції (Україна)
* безкоштовна доставка
* зовнішнє перевезення
* доставка зі складів (Україна)
* доставка від постачальника (Україна)
* спеціальні проєкти (регулярні перевезення)
3.28.2 ram:DescriptionCode M string Код (TRANSPORTATION_TYPE)
3.29 ram:PreviousAdministrativeReferencedDocument -/M   Попередня транзакція eCMR, на основі якої складено поточний документ. Блок не вказується, якщо документ створено з «нуля»
3.29.1 ram:TypeCode O decimal Тип документа, на основі якого складено поточний документ. Довідник кодів документів
3.29.2 ram:ID M int Відповідає ExchangedExchangedDocumentContext.SpecifiedTransactionID попередніх версій
3.29.3 ram:Remarks O string Base64 документа попередньої версії
3.29.4.1 ram:FormattedIssueDateTime.qdt:DateTimeString O datetime
(2021-12-13T14:19:23+02:00)
Дата та час складання попереднього eCMR документа
3.29.5 ram:AttachedSpecifiedBinaryFile O   Вкладений бінарний файл документа, на основі якого складено поточний документ
3.29.5.1 ram:ID M string Відповідає document.ram:ID із ЦБД еТТН
3.29.5.2 ram:URIID M string Посилання на документ
3.29.5.3 ram:MIMECode O string Код MIME типізації
3.29.5.4 ram:SizeMeasure M Long Розмір файлу
II UaSignatureStorage M   Підписи
4 Signature (SigningPartyRoleCode=CZ) M   КЕП Вантажовідправника
4.1 SigningPartyRoleCode M string Роль підписанта (Вантажовідправник - CZ). Довідник ролей
4.2 PartySignature M string Підпис (base64 підпису p7s)
4.3 Name M string ПІБ підписанта (відповідальної особи вантажовідправника)
4.4 Position O string Посада підписанта (відповідальної особи вантажовідправника)
4.5.1 SpecifiedTaxRegistration.ram:ID M string РНОКПП відповідальної особи вантажовідправника
5 Signature (SigningPartyRoleCode=DR) M   КЕП Водія
5.1 SigningPartyRoleCode M string Роль підписанта (Водій - DR). Довідник ролей
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=CA) M   КЕП Перевізника
6.1 SigningPartyRoleCode M string Роль підписанта (Перевізник - CA). Довідник ролей
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=CN) M   КЕП Вантажоодержувача
7.1 SigningPartyRoleCode M string Роль підписанта (Вантажоодержувач - CN). Довідник ролей
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 РНОКПП підписанта (Вантажоодержувача)
[1] - елементи структури мають наступний вигляд:
  • параметрЗіЗначенням;

  • об’єктЗПараметрами;

  • масивОб’єктів;

  • жовтим фоном виділяються комірки, в яких відбувались останні зміни

[2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
  • M (mandatory) — обов’язкові до заповнення поля;

  • O (optional) — необов’язкові (опціональні) для заповнення поля.


За цим посиланням можна завантажити ТТН, XML-Приклад

За цим посиланням можна завантажити Обов'язкові поля ТТН, XML-Приклад

За цим посиланням можна завантажити ТТН, JSON-Приклад

За цим посиланням можна завантажити Обовʼязкові поля ТТН, JSON-Приклад


 

 

XML Специфікації документів для роботи з «АТБ»

Акт приймання товару до ВН (COMDOC_035)

Акт приймання товару до Видаткової Накладної (COMDOC_035)

Опис полів

Назва поля

Тип 1

Формат

Опис

ЕлектроннийДокумент

M

 

Початок документу

Заголовок

M

Кількість входжень вузла: Min = 1; Max = 1

Заголовок (початок блоку)

НомерДокументу

M

Рядок (16)

Номер документу

ТипДокументу

M

Рядок (50)

Тип документа: Акт приймання товару до ВН

КодТипуДокументу

M

«035»

Допустиме значення: 035 => Акт приймання товару до ВН

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документу

НомерЗамовлення

M

Рядок (20)

Номер замовлення

ДатаЗамовлення

M

Дата (РРРР-ММ-ДД)

Дата здійснення замовлення

НомерДоговоруПоставки

M

Рядок (30)

Номер договору, за яким здійснюється поставка

ДатаДоговоруПоставки

M

Дата (РРРР-ММ-ДД)

Дата договору, за яким здійснюється поставка

ПлановаДатаДоставки

M

Дата (РРРР-ММ-ДД)

Планова дата поставки

ФактичнаДатаДоставки

M

Дата (РРРР-ММ-ДД)

Фактична дата поставки

ДокВерсія

M

Число позитивне (1-99)

Версія документа

ДокПідстава

M

Кількість входжень вузла: Min = 0; Max = 10

Документ-підстава (початок блоку)

НомерДокументу

M

Рядок (30)

Номер документу-підстави

ТипДокументу

M

Рядок (50)

Тип документа: Видаткова накладна

КодТипуДокументу

M

«006»

Допустиме значення: 006 => Видаткова накладна

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документу-підстави

ДокПідстава

   

Документ-підстава (завершення блоку)

НомерВідвантаження

M

Рядок (50)

Номер повідомлення про відвантаження

ДатаВідвантаження

M

Дата (РРРР-ММ-ДД)

Дата повідомлення про відвантаження

Заголовок

   

Заголовок (завершення блоку)

Сторони

M

Мількість входжень вузла: Min = 1; Max = 1

Сторони, між якими укладено документ (початок блоку)

Контрагент

M

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача

СтатусКонтрагента

M

Рядок (30)

Допустимі значення: Покупець

ВидОсоби

M

Рядок (20)

Допустимі значення:

  • Юридична;

  • Фізична

НазваКонтрагента

M

Рядок (50)

Назва контрагента

КодКонтрагента

M

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

M

Рядок (12)

Індивідуальний податковий номер

IBAN

M

Рядок

IBAN (міжнародний номер банківського рахунку; використовується при міжнародних розрахунках)

Телефон

M

Рядок (20)

Телефон контрагента

GLN

M

Integer (13)

Глобальний номер розташування (GLN) контрагента

ЮрАдреса

M

 

Юридична адреса контрагента (початок блоку)

Індекс

M

Integer (5)

Індекс

Область

M

Рядок (50)

Область

Місто

M

Рядок (50)

Місто

Вулиця

M

Рядок (50)

Вулиця

ЮрАдреса

   

Юридична адреса контрагента (завершення блоку)

Контрагент

   

Контрагент (завершення блоку)

Контрагент

M

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача

СтатусКонтрагента

M

Рядок (30)

Допустимі значення: Постачальник

ВидОсоби

M

Рядок (20)

Допустимі значення:

  • Юридична;

  • Фізична

НазваКонтрагента

M

Рядок (200)

Назва контрагента

КодКонтрагента

M

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

M

Рядок (12)

Індивідуальний податковий номер

IBAN

M

Рядок

IBAN (міжнародний номер банківського рахунку; використовується при міжнародних розрахунках)

Телефон

M

Рядок (20)

Телефон контрагента

GLN

M

Integer (13)

Глобальний номер розташування (GLN) контрагента

ЮрАдреса

M

 

Юридична адреса контрагента (початок блоку)

Індекс

M

Integer (5)

Індекс

Область

M

Рядок (50)

Область

Місто

M

Рядок (50)

Місто

Вулиця

M

Рядок (50)

Вулиця

ЮрАдреса

   

Юридична адреса контрагента (завершення блоку)

Контрагент

   

Контрагент (завершення блоку)

Сторони

   

Сторони, між якими укладено документ (завершення блоку)

МісцеДоставки

M

 

Місце доставки (початок блоку)

GLN

M

Integer (13)

Глобальний номер розташування (GLN) місця доставки

Індекс

M

Integer (5)

Індекс

Область

M

Рядок (50)

Область

Місто

M

Рядок (50)

Місто

Вулиця

M

Рядок (50)

Вулиця

МісцеДоставки

   

Місце доставки (завершення блоку)

Параметри

M

 

Параметри (початок блоку). Тег передбачає довільне значення; використовується для передачі додаткової інформації, що не входить до основних полей специфікації

<Параметр ІД=«1» назва=«Точка доставки»>4829900017590</Параметр>

M

Рядок (250)

Додаткові параметри. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю. Для ІД=1 вказується точка доставки. Максимальна кількість тегів – 99.

<Параметр ІД=«2» назва=«Адреса доставки»>Дніпропетровська обл., Дніпровський р-н, територія Слобожанської селищної ради, комплекс будівель та споруд №8</Параметр>

M

Рядок (250)

Додаткові параметри. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю. Для ІД=2 вказується розшифровка адреси доставки. Максимальна кількість тегів – 99.

Параметри

M

 

Параметри (завершення блоку)

Таблиця

M

Кількість входжень вузла: Min = 0; Max = 1

Таблиця (початок блоку)

Рядок

M

Кількість входжень вузла: Min = 1;Max = 9999

Рядок (початок блоку). У кожного наступного блоку ідентифікатор (ІД) збільшується на одиницю

НомПоз

M

Integer (3)

Номер позиції

<Штрихкод ІД=«1»>6908876610177</Штрихкод>

M

Рядок (13)

Штрих-код продукту. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю.

АртикулПокупця

M

Рядок (32)

Артикул покупця

КодУКТЗЕД

M

Integer (10)

Код товару згідно УКТ ЗЕД (значення не менше 4 і не більше 10 символів)

Найменування

M

Рядок (250)

Найменування товарної позиції

ЗаявленаКількість

M

Decimal (#.00)

Заявлена кількість товарних позицій

ПрийнятаКількість

M

Decimal (#.000)

Прийнята кількість товарних позицій

ОдиницяВиміру

M

Рядок (10)

Одиниці виміру 2

БазоваЦіна

M

Decimal (#.00)

Ціна за одиницю без ПДВ

ЦінаЗіЗнижкоюБезПДВ

O

Decimal (#.00)

Цiна за одиницю зі знижкою, без ПДВ

ВсьогоПоРядку

M

Кількість входжень вузла: Min = 0; Max = 1

Загальна сума по рядку (початок блоку)

СумаБезПДВ

M

Decimal (#.00)

Сума без ПДВ

СумаПДВ

O

Decimal (#.00)

Сума ПДВ

Сума

O

Decimal (#.00)

Сума

ВсьогоПоРядку

   

Загальна сума по рядку (завершення блоку)

СтавкаПДВ

M

«0»/«7»/«20»

Ставка податку на додану вартість (%); Допустиме значення: 0 / 7 / 20

ВідсотокЗнижки

O

Decimal (#.00)

Відсоток знижки

Причина

M

Кількість входжень вузла: Min = 0; Max = 1

Причина для повернення (початок блоку)

Кількість

M

Decimal (#.00)

Кількість відхилень

Причина

   

Причина для повернення (завершення блоку)

Рядок

   

Рядок (завершення блоку)

Таблиця

   

Таблиця (завершення блоку)

ВсьогоПоДокументу

M

Сумарні значення позицій за документом (початок блоку)

 

СумаБезПДВ

M

Decimal (#.00)

Сума без ПДВ по документу

ПДВ

M

Decimal (#.00)

Сума ПДВ по документу

Сума

M

Decimal (#.00)

Сума з ПДВ по документу

ВсьогоПоДокументу

M

 

Сумарні значення позицій за документом (завершення блоку)

ЕлектроннийДокумент

M

 

Завершення документу

[1] - елементи структури мають наступний вигляд:
  • параметрЗіЗначенням;

  • об’єктЗПараметрами;

  • масивОб’єктів;

  • жовтим фоном виділяються комірки, в яких відбувались останні зміни

[2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
  • M (mandatory) — обов’язкові до заповнення поля;

  • O (optional) — необов’язкові (опціональні) для заповнення поля.


За цим посиланням можна завантажити XML-Приклад COMDOC_035

XML Специфікації документів для роботи з «АТБ»

Видаткова накладна (COMDOC_006)

Видаткова накладна (COMDOC_006)

Опис полів

Назва поля

Тип 1

Формат

Опис

ЕлектроннийДокумент

M

 

Початок документу

Заголовок

M

Кількість входжень вузла: Min = 1; Max = 1

Заголовок (початок блоку)

НомерДокументу

M

Рядок (16)

Номер документу

ТипДокументу

M

Рядок (50)

Тип документу: Видаткова накладна

КодТипуДокументу

M

«006»

Допустиме значення: 006 => Видаткова накладна

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документу

НомерЗамовлення

M

Рядок (20)

Номер замовлення

ДатаЗамовлення

M

Дата (РРРР-ММ-ДД)

Дата здійснення замовлення

ПлановаДатаДоставки

M

Дата (РРРР-ММ-ДД)

Планова дата поставки

ДокВерсія

M

Число позитивне (1-99)

Версія документа

ДокПідстава

M

Кількість входжень вузла: Min = 0; Max = 10

Документ-підстава (початок блоку)

НомерДокументу

M

Рядок (30)

Номер документу-підстави

ТипДокументу

M

Рядок (50)

Тип документа: Договір

КодТипуДокументу

M

«001»

Допустиме значення: 001 => Договір

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документу-підстави

ДокПідстава

   

Документ-підстава (завершення блоку)

НомерВідвантаження

M

Рядок (50)

Номер повідомлення про відвантаження

ДатаВідвантаження

M

Дата (РРРР-ММ-ДД)

Дата повідомлення про відвантаження

Заголовок

   

Заголовок (завершення блоку)

Сторони

M

Мількість входжень вузла: Min = 1; Max = 1

Сторони, між якими укладено документ (початок блоку)

Контрагент

M

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок Постачальника, другим – Покупця

СтатусКонтрагента

M

Рядок (30)

Допустимі значення: Постачальник

ВидОсоби

M

Рядок (20)

Допустимі значення: Юридична; Фізична

НазваКонтрагента

M

Рядок (200)

Назва контрагента

КодКонтрагента

M

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

M

Рядок (12)

Індивідуальний податковий номер

IBAN

M

Рядок

IBAN (міжнародний номер банківського рахунку; використовується при міжнародних розрахунках)

Телефон

O

Рядок (20)

Телефон контрагента

GLN

M

Integer (13)

Глобальний номер розташування (GLN) контрагента

ЮрАдреса

M

 

Юридична адреса контрагента (початок блоку)

Індекс

M

Integer (5)

Індекс

Область

M

Рядок (100)

Область. Допустимі значення:

  • Одеська

  • Дніпропетровська

  • Чернігівська

  • Харківська

  • Житомирська

  • Полтавська

  • Херсонська

  • Київська

  • Запорізька

  • Луганська

  • Донецька

  • Вінницька

  • Автономна Республіка Крим

  • Миколаївська

  • Кіровоградська

  • Сумська

  • Львівська

  • Черкаська

  • Хмельницька

  • Волинська

  • Рівненська

  • Івано-Франківська

  • Тернопільська

  • Закарпатська

  • Чернівецька

  • м. Севастополь

  • м. Київ

Місто

M

Рядок (100)

Місто

Вулиця

M

Рядок (100)

Вулиця

ЮрАдреса

   

Юридична адреса контрагента (завершення блоку)

Контрагент

   

Контрагент (завершення блоку)

Контрагент

M

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок Постачальника, другим – Покупця

СтатусКонтрагента

M

Рядок (30)

Допустимі значення: Покупець

ВидОсоби

M

Рядок (20)

Допустимі значення: Юридична; Фізична

НазваКонтрагента

M

Рядок (200)

Назва контрагента

КодКонтрагента

M

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

M

Рядок (12)

Індивідуальний податковий номер

IBAN

M

Рядок

IBAN (міжнародний номер банківського рахунку; використовується при міжнародних розрахунках)

Телефон

O

Рядок (20)

Телефон контрагента

GLN

M

Integer (13)

Глобальний номер розташування (GLN) контрагента

ЮрАдреса

M

 

Юридична адреса контрагента (початок блоку)

Індекс

M

Integer (5)

Індекс

Область

M

Рядок (100)

Область. Допустимі значення:

  • Одеська

  • Дніпропетровська

  • Чернігівська

  • Харківська

  • Житомирська

  • Полтавська

  • Херсонська

  • Київська

  • Запорізька

  • Луганська

  • Донецька

  • Вінницька

  • Автономна Республіка Крим

  • Миколаївська

  • Кіровоградська

  • Сумська

  • Львівська

  • Черкаська

  • Хмельницька

  • Волинська

  • Рівненська

  • Івано-Франківська

  • Тернопільська

  • Закарпатська

  • Чернівецька

  • м. Севастополь

  • м. Київ

Місто

M

Рядок (100)

Місто

Вулиця

M

Рядок (100)

Вулиця

ЮрАдреса

   

Юридична адреса контрагента (завершення блоку)

Контрагент

   

Контрагент (завершення блоку)

Сторони

   

Сторони, між якими укладено документ (завершення блоку)

МісцеДоставки

M

 

Місце доставки (початок блоку)

GLN

M

Integer (13)

Глобальний номер розташування (GLN) місця доставки

Індекс

M

Integer (5)

Індекс

Область

M

Рядок (100)

Область

Місто

M

Рядок (100)

Місто

Вулиця

M

Рядок (100)

Вулиця

МісцеДоставки

   

Місце доставки (завершення блоку)

Параметри

M

 

Параметри (початок блоку). Тег передбачає довільне значення; використовується для передачі додаткової інформації, що не входить до основних полей специфікації

<Параметр ІД=«1» назва=«Точка доставки»>4829900017590</Параметр>

M

Рядок (250)

Додаткові параметри. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю. Для ІД=1 вказується точка доставки. Максимальна кількість тегів – 99.

<Параметр ІД=«2» назва=«Адреса доставки»>Дніпропетровська обл., Дніпровський р-н, територія Слобожанської селищної ради, комплекс будівель та споруд №8</Параметр>

M

Рядок (250)

Додаткові параметри. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю. Для ІД=2 вказується розшифровка адреси доставки. Максимальна кількість тегів – 99.

Параметри

M

 

Параметри (завершення блоку)

Таблиця

M

Кількість входжень вузла: Min = 0; Max = 1

Таблиця (початок блоку)

Рядок

M

Кількість входжень вузла: Min = 1;Max = 9999

Рядок (початок блоку). У кожного наступного блоку ідентифікатор (ІД) збільшується на одиницю

НомПоз

M

Integer (3)

Номер позиції

<Штрихкод ІД=«1»>6908876610177</Штрихкод>

M

Рядок (13)

Штрих-код продукту. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю.

АртикулПокупця

M

Рядок (32)

Артикул покупця

КодУКТЗЕД

M

Integer (10)

Код товару згідно УКТ ЗЕД (значення не менше 4 і не більше 10 символів)

Найменування

M

Рядок (250)

Найменування товарної позиції

ПрийнятаКількість

M

Decimal (#.000)

Прийнята кількість товарних позицій

ОдиницяВиміру

M

Рядок (10)

Одиниці виміру 2

БазоваЦіна

M

Decimal (#.00)

Ціна за одиницю без ПДВ

ВсьогоПоРядку

M

Кількість входжень вузла: Min = 0; Max = 1

Загальна сума по рядку (початок блоку)

СумаБезПДВ

M

Decimal (#.00)

Сума без ПДВ

ВсьогоПоРядку

   

Загальна сума по рядку (завершення блоку)

СтавкаПДВ

M

«0»/«7»/«20»

Ставка податку на додану вартість (%); Допустиме значення: 0 / 7 / 20

Рядок

   

Рядок (завершення блоку)

Таблиця

   

Таблиця (завершення блоку)

ВсьогоПоДокументу

M

Сумарні значення позицій за документом (початок блоку)

 

СумаБезПДВ

M

Decimal (#.00)

Сума без ПДВ по документу

ПДВ

M

Decimal (#.00)

Сума ПДВ по документу

Сума

M

Decimal (#.00)

Сума з ПДВ по документу

ВсьогоПоДокументу

M

 

Сумарні значення позицій за документом (завершення блоку)

ЕлектроннийДокумент

M

 

Завершення документу

[1] - елементи структури мають наступний вигляд:
  • параметрЗіЗначенням;

  • об’єктЗПараметрами;

  • масивОб’єктів;

  • жовтим фоном виділяються комірки, в яких відбувались останні зміни

[2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
  • M (mandatory) — обов’язкові до заповнення поля;

  • O (optional) — необов’язкові (опціональні) для заповнення поля.


За цим посиланням можна завантажити XML-Приклад COMDOC_006

За цим посиланням можна завантажити JSON-Приклад COMDOC_006

XML Специфікації документів для роботи з «АТБ»

Анулювання (COMDOC_019)

Анулювання (COMDOC_019)

Опис полів

Назва поля

Тип 1

Формат

Опис

ЕлектроннийДокумент

M

 

Початок документу

Заголовок

M

Кількість входжень вузла: Min = 1; Max = 1

Заголовок (початок блоку)

НомерДокументу

M

Рядок (16)

Номер документу

ТипДокументу

M

Рядок (50)

Тип документу: Анулювання

КодТипуДокументу

M

«019»

Допустиме значення: 019 => Анулювання

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документу

ПричинаАнулювання

M

Рядок (255)

Причина анулювання

ДатаАнулювання

M

Дата (РРРР-ММ-ДД)

Дата анулювання

МісцеСкладання

O

Рядок (255)

Місце складання документу

Заголовок

   

Заголовок (завершення блоку)

ДокументЩоАнулюється

   

Документ, що аннулюється (початок блоку)

НомерДокументу

M

Рядок (16)

Номер документу

ТипДокументу

M

Рядок (50)

Типи документів: Договір, Додаткова угода…(типи коммерційних документів)

КодТипуДокументу

M

«001» / «002» / «003» …

Код типу документу

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документу

ДокументЩоАнулюється

   

Документ, що аннулюється (завершення блоку)

Сторони

M

Мількість входжень вузла: Min = 1; Max = 1

Сторони, між якими укладено документ (початок блоку)

Контрагент

M

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача

СтатусКонтрагента

M

Рядок (30)

Допустимі значення:

  • Покупець;

  • Отримувач;

  • Продавець;

  • Замовник;

  • Виконавець;

  • Перевізник;

  • Платник;

  • Підрядник;

  • Відправник;

  • Вантажоодержувач;

  • Вантажовідправник;

  • Експедитор;

  • Клієнт;

  • Консультант

ВидОсоби

M

Рядок (20)

Допустимі значення: Юридична Фізична

НазваКонтрагента

M

Рядок (50)

Назва контрагента

КодКонтрагента

M

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

M

Рядок (12)

Індивідуальний податковий номер контрагента

СвідоцтвоПДВ

O

Integer (10)

Свідоцтво ПДВ контрагента

GLN

M

Integer (13)

Глобальний номер розташування (GLN) контрагента

Контрагент

   

Контрагент (завершення блоку)

Контрагент

M

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача

СтатусКонтрагента

M

Рядок (30)

Допустимі значення:

  • Покупець;

  • Отримувач;

  • Продавець;

  • Замовник;

  • Виконавець;

  • Перевізник;

  • Платник;

  • Підрядник;

  • Відправник;

  • Вантажоодержувач;

  • Вантажовідправник;

  • Експедитор;

  • Клієнт;

  • Консультант

ВидОсоби

M

Рядок (20)

Допустимі значення: Юридична Фізична

НазваКонтрагента

M

Рядок (50)

Назва контрагента

КодКонтрагента

M

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

M

Рядок (12)

Індивідуальний податковий номер контрагента

СвідоцтвоПДВ

O

Integer (10)

Свідоцтво ПДВ контрагента

GLN

M

Integer (13)

Глобальний номер розташування (GLN) контрагента

Контрагент

   

Контрагент (завершення блоку)

Сторони

   

Сторони, між якими укладено документ (завершення блоку)

ЕлектроннийДокумент

O

 

Завершення блоку

[1] - елементи структури мають наступний вигляд:
  • параметрЗіЗначенням;

  • об’єктЗПараметрами;

  • масивОб’єктів;

  • жовтим фоном виділяються комірки, в яких відбувались останні зміни

[2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
  • M (mandatory) — обов’язкові до заповнення поля;

  • O (optional) — необов’язкові (опціональні) для заповнення поля.


За цим посиланням можна завантажити XML-Приклад COMDOC_019

За цим посиланням можна завантажити JSON-Приклад COMDOC_019

XML Специфікації документів для роботи з «АТБ»

Повідомлення про відмову від підписання документу (квитанція №13) / Повідомлення про відклик підпису (квитанція №14) (COMDOC_021)

Повідомлення про відмову від підписання документу (квитанція №13) / Повідомлення про відклик підпису (квитанція №14) (COMDOC_021)

Опис полів

Назва поля

Тип 1

Формат

Опис

ЕлектроннийДокумент

M

 

Початок документу

Заголовок

M

Кількість входжень вузла: Min = 1; Max = 1

Заголовок (початок блоку)

НомерДокументу

M

Рядок (30)

Номер документу

ТипДокументу

M

Рядок (50)

Тип документу: Повідомлення про відмову від підписання документу (квитанція №13) / Повідомлення про відклик підпису (квитанція №14)

КодТипуДокументу

M

«021»

Допустиме значення: 021 => Повідомлення про відмову від підписання документу (квитанція №13) / Повідомлення про відклик підпису (квитанція №14)

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документу

НомерЗамовлення

O

Рядок (20)

Номер замовлення

ДокПідстава

O

Кількість входжень вузла: Min = 0; Max = 10

Документ-підстава (початок блоку)

НомерДокументу

M

Рядок (30)

Номер документу-підстави

ТипДокументу

M

Рядок (50)

Типи документів: Договір, Додаткова угода…(типи коммерційних документів)

КодТипуДокументу

M

«001» / «002» / «003» …

Код типу документу

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документу

ДокПідстава

   

Документ-підстава (завершення блоку)

Заголовок

   

Заголовок (завершення блоку)

Відхилив

   

До заповнення реквізитами компанії, що відхиляє документ (початок блоку)

СтатусКонтрагента

M

Рядок (30)

Допустимі значення: Замовник (квитанція №13) / Відправник (квитанція №14)

ВидОсоби

M

Рядок (20)

Допустимі значення: Юридична Фізична

НазваКонтрагента

M

Рядок (50)

Назва контрагента

КодКонтрагента

M

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

M

Рядок (12)

Індивідуальний податковий номер

МФО

O

Рядок

МФО банку

IBAN

O

Рядок (35)

IBAN (міжнародний номер банківського рахунку; використовується при міжнародних розрахунках)

Телефон

O

Рядок (20)

Телефон контрагента

Відхилив

   

До заповнення реквізитами компанії, що відхиляє документ (завершення блоку)

Сторони

M

Мількість входжень вузла: Min = 1; Max = 1

Сторони, між якими укладено документ (початок блоку)

Контрагент

M

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача

СтатусКонтрагента

M

Рядок (30)

Допустимі значення: Відправник (квитанція №13) / Замовник (квитанція №14)

ВидОсоби

M

Рядок (20)

Допустимі значення: Юридична Фізична

НазваКонтрагента

M

Рядок (50)

Назва контрагента

КодКонтрагента

M

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

M

Рядок (12)

Індивідуальний податковий номер

СвідоцтвоПДВ

O

Integer (10)

Свідоцтво платника ПДВ (податку на додану вартість)

GLN

M

Integer (13)

Глобальний номер розташування (GLN) контрагента

Контрагент

   

Контрагент (завершення блоку)

Сторони

   

Сторони, між якими укладено документ (завершення блоку)

Текст

M

Рядок (100)

Додаткова інформація

ЕлектроннийДокумент

O

 

Завершення документу

[1] - елементи структури мають наступний вигляд:
  • параметрЗіЗначенням;

  • об’єктЗПараметрами;

  • масивОб’єктів;

  • жовтим фоном виділяються комірки, в яких відбувались останні зміни

[2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
  • M (mandatory) — обов’язкові до заповнення поля;

  • O (optional) — необов’язкові (опціональні) для заповнення поля.


За цим посиланням можна завантажити XML-Приклад COMDOC_021 - відмова від підписання

За цим посиланням можна завантажити XML-Приклад COMDOC_021 - відклик підпису

XML Специфікації документів для роботи з «АТБ»

Акт приймання-передачі (додаток 8) (COMDOC_032)

Акт приймання-передачі (додаток 8) (COMDOC_032)

Опис полів

Назва поля

Тип 1

Формат

Опис

ЕлектроннийДокумент

M

 

Початок документа

Заголовок

M

Кількість входжень вузла: Min = 1; Max = 1

Заголовок (початок блоку)

НомерДокументу

M

Рядок (16)

Номер документа

ТипДокументу

M

Рядок (50)

Тип документа: Акт приймання-передачі (додаток 8)

КодТипуДокументу

M

«032»

Допустиме значення: 032 => Акт приймання-передачі (додаток 8)

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документа

НомерЗамовлення

M

Рядок (20)

Номер замовлення

ДатаЗамовлення

M

Дата (РРРР-ММ-ДД)

Дата здійснення замовлення

ДокВерсія

M

Число позитивне (1-99)

Версія документа

ДокПідстава

M

Кількість входжень вузла: Min = 0; Max = 10

Документ-підстава (початок блоку)

НомерДокументу

M

Рядок (30)

Номер документа-підстави

ТипДокументу

M

Рядок (50)

Тип документа: Договір

КодТипуДокументу

M

«001»

Допустиме значення: 001 => Договір

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документа-підстави

ДокПідстава

   

Документ-підстава (завершення блоку)

НомерВідвантаження

M

Рядок (50)

Номер повідомлення про відвантаження

ДатаВідвантаження

M

Дата (РРРР-ММ-ДД)

Дата повідомлення про відвантаження

Заголовок

   

Заголовок (завершення блоку)

Сторони

M

Мількість входжень вузла: Min = 1; Max = 1

Сторони, між якими укладено документ (початок блоку)

Контрагент

M

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача

СтатусКонтрагента

M

Рядок (30)

Допустимі значення: Замовник

ВидОсоби

M

Рядок (20)

Допустимі значення: Юридична; Фізична

НазваКонтрагента

M

Рядок (200)

Назва контрагента

КодКонтрагента

M

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

M

Рядок (12)

Індивідуальний податковий номер

Телефон

O

Рядок (20)

Телефон контрагента

GLN

M

Integer (13)

Глобальний номер розташування (GLN) контрагента

ВідповідальнаОсоба

M

Мількість входжень вузла: Min = 1; Max = 1

Дані відповідальної особи (початок блоку)

Прізвище

M

Рядок (50)

Прізвище

Імя

M

Рядок (50)

Імя

ПоБатькові

M

Рядок (50)

По батькові

ІПН

M

Рядок (12)

Індивідуальний податковий номер

Посада

M

Рядок (200)

Посада довіреної особи

НаПідставі

M

Рядок (200)

№ довіреності / назва документа

НаПідставіДата

M

Дата (РРРР-ММ-ДД)

Дата довіреності / документа

ВідповідальнаОсоба

   

Дані відповідальної особи (завершення блоку)

Контрагент

   

Контрагент (завершення блоку)

Контрагент

M

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача

СтатусКонтрагента

M

Рядок (30)

Допустимі значення: Виконавець

ВидОсоби

M

Рядок (20)

Допустимі значення: Юридична; Фізична

НазваКонтрагента

M

Рядок (200)

Назва контрагента

КодКонтрагента

M

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

M

Рядок (12)

Індивідуальний податковий номер

Телефон

O

Рядок (20)

Телефон контрагента

GLN

M

Integer (13)

Глобальний номер розташування (GLN) контрагента

Контрагент

   

Контрагент (завершення блоку)

Сторони

   

Сторони, між якими укладено документ (завершення блоку)

МісцеДоставки

O

 

Місце доставки (початок блоку)

GLN

O

Integer (13)

Глобальний номер розташування (GLN) місця доставки

Індекс

O

Integer (5)

Індекс

Область

O

Рядок (100)

Область

Місто

O

Рядок (100)

Місто

Вулиця

O

Рядок (100)

Вулиця

МісцеДоставки

   

Місце доставки (завершення блоку)

Параметри

M

 

Параметри (початок блоку). Тег передбачає довільне значення; використовується для передачі додаткової інформації, що не входить до основних полей специфікації

<Параметр ІД=«1» назва=«Точка доставки»>4829900017590</Параметр>

M

Рядок (250)

Додаткові параметри. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю. Для ІД=1 вказується точка доставки. Максимальна кількість тегів – 99.

<Параметр ІД=«2» назва=«Адреса доставки»>Дніпропетровська обл., Дніпровський р-н, територія Слобожанської селищної ради, комплекс будівель та споруд №8</Параметр>

M

Рядок (250)

Додаткові параметри. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю. Для ІД=2 вказується розшифровка адреси доставки. Максимальна кількість тегів – 99.

Параметри

   

Параметри (завершення блоку)

Таблиця

M

Кількість входжень вузла: Min = 0; Max = 1

Таблиця (початок блоку)

Рядок

M

Кількість входжень вузла: Min = 1;Max = 9999

Рядок (початок блоку). У кожного наступного блоку ідентифікатор (ІД) збільшується на одиницю

НомПоз

M

Integer (3)

Номер позиції

АртикулПокупця

M

Рядок (32)

Артикул покупця

Найменування

M

Рядок (250)

Найменування товарної позиції

ПрийнятаКількість

M

Decimal (#.000)

Прийнята кількість товарних позицій

ОдиницяВиміру

M

Рядок (10)

Одиниці виміру

БазоваЦіна

M

Decimal (#.00)

Ціна за одиницю без ПДВ

ВсьогоПоРядку

M

Кількість входжень вузла: Min = 0; Max = 1

Загальна сума по рядку (початок блоку)

СумаБезПДВ

M

Decimal (#.00)

Сума без ПДВ

ВсьогоПоРядку

   

Загальна сума по рядку (завершення блоку)

СтавкаПДВ

M

«0»/«7»/«20»

Ставка податку на додану вартість (%); Допустиме значення: 0 / 7 / 20

Рядок

   

Рядок (завершення блоку)

Таблиця

   

Таблиця (завершення блоку)

ВсьогоПоДокументу

M

Сумарні значення позицій за документом (початок блоку)

 

СумаБезПДВ

M

Decimal (#.00)

Сума без ПДВ по документу

ПДВ

M

Decimal (#.00)

Сума ПДВ по документу

Сума

M

Decimal (#.00)

Сума з ПДВ по документу

ВсьогоПоДокументу

   

Сумарні значення позицій за документом (завершення блоку)

ЕлектроннийДокумент

   

Завершення документа

[1] - елементи структури мають наступний вигляд:
  • параметрЗіЗначенням;

  • об’єктЗПараметрами;

  • масивОб’єктів;

  • жовтим фоном виділяються комірки, в яких відбувались останні зміни

[2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
  • M (mandatory) — обов’язкові до заповнення поля;

  • O (optional) — необов’язкові (опціональні) для заповнення поля.


За цим посиланням можна завантажити XML-Приклад COMDOC_032


XML Специфікації документів для роботи з «АТБ»

Акт приймання-передачі (додаток 9) (COMDOC_033)

Акт приймання-передачі (додаток 9) (COMDOC_033)

Опис полів

Назва поля

Тип 1

Формат

Опис

ЕлектроннийДокумент

M

 

Початок документу

Заголовок

M

Кількість входжень вузла: Min = 1; Max = 1

Заголовок (початок блоку)

НомерДокументу

M

Рядок (16)

Номер документу

ТипДокументу

M

Рядок (50)

Тип документу: Акт приймання-передачі (додаток 9)

КодТипуДокументу

M

«033»

Допустиме значення: 033 => Акт приймання-передачі (додаток 9)

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документу

НомерЗамовлення

M

Рядок (32)

Номер замовлення

ДатаЗамовлення

M

Дата (РРРР-ММ-ДД)

Дата здійснення замовлення

ДокВерсія

M

Число позитивне (1-99)

Версія документа

ДокПідстава

M

Кількість входжень вузла: Min = 0; Max = 10

Документ-підстава (початок блоку)

НомерДокументу

M

Рядок (30)

Номер документу-підстави

ТипДокументу

M

Рядок (50)

Тип документа: Договір

КодТипуДокументу

M

«001»

Допустиме значення: 001 => Договір

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документу-підстави

ДокПідстава

   

Документ-підстава (завершення блоку)

НомерВідвантаження

M

Рядок (50)

Номер повідомлення про відвантаження

ДатаВідвантаження

M

Дата (РРРР-ММ-ДД)

Дата повідомлення про відвантаження

Заголовок

   

Заголовок (завершення блоку)

Сторони

M

Мількість входжень вузла: Min = 1; Max = 1

Сторони, між якими укладено документ (початок блоку)

Контрагент

M

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача

СтатусКонтрагента

M

Рядок (30)

Допустимі значення: Виконавець

ВидОсоби

M

Рядок (20)

Допустимі значення: Юридична; Фізична

НазваКонтрагента

M

Рядок (200)

Назва контрагента

КодКонтрагента

M

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

M

Рядок (12)

Індивідуальний податковий номер

GLN

M

Integer (13)

Глобальний номер розташування (GLN) контрагента

Контрагент

   

Контрагент (завершення блоку)

Контрагент

M

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача

СтатусКонтрагента

M

Рядок (30)

Допустимі значення: Замовник

ВидОсоби

M

Рядок (20)

Допустимі значення: Юридична; Фізична

НазваКонтрагента

M

Рядок (50)

Назва контрагента

КодКонтрагента

M

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

M

Рядок (12)

Індивідуальний податковий номер

GLN

M

Integer (13)

Глобальний номер розташування (GLN) контрагента

ВідповідальнаОсоба

O

Мількість входжень вузла: Min = 1; Max = 1

Відповідальна особа (дані)

Прізвище

O

Рядок (50)

Прізвище

Імя

O

Рядок (50)

Імя

ПоБатькові

O

Рядок (50)

По батькові

ІПН

M

Рядок (12)

Індивідуальний податковий номер

Посада

O

Рядок

Посада довіреної особи

НаПідставі

O

Рядок

№ довіреності / назва документа

НаПідставіДата

O

Дата (РРРР-ММ-ДД)

Дата довіреності / документа

ВідповідальнаОсоба

     

Контрагент

   

Контрагент (завершення блоку)

Сторони

   

Сторони, між якими укладено документ (завершення блоку)

МісцеДоставки

O

 

Місце доставки (початок блоку)

GLN

O

Integer (13)

Глобальний номер розташування (GLN) місця доставки

Індекс

O

Integer (5)

Індекс

Область

O

Рядок (50)

Область

Місто

O

Рядок (50)

Місто

Вулиця

O

Рядок (50)

Вулиця

МісцеДоставки

   

Місце доставки (завершення блоку)

Параметри

M

 

Параметри (початок блоку). Тег передбачає довільне значення; використовується для передачі додаткової інформації, що не входить до основних полей специфікації

<Параметр ІД=«1» назва=«Точка доставки»>4829900017590</Параметр>

M

Рядок (250)

Додаткові параметри. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю. Для ІД=1 вказується точка доставки. Максимальна кількість тегів – 99.

<Параметр ІД=«2» назва=«Адреса доставки»>Дніпропетровська обл., Дніпровський р-н, територія Слобожанської селищної ради, комплекс будівель та споруд №8</Параметр>

M

Рядок (250)

Додаткові параметри. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю. Для ІД=2 вказується розшифровка адреси доставки. Максимальна кількість тегів – 99.

Параметри

M

 

Параметри (завершення блоку)

Таблиця

M

Кількість входжень вузла: Min = 0; Max = 1

Таблиця (початок блоку)

Рядок

M

Кількість входжень вузла: Min = 1;Max = 9999

Рядок (початок блоку). У кожного наступного блоку ідентифікатор (ІД) збільшується на одиницю

НомПоз

M

Integer (3)

Номер позиції

АртикулПокупця

M

Рядок (32)

Артикул покупця

Найменування

M

Рядок (250)

Найменування товарної позиції

ПрийнятаКількість

M

Decimal (#.000)

Прийнята кількість товарних позицій

ОдиницяВиміру

M

Рядок (10)

Одиниці виміру

БазоваЦіна

M

Decimal (#.00)

Ціна за одиницю без ПДВ

ВсьогоПоРядку

M

Кількість входжень вузла: Min = 0; Max = 1

Загальна сума по рядку (початок блоку)

СумаБезПДВ

M

Decimal (#.00)

Сума без ПДВ

СумаПДВ

O

Decimal (#.00)

Сума ПДВ

Сума

O

Decimal (#.00)

Сума

ВсьогоПоРядку

   

Загальна сума по рядку (завершення блоку)

СтавкаПДВ

M

«0»/«7»/«20»

Ставка податку на додану вартість (%); Допустиме значення: 0 / 7 / 20

Рядок

   

Рядок (завершення блоку)

Таблиця

   

Таблиця (завершення блоку)

ВсьогоПоДокументу

M

Сумарні значення позицій за документом (початок блоку)

 

СумаБезПДВ

M

Decimal (#.00)

Сума без ПДВ по документу

ПДВ

M

Decimal (#.00)

Сума ПДВ по документу

Сума

M

Decimal (#.00)

Сума з ПДВ по документу

ВсьогоПоДокументу

M

 

Сумарні значення позицій за документом (завершення блоку)

ЕлектроннийДокумент

M

 

Завершення документу

[1] - елементи структури мають наступний вигляд:
  • параметрЗіЗначенням;

  • об’єктЗПараметрами;

  • масивОб’єктів;

  • жовтим фоном виділяються комірки, в яких відбувались останні зміни

[2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
  • M (mandatory) — обов’язкові до заповнення поля;

  • O (optional) — необов’язкові (опціональні) для заповнення поля.


За цим посиланням можна завантажити XML-Приклад COMDOC_033


XML Специфікації документів для роботи з «АТБ»

Акт приймання товару до АПП (COMDOC_034)

Акт приймання товару до АПП (COMDOC_034)

Опис полів

Назва поля

Тип 1

Формат

Опис

ЕлектроннийДокумент

M

 

Початок документу

Заголовок

M

Кількість входжень вузла: Min = 1; Max = 1

Заголовок (початок блоку)

НомерДокументу

M

Рядок (16)

Номер документу

ТипДокументу

M

Рядок (50)

Тип документу: Акт приймання товару до АПП

КодТипуДокументу

M

«034»

Допустиме значення: 034 => Акт приймання товару до АПП

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документу

НомерЗамовлення

M

Рядок (20)

Номер замовлення

ДатаЗамовлення

M

Дата (РРРР-ММ-ДД)

Дата здійснення замовлення

НомерДоговоруПоставки

M

Рядок (30)

Номер договору, за яким здійснюється поставка

ДатаДоговоруПоставки

M

Дата (РРРР-ММ-ДД)

Дата договору, за яким здійснюється поставка

ДокВерсія

M

Число позитивне (1-99)

Версія документа

ДокПідстава

M

Кількість входжень вузла: Min = 0; Max = 10

Документ-підстава (початок блоку)

НомерДокументу

M

Рядок (30)

Номер документу-підстави

ТипДокументу

M

Рядок (50)

Тип документа: Акт прийому-перадачі товару

КодТипуДокументу

M

«032»

Допустиме значення: 032 => Акт прийому-перадачі товару

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документу-підстави

ДокПідстава

   

Документ-підстава (завершення блоку)

НомерВідвантаження

M

Рядок (50)

Номер повідомлення про відвантаження

ДатаВідвантаження

M

Дата (РРРР-ММ-ДД)

Дата повідомлення про відвантаження

Заголовок

   

Заголовок (завершення блоку)

Сторони

M

Мількість входжень вузла: Min = 1; Max = 1

Сторони, між якими укладено документ (початок блоку)

Контрагент

M

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача

СтатусКонтрагента

M

Рядок (30)

Допустимі значення: Виконавець

ВидОсоби

M

Рядок (20)

Допустимі значення: Юридична; Фізична

НазваКонтрагента

M

Рядок (50)

Назва контрагента

КодКонтрагента

M

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

M

Рядок (12)

Індивідуальний податковий номер

GLN

M

Integer (13)

Глобальний номер розташування (GLN) контрагента

Контрагент

   

Контрагент (завершення блоку)

Контрагент

M

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача

СтатусКонтрагента

M

Рядок (30)

Допустимі значення: Замовник

ВидОсоби

M

Рядок (20)

Допустимі значення: Юридична; Фізична

НазваКонтрагента

M

Рядок (200)

Назва контрагента

КодКонтрагента

M

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

M

Рядок (12)

Індивідуальний податковий номер

GLN

M

Integer (13)

Глобальний номер розташування (GLN) контрагента

ВідповідальнаОсоба

M

Мількість входжень вузла: Min = 1; Max = 1

Дані відповідальної особи (початок блоку)

Прізвище

M

Рядок (50)

Прізвище

Імя

M

Рядок (50)

Імя

ПоБатькові

M

Рядок (50)

По батькові

ІПН

M

Рядок (12)

Індивідуальний податковий номер

Посада

M

Рядок

Посада довіреної особи

НаПідставі

M

Рядок

№ довіреності / назва документа

НаПідставіДата

M

Дата (РРРР-ММ-ДД)

Дата довіреності / документа

ВідповідальнаОсоба

   

Дані відповідальної особи (завершення блоку)

Контрагент

   

Контрагент (завершення блоку)

Сторони

   

Сторони, між якими укладено документ (завершення блоку)

МісцеДоставки

O

 

Місце доставки (початок блоку)

GLN

O

Integer (13)

Глобальний номер розташування (GLN) місця доставки

Індекс

O

Integer (5)

Індекс

Область

O

Рядок (50)

Область

Місто

O

Рядок (50)

Місто

Вулиця

O

Рядок (50)

Вулиця

МісцеДоставки

   

Місце доставки (завершення блоку)

Параметри

M

 

Параметри (початок блоку). Тег передбачає довільне значення; використовується для передачі додаткової інформації, що не входить до основних полей специфікації

<Параметр ІД=«1» назва=«Точка доставки»>4829900017590</Параметр>

M

Рядок (250)

Додаткові параметри. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю. Для ІД=1 вказується точка доставки. Максимальна кількість тегів – 99.

<Параметр ІД=«2» назва=«Адреса доставки»>Дніпропетровська обл., Дніпровський р-н, територія Слобожанської селищної ради, комплекс будівель та споруд №8</Параметр>

M

Рядок (250)

Додаткові параметри. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю. Для ІД=2 вказується розшифровка адреси доставки. Максимальна кількість тегів – 99.

Параметри

M

 

Параметри (завершення блоку)

Таблиця

M

Кількість входжень вузла: Min = 0; Max = 1

Таблиця (початок блоку)

Рядок

M

Кількість входжень вузла: Min = 1;Max = 9999

Рядок (початок блоку). У кожного наступного блоку ідентифікатор (ІД) збільшується на одиницю

НомПоз

M

Integer (3)

Номер позиції

АртикулПокупця

M

Рядок (32)

Артикул покупця

Найменування

M

Рядок (250)

Найменування товарної позиції

ЗаявленаКількість

M

Decimal (#.00)

Заявлена кількість товарних позицій

ПрийнятаКількість

M

Decimal (#.000)

Прийнята кількість товарних позицій

ОдиницяВиміру

M

Рядок (10)

Одиниці виміру 2

БазоваЦіна

M

Decimal (#.00)

Ціна за одиницю без ПДВ

ВсьогоПоРядку

M

Кількість входжень вузла: Min = 0; Max = 1

Загальна сума по рядку (початок блоку)

СумаБезПДВ

M

Decimal (#.00)

Сума без ПДВ

СумаПДВ

O

Decimal (#.00)

Сума ПДВ

Сума

O

Decimal (#.00)

Сума

ВсьогоПоРядку

   

Загальна сума по рядку (завершення блоку)

СтавкаПДВ

M

«0»/«7»/«20»

Ставка податку на додану вартість (%); Допустиме значення: 0 / 7 / 20

Причина

M

Кількість входжень вузла: Min = 0; Max = 1

Причина для повернення (початок блоку)

Кількість

M

Decimal (#.00)

Кількість відхилень

Причина

   

Причина для повернення (завершення блоку)

Рядок

   

Рядок (завершення блоку)

Таблиця

   

Таблиця (завершення блоку)

ВсьогоПоДокументу

M

Сумарні значення позицій за документом (початок блоку)

 

СумаБезПДВ

M

Decimal (#.00)

Сума без ПДВ по документу

ПДВ

M

Decimal (#.00)

Сума ПДВ по документу

Сума

M

Decimal (#.00)

Сума з ПДВ по документу

ВсьогоПоДокументу

M

 

Сумарні значення позицій за документом (завершення блоку)

ЕлектроннийДокумент

M

 

Завершення документу

[1] - елементи структури мають наступний вигляд:
  • параметрЗіЗначенням;

  • об’єктЗПараметрами;

  • масивОб’єктів;

  • жовтим фоном виділяються комірки, в яких відбувались останні зміни

[2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
  • M (mandatory) — обов’язкові до заповнення поля;

  • O (optional) — необов’язкові (опціональні) для заповнення поля.


За цим посиланням можна завантажити XML-Приклад COMDOC_034


XML Специфікації документів для роботи з «АТБ»

Повідомлення про прийом (RECADV)

XML специфікація документа Повідомлення про прийом (RECADV) є стандартною, її можна знайти за посиланням.

Робота з мережею «АТБ» через API

Інструкція для постачальників по обміну Е-ТТН на постачання товару в ТОВ «АТБ-МАРКЕТ»

1. Загальні положення по обміну документами  

1.1.Електронний документообіг впроваджується для операцій постачання товару. Документи для  повернення товару, постачання/повернення тари, супровідні документи (сертифікати якості товару) довіреності, специфікації – продовжують оформлятися у паперовому вигляді.  

1.2.В електронний вигляд переводяться наступні документи: 
- ТТН та підпорядковані до неї акти;
- Видаткова накладна та Акт приймання до ВН; 
До моменту початку роботи Центральної Бази Даних (ЦБД) електронні ТТН необхідно дублювати  паперовою копією ТТН. 

1.3.Електронний підпис: при підписанні електронних документів необхідно використовувати  кваліфікований електронний підпис на захищеному носії (далі КЕП). Зверніть увагу, УЕП  (удосконалений електронний підпис) не підходить! Для представників Постачальника та  Вантажовідправника обов’язковим є посадовий КЕП юридичної особи, що містить посаду  співробітника (наприклад, «Комірник»), РНОКПП особи і ЄДРПОУ підприємства. Для Водія та  Експедитора допустимим є особистий КЕП фізичної особи, що обов’язково містить РНОКПП особи;  посада водія та експедитора в КЕП не є обов’язковою. Також КЕП має бути у всіх інших учасників  перевезення, в разі, якщо вони будуть підписувати е-ТТН (Проміжний склад, Перевізник тощо). 

1.4.Обов’язковий мінімум підписів (КЕП) в електронних документах:
- Видаткова накладна: КЕП матеріально-відповідальної особи Постачальника; - Е-ТТН: КЕП матеріально-відповідальної особи Вантажовідправника; КЕП Водія, що здійснює  доставку товару на РЦ, підписувати саме під роллю Водія, а не Перевізника;
- Акт розбіжностей до е-ТТН: КЕП Водія, що здійснює доставку товару на РЦ, підписувати саме  під роллю Водія, а не Перевізника.
- Підпис Директора, головного бухгалтера, бухгалтера, іншого спеціаліста, тощо є допустимим  згідно чинного законодавства та Договору. 

1.5.Якщо Постачальник працює через Логістичного оператора (третю особу), що здійснює послуги  відповідального зберігання для Постачальника, в такому випадку в е-ТТН Замовником вказується  Постачальник, а Вантажовідправником – Логістичний оператор, що відвантажує товар. Е-ТТН  підписується представником Вантажовідправника (Логістичного оператора). 

1.6.Накладання печатки підприємства на Видаткову накладну і пов’язані акти приймання - заборонено.  В е-ТТН печатка підприємства допустима, але не є обов’язковою і не може бути альтернативою  посадового КЕП. Відповідно, з боку АТБ печатка підприємства накладатися не буде. 

2. Вимоги до оформлення електронних документів 

2.1. В Замовленні, яке Постачальник отримує від АТБ, в полі «Додаткова інформація» зазначено, за  яким документообігом очікується поставка. Якщо зазначено «Електронний-ДО» - до цього  Замовлення необхідно оформлювати електронний пакет документів. 

Зверніть увагу!! Якщо в Замовленні зазначено «Електронний-ДО», то Повідомлення про  відвантаження без пакету електронних документів на склад не передається. 

Приклад: 

Снимок экрана 2026-06-05 в 11.13.44.png

2.2 В єдиний пакет документів входять: «Повідомлення про відвантаження», «Видаткова накладна» та «е-ТТН». Для об'єднання документів в єдиний ланцюжок (з однаковим номером BRANCH_UUID),  всі електронні документи мають бути створені на основі одного Повідомлення про відвантаження  та повинні мати однакову дату документа (наприклад, дата «Від_01.12.2025» однакова для всіх  документів ланцюжка). Номер BRANCH_UUID формується з таких тегів Повідомлення про  відвантаження: <NUMBER> (номер Повідомлення), <DATE> (дата Повідомлення), <ORDERNUMBER>  (номер Замовлення), <ORDERDATE> (дата Замовлення). 

- Якщо одне Замовлення виконується декількома поставками, то для кожної поставки створюється  окремий пакет документів, а номер кожного нового Повідомлення про відвантаження має бути  унікальним. Таким чином, до кожного унікального Повідомлення про відвантаження мають бути  оформлені окрема Видаткова накладна і е-ТТН, всі документи пакета з однаковою датою  документа. Номер BRANCH_UUID повинен бути унікальним для кожного пакету. 

- Нова версія Повідомлення про відвантаження може бути створена за необхідності виправлення  помилки в Повідомленні. Для створення нової версії Повідомлення про відвантаження, всі теги, що  створюють BRANCH_UUID, повинні залишитись незмінними, змінюється тільки номер версії  Повідомлення: <VERSION>. 

- Нова версія Видаткової накладної може бути створена за необхідності виправлення помилки у ВН.  В такому випадку нова версія документу створюється на основі останньої версії Повідомлення про  відвантаження, а BRANCH_UUID пакету залишається незмінним. 

- Нова версія е-ТТН створюється шляхом створення нової транзакції е-ТТН – через додавання нового  підпису КЕП. Створення нової версії е-ТТН шляхом клонування документу заборонено! В разі неможливості виправлення помилки шляхом створення нової транзакції е-ТТН (наприклад, е-ТТН  підписана підписом на незахищеному носії, що є критичною помилкою), необхідно створити  повністю новий пакет ЮЗД з новим номером BRANCH_UUID. Для цього створюється нове  Повідомлення про відвантаження з новим унікальним номером, на основі якого створюються всі 

інші документи ланцюжка: Видаткова, е-ТТН (номера цих документів, крім Повідомлення, можуть  залишитись старими). 

2.3. Планова дата постачання повинна бути однаковою в Повідомленні про відвантаження та у  Видатковій накладній і не може буте раніше дати постачання, що зазначена в Замовленні. Номер  Видаткової накладної в Повідомленні про відвантаження та фактично у Видатковій накладній  повинен співпадати. 

2.4. Всі юридичні назви та юридичні адреси в документах мають бути заповнені згідно з даними  бази Мінюсту, включно з регістром, лапками, комами і т. ін. Наприклад: 

- юридична назва: ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ "АТБ-МАРКЕТ" 

- юридична адреса: Україна, 49000, Дніпропетровська обл., місто Дніпро, ПРОСПЕКТ ОЛЕКСАНДРА  ПОЛЯ, будинок 40 

Зайва кома, або інший тип лапок, або інший регістр в електронних документах призводять до  помилки документа. Документи з помилками не обробляються, приймання товару блокується. 

2.5. Видаткова накладна: 

- Номер документу підстави (№ Договору постачання) – у форматі «Р40586»;
- Найменування товару – українською мовою, ідентично найменуванню в податковій накладній.  Допускається назва ТМ латиницею. Найменування товарів в усіх документах пакету мають  співпадати;
- Поле «Код УКТЗЕД» обов’язкове і повинно мати значення не менше 4 і не більше 10 символів;
- В блоці «Місце доставки» обов’язковим є поле «Область»;
- Значення «GLN» в Місце доставки та «Точка доставки» в Параметрах мають збігатися.
- Якщо постачальник неплатник ПДВ, постачальнику потрібно замість ІПН вносити константу:  "100000000000". 

2.6. Е-ТТН: 

- В існуючій реалізації можливо використання тільки такого коду підтипу документа: urn:ua:e transport.gov.ua:ettn:01:generic:001 - generic (default);
- Обов’язковими є підписи Вантажовідправника та Водія;
- У відповідальної особи з посадовим підписом має бути зазначений код ЄДРПОУ та РНОКПП. Для  непосадового підпису фізичної особи – код РНОКПП. ПАСПОРТ – не вказувати;
- Всі підписанти документу мають бути вказані в блоці Вантажно-розвантажувальні операції. Вказані  дані підписантів в блоці Вантажно-розвантажувальні операції мають співпадати з даними в КЕП підписантів (посада, ЄДРПОУ, РНОКПП тощо);
- Поле «Місце складання» повинно містити вичерпну інформацію для ідентифікації місця складання,  точність до рівня коду населеного пункту згідно кодифікатору КАТОТТГ;
- Атрибут «Відомості про транспортний засіб» – обов’язкове заповнення всіх атрибутів: Довжина,  Ширина, Висота та Загальна маса з вантажем в КГ. 

Снимок экрана 2026-06-05 в 11.14.15.png

- Поле «Пункт розвантаження» повинно містити адресу локації (РЦ), на яку здійснюється доставка, згідно з Довідником локацій Провайдера; 
- Супровідні документи на вантаж: обов’язкові значення: «Повідомлення про відвантаження» та  «Замовлення», на підставі якого виконується поставка:

Снимок экрана 2026-06-05 в 11.14.35.png

Таблиця 2.1. Допустимі типи супровідних документів на вантаж в е-ТТН: 

Код 

Назва 

Опис

220 

Замовлення 

Обов’язкове значення - Документ/повідомлення, за  допомогою якого покупець ініціює трансакцію з  продавцем

351 

Повідомлення про  

відвантаження

Обов’язкове значення - Повідомлення про  відвантаження (DESADV)

916 

Коригуючій акт 

Використовується при формуванні актів, для вказання  попередньої транзакції поточного акту

723 

Спеціальна охорона вантажу 

Документ, що підтверджує надання спеціальних  охоронних послуг

290 

Право на пред'явлення претензії 

Запис про передачу права на пред’явлення претензії

441 

Маршрутний лист 

Документ, що визначає маршрути перевезень між  пунктами

335 

Заявка на транспортування 

Заявка на транспортування

770 

Підтвердження заявки на  

транспортування

Підтвердження заявки на транспортування

- В блоці «Загальні дані» – обов’язкове заповнення кожного атрибуту. Зверніть увагу, атрибут «У  тому числі ПДВ, грн» ("vatAmount") – обов’язкове заповнення: 

Снимок экрана 2026-06-05 в 11.15.01.png

- В блоці «Відомості про вантаж»: 

а) Найменування – обов’язкове заповнення українською мовою;
б) Артикул покупця – Код АП, обов’язкове заповнення;
в) Одиниця виміру – відноситься до кількості місць транспортної упаковки (в піддонах, або ящиках),  обов’язкове значення – «Штука»;
г) Кількість місць – транспортної упаковки (кількість піддонів, або ящиків) обов’язкове заповнення; д) Кількість одиниць – в одиницях Замовлення (в штуках, кг, або пачках), обов’язкове заповнення;
е) Одиниця виміру к-сті одиниць, допустимі значення: ["ПАЧ", "ПАЧ.", "ПАЧКА", "BH" (латиницею),  "ШТУКА", "ШТ", "ШТ.", "PCE" (латиницею), "КІЛОГРАМ", "КГ", "КГ.", "KGM" (латиницею)] – обов’язкове заповнення. Значення BASE_UOM повинно співпадати зі значенням "Одиниці виміру" у  Видатковій та АПП8. Наприклад, якщо у Видатковій і АПП8 вказано "шт", то і в е-ТТН має бути "шт";
є) Вид пакування – обов’язкове заповнення;
ж) Ціна без ПДВ за одиницю – обов’язкове заповнення;
з) Загальна сума з ПДВ – обов’язкове заповнення;
и) Загальна сума без ПДВ – обов’язкове заповнення;
і) Маса брутто, кг – обов’язкове заповнення; 

! Якщо доставка здійснюється в одиницях Замовлення, в такому випадку «Кількість місць» =  «Кількість одиниць», а «Одиниця виміру» = «Одиниця виміру к-сті одиниць», допустимі значення:  ["ПАЧ", "ПАЧ.", "ПАЧКА", "BH" (латиницею), "ШТУКА", "ШТ", "ШТ.", "PCE" (латиницею), "КІЛОГРАМ",  "КГ", "КГ.", "KGM" (латиницею)]. 

Снимок экрана 2026-06-05 в 11.15.22.png

- В блоці «Вантажно-розвантажувальні операції»: 

а) Поле «Навантаження, маса брутто» – обов’язкове заповнення;
б) Дата і Час прибуття – це час, коли авто прибуло під навантаження на склад Постачальника – обов’язкове заповнення;
в) Дата і Час вибуття – це час, коли авто вибуло після навантаження зі складу Постачальника – обов’язкове заповнення;
г) Час простою – обов’язкове заповнення в форматі time «HH:MM» (наприклад, 00:30); д) Поле «Здав, відповідальна особа Вантажовідправника» – обов’язкове заповнення; е) Поле «Прийняв (відповідальна особа перевізника) дані водія – обов’язкове заповнення»;
є) Якщо е-ТТН підписує Експедитор, поле «Прийняв експедитор» – обов’язкове заповнення.

Снимок экрана 2026-06-05 в 09.34.52.png

2.7. Надіслані документи одразу проходять первинну валідацію на боці АТБ на повноту та  коректність заповнення обов’язкових атрибутів.  

Якщо документи не пройшли первинну валідацію, на Порталі провайдера про це буде повідомлено.  Також вказується причина скасування документу. 

Приклад помилки валідації для Видаткової накладної на ВЕБ-платформі EDIN:

Снимок экрана 2026-06-05 в 09.34.13.png

Снимок экрана 2026-06-05 в 09.34.33.png

Приклад помилки валідації для е-ТТН на ВЕБ-платформі EDIN:

Снимок экрана 2026-06-05 в 09.35.16.png

Снимок экрана 2026-06-05 в 09.35.39.png

Зверніть увагу, якщо на Порталі провайдера відсутній статус по надісланим документам (немає  жодного значку в правому верхньому кутку), це означає, що документи не пройшли перевірку в  системі АТБ. Можливі причини: не вистачає якогось з документів пакету; документи не поєднались  в єдиний ланцюжок; вказано отримувачем не АТБ чи ЛЮ; документ не отримано системою АТБ. 

Приклад документу Видаткова накладна без статусу результатів перевірки в системі АТБ:

Снимок экрана 2026-06-05 в 09.36.05.png

2.8. Специфікації електронних документів: 

https://wiki.edin.ua/uk/latest/ClientProcesses/ATB/ATB_XML-structure.html?highlight#xml https://wiki.edin.ua/uk/latest/Docs_ETTNv3/Docs_ETTNv3_list.html#ettn-v3 

2.9. Після успішного проходження первинної валідації, за умови, що всі документи Пакету отримано,  документи передаються на проходження вторинних логічних перевірок, які розпочинаються після  20:00 за день до дати постачання по Замовленню. Після 20:00 вторинні перевірки документів  відбуваються кожні 10-15 хвилин. При виявленні вторинних помилок на Портал Провайдера  відправляється статус про результати перевірки з кодом помилки (див. Таблицю 2.2. Перелік кодів  помилок). Якщо буде виявлено помилку на рівні шапки, в повідомленні буде вказано тільки код  помилки, а якщо на рівні деталей, то буде вказано код помилки і код товару, в якому виявлено  помилку, наприклад: 4_107168, де «4» – код помилки ціни, а «107168» – код товару (код АП), по  якому не співпадає ціна. 

Таблиця 2.2. Перелік кодів помилок

Код 

Опис помилки 

Дії Постачальника

Помилка кількості товару 

Перевірити відповідність кількості в Повідомленні  про відвантаженні (DESADV) та ЮЗД + е-ТТН. Кількість  у DESADV може бути автоматично змінено системою  АТБ, в разі перевищення кількості із ORDERS.  Привести у відповідність кількість між ORDERS,  DESADV та ЮЗД, шляхом створення нових версій  документів.  

У випадку помилки в е-ТТН – створити повністю  новий пакет документів

Товар відсутній в повідомленні про  відвантаження (DESADV)

Перевірити коректність кодів АП товарів, створити нові версії ЮЗД з коректним товаром. У випадку  помилки в е-ТТН – створити повністю новий пакет  документів

Невідповідність закупівельної ціни  без ПДВ товару (товарів) між  

документами та системою АТБ

Якщо помилка на боці Постачальника – створити нові  версії ЮЗД з коректними цінами. У випадку помилки  в е-ТТН – створити повністю новий пакет документів. 

Дата поставки в DESADV та ВН не  відповідає даті поставки Замовлення

Перевірити відповідність дати постачання  Замовлення даті постачання в DESADV і у ВН.  Створити нові версії документів з коректною датою  поставки

Невідповідність ставки ПДВ товару  (товарів) між документами та  

системою АТБ

Якщо помилка на боці Постачальника – сформувати  новий пакет з коректними ПДВ. Якщо помилка на  боці АТБ – звернутися до Категорійного менеджера  Служби закупок

Помилка суми без ПДВ 

Створити нові версії документів з коректною сумою  без ПДВ

Помилка суми ПДВ 

Створити нові версії документів з коректною сумою  ПДВ

Помилка суми з ПДВ 

Створити нові версії документів з коректною сумою з  ПДВ

11 

Юридична назва Постачальника/  Вантажовідправника/ Замовника не  відповідає інформації з ЄДР

Створити нові версії документів з повною юридичною назвою з урахуванням регістру, наприклад:  АКЦІОНЕРНЕ ТОВАРИСТВО "РУДЬ".  

Якщо назва внесена вірно, але помилка не зникає,  звернутися до Менеджера Служби закупок і з’ясувати коректність внесення назви в систему АТБ

13 

Юридична назва  

Покупця/Вантажоодержувача не  відповідає інформації з ЄДР

Створити нові версії документів з повною юридичною назвою з урахуванням регістру, наприклад: ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ  "ЛОГІСТИК ЮНІОН"

14 

Не коректний ЄДРПОУ  

Постачальника/Вантажовідправника/  Замовника

Створити нові версії документів з коректним ЄДРПОУ. Якщо ЄДРПОУ вказано вірно, але помилка не зникає,  звернутися до Менеджера Служби закупок і з’ясувати коректність внесення ЄДРПОУ в систему АТБ

16 

Не коректний ЄДРПОУ  

Покупця/Вантажоодержувача

Створити нові версії документів з коректним ЄДРПОУ

17 

Помилка юридичної адреси  

Покупця/Вантажоодержувача

Створити нові версії документів з коректною  юридичною адресою. Для е-ТТН можливо  використовувати Акт про зміну пункту призначення.  Довідник актуальних юридичних адрес знаходиться у  Провайдера

18 

В DESADV вказана схема постачання  з Відповідального зберігання ЛЮ,  для якої не передбачено створення  е-ТТН

Перевірити схему постачання. Якщо дійсно схема  Відповідального зберігання ЛЮ, то необхідно  анулювати зайвий документ е-ТТН. Якщо постачання  без Відповідального зберігання ЛЮ, необхідно  створити повністю новий пакет документів з новим DESADV, в якому заповнити тег: 

<RECIPTYPE>0</RECIPTYPE>, що вказує на постачання  напряму на РЦ/склад

19 

Помилка дати документа. Дата  документу повинна співпадати для  кожного документу пакету.

Створити нові версії документів з коректною датою  Документу та з однаковою «Датою Від…» для  кожного документу пакету. У випадку помилки в е ТТН – створити повністю новий пакет документів.  Допускається дата ВН більше дати е-ТТН та АПП8 на  один день. Дата «Документ №… Від…» повинна бути  не менше 5 і не більше 5 днів від дати постачання по  Замовленню, та повинна співпадати для кожного  документу пакету.

20 

Товар присутній в DESADV, але  відсутній в ЮЗД + е-ТТН

Створити нові версії ЮЗД з коректними товарами. У  випадку помилки в е-ТТН – створити повністю новий  пакет документів

21 

Помилка адреси Місця поставки: або  помилка в адресі, або взагалі  

вказано не коректну локацію, на яку  не очікується доставка

Створити нові версії документів з коректною адресою Місця доставки. Для е-ТТН можливо використовувати  Акт про зміну пункту призначення. Довідник  актуальних адрес локацій знаходиться у Провайдера

22 

Помилка дати Договору 

Створити нові версії документів з коректною датою  Договору

23 

Документ не відповідає Договору  постачання

Даний електронний документ не очікується в процесі  постачання. Наприклад, отримано документ АПП8  для поставки без Договору ЛЮ. Перевірте Договірні  умови, в разі помилки на боці АТБ – зверніться до  Категорійного менеджера Служби закупок

25 

Не допускається в одному документі  товари з різними ставками ПДВ

Створити новий пакет Документів з ідентичною  ставкою ПДВ товарів

26 

Помилка номеру Договору 

Створити нові версії документів з коректним  номером Договору: для ВН – Договір постачання, для  АПП8 – Договір Логістики

27 

В документі вказано не вірний код  КАТОТТГ Місця розвантаження

Створити нові версії документів з коректним КАТОТТГ  Місця доставки. Довідник актуальних адрес локацій  знаходиться у Провайдера

28 

Одиниця виміру товарів між  

документами комплекту не  

збігається

Створити нові версії документів. В залежності від  комплекту документів по Договору, одиниці виміру  для товарів у ВН та е-ТТН або у ВН, АПП8 та е-ТТН  повинні збігатися

29 

Маса брутто в шапці документу не  відповідає сумі ваги детальної  частини

Створити нову версію е-ТТН з відповідністю Маси  брутто в шапці, в блоці Вантажно-розвантажувальні  операції та в деталях документу

30 

Кількість місць в шапці документу е ТТН не відповідає сумі кількості  місць детальної частини

Створити нову версію е-ТТН з відповідністю Кількості  місць в шапці та в деталях документу

31 

Не коректне Повне найменування  Пункту розвантаження в е-ТТН

або помилка в найменуванні, або вказано не  коректну локацію доставки. Створити нову версію е ТТН з коректним найменування Місця постачання.  Можливо використовувати Акт про зміну пункту  призначення. Довідник актуальних адрес локацій  знаходиться у Провайдера

33 

ІПН Постачальника Документу не  відповідає ІПН в Договорі

Створити нові версії документів з коректним ІПН. У випадку помилки в е-ТТН – створити повністю новий  пакет документів. Якщо ІПН внесений вірно, але  помилка не зникає, звернутися до Менеджера  Служби закупок і з’ясувати коректність внесення ІПН в систему АТБ

34 

Не коректний ІПН Покупця/  

Виконавця

Створити нові версії документів з коректним ІПН  Покупця/ Виконавця. У випадку помилки в е-ТТН – створити повністю новий пакет документів. Для ВН – ІПН АТБ-Маркет, для АПП8 та е-ТТН – ІПН Логістик  Юніон

В разі отримання відповіді про Помилку закупівельної ціни (код помилки – 4), Постачальнику  необхідно звернутися до категорійного менеджера Служби закупок і надати інформацію про не  коректну ціну: Номер Замовлення, Код АП товару, Дата постачання, Актуальна ціна. Менеджер  Служби закупок приймає рішення про редагування ціни в Замовленні. 

Відповідь надається по кожному документу окремо. Тому Видаткова та е-ТТН можуть бути без  помилок, а Видаткова з помилкою (наприклад, не коректний номер або дата Договору). В такому  випадку Повідомлення про відвантаження не передається в систему складу для приймання товару до моменту виправлення помилки. 

Також статус перевірки може змінитись в обидва боки. Наприклад, спочатку е-ТТН була успішно  перевірена, але потім додався підпис Експедитора на незахищеному носії, відповідно е-ТТН  отримає статус Відмова в підписанні. 

Тільки після успішного проходження перевірок всіх документів, що входять в пакет ЮЗД, а також  при наявності всіх документів в пакеті і при наявності всіх підписів в документах зі сторони  Постачальника та Водія, в систему складу передається Повідомлення про відвантаження. Але варто  зауважити, що навіть після успішного проходження перевірок та після передачі Повідомлення про  відвантаження в систему складу, в разі, якщо в е-ТТН будуть внесені зміни, які не пройдуть  перевірку, приймання товару буде заблоковано (наприклад, Перевізник при підписанні е-ТТН  видалив дані Водія, або підписав документ невалідним підписом). 

Якщо документи успішно пройшли первинну та вторинну перевірки в системі АТБ, на порталі  Провайдера для такого документу з’явиться відповідний статус (значок зеленого кольору в правому  верхньому кутку). 

Приклад документів, що пройшли успішну перевірку в системі АТБ:

Снимок экрана 2026-06-05 в 09.39.48.png

3. Приймання товару на Складі без розбіжностей 

3.1.Склад «АТБ-маркет» здійснює приймання. Якщо кількість поставленого товару відповідає кількості  DESADV, приймальник підписує е-ТТН за допомогою КЕП. 

3.2.Після приймання товару, якщо кількість поставленого товару відповідає кількості DESADV, і фактична  дата приймання товару відповідає даті постачання із Замовлення, співробітник складу «АТБ маркет» підписує Видаткову накладну Постачальника. Документ отримує статус «Підтверджено з  двох сторін». 

Схема обміну документами без розбіжностей: 

Снимок экрана 2026-06-05 в 09.40.25.png

4. Приймання товару на Складі з розбіжностями 

4.1.Якщо кількість прийнятого товару не відповідає кількості DESADV, приймальник створює Акт  розбіжностей до е-ТТН, в якому вказує кількість розбіжності (для штучного товару – в штуках, для  вагового товару – в кілограмах) і причину розбіжностей (для кожної позиції), ставить свою КЕП, після  чого Акт відправляється на підписання Водієві, шляхом публікації документа EDI-провайдером для  Перевізника. Водій підписує за допомогою КЕП Акт розбіжностей до е-ТТН, в разі згоди з ним, або  ставить відмову від підпису, в разі незгоди з Актом. У будь-якому випадку, приймальник «АТБ маркет» підписує е-ТТН тільки якщо з Водієм узгоджені всі спірні питання, за допомогою  оформлення Акту. 

4.2.Якщо кількість прийнятого товару не відповідає кількості DESADV і / або фактична дата приймання  товару відповідає даті постачання із Замовлення, на стороні «АТБ-маркет» оформлюється Акт  приймання до Видаткової накладної, в якому вказується відвантажена, фактично прийнята кількість товару і фактична дата приймання. Співробітник складу «АТБ-маркет» ставить КЕП, після чого  документ відправляється на підпис Постачальнику шляхом публікації документа EDI-провайдером. 

4.3.Представник Постачальника, отримавши Акт прийому до Видаткової накладної, підписує його за  допомогою КЕП, після чого оформлений документ публікується EDI-провайдером для ТОВ «АТБ МАРКЕТ». 

4.4.Після отримання відповіді про підписання Постачальником Акту приймання до Видаткової  накладної, співробітник складу «АТБ-маркет» підписує Видаткову накладну. 

4.5.У разі, якщо обидві сторони прийшли до висновку, що електронний документ некоректний,  анулювання такого документа проводиться шляхом формування нового документа Анулювання  (COMDOC_019), який створюється та підписується на боці АТБ і відправляється на підпис  Постачальнику. Документ анулювання може бути створений до вихідних документів АТБ: АПП№9,  Акту приймання до АПП№8 та Акту приймання до Видаткової накладної. В разі створення документу  Анулювання, АТБ також створить та відправить нову версію вихідного документу замість  анульованого. 

4.6.У разі, якщо Акт розбіжностей до е-ТТН після підписання Водієм не пройде перевірки: (наприклад,  підписано не КЕП; не заповнені дані Водія; підписано підписом в якому не співпадають дані Водія з  даними Водія, зазначеними в документі; підписано не водієм) – документ не пройде перевірки, а е-ТТН буде заблокована для підписання. В такому випадку необхідно оформити повністю новий  комплект документів, або перевести поставку на паперові копії. 

4.7.Документ Акт приймання до Видаткової накладної проходить перевірку після підписання  Постачальником. Якщо буде виявлено помилку підпису (наприклад, підпис не КЄП), документ буде оформлено з новою версію на боці АТБ та надіслано на підписання Постачальнику повторно. 

4.8.У випадку незгоди з документом Акт приймання до Видаткової накладної по причині розбіжності  суми – Постачальнику необхідно відмовитись від підписання документу та повідомити  співробітників складу про некоректні суми. 

Схема обміну документами з розбіжностями: 

Снимок экрана 2026-06-05 в 09.41.23.png

Зверніть увагу!

  1. В разі, якщо поставка не прийнята в повному об’ємі, АТБ не оформлює жодних електронних  документів. Подальша переадресація з оформленням Акту зміни пункту призначення або іншим чином – на боці Постачальника. 
  2. Е-ТТН для не прийнятого товару по причині бій/брак, або з інших причин, на боці АТБ не  оформлюється. Подальші дії вирішуються між Постачальником та Перевізником без  залучення АТБ. 
  3. Звертайте увагу на необхідність своєчасного підписання документів, з огляду на Договірні  умови. 
5. Використання Актів до е-ТТН в ЕДО з АТБ 

Акти розвантаження та завантаження на проміжному складі 

Використовуються у разі повного перевантаження вантажу (без розподілу на кілька актів) в процесі  перевезення на Проміжний склад з подальшим перевантаженням на інший автомобіль. Головною  умовою використання цього акту в роботі з АТБ є наявність підпису нового водія під роллю Водія в  е-ТТН. При його відсутності документ не пройде перевірку. В існуючій реалізації, після отримання  Акту розвантаження на проміжному складі система АТБ відправить статус помилки по е-ТТН, але  після отримання Акту завантаження на проміжному складі та за умови наявності інформації про  нового Водія та підпису нового Водія – е-ТТН пройде перевірку. 

https://wiki.edin.ua/uk/latest/ETTN_3_0/Create_StorageDelivery_Act_from.html#id1 https://wiki.edin.ua/uk/latest/ETTN_3_0/Create_StoragePickUp_Act_from.html#id1 

Акт перевантаження до е-ТТН 

Складається у випадку заміни транспортного засобу та/або водія в процесі перевезення, без заміни  е-ТТН. Головною умовою використання цього акту в роботі з АТБ є наявність інформації про нового  Водія та підпису нового водія під роллю Водія в е-ТТН. При його відсутності документ не пройде  перевірку. 

https://wiki.edin.ua/uk/latest/ETTN_3_0/Create_Reload_Act_from.html#id1 

Акт про заміну пункту призначення до е-ТТН 

Складається у випадку необхідності змінити Пункт розвантаження та/або Вантажоодержувача (Наприклад, в е-ТТН помилково вказано Вантажоодержувач – АТБ-маркет, Актом змінити на ЛЮ). https://wiki.edin.ua/uk/latest/ETTN_3_0/Create_Consignee_Change_Act_from.html#id1 

Акт перепломбування до е-ТТН 

Складається в разі заміни пломби на вантажі чи автомобілі. 

https://wiki.edin.ua/uk/latest/ETTN_3_0/Create_Resealing_Act_from.html#id1 

Акт коригування до е-ТТН 

Складається в разі необхідності виправити деякі реквізити е-ТТН. Ініціатором створення «Акту  коригування» може виступати: «Замовник», «Вантажовідправник», «Перевізник». https://wiki.edin.ua/uk/latest/ETTN_3_0/Create_Adjustment_Act_from.html#id1 

Акт примусового завершення до е-ТТН 

Складається учасником під роллю «Замовник» у разі неможливості завершення життєвого циклу «е ТТН». 

https://wiki.edin.ua/uk/latest/ETTN_3_0/Create_Stop_Act_from.html#id1 

Робота з 3PL оператором, який виступає Вантажовідправником

Перед початком роботи по даній схемі Постачальнику необхідно проінформувати офіційним листом  Категорійного менеджера Служби закупок про використання такої схеми. 

  1. Постачальник створює е-ТТН, «Замовник» – Постачальник, «Вантажовідправник» – 3PL оператор.  Постачальник заповнює е-ТТН та надсилає її без підписання – «Попередня ТТН». Для створення  попередньої е-ТТН достатньо заповнити «Замовник» (Постачальник) та «Вантажовідправник» (3PL оператор) 
  2. Вантажовідправник (3PL оператор) на підставі Попередньої ТТН створює е-ТТН (через додаткові  дії), заповнює, підписує під Вантажовідправником (Комірник 3PL оператора) та надсилає е-ТТН.
  3. Водій Перевізника підписує е-ТТН та надсилає її. 
  4. Е-ТТН відправлена Вантажоодержувачу. 

Снимок экрана 2026-06-05 в 10.43.13.png

6. Постачання по схемі Транзит ЛЮ 

При постачанні товару по схемі Транзит ЛЮ, Постачальник виконує доставку товару на Транзитний  РЦ, а логістичний оператор «Логістик Юніон» виконує переміщення товару Постачальника на кінцеві  РЦ. Постачальник заключає Договір з «Логістик Юніон» про надання таких послуг. 

Документообіг при схемі Транзит ЛЮ: 

- АТБ створює Замовлення (OREDRS), де вказує Місце доставки – Кінцевий РЦ (GLN); - Постачальник створює Повідомлення про відвантаження (DESADV), вказує Місце доставки – Транзитний РЦ (GLN), куди фактично доставить товар, Кінцевий одержувач – Кінцевий РЦ  (GLN), згідно з Замовленням;
- Постачальник створює е-ТТН, Вантажоодержувач – АТБ, Місце доставки – Транзитний РЦ  (GLN), куди Постачальник фактично доставить товар;
- Постачальник створює Видаткову накладну (COMDOC_006), де Покупець – АТБ, а Місце  доставки – Кінцевий РЦ (GLN), згідно з Замовленням. GLN «Місця доставки» та GLN «Точки  доставки» в Параметрах повинні співпадати;
- Після здачі товару на Транзитному РЦ, в системі АТБ створюється внутрішня е-ТТН на  переміщення товару з Транзитного на Кінцевий РЦ, де Замовником заначено  Постачальника, Вантажовідправник і Вантажоодержувач – Логістик Юніон. Внутрішня е-ТТН  доступна Постачальнику для перегляду на Платформі Провайдера.

Інструкція для постачальників по обміну Е-ТТН на постачання товару в ТОВ «АТБ-МАРКЕТ» з поставкою через ТОВ «Логістик Юніон»

1. Загальні положення по обміну документами  

1.1.Електронний документообіг впроваджується для операцій постачання товару. Документи для  повернення товару, постачання/повернення тари, супровідні документи (сертифікати якості товару)  продовжують оформлятися у паперовому вигляді.  

1.2.В електронний вигляд переводяться наступні документи: 
- ТТН та підпорядковані до неї акти;
- Видаткова накладна та Акт приймання до ВН; 
- Акти прийому-передачі товару (далі АПП8 та АПП9) та Акт приймання до АПП8. До моменту початку роботи Центральної Бази Даних (ЦБД) електронні ТТН необхідно дублювати  паперовою копією ТТН. 

1.3.Електронний підпис: при підписанні електронних документів необхідно використовувати  кваліфікований електронний підпис на захищеному носії (далі КЕП). Зверніть увагу, УЕП  (удосконалений електронний підпис) не підходить! Для представників Постачальника та  Вантажовідправника обов’язковим є посадовий КЕП юридичної особи, що містить посаду  співробітника (наприклад, «Комірник»), РНОКПП особи і ЄДРПОУ підприємства. Для Водія та  Експедитора допустимим є особистий КЕП фізичної особи, що обов’язково містить РНОКПП особи;  посада водія та експедитора в КЕП не є обов’язковою. Також КЕП має бути у всіх інших учасників  перевезення, в разі, якщо вони будуть підписувати е-ТТН (Проміжний склад, Перевізник тощо). 

1.4.Обов’язковий мінімум підписів (КЕП) в електронних документах: 

- Видаткова накладна: КЕП матеріально-відповідальної особи Постачальника;
- АПП8 та АПП9: КЕП матеріально-відповідальної особи Постачальника. Дані підписанта в КЕП  мають збігатися з даними матеріально-відповідальної особи, що зазначена в Документі: ПІБ  матеріально-відповідальної особи, РНОКПП, ЄДРПОУ, посада тощо;
- Е-ТТН: КЕП матеріально-відповідальної особи Вантажовідправника; КЕП Водія, що здійснює  доставку товару на РЦ, підписувати саме під роллю Водія, а не Перевізника;
- Акт розбіжностей до е-ТТН: КЕП Водія, що здійснює доставку товару на РЦ, підписувати саме  під роллю Водія, а не Перевізника.
- Підпис Директора, головного бухгалтера, бухгалтера, іншого спеціаліста,тощо є допустимим згідно чинного законодавства та Договору. 

1.5.Якщо Постачальник працює через Логістичного оператора (третю особу), що здійснює послуги  відповідального зберігання для Постачальника, в такому випадку в е-ТТН Замовником вказується  Постачальник, а Вантажовідправником – Логістичний оператор, що відвантажує товар. Е-ТТН  підписується представником Вантажовідправника (Логістичного оператора). 

1.6.При постачанні товару по схемі "відповідального зберігання" через Логістик-Юніон, або з  використанням інших логістичних операторів, постачальник повинен надати до Служби закупок  АТБ-маркет лист про використання такої схеми поставки. (Постачання по схемі «Відповідального  зберігання ЛЮ» описано в розділі 7)

1.7.Накладання печатки підприємства на Видаткову накладну та Акти 8-9 і пов’язані з цими  документами акти приймання - заборонено. В е-ТТН печатка підприємства допустима, але не є  обов’язковою і не може бути альтернативою посадового КЕП. Відповідно, з боку АТБ та ЛЮ печатка  підприємства накладатися не буде. 

2. Вимоги до оформлення електронних документів 

2.1. В Замовленні, яке Постачальник отримує від АТБ, в полі «Додаткова інформація» зазначено, за  яким документообігом очікується поставка. Якщо зазначено «Електронний-ДО» - до цього  Замовлення необхідно оформлювати електронний пакет документів.  

Зверніть увагу!! Якщо в Замовленні зазначено «Електронний-ДО», то Повідомлення про  відвантаження без пакету електронних документів на склад не передається. 

Приклад: 

Снимок экрана 2026-06-05 в 11.21.50.png

2.2 Документи «Повідомлення про відвантаження» та «Видаткова накладна» необхідно  оформлювати на адресу ТОВ «АТБ МАРКЕТ». Документи «е-ТТН» та «Акт приймання-передачі  (додаток 8)» необхідно оформлювати на Вантажоодержувача ТОВ «ЛОГІСТИК ЮНІОН». 

2.3. В єдиний пакет документів входять: «Повідомлення про відвантаження», «Видаткова  накладна», «Акт приймання-передачі (додаток 8)» та «е-ТТН» (крім випадків постачання зі складу  відповідального зберігання, що територіально знаходиться разом зі складом ЛЮ, в такому разі е ТТН не потрібна). Для об'єднання документів в єдиний ланцюжок (з однаковим номером  BRANCH_UUID), всі електронні документи мають бути створені на основі одного Повідомлення про  відвантаження та повинні мати однакову дату документа (наприклад, дата «Від_01.12.2025»  однакова для всіх документів ланцюжка). Номер BRANCH_UUID формується з таких тегів  Повідомлення про відвантаження: <NUMBER> (номер Повідомлення), <DATE> (дата Повідомлення),  <ORDERNUMBER> (номер Замовлення), <ORDERDATE> (дата Замовлення). 

- Якщо одне Замовлення виконується декількома поставками, то для кожної поставки створюється  окремий пакет документів, а номер кожного нового Повідомлення про відвантаження має бути  унікальним. Таким чином, до кожного унікального Повідомлення про відвантаження мають бути  оформлені окрема Видаткова накладна, АПП8 і е-ТТН, всі документи пакета з однаковою датою  документа. Номер BRANCH_UUID повинен бути унікальним для кожного пакету.

- Нова версія Повідомлення про відвантаження може бути створена за необхідності виправлення  помилки в Повідомленні. Для створення нової версії Повідомлення про відвантаження, всі теги, що  створюють BRANCH_UUID, повинні залишитись незмінними, змінюється тільки номер версії  Повідомлення: <VERSION>. 

- Нова версія Видаткової накладної і АПП8 можуть бути створені за необхідності виправлення  помилки в цих документах. В такому випадку нова версія документу створюється на основі  останньої версії Повідомлення про відвантаження, а BRANCH_UUID пакету залишається незмінним. 

- Нова версія е-ТТН створюється шляхом створення нової транзакції е-ТТН – через додавання нового  підпису КЕП. Створення нової версії е-ТТН шляхом клонування документу заборонено! В разі неможливості виправлення помилки шляхом створення нової транзакції е-ТТН (наприклад, е-ТТН  підписана підписом на незахищеному носії, що є критичною помилкою), необхідно створити  повністю новий пакет ЮЗД з новим номером BRANCH_UUID. Для цього створюється нове  Повідомлення про відвантаження з новим унікальним номером, на основі якого створюються всі  інші документи ланцюжка: Видаткова, АПП8 і е-ТТН (номера цих документів, крім Повідомлення,  можуть залишитись старими). 

2.4. Планова дата постачання повинна бути однаковою в Повідомленні про відвантаження та у  Видатковій накладній і не може буте раніше дати постачання, що зазначена в Замовленні. Номер  Видаткової накладної в Повідомленні про відвантаження та фактично у Видатковій накладній  повинен співпадати. 

2.5. Всі юридичні назви та юридичні адреси в документах мають бути заповнені згідно з даними  бази Мінюсту, включно з регістром, лапками, комами і т. ін. Наприклад: 

- юридична назва: ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ "ЛОГІСТИК ЮНІОН"  

- юридична адреса: Україна, 52005, Дніпропетровська обл., Дніпровський р-н, КОМПЛЕКС БУДІВЕЛЬ  ТА СПОРУД, будинок 8, офіс 229 

Зайва кома, або інший тип лапок, або інший регістр в електронних документах призводять до  помилки документа. Документи з помилками не обробляються, приймання товару блокується. 

2.6. Видаткова накладна: 

- Номер документу підстави (№ Договору постачання) – у форматі «Р40586»;
- Найменування товару – українською мовою, ідентично найменуванню в податковій накладній.  Допускається назва ТМ латиницею. Найменування товарів в усіх документах пакету мають  співпадати;
- Поле «Код УКТЗЕД» обов’язкове і повинно мати значення не менше 4 і не більше 10 символів;
- В блоці «Місце доставки» обов’язковим є поле «Область»;
- Значення «GLN» в Місце доставки та «Точка доставки» в Параметрах мають збігатися.
- Якщо постачальник неплатник ПДВ, постачальнику потрібно замість ІПН вносити константу:  "100000000000". 

2.7. Акт-8: 

- Номер і Дата документу підстави – вказати Договір Логістики, у форматі «ЛЮ-Д-115»;
- Дані Відповідальної особи, зазначеної в Документі, мають співпадати з даними підписанта в КЕП,  яким підписується Документ.
- Значення «GLN» в Місце доставки та «Точка доставки» в Параметрах мають збігатися.

2.8. Е-ТТН:
- В існуючій реалізації можливо використання тільки такого коду підтипу документа: urn:ua:e transport.gov.ua:ettn:01:generic:001 - generic (default);
- Обов’язковими є підписи Вантажовідправника та Водія;
- У відповідальної особи з посадовим підписом має бути зазначений код ЄДРПОУ та РНОКПП. Для  непосадового підпису фізичної особи – код РНОКПП. ПАСПОРТ – не вказувати;
- Всі підписанти документу мають бути вказані в блоці Вантажно-розвантажувальні операції. Вказані  дані підписантів в блоці Вантажно-розвантажувальні операції мають співпадати з даними в КЕП підписантів (посада, ЄДРПОУ, РНОКПП тощо);
- Поле «Місце складання» повинно містити вичерпну інформацію для ідентифікації місця складання,  точність до рівня коду населеного пункту згідно кодифікатору КАТОТТГ;
- Атрибут «Відомості про транспортний засіб» – обов’язкове заповнення всіх атрибутів: Довжина,  Ширина, Висота та Загальна маса з вантажем в КГ. 

Снимок экрана 2026-06-05 в 11.24.22.png

- Поле «Пункт розвантаження» повинно містити адресу локації (РЦ), на яку здійснюється доставка, згідно з Довідником локацій Провайдера; 

- «Супровідні документи на вантаж», обов’язкові значення: «Повідомлення про відвантаження» та  «Замовлення», на підставі якого виконується поставка: 

Снимок экрана 2026-06-05 в 11.24.41.png

Таблиця 2.1. Допустимі типи супровідних документів на вантаж в е-ТТН:

Код 

Назва 

Опис

220 

Замовлення 

Обов’язкове значення - Документ/повідомлення, за  допомогою якого покупець ініціює трансакцію з  продавцем

351 

Повідомлення про  

відвантаження

Обов’язкове значення - Повідомлення про  відвантаження (DESADV)

916 

Коригуючій акт 

Використовується при формуванні актів, для вказання  попередньої транзакції поточного акту

723 

Спеціальна охорона вантажу 

Документ, що підтверджує надання спеціальних  охоронних послуг

290 

Право на пред'явлення претензії 

Запис про передачу права на пред’явлення претензії

441 

Маршрутний лист 

Документ, що визначає маршрути перевезень між  пунктами

335 

Заявка на транспортування 

Заявка на транспортування

770 

Підтвердження заявки на  

транспортування

Підтвердження заявки на транспортування

- В блоці «Загальні дані» – обов’язкове заповнення кожного атрибуту. Зверніть увагу, атрибут «У  тому числі ПДВ, грн» ("vatAmount") – обов’язкове заповнення: 

Снимок экрана 2026-06-05 в 11.26.02.png

- В блоці «Відомості про вантаж»: 

а) Найменування – обов’язкове заповнення українською мовою;
б) Артикул покупця – Код АП, обов’язкове заповнення;
в) Одиниця виміру – відноситься до кількості місць транспортної упаковки (в піддонах, або ящиках),  обов’язкове значення – «Штука»;
г) Кількість місць – транспортної упаковки (кількість піддонів, або ящиків) обов’язкове заповнення;
д) Кількість одиниць – в одиницях Замовлення (в штуках, кг, або пачках), обов’язкове заповнення;
е) Одиниця виміру к-сті одиниць, допустимі значення: ["ПАЧ", "ПАЧ.", "ПАЧКА", "BH" (латиницею),  "ШТУКА", "ШТ", "ШТ.", "PCE" (латиницею), "КІЛОГРАМ", "КГ", "КГ.", "KGM" (латиницею)] – обов’язкове заповнення. Значення BASE_UOM повинно співпадати зі значенням "Одиниці виміру" у  Видатковій та АПП8. Наприклад, якщо у Видатковій і АПП8 вказано "шт", то і в е-ТТН має бути "шт";
є) Вид пакування – обов’язкове заповнення;
ж) Ціна без ПДВ за одиницю – обов’язкове заповнення;
з) Загальна сума з ПДВ – обов’язкове заповнення;
и) Загальна сума без ПДВ – обов’язкове заповнення;
і) Маса брутто, кг – обов’язкове заповнення; 

! Якщо доставка здійснюється в одиницях Замовлення, в такому випадку «Кількість місць» =  «Кількість одиниць», а «Одиниця виміру» = «Одиниця виміру к-сті одиниць», допустимі значення:  ["ПАЧ", "ПАЧ.", "ПАЧКА", "BH" (латиницею), "ШТУКА", "ШТ", "ШТ.", "PCE" (латиницею), "КІЛОГРАМ",  "КГ", "КГ.", "KGM" (латиницею)].

Снимок экрана 2026-06-05 в 11.28.38.png

- В блоці «Вантажно-розвантажувальні операції»: 

а) Поле «Навантаження, маса брутто» – обов’язкове заповнення;
б) Дата і Час прибуття – це час, коли авто прибуло під навантаження на склад Постачальника – обов’язкове заповнення;
в) Дата і Час вибуття – це час, коли авто вибуло після навантаження зі складу Постачальника – обов’язкове заповнення;
г) Час простою – обов’язкове заповнення в форматі time «HH:MM» (наприклад, 00:30);
д) Поле «Здав, відповідальна особа Вантажовідправника» – обов’язкове заповнення;
е) Поле «Прийняв (відповідальна особа перевізника) дані водія – обов’язкове заповнення»;
є) Якщо е-ТТН підписує Експедитор, поле «Прийняв експедитор» – обов’язкове заповнення. 

Снимок экрана 2026-06-05 в 11.29.32.png

2.9. Надіслані документи одразу проходять первинну валідацію на боці АТБ на повноту та  коректність заповнення обов’язкових атрибутів.  

Якщо документи не пройшли первинну валідацію, на Порталі провайдера про це буде повідомлено.  Також вказується причина скасування документу.

Приклад помилки валідації для Видаткової накладної та АПП-8 на ВЕБ-платформі EDIN:

Снимок экрана 2026-06-05 в 11.30.08.png

Снимок экрана 2026-06-05 в 11.31.25.png

Приклад помилки валідації для е-ТТН на ВЕБ-платформі EDIN: 

Снимок экрана 2026-06-05 в 11.31.45.png

Снимок экрана 2026-06-05 в 11.31.56.png

Зверніть увагу, якщо на Порталі провайдера відсутній статус по надісланим документам (немає  жодного значку в правому верхньому кутку), це означає, що документи не пройшли перевірку в  системі АТБ. Можливі причини: не вистачає якогось з документів пакету; документи не поєднались  в єдиний ланцюжок; вказано отримувачем не АТБ чи ЛЮ; документ не отримано системою АТБ. 

Приклад документу Видаткова накладна без статусу результатів перевірки в системі АТБ:

Снимок экрана 2026-06-05 в 11.32.17.png

2.10. Специфікації електронних документів: 

https://wiki.edin.ua/uk/latest/ClientProcesses/ATB/ATB_XML-structure.html?highlight#xml https://wiki.edin.ua/uk/latest/Docs_ETTNv3/Docs_ETTNv3_list.html#ettn-v3 

2.11. Після успішного проходження первинної валідації, за умови, що всі документи Пакету  отримано, документи передаються на проходження вторинних логічних перевірок, які  розпочинаються після 20:00 за день до дати постачання по Замовленню. Після 20:00 вторинні  перевірки документів відбуваються кожні 10-15 хвилин. При виявленні вторинних помилок на  Портал Провайдера відправляється статус про результати перевірки з кодом помилки (див.  Таблицю 2.2. Перелік кодів помилок). Якщо буде виявлено помилку на рівні шапки, в повідомленні  буде вказано тільки код помилки, а якщо на рівні деталей, то буде вказано код помилки і код товару,  в якому виявлено помилку, наприклад: 4_107168, де «4» – код помилки ціни, а «107168» – код  товару (код АП), по якому не співпадає ціна. 

Таблиця 2.2. Перелік кодів помилок

Код 

Опис помилки 

Дії Постачальника

Помилка кількості товару 

Перевірити відповідність кількості в Повідомленні  про відвантаженні (DESADV) та ЮЗД + е-ТТН. Кількість  у DESADV може бути автоматично змінено системою  АТБ, в разі перевищення кількості із ORDERS.  Привести у відповідність кількість між ORDERS,  DESADV та ЮЗД, шляхом створення нових версій  документів.  

У випадку помилки в е-ТТН – створити повністю  новий пакет документів

Товар відсутній в повідомленні про  відвантаження (DESADV)

Перевірити коректність кодів АП товарів, створити нові версії ЮЗД з коректним товаром. У випадку  помилки в е-ТТН – створити повністю новий пакет  документів

Невідповідність закупівельної ціни  без ПДВ товару (товарів) між  

документами та системою АТБ

Якщо помилка на боці Постачальника – створити нові  версії ЮЗД з коректними цінами. У випадку помилки  в е-ТТН – створити повністю новий пакет документів.  

Якщо помилка на боці АТБ – звернутися до  Категорійного менеджера Служби закупок

Дата поставки в DESADV та ВН не  відповідає даті поставки Замовлення

Перевірити відповідність дати постачання  Замовлення даті постачання в DESADV і у ВН.  Створити нові версії документів з коректною датою  поставки

Невідповідність ставки ПДВ товару  (товарів) між документами та  

системою АТБ

Якщо помилка на боці Постачальника – сформувати  новий пакет з коректними ПДВ. Якщо помилка на  боці АТБ – звернутися до Категорійного менеджера  Служби закупок

Помилка суми без ПДВ 

Створити нові версії документів з коректною сумою  без ПДВ

Помилка суми ПДВ 

Створити нові версії документів з коректною сумою  ПДВ

Помилка суми з ПДВ 

Створити нові версії документів з коректною сумою з  ПДВ

11 

Юридична назва Постачальника/  Вантажовідправника/ Замовника не  відповідає інформації з ЄДР

Створити нові версії документів з повною юридичною назвою з урахуванням регістру, наприклад:  АКЦІОНЕРНЕ ТОВАРИСТВО "РУДЬ".  

Якщо назва внесена вірно, але помилка не зникає,  звернутися до Менеджера Служби закупок і з’ясувати коректність внесення назви в систему АТБ

13 

Юридична назва  

Покупця/Вантажоодержувача не  відповідає інформації з ЄДР

Створити нові версії документів з повною юридичною назвою з урахуванням регістру, наприклад: ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ  "ЛОГІСТИК ЮНІОН"

14 

Не коректний ЄДРПОУ  

Постачальника/Вантажовідправника/  Замовника

Створити нові версії документів з коректним ЄДРПОУ. Якщо ЄДРПОУ вказано вірно, але помилка не зникає,  звернутися до Менеджера Служби закупок і з’ясувати коректність внесення ЄДРПОУ в систему АТБ

16 

Не коректний ЄДРПОУ  

Покупця/Вантажоодержувача

Створити нові версії документів з коректним ЄДРПОУ

17 

Помилка юридичної адреси  

Покупця/Вантажоодержувача

Створити нові версії документів з коректною  юридичною адресою. Для е-ТТН можливо  використовувати Акт про зміну пункту призначення.  Довідник актуальних юридичних адрес знаходиться у  Провайдера

18 

В DESADV вказана схема постачання  з Відповідального зберігання ЛЮ,  для якої не передбачено створення  е-ТТН

Перевірити схему постачання. Якщо дійсно схема  Відповідального зберігання ЛЮ, то необхідно  анулювати зайвий документ е-ТТН. Якщо постачання  без Відповідального зберігання ЛЮ, необхідно  створити повністю новий пакет документів з новим DESADV, в якому заповнити тег:  

<RECIPTYPE>0</RECIPTYPE>, що вказує на постачання напряму на РЦ/склад

19 

Помилка дати документа. Дата  документу повинна співпадати для  кожного документу пакету.

Створити нові версії документів з коректною датою  Документу та з однаковою «Датою Від…» для  кожного документу пакету. У випадку помилки в е ТТН – створити повністю новий пакет документів.  Допускається дата ВН більше дати е-ТТН та АПП8 на  один день. Дата «Документ №… Від…» повинна бути  не менше 5 і не більше 5 днів від дати постачання по  Замовленню, та повинна співпадати для кожного  документу пакету.

20 

Товар присутній в DESADV, але  відсутній в ЮЗД + е-ТТН

Створити нові версії ЮЗД з коректними товарами. У  випадку помилки в е-ТТН – створити повністю новий  пакет документів

21 

Помилка адреси Місця поставки: або  помилка в адресі, або взагалі  

вказано не коректну локацію, на яку  не очікується доставка

Створити нові версії документів з коректною адресою Місця доставки. Для е-ТТН можливо використовувати  Акт про зміну пункту призначення. Довідник  актуальних адрес локацій знаходиться у Провайдера

22 

Помилка дати Договору 

Створити нові версії документів з коректною датою  Договору

23 

Документ не відповідає Договору  постачання

Даний електронний документ не очікується в процесі  постачання. Наприклад, отримано документ АПП8  для поставки без Договору ЛЮ. Перевірте Договірні  умови, в разі помилки на боці АТБ – зверніться до  Категорійного менеджера Служби закупок

25 

Не допускається в одному документі товари з різними ставками ПДВ

Створити новий пакет Документів з ідентичною  ставкою ПДВ товарів

26 

Помилка номеру Договору 

Створити нові версії документів з коректним  номером Договору: для ВН – Договір постачання, для  АПП8 – Договір Логістики

27 

В документі вказано не вірний код  КАТОТТГ Місця розвантаження

Створити нові версії документів з коректним КАТОТТГ  Місця доставки. Довідник актуальних адрес локацій  знаходиться у Провайдера

28 

Одиниця виміру товарів між  

документами комплекту не  

збігається

Створити нові версії документів. В залежності від  комплекту документів по Договору, одиниці виміру  для товарів у ВН та е-ТТН або у ВН, АПП8 та е-ТТН  повинні збігатися

29 

Маса брутто в шапці документу не  відповідає сумі ваги детальної  частини

Створити нову версію е-ТТН з відповідністю Маси  брутто в шапці, в блоці Вантажно-розвантажувальні  операції та в деталях документу

30 

Кількість місць в шапці документу е ТТН не відповідає сумі кількості  місць детальної частини

Створити нову версію е-ТТН з відповідністю Кількості  місць в шапці та в деталях документу

31 

Не коректне Повне найменування  Пункту розвантаження в е-ТТН

або помилка в найменуванні, або вказано не  коректну локацію доставки. Створити нову версію е ТТН з коректним найменування Місця постачання.  Можливо використовувати Акт про зміну пункту  призначення. Довідник актуальних адрес локацій  знаходиться у Провайдера

33 

ІПН Постачальника Документу не  відповідає ІПН в Договорі

Створити нові версії документів з коректним ІПН. У випадку помилки в е-ТТН – створити повністю новий  пакет документів. Якщо ІПН внесений вірно, але  помилка не зникає, звернутися до Менеджера  Служби закупок і з’ясувати коректність внесення ІПН в систему АТБ

34 

Не коректний ІПН Покупця/  

Виконавця

Створити нові версії документів з коректним ІПН  Покупця/ Виконавця. У випадку помилки в е-ТТН – створити повністю новий пакет документів. Для ВН – ІПН АТБ-Маркет, для АПП8 та е-ТТН – ІПН Логістик  Юніон

В разі отримання відповіді про Помилку закупівельної ціни (код помилки – 4), Постачальнику  необхідно звернутися до категорійного менеджера Служби закупок і надати інформацію про не  коректну ціну: Номер Замовлення, Код АП товару, Дата постачання, Актуальна ціна. Менеджер  Служби закупок приймає рішення про редагування ціни в Замовленні. 

Відповідь надається по кожному документу окремо. Тому Видаткова та е-ТТН можуть бути без  помилок, а Акт-8 з помилкою (наприклад, не коректний номер або дата Договору). В такому випадку  Повідомлення про відвантаження не передається в систему складу для приймання товару до  моменту виправлення помилки. 

Також статус перевірки може змінитись в обидва боки. Наприклад, спочатку е-ТТН була успішно  перевірена, але потім додався підпис Експедитора на незахищеному носії, відповідно е-ТТН  отримає статус Відмова в підписанні. 

Тільки після успішного проходження перевірок всіх документів, що входять в пакет ЮЗД, а також  при наявності всіх документів в пакеті і при наявності всіх підписів в документах зі сторони  Постачальника та Водія, в систему складу передається Повідомлення про відвантаження. Але варто  зауважити, що навіть після успішного проходження перевірок та після передачі Повідомлення про  відвантаження в систему складу, в разі, якщо в е-ТТН будуть внесені зміни, які не пройдуть  перевірку, приймання товару буде заблоковано (наприклад, Перевізник при підписанні е-ТТН  видалив дані Водія, або підписав документ невалідним підписом). 

Якщо документи успішно пройшли первинну та вторинну перевірки в системі АТБ, на порталі  Провайдера для такого документу з’явиться відповідний статус (значок зеленого кольору в правому  верхньому кутку). 

Приклад документів, що пройшли успішну перевірку в системі АТБ: 

Снимок экрана 2026-06-05 в 11.34.48.png

3. Приймання товару на РЦ без розбіжностей 

3.1.Склад здійснює приймання. Якщо кількість поставленого товару відповідає кількості DESADV,  приймальник ТОВ «Логістик Юніон» підписує е-ТТН за допомогою КЕП. 

3.2.Після приймання товару в обліковій системі складу, приймальник ТОВ «Логістик Юніон» підписує за  допомогою КЕП АПП№8. Документ отримує статус «Підтверджено з двох сторін». Також ТОВ  «Логістик Юніон» оформлює та підписує за допомогою КЕП АПП№9 від ТОВ «Логістик Юніон» до  Постачальника, в якому зазначається фактично прийнята кількість товару. АПП№8 та АПП№9  підписуються разом.

3.3.Після приймання товару, якщо кількість поставленого товару відповідає кількості DESADV, і фактична  дата приймання товару відповідає даті постачання із Замовлення, співробітник складу «АТБ МАРКЕТ» підписує Видаткову накладну Постачальника. Документ отримує статус «Підтверджено з  двох сторін». 

3.4.Постачальник, отримавши АПП№9, підписує його за допомогою КЕП, після чого оформлений  документ публікується EDI-провайдером для ТОВ «Логістик Юніон». Документ отримує статус  «Підтверджено з двох сторін». 

Схема обміну документами без розбіжностей: 

Снимок экрана 2026-06-05 в 11.36.10.png

4. Приймання товару на РЦ з розбіжностями 

4.1.Якщо кількість прийнятого товару не відповідає кількості DESADV, приймальник створює Акт  розбіжностей до е-ТТН, в якому вказує кількість розбіжності (для штучного товару – в штуках, для  вагового товару – в кілограмах) і причину розбіжностей (для кожної позиції), ставить свою КЕП, після  чого Акт відправляється на підписання Водієві, шляхом публікації документа EDI-провайдером для  Перевізника. Водій підписує за допомогою КЕП Акт розбіжностей до е-ТТН, в разі згоди з ним, або  ставить відмову від підпису, в разі незгоди з Актом. У будь-якому випадку, приймальник ТОВ  «Логістик Юніон» підписує е-ТТН тільки якщо з Водієм узгоджені всі спірні питання, за допомогою  оформлення Акту. 

4.2.На стороні ТОВ «Логістик Юніон» оформлюється Акт приймання до АПП№8, в якому вказується  відвантажена і фактично прийнята кількість, також оформлюється АПП№9 на фактично прийняту  кількість. Приймальник «Логістик Юніон» підписує за допомогою КЕП обидва документи, після чого  документи відправляються на підпис Постачальнику шляхом публікації їх EDI-провайдером. Також  Акт приймання до АПП№8 створюється в разі, якщо фактична дата приймання товару не відповідає  даті постачання із Замовлення. 

4.3.Представник Постачальника, отримавши Акт прийому до АПП№8 та АПП№9, підписує їх за  допомогою КЕП, після чого оформлені документи публікуються EDI-провайдером для ТОВ «Логістик  Юніон». 

4.4.Після отримання відповіді про підписання Постачальником Акту прийому до АПП№8, на стороні ТОВ  «Логістик Юніон» підписується АПП№8. При наявності Акту приймання до АПП№8 та до моменту  його підписання двома сторонами, батьківський документ АПП№8 заблоковано для підписання. 

4.5.Якщо кількість прийнятого товару не відповідає кількості DESADV і / або фактична дата приймання  товару не відповідає даті постачання із Замовлення, на стороні ТОВ «АТБ-МАРКЕТ» оформлюється  Акт приймання до Видаткової накладної, в якому вказується відвантажена, фактично прийнята  кількість товару і фактична дата приймання. Співробітник складу «АТБ-МАРКЕТ» ставить КЕП, після  чого документ відправляється на підпис Постачальнику шляхом публікації документа EDI провайдером. 

4.6.Представник Постачальника, отримавши Акт прийому до Видаткової накладної, підписує його за  допомогою КЕП, після чого оформлений документ публікується EDI-провайдером для ТОВ «АТБ МАРКЕТ». 

4.7.Після отримання відповіді про підписання Постачальником Акту приймання до Видаткової  накладної, співробітник складу «АТБ-МАРКЕТ» підписує Видаткову накладну. 

4.8.У разі, якщо обидві сторони дійшли висновку, що електронний документ, створений АТБ, некоректний, анулювання такого документа проводиться шляхом формування нового документа  Анулювання (COMDOC_019), який створюється та підписується на боці АТБ і відправляється на  підпис Постачальнику. Документ анулювання може бути створений до вихідних документів АТБ:  АПП№9, Акту приймання до АПП№8 та Акту приймання до Видаткової накладної. В разі створення  документу Анулювання, АТБ також створить та відправить нову версію вихідного документу замість  анульованого. 

4.9.У разі, якщо Акт розбіжностей до е-ТТН після підписання Водієм не пройде перевірки: (наприклад,  підписано не КЕП; не заповнені дані Водія; підписано підписом в якому не співпадають дані Водія з  даними Водія, зазначеними в документі; підписано не водієм) – документ не пройде перевірки, а е-ТТН буде заблокована для підписання. В такому випадку необхідно оформити повністю новий  комплект документів, або перевести поставку на паперові копії. 

4.10. Документи АПП№9, Акт приймання до АПП№8, Акт приймання до Видаткової накладної проходять перевірку після підписання Постачальником. Якщо буде виявлено помилку підпису (наприклад, підпис не КЕП), дані документи будуть оформлені з новою версію на боці АТБ та  надіслані на підписання Постачальнику повторно. 

4.11. У випадку незгоди з документами АПП№9, Акт приймання до АПП№8, Акт приймання до  Видаткової накладної по причині розбіжності суми – Постачальнику необхідно відмовитись від  підписання документів та повідомити співробітників складу про некоректні суми. 

Схема обміну документами з розбіжностями:

Снимок экрана 2026-06-05 в 11.36.50.png

Зверніть увагу! 

  1. В разі, якщо поставка не прийнята в повному об’ємі, АТБ/ЛЮ не оформлює жодних  електронних документів. Подальша переадресація з оформленням Акту зміни пункту  призначення або іншим чином – на боці Постачальника. 
  2. Е-ТТН для не прийнятого товару по причині бій/брак, або з інших причин, на боці АТБ/ЛЮ не  оформлюється. Подальші дії вирішуються між Постачальником та Перевізником без  залучення АТБ/ЛЮ. 
  3. Звертайте увагу на необхідність своєчасного підписання документів, з огляду на Договірні  умови. 
5. Використання Актів до е-ТТН в ЕДО з АТБ 

Акти розвантаження та завантаження на проміжному складі 

Використовуються у разі повного перевантаження вантажу (без розподілу на кілька актів) в процесі  перевезення на Проміжний склад з подальшим перевантаженням на інший автомобіль. Головною  умовою використання цього акту в роботі з АТБ є наявність підпису нового водія під роллю Водія в  е-ТТН. При його відсутності документ не пройде перевірку. В існуючій реалізації, після отримання  Акту розвантаження на проміжному складі система АТБ відправить статус помилки по е-ТТН, але  після отримання Акту завантаження на проміжному складі та за умови наявності інформації про  нового Водія та підпису нового Водія – е-ТТН пройде перевірку. 

https://wiki.edin.ua/uk/latest/ETTN_3_0/Create_StorageDelivery_Act_from.html#id1 https://wiki.edin.ua/uk/latest/ETTN_3_0/Create_StoragePickUp_Act_from.html#id1 

Акт перевантаження до е-ТТН 

Складається у випадку заміни транспортного засобу та/або водія в процесі перевезення, без заміни  е-ТТН. Головною умовою використання цього акту в роботі з АТБ є наявність інформації про нового  Водія та підпису нового водія під роллю Водія в е-ТТН. При його відсутності документ не пройде  перевірку. 

https://wiki.edin.ua/uk/latest/ETTN_3_0/Create_Reload_Act_from.html#id1 

Акт про заміну пункту призначення до е-ТТН 

Складається у випадку необхідності змінити Пункт розвантаження та/або Вантажоодержувача (Наприклад, в е-ТТН помилково вказано Вантажоодержувач – АТБ-маркет, Актом змінити на ЛЮ).

https://wiki.edin.ua/uk/latest/ETTN_3_0/Create_Consignee_Change_Act_from.html#id1 

Акт перепломбування до е-ТТН 

Складається в разі заміни пломби на вантажі чи автомобілі. 

https://wiki.edin.ua/uk/latest/ETTN_3_0/Create_Resealing_Act_from.html#id1 

Акт коригування до е-ТТН 

Складається в разі необхідності виправити деякі реквізити е-ТТН. Ініціатором створення «Акту  коригування» може виступати: «Замовник», «Вантажовідправник», «Перевізник». https://wiki.edin.ua/uk/latest/ETTN_3_0/Create_Adjustment_Act_from.html#id1 

Акт примусового завершення до е-ТТН 

Складається учасником під роллю «Замовник» у разі неможливості завершення життєвого циклу «е ТТН». 

https://wiki.edin.ua/uk/latest/ETTN_3_0/Create_Stop_Act_from.html#id1 

Робота з 3PL оператором, який виступає Вантажовідправником 

Перед початком роботи по даній схемі Постачальнику необхідно проінформувати офіційним листом  Категорійного менеджера Служби закупок про використання такої схеми. 

1. Постачальник створює е-ТТН, «Замовник» – Постачальник, «Вантажовідправник» – 3PL оператор.  Постачальник заповнює е-ТТН та надсилає її без підписання – «Попередня ТТН». Для створення  попередньої е-ТТН достатньо заповнити «Замовник» (Постачальник) та «Вантажовідправник» (3PL оператор)
2. Вантажовідправник (3PL оператор) на підставі Попередньої ТТН створює е-ТТН (через додаткові  дії), заповнює, підписує під Вантажовідправником (Комірник 3PL оператора) та надсилає е-ТТН.
3. Водій Перевізника підписує е-ТТН та надсилає її.
4. Е-ТТН відправлена Вантажоодержувачу.

Снимок экрана 2026-06-05 в 11.38.22.png

6. Постачання по схемі Транзит ЛЮ 

При постачанні товару по схемі Транзит ЛЮ, Постачальник виконує доставку товару на Транзитний  РЦ, а логістичний оператор «Логістик Юніон» виконує переміщення товару Постачальника на кінцеві  РЦ. Постачальник заключає Договір з «Логістик Юніон» про надання таких послуг. 

Документообіг при схемі Транзит ЛЮ: 

- АТБ створює Замовлення (OREDRS), де вказує Місце доставки – Кінцевий РЦ (GLN);
- Постачальник створює Повідомлення про відвантаження (DESADV), вказує: а) Місце  доставки – Транзитний РЦ (GLN), куди фактично доставить товар; б) Кінцевий одержувач – Кінцевий РЦ (GLN), згідно з Замовленням;
- Постачальник створює е-ТТН, Вантажоодержувач – ЛЮ, Місце доставки – Транзитний РЦ  (GLN), куди Постачальник фактично доставить товар;
- Постачальник створює Видаткову накладну (COMDOC_006), де Покупець – АТБ, а Місце  доставки – Кінцевий РЦ (GLN), згідно з Замовленням. GLN «Місця доставки» та GLN «Точки  доставки» в Параметрах повинні співпадати;
- Постачальник створює АПП№8 (COMDOC_032), якщо такий документ передбачено  Договором Логістики, Виконавець – ЛЮ, Місце доставки – Кінцевий РЦ (GLN), згідно з  Замовленням. GLN «Місця доставки» та GLN «Точки доставки» в Параметрах повинні  співпадати;
- Після здачі товару на Транзитному РЦ, в системі АТБ створюється внутрішня е-ТТН на  переміщення товару з Транзитного на Кінцевий РЦ, де Замовником заначено Постачальника, Вантажовідправник і Вантажоодержувач – Логістик Юніон. Внутрішня е-ТТН  доступна Постачальнику для перегляду на Платформі Провайдера. 

7. Постачання по схемі Відповідального зберігання ЛЮ. 

При постачанні товару по схемі Відповідального зберігання ЛЮ товар Постачальника територіально  знаходиться на складах «Логістик Юніон». В такому випадку, е-ТТН створювати не потрібно, оскільки  перевезення товару не здійснюється. В комплект документів входять: 

- Повідомлення про відвантаження;
- Видаткова накладна;
- АПП№8 (якщо передбачено Договором логістики). 

При створенні Повідомлення про відвантаження (DESADV) на Порталі Провайдера EDIN необхідно  вказати Тип поставки – «Поставка зі складів Логістик Юніон». В XML повідомленні DESADV необхідно  заповнити тег: <RECIPTYPE>1</RECIPTYPE>.

Снимок экрана 2026-06-05 в 11.40.19.png