XML Специфікації документів для роботи з Мережею «Comfy»
В переліку специфікацій вказані лише модифіковані під клієнта документи. Специфікації стандартних документів на платформі EDI Network 2.0 можна знайти за посиланням.
- Замовлення (ORDER)
- Підтвердження замовлення (ORDRSP)
- Статус Підтвердження замовлення (Status)
- Повідомлення про відвантаження (DESADV)
- Видаткова накладна (COMDOC_006)
Замовлення (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 |
Закінчення документа |
- [1] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
-
-
-
M (mandatory) — обов’язкові для заповнення поля;
-
O (optional) — необов’язкові (опціональні) для заповнення поля.
-
-
Завантажити XML-приклад Замовлення (ORDER): ORDER_example.xml
Підтвердження замовлення (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 |
Закінчення документа |
- [1] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
-
-
-
M (mandatory) — обов’язкові для заповнення поля;
-
O (optional) — необов’язкові (опціональні) для заповнення поля.
-
-
Завантажити XML-приклад Підтвердження замовлення (ORDRSP): ORDRSP_example.xml
Статус Підтвердження замовлення (Status)
Статус передається за допомогою методу API.
Стандартна XML-специфікація документа Статус (Status) знаходиться за посиланням.
Повідомлення про відвантаження (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 |
Закінчення документа |
- [1] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
-
-
-
M (mandatory) — обов’язкові для заповнення поля;
-
O (optional) — необов’язкові (опціональні) для заповнення поля.
-
-
Завантажити XML-приклад Повідомлення про відвантаження (DESADV): DESADV_example.xml
Видаткова накладна (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 |
Завершення документу |
- [1] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
-
-
-
M (mandatory) — обов’язкові для заповнення поля;
-
O (optional) — необов’язкові (опціональні) для заповнення поля.
-
-
Завантажити XML-приклад Видаткової накладної (COMDOC_006): COMDOC_006_example.xml