• Жеке кабинетте 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

    Бағалар анықтамалығы жүйемен сәтті қабылданып, өңдеуге қойылды