XML Специфікації для роботи з Мережею «Comfy»
Зміст:
Замовлення (ORDER)
Назва поля |
Тип 1 |
Формат |
Опис |
|---|---|---|---|
ORDER |
Початок документа |
||
NUMBER |
М |
Рядок (50) |
Номер замовлення на покупку |
DATE |
М |
Дата (РРРР-ММ-ДД) |
Дата замовлення |
DOCTYPE |
O |
Рядок |
Тип документа:
|
ACTION |
O |
Рядок |
Тип активності:
|
CAMPAIGNNUMBER |
O |
Рядок (70) |
Номер договору постачання |
CAMPAIGNNUMBERDATE |
O |
Дата (РРРР-ММ-ДД) |
Дата договору постачання |
HEAD |
Початок основного блоку |
||
SUPPLIER |
M |
Число (13) |
GLN постачальника |
RECIPIENT |
M |
Число (13) |
GLN одержувача повідомлення |
BUYERCODE |
O |
Число (35) |
ЄДРПОУ |
BUYER |
M |
Число (13) |
Унікальний код місцеперебування компанії |
SENDER |
M |
Число (13) |
GLN відправника повідомлення |
DELIVERYDATE |
М |
Дата (РРРР-ММ-ДД) |
Дата постачання товару |
DELIVERYPLACE |
M |
Число (13) |
Унікальний код місцеперебування складу |
POSITION |
Товарні позиції (початок блоку) |
||
PREORDERNUM |
O |
Рядок (10) |
№ попереднього замовлення (якщо Рядок замовлення створений на основі попереднього замовлення) |
POSITIONNUMBER |
М |
Число позитивне |
Номер товарної позиції |
PRODUCTIDBUYER |
О |
Рядок (16) |
Код товару |
PRODUCT |
M |
Число (8, 10, 14) |
Штрихкод товару |
BRENDNAME |
О |
Рядок (70) |
Найменування бренду товару |
CATEGORYNAME |
О |
Рядок (70) |
Найменування категорії товару |
PRODUCTIDSUPPLIER |
О |
Рядок (40) |
Код товару в системі постачальника |
VAT |
O |
Число десяткове |
Ставка ПДВ,% |
ORDEREDQUANTITY |
M |
Десяткове число в форматі #.### |
Замовлена кількість |
ORDERUNIT |
O |
Рядок (3) |
|
ORDERPRICE |
O |
Число десяткове в форматі #.### |
Ціна продукту без ПДВ |
AMOUNT |
O |
Число десяткове в форматі #.### |
Сума без ПДВ |
PRICEWITHVAT |
O |
Число десяткове в форматі #.### |
Ціна продукту з ПДВ |
AMOUNTWITHVAT |
O |
Число десяткове в форматі #.### |
Сума з ПДВ |
POSITION |
Товарні позиції (закінчення блоку) |
||
HEAD |
Закінчення основного блоку |
||
ORDER |
Закінчення документа |
Підтвердження замовлення (ORDRSP)
Назва поля |
Тип 1 |
Формат |
Опис |
|---|---|---|---|
ORDRSP |
Початок документа |
||
NUMBER |
M |
Рядок (50) |
Номер підтвердження в системі постачальника |
DATE |
M |
Дата (РРРР-ММ-ДД) |
Дата підтвердження в системі постачальника |
ORDERNUMBER |
M |
Рядок (50) |
Номер замовлення |
DOCTYPE |
O |
Рядок |
Тип документа, завжди O
|
ORDERDATE |
M |
Дата (РРРР-ММ-ДД) |
Дата замовлення |
HEAD |
Початок основного блоку |
||
SUPPLIER |
M |
Число (13) |
GLN постачальника |
SENDER |
M |
Число (13) |
GLN відправника повідомлення |
BUYER |
M |
Число (13) |
GLN покупця |
RECIPIENT |
M |
Число (13) |
GLN одержувача повідомлення |
DELIVERYDATE |
M |
Дата (РРРР-ММ-ДД) |
Дата доставки |
DELIVERYPLACE |
M |
Число (13) |
GLN місця доставки |
POSITION |
Товарні позиції (початок блоку) |
||
POSITIONNUMBER |
M |
Ціле число |
Номер позиції |
PRODUCTIDBUYER |
O |
Рядок (16) |
Код товару покупця |
PRODUCT |
M |
Ціле число (8, 10, 14) |
Штрих-код продукту |
PRODUCTIDSUPPLIER |
O |
Рядок (40) |
Артикул в БД постачальника |
CUSTOMSTARIFFNUMBER |
О |
Ціле позитивне число |
Код УКТЗЕД / Номер державної митної декларації (ВМД) |
VAT |
O |
Рядок (3) 20/19/16/14/7/2/0 |
Ставка ПДВ (20%, 19%, 16%, 14%, 7%, 2%, 0%) |
TAXAMOUNT |
М |
Число десяткове |
ПДВ |
ORDEREDQUANTITY |
M |
Ціле позитивне число |
Замовлена кількість |
ACCEPTEDQUANTITY |
M |
Ціле позитивне число |
Підтверджена кількість |
PRICE |
O |
Число десяткове, в форматі 0.### |
Ціна продукту без ПДВ |
PRICEWITHVAT |
O |
Число десяткове, в форматі 0.### |
Ціна продукту з ПДВ |
AMOUNT |
O |
Число десяткове, в форматі 0.### |
Сума товару без ПДВ |
AMOUNTWITHVAT |
O |
Число десяткове, в форматі 0.### |
Сума товару з ПДВ |
DISCOUNT |
О |
Число десяткове, в форматі 0.### |
Сума знижки |
LATESTDELIVERYDATE |
О |
Дата (РРРР-ММ-ДД) |
Дата постачання |
POSITION |
Товарні позиції (закінчення блоку) |
||
HEAD |
Закінчення основного блоку |
||
ORDRSP |
Закінчення документа |
Статус Підтвердження замовлення (Status)
Статус передається за допомогою методу API
Повідомлення про відвантаження (DESADV)
Назва поля |
Тип 1 |
Формат |
Опис |
|---|---|---|---|
DESADV |
Початок документа |
||
NUMBER |
М |
Рядок (50) |
Номер повідомлення про відвантаження |
DATE |
М |
Дата (РРРР-ММ-ДД) |
Дата документа |
VERSION |
О |
Ціле позитивне число |
Версія документа (на рівні одного ланцюжка документів). При заміні документа (номер документа зберігається) потрібно збільшувати значення на одиницю (n+1) |
ORDERNUMBER |
M |
Рядок (50) |
Номер замовлення |
ORDERDATE |
M |
Дата (РРРР-ММ-ДД) |
Дата замовлення |
ORDRSPNUMBER |
О |
Рядок (16) |
Номер підтвердження замовлення |
ORDRSPDATE |
О |
Дата (РРРР-ММ-ДД) |
Дата підтвердження замовлення |
CAMPAIGNNUMBER |
О |
Рядок (70) |
Номер договору на постачання |
SUPPLIER |
М |
Число (13) |
GLN постачальника |
BUYER |
М |
Число (13) |
GLN покупця |
SENDER |
М |
Число (13) |
GLN відправника повідомлення |
RECIPIENT |
М |
Число (13) |
GLN одержувача повідомлення |
DELIVERYDATE |
М |
Дата (РРРР-ММ-ДД) |
Дата постачання |
DELIVERYNOTENUMBER |
М |
Рядок (16) |
Номер накладної |
DELIVERYNOTEDATE |
М |
Дата (РРРР-ММ-ДД) |
Дата накладної |
WAYBILLNUMBER |
О |
Рядок (70) |
Номер транспортної накладної |
WAYBILLDATE |
О |
Дата (РРРР-ММ-ДД) |
Дата транспортної накладної |
TRANSPORTQUANTITY |
О |
Ціле позитивне число |
Кількість машин; Загальна кількість повідомлень про відвантаження на замовлення. Якщо одне з полей TRANSPORTID чи TRANSPORTQUANTITY заповнено, то інше автоматично є обов’язковим. |
TRANSPORTMARK |
О |
Рядок (70) |
Марка машини |
TRANSPORTID |
О |
Рядок (70) |
Порядковий номер авто. Якщо одне з полей TRANSPORTID чи TRANSPORTQUANTITY заповнено, то інше автоматично є обов’язковим. |
TRANSPORTERNAME |
О |
Рядок (70) |
Ім’я водія |
TRANSPORTTYPE |
М |
Рядок (70) |
Тип транспортування: 20 - залізничний, 30 - дорожній, 40 - повітряний, 60 - спарений, 100 - кур’єрська служба |
PACKAGEWEIGHT |
O |
Десяткове число |
Вага |
PACKAGEWEIGHT |
O |
Десяткове число |
Вага по накладній |
TOTALPACKAGES |
O |
Десяткове число |
Кількість коробів |
TOTALPALLETS |
O |
Десяткове число |
Кількість палет |
DELIVERYPLACE |
M |
Число (13) |
GLN місця доставки |
POSITION |
Позиція |
||
POSITIONNUMBER |
М |
Ціле позитивне число |
Номер позиції |
PRODUCT |
М |
Число (8, 10, 14) |
Штрихкод продукту |
PRODUCTIDSUPPLIER |
О |
Рядок (40) |
Артикул в БД постачальника |
PRODUCTIDBUYER |
О |
Рядок (16) |
Артикул в БД покупця |
DELIVEREDQUANTITY |
М |
Ціле число |
Кількість товару, що поставляється |
DELIVEREDUNIT |
О |
Рядок (3) |
|
AMOUNT |
О |
Число десяткове |
Сума товару без ПДВ |
AMOUNTWITHVAT |
О |
Число десяткове |
Сума товару з ПДВ |
CUSTOMSTARIFFNUMBER |
О |
Число (4-10) |
Код УКТЗЕД / Номер державної митної декларації (ВМД) |
DKPPCODE |
О/M (M - при відсутності коду CUSTOMSTARIFFNUMBER) |
Рядок (12) |
Код по Державному класифікатору продукції та послуг. Може приймати значення: 58.29. , 68.20.1, 68.20.12, 68.20.12-00.00. |
TAXRATE |
О |
Ціле число |
Ставка ПДВ (20%, 19%, 16%, 14%, 7%, 2%, 0%) |
BRUTTOWEIGHT |
O |
Decimal (18,3) / Розділення крапкою |
Вага брутто |
POSITION |
Позиція (закінчення блоку) |
||
DESADV |
Закінчення документа |
||
Видаткова накладна (COMDOC_006)
Назва поля |
Тип 1 |
Формат |
Опис |
|---|---|---|---|
ЕлектроннийДокумент |
M |
Початок документу |
|
Заголовок |
M |
Кількість входжень вузла: Min = 1; Max = 1 |
Заголовок (початок блоку) |
НомерДокументу |
M |
Рядок (16) |
Номер документу |
ТипДокументу |
M |
Рядок (50) |
Тип документу: Видаткова накладна |
КодТипуДокументу |
M |
«006» |
Допустиме значення: 006 => Видаткова накладна |
ДатаДокументу |
M |
Дата (РРРР-ММ-ДД) |
Дата складання документу |
ТермінОплати |
O |
Дата (РРРР-ММ-ДД) |
Термін оплати по поставці товару |
ТермінПідпису |
O |
Термін дії підписання документу (початок блоку) |
|
Початок |
M |
Дата (РРРР-ММ-ДД) |
Дата початку терміну дії підписання |
Кінець |
M |
Дата (РРРР-ММ-ДД) |
Дата закінчення терміну дії підписання |
НомерЗамовлення |
O |
Рядок (20) |
Номер замовлення за документом |
ДатаЗамовлення |
O |
Дата (РРРР-ММ-ДД) |
Дата здійснення замовлення |
МісцеСкладання |
O |
Рядок (255) |
Місце складання документу |
ДокПідстава |
M |
Документ-підстава (початок блоку) |
|
НомерДокументу |
M |
Рядок (30) |
Номер документу-підстави |
ТипДокументу |
M |
Рядок (50) |
Типи документів: Договір, Додаткова угода…(типи комерційних документів) |
КодТипуДокументу |
M |
«001» / «002» / «003» …» |
|
ДатаДокументу |
M |
Дата (РРРР-ММ-ДД) |
Дата складання документу-підстави |
ОдностороннєПідписання |
O |
Integer (1) |
Допустиме значення: 1 - Підписання у відповідь не очікується (документ підписується лише відправником) |
ДокПідстава |
Документ-підстава (завершення блоку) |
||
Заголовок |
Заголовок (завершення блоку) |
||
Сторони |
M |
Мількість входжень вузла: Min = 1; Max = 1 |
Сторони, між якими укладено документ (початок блоку) |
Контрагент |
M |
Кількість входжень вузла: Min = 2; Max = 10 |
Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача |
СтатусКонтрагента |
M |
Рядок (30) |
Допустимі значення:
|
ВидОсоби |
M |
Рядок (20) |
Допустимі значення: Юридична; Фізична |
НазваКонтрагента |
M |
Рядок (50) |
Назва контрагента |
КодКонтрагента |
M |
Рядок (8) |
Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр) |
ІПН |
M |
Рядок (12) |
Індивідуальний податковий номер |
СвідоцтвоПДВ |
O |
Integer (10) |
Свідоцтво ПДВ контрагента |
МФО |
O |
Integer (6) |
МФО банку контрагента |
ПоточРах |
O |
Рядок |
Поточний рахунок контрагента |
IBAN |
O |
Рядок (35) |
IBAN (міжнародний номер банківського рахунку; використовується при міжнародних розрахунках) |
Банк |
O |
Рядок |
Банк контрагента |
Телефон |
O |
Рядок (20) |
Телефон контрагента |
GLN |
M |
Integer (13) |
Глобальний номер розташування (GLN) контрагента |
Контрагент |
Контрагент (завершення блоку) |
||
Сторони |
Сторони, між якими укладено документ (завершення блоку) |
||
МісцеДоставки |
M |
Місце доставки (початок блоку) |
|
GLN |
O |
Integer (13) |
Глобальний номер розташування (GLN) місця доставки |
Індекс |
O |
Integer (5) |
Індекс |
Область |
O |
Рядок (50) |
Область |
Місто |
O |
Рядок (50) |
Місто |
Вулиця |
O |
Рядок (50) |
Вулиця |
МісцеДоставки |
Місце доставки (завершення блоку) |
||
Параметри |
M |
Параметри (початок блоку). Тег передбачає довільне значення; використовується для передачі додаткової інформації, що не входить до основних полів специфікації |
|
Параметр |
O |
Рядок (50) |
Максимальна кількість тегів – 99. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю. |
Параметри |
M |
Параметри (завершення блоку) |
|
Таблиця |
O |
Кількість входжень вузла: Min = 0; Max = 1 |
Таблиця (початок блоку) |
Рядок |
M |
Кількість входжень вузла: Min = 1;Max = 9999 |
Рядок (початок блоку). У кожного наступного блоку ідентифікатор (ІД) збільшується на одиницю |
НомПоз |
M |
Integer (3) |
Номер позиції |
<Штрихкод ІД=«1»>6908876610177</Штрихкод> |
O |
Рядок (13) |
Штрих-код продукту. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю. |
АртикулПокупця |
O |
Рядок (10) |
Артикул покупця |
АртикулПродавця |
O |
Рядок (40) |
Артикул продавця |
КодУКТЗЕД |
O |
Integer (10) |
Код товару згідно УКТ ЗЕД (значення не менше 4 і не більше 10 символів) |
ДКПП |
О/M (M - при відсутності коду УКТЗЕД) |
Рядок (12) |
Код по Державному класифікатору продукції та послуг. Може приймати значення: 58.29. , 68.20.1, 68.20.12, 68.20.12-00.00. |
Найменування |
M |
Рядок (50) |
Найменування товарної позиції |
Примітка |
О |
Рядок (50) |
Примітка до товарної позиції |
ПрийнятаКількість |
M |
Decimal (#.000) |
Прийнята кількість товарних позицій |
ОдиницяВиміру |
O |
Рядок (10) |
|
БазоваЦіна |
O |
Decimal (#.00) |
Ціна за одиницю без ПДВ |
ПДВ |
O |
Decimal (#.00) |
Сума ПДВ в одиниці товару (послуги) |
Ціна |
O |
Decimal (#.00) |
Ціна за одиницю з ПДВ |
КількістьАльтОВ |
O |
Decimal (#.000) |
Кількість одиниць товару (в альтернативних одиницях виміру) |
АльтОВ |
O |
Рядок (10) |
Альтернативна одиниця виміру. Може бути вказана у випадку, необхідності вказання в документі додаткової одиниці виміру, відповідно до постанови «Про запровадження режиму експортного забезпечення» |
АльтЦінаБезПДВ |
O |
Decimal (#.000) |
Ціна без ПДВ (в альтернативних одиницях виміру) |
ОзнакаІмпорту |
O |
Integer (1) |
Може приймати значення: 1 - Імпортний товар, 2 - Не імпортний товар |
МРЦ |
O |
Decimal (#.00) |
Максимальна роздрібна ціна |
Сертифікат |
O |
Рядок (50) |
Інформація по сертифікату |
ВсьогоПоРядку |
O |
Кількість входжень вузла: Min = 0; Max = 1 |
Загальна сума по рядку (початок блоку) |
СумаБезПДВ |
O |
Decimal (#.00) |
Сума без ПДВ без знижки |
СумаПДВ |
O |
Decimal (#.00) |
Сума ПДВ |
Сума |
O |
Decimal (#.00) |
Сума |
СумаЗіЗнижкоюБезПДВ |
O |
Decimal (#.00) |
Сума без ПДВ зі знижкою |
СумаЗіЗнижкоюЗПДВ |
O |
Decimal (#.00) |
Сума з ПДВ зі знижкою |
АльтСумаБезПДВ |
O |
Decimal (#.00) |
Сума без ПДВ по рядку (в альтернативних одиницях виміру) |
ВсьогоПоРядку |
Загальна сума по рядку (завершення блоку) |
||
СтавкаПДВ |
M |
«0»/«7»/«20» |
Ставка податку на додану вартість (%); Допустиме значення: 0 / 7 / 20 |
ЦінаРегулярна |
O |
Регулярна ціна (початок блоку) |
|
ЦінаБезПДВ |
O |
Decimal (#.00) |
Цiна без ПДВ |
ЦінаЗіЗнижкоюБезПДВ |
O |
Decimal (#.00) |
Цiна без ПДВ зі знижкою |
ЦінаЗіЗнижкоюЗПДВ |
O |
Decimal (#.00) |
Цiна з ПДВ зі знижкою |
ЦінаРегулярна |
Регулярна ціна (Завершення блоку) |
||
Рядок |
Рядок (завершення блоку) |
||
Таблиця |
Таблиця (завершення блоку) |
||
ВсьогоПоДокументу |
O |
Сумарні значення позицій за документом (початок блоку) |
|
СумаБезПДВ |
O |
Decimal (#.00) |
Сума по всім позиціям без ПДВ без знижки |
ВсьогоЗіЗнижкоюБезПДВ |
O |
Decimal (#.00) |
Сума по всім позиціям без ПДВ зі знижкою |
ВсьогоЗіЗнижкоюЗПДВ |
O |
Decimal (#.00) |
Сума по всім позиціям з ПДВ зі знижкою |
ПДВ |
M |
Decimal (#.00) |
Сума ПДВ в одиниці товару (послуги) |
Сума |
M |
Decimal (#.00) |
Сума |
ВсьогоПоДокументу |
M |
Сумарні значення позицій за документом (завершення блоку) |
|
ЕлектроннийДокумент |
M |
Завершення документу |
XML-Приклад "Видаткова накладна" (COMDOC_006)
- 1
Під визначенням колонки Тип поля мається на увазі скорочене позначення:
M (mandatory) — обов’язкові до заповнення поля;
O (optional) — необов’язкові (опціональні) до заповнення поля.
- 2
Одиниці виміру: «г», «кг», «л», «м», «мм», «м2», «м3», «шт», «кор», «пач», «піддон», «пак», «штука дрібна», «uauzd_MIL», «пляш», «рул», «послуга», «uauzd_CMT», «грн», «ящ», «Пар», «год.», «пог.м», «компл», «Тонна», «Блок», «Набір», «паков», «банк», «од»