XML Специфікації документів для роботи з мережею «МЕТРО»

В переліку специфікацій вказані лише модифіковані під клієнта документи. Специфікації стандартних документів на платформі EDI Network 2.0 можна знайти за посиланням.

Транспортна накладна (DOCUMENTINVOICE_TNN)

Опис полів:

Назва поля

Тип 1

Формат

Опис

Document-Invoice

   

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

Invoice-Header

М

 

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

InvoiceNumber

М

Рядок (35)

номер Транспортної накладної

InvoiceDate

М

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

дата Транспортної накладної

InvoiceCurrency

М

Рядок (3)

валюта

DocumentFunctionCode

М

TNN

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

  • TNN - транспортна накладна

ContractNumber

О

Рядок (16)

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

ContractDate

O

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

дата контракту

Invoice-Header

   

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

Invoice-Reference

   

Підстава (початок блоку)

Order

О

 

Замовлення (початок блоку)

BuyerOrderNumber

О

Число (6-10)

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

BuyerOrderDate

О

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

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

Order

   

Замовлення (закінчення блоку)

TaxInvoice

О

 

Податкова накладна (початок блоку)

TaxInvoiceNumber

О

Рядок (35)

номер податкової накладної

TaxInvoiceDate

О

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

дата податкової накладної (повинна збігатися з датою товарною накладною)

TaxInvoice

   

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

DespatchAdvice

М

 

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

DespatchAdviceNumber

М

Рядок (16)

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

DespatchAdvice

   

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

ReceivingAdvice

О

 

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

ReceivingAdviceNumber

М

Рядок (16)

Номер повідомлення про прийом (RECADV). У разі коригування повернення, має бути вказаний номер акта на повернення

DeliveryDate

O

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

Дата приймання. В разі коригування повернення, має бути вказана дата акту на повернення

ReceivingAdvice

   

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

Invoice-Reference

   

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

Invoice-Parties

   

Блок контрагентів (початок)

Buyer

   

Блок покупця (початок)

ILN

М

Число (13)

GLN покупця

TaxID

М

Число (12)

Податковий ідентифікаційний номер покупця

UtilizationRegisterNumber

М

Число(8,10)

ЄДРПОУ покупця

Name

М

Рядок (175)

назва покупця

StreetAndNumber

М

Рядок (35)

вулиця і номер будинку покупця

CityName

М

Рядок (35)

місто покупця

PostalCode

М

Рядок (9)

поштовий код покупця

Country

O

Рядок (3)

код країни покупця (код ISO 3166)

PhoneNumber

М

Рядок (35)

телефон покупця

Buyer

   

Блок покупця (закінчення)

Seller

   

Блок продавця (початок)

ILN

М

Число (13)

GLN продавця

TaxID

М

Число (12)

Податковий ідентифікаційний номер продавця

CodeByBuyer

М

Рядок (35)

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

UtilizationRegisterNumber

М

Число(8,10)

ЄДРПОУ продавця

Name

М

Рядок (175)

назва продавця

StreetAndNumber

М

Рядок (140)

вулиця і номер будинку продавця

CityName

М

Рядок (35)

місто продавця

PostalCode

М

Рядок (9)

поштовий код продавця

Country

O

Рядок (3)

код країни продавця (код ISO 3166)

PhoneNumber

М

Рядок (35)

телефон продавця

IBAN

O

UA + NN + 351005 + XXXXXXXXXXXXXXXXXXX

UA — (2 літери) — код країни (ГОСТ ISO 3166-1);

NN — (2 цифри) — контрольне число;

351005 — (6 цифр) — МФО;

XXX…XXX — (19 цифр) — рахунок клієнта.

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

Seller

   

Блок продавця (закінчення)

DeliveryPoint

M

 

Точка доставки (початок)

ILN

М

Число (13)

GLN точки доставки (МЕТРО)

DeliveryPlace

O

Рядок (35)

код точки доставки (не повинен перевищувати два знаки)

DeliveryPoint

   

Точка доставки (закінчення)

Invoicee

   

Рахунок (початок блоку)

ILN

M

Число (13)

GLN для виставлення рахунку

Invoicee

   

Рахунок (закінчення блоку)

Payer

   

Платник Транспортної накладної (початок блоку)

ILN

M

Число (13)

GLN платника Транспортної накладної

Payer

   

Платник Транспортної накладної (закінчення блоку)

Invoice-Parties

   

Блок контрагентів (закінчення)

Invoice-Lines

   

Рядки Транспортної накладної (початок блоку)

Line

   

Рядок (початок блоку)

Line-Item

   

Позиція (початок блоку)

LineNumber

М

Ціле число

номер позиції в табличній частині

EAN

М

Число (14)

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

BuyerItemCode

O

Рядок (16)

Артикул в БД покупця (МЕТРО)

ProductIdBuyer

M

Рядок (16)

Артикул в БД MGB

ItemDescription

М

Рядок (210)

Опис товару

UnitOfMeasure

М

Рядок (3)

Одиниці виміру. Доступні значення:

  • PCE - шт.

  • KGM - кг.

CountPiecesInBox

M

Ціле число;

Число десяткове (3 знаки після коми) при UnitOfMeasure=KGM

Кількість одиниць товару у коробці (для вагового товару — вага товару у коробці)

BoxesCount

M

Ціле число

Кількість коробів товару, що постачається

DeliveredQuantity

М

Ціле число;

Число десяткове (3 знаки після коми) при UnitOfMeasure=KGM

Кількість доставлених метро одиниць

Line-Item

   

Позиція (закінчення блоку)

Line

   

Рядок (закінчення блоку)

Invoice-Lines

   

Рядки Транспортної накладної (закінчення блоку)

Invoice-Summary

   

Підсумки (початок блоку)

TotalLines

M

Ціле число

Кількість рядків в документі

TotalQuantity

М

Число десяткове (3 знаки після коми)

Загальна кількість одиниць товару

Invoice-Summary

   

Підсумки (закінчення блоку)

Document-Invoice

   

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


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

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


XML приклад
<?xml version="1.0" encoding="UTF-8"?>
<Document-Invoice>
<Invoice-Header>
   <InvoiceNumber>1112</InvoiceNumber>
   <InvoiceDate>2024-03-12</InvoiceDate>
   <InvoiceCurrency>UAH</InvoiceCurrency>
   <DocumentFunctionCode>TNN</DocumentFunctionCode>
   <ContractNumber>from_TNN</ContractNumber>
   <ContractDate>2024-03-14</ContractDate>
</Invoice-Header>
<Invoice-Reference>
   <Order>
      <BuyerOrderNumber>1543_0001</BuyerOrderNumber>
      <BuyerOrderDate>2024-01-19</BuyerOrderDate>
   </Order>
   <DespatchAdvice>
      <DespatchAdviceNumber>1543_0001</DespatchAdviceNumber>
   </DespatchAdvice>
</Invoice-Reference>
<Invoice-Parties>
   <Buyer>
      <ILN>4820086630009</ILN>
      <TaxID>123444567012</TaxID>
      <UtilizationRegisterNumber>12345678</UtilizationRegisterNumber>
      <Name>ТОВ &quot;МЕТРО КЕШ ЕНД КЕРІ УКРАЇНА&quot;</Name>
      <StreetAndNumber>стрит</StreetAndNumber>
      <CityName>м. Херсон, Херсонський р-н</CityName>
      <PostalCode>02140</PostalCode>
      <PhoneNumber>380440020565</PhoneNumber>
   </Buyer>
   <Seller>
      <ILN>9864065732181</ILN>
      <TaxID>1234567890</TaxID>
      <CodeByBuyer>from_TNN</CodeByBuyer>
      <UtilizationRegisterNumber>12345678</UtilizationRegisterNumber>
      <Name>FelEx_1</Name>
      <StreetAndNumber>вул. Умніца, 3</StreetAndNumber>
      <CityName>м. Херсон, Херсонський р-н</CityName>
      <PostalCode>453278</PostalCode>
      <PhoneNumber>380930000000</PhoneNumber>
   </Seller>
   <DeliveryPoint>
      <ILN>9864065748694</ILN>
   </DeliveryPoint>
</Invoice-Parties>
<Invoice-Lines>
   <Line>
      <Line-Item>
      <LineNumber>1</LineNumber>
      <EAN>1231231002</EAN>
      <BuyerItemCode>4444</BuyerItemCode>
      <ProductIdBuyer>2323</ProductIdBuyer>
      <ItemDescription>Тестова позиція 003</ItemDescription>
      <UnitOfMeasure>PCE</UnitOfMeasure>
      <CountPiecesInBox>50</CountPiecesInBox>
      <DeliveredQuantity>1000</DeliveredQuantity>
      </Line-Item>
   </Line>
   <Line>
      <Line-Item>
      <LineNumber>2</LineNumber>
      <EAN>1110000000001</EAN>
      <BuyerItemCode>121212</BuyerItemCode>
      <ProductIdBuyer>56</ProductIdBuyer>
      <SupplierItemCode>1212</SupplierItemCode>
      <ExternalItemCode>8989</ExternalItemCode>
      <ItemDescription>Мандарин клементина 1</ItemDescription>
      <InvoiceQuantity>1212</InvoiceQuantity>
      <UnitOfMeasure>KGM</UnitOfMeasure>
      <CountPiecesInBox>56.555</CountPiecesInBox>
      <DeliveredQuantity>450.666</DeliveredQuantity>
      </Line-Item>
   </Line>
   <Line>
      <Line-Item>
      <LineNumber>3</LineNumber>
      <EAN>00012345678</EAN>
      <BuyerItemCode>2323</BuyerItemCode>
      <ProductIdBuyer>6562</ProductIdBuyer>
      <ItemDescription>Хлібчик</ItemDescription>
      <InvoiceQuantity>3434</InvoiceQuantity>
      <UnitOfMeasure>PCE</UnitOfMeasure>
      <CountPiecesInBox>15</CountPiecesInBox>
      <BoxesCount>2000.00</BoxesCount>
      <DeliveredQuantity>30000</DeliveredQuantity>
      </Line-Item>
   </Line>
   <Line>
      <Line-Item>
      <LineNumber>4</LineNumber>
      <EAN>1472583690147</EAN>
      <BuyerItemCode>212123</BuyerItemCode>
      <ProductIdBuyer>3333</ProductIdBuyer>
      <ItemDescription>drink</ItemDescription>
      <InvoiceQuantity>222</InvoiceQuantity>
      <UnitOfMeasure>PCE</UnitOfMeasure>
      <CountPiecesInBox>5</CountPiecesInBox>
      <DeliveredQuantity>30</DeliveredQuantity>
      </Line-Item>
   </Line>
   <Line>
      <Line-Item>
      <LineNumber>5</LineNumber>
      <EAN>11100033311117777</EAN>
      <BuyerItemCode>515151</BuyerItemCode>
      <ProductIdBuyer>52365</ProductIdBuyer>
      <SupplierItemCode>666161</SupplierItemCode>
      <ExternalItemCode>11111111</ExternalItemCode>
      <ItemDescription>Product test edi 4076</ItemDescription>
      <ItemType>CU</ItemType>
      <InvoiceQuantity>50</InvoiceQuantity>
      <UnitOfMeasure>PCE</UnitOfMeasure>
      <CountPiecesInBox>10</CountPiecesInBox>
      <DeliveredQuantity>100</DeliveredQuantity>
      </Line-Item>
   </Line>
</Invoice-Lines>
<Invoice-Summary>
   <TotalLines>5</TotalLines>
   <TotalQuantity>31580.666</TotalQuantity>
</Invoice-Summary>
</Document-Invoice>

Акт розбіжностей до транспортної накладної (DOCUMENTINVOICE_DTN)

Опис полів:

Назва поля

Тип 1

Формат

Опис

Document-Invoice

   

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

Invoice-Header

М

 

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

InvoiceNumber

М

Рядок (35)

номер Акта розбіжностей до транспортної накладної

InvoiceDate

М

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

дата Акта розбіжностей до транспортної накладної

InvoiceTime

O

Час (ГГ:ХХ)

Час документа

DocumentFunctionCode

М

DTN

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

  • DTN - Акт розбіжностей до транспортної накладної

ContractNumber

О

Рядок (70)

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

ContractDate

М

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

дата контракту

InternalWarehouseNumber

M

Число (6-10)

Внутрішній cкладський номер (Перші дві цифри номера замовлення замінюються на «77»)

Invoice-Header

   

Заголовна частина (закінчення блоку)

Invoice-Reference

O

 

Підстава (початок блоку)

Order

О

 

Замовлення (початок блоку)

BuyerOrderNumber

О

Число (6-10)

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

BuyerOrderDate

О

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

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

Order

   

Замовлення (закінчення блоку)

Invoice

O

 

Транспортна накладна (початок блоку)

OriginalInvoiceNumber

O

Рядок(35)

Номер транспортної накладної

OriginalInvoiceDate

O

yyyy-MM-dd

Дата транспортної накладної

Invoice

   

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

Invoice-Reference

   

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

Invoice-Parties

M

 

Блок контрагентів (початок)

Buyer

   

Блок покупця (початок)

ILN

М

Число (13)

GLN покупця

TaxID

М

Число (12)

Податковий ідентифікаційний номер покупця

UtilizationRegisterNumber

М

Число(8,10)

ЄДРПОУ покупця

Name

М

Рядок (175)

назва покупця

StreetAndNumber

М

Рядок (35)

вулиця і номер будинку покупця

CityName

М

Рядок (35)

місто покупця

PostalCode

М

Рядок (9)

поштовий код покупця

Country

O

Рядок (3)

код країни покупця (код ISO 3166)

PhoneNumber

М

Рядок (35)

телефон покупця

Buyer

   

Блок покупця (закінчення)

Seller

   

Блок продавця (початок)

ILN

М

Число (13)

GLN продавця

TaxID

М

Число (12)

Податковий ідентифікаційний номер продавця

CodeByBuyer

М

Рядок (35)

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

UtilizationRegisterNumber

М

Число(8,10)

ЄДРПОУ продавця

Name

М

Рядок (175)

назва продавця

StreetAndNumber

М

Рядок (140)

вулиця і номер будинку продавця

CityName

М

Рядок (35)

місто продавця

PostalCode

М

Рядок (9)

поштовий код продавця

Country

O

Рядок (3)

код країни продавця (код ISO 3166)

PhoneNumber

М

Рядок (35)

телефон продавця

IBAN

O

UA + NN + 351005 + XXXXXXXXXXXXXXXXXXX

UA — (2 літери) — код країни (ГОСТ ISO 3166-1);

NN — (2 цифри) — контрольне число;

351005 — (6 цифр) — МФО;

XXX…XXX — (19 цифр) — рахунок клієнта.

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

Seller

   

Блок продавця (закінчення)

DeliveryPoint M   Точка доставки (початок блоку)
ILN М Число (13) GLN точки доставки (МЕТРО)
DeliveryPlace М Рядок (35) код точки доставки (не повинен перевищувати два знаки)

Invoice-Parties

   

Блок контрагентів (закінчення)

Invoice-Lines

O

 

Таблична частина (початок блоку)

Line

O

 

Рядок (початок блоку)

Line-Item

M

 

Позиція (початок блоку)

LineNumber

М

Ціле число

номер рядка

EAN

O

Число [0-9] (14)

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

BuyerItemCode

O

Рядок (16)

Артикул в БД покупця (МЕТРО)

ProductIdBuyer

M

Рядок (16)

Артикул в БД MGB

LogisticItemCode

O

Рядок (16)

Артикул FM Logistic

ItemDescription

М

Рядок (210)

Опис товару

UnitOfMeasure

М

Рядок (3)

Одиниці виміру. Доступні значення:

  • PCE - шт.

  • KGM - кг.

InvoiceDeliveredQuantity

М

Ціле позитивне число; Число десяткове (3 знаки після коми) при UnitOfMeasure=KGM

Кількість доставлених Метро одиниць в транспортній накладній

AcceptedQuantity

М

Ціле позитивне число; Число десяткове (3 знаки після коми) при UnitOfMeasure=KGM

Кількість прийнятих Метро одиниць

ReturnedQuantity

М

Ціле число; Число десяткове (3 знаки після коми) при UnitOfMeasure=KGM

Кількість повернених Метро одиниць

ReasonRejection

   

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

ReasonCode

М

Число(2)

Код причини повернення:

  • 1 - Зіпсований;

  • 2 - Брак;

  • 3 - Бій;

  • 4 - Невідповідність ціни;

  • 5 - Відсутність в замовленні;

  • 6 - Недовіз;

  • 7 - Без документів;

  • 8 - Пересорт;

  • 9 - Невідповідність штрих-коду;

  • 10 - Відсутність в БД;

  • 11 - Нетоварний вигляд;

  • 12 - Бомбаж;

  • 13 - Розвакуумація;

  • 14 - Понад заказу;

  • 15 - Невідповідність назви;

  • 16 - Невідповідність грамовки;

  • 17 - Відсутність сертифікатів;

  • 18 - Відсутність терміну придатності;

  • 19 - Відсутність ветеринарного свідоцтва;

  • 20 - Відсутність акцизних марок;

  • 21 - Відсутність інформаціі для покупців;

  • 22 - Відсутність рекомендованої ціни на тютюнових виробах;

  • 23 - Відсутність дати виготовлення;

  • 24 - Відсутність кінцевого терміну реалізації;

  • 25 - Надлишки;

  • 26 - Малий термін;

  • 27 - Протерміновано;

  • 99 - Вільний текст

ReasonText

M

Рядок (75)

Вільний текст вказання причини відмови товару

ReasonRejection

   

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

Line-Item

   

Позиція (закінчення блоку)

Line

   

Рядок (закінчення блоку)

Invoice-Lines

   

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

Invoice-Summary

O

 

Підсумки (початок блоку)

TotalLines

M

Ціле позитивне число

Кількість рядків в документі

TotalAcceptedQuantity

М

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

Загальна кількість прийнятих одиниць товару

Invoice-Summary

   

Підсумки (закінчення блоку)

Document-Invoice

   

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


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

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


XML приклад

 

<Document-Invoice>
  <Invoice-Header>
    <InvoiceNumber>4463_DTN_1</InvoiceNumber>
    <InvoiceDate>2024-03-11</InvoiceDate>
    <InvoiceCurrency>UAH</InvoiceCurrency>
    <DocumentFunctionCode>DTN</DocumentFunctionCode>
    <ContractNumber>25699</ContractNumber>
    <ContractDate>2023-08-30</ContractDate>
    <InternalWarehouseNumber>77437777</InternalWarehouseNumber>
  </Invoice-Header>
  <Invoice-Reference>
    <Order>
      <BuyerOrderNumber>45437777</BuyerOrderNumber>
      <BuyerOrderDate>2023-08-03</BuyerOrderDate>
    </Order>
    <Invoice>
      <OriginalInvoiceNumber>34343443</OriginalInvoiceNumber>
      <OriginalInvoiceDate>2024-03-11</OriginalInvoiceDate>
    </Invoice>
  </Invoice-Reference>
  <Invoice-Parties>
    <Buyer>
      <ILN>4820086630009</ILN>
      <TaxID>123444567012</TaxID>
      <UtilizationRegisterNumber>12345678</UtilizationRegisterNumber>
      <Name>ТОВ &quot;МЕТРО КЕШ ЕНД КЕРІ УКРАЇНА&quot;</Name>
      <StreetAndNumber>стрит</StreetAndNumber>
      <CityName>м. Херсон, Херсонський р-н</CityName>
      <PostalCode>02140</PostalCode>
      <PhoneNumber>380440020565</PhoneNumber>
    </Buyer>
    <Seller>
      <ILN>9864065732181</ILN>
      <TaxID>1234567890</TaxID>
      <UtilizationRegisterNumber>12345678</UtilizationRegisterNumber>
      <Name>FelEx_1</Name>
      <StreetAndNumber>вул. Умніца, 3</StreetAndNumber>
      <CityName>м. Херсон, Херсонський р-н</CityName>
      <PostalCode>453278</PostalCode>
      <PhoneNumber>380930000000</PhoneNumber>
    </Seller>
    <DeliveryPoint>
      <ILN>4820086630009</ILN>
      <DeliveryPlace>15</DeliveryPlace>
    </DeliveryPoint>
  </Invoice-Parties>
  <Invoice-Lines>
    <Line>
      <Line-Item>
        <LineNumber>1</LineNumber>
        <EAN>8898988989800</EAN>
        <BuyerItemCode>336074</BuyerItemCode>
        <ProductIdBuyer>133873009999</ProductIdBuyer>
        <ItemDescription>СОСИСКА</ItemDescription>
        <UnitOfMeasure>KGM</UnitOfMeasure>
        <InvoiceDeliveredQuantity>5.123</InvoiceDeliveredQuantity>
        <AcceptedQuantity>10</AcceptedQuantity>
        <ReturnedQuantity>0</ReturnedQuantity>
        <ReasonRejection>
          <ReasonCode>10</ReasonCode>
          <ReasonText>Відсутність в БД</ReasonText>
        </ReasonRejection>
      </Line-Item>
    </Line>
  </Invoice-Lines>
  <Invoice-Summary>
    <TotalLines>1</TotalLines>
    <TotalAcceptedQuantity>10</TotalAcceptedQuantity>
  </Invoice-Summary>
</Document-Invoice>

 

Накладна на повернення (DOCUMENTINVOICE_NP)

Мережа «МЕТРО» відправляє документ Накладна на повернення своїм Постачальникам.

Опис полів:

№ з/п Параметр² Тип¹ Формат Опис
I Document-Invoice     Початок документа
1 Invoice-Header М   Заголовна частина
1.1 InvoiceNumber М Рядок (35) Номер документа
1.2 InvoiceDate М Дата (РРРР-ММ-ДД) Дата документа
1.3 InvoiceDateInWords O Рядок (175) Дата накладної словами
1.4 InvoiceCurrency М Рядок (3) Валюта
1.5 InvoicePostDate O Дата (РРРР-ММ-ДД) Дата відправки накладної
1.6 InvoicePostTime O Час (год: хв) Час відправки накладної
1.7 DocumentFunctionCode М NP Код типу документа:
NP - Накладна на повернення
1.8 ContractNumber О Рядок (70) Номер контракту
1.9 ContractDate М Дата (РРРР-ММ-ДД) Дата контракту
1.10 CashRegisterNumber О Рядок (35) Номер каси
1.11 InternalClientNumber О Рядок (35) Внутрішній номер клієнта
1.12 AdditionalNumber О Рядок (35) Додатковий номер
1.13 InvoicePaymentMeans О Рядок (35) Засіб оплати
2 Invoice-Reference     Підстава (початок блоку)
2.1 TaxInvoice М   Податкова накладна (початок блоку)
2.1.1 TaxInvoiceNumber М Рядок (35) номер податкової накладної
2.1.2 TaxInvoiceDate М Дата (РРРР-ММ-ДД) дата податкової накладної (повинна збігатися з датою товарною накладною)
2.2 DeliveryNote М   Повідомлення про доставку (початок блоку)
2.2.1 DeliveryNoteNumber М Рядок (35) Номер документа-підстави
2.2.2 DeliveryNoteDate М Дата (РРРР-ММ-ДД) Дата складання документа
3 Invoice-Parties     Блок контрагентів (початок)
3.1 Buyer     Блок покупця (початок)
3.1.1 ILN М Число (13) GLN покупця
3.1.2 TaxID М Число (12) Податковий ідентифікаційний номер покупця
3.1.3 UtilizationRegisterNumber М Число(8,10) ЄДРПОУ покупця
3.1.4 Name М Рядок (175) назва покупця
3.1.5 StreetAndNumber М Рядок (35) вулиця і номер будинку покупця
3.1.6 CityName М Рядок (35) місто покупця
3.1.7 PostalCode М Рядок (9) поштовий код покупця
3.1.8 Country O Рядок (3) код країни покупця (код ISO 3166)
3.1.9 PhoneNumber М Рядок (35) телефон покупця
3.2 Seller     Блок продавця (початок)
3.2.1 ILN М Число (13) GLN продавця
3.2.2 TaxID М Число (12) Податковий ідентифікаційний номер продавця
3.2.3 CodeByBuyer М Рядок (35) номер договору на поставку
3.2.4 UtilizationRegisterNumber М Число(8,10) ЄДРПОУ продавця
3.2.5 Name М Рядок (175) назва продавця
3.2.6 StreetAndNumber М Рядок (140) вулиця і номер будинку продавця
3.2.7 CityName М Рядок (35) місто продавця
3.2.8 PostalCode М Рядок (9) поштовий код продавця
3.2.9 Country O Рядок (3) код країни продавця (код ISO 3166)
3.2.10 PhoneNumber М Рядок (35) телефон продавця
3.2.11 IBAN O UA + NN + 351005 + XXXXXXXXXXXXXXXXXXX
UA — (2 літери) — код країни (ГОСТ ISO 3166-1);
NN — (2 цифри) — контрольне число;
351005 — (6 цифр) — МФО;
XXX…XXX — (19 цифр) — рахунок клієнта.
IBAN (міжнародний номер банківського рахунку; використовується при міжнародних розрахунках)
3.3 SellerHeadquarters O   Блок головного офісу (початок)
3.3.1 ILN O Число (13) GLN головного офісу
3.3.2 LocationNumber O Рядок (175) Назва локації головного офісу
3.3.3 StreetAndNumber O Рядок (175) Вулиця і номер будинку
3.3.4 CityName O Рядок (35) Місто
3.3.5 PostalCode O Рядок (9) Поштовий код
3.3.6 PhoneNumber O Рядок (35) Телефон
3.4 DeliveryPoint M   Точка доставки (початок)
3.4.1 ILN М Число (13) GLN точки доставки (МЕТРО)
3.5 Invoicee     Рахунок (початок блоку)
3.5.1 ILN M Число (13) GLN для виставлення рахунку
3.6 Payer     Платник (початок блоку)
3.6.1 ILN M Число (13) GLN платника
4 Invoice-Lines O   Рядки (початок блоку)
4.1 Line O   Рядок (початок блоку)
4.1.1 Line-Item M   Позиція (початок блоку)
4.1.1.1 LineNumber М Ціле число номер позиції в табличній частині
4.1.1.2 EAN М Число (14) Штрих-код продукту
4.1.1.3 BuyerItemCode M Рядок (16) Артикул в БД покупця
4.1.1.4 SupplierItemCode M Рядок (16) Артикул постачальника
4.1.1.5 ExternalItemCode M Рядок (4-10) код товару згідно з довідника УКТ ЗЕД
4.1.1.6 ItemDescription М Рядок (210) Опис товару
4.1.1.7 InvoiceQuantity M Число позитивне Замовлена ​​кількість (кількість товару за накладною)
4.1.1.8 UnitOfMeasure О Рядок (3) Одиниці виміру
4.1.1.9 InvoiceUnitNetPrice M Число з плаваючою точкою (6 знаків до коми, 2 знака після коми) Ціна однієї одиниці без ПДВ
4.1.1.10 TaxRate M 20/19/16/14/7/2/0 Ставка ПДВ (20%, 19%, 16%, 14%, 7%, 2%, 0%)
4.1.1.11 TaxCategoryCode O S / E / Z Код категорії податку:
S - стандартний податок; можливі значення TaxRate: 20/19/16/14/7/2 (інакше помилка)

E - звільнений від сплати податку; можливі значення TaxRate=0 (інакше помилка)

Z - нульова ставка (0%); можливі значення TaxRate=0 (інакше помилка)
4.1.1.12 TaxAmount M Число з плаваючою точкою (6 знаків до коми, 2 знака після коми) Сума ПДВ по артикулу = сума сум без ПДВ по артикулах * ставку (округляється до 2 знаків)
4.1.1.13 NetAmount M Число з плаваючою точкою (6 знаків до коми, 2 знака після коми) Всього без ПДВ (обчислюється)
5 Invoice-Summary     Підсумки (початок блоку)
5.1 TotalLines M Ціле число Кількість рядків в документі
5.2 TotalNames M Ціле число Всього найменувань
5.3 TotalNetAmount M Число з плаваючою точкою (6 знаків до коми, 2 знака після коми) Загальна сума без ПДВ
5.4 TotalTaxAmount M Число з плаваючою точкою (6 знаків до коми, 2 знака після коми) Сума ПДВ
5.5 TotalGrossAmount M Число з плаваючою точкою (6 знаків до коми, 2 знака після коми) Загальна сума з ПДВ
5.6 TotalExciseDuty O Число з плаваючою точкою (6 знаків до коми, 2 знака після коми) Загальна сума акцизного податку
5.7 TotalCashAmount O Число з плаваючою точкою (6 знаків до коми, 2 знака після коми) Загальна сума готівки
5.8 TotalBankAmount O Число з плаваючою точкою (6 знаків до коми, 2 знака після коми) Загальна сума банку
5.9 TotalAmountInWords O Рядок (175) Загальна сума словами
5.10 Tax-Summary     Податки (початок блоку)
5.10.1 Tax-Summary-Line M   Рядок податків (початок блоку)
5.10.1.1 TaxRate M 20/19/16/14/7/2/0 Ставка ПДВ (20%, 19%, 16%, 14%, 7%, 2%, 0%)
5.10.1.2 TaxCategoryCode O S / E / Z Код категорії податку:
S - стандартний податок; можливі значення TaxRate: 20/19/16/14/7/2 (інакше помилка)

E - звільнений від сплати податку; можливі значення TaxRate=0 (інакше помилка)

Z - нульова ставка (0%); можливі значення TaxRate=0 (інакше помилка)
5.10.1.3 TaxAmount M Число з плаваючою точкою (6 знаків до коми, 2 знака після коми) Сума податку для кожної категорії податку
5.10.1.4 TaxableAmount M Число з плаваючою точкою (6 знаків до коми, 2 знака після коми) Оподаткована сума за обраною категорією податку
5.10.1.5 ExciseDuty O Число з плаваючою точкою (6 знаків до коми, 2 знака після коми) Акцизний податок

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

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

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

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

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

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


XML приклад
<Document-Invoice>
  <Invoice-Header>
    <InvoiceNumber>1233_ftp_3</InvoiceNumber>
    <InvoiceDate>2023-09-12</InvoiceDate>
    <InvoiceCurrency>UAH</InvoiceCurrency>
    <InvoicePostDate>2023-08-30</InvoicePostDate>
    <InvoicePostTime>14:49</InvoicePostTime>
    <DocumentFunctionCode>NP</DocumentFunctionCode>
    <ContractNumber>13117117</ContractNumber>
    <ContractDate>2023-08-30</ContractDate>
    <InvoiceDateInWords>30 серпня 2023 р.</InvoiceDateInWords>
    <CashRegisterNumber>39</CashRegisterNumber>
    <InternalClientNumber>13117117</InternalClientNumber>
    <AdditionalNumber>242002</AdditionalNumber>
    <InvoicePaymentMeans>Картка</InvoicePaymentMeans>
  </Invoice-Header>
  <Invoice-Reference>
    <TaxInvoice>
      <TaxInvoiceNumber>1639002</TaxInvoiceNumber>
      <TaxInvoiceDate>2023-08-30</TaxInvoiceDate>
    </TaxInvoice>
    <DeliveryNote>
      <DeliveryNoteNumber>1608089</DeliveryNoteNumber>
      <DeliveryNoteDate>2023-08-30</DeliveryNoteDate>
    </DeliveryNote>
  </Invoice-Reference>
  <Invoice-Parties>
    <Buyer>
      <ILN>4820086630009</ILN>
      <TaxID>12345670</TaxID>
      <UtilizationRegisterNumber>12345670</UtilizationRegisterNumber>
      <Name>ТОВ &quot;МЕТРО КЕШ ЕНД КЕРІ УКРАЇНА&quot;</Name>
    </Buyer>
    <Seller>
      <ILN>9864065732181</ILN>
      <TaxID>1010101016</TaxID>
      <UtilizationRegisterNumber>34554363</UtilizationRegisterNumber>
      <Name>FelEx_1</Name>
      <IBAN>UA903052992990004149123456789</IBAN>
    </Seller>
    <DeliveryPoint>
      <ILN>9991027227536</ILN>
      <DeliveryPlace>13117117</DeliveryPlace>
    </DeliveryPoint>
    <Invoicee>
      <ILN>9991027227536</ILN>
    </Invoicee>
    <Payer>
      <ILN>9991027227536</ILN>
    </Payer>
    <SellerHeadquarters>
      <ILN>4820086639941</ILN>
      <StreetAndNumber>ПРОСПЕКТ СТЕПАНА БАНДЕРИ, 26-В (літера Б)</StreetAndNumber>
      <CityName>КИЇВ</CityName>
      <PostalCode>04073</PostalCode>
      <PhoneNumber>0800501401</PhoneNumber>
    </SellerHeadquarters>
  </Invoice-Parties>
  <Invoice-Lines>
    <Line>
      <Line-Item>
        <LineNumber>1</LineNumber>
        <EAN>23141060</EAN>
        <BuyerItemCode>314106</BuyerItemCode>
        <SupplierItemCode>314106</SupplierItemCode>
        <ExternalItemCode>2106909200</ExternalItemCode>
        <ItemDescription>314106 : ОРБІТ БІЛОСНІЖНИЙ 14Г .</ItemDescription>
        <InvoiceQuantity>-1.000</InvoiceQuantity>
        <UnitOfMeasure>PCE</UnitOfMeasure>
        <InvoiceUnitNetPrice>11.33</InvoiceUnitNetPrice>
        <TaxRate>20.00</TaxRate>
        <TaxCategoryCode>S</TaxCategoryCode>
        <TaxAmount>-2.27</TaxAmount>
        <NetAmount>-11.33</NetAmount>
      </Line-Item>
    </Line>
  </Invoice-Lines>
  <Invoice-Summary>
    <TotalLines>1</TotalLines>
    <TotalNetAmount>-30.58</TotalNetAmount>
    <TotalTaxAmount>-6.12</TotalTaxAmount>
    <TotalGrossAmount>-36.70</TotalGrossAmount>
    <Tax-Summary>
      <Tax-Summary-Line>
        <TaxRate>20.00</TaxRate>
        <TaxCategoryCode>S</TaxCategoryCode>
        <TaxAmount>-6.12</TaxAmount>
        <TaxableAmount>-30.58</TaxableAmount>
        <ExciseDuty>0.00</ExciseDuty>
      </Tax-Summary-Line>
    </Tax-Summary>
    <TotalNames>1</TotalNames>
    <TotalExciseDuty>0.00</TotalExciseDuty>
    <TotalCashAmount>0.00</TotalCashAmount>
    <TotalBankAmount>-36.70</TotalBankAmount>
    <TotalAmountInWords>-Тридцять шість гривень 70 копійок</TotalAmountInWords>
  </Invoice-Summary>
</Document-Invoice>