XML Специфікації для роботи з Мережею «Епіцентр»
Зміст:
Видаткова накладна (DOCUMENTINVOICE)
Назва поля |
Тип 1 |
Формат |
Опис |
---|---|---|---|
Document-Invoice |
Початок документа |
||
Invoice-Header |
М |
Початок основного блоку |
|
InvoiceNumber |
М |
Рядок (16) |
Номер видаткової накладної |
InvoiceDate |
М |
Дата (РРРР-ММ-ДД) |
Дата накладної |
DocumentFunctionCode |
М |
DRN |
Код документа (константа) |
ContractNumber |
M |
Рядок (35) |
Номер договору |
ContractDate |
М |
Дата (РРРР-ММ-ДД) |
Дата договору |
InvoiceCurrency |
O |
Рядок (3) |
валюта |
InvoicePostDate |
O |
Дата (РРРР-ММ-ДД) |
дата відправки |
InvoicePostTime |
O |
Час (год: хв) |
час відправки |
Invoice-Header |
M |
Закінчення основного блоку |
|
Invoice-Reference |
M |
Підстава (початок блоку) |
|
Order |
M |
Замовлення (початок блоку) |
|
BuyerOrderNumber |
M |
Рядок (35) |
Номер замовлення |
BuyerOrderDate |
M |
Дата (РРРР-ММ-ДД) |
Дата замовлення |
Order |
Замовлення (закінчення блоку) |
||
TaxInvoice |
O |
Податкова накладна (початок блоку) |
|
TaxInvoiceNumber |
O |
Рядок (35) |
номер податкової накладної |
TaxInvoiceDate |
O |
Дата (РРРР-ММ-ДД) |
дата податкової накладної (повинна збігатися з датою товарною накладною) |
TaxInvoice |
Податкова накладна (закінчення блоку) |
||
DespatchAdvice |
O |
Повідомлення про відвантаження (початок блоку) |
|
DespatchAdviceNumber |
O |
Рядок (16) |
Номер повідомлення про відвантаження |
DespatchAdvice |
Повідомлення про відвантаження (закінчення блоку) |
||
ReceivingAdvice |
Повідомлення про прийом (початок блоку) |
||
ReceivingAdviceNumber |
O |
Рядок (16) |
Номер повідомлення про прийом (RECADV). У разі коригування повернення, має бути вказаний номер акта на повернення |
DeliveryDate |
O |
Дата (РРРР-ММ-ДД) |
Дата приймання. В разі коригування повернення, має бути вказана дата акту на повернення |
ReceivingAdvice |
Повідомлення про прийом (закінчення блоку) |
||
Invoice-Reference |
Підстава (закінчення блоку) |
||
Invoice-Parties |
Блок контрагентів (початок) |
||
Buyer |
M |
Блок покупця (початок) |
|
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 |
M |
Блок продавця (початок) |
|
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 точки доставки (МЕТРО) |
Name |
O |
Рядок (175) |
назва продавця |
StreetAndNumber |
M |
Рядок (140) |
вулиця і номер будинку продавця |
CityName |
М |
Рядок (35) |
місто продавця |
PostalCode |
O |
Рядок (9) |
поштовий код продавця |
DeliveryPoint |
Точка доставки (закінчення) |
||
Invoice-Parties |
Блок контрагентів (закінчення) |
||
Invoice-Lines |
Рядки ТН (початок блоку) |
||
Line |
Рядок (початок блоку) |
||
Line-Item |
Позиція (початок блоку) |
||
LineNumber |
М |
Ціле число |
номер позиції в табличній частині |
EAN |
М |
Число (14) |
Штрих-код продукту |
BuyerItemCode |
M |
Рядок (16) |
Артикул в БД покупця |
ExternalItemCode |
M |
Рядок (4-10) |
код товару згідно з довідника УКТ ЗЕД |
ItemDescription |
М |
Рядок (210) |
Опис товару |
InvoiceQuantity |
M |
Число позитивне |
Замовлена кількість (кількість товару за накладною) |
BuyerUnitOfMeasure |
M |
Рядок (10) |
Одиниці виміру 2 |
UnitOfMeasure |
О |
Рядок (10) |
Одиниці виміру 2 |
InvoiceUnitGrossPrice |
M |
Decimal (18,2) |
Ціна однієї одиниці з ПДВ |
InvoiceUnitNetPrice |
M |
Число позитивне |
Ціна однієї одиниці без ПДВ |
TaxRate |
M |
20/19/16/14/7/2/0 |
Ставка ПДВ (20%, 19%, 16%, 14%, 7%, 2%, 0%) |
TaxCategoryCode |
M |
S / E / Z |
Код категорії податку:
|
GrossAmount |
M |
Decimal (18,2) |
Сума з ПДВ |
TaxAmount |
M |
Число позитивне |
Сума ПДВ по артикулу = сума сум без ПДВ по артикулах * ставку (округляється до 2 знаків) |
NetAmount |
M |
Число позитивне |
Всього без ПДВ (обчислюється) |
Line-Item |
Позиція (закінчення блоку) |
||
Line |
Рядок (закінчення блоку) |
||
Invoice-Lines |
Рядки ТН (закінчення блоку) |
||
Invoice-Summary |
Підсумки (початок блоку) |
||
TotalLines |
M |
Ціле число |
Кількість рядків в документі |
TotalNetAmount |
M |
Число позитивне |
Загальна сума без ПДВ |
TotalTaxAmount |
M |
Число позитивне |
Сума ПДВ |
TotalGrossAmount |
M |
Число позитивне |
Загальна сума з ПДВ |
Invoice-Summary |
Підсумки (закінчення блоку) |
||
Document-Invoice |
Закінчення документа |
Акт розбіжностей (DOCCORINVOICE)
Назва поля |
Тип 1 |
Формат |
Опис |
---|---|---|---|
Document-Invoice |
Початок документа |
||
Invoice-Header |
М |
Початок основного блоку |
|
InvoiceNumber |
М |
Рядок (16) |
Номер Акта розбіжностей |
InvoiceDate |
М |
Дата (РРРР-ММ-ДД) |
Дата Акта розбіжностей |
DocumentFunctionCode |
М |
CVN |
Код документа (константа) |
ContractNumber |
M |
Рядок (35) |
Номер договору |
ContractDate |
М |
Дата (РРРР-ММ-ДД) |
Дата договору |
CorrectionReason |
М |
NAC / NRC |
причина коригування:
|
Invoice-Header |
M |
Закінчення основного блоку |
|
Invoice-Reference |
M |
Підстава (початок блоку) |
|
Order |
M |
Замовлення (початок блоку) |
|
BuyerOrderNumber |
M |
Рядок (35) |
Номер замовлення |
BuyerOrderDate |
M |
Дата (РРРР-ММ-ДД) |
Дата замовлення |
Order |
Замовлення (закінчення блоку) |
||
DeliveryNote |
M |
Повідомлення про доставку (початок блоку) |
|
DeliveryNoteNumber |
M |
Номер документа-підстави |
|
DeliveryNoteDate |
M |
Дата складання документа |
|
DeliveryNote |
M |
Повідомлення про доставку (закінчення блоку) |
|
Invoice-Reference |
Підстава (закінчення блоку) |
||
Invoice-Parties |
M |
Блок контрагентів (початок) |
|
Buyer |
M |
Блок покупця (початок) |
|
ILN |
М |
Число (13) |
GLN покупця |
TaxID |
М |
Число (12) |
Податковий ідентифікаційний номер покупця |
UtilizationRegisterNumber |
М |
Число(8,10) |
ЄДРПОУ покупця |
Name |
М |
Рядок (60) |
назва покупця |
StreetAndNumber |
М |
Рядок (35) |
вулиця і номер будинку покупця |
CityName |
М |
Рядок (35) |
місто покупця |
PostalCode |
М |
Рядок (9) |
поштовий код покупця |
Country |
O |
Рядок (3) |
код країни покупця (код ISO 3166) |
PhoneNumber |
М |
Рядок (35) |
телефон покупця |
Buyer |
Блок покупця (закінчення) |
||
Seller |
M |
Блок продавця (початок) |
|
ILN |
М |
Число (13) |
GLN продавця |
TaxID |
М |
Число (12) |
Податковий ідентифікаційний номер продавця |
UtilizationRegisterNumber |
М |
Число(8,10) |
ЄДРПОУ продавця |
Name |
М |
Рядок (60) |
назва продавця |
StreetAndNumber |
М |
Рядок (140) |
вулиця і номер будинку продавця |
CityName |
М |
Рядок (35) |
місто продавця |
PostalCode |
М |
Рядок (9) |
поштовий код продавця |
Country |
O |
Рядок (3) |
код країни продавця (код ISO 3166) |
PhoneNumber |
М |
Рядок (35) |
телефон продавця |
Seller |
Блок продавця (закінчення) |
||
DeliveryPoint |
M |
Точка доставки (початок блоку) |
|
ILN |
M |
Число (13) |
Глобальний номер розташування (GLN) точки доставки |
Name |
O |
Рядок (80) |
Юридична особа об’єкту доставки |
CityName |
M |
Рядок (35) |
Місто |
StreetAndNumber |
M |
Рядок (140) |
Вулиця і номер будинку |
PostalCode |
O |
Рядок (9) |
Поштовий код |
DeliveryPoint |
Точка доставки (закінчення блоку) |
||
Invoice-Parties |
Блок контрагентів (закінчення) |
||
Invoice-Lines |
M |
Рядки ТН (початок блоку) |
|
Line |
M |
Рядок (початок блоку) |
|
Line-Item |
M |
Позиція (початок блоку) |
|
LineNumber |
М |
Ціле число (3) |
номер позиції в табличній частині |
EAN |
М |
Число (13) |
Штрих-код продукту |
BuyerItemCode |
M |
Строка (10) |
Артикул в БД покупця |
ExternalItemCode |
M |
Рядок (4-10) |
код товару згідно з довідника УКТ ЗЕД |
ItemDescription |
М |
Рядок (50) |
Опис товару |
InvoiceQuantity |
M |
Decimal (18,3) |
Замовлена кількість (кількість товару за накладною) |
BuyerUnitOfMeasure |
M |
Рядок (10) |
|
InvoiceUnitNetPrice |
M |
Decimal (18,5) |
Ціна однієї одиниці без ПДВ |
TaxRate |
M |
Число позитивне |
Ставка ПДВ (20%, 7%, 0%) |
TaxAmount |
O |
Decimal (18,2) |
Сума ПДВ по артикулу |
NetAmount |
O |
Decimal (18,2) |
Сума без ПДВ |
AcceptedInvoiceQuantity |
M |
Decimal (18,3) |
Прийнята кількість |
CorrectionInvoiceQuantity |
M / - |
Positive decimal (18,3) |
Кількість товару за коригувальною накладною. Поле обов’язкове і повинне бути присутнім в документі тільки в разі Коригування кількості |
CorrectionInvoiceUnitNetPrice |
M / - |
Positive decimal (18,2) |
Ціна товару без ПДВ за коригувальною накладною. Поле обов’язкове і повинне бути присутнім в документі тільки в разі Цінових коригувань |
CorrectionInvoiceUnitGrossPrice |
M / - |
Positive decimal (18,2) |
Ціна товару з ПДВ за коригувальною накладною. Поле обов’язкове і повинне бути присутнім в документі тільки в разі Цінових коригувань |
CorrectionNetAmount |
M |
Decimal (18,2) |
Сума без ПДВ з урахуванням коригування |
CorrectionTaxAmount |
M |
Decimal (18,2) |
Сума ПДВ з урахуванням коригування |
CorrectionGrossAmount |
M |
Decimal (18,2) |
Сума з ПДВ з урахуванням коригування |
ReasonRejection |
Причина розбіжності (початок блоку) |
||
ReasonCode |
М |
Число(2) |
Код причини повернення:
|
ReasonText |
M |
Рядок (75) |
Вільний текст вказання причини розбіжності товару |
ReasonRejection |
Причина розбіжності (закінчення блоку) |
||
Line-Item |
Позиція (закінчення блоку) |
||
Line |
Рядок (закінчення блоку) |
||
Invoice-Lines |
Рядки ТН (закінчення блоку) |
||
Invoice-Summary |
Підсумки (початок блоку) |
||
TotalLines |
M |
Ціле число (4) |
Кількість рядків в документі |
Tax-Summary |
Податки (початок блоку) |
||
Tax-Summary-Line |
Рядок податків (початок блоку) |
||
TaxRate |
O |
Число позитивне |
Ставка ПДВ (20%, 7%, 0%) |
TaxAmount |
O |
Decimal (18,2) |
Сума податку для кожної категорії податку |
TaxableAmount |
O |
Decimal (18,2) |
Оподаткована сума за обраною категорією податку |
CorrectionTaxAmount |
M |
Decimal (18,2) |
Загальна сума коригування ПДВ |
CorrectionTaxableAmount |
M |
Decimal (18,2) |
Загальна сума коригування без ПДВ |
CorrectionGrossAmount |
M |
Decimal (18,2) |
Загальна сума коригування з ПДВ |
Tax-Summary-Line |
Рядок податків (закінчення блоку) |
||
Tax-Summary |
Податки (закінчення блоку) |
||
Invoice-Summary |
Підсумки (закінчення блоку) |
||
Document-Invoice |
Закінчення документа |
Акт приймання-передачі (DOCUMENTINVOICE_APP)
Назва поля |
Тип 1 |
Формат |
Опис |
---|---|---|---|
Document-Invoice |
M |
Початок документа |
|
Invoice-Header |
M |
Заголовна частина (початок блоку) |
|
InvoiceNumber |
M |
Рядок(35) |
Номер документа |
InvoiceDate |
M |
yyyy-MM-dd |
Дата документа |
DocumentFunctionCode |
M |
APP |
Функціональний код типу документа:
|
ContractNumber |
M |
Рядок(70) |
Номер контракту |
ContractDate |
O |
yyyy-MM-dd |
Дата контракту |
Invoice-Header |
Заголовна частина (закінчення блоку) |
||
Invoice-References |
O |
Виноски з рахунку (початок блоку) |
|
ReceivingAdvices |
O |
Резерви (початок блоку) |
|
ReceivingAdvice |
O |
Отримане рішення по резерву (початок блоку). Блоків може бути кілька |
|
ReceivingAdviceNumber |
O |
Рядок(70) |
Номер отриманого резерву |
ReceivingAdviceDate |
O |
yyyy-MM-dd |
Дата резерву |
ReceivingAdviceTime |
O |
HH:mm |
Час резерву |
ReceivingAdvice |
Отримане рішення (закінчення блоку) |
||
ReceivingAdvices |
Резерви (закінчення блоку) |
||
Invoice-References |
Виноски з рахунку (закінчення блоку) |
||
Invoice-Parties |
M |
Контрагенти (початок блоку) |
|
Buyer |
M |
Покупець (початок блоку) |
|
ILN |
M |
[0-9](13) |
GLN Покупця |
TaxID |
O |
Рядок(70) |
Податковий ідентифікатор Покупця |
Name |
M |
Рядок(175) |
Назва Покупця |
StreetAndNumber |
O |
Рядок(140) |
Назва вулиці та номер будинку Покупця |
CityName |
O |
Рядок(35) |
Назва міста Покупця |
PostalCode |
O |
Рядок(17) |
Поштовий індекс Покупця |
UtilizationRegisterNumber |
M |
Рядок(70) |
NIP Покупця |
Buyer |
Покупець (закінчення блоку) |
||
Seller |
M |
Продавець (початок блоку) |
|
ILN |
M |
[0-9](13) |
GLN Продавця |
TaxID |
M |
Рядок(70) |
Податковий ідентифікатор Продавця |
Name |
M |
Рядок(175) |
Назва Продавця |
StreetAndNumber |
M |
Рядок(140) |
Назва вулиці та номер будівлі Продавця |
CityName |
M |
Рядок(35) |
Назва міста Продавця |
PostalCode |
M |
Рядок(17) |
Поштовий індекс Продавця |
UtilizationRegisterNumber |
M |
Рядок(70) |
NIP Продавця |
Seller |
Продавець (закінчення блоку) |
||
Invoice-Parties |
Контрагенти (закінчення блоку) |
||
Invoice-Lines |
O |
Таблична частина (початок блоку) |
|
Line |
O |
Рядок (початок блоку) |
|
Line-Item |
M |
Пункт в рядку (початок блоку) |
|
LineNumber |
M |
Число |
Номер рядка |
UnloadingPlace |
M |
[0-9](13) |
Місце розвантаження |
IdentificationCode |
M |
Рядок(10) |
Код Місця розвантаження |
CargoPlaces |
M |
Грузові місця, (початок блоку). Блок може містити список |
|
CargoPlace |
M |
Рядок(35) |
Грузове місце, може бути кілька |
CargoPlaces |
Грузові місця, (закінчення блоку) |
||
Invoices |
M |
Видаткові накладні (початок блоку) |
|
Invoice |
O |
Видаткова накладна (початок блоку). Блоків може бути кілька |
|
OriginalInvoiceNumber |
M |
Рядок(70) |
Номер видаткової накладної |
OriginalInvoiceDate |
O |
yyyy-MM-dd |
Дата видаткової накладної |
Invoice |
Видаткова накладна(закінчення блоку) |
||
Invoices |
Видаткові накладні (початок блоку) |
||
Orders |
M |
Замовлення (початок блоку) |
|
Order |
M |
Замовлення (початок блоку). Блоків може бути кілька |
|
BuyerOrderNumber |
M |
Рядок (35) |
Номер замовлення |
BuyerOrderDate |
M |
yyyy-MM-dd |
Дата складання документа Замовлення |
Order |
Замовлення (закінчення блоку) |
||
Orders |
Замовлення (закінчення блоку) |
||
TemperatureMode |
M |
Ціле число |
Температурний режим; може приймати значення:
|
DeclaredQuantity |
O |
Число десяткове(2) |
Кількість місць |
TransportUnit |
O |
Ціле число |
Транспортний юніт. Можливі значення:
|
Line-Item |
Пункт в рядку (закінчення блоку) |
||
Line |
Рядок (закінчення блоку) |
||
Invoice-Lines |
Таблична частина (закінчення блоку) |
||
Invoice-Summary |
O |
Всього (початок блоку) |
|
TotalLines |
M |
Число |
Всього рядків |
TotalDeclaredQuantity |
O |
Число десяткове(2) |
Всього місць |
Invoice-Summary |
Всього (закінчення блоку) |
||
Document-Invoice |
Завершення документа |
Накладна на повернення (DOCUMENTINVOICE_NP)
DOCUMENTINVOICE з DocumentFunctionCode=NP - Накладна на повернення. Мережа інтегровано відправляє документ своїм Постачальникам
XML:
<Document-Invoice>
<Invoice-Header>
<InvoiceNumber>Test12563</InvoiceNumber>
<InvoiceDate>2024-04-10</InvoiceDate>
<InvoiceCurrency>UAH</InvoiceCurrency>
<DocumentFunctionCode>NP</DocumentFunctionCode>
<ContractNumber>13117117</ContractNumber>
<ContractDate>2023-08-30</ContractDate>
<InternalClientNumber>Впп/ОТ0000921</InternalClientNumber>
<Info>
Причина повернення:Некондинційний товар.=Тип договора:постачання=
</Info>
<PersonName>Філліпович Людмила Євгеніївна</PersonName>
</Invoice-Header>
<Invoice-Reference>
<TaxInvoice>
<TaxInvoiceNumber>Пнк/R10007984</TaxInvoiceNumber>
<TaxInvoiceDate>2024-04-01</TaxInvoiceDate>
</TaxInvoice>
<Order>
<BuyerOrderNumber>Зкз/KR-0000105</BuyerOrderNumber>
<BuyerOrderDate>2024-03-19</BuyerOrderDate>
</Order>
<DeliveryNote>
<DeliveryNoteNumber>Post125468</DeliveryNoteNumber>
<DeliveryNoteDate>2024-04-01</DeliveryNoteDate>
</DeliveryNote>
</Invoice-Reference>
<Invoice-Parties>
<Buyer>
<ILN>9864066866014</ILN>
<TaxID>2333243312</TaxID>
<UtilizationRegisterNumber>32490244</UtilizationRegisterNumber>
<Name>ТОВ "Епіцентр К"</Name>
<StreetAndNumber>вул. Берковецька, 6-K</StreetAndNumber>
<CityName>м. Київ</CityName>
<PostalCode>04128</PostalCode>
<PhoneNumber>(044)206-26-00</PhoneNumber>
</Buyer>
<Seller>
<ILN>9864065732181</ILN>
<TaxID>1010101016</TaxID>
<UtilizationRegisterNumber>34554363</UtilizationRegisterNumber>
<Name>FelEx_1</Name>
</Seller>
<DeliveryPoint>
<ILN>9864066870820</ILN>
</DeliveryPoint>
</Invoice-Parties>
<Invoice-Lines>
<Line>
<Line-Item>
<LineNumber>1</LineNumber>
<EAN>1212121212121</EAN>
<BuyerItemCode>70206212</BuyerItemCode>
<SupplierItemCode>1456987456985</SupplierItemCode>
<ItemDescription>Радіатор 22К</ItemDescription>
<InvoiceQuantity>1.000</InvoiceQuantity>
<UnitOfMeasure>шт</UnitOfMeasure>
<InvoiceUnitNetPrice>4510.75</InvoiceUnitNetPrice>
<TaxRate>20.00</TaxRate>
<TaxCategoryCode>S</TaxCategoryCode>
<NetAmount>4510.75</NetAmount>
</Line-Item>
</Line>
</Invoice-Lines>
<Invoice-Summary>
<TotalLines>1</TotalLines>
<TotalNetAmount>4510.75</TotalNetAmount>
<TotalTaxAmount>902.15</TotalTaxAmount>
<TotalGrossAmount>5412.90</TotalGrossAmount>
</Invoice-Summary>
</Document-Invoice>
- 1
Під визначенням колонки Тип поля мається на увазі скорочене позначення:
M (mandatory) — обов’язкові до заповнення поля;
O (optional) — необов’язкові (опціональні) до заповнення поля.
- 2
елементи структури мають наступний вигляд:
параметрЗіЗначенням;
об’єктЗПараметрами;
масивОб’єктів;
жовтим фоном виділяються комірки, в яких відбувались останні зміни
- 3
Під визначенням колонки Тип поля мається на увазі скорочене позначення:
M (mandatory) — обов’язкові до заповнення поля;
O (optional) — необов’язкові (опціональні) до заповнення поля.
- 4
Одиниці виміру: «г», «кг», «л», «м», «мм», «м2», «м3», «шт», «кор», «пач», «піддон», «пак», «штука дрібна», «uauzd_MIL», «пляш», «рул», «послуга», «uauzd_CMT», «грн», «ящ», «Пар», «год.», «пог.м», «компл», «Тонна», «Блок», «Набір», «паков», «банк», «од»