Экспорт заказов с сайта - XML файл

На данной странице описана структура содержимого XML файла, использующегося для экспорта заказов с сайта на платформе komiz.io в систему бухгалтерского учета, например «1C».

Ниже приведен сокращенный пример файла имеющего описываемый формат (полный пример приведен далее).

<?xml version="1.0" encoding="utf-8"?>
<orders amount="2" sessionId="1234567890">   <!-- Содержит теги заказов -->
    <order code="12345678">                  <!-- Содержит информацию об одном заказе -->
        <time>2014-12-31 08:32:59</time>     <!-- Одно из полей заказа -->
        ...
        <offers amount="3">                  <!-- Содержит теги товаров в заказе -->
            <offer article="art1" asId="">           <!-- Содержит информацию об одном товаре в заказе -->
                <title>Товар1</title>        <!-- Одно из полей товара в заказе -->
                ...
            </offer>
            <offer article="art2" asId="">
                ...
            </offer>
            <offer article="art3" asId="">
                ...
            </offer>
        </offers>
    </order>
    <order code="87654321">
        ...
    </order>
</orders>

Символом «троеточие» обозначены участки файла, которые в действительном файле заполнены, но в примере выше упущены с целью улучшения понимания общего принципа организации файла.

Данные в файле содержатся в кодировке UTF-8.

Ниже перечислены основные особенности структуры файла.

• Коренным тегом XML документа является orders. Он является контейнером списка заказов, каждому из которых соответствует дочерний тег order.
• Тег order в дочерних тегах и атрибутах содержит информацию о самом заказе, а также информацию о товарах в данном
• Тег offers (который находится в теге order) содержит информацию о товарах в текущем заказе
• Информация о каждом товаре в заказе заключена в тег offer являющимся дочерним для offers
• Каждой «сущности» в системе соответствует ее «уникальный идентификатор». Для заказа - это «код заказа» (содержится в атрибуте code тега order); для товара - это «артикул» (содержится в атрибуте article тега offer).

ОБРАТИТЕ ВНИМАНИЕ! Все теги (и их атрибуты) обязательно присутствуют в файле (в рамках своего контекста, т.е. родительского тега). Но также нужно учесть, что количество повторяемых тегов варьируется относительно количества отображаемых ими «сущностей». Например, количество тегов order равно количеству заказов в данном файле (т.е. может быть равным нулю). А, например, количество тегов offer равно количеству товаров в конкретном заказе (т.е. может быть равно нулю).

Ниже приведен перечень всех XML тегов, используемых в описываемом файле, с указанием инструкций по их использованию. Теги перечислены в алфавитном порядке.

<?xml version="1.0" encoding="utf-8"?>
<orders amount="1" sessionId="5782325740">
    <order code="2145386259">
        <status>test</status>
        <payStatus>Оплачен</payStatus>
        <deliveryStatus>Получен</deliveryStatus>
        <time>2016-08-03 20:11:35</time>
        <time_unixtime>1470244295</time_unixtime>
        <orderPriceAll>20.10</orderPriceAll>
        <orderPriceResult>20.10</orderPriceResult>
        <orderPrice>22.33</orderPrice>
        <discount>10.00</discount>
        <userDiscount>0.00</userDiscount>
        <userId>7035</userId>
        <userAsId></userAsId>
        <telephone>011111111, 02222222</telephone>
        <email>[email protected]</email>
        <lastName>Иванов</lastName>
        <firstName>Петр</firstName>
        <middleName>Николаевич</middleName>
        <userComment></userComment>
        <adminComment>Клиент хочет, чтобы заказ доставили с 16:00 до 17:00 по указанному адресу</adminComment>
        <country>Австрия</country>
        <city>Вена</city>
        <cityId>12345-12345-122345-112414</cityId>
        <warehouseId>98764-95634-9575435-4444</warehouseId>
        <deliveryType>Транспортной компанией Австрия-Экспресс</deliveryType>
        <payType>Налично при получении заказа</payType>
        <orderDeliveryPrice>0.00</orderDeliveryPrice>
        <orderDeliveryPriceName></orderDeliveryPriceName>
        <dateSend>2018-02-16</dateSend>
        <dateDelivery>2018-02-17</dateDelivery>
        <deliveryServiceCode></deliveryServiceCode>
        <storeAddress></storeAddress>
        <additionalReceiver></additionalReceiver>
        <postIndex>123123</postIndex>
        <region></region>
        <district></district>
        <street>Лесная</street>
        <building>8</building>
        <bulk></bulk>
        <apartment>9</apartment>
        <offers amount="1">
            <offer article="35130944" asId="" action="0">
                <offerId>5325</offerId>
                <amount>1</amount>
                <code>5325-6261</code>
                <title>Видеопроектор BIG VP2000</title>
                <size></size>
                <color></color>
                <material></material>
                <weight>0</weight>
                <price>22.33</price>
                <priceAll>22.33</priceAll>
                <priceResult>20.10</priceResult>
                <priceResultAll>20.10</priceResultAll>
            </offer>
        </offers>
    </order>
</orders>