Товарна/цінова/видаткова накладна (DOCUMENTINVOICE)
DOCUMENTINVOICE - Товарна накладна. Документ може бути створений на підставі Повідомлення про прийом (RECADV).
Опис полів:
| № з/п | Параметр1 | Тип2 | Формат | Опис |
| I | Document-Invoice | Початок документа | ||
| 1 | Invoice-Header | М | Початок основного блоку | |
| 1.1 | InvoiceNumber | М | Число (15) | номер накладної |
| 1.2 | InvoiceDate | М | Дата (РРРР-ММ-ДД) | дата накладної |
| 1.3 | InvoiceCurrency | М | Рядок (3) | валюта ("UAH") |
| 1.4 | InvoicePostDate | O | Дата (РРРР-ММ-ДД) | дата відправки накладної |
| 1.5 | InvoicePostTime | O | Час (год: хв) | час відправки накладної |
| 1.6 | DocumentFunctionCode | М | TN/PRN/DRN | Код типу документа |
| 1.7 | ContractNumber | O/M | Рядок (16) | Номер договору на поставку. Поле обов'язкове для Товарної накладної та Коригування товарної накладної (DocumentFunctionCode=TN/CTN) |
| 1.8 | ContractDate | М | Дата (РРРР-ММ-ДД) | дата контракту |
| 1.9 |
UA — (2 літери) — код країни (ГОСТ ISO 3166-1);
NN — (2 цифри) — контрольне число;
351005 — (6 цифр) — МФО;
XXX…XXX — (19 цифр) — рахунок клієнта. IBAN (міжнародний номер банківського рахунку; використовується при міжнародних розрахунках) 3.2.12 SellerTALicense О Рядок (255) Ліцензія ТА продавця 3.3 DeliveryPoint M Точка доставки (початок блоку) 3.3.1 ILN М Число (13) GLN точки доставки (МЕТРО) 3.3.2 DeliveryPlace М Рядок (35) код точки доставки (не повинен перевищувати два знаки) 3.4 Invoicee Рахунок (початок блоку) 3.4.1 ILN M Число (13) GLN для виставлення рахунку 3.5 Payer Платник (початок блоку) 3.5.1 ILN M Число (13) GLN платника 4 Parameters
Параметри (початок блоку). Тег передбачає довільне значення; використовується для передачі додаткової інформації, що не входить до специфікації 4.1 Parameter О Рядок (50) Максимальна кількість тегів – 99. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю. 5 Invoice-Lines Рядки ТН (початок блоку) 5.1 Line Рядок (початок блоку) 5.1.1 Line-Item Позиція (початок блоку) 5.1.1.1 LineNumber М Ціле число номер позиції в табличній частині 5.1.1.2 EAN М Число (14) Штрих-код продукту 5.1.1.3 BuyerItemCode О/M Рядок (18) Артикул в БД покупця. Поле обов’язкове, якщо отримувач ТМ Метро. Поле обов'язкове для Товарної накладної та Коригування товарної накладної (DocumentFunctionCode=TN/CTN) 5.1.1.4 ExternalItemCode M/O Число (10) Код товару згідно з довідника УКТ ЗЕД. Поле опціональне для Товарної накладної та Коригування товарної накладної (DocumentFunctionCode=TN/CTN) 5.1.1.5 ItemDescription М Рядок (256) Опис товару 5.1.1.6 InvoiceQuantity M Число позитивне Замовлена кількість (кількість товару за накладною) 5.1.1.7 BuyerUnitOfMeasure О Рядок (10) Одиниці виміру згідно Класифікатора системи позначень одиниць вимірювання та обліку (КСПОВО) (шт. – штука; уп. – упаковка; л. – літр; послуга; кг. – кілограм; г. – грам…) 5.1.1.8 UnitOfMeasure О/M Рядок (3) Одиниці виміру. Поле обов'язкове для Товарної накладної та Коригування товарної накладної (DocumentFunctionCode=TN/CTN) 5.1.1.9 InvoiceUnitGrossPrice O Decimal (18,2) Ціна однієї одиниці з ПДВ 5.1.1.10 InvoiceUnitNetPrice M Decimal (18,4) Ціна однієї одиниці без ПДВ 5.1.1.11 TaxRate M 20/19/16/14/7/2/0 Ставка ПДВ (20%, 19%, 16%, 14%, 7%, 2%, 0%) 5.1.1.12 TaxCategoryCode O S / E / Z Код категорії податку:
S - стандартний податок; можливі значення TaxRate: 20/19/16/14/7/2 (інакше помилка)
E - звільнений від сплати податку; можливі значення TaxRate=0 (інакше помилка)
Z - нульова ставка (0%); можливі значення TaxRate=0 (інакше помилка) 5.1.1.13 GrossAmount O Decimal (18,2) Сума з ПДВ 5.1.1.14 TaxAmount M Число позитивне Сума ПДВ по артикулу = сума сум без ПДВ по артикулах * ставку (округляється до 2 знаків) 5.1.1.15 NetAmount M Число позитивне Всього без ПДВ (обчислюється) 5.1.1.16 AdditionalInvoiceQuantity О Число позитивне Кількість одиниць товару (в альтернативних одиницях виміру) згідно Постанови про РЕЗ 1261 5.1.1.17 AdditionalUnitOfMeasure О Рядок (3) Одиниця виміру (альт.) згідно Постанови про РЕЗ 1261 5.1.1.18 AdditionalNetAmount О Число позитивне Ціна без ПДВ (альт.) згідно Постанови про РЕЗ 1261 5.1.1.19 MaxRetailPrice О Decimal(#.00) Максимальна роздрібна ціна 5.1.1.20 CertificateInfo О Рядок (50) Інформація по сертифікату 5.1.1.21 ImportType O Integer (1)
Ознака імпорту:
Може приймати значення:
1 - Імпортний товар,
2 - Не імпортний товар
6 Invoice-Summary Підсумки (початок блоку) 6.1 TotalLines M Ціле число Кількість рядків в документі 6.2 TotalNetAmount M Число позитивне Загальна сума без ПДВ 6.3 TotalTaxAmount M Число позитивне Сума ПДВ 6.4 TotalGrossAmount M Число позитивне Загальна сума з ПДВ 6.5 Tax-Summary Податки (початок блоку) 6.5.1 Tax-Summary-Line Рядок податків (початок блоку) 6.5.1.1 TaxRate M 20/19/16/14/7/2/0 Ставка ПДВ (20%, 19%, 16%, 14%, 7%, 2%, 0%) 6.5.1.2 TaxCategoryCode O/M S / E / Z Код категорії податку:* S - стандартний податок; можливі значення TaxRate: 20/19/16/14/7/2 (інакше помилка)
* E - звільнений від сплати податку; можливі значення TaxRate=0 (інакше помилка)
* Z - нульова ставка (0%); можливі значення TaxRate=0 (інакше помилка)
Поле обов'язкове для Товарної накладної та Коригування товарної накладної (DocumentFunctionCode=TN/CTN) 6.5.1.3 TaxAmount M Число позитивне Сума податку для кожної категорії податку 6.5.1.4 TaxableAmount M Число позитивне Оподаткована сума за обраною категорією податку
- [1] - елементи структури мають наступний вигляд:
-
-
параметрЗіЗначенням;
-
об’єктЗПараметрами;
-
масивОб’єктів;
-
жовтим фоном виділяються комірки, в яких відбувались останні зміни
-
- [2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
-
-
-
M (mandatory) — обов’язкові до заповнення поля;
-
O (optional) — необов’язкові (опціональні) до заповнення поля.
XML приклад
<Document-Invoice> <Invoice-Header> <InvoiceNumber>TEST1</InvoiceNumber> <InvoiceDate>2023-04-01</InvoiceDate> <InvoiceCurrency>UAH</InvoiceCurrency> <InvoicePostDate>2020-01-10</InvoicePostDate> <InvoicePostTime>14:14</InvoicePostTime> <DocumentFunctionCode>TN</DocumentFunctionCode> <ContractNumber>12312564</ContractNumber> <ContractDate>2023-04-25</ContractDate> </Invoice-Header> <Invoice-Reference> <Order> <BuyerOrderNumber>ftp_3037_1</BuyerOrderNumber> <BuyerOrderDate>2022-09-08</BuyerOrderDate> </Order> <TaxInvoice> <TaxInvoiceNumber>5670542</TaxInvoiceNumber> <TaxInvoiceDate>2020-01-10</TaxInvoiceDate> </TaxInvoice> <DespatchAdvice> <DespatchAdviceNumber>2936_des_1</DespatchAdviceNumber> </DespatchAdvice> <ReceivingAdvice> <ReceivingAdviceNumber>777_des_3</ReceivingAdviceNumber> <DeliveryDate>2022-07-03</DeliveryDate> </ReceivingAdvice> </Invoice-Reference> <Invoice-Parties> <Buyer> <ILN>9864232324065</ILN> <TaxID>9000999909</TaxID> <UtilizationRegisterNumber>0957042</UtilizationRegisterNumber> <Name>FELEX TEST Bogdan 2</Name> <StreetAndNumber>Юр адреса</StreetAndNumber> <CityName>Kiev</CityName> <PostalCode>47298</PostalCode> <Country>UA</Country> <PhoneNumber>0990110555</PhoneNumber> </Buyer> <Seller> <ILN>9864065732181</ILN> <CodeByBuyer>215547</CodeByBuyer> <UtilizationRegisterNumber>34554362</UtilizationRegisterNumber> <Name>Епіцентр</Name> <StreetAndNumber>ул Улица</StreetAndNumber> <CityName>г Городок</CityName> <PostalCode>102030</PostalCode> <PhoneNumber>380000000000</PhoneNumber> <IBAN>UA613808050000000026004439987</IBAN> </Seller> <DeliveryPoint> <ILN>9864066866014</ILN> <Name>Епіцентр</Name> <DeliveryPlace>г Городок</DeliveryPlace> </DeliveryPoint> <Invoicee> <ILN>9864065732231</ILN> </Invoicee> <Payer> <ILN>9864065732211</ILN> </Payer> </Invoice-Parties> <Parameters> <Parameter ID="1" name="Точка доставки">9864232009067</Parameter> <Parameter ID="1" name="Адреса -доставки">08032, Бучанський район, село Колонщина, вулиця Київська, будинок 23</Parameter> </Parameters> <Invoice-Lines> <Line> <Line-Item> <LineNumber>1</LineNumber> <EAN>14725836901471</EAN> <BuyerItemCode>11111111</BuyerItemCode> <ExternalItemCode>3333333333</ExternalItemCode> <ItemDescription>drink1</ItemDescription> <InvoiceQuantity>3.000</InvoiceQuantity> <BuyerUnitOfMeasure>шт</BuyerUnitOfMeasure> <InvoiceUnitNetPrice>456.00</InvoiceUnitNetPrice> <TaxRate>7</TaxRate> <TaxCategoryCode>S</TaxCategoryCode> <GrossAmount>1201.2</GrossAmount> <TaxAmount>95.76</TaxAmount> <NetAmount>1368.00</NetAmount> </Line-Item> </Line> </Invoice-Lines> <Invoice-Summary> <TotalLines>1</TotalLines> <TotalNetAmount>1001</TotalNetAmount> <TotalTaxAmount>200.2</TotalTaxAmount> <TotalGrossAmount>1201.2</TotalGrossAmount> <Tax-Summary> <Tax-Summary-Line> <TaxRate>7.00</TaxRate> <TaxAmount>200.2</TaxAmount> <TaxableAmount>200.5</TaxableAmount> </Tax-Summary-Line> </Tax-Summary> </Invoice-Summary> </Document-Invoice>
-
-