Формат 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>


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

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

Коды городов


IDCity_KAZCity_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Ақкөл қ.г. Акколь
  • No labels