WEB3смарт-келісімшарттар / dApp / активтерді токендеуWeb3 әзірлеу →

Kaspi Магазинді 1С-пен интеграциялау: прайс, қалдық және тапсырыс қолмен енгізусіз

Kaspi Магазин мен 1С алмасуы қалай жұмыс істейді: баға мен қалдығы бар XML прайс-лист, тапсырыс API-і, артикулдар, қоймалар, жиі қателер және іске қосу реті.

Тауар каталогы ашылған ноутбук және жаңа тапсырыстары бар телефон: Kaspi дүкені мен есеп жүйесінің алмасуы

Kaspi.kz-те сатсаңыз және есепті 1С-те жүргізсеңіз, ерте ме, кеш пе командада біреу екі терезенің арасында жүре бастайды. Таңертең жаңа тапсырыстарды сатушы кабинетінен 1С-ке көшіреді, түсте Excel-де бағаны түзетіп, прайс-листті жүктейді, кешке соңғы тауар дүкенде сатылып кеткенін, ал Kaspi-де ол әлі «бар» болып тұрғанын есіне алады. Бір жердегі қате тапсырыстың күшін жоюға айналады, ал сатушының кінәсінен болған бас тартуларды Kaspi жұмыс сапасының көрсеткіштерінде есептейді.

Интеграция осы қолмен көшіруді алып тастайды. Бірақ «интеграция» деген сөздің астында екі түрлі нәрсе жатыр, және оларды шатастыру ақшаға түседі. Kaspi Магазин мен 1С алмасуы шын мәнінде қалай құрылғанын талдаймыз: прайс-лист арқылы не жүреді, API арқылы не жүреді, әдетте қай жерде бұзылады және мұны қандай ретпен іске қосу керек. Kaspi туралы деректер серіктестерге арналған Kaspi Гидінен алынды және 2026 жылғы 16 қарашада тексерілді.

Алмасудың бір емес, екі арнасы

Kaspi.kz Магазинінің есеп жүйеңізбен байланысатын екі тәуелсіз жолы бар, және олар әртүрлі бағытта жұмыс істейді.

Не беріледіАрнаБағыты
Баға, қалдық, қоймалар бойынша бар-жоғы, алдын ала тапсырысСілтеме арқылы XML прайс-лист1С-тен Kaspi-ге
Жаңа тапсырыстар, құрамы, қойма, мәртебелерСатушы API-іKaspi-ден 1С-ке, мәртебелер кері
Жаңа тауар карточкалары, штрихкодтарТауарлар API-іЖүйеңізден Kaspi-ге

Kaspi өз гидінде қалдықты есеп жүйесінен дәл прайс-лист арқылы беруді ұсынады: есеп жүйесі XML файлды серверіңізге шығарады, ал оның сілтемесін кабинетте көрсетесіз (қалдық туралы бөлім). Тапсырыстар мен олардың мәртебелері сатушы API-і арқылы жүреді. Дүкенді біріктіруге болатын жүйелер ішінде Kaspi 1С-ті тікелей атайды (API туралы жалпы сұрақтар).

Осыдан бірінші ереже шығады: 1С пен Kaspi байланысы бір батырма емес, екі міндет. Каталогты шығару және тапсырыстарды қабылдау.

Прайс-лист: баға мен қалдық 1С-тен Kaspi-ге қалай кетеді

Прайс-лист екі форматта болады. Excel деректерді қолмен жүктеуге жарайды: файл өңделеді, каталог 15 минут ішінде жаңарады. Бірақ қалалар бойынша баға не алдын ала тапсырыс мерзімі әртүрлі болса, қойма бестен көп болса немесе қоймалар PP1-PP5 деп аталмаса, Excel қолжетімсіз. Деректер өздігінен жаңарып тұруы үшін XML керек.

Автоматты жүктеу былай құрылған:

  1. 1С кесте бойынша тауарлар, баға мен қалдығы бар XML файл жасайды. Kaspi мұндай файлды 1С-те жасауға болатынын тікелей жазады.
  2. Файл серверіңізде жатады және http не https сілтемесі арқылы ашылады.
  3. Сатушы кабинетінің веб-нұсқасында сілтеме тауарлар бөліміндегі прайс-листті автоматты жүктеу баптауына қойылады.
  4. Файлда өзгеріс болса, Kaspi оны әр 60 минут сайын алып отырады.

Әр тауар бойынша файлда не болады:

  • артикул (sku): тек сандар мен латын әріптері, 20 таңбаға дейін, прайс-лист ішінде қайталанбайды;
  • атауы (model) және бренді (brand);
  • қоймалар бойынша бар-жоғы: кабинеттегі қоймалар мен дүкендер бөлімінен алынатын қойма коды (storeId), тауар бар ма, жоқ па, қоймадағы саны (stockCount) және күнмен алдын ала тапсырыс мерзімі, 30 күннен аспайды;
  • барлық қалаға ортақ бір баға (price) немесе қала кодымен қалалар бойынша баға (cityprices).

Қалалар бойынша баға мен қоймаларға әртүрлі алдын ала тапсырыс мерзімін тек XML-де беруге болады, және тек қоймалар әртүрлі қалада тұрса. Бір қаладағы қоймаларға бірыңғай баға мен мерзім қойылады.

Әдетте тым кеш білетін екі жайт бар. Тауарды бұрын қолмен қосқан болсаңыз, оны прайс-листке енгізу керек, әйтпесе ол сатылымнан алынады. Ал файлдағы әлі сатылымда жоқ тауарлар танылмаған, байланыссыз тауарлар тізіміне түседі, оларды сатылымға өзіңіз қоясыз. Толығырақ прайс-лист туралы бөлімде.

Артикул мен қойма: бәрін сәйкестендіру шешеді

XML файлды 1С-тен техникалық тұрғыда жасау қиын емес. Қиыны 1С-тегі қай тауар Kaspi-дегі қай карточкаға сәйкес келетінін келісу. Өз бетімен жасалған шығарулардың көбі осыдан сүрінеді.

  • 1С-тегі тауар коды Kaspi артикулына әрдайым жарамайды. 1С-те кирилл әріптері, сызықшалар, ұзын кодтар кездеседі. Kaspi артикулы латын әріптері мен сандардан тұрады және 20 таңбадан аспайды, сондықтан жиі бөлек реквизит не сәйкестік кестесін ашамыз.
  • Өлшем мен түс. 1С-те бұл сипаттамалары бар бір тауар, ал Kaspi-де бөлек позициялар болса, әр сипаттамаға өз артикулы керек.
  • Қоймалар. Kaspi-де сататын 1С-тің әр қоймасына кабинеттегі нүкте коды сәйкестендіріледі. Байланысқа кірмеген қойма Kaspi-де көрінбейді.
  • Баға түрі. 1С-тің қай баға түрі Kaspi-ге кететінін және қалалар бойынша баға керек пе екенін бөлек шешіңіз.

Сәйкестік кестесін 1С-те номенклатураны жүргізетін адаммен бір рет келіскен дұрыс. Кейін ассортименттің жартысы неге «танылмағанын» іздеу әлдеқайда қымбатқа түседі.

Тапсырыстар: сатушы API-і не береді

Сатушы API-і токенмен жұмыс істейді. Оны тек компания басшысы ала алады: сатушы кабинетінің веб-нұсқасында баптаулардағы «Токен API» бөлімінде токенді жасап, көшіреді. Токен өзгермейді, және ол кімде болса, сол кабинетіңіздегі тапсырыстар мен тауарларды көреді. Сондықтан токен мессенджерде жіберілмейді, байланыстың баптауларында сақталады (токенді қалай алу керек).

API арқылы байланыс:

  • тапсырыстар тізімін алады: күйі бойынша (жаңа, құжатқа қол қою керек, өзі алып кету, өз жеткізуіңіз, Kaspi Жеткізу, мұрағат) және жасалған күні бойынша сүзгімен, бір бетте 100 тапсырысқа дейін;
  • тапсырысты қабылдайды: оны APPROVED_BY_BANK («сатушы қабылдауы керек») мәртебесінен ACCEPTED_BY_MERCHANT мәртебесіне ауыстырады;
  • тапсырыс құрамын және сатып алушы тауарға тапсырыс берген қойманы алады;
  • Kaspi Жеткізуге тапсыру үшін жүкқұжат жасайды;
  • себебін көрсетіп тапсырыстың күшін жояды;
  • тапсырысты аяқтайды: COMPLETED мәртебесі сатып алушы Kaspi.kz қосымшасында алатын кодпен қойылады.

1С жағынан бұл былай көрінеді: Kaspi-ден келген жаңа тапсырыс 1С-те сатып алушысы, тауарлары және қоймасы бар тапсырыс құжаты болып пайда болады, менеджер оны үйреншікті интерфейсте жинайды, ал мәртебе Kaspi-ге кері кетеді. Маңыздысы: Kaspi ережелері тапсырыстарды сатушы кабинетінен тыс өңдеуге тыйым салады, API арқылы өңдеу бұған жатпайды (жұмыс ережелері). Яғни API арқылы байланыс қалыпты, рұқсат етілген жол, ал «тапсырысты кабинеттен Excel-ге, одан 1С-ке қайта теру» олай емес.

Тауарлар API-і де бар: ол арқылы жаңа тауарларды сатылымға қосады (артикул, атауы, бренді, санат коды, сипаттамасы, фото сілтемелері, қасиеттері), жүктеу нәтижесін тексереді және штрихкодтарды байлайды. Ассортимент үлкен әрі жиі өзгерсе, бұл тиімді. Жаңа позиция аз болса, карточкаларды кабинетте ашқан оңай.

Қалдық: әдетте қай жерде бұзылады

Сату мен жаңарту арасындағы кідіріс. Файл өзгерсе, Kaspi прайс-листті 60 минутта бір рет алады. Сол тауар дүкенде не сайтта да сатылса, осы бір сағатта соңғы дана екі рет кетуі мүмкін. Емі қор: соңғы даналарға қоймадағыдан азырақ шығарыңыз немесе позицияны алдын ала алып тастаңыз.

Бас тарту. Тапсырыстың күші жойылғанда қалдыққа не болатыны жеткізу тәсіліне байланысты (қалдық туралы бөлім). Өз жеткізуіңізде және өзі алып кетуде саны автоматты түрде жаңарады. Kaspi Жеткізуде тапсырыс жаңа, қол қоюда, алдын ала тапсырыста не қаптау кезеңінде болса, қалдық өзі қалпына келеді. Ал тапсырыс тапсыру кезеңінде болса не Kaspi Жеткізуге тапсырылып қойса, тауарды қабылдау пунктінен алып, қалдықты жаңарту керек. Байланыс 1С-те де дәл осыны көрсетуі тиіс, әйтпесе есеп пен витрина алшақтайды.

Қалдықты көрсету бәріне емес, бірақ көпшілікке міндетті. Kaspi.kz Магазиніне 2025 жылғы 21 қазаннан кейін қосылғандар немесе жұмыс сапасы көрсеткіштері «Плохо» (нашар) деңгейінде және одан төмен болғандар тауар санын көрсетуі керек. Қалғандары көрсетпеуі мүмкін, бірақ онда тауар біткенде оны сатылымнан өздері алады.

Рейтинг. Kaspi-де сатушы жұмысының сапасына талаптар бар: рейтинг 4 жұлдыздан бастап, сатушы кінәсінен бас тарту 3%-дан төмен, Kaspi Жеткізуге тапсырудағы кідіріс 10%-дан аз, сапа бойынша қайтару 2%-дан төмен. Бұзушылық үшін ынтымақтастықты толық тоқтатуға дейін шектеу қойылуы мүмкін (неге ажыратады). Қате қалдық ең алдымен бас тартуларға соғады, сондықтан дәл шығару ыңғайлылық қана емес, дүкенді қорғау.

Типтік модуль ме, әлде 1С-іңізге арналған байланыс па

Kaspi-мен алмасудың дайын модульдері 1С серіктестерінде бар, және бір қоймасы бар типтік конфигурацияға олар жиі жеткілікті. Өзіңізге арналған байланыс мына жағдайларда керек:

  • 1С конфигурациясы өзгертілген, модуль түзетусіз орнамайды;
  • қойма бірнешеу, қалалар бойынша баға әртүрлі, алдын ала тапсырыс керек;
  • Kaspi-ден бөлек өз сайтыңыз бар және қалдық ортақ болуы керек (1С-ті сайтпен қалай байланыстыруды 1С мен сайт интеграциясы туралы мақалада талдадық);
  • есеп тек 1С-те жүрмейді, мысалы қойма МойСклад жүйесінде, клиенттер CRM-де;
  • сатудан кейін құжаттарды жабу керек, мысалы ИС ЭСФ жүйесінде шот-фактура.

Қайда сату керегін енді таңдап жатсаңыз, арналарды талдаудан бастаңыз: Kaspi ме, әлде өз интернет-дүкеніңіз бе және Қазақстанда интернет-дүкенді қалай ашу керек. 1С барлық витринаның орталығы ретінде қалай жұмыс істейтіні 1С интеграциясы бетінде жазылған.

Байланысты қалай іске қосамыз

  1. Талдау. 1С конфигурациясын, қоймаларды, қалаларды, баға түрлерін және Kaspi тапсырыстары қазір қалай өңделетінін қараймыз.
  2. Сәйкестік кестесі. 1С-тің артикулдары, қоймалары мен қалалары Kaspi кодтарымен салыстырылады. Номенклатураны жүргізетін адаммен келісеміз.
  3. Прайс-лист. XML-ді кесте бойынша жасауды және сілтеме арқылы жариялауды баптаймыз, кабинеттегі жүктеуді тексереміз: не танылды, не танылмады.
  4. Тапсырыстар. API-ді токеніңізбен қосамыз, алдымен базаның көшірмесінде, кейін бақылаумен нақты тапсырыстарда тексереміз.
  5. Алмасу журналы. Қай тапсырыс не тауар өтпегені және неге екені көрініп тұрады, жауапты адам хабарлама алады.

Екі жүйенің типтік байланысы, мысалы Kaspi мен 1С, 270 000 ₸ бастап тұрады. Қойма мен витрина көп болса не 1С қатты өзгертілген болса, талдаудан кейін есептеп, бағасын шартта бекітеміз. Толығырақ 1С пен Kaspi интеграциясы қанша тұрады бетінде. Жасалған жұмысқа 6 ай кепілдік береміз, код пен қолжетімділік сізде қалады. 1С-тің ескі нұсқаларымен де жұмыс істейміз: Хоту-Ас жобасында адалдық қосымшасын 1С 7.7-мен байланыстырдық.

Қызмет туралы толығырақ

Осы тақырып бойынша не істейміз

Сұрақтар

Қысқа әрі нақты.

Kaspi 1С-тен баға мен қалдықты қаншалықты жиі жаңартады?

Автоматты жүктеуде Kaspi XML прайс-листті сілтемеңіз арқылы әр 60 минут сайын алады, егер файлда өзгеріс болса. Қолмен жүктелген Excel файл 15 минут ішінде өңделеді. Сондықтан тауардың соңғы даналарына қор қалдырған дұрыс.

Қалдықты Kaspi-ге API арқылы беруге бола ма?

Қалдықты есеп жүйесінен автоматты беру үшін Kaspi өз гидінде сілтеме арқылы XML прайс-листті ұсынады. Сатушы API-і арқылы тапсырыстар мен олардың мәртебелері жүреді, тауарлар API-і арқылы жаңа карточкалар қосылады.

Kaspi API токенін кім ала алады?

Тек компания басшысы: сатушы кабинетінің веб-нұсқасында, баптаулардағы «Токен API» бөлімінде. Токен өзгермейді және онымен кабинеттің тапсырыстары мен тауарлары көрінеді, сондықтан оны тек техникалық маманға беріңіз.

Kaspi Магазинді 1С-пен интеграциялау қанша тұрады?

Екі жүйенің типтік байланысы 270 000 ₸ бастап. Қойма, қала не витрина көп болса, 1С конфигурациясын талдағаннан кейін есептеп, бағасын шартта бекітеміз.

Өз байланысының орнына дайын модуль жарай ма?

Типтік 1С конфигурациясы мен бір қойма үшін жиі жарайды. Өз байланысы 1С өзгертілген болса, қойма мен қала бірнешеу болса немесе Kaspi-ден бөлек ортақ қалдығы бар сайт пен CRM болса керек.

Тағы оқыңыз

Жобаңызды талқылайық па?

Қанша тұратынын және қанша уақыт алатынын айтамыз. Баға шартта бекітіледі.

Сіздің таңдауыңызKaspi дүкені270 000 ₸ бастап
Өтінімді команда алады, жұмыс уақытында жауап береміз.Баға төлемге дейін шартта бекітіледі.Өзіңіз сұрамасаңыз, қоңырау шалмаймыз.
Баға есебіне өтінім
Жоба бюджеті
Өтінім командаға түседі. Поштамен жауап береміз, жарнамалық қоңырау шалмаймыз.

Міндет бар ма? Бізге жазыңыз.

Жобаны WhatsApp немесе пошта арқылы сипаттаңыз. Жұмыс уақытында жауап беріп, брифтен кейін бағасын айтамыз.