Skip to main content

Товарна/цінова/видаткова накладна (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 Код типу документа
* TN - товарна накладна
* PRN- Цінова накладна
* DRN - Видаткова накладна
1.7 ContractNumber O/M Рядок (16) Номер договору на поставку. Поле обов'язкове для Товарної накладної та Коригування товарної накладної (DocumentFunctionCode=TN/CTN)
1.8 ContractDate М Дата (РРРР-ММ-ДД) дата контракту
2 Invoice-Reference     Підстава (початок блоку)
2.1 Order     Замовлення (початок блоку)
2.1.1 BuyerOrderNumber О Число (6-12) Номер замовлення
2.1.2 BuyerOrderDate О Дата (РРРР-ММ-ДД) Дата замовлення
2.1.3 PlaceOfIssue О Рядок (255) Місце складання документу 2.2 TaxInvoice М   Податкова накладна (початок блоку) 2.2.1 TaxInvoiceNumber М/O Рядок (16) Номер податкової накладної. Поле опціональне для Товарної накладної та Коригування товарної накладної (DocumentFunctionCode=TN/CTN) 2.2.2 TaxInvoiceDate М/O Дата (РРРР-ММ-ДД) Дата податкової накладної (повинна збігатися з датою товарної накладної). Поле опціональне для Товарної накладної та Коригування товарної накладної (DocumentFunctionCode=TN/CTN) 2.3 DespatchAdvice М   Повідомлення про відвантаження (початок блоку) 2.3.1 DespatchAdviceNumber М/O Рядок (15) Номер повідомлення про відвантаження. Поле обов'язкове для Товарної накладної та Коригування товарної накладної (DocumentFunctionCode=TN/CTN) 2.4 ReceivingAdvice     Повідомлення про прийом (початок блоку) 2.4.1 ReceivingAdviceNumber М Рядок (16) Номер повідомлення про прийом (RECADV). У разі коригування повернення, має бути вказаний номер акта на повернення 2.4.2 DeliveryDate O Дата (РРРР-ММ-ДД) Дата приймання. В разі коригування повернення, має бути вказана дата акту на повернення 3 Invoice-Parties     Блок контрагентів (початок) 3.1 Buyer     Блок покупця (початок) 3.1.1 ILN М Число (13) GLN покупця 3.1.2 TaxID М/O Число (35) Податковий ідентифікаційний номер покупця. Поле опціональне для Товарної накладної та Коригування товарної накладної (DocumentFunctionCode=TN/CTN) 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 М/O Число (35) Податковий ідентифікаційний номер продавця. Поле опціональне для Товарної накладної та Коригування товарної накладної (DocumentFunctionCode=TN/CTN) 3.2.3 CodeByBuyer М Рядок (5)/Рядок (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 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     Рядки ТН (початок блоку) 4.5.1 Line     Рядок (початок блоку) 4.5.1.1 Line-Item     Позиція (початок блоку) 4.5.1.1.1 LineNumber М Ціле число номер позиції в табличній частині 4.5.1.1.2 EAN М Число (14) Штрих-код продукту 4.5.1.1.3 BuyerItemCode О/M Рядок (18) Артикул в БД покупця. Поле обов’язкове, якщо отримувач ТМ Метро. Поле обов'язкове для Товарної накладної та Коригування товарної накладної (DocumentFunctionCode=TN/CTN) 4.5.1.1.4 ExternalItemCode M/O Число (10) Код товару згідно з довідника УКТ ЗЕД. Поле опціональне для Товарної накладної та Коригування товарної накладної (DocumentFunctionCode=TN/CTN) 4.5.1.1.5 ItemDescription М Рядок (256) Опис товару 4.5.1.1.6 InvoiceQuantity M Число позитивне Замовлена ​​кількість (кількість товару за накладною) 4.5.1.1.7 BuyerUnitOfMeasure О Рядок (10) Одиниці виміру згідно Класифікатора системи позначень одиниць вимірювання та обліку (КСПОВО) (шт. – штука; уп. – упаковка; л. – літр; послуга; кг. – кілограм; г. – грам…) 4.5.1.1.8 UnitOfMeasure О/M Рядок (3) Одиниці виміру. Поле обов'язкове для Товарної накладної та Коригування товарної накладної (DocumentFunctionCode=TN/CTN) 4.5.1.1.9 InvoiceUnitGrossPrice O Decimal (18,2) Ціна однієї одиниці з ПДВ 4.5.1.1.10 InvoiceUnitNetPrice M Decimal (18,4) Ціна однієї одиниці без ПДВ 4.5.1.1.11 TaxRate M 20/19/16/14/7/2/0 Ставка ПДВ (20%, 19%, 16%, 14%, 7%, 2%, 0%) 4.5.1.1.12 TaxCategoryCode O S / E / Z Код категорії податку:
S - стандартний податок; можливі значення TaxRate: 20/19/16/14/7/2 (інакше помилка)

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

Z - нульова ставка (0%); можливі значення TaxRate=0 (інакше помилка) 4.5.1.1.13 GrossAmount O Decimal (18,2) Сума з ПДВ 4.5.1.1.14 TaxAmount M Число позитивне Сума ПДВ по артикулу = сума сум без ПДВ по артикулах * ставку (округляється до 2 знаків) 4.5.1.1.15 NetAmount M Число позитивне Всього без ПДВ (обчислюється) 4.5.1.1.16 AdditionalInvoiceQuantity О Число позитивне Кількість одиниць товару (в альтернативних одиницях виміру) згідно Постанови про РЕЗ 1261 4.5.1.1.17 AdditionalUnitOfMeasure О Рядок (3) Одиниця виміру (альт.) згідно Постанови про РЕЗ 1261 4.5.1.1.18 AdditionalNetAmount О Число позитивне Ціна без ПДВ (альт.) згідно Постанови про РЕЗ 1261 55.1.1.19 MaxRetailPrice О Decimal(#.00) Максимальна роздрібна ціна 5.1.1.20 CertificateInfo О Рядок (50) Інформація по сертифікату 6 Invoice-Summary     Підсумки (початок блоку) 5.6.1 TotalLines M Ціле число Кількість рядків в документі 5.6.2 TotalNetAmount M Число позитивне Загальна сума без ПДВ 5.6.3 TotalTaxAmount M Число позитивне Сума ПДВ 5.6.4 TotalGrossAmount M Число позитивне Загальна сума з ПДВ 5.6.5 Tax-Summary     Податки (початок блоку) 5.6.5.1 Tax-Summary-Line     Рядок податків (початок блоку) 5.6.5.1.1 TaxRate M 20/19/16/14/7/2/0 Ставка ПДВ (20%, 19%, 16%, 14%, 7%, 2%, 0%) 5.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) 5.6.5.1.3 TaxAmount M Число позитивне Сума податку для кожної категорії податку 5.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>
       <Параметри>
          <Параметр ІД="1" назва="Точка доставки">9864232009067</Параметр>
          <Параметр ІД="2" назва="Адреса -доставки">08032, Бучанський район, село Колонщина, вулиця Київська, будинок 23</Параметр>
       </Параметри>
       <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>