XML Специфікації «Маркет»

Прайс-лист (PRICAT)

Прайс-лист (PRICAT) служить для опису товарів і послуг. Даний документ відправляється Виробником; в документі вказується штрих-код продукту, його опис, ціна, ставка ПДВ. За допомогою Прайс-листа можна також вказати зміни в ціні (зростання/зменшення).

Назва поля

Тип 1

Формат

Опис

PRICAT

Початок документа

ACTION

O

Число - «15», «16», «17», «18», «19»

Тип документа і вибір дії:

  • 15 - прайс-лист для Distribution,

  • 16 - масова очистка прайс-листа,

  • 17 - прайс-лист з характеристиками товарної позиції,

  • 18 - прайс-лист з цінами товарної позиції,

  • 19 - запит прайс-листа на поточну дату

NUMBER

M

Рядок (16)

Номер документа

DATE

M

Дата (РРРР-ММ-ДД)

Дата документа

DATEFROM

M (O - при ACTION = 17)

Дата (РРРР-ММ-ДД)

Прайс-лист вступає в силу з дати

DATETO

M (O - при ACTION = 17)

Дата (РРРР-ММ-ДД)

Дата закінчення дії прайс-листа

SUPPLIER

M

Число (13)

GLN Виробника

BUYER

M (O - при ACTION = 17)

Число (13)

GLN Дистриб’ютора

SENDER

M

Число (13)

GLN відправника повідомлення

RECIPIENT

M (O - при ACTION = 17)

Число (13)

GLN одержувача повідомлення

CATALOGUE

Каталог (початок блоку)

POSITION

Товарні позиції (початок блоку)

POSITIONNUMBER

O

Число позитивне

Номер товарної позиції (Порядковий номер товарної позиції в документі (1, 2, 3, 4 … n))

ACTION

O

Число - «2», «3», «4», «27», «29»

Необхідна дія:

  • 2 - додавання нових позицій,

  • 3 - видалення позицій,

  • 4 - зміна даних по позиції

PRODUCTGROUP

M (O - при ACTION = 18)

Рядок (75)

Лінійка товарів

BRAND

M (O - при ACTION = 18 та Виробника ПП «СПС»)

Рядок (75)

Категорія товарів

SUBBRAND

M (O - при ACTION = 18 та Виробника ПП «СПС»)

Рядок (75)

Підкатегорія товарів

IDSUPPLIER

M

Рядок (20)

Артикул

PRODUCTNAME

M (O - при ACTION = 18)

Рядок (255)

Повна назва продукту

PRODUCT

M

Ціле позитивне число (20)

Штрих-код

MINORDERQUANTITY

O (M-для Розетка)

Число з плаваючою точкою (10,3)

Мінімальна кількість замовлення

IDPRODUCER

O

Рядок (8)

Код Виробника

IDNATIONAL

O

Ціле позитивне число (20)

Код товару за національним класифікатором (код УКТЗЕД)

UNITWEIGHT

O

Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)

Вага одиниці (кг) / Для Виробника ПП «СПС»: Вага (г/шт)

QUANTITYOFCUINTU

M (O - при ACTION = 18)

Ціле позитивне число (10)

Одиниць в коробці (Для Виробника ПП «СПС»: Шт./ящ.)

SECONDARYSALES

О

Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)

Вторинні продажі за 21 день, шт (у дистрибютора по звітах. інформаційне)

AVERAGESALES

О

Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)

Середньомісячні вторинні продажі (середні за останні 3 місяці), шт (у дистрибютора по звітах. інформаційне)

ACTUALQUANTITYBUYER

О

Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)

Залишок покупця, шт (у дистрибютора по звітах. інформаційне)

RECOMMENDEDORDERPCE

О

Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)

Рекомендоване замовлення, шт

RECOMMENDEDORDERBOX

О

Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)

Рекомендоване замовлення, ящ

BOXWEIGHT

O

Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)

Вага коробки (кг)

BOXINLAYER

O

Ціле позитивне число (20)

Коробок в шарі (шт.)

BOXINPALLET

O

Ціле позитивне число (20)

Коробок на палеті (шт.)

PALLETWEIGHT

O

Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)

Вага палети (кг)

UNIT

M (O - при ACTION=16/18/19 та Виробника ПП «СПС»)

Рядок (3)

Одиниці виміру

ACTUALQUANTITY

O

Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)

Залишок по позиції

UNITPRICE

M (O - при ACTION = 17 та Виробника ПП «СПС»)

Число з плаваючою точкою (максимально: 6 знаків до крапки і 6 знака після крапки)

Ціна за одиницю без ПДВ (грн.)

PRICEWITHVAT

O(M - для Виробника ПП «СПС»)

Число з плаваючою точкою (максимально: 6 знаків до крапки і 6 знака після крапки)

Ціна за одиницю з ПДВ (грн.) / Для Виробника ПП «СПС»: Ціна зі знижкою з ПДВ (грн./шт.)

TAXRATE

O

Ціле позитивне число - «20», «0», «7»

Ставка ПДВ,%

QUOTA

O

Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)

Квота на замовлення

INFO

O

Рядок (255)

Коментар

NEWPOSITION

O

Число - «0», «1»

Новинка

PROMO

О

Число - «0», «1»

Акція

PUBLICPOSITION

О

Число - «0», «1»

Публічна позиція

POSITION

Товарні позиції (закінчення блоку)

CATALOGUE

Каталог (закінчення блоку)

PRICAT

Закінчення документа

Приклад PRICAT

Замовлення (ORDER)

Замовлення (ORDER) на поставку відправляється Дистриб’ютором; в документі вказується штрих-код продукту, його опис, замовлена кількість, ціна та інша необхідна інформація.

Назва поля

Тип 1

Формат

Опис

ORDER

Початок документа

DOCUMENTNAME

М

Число позитивне

Назва документа (220 -замовлення)

NUMBER

М

Рядок (50)

Номер замовлення

DATE

М

Дата (РРРР-ММ-ДД)

Дата документа

DELIVERYDATE

М

Дата (РРРР-ММ-ДД)

Дата поставки

CURRENCY

O

Рядок (3)

Тризначний код валюти (наприклад, UAH, RUB, USD, EUR, MDL, BYR)

PAYMENTMETHOD

O

Рядок (1)

Код способу оплати:

  • 1 - Готівковий розрахунок

  • 2 - Безготівковий розрахунок

DOCTYPE

O

Рядок (1)

Тип документа:

  • O - оригінал

DISTRIBUTOR

М

Заповнюється лише для сервісу Distribution:

  • 1 - документ сервісу Distribution

PREORDER

O

Попередні замовлення (початок блоку)

PREORDERNUM

O

Рядок (10)

Номер першого Попереднього замовлення (тег може бути використаний декілька разів)

PREORDER

O

Попередні замовлення (закінчення блоку)

HEAD

Початок основного блоку

SUPPLIER

M

Число (13)

GLN Виробника

BUYER

M

Число (13)

GLN Дистриб’ютора

DELIVERYPLACE

M

Число (13)

GLN місця доставки

SENDER

M

Число (13)

GLN відправника повідомлення

RECIPIENT

M

Число (13)

GLN одержувача повідомлення

EDIINTERCHANGEID

O

Рядок (70)

Номер транзакції (підтягується з NUMBER)

DELIVERYTERMS

O

Число

Допустимі значення:

  • 1 - Самовивіз;

  • 2 - Доставка транспортом виробника

PAYMENTMETHOD

O

Число

Спосіб оплати:

  • 1 - Готівковий розрахунок;

  • 2 - Безготівковий розрахунок

POSITION

Товарні позиції (початок блоку)

POSITIONNUMBER

O

Число позитивне

Номер товарної позиції

PRODUCT

M

Число (8, 10, 14)

Штрихкод продукту

PRODUCTIDSUPPLIER

M

Рядок (16)

Артикул в БД

IDPRODUCER

O

Рядок (8)

Код Виробника

ORDEREDQUANTITY

M

Число позитивне

Замовлена ​​кількість (к-ть одиниць)

ORDERUNIT

M

Рядок (3)

Одиниці виміру

ORDERPRICE

O/M

Число десяткове

Ціна продукту без ПДВ. Поле обов’язково заповнюється, якщо Виробник вказав обмеження Мінімальна сума замовлення без ПДВ та/або Максимальна сума замовлення без ПДВ

PRICEWITHVAT

O/M

Число десяткове

Ціна продукту з ПДВ. Поле обов’язково заповнюється, якщо Виробник вказав обмеження Мінімальна сума замовлення з ПДВ та/або Максимальна сума замовлення з ПДВ

VAT

O

Число десяткове

Ставка ПДВ,%

MAXIMUMORDERQUANTITY

O

Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)

Квота на замовлення

CATEGORYNAME

O

Рядок (70)

Найменування лінійки товару

BRENDNAME

O

Рядок (70)

Найменування категорії товару

GROUPNAME

Найменування підкатегорії товару

NOVELTY

O

Новинка

COUNTPIECESINBOX

O

Число позитивне

Кількість одиниць в коробці

COUNTBOXESINLAYER

O

Число позитивне

Кількість коробок в шарі (в 1 рівні)

COUNTPERPALLET

O

Число позитивне

Кількість коробок на палеті

WEIGHT

O

Число десяткове

Вага коробки

UNITWEIGHT

O

Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)

Вага одиниці (кг)

PALLETS

O

Число позитивне

Кількість палет

BOXESCOUNT

O

Число позитивне

Кількість коробок

CHARACTERISTIC

Характеристики (початок блоку)

DESCRIPTION

О

Рядок (70)

Найменування/опис продукту

CHARACTERISTIC

Характеристики (закінчення блоку)

POSITION

Товарні позиції (закінчення блоку)

HEAD

Закінчення основного блоку

ORDER

Закінчення документа

Приклад ORDER

Обмеження (LIMITS)

Обмеження (LIMITS) на замовлення відправляється Виробником; в документі вказуються ціни та кількості по формуванню замовлення у вказаного Дистриб’ютора.

Назва поля

Тип 1

Формат

Опис

DISTRIBEX_LIMITS

Початок документа

HEAD

Початок основного блоку

SENDER

M

Число (13)

GLN Виробника

RECIPIENT

M

Число (13)

GLN Дистриб’ютора

LIMIT

Обмеження (початок блоку)

NAME

M

Рядок. Доступні значення:

  • «min_sum_nds» - Мінімальна сума замовлення з ПДВ, грн - float (10,4)

  • «max_sum_nds» - Максимальна сума замовлення з ПДВ, грн - float (10,4)

  • «min_sum_without_nds» - Мінімальна сума замовлення без ПДВ, грн - float (10,4)

  • «max_sum_without_nds» - Максимальна сума замовлення без ПДВ, грн - float (10,4)

  • «credit_limit» - Кредитний ліміт - float (10,4)

  • «max_weight» - Максимальна вага замовлення, кг - float (13,3)

  • «max_pos_qty» - Максимальна кількість позицій в замовленні - число позитивне (10)

  • «max_pack_qty» - Максимальна кількість коробок - число позитивне (10)

  • «max_pallet_qty» - Максимальна кількість палет - число позитивне (10)

  • «multiplicity_packing» - Кратність упаковки - 0-ні; 1-так

  • «surcharge_rate» - Тариф для надбавки, грн - float (10,2)

  • «multiplicity_min_order_qty» - Кратність мінімальної кількості замовлення - 0-ні, 1-так

Назва обмеження

VALUE

M

Число (формат залежить від NAME)

Значення обмеження

LIMIT

Обмеження (закінчення блоку)

HEAD

Закінчення основного блоку

DISTRIBEX_LIMITS

Закінчення документа

Приклад LIMITS

Прибуткова накладна (COMDOC_007)

Прибуткова накладна (COMDOC_007)

Назва поля

Тип 1

Формат

Опис

ЕлектроннийДокумент

M

Початок документу

Заголовок

M

Кількість входжень вузла: Min = 1; Max = 1

Заголовок (початок блоку)

НомерДокументу

M

Рядок (16)

Номер документу

ТипДокументу

M

Рядок (50)

Тип документу: Прибуткова накладна

КодТипуДокументу

M

«007»

Допустиме значення: 007 => Прибуткова накладна (всі підтипи COMDOC)

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документу

НомерЗамовлення

O

Рядок (20)

Номер замовлення за документом

ДатаЗамовлення

O

Дата (РРРР-ММ-ДД)

Дата здійснення замовлення

МісцеСкладання

O

Рядок (255)

Місце складання документу

ДокПідстава

O

Кількість входжень вузла: Min = 0; Max = 10

Документ-підстава (початок блоку)

НомерДокументу

M

Рядок (30)

Номер документу-підстави

ТипДокументу

M

Рядок (50)

Типи документів: Договір, Додаткова угода…(типи коммерційних документів)

КодТипуДокументу

M

«001» / «002» / «003» …

Код типу документу

ДатаДокументу

M

Дата (РРРР-ММ-ДД)

Дата складання документу

ДокПідстава

Документ-підстава (завершення блоку)

Заголовок

Заголовок (завершення блоку)

Сторони

M

Мількість входжень вузла: Min = 1; Max = 1

Сторони, між якими укладено документ (початок блоку)

Контрагент

M

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача

СтатусКонтрагента

M

Рядок (30)

Допустимі значення: Покупець; Отримувач; Продавець; Замовник; Виконавець; Перевізник; Платник; Підрядник; Відправник; Вантажоодержувач; Вантажовідправник; Експедитор; Клієнт; Консультант

ВидОсоби

M

Рядок (20)

Допустимі значення: Юридична Фізична

НазваКонтрагента

M

Рядок (50)

Назва контрагента

КодКонтрагента

M

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

M

Рядок (12)

Індивідуальний податковий номер контрагента

СвідоцтвоПДВ

O

Integer (10)

Свідоцтво ПДВ контрагента

IBAN

O

Рядок (35)

IBAN (міжнародний номер банківського рахунку; використовується при міжнародних розрахунках)

GLN

M

Integer (13)

Глобальний номер розташування (GLN) контрагента

Контрагент

Контрагент (завершення блоку)

Сторони

Сторони, між якими укладено документ (завершення блоку)

Парамети

O

Параметри (початок блоку). Тег передбачає довільне значення; використовується для передачі додаткової інформації, що не входить до специфікації

Параметр

O

Рядок (50)

Максимальна кількість тегів – 99. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю.

Парамети

O

Параметри (завершення блоку)

Таблиця

O

Кількість входжень вузла: Min = 0; Max = 1

Таблиця (початок блоку)

Рядок

M

Кількість входжень вузла: Min = 1;Max = 9999

Рядок (початок блоку). У кожного наступного блоку ідентифікатор (ІД) збільшується на одиницю

НомПоз

M

Integer (3)

Номер позиції

Штрихкод

O

Рядок (13)

Максимальна кількість тегів – 99. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю.

АртикулПокупця

O

Рядок (10)

Артикул покупця

Найменування

M

Рядок (50)

Найменування товарної позиції

ПрийнятаКількість

O

Decimal (#.000)

Прийнята кількість товарних позицій

ОдиницяВиміру

O

Рядок (10)

Одиниці виміру [2]_

БазоваЦіна

O

Decimal (#.00)

Ціна за одиницю без ПДВ

ПДВ

O

Decimal (#.00)

Сума ПДВ в одиниці товару (послуги)

Ціна

O

Decimal (#.00)

Ціна за одиницю з ПДВ

СтавкаПДВ

Ставка податку на додану вартість

ВсьогоПоРядку

O

Кількість входжень вузла: Min = 0; Max = 1

Загальна сума по рядку (початок блоку)

СумаБезПДВ

O

Decimal (#.00)

Сума без ПДВ

СумаПДВ

O

Decimal (#.00)

Сума ПДВ

Сума

O

Decimal (#.00)

Сума

ВсьогоПоРядку

Загальна сума по рядку (завершення блоку)

Рядок

Рядок (завершення блоку)

Таблиця

Таблиця (завершення блоку)

ВсьогоПоДокументу

O

Сумарні значення позицій за документом (початок блоку)

СумаБезПДВ

O

Decimal (#.00)

Сума без ПДВ

ПДВ

O

Decimal (#.00)

Сума ПДВ в одиниці товару (послуги)

Сума

O

Decimal (#.00)

Сума

ВсьогоПоДокументу

O

Сумарні значення позицій за документом (завершення блоку)

ЕлектроннийДокумент

O

Завершення документу

Приклад COMDOC_007

1

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

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

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