МойСклад жүйесінің B2B-порталмен интеграциясы: API, вебхуктар және қандай деректер беріледі
Мазмұны
- МойСклад интеграция үшін қандай мүмкіндіктер береді
- Қандай деректер беріледі
- Тұрақты сұрау жіберудің орнына вебхуктер
- API лимиттері
- Дилерлердің жеке бағалары мен шарттары
- Қалдықтар
- Порталдан МойСклад жүйесіне тапсырыс
- Битрикс24 және 1С жүйелерімен байланыс
- Мерзімдер
- МойСклад интеграцияларындағы жиі кездесетін қателер
- Жиі қойылатын сұрақтар
МойСклад жүйесін күрделі инфрақұрылымсыз бұлтта тауар есебін жүргізгісі келетін компаниялар таңдайды. Оның API интерфейсі ашық, сондықтан оған B2B-порталды қосу жабық жергілікті дерекқорға қосқаннан әлдеқайда оңай. Алайда «оңай» деген «оп-оңай» дегенді білдірмейді: API шектеулері, вебхуктердің өзіндік ерекшеліктері, ал көтерме сауда логикасының МойСклад жүйесінде болмауы мүмкін өз талаптары бар.
Интеграцияның қалай жұмыс істейтінін, қандай деректер берілетінін және оның сенімділігін қалай қамтамасыз етуге болатынын қарастырайық.
МойСклад интеграция үшін қандай мүмкіндіктер береді
- Тауарлармен, модификациялармен, контрагенттермен, тапсырыстармен, құжаттармен, қоймалармен және есептермен жұмыс істеуге арналған JSON API;
- вебхуктер: МойСклад сыртқы жүйеге объектілердің жасалғаны, өзгертілгені немесе жойылғаны туралы өзі хабарлайды;
- қоймалардағы қалдықтар туралы есептер;
- Жекелеген контрагенттерге арналған шарттарды қоса алғанда, баға түрлері мен жеңілдіктер;
- құжаттардың баспа нысандары.
Объектілердің, параметрлер мен шектеулердің өзекті тізімі МойСклад API ресми құжаттамасында сипатталған. Жобалау алдында оның ағымдағы нұсқасын тексерген жөн.
Қандай деректер беріледі
| Деректер | Бағыт | Механизм |
|---|---|---|
| Тауарлар, модификациялар, жиынтықтар | МойСклад → портал | API, өзгерістерге арналған вебхуктер |
| Тауар топтары мен сипаттамалары | МойСклад → портал | API |
| Баға түрлері мен жеңілдіктер | МойСклад → портал | API |
| Қоймалардағы қалдықтар | МойСклад → портал | кесте бойынша және өзгерістер болған кезде жасалатын қалдықтар туралы есеп |
| Контрагенттер мен шарттар | МойСклад ↔ портал | API, вебхуктер |
| Сатып алушылардың тапсырыстары | портал → МойСклад | API |
| Тапсырыс мәртебелері | МойСклад → портал | вебхуктер |
| Тауарды жөнелту құжаттары, шоттар | МойСклад → портал | API, баспа нысандары |
Тұрақты сұрау жіберудің орнына вебхуктер
Вебхуктер болмаса, портал МойСклад жүйесіне «не өзгерді?» деп тұрақты түрде сұрау жіберуге мәжбүр болады. Бұл API лимиттерін жұмсап, кідіріске әкеледі. Ал вебхуктер арқылы МойСклад хабарламаны өзі жібереді, портал тек өзгерген объектіні алады.
Ескеру қажет ерекшеліктер:
- хабарлама қайта келуі немесе мүлде келмеуі мүмкін, сондықтан қайталанудан қорғау және деректерді мерзімді салыстырып тексеру қажет;
- хабарлама өзгеріс болғанын хабарлайды, ал деректерді бөлек сұрату керек;
- вебхук өңдеушісі үнемі қолжетімді болып, жылдам жауап беруі керек, ал көп уақыт алатын өңдеуді фондық режимде орындауы тиіс.
API лимиттері
МойСклад API интерфейсінде белгілі бір кезеңдегі сұраулар санына және параллель сұрауларға шектеулер бар. Бір аккаунттың барлық интеграциясы ортақ лимитті пайдаланады. Сондықтан:
- портал пайдаланушының әр әрекеті кезінде МойСклад жүйесіне сұрау жібермеуі керек, ол деректердің өз көшірмесімен жұмыс істейді;
- каталогты толық жүктеп алу тек бастапқы жүктеу мен салыстырып тексеру кезінде қажет;
- сұрауларға басымдық беріледі: тапсырыс жасау сипаттамаларды жаңартудан маңыздырақ;
- лимиттен асу қатесі пайда болса, сұрау үзілістен кейін қайталанады.
Бұл шектеулерді жеке мақалада егжей-тегжейлі қарастырамыз.
Дилерлердің жеке бағалары мен шарттары
МойСклад жүйесінде контрагенттерге арналған баға түрлері мен жеңілдік тетіктері бар. Портал үшін мыналар маңызды:
- әр дилерге қандай баға түрі мен жеңілдіктер қолданылатынын анықтау;
- порталда бағаны сол ережелер бойынша есептеу немесе қорытынды соманы МойСклад жүйесінен алу;
- іске қосу алдында нақты тапсырыстарда нәтижелердің сәйкестігін тексеру.
Егер ережелер МойСклад мүмкіндіктерінен күрделірек болса (мысалы, келісуді қажет ететін кредиттік лимиттер немесе көп деңгейлі бонустар), бұл логиканы порталда немесе интеграциялық қабатта іске асырады.
Қалдықтар
Қоймалардағы қалдықтар туралы мәліметтер есептерден алынады. Портал үшін әдетте мыналар қажет:
- резервтерді ескере отырып, қолжетімді қалдықты көрсету;
- тек дилерлерге тауар жөнелтілетін қоймаларды есепке алу;
- деректерді жиі, бірақ API лимиттері шегінде жаңарту;
- тапшы тауарлардың қалдығын тапсырыс жіберілген сәтте тексеру.
Порталдан МойСклад жүйесіне тапсырыс
- Портал сатып алушының тапсырысын контрагентке, шартқа және қоймаға байланыстырып жасайды.
- Қайталанған операция телнұсқа жасамауы үшін әр операцияға бірегей кілт беріледі.
- МойСклад тауарды өз ережелері бойынша резервке қояды.
- Тапсырыс мәртебелері порталға вебхуктер арқылы қайтарылады.
- Жөнелту құжаттары мен шоттар дилерге кабинетте қолжетімді болады.
- Күнделікті салыстырып тексеру порталдағы барлық тапсырыстардың МойСклад жүйесінде дұрыс сомалармен бар екенін анықтайды.
Битрикс24 және 1С жүйелерімен байланыс
- Битрикс24: порталдан келген тапсырыс менеджер үшін оқиға немесе мәміле жасайды, МойСклад жүйесіндегі мәртебелер CRM жүйесін жаңартады.
- 1С:Бухгалтерия: МойСклад жүйесіндегі құжаттар бухгалтерияға беріледі, ал дилер кабинеті үшін өзара есеп айырысу деректері 1С жүйесінен алынады.
Егер жүйе саны екіден көп болса, әрқайсысын бір-бірімен байланыстырудың орнына, барлық алмасуды бір интеграциялық қабат арқылы жүргізген дұрыс.
Мерзімдер
| Кезең | Шамамен |
|---|---|
| Порталдағы каталог, бағалар, қалдықтар | бірнеше апта |
| Тапсырыстар мен мәртебелер | қосымша бірнеше апта |
| Құжаттар, лимиттер, рөлдер | 1-2 ай |
| Битрикс24 және 1С жүйелерімен байланыс | схемаға байланысты |
МойСклад интеграцияларындағы жиі кездесетін қателер
- портал бет ашылған сайын МойСклад жүйесінен бағалар мен қалдықтарды сұратып, лимиттерге тіреледі;
- вебхуктер синхронды өңделеді, өңдеуші жауап беріп үлгермейді де, хабарламалар жоғалады;
- салыстырып тексеру жүргізілмейді, соның салдарынан өткізіліп алған өзгерістер апталап жиналады;
- контрагенттер порталда да, МойСклад жүйесінде де бір-бірімен сәйкестендірілмей жасалады;
- бірнеше сервис аккаунтқа бір-бірінен тәуелсіз қосылып, өзара кедергі келтіреді.
Жиі қойылатын сұрақтар
МойСклад жүйесі мен сайтты байланыстыратын дайын модульдер бар ма?
Стандартты интернет-дүкендерге арналған дайын интеграциялар бар. Жеке бағалары, лимиттері және құжаттары бар дилерлік кабинет үшін әдетте арнайы интеграция қажет.
Тек вебхуктер арқылы жұмыс істеуге бола ма?
Жоқ, оған қоса деректерді жүйелі түрде салыстырып тексеру керек, өйткені кейбір хабарламалар жоғалуы мүмкін.
Интеграция қанша уақыт алады?
Каталог, бағалар, қалдықтар мен тапсырыстардың базалық алмасуы бірнеше апта алады. Құжаттар, лимиттер және CRM қамтылған толық жүйеге көбірек уақыт қажет.
Каталог өте үлкен болса ше?
Портал жағында деректердің жеке көшірмесі, өзгерістер бойынша жаңарту және лимиттерді ескеретін сұраулар жоспарлаушысы қажет.
Дилерге МойСклад жүйесіндегі құжаттарды көрсетуге бола ма?
Иә, портал API арқылы алып, кабинетте көрсететін құжаттардың баспа нысандары арқылы көрсетуге болады.
