Формат XML

<?xml version="1.0" encoding="utf-8"?>
<kaspi_catalog date="string"
              xmlns="kaspiShopping"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="kaspiShopping http://kaspi.kz/kaspishopping.xsd">
   <company>CompanyName</company>
    <merchantid>CompanyID</merchantid>
    <offers>
        <offer sku="232130213">
            <model>iphone 5s white 32gb</model>
            <brand>Apple</brand>
            <availabilities>
                <availability available="yes" storeId="myFavoritePickupPoint1"/>
                <availability available="yes" storeId="myFavoritePickupPoint2"/>
            </availabilities>
            <price>6418</price>
        </offer>
        <offer sku="232130223">
            <model>iphone 6s white 32gb</model>
            <brand>Apple</brand>
            <availabilities>
                <availability available="yes" storeId="myFavoritePickupPoint1"/>
                <availability available="yes" storeId="myFavoritePickupPoint2"/>
            </availabilities>
            <cityprices>
            <cityprice cityId="750000000">193000</cityprice>
            <cityprice cityId="710000000">195000</cityprice>
            </cityprices>
        </offer>
    </offers>
</kaspi_catalog>

Требования к элементам:

В элементе <offers> содержится список товарных предложений магазинов. Каждое товарное предложение описывается отдельным элементом offer;
Атрибут sku элемента offer идентификатор товарного предложения. Атрибут может содержать только цифры и латинские буквы. Максимальная длина sku — 20 символов. Идентификатор предложения должен быть уникальным среди всех товарных предложений одного прайс-листа. Один из вариантов заполнения sku – артикул товара в системе Партнера.
Элемент <model> - Содержит в себе название товара (обязательный элемент)
Элемент <brand> – Производитель товара (необязательный)
Элемент <availabilities> - Пункты самовывоза товаров.
В атрибуте storeId элемента <availability> указывается уникальный идентификационный номер пункта самовывоза, в атрибуте available элемента <availability> указывается наличие товара: yes в случае наличия товара или его отсутствие no. Атрибуты указываются для каждого пункта отдельно. storeId пункта заполняется Партнером, но необходимо отдельно сообщить менеджеру соответствие storeId и адреса пункта самовывоза.
Элемент cityprices – Цена, включающая НДС, по которой данный товар можно приобрести в пунктах самовывоза определенного города. В атрибуте cityId элемента cityprice указывается id города в соответствии с таблицей приведенной ниже. Для каждого города атрибуты указываются отдельно. Доступны только те города, которые были указаны при регистрации Партнера и в которых возможна покупка на KaspiShopping; (Элемент cityprice используется если одни и те же товары имеют разные цены в разных городах)
Элемент <price> – цена, включающая НДС, по которой данный товар можно приобрести в пунктах самовывоза любого города. (Элемент price используется если товар имеет одинаковую цену во всех городах, или товар продается только в одном городе).

Требования к формату цены:

Цена не должна содержать пробелов (разделителей)
Цена не должна содержать десятичных знаков
Цена не должна содержать посторонних символов (например знак тнг.)

Для настройки Автоматической загрузки:

Выложить сформированный XML в http/s сервер
Указать ссылку в кабинете продавца
Каждые 30 минут система будет загружать ваш прайс-лист, если в нём есть изменения

Прежде чем загружать подготовленный прайс-лист, рекомендуем вам проверить его на правильность структуры XSD

<?xml version="1.0" encoding="UTF-8"?>
<!-- edited with XMLSpy v2014 rel. 2 sp1 (x64) (http://www.altova.com) by Daniel Brodkorb (mgm technology partners gmbh) -->
<!-- W3C Schema generated by XMLSpy v2014 rel. 2 sp1 (x64) (http://www.altova.com) -->
<xs:schema xmlns="kaspiShopping" xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="kaspiShopping">
    <xs:element name="model" type="xs:string">
        <xs:annotation>
            <xs:documentation>Model name of the product, typically a good description describing the product unambiguously</xs:documentation>
        </xs:annotation>
    </xs:element>
    <xs:element name="offer">
        <xs:annotation>
            <xs:documentation>Attribute rownumber is only used for internal processing</xs:documentation>
        </xs:annotation>
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="model"/>
                <xs:element ref="brand" minOccurs="0" maxOccurs="1"/>
                <xs:element ref="availabilities" minOccurs="0"/>
                <xs:element ref="deliveryOptions" minOccurs="0"/>
                <xs:choice>
                    <xs:element ref="price"/>
                    <xs:element ref="cityprices"/>
                </xs:choice>
            </xs:sequence>
            <xs:attribute name="sku" type="xs:string" use="required"/>
            <xs:attribute name="rownumber" type="xs:unsignedLong" use="optional"/>
        </xs:complexType>
    </xs:element>
    <xs:element name="offers">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="offer" maxOccurs="unbounded"/>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <xs:element name="brand" type="xs:string"/>
    <xs:element name="company" type="xs:string"/>
    <xs:element name="merchantid" type="xs:string"/>
    <xs:element name="availability">
        <xs:complexType>
            <xs:attribute name="storeId" type="xs:string" use="required"/>
            <xs:attribute name="available" type="xs:string" use="required"/>
        </xs:complexType>
    </xs:element>
    <xs:element name="deliveryOption">
        <xs:complexType>
            <xs:attribute name="city" type="xs:string" use="required"/>
            <xs:attribute name="priceToDoor" type="xs:unsignedLong" use="optional"/>
            <xs:attribute name="priceToPP" type="xs:unsignedLong" use="optional"/>
            <xs:attribute name="timeToDoor" type="xs:unsignedLong" use="optional"/>
            <xs:attribute name="timeToPP" type="xs:unsignedLong" use="optional"/>
        </xs:complexType>
    </xs:element>
    <xs:element name="kaspi_catalog">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="company"/>
                <xs:element ref="merchantid"/>
                <xs:element ref="offers"/>
            </xs:sequence>
            <xs:attribute name="date" type="xs:string" use="required"/>
        </xs:complexType>
    </xs:element>
    <xs:element name="availabilities">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="availability" maxOccurs="unbounded"/>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <xs:element name="deliveryOptions">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="deliveryOption" maxOccurs="unbounded"/>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <xs:element name="price">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_price">
                    <xs:attribute name="oldprice" type="xs:unsignedLong" use="optional" />
                </xs:extension>
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <xs:element name="cityprices">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="cityprice" maxOccurs="unbounded"/>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <xs:element name="cityprice">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_price">
                    <xs:attribute name="cityId" type="xs:string" use="required"/>
                    <xs:attribute name="oldprice" type="xs:unsignedLong" use="optional"/>
                </xs:extension>
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <xs:simpleType name="ST_price">
        <xs:restriction base="xs:unsignedLong"/>
    </xs:simpleType>
</xs:schema>

Символы используемые в XML

Следующие символы в текстовых данных (например, название Товара) должны быть заменены на эквивалентные им коды:

Символ в тексте	Код для XML-файла
"	&quot
&	&amp
>	&gt
<	&lt
'	&apos

Файл должен быть предоставлен в кодировке UTF-8.

Коды городов

ID	City_KAZ	City_RUS
471010000	Ақтау қ.	г. Актау
151010000	Ақтөбе қ.	г. Актобе
750000000	Алматы қ.	г. Алматы
511610000	Арыс қ.	г. Арысь
710000000	Астана қ.	г. Астана
231010000	Атырау қ.	г. Атырау
351810000	Жезқазған қ.	г. Жезказган
351010000	Қарағанды қ.	г. Караганда
195220100	Қаскелең қ.	г. Каскелен
191610000	Қапшағай қ.	г. Капшагай
111010000	Көкшетау қ.	г. Кокшетау
314851205	Қордай а.	с. Кордай
391010000	Қостанай қ.	г. Костанай
233620100	Құлсары қ.	г. Кульсары
431010000	Қызылорда қ.	г. Кызылорда
551010000	Павлодар қ.	г. Павлодар
591010000	Петропавл қ.	г. Петропавловск
392410000	Рудный қ.	г. Рудный
352310000	Сәтбаев қ.	г. Сатпаев
632810000	Семей қ.	г. Семей
196220100	Талғар қ.	г. Талгар
191010000	Талдықорған қ.	г. Талдыкорган
311010000	Тараз қ.	г. Тараз
352410000	Теміртау қ.	г. Темиртау
271010000	Орал қ.	г. Уральск
631010000	Өскемен қ.	г. Усть-Каменогорск
511010000	Шымкент қ.	г. Шымкент
552210000	Екібастұз қ.	г. Экибастуз
194020100	Есік қ.	г. Есик
512610000	Түркістан қ.	г. Туркестан
117020100	Щучинск қ.	г. Щучинск
471810000	Жаңаөзен қ.	г. Жанаозен
515420100	Сарыағаш қ.	г. Сарыагаш
352810000	Шахтинск қ.	г. Шахтинск
117055900	Шиелі қ.	г. Шиели
273620100	Ақсай қ.	г. Аксай
514420100	Жетісай қ.	г. Жетысай
351610000	Балхаш қ.	г. Балхаш
551610000	Ақсу қ.	г. Аксу
433220100	Арал қ.	г. Аральск
431910000	Байқоңыр қ.	г. Байконыр
473630100	Бейнеу қ.	г. Бейнеу
195620100	Жаркент қ.	г. Жаркент
634620100	Зайсан қ.	г. Зайсан
316220100	Қаратау қ.	г. Каратау
612010000	Кентау қ.	г. Кентау
314851205	Қордай қ.	г. Кордай
392010000	Лисаковск қ.	г. Лисаковск
352210000	Сарань қ.	г. Сарань
111810000	Степногорск қ.	г. Степногорск
192610000	Текелі қ.	г. Текели
616420100	Шардара қ.	г. Шардара
316621100	Шу қ.	г. Шу
156420100	Риддер қ.	г. Риддер
634820100	Алтай қ.	г. Алтай
271035100	Зашаған а.	с. Зачаганск
153220100	Алға а.	с. Алга
156020100	Хромтау қ.	г. Хромтау
391610000	Арқалық қ.	г. Аркалык
395430100	Тобыл а.	п. Тобыл
554230100	Железинка а.	п. Железинка
394420100	Жітіқара қ.	г. Житикара
116651100	Қосшы а.	с. Косшы
633420100	Аягөз қ.	г. Аягоз
634030100	Глубокое а.	п. Глубокое
632210000	Курчатов қ.	г. Курчатов
636820100	Шемонаиха қ.	г. Шемонаиха
353220100	Абай қ.	г. Абай
474630100	Шетпе а.	п. Шетпе
475220100	Форт-Шевченко қ.	г. Форт-Шевченко
474239100	Жетібай а.	п. Жетыбай
474230100	Құрық а.	п. Курык
113220100	Ақкөл қ.	г. Акколь

Page tree

XML

Формат XML

Требования к элементам:

Требования к формату цены:

Для настройки Автоматической загрузки:

Символы используемые в XML

Коды городов