XML Специфікації для роботи з мережею «МЕТРО»

Зміст:

• XML Специфікації для роботи з мережею «МЕТРО»

  • Транспортна накладна (DOCUMENTINVOICE_TNN)

  • Акт розбіжностей до транспортної накладної (DOCUMENTINVOICE_DTN)

---

Транспортна накладна (DOCUMENTINVOICE_TNN)

Транспортна накладна (DOCUMENTINVOICE_TNN)

Назва поля	Тип 1	Формат	Опис
Document-Invoice			Початок документа
Invoice-Header	М		Початок основного блоку
InvoiceNumber	М	Рядок (35)	номер Транспортної накладної
InvoiceDate	М	Дата (РРРР-ММ-ДД)	дата Транспортної накладної
InvoiceCurrency	М	Рядок (3)	валюта
DocumentFunctionCode	М	TNN	Код типу документа: TNN - транспортна накладна
ContractNumber	О	Рядок (16)	номер договору на поставку
ContractDate	М	Дата (РРРР-ММ-ДД)	дата контракту
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	M	Рядок (16)	Артикул в БД покупця (МЕТРО)
ProductIdBuyer	M	Рядок (16)	Артикул в БД MGB
ItemDescription	М	Рядок (210)	Опис товару
CountPiecesInBox	M	Ціле число	Кількість одиниць товару у коробці (для вагового товару — вага товару у коробці)
BoxesCount	M	Ціле число	Кількість коробів товару, що постачається
DeliveredQuantity	М	Ціле число	Кількість доставлених метро одиниць
Line-Item			Позиція (закінчення блоку)
Line			Рядок (закінчення блоку)
Invoice-Lines			Рядки Транспортної накладної (закінчення блоку)
Invoice-Summary			Підсумки (початок блоку)
TotalLines	M	Ціле число	Кількість рядків в документі
TotalQuantity	М	Ціле число	Загальна кількість одиниць товару
Invoice-Summary			Підсумки (закінчення блоку)
Document-Invoice			Закінчення документа

Приклад "Транспортної накладної" (DOCUMENTINVOICE_TNN)

---

Акт розбіжностей до транспортної накладної (DOCUMENTINVOICE_DTN)

Акт розбіжностей до транспортної накладної (DOCUMENTINVOICE_DTN)

Назва поля	Тип 1	Формат	Опис
Document-Invoice			Початок документа
Invoice-Header	М		Заголовна частина (початок блоку)
InvoiceNumber	М	Рядок (35)	номер Акта розбіжностей до транспортної накладної
InvoiceDate	М	Дата (РРРР-ММ-ДД)	дата Акта розбіжностей до транспортної накладної
InvoiceTime	O	Час (ГГ:ХХ)	Час документа
DocumentFunctionCode	М	DTN	Код типу документа: DTN - Акт розбіжностей до транспортної накладної
ContractNumber	О	Рядок (70)	номер контракту
ContractDate	М	Дата (РРРР-ММ-ДД)	дата контракту
InternalWarehouseNumber	M	Число (6-10)	Внутрішній cкладський номер (Перші дві цифри номера замовлення замінюються на «77»)
Invoice-Header			Заголовна частина (закінчення блоку)
Invoice-Reference	O		Підстава (початок блоку)
Invoice	O		Транспортна накладна (початок блоку)
OriginalInvoiceNumber	O	Рядок(35)	Номер транспортної накладної
OriginalInvoiceDate	O	yyyy-MM-dd	Дата транспортної накладної
Invoice			Транспортна накладна (закінчення блоку)
Order	О		Замовлення (початок блоку)
BuyerOrderNumber	О	Число (6-10)	Номер замовлення
BuyerOrderDate	О	Дата (РРРР-ММ-ДД)	Дата замовлення
Order			Замовлення (закінчення блоку)
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			Блок продавця (закінчення)
Invoice-Parties			Блок контрагентів (закінчення)
Invoice-Lines	O		Таблична частина (початок блоку)
Line	O		Рядок (початок блоку)
Line-Item	M		Позиція (початок блоку)
LineNumber	М	Ціле число	номер рядка
EAN	O	Число [0-9] (14)	Штрих-код продукту
BuyerItemCode	M	Рядок (16)	Артикул в БД покупця (МЕТРО)
ProductIdBuyer	M	Рядок (16)	Артикул в БД MGB
LogisticItemCode	M	Рядок (16)	Артикул FM Logistic
ItemDescription	М	Рядок (210)	Опис товару
InvoiceDeliveredQuantity	М	Число позитивне	Кількість Метро одиниць в транспортній накладній
AcceptedQuantity	М	Число позитивне	Кількість прийнятих Метро одиниць
ReturnedQuantity	М	Число позитивне	Кількість повернених Метро одиниць
ReasonRejection			Причина відмови (початок блоку)
ReasonCode	М	Число(2)	Код причини повернення: 1 - Зіпсований; 2 - Брак; 3 - Бій; 4 - Невідповідність ціни; 5 - Відсутність в замовленні; 6 - Недовіз; 7 - Без документів; 8 - Пересорт; 9 - Невідповідність штрих-коду; 10 - Відсутність в БД; 11 - Нетоварний вигляд; 12 - Бомбаж; 13 - Розвакуумація; 14 - Понад заказу; 15 - Невідповідність назви; 16 - Невідповідність грамовки; 17 - Відсутність сертифікатів; 18 - Відсутність терміну придатності; 19 - Відсутність ветеринарного свідоцтва; 20 - Відсутність акцизних марок; 21 - Відсутність інформаціі для покупців; 22 - Відсутність рекомендованої ціни на тютюнових виробах; 23 - Відсутність дати виготовлення; 24 - Відсутність кінцевого терміну реалізації; 25 - Надлишки; 26 - Малий термін; 27 - Протерміновано; 99 - Вільний текст
ReasonText	M	Рядок (75)	Вільний текст вказання причини відмови товару
ReasonRejection			Причина відмови (закінчення блоку)
Line-Item			Позиція (закінчення блоку)
Line			Рядок (закінчення блоку)
Invoice-Lines			Таблична частина (закінчення блоку)
Invoice-Summary	O		Підсумки (початок блоку)
TotalLines	M	Ціле позитивне число	Кількість рядків в документі
TotalAcceptedQuantity	М	Число позитивне	Загальна кількість прийнятих одиниць товару
Invoice-Summary			Підсумки (закінчення блоку)
Document-Invoice			Закінчення документа

Приклад "Акта розбіжностей до транспортної накладної" (DOCUMENTINVOICE_DTN)

---

1

Під визначенням колонки Тип поля мається на увазі скорочене позначення:

• M (mandatory) — обов’язкові до заповнення поля;

• O (optional) — необов’язкові (опціональні) до заповнення поля.

2

Одиниці виміру: «г», «кг», «л», «м», «мм», «м2», «м3», «шт», «кор», «пач», «піддон», «пак», «штука дрібна», «uauzd_MIL», «пляш», «рул», «послуга», «uauzd_CMT», «грн», «ящ», «Пар», «год.», «пог.м», «компл», «Тонна», «Блок», «Набір», «паков», «банк», «од»