Формат 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-файла |
---|---|
" | " |
& | & |
> | > |
< | < |
' | &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 | Ақкөл қ. | г. Акколь |
515820100 | Леңгір қ. | г. Ленгер |
195020100 | Үштөбе қ. | г. Уштобе |
154820100 | Қандыағаш қ. | г. Кандыагаш |
194230100 | Ұзынағаш а. | с. Узынагаш |
515230100 | Ақсукент қ. | с. Аксукент |