XML Специфікації документів для роботи з мережею «МЕТРО»
В переліку специфікацій вказані лише модифіковані під клієнта документи. Специфікації стандартних документів на платформі EDI Network 2.0 можна знайти за посиланням.
- Транспортна накладна (DOCUMENTINVOICE_TNN)
- Акт розбіжностей до транспортної накладної (DOCUMENTINVOICE_DTN)
- Накладна на повернення (DOCUMENTINVOICE_NP)
Транспортна накладна (DOCUMENTINVOICE_TNN)
Опис полів:
|
Назва поля |
Тип 1 |
Формат |
Опис |
|---|---|---|---|
|
Document-Invoice |
Початок документа |
||
|
Invoice-Header |
М |
Початок основного блоку |
|
|
InvoiceNumber |
М |
Рядок (35) |
номер Транспортної накладної |
|
InvoiceDate |
М |
Дата (РРРР-ММ-ДД) |
дата Транспортної накладної |
|
InvoiceCurrency |
М |
Рядок (3) |
валюта |
|
DocumentFunctionCode |
М |
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) |
Одиниці виміру. Доступні значення:
|
|
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>ТОВ "МЕТРО КЕШ ЕНД КЕРІ УКРАЇНА"</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 |
Код типу документа:
|
|
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) |
Одиниці виміру. Доступні значення:
|
|
InvoiceDeliveredQuantity |
М |
Ціле позитивне число; Число десяткове (3 знаки після коми) при UnitOfMeasure=KGM |
Кількість доставлених Метро одиниць в транспортній накладній |
|
AcceptedQuantity |
М |
Ціле позитивне число; Число десяткове (3 знаки після коми) при UnitOfMeasure=KGM |
Кількість прийнятих Метро одиниць |
|
ReturnedQuantity |
М |
Ціле число; Число десяткове (3 знаки після коми) при UnitOfMeasure=KGM |
Кількість повернених Метро одиниць |
|
ReasonRejection |
Причина відмови (початок блоку) |
||
|
ReasonCode |
М |
Число(2) |
Код причини повернення:
|
|
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>ТОВ "МЕТРО КЕШ ЕНД КЕРІ УКРАЇНА"</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>ТОВ "МЕТРО КЕШ ЕНД КЕРІ УКРАЇНА"</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>