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 |
О |
Рядок (3) |
Одиниці виміру 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 / PAC, NRC / PRC |
причина коригування:
|
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) |
Сума з ПДВ з урахуванням коригування |
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 |
Рядок(3) |
Код Місця розвантаження |
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_APP)
- 1
Під визначенням колонки Тип поля мається на увазі скорочене позначення:
M (mandatory) — обов’язкові до заповнення поля;
O (optional) — необов’язкові (опціональні) до заповнення поля.
- 2
Одиниці виміру: «г», «кг», «л», «м», «мм», «м2», «м3», «шт», «кор», «пач», «піддон», «пак», «штука дрібна», «uauzd_MIL», «пляш», «рул», «послуга», «uauzd_CMT», «грн», «ящ», «Пар», «год.», «пог.м», «компл», «Тонна», «Блок», «Набір», «паков», «банк», «од»