Skip to main content

XML-специфікація до Документообіг з мережею «АТБ». Інструкція для Постачальника

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

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

Назва поля

Тип 1

Формат

Опис

ORDER

   

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

DOCUMENTNAME

M

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

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

NUMBER

M

Рядок (50)

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

DATE

M

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

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

ACTION

О

« 4 »,« 5 »,« 27 »,« 29 »

4 - поставка змінена, 5 - заміна документа, 29 - поставка прийнята, 27 - поставка не прийнята

EXCHANGE_SCHEMA_TYPE

O

 

лише для Фоззі: схема документообігу: 0-звичайна, 1-особлива

VERSION

O

Число позитивне (1-99)

Версія замовлення

PROMO

O

« 0 »,« 1 »

Акція: 0 - немає, 1 - є

DELIVERYDATE

M

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

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

DELIVERYTIME

O

Час (год: хв)

Час поставки

SHIPMENTDATE

O

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

Дата відвантаження

SHIPMENTTIME

O

Час (год: хв)

Час відвантаження

CAMPAIGNNUMBER

O

Рядок (70)

Номер договору на поставку

CAMPAIGNNUMBERDATE

O

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

Дата договору

CURRENCY

M

Рядок (3)

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

TRANSPORTQUANTITY

O

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

Кількість машин

ORDERREFERENCENUMBER

 

Рядок (16)

Унікальний номер замовлення для відстеження

LIMES

   

Деталі транспорту (початок блоку)

LIMESNAME

O

Рядок (70)

Назва рампи

DATEFROM

O

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

Дата прибуття транспорту

TIMEFROM

O

Час (год: хв)

Час прибуття транспорту

DATETO

O

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

Дата закінчення відвантаження

TIMETO

O

Час (год: хв)

Час закінчення відвантаження

LIMES

   

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

VAT

O

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

Ставка ПДВ,%

TRANSPORTATIONTYPES

O

Рядок (35)

Вид транспортування

TRANSPORTATIONMEANS

O

Рядок (70)

Транспортний засіб

TRANSPORTATIONCONDITION

O

Рядок (70)

Умови транспортування

TRANSPORTATIONPAYMENTTYPE

O

Рядок (35)

Тип оплати доставки (Умови оплати)

TRANSPORTATIONROUTE

O

Рядок (70)

Маршрут доставки

BLANKETORDERNUMBER

O

Рядок (35)

Номер бланкового замовлення

INFOCODED

O

Рядок (35)

Інфокод

DOCTYPE

O

Рядок (1)

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

    O - оригінал,

    R - заміна,

    D - видалення,

    F - фіктивність замовлення,

    PO - попереднє замовлення,

    OS - замовлення на послугу / маркетинг

    CORRNUMBER

         

    SUPORDER

    O

    Рядок (35)

    Номер замовлення постачальника

    KDKNUM

    O

    Рядок (35)

    Номер загального замовлення КДК

    ORDRTYPE

    O

    Рядок (35)

    Тип замовлення

    INFO

    O

    Рядок (70)

    Вільний текст

    PREORDER

    O

     

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

    PREORDERNUM

    O

    Рядок (10)

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

    PREORDER

    O

     

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

    EARLIESTDELIVERYDATE

    O

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

    Поставка не раніше зазначеної дати

    LATESTDELIVERYDATE

    O

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

    Поставка не пізніше зазначеної дати

    HEAD

       

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

    SUPPLIER

    M

    Число (13)

    GLN постачальника

    BUYER

    M

    Число (13)

    GLN покупця

    BUYERCODE

    O

    Рядок (35)

    Код покупця

    BRANCHCODE

    O

    Рядок

    Код філіалу (для Нова Лінія та ЕПІЦЕНТР К )

    DELIVERYPLACE

    M

    Число (13)

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

    FINALRECIPIENT

    O

    Число (13)

    GLN кінцевого консигнатора

    ORDERPARTNER

    O

    Число (13)

    GLN замовника

    INVOICEPARTNER

    O

    Число (13)

    GLN платника

    SENDER

    M

    Число (13)

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

    RECIPIENT

    M

    Число (13)

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

    CONSIGNEE

    О

    Число (13)

    GLN вантажоодержувача

    RECIPIENTCODE

    O

    Рядок (35)

    Код отримувача

    RECIPIENTNAME

    O

    Рядок (70)

    Ім’я одержувача

    INFO

    O

    Рядок (70)

    Вільний текст

    DISCOUNTVALUE

    O

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

    Розмір знижки

    RECIPIENTCONTACTFACE

    O

    Рядок (70)

    Контактна особа

    RECIPIENTPHONE

    O

    Рядок (35)

    Телефон одержувача

    RECIPIENTCITY

    O

    Рядок (35)

    Місто одержувача

    RECIPIENTADRESS

    O

    Рядок (70)

    Адреса одержувача

    EDIINTERCHANGEID

    O

    Рядок (70)

    Номер транзакції

    POSITION

       

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

    POSITIONNUMBER

    M

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

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

    PRODUCT

    M

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

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

    PRODUCTIDSUPPLIER

    O

    Рядок (16)

    Артикул в БД

    PRODUCTIDBUYER

    O

    Рядок (16)

    Артикул в БД покупця

    BUYERPARTNUMBER

    О

    Рядок (16)

    Внутрішній системний номер артикулу в БД покупця

    ORDEREDQUANTITY

    M

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

    Замовлена ​​кількість

    QUANTITYOFCUINTU

    О

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

    Кількість в упаковці

    ORDERUNIT

    О

    Рядок (3)

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

    QUANTITYOFPACKS

    О

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

    Кількість упаковок

    ORDERPRICE

    M

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

    Ціна продукту без ПДВ

    PRICEWITHVAT

    O

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

    Ціна продукту з ПДВ

    AMOUNT

    O

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

    Сума товару (без ПДВ)

    AMOUNTWITHVAT

    О

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

    Сума товару (з ПДВ)

    VAT

    O

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

    Ставка ПДВ,%

    CLAIMEDDELIVERYDATE

    O

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

    Оголошена дата доставки

    CLAIMEDDELIVERYTIME

    O

    Час (год: хв)

    Оголошений час доставки

    DELIVERYPLACE

    О

    Число (13)

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

    INFOCODED

    O

    Рядок (35)

    Інфокод

    MINIMUMORDERQUANTITY

    O

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

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

    MAXIMUMORDERQUANTITY

    O

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

    Максимально допустима відвантажувана кількість

    PRODUCTIONCODE

    О

    Рядок (16)

    Код алкогольної продукції

    POSITIONKGM

    O

     

    Всього кілограм по позиції

    INFO

    O

    Рядок (90)

    Вільний текст

    COMPAIGNNUMBER

    O

    Рядок (70)

    Номер постачальника

    EARLIESTDELIVERYDATE

    O

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

    Поставка не раніше зазначеної дати

    LATESTDELIVERYDATE

    O

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

    Поставка не пізніше зазначеної дати

    LATESTDELIVERYTIME

    O

    Час (год: хв)

    Поставка не пізніше зазначеного часу

    CONDITIONSTATUS

    О

    Рядок (3)

    Статус кондиції

    PACKAGEID

    O

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

    Ідентифікатор упаковки

    CATEGORYNAME

    O

    Рядок (70)

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

    BRENDNAME

    O

    Рядок (70)

    Найменування бренду

    GROUPNAME

       

    Найменування групи товару

    NOVELTY

    O

     

    Новинка

    COUNTPIECESINBOX

    O

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

    Кількість частин в упаковці

    COUNTBOXESINLAYER

    O

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

    Кількість упаковок на 1 рівні

    COUNTPERPALLET

    O

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

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

    WEIGHT

    O

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

    Вага

    PALLETS

    O

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

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

    COUNTRYORIGIN

    О

    Рядок (2)

    Країна виробник

    CALIBRE

    O

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

    Діаметр

    PRICEWITHDISCOUNT

    O

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

    Ціна з урахуванням знижки

    BOXESCOUNT

    O

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

    Кількість упаковок

    CHARACTERISTIC

       

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

    SERVICEDESCRIPTION

    О/M (обов’язковий тільки для Замовлення послуги - ORDER з полем DOCTYPE=OS)

    Рядок (500)

    Назва послуги

    DESCRIPTION

    О

    Рядок (70)

    Опис продукту

    CHARACTERISTIC

       

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

    PACKING

       

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

    PACKINGTYPE

    O

    Рядок (3)

    Тип упаковки

    PACKINGQUANTITY

    O

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

    Кількість упаковок

    PACKINGUNIT

    O

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

    Пакувальник

    PACKING

       

    Упаковка (закінчення блоку)

    POSITION

       

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

    HEAD

       

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

    ORDER

       

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

    Приклад XML

    <?xml version="1.0" encoding="UTF-8"?>
    <ORDER>
      <DOCUMENTNAME>220</DOCUMENTNAME>
      <NUMBER>test2</NUMBER>
      <DATE>2020-12-07</DATE>
      <ACTION>4</ACTION>
      <EXCHANGE_SCHEMA_TYPE>0</EXCHANGE_SCHEMA_TYPE>
      <VERSION>1</VERSION>
      <PROMO>0</PROMO>
      <DELIVERYDATE>2020-12-15</DELIVERYDATE>
      <DELIVERYTIME>20:20</DELIVERYTIME>
      <SHIPMENTDATE>2023-03-06</SHIPMENTDATE>
      <SHIPMENTTIME>20:30</SHIPMENTTIME>
      <CAMPAIGNNUMBER>111111</CAMPAIGNNUMBER>
      <CAMPAIGNNUMBERDATE>2023-03-02</CAMPAIGNNUMBERDATE>
      <CURRENCY>UAH</CURRENCY>
      <TRANSPORTQUANTITY>1</TRANSPORTQUANTITY>
      <ORDERREFERENCENUMBER>123456789</ORDERREFERENCENUMBER>
      <LIMES>
        <LIMESNAME>назва</LIMESNAME>
        <DATEFROM>2023-03-07</DATEFROM>
        <TIMEFROM>20:00</TIMEFROM>
        <DATETO>2023-03-07</DATETO>
        <TIMETO>20:30</TIMETO>
      </LIMES>
      <VAT>20</VAT>
      <TRANSPORTATIONTYPES>перевезення</TRANSPORTATIONTYPES>
      <TRANSPORTATIONMEANS>авто</TRANSPORTATIONMEANS>
      <TRANSPORTATIONCONDITION>умова</TRANSPORTATIONCONDITION> 
      <TRANSPORTATIONPAYMENTTYPE>погодинна</TRANSPORTATIONPAYMENTTYPE>
      <TRANSPORTATIONROUTE>маршрут</TRANSPORTATIONROUTE>
      <BLANKETORDERNUMBER>12345</BLANKETORDERNUMBER>
      <INFOCODED>41322267</INFOCODED>
      <DOCTYPE>O</DOCTYPE>
      <CORRNUMBER>12</CORRNUMBER>
      <SUPORDER>номер 123</SUPORDER>
      <KDKNUM>40817810099910004312</KDKNUM>
      <ORDRTYPE>ORIGINAL</ORDRTYPE>
      <INFO>інформація</INFO>
      <PREORDER>
         <PREORDERNUM>12543</PREORDERNUM>
      </PREORDER>  
      <EARLIESTDELIVERYDATE>2023-03-06</EARLIESTDELIVERYDATE>
      <LATESTDELIVERYDATE>2023-03-10</LATESTDELIVERYDATE>
      <HEAD>
        <SUPPLIER>9101010101035</SUPPLIER>
        <BUYER>9101010101042</BUYER>
        <BUYERCODE>43562211</BUYERCODE>
        <BRANCHCODE>442AA1</BRANCHCODE>
        <DELIVERYPLACE>9101010101042</DELIVERYPLACE>
        <FINALRECIPIENT>9101010101042</FINALRECIPIENT>
        <ORDERPARTNER>9101010101042</ORDERPARTNER>
        <INVOICEPARTNER>9101010101042</INVOICEPARTNER>
        <SENDER>9101010101042</SENDER>
        <RECIPIENT>9101010101035</RECIPIENT>
        <CONSIGNEE>9101010101035</CONSIGNEE>
        <RECIPIENTCODE>51112212</RECIPIENTCODE>
        <RECIPIENTNAME>Василій</RECIPIENTNAME>
        <INFO>текст</INFO>
        <DISCOUNTVALUE>10</DISCOUNTVALUE>
        <RECIPIENTCONTACTFACE>Іванов Сергій Миколайович</RECIPIENTCONTACTFACE>
        <RECIPIENTPHONE>+380955678484</RECIPIENTPHONE>
        <RECIPIENTCITY>Київ</RECIPIENTCITY>
        <RECIPIENTADRESS>вул.Чистяківська 40</RECIPIENTADRESS>
        <EDIINTERCHANGEID>test2</EDIINTERCHANGEID>
        <POSITION>
          <POSITIONNUMBER>1</POSITIONNUMBER>
          <PRODUCT>5903333337</PRODUCT>
          <PRODUCTIDSUPPLIER>8444400</PRODUCTIDSUPPLIER>
          <PRODUCTIDBUYER>1117444</PRODUCTIDBUYER>
          <BUYERPARTNUMBER>111</BUYERPARTNUMBER>
          <ORDEREDQUANTITY>2</ORDEREDQUANTITY>
          <QUANTITYOFCUINTU>11</QUANTITYOFCUINTU>
          <ORDERUNIT>PCE</ORDERUNIT>
          <QUANTITYOFPACKS>11</QUANTITYOFPACKS>
          <ORDERPRICE>30.210000</ORDERPRICE>
          <PRICEWITHVAT>36.25</PRICEWITHVAT>
          <AMOUNT>11111.00</AMOUNT>
          <AMOUNTWITHVAT>111111.00</AMOUNTWITHVAT>
          <VAT>20</VAT>
          <CLAIMEDDELIVERYDATE>2023-03-01</CLAIMEDDELIVERYDATE>
          <CLAIMEDDELIVERYTIME>20:20</CLAIMEDDELIVERYTIME>
          <DELIVERYPLACE>9864232377986</DELIVERYPLACE>
          <INFOCODED>4112121</INFOCODED>
          <MINIMUMORDERQUANTITY>11</MINIMUMORDERQUANTITY>
          <MAXIMUMORDERQUANTITY>111</MAXIMUMORDERQUANTITY>
          <PRODUCTIONCODE>47251</PRODUCTIONCODE>
          <POSITIONKGM>5</POSITIONKGM>
          <INFO>вільний текст</INFO>
          <COMPAIGNNUMBER>12457847334</COMPAIGNNUMBER>
          <EARLIESTDELIVERYDATE>2023-03-06</EARLIESTDELIVERYDATE>
          <LATESTDELIVERYDATE>2023-03-10</LATESTDELIVERYDATE>
          <LATESTDELIVERYTIME>20:20</LATESTDELIVERYTIME>
          <CONDITIONSTATUS>346</CONDITIONSTATUS>
          <PACKAGEID>1234689876</PACKAGEID>
          <CATEGORYNAME>ТОВ &quot;Геберит Трейдинг&quot;</CATEGORYNAME>
          <BRENDNAME>Kolo PL</BRENDNAME>
          <GROUPNAME>Kolo PL furniture</GROUPNAME>
          <NOVELTY>0</NOVELTY>
          <COUNTPIECESINBOX>1</COUNTPIECESINBOX>
          <COUNTBOXESINLAYER>3</COUNTBOXESINLAYER>
          <COUNTPERPALLET>4</COUNTPERPALLET>
          <WEIGHT>5.6</WEIGHT>
          <PALLETS>2</PALLETS>
          <COUNTRYORIGIN>20</COUNTRYORIGIN>
          <CALIBRE>30</CALIBRE>
          <PRICEWITHDISCOUNT>10.50</PRICEWITHDISCOUNT>
          <BOXESCOUNT>2</BOXESCOUNT>
          <CHARACTERISTIC>
            <SERVICEDESCRIPTION>Послуги з доставки товару</SERVICEDESCRIPTION>
            <DESCRIPTION>REKORD ШафкаУмивал60см, білий глянець</DESCRIPTION>
          </CHARACTERISTIC>
          <PACKING>
            <PACKINGTYPE>тип</PACKINGTYPE>
            <PACKINGQUANTITY>3</PACKINGQUANTITY>
            <PACKINGUNIT>20</PACKINGUNIT>
          </PACKING>
        </POSITION>
      </HEAD>
    </ORDER>