|
|
Жеке кабинетте API XML арқылы сауда ұсыныстарын жүктеу үшін мәзірінің «Тауарлар» бөлімінде «Бағаларды автоматты түрде жүктеу» өту қажет.
Автоматты түрде жүктеу беті ашылады, онда Сіз XML форматындағы бағатізбеге сілтеме көрсетуіңіз керек. Қажетті болған жағдайда Логин және құпия сөзді орнату қажет.
НАЗАР аударыңыз! Файл пішімі үйлесімді Kaspi.kz.
Тауарлар бойынша бағалар анықтамалығын жаңарту API үшін XML құрылымы
|
№
|
Параметр
|
Атрибут
|
Описание
|
|
1
|
company
|
|
Ұйымның атауы
|
|
2
|
merchantid
|
|
Ұйымның БСН немесе ЖСН, егер ЖК болса
|
|
3
|
offers
|
|
Әрқайсысы offer объектісімен сипатталатын дүкеннің сауда ұсыныстарының массиві бар элемент
|
|
4
|
offer
|
|
Элемент тауарға арналған сауда ұсынысының сипаттамасын қамтиды
|
|
5
|
|
sku
|
Offer элементінің атрибуты. Жеткізушідегі тауар артикулы. Мақала мәнінің ұзындығы 25 таңбадан аспауы керек. Мақала мәндері бір баға тізімінде ерекше болуы керек.
|
|
6
|
model
|
|
Элемент жеткізуші каталогынан өнім моделінің атауын қамтиды
|
|
7
|
brand
|
|
Элемент тауар өндірушінің атауын қамтиды
|
|
8
|
availabilities
|
|
Элемент сату нүктелерінің массивін қамтиды
|
|
9
|
|
availability
|
Аvailabilities элементінің атрибуты. Сату нүктесінде тауар болған кезде «yes» мәнін қабылдайды, сату нүктесінде тауар болмаған кезде «no»мәнін қабылдайды
|
|
10
|
|
storeid
|
Сату нүктесінің бірегей идентификаторы бар availabilities элементінің атрибуты. Storeid орнату ұйымның профилінде «Филиалдар»мәзірінде жүзеге асырылады, идентификатор мәтінінде бірегей нөмір қосылған «POS» белгісі қолданылады.
|
|
11
|
price
|
|
Егер өнім беруші ҚҚС төлеуші болып табылса, Элемент ҚҚС-мен тауар бірлігінің бағасын не егер өнім беруші ҚҚС төлеуші болмаса, ҚҚС-ты есепке алмағанда, тауар бірлігі үшін бағаны қамтиды
|
*Барлық бағалар теңгемен көрсетіледі. Баға нақты сан болған жағдайда, онда бүтін және бөлшек бөлік арасындағы бөлгіш ретінде "нүкте" қолданылады (Мәселен, 250.42).
Сұраным үлгісі
URL: https://monitor.a7.kz/test.xml
Сұраным түрі - POST
Тақырыптары (Headers):
Content-Type: application/xml
authorization-token: <пайдаланушының бейініндегі токені>
Сұраным қалпы
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
|
<kaspi_catalog xmlns="kaspiShopping" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" date="string" xsi:schemaLocation="kaspiShopping http://kaspi.kz/kaspishopping.xsd">
<company>Kinderville</company>
<merchantid>Kinderville</merchantid>
<offers>
<offer sku="уцвашйоцущ">
<model>Губка для доски Silwerhof "Classic" магнитная, зеленая</model>
<brand>Silwerhof</brand>
<availabilities>
<availability available="yes" storeId="POS56521"/>
<availability available="no" storeId="POS56946"/>
<availability available="no" storeId="POS56964"/>
<availability available="no" storeId="POS56965"/>
<availability available="no" storeId="POS56969"/>
<availability available="no" storeId="POS59590"/>
<availability available="no" storeId="POS59593"/>
<availability available="no" storeId="POS59637"/>
<availability available="no" storeId="POS59638"/>
<availability available="no" storeId="POS59641"/>
<availability available="no" storeId="POS59645"/>
<availability available="no" storeId="POS59646"/>
</availabilities>
<price>336</price>
</offer>
<offer sku="акршугргшк">
<model>Магниты InФормат, диаметр 30 мм, 6 шт в наборе, коробка</model>
<brand>InФормат</brand>
<availabilities>
<availability available="yes" storeId="POS56521"/>
<availability available="no" storeId="POS56946"/>
<availability available="no" storeId="POS56964"/>
<availability available="no" storeId="POS56965"/>
<availability available="yes" storeId="POS56969"/>
<availability available="no" storeId="POS59590"/>
<availability available="no" storeId="POS59593"/>
<availability available="yes" storeId="POS59637"/>
<availability available="no" storeId="POS59638"/>
<availability available="no" storeId="POS59641"/>
<availability available="yes" storeId="POS59645"/>
<availability available="no" storeId="POS59646"/>
</availabilities>
<price>1,12</price>
</offer>
|
Бағалар анықтамалығын жүктеу барысындағы өңдеушінің әрекеті
|
Өңдеу тәртібінің нөмірі
|
Әрекеттің сипаттамасы
|
|
Өңдеу тәртібінің нөмірі
|
Әрекеттің сипаттамасы
|
|
1
|
Егер sku төлсипатының бірдей мәні бар бірнеше <offer> элементтері табылса, мұндай жағдайда прайс - парақты жүктеу қатесі болады
|
|
2
|
Элементтердің болуы және толтырылуы міндетті <brand>, <model > әйтпесе барлық <offer> өңдеушімен ескерілмейді
|
|
3
|
Әрбір <offer> элементін өңдеу кезінде ең алдымен кірістірілген <price>элементін іздеу керек. Егер мұндай элемент табылса, оның мазмұнын өңдеу басталады.
|
|
4
|
<Availabilities> элементінің болуы және оның толықтығы міндетті түрде тексеріледі. Ол болмаған жағдайда, барлық < price > өңдегішті елемейді.
|
|
5
|
Егер <availability> элементіндегі storeId төлсипаты бос немесе дұрыс емес мәнге ие болса ,онда берілген < availability > элементін өңдеуші толығымен елемейді.
|
|
5.1
|
Егер <availability> элементінен availability төлсипаты табылмаса немесе "yes", "no" - дан бос немесе басқа мәнге ие болса, онда берілген <availability> өңдеушімен толығымен еленбейді
|
HTTP жауаптарының мәртебелері:
|
№
|
Мәртебе нөмірі
|
Сипаттамасы
|
|
1
|
201
|
Бағалар анықтамалығы жүйемен сәтті қабылданып, өңдеуге қойылды
|
|
|
|
|