API-інтэграцыя: ERP, CRM і інтэрнэт-магазін
API-інтэграцыя злучае інтэрнэт-магазін, ERP, CRM, плацяжы, кур’ераў і бухгалтарскія сістэмы, каб вам не даводзілася ўводзіць адны і тыя ж даныя паўторна. Пры выкарыстанні API адна сістэма адпраўляе запыт, а пры выкарыстанні webhook іншая адпраўляе апавяшчэнне, калі адбываецца падзея. Надзейная інтэграцыя пачынаецца з аднаго канкрэтнага працэсу і дакладных правілаў, якая сістэма з’яўляецца галоўнай для кожнага тыпу даных.

У чым розніца паміж API і webhook?
API, гэта ўзгоднены спосаб, з дапамогай якога адна сістэма запытвае або адпраўляе інфармацыю іншай. Інтэрнэт-магазін можа запытаць наяўнасць, адправіць заказ у ERP або праверыць статус адпраўлення. Сістэма, якой патрэбныя даныя, пачынае камунікацыю.
Webhook працуе ў адваротным кірунку. Калі адбываецца падзея, сістэма адпраўляе апавяшчэнне на загадзя вызначаны адрас. Напрыклад, плацежны аператар можа паведаміць вашаму праграмнаму забеспячэнню аб паспяховым плацяжы, а яно зменіць статус заказа і запусціць наступны крок.
| Механізм | Хто пачынае камунікацыю? | Прыдатны прыклад | Што трэба прадугледзець |
|---|---|---|---|
| API | Ваша сістэма адпраўляе запыт | Праверка наяўнасці або адпраўка заказа | Аўтэнтыфікацыя, абмежаванні колькасці запытаў і апрацоўка адказаў |
| Webhook | Сістэма, у якой адбылася падзея | Новы плацеж, заказ або змяненне статусу | Праверка подпісу, паўторная адпраўка і абарона ад дублявання |
Якія працэсы варта злучыць у першую чаргу?
Не пачынайце з жадання злучыць усё. Выберыце працэс, які часта паўтараецца, запавольвае каманду або стварае дарагія памылкі. Звычайна гэта рух заказа, кантакт з кліентам, складскія рэшткі або плацеж.
Інтэрнэт-магазін, склад і ERP
Пры новым заказе магазін адпраўляе ў ERP-сістэму даныя аб прадуктах, колькасці, кліенце і спосабе аплаты. ERP вяртае інфармацыю аб наяўнасці і статусе, а пры змяненні на складзе магазін атрымлівае абноўленыя колькасці. Так зніжаецца рызыка прадаць тавар, якога ўжо няма ў наяўнасці.
Перад распрацоўкай удакладніце, якая сістэма з’яўляецца галоўнай для цаны, наяўнасці, прадукту і кліента. Калі і магазін, і ERP могуць змяняць адно і тое ж значэнне без вызначанага правіла, інтэграцыя толькі хутчэй перанясе канфлікт.
Сайт, CRM і аддзел продажаў
Форма запыту на сайце можа стварыць ліда ў CRM з указаннем крыніцы, паслугі, тэлефона і паведамлення. Пасля гэтага сістэма можа стварыць задачу для менеджара па продажах, адправіць пацвярджэнне або накіраваць тэрміновы запыт канкрэтнаму супрацоўніку.
Найбольш частая праблема тут, не адсутнасць API, а няяснае вызначэнне ліда. Трэба ведаць, калі ствараецца новы кантакт, што адбываецца пры паўторным запыце і хто атрымлівае задачу. Інакш вы атрымаеце дублікаты кліентаў і нераўнамерна размеркаваныя запыты. Калі працэс у CRM мае спецыфічныя патрабаванні, CRM-сістэма на заказ дазваляе закласці гэтыя правілы непасрэдна ў сістэму.
Плацяжы, выстаўленне рахункаў і апавяшчэнні
Паспяховы плацеж можа змяніць статус заказа на «аплачаны», адправіць даныя ў ERP і запусціць стварэнне рахунка-фактуры. Важна, каб рахунак-фактура не ствараўся паўторна, калі плацежны аператар адправіць адно і тое ж апавяшчэнне больш за адзін раз.
Сайт, CRM і тэлефанія
Пры ўваходным званку тэлефонная сістэма можа перадаць нумар у CRM, каб адкрылася картка кліента. Пасля размовы запісваюцца вынік, задача або нататка. Гэта карысна, калі аддзелы продажаў і абслугоўвання працуюць з вялікай колькасцю ўваходных запытаў.
Як выглядае інтэграцыя ў рэальнай бізнес-сістэме?
Пры LiftexPro, ERP для ліфтавых кампаній розныя аперацыі з'яўляюцца часткамі адзінага працэсу: планаванне аглядаў, кіраванне будынкамі, праца тэхнікаў і аўтаматычнае выстаўленне рахункаў. Такая сістэма паказвае, чаму інтэграцыя, гэта не проста перадача палёў паміж дзвюма праграмамі. Трэба ведаць, што адбываецца пасля кожнага статусу і хто мае права яго змяніць.
Напрыклад, для палявых каманд недастаткова проста зафіксаваць візіт. Вынік павінен трапіць да патрэбнага аб'екта, стварыць або змяніць задачу, улічвацца пры выстаўленні рахункаў і заставацца бачным у гісторыі кліента. Менавіта гэтыя ўзаемасувязі вызначаюць архітэктуру і тэставанне.
Якія ёсць варыянты злучэння сістэм?
Выбар залежыць ад колькасці сістэм, дакументацыі, сцэнарыяў і кошту памылкі. No-code інструмент зручны для простага абмену. Гатовы канектар, разумны выбар, калі ён падтрымлівае менавіта ваш працэс. Персанальная інтэграцыя больш падыходзіць, калі ў вас ёсць ERP, некалькі каналаў або спецыфічныя правілы.
| Варыянт | Калі мае сэнс | Што можа пайсці не так | Кошт |
|---|---|---|---|
| Make або Zapier | Адно або два простыя дзеянні паміж папулярнымі праграмамі | Абмежаваная логіка, ліміты аперацый і залежнасць ад знешняга сэрвісу | указваецца ў прапанове |
| Гатовы канектар або плагін | Сістэмы папулярныя і для іх ёсць падтрымліваемы сцэнарый | Несупадзенне палёў, адсутнасць важных выключэнняў і залежнасць ад версіі плагіна | указваецца ў прапанове |
| Персанальная API-інтэграцыя | У вас ёсць спецыфічныя правілы, ERP, склад або некалькі каналаў | Больш працы на старце і патрэба ў падтрымцы | указваецца ў прапанове |
| Інтэграцыйны слой | Ёсць шмат сістэм, вялікі аб'ём або крытычныя аперацыі | Патрэбныя архітэктура, маніторынг і адказны за працэс | указваецца ў прапанове |
Пры выкарыстанні гатовага канектара нізкі кошт не азначае, што праца завершана. Праверце палі, падатковыя правілы, дубляванне, акругленне, адхіленыя плацяжы і вяртанні. Пры персанальнай інтэграцыі бюджэт у першую чаргу вызначаецца колькасцю сцэнарыяў і выключэнняў, а не толькі колькасцю сістэм.
Калі асноўная праблема звязана з крамай і яе аперацыямі, сувязі з плацежнымі сістэмамі, кур'ерамі і ўнутранымі сістэмамі трэба планаваць яшчэ пры распрацоўцы інтэрнэт-крамы. Калі крама ўжо працуе, інтэграцыя будуецца з улікам яе рэальных магчымасцяў і абмежаванняў API.
Як праходзіць надзейная API-інтэграцыя?
- 01Апісанне працэсу
Запішыце, што адбываецца сёння ад пачатку да канца. Хто ўводзіць заказ, дзе правяраецца наяўнасць, калі выстаўляецца рахунак і хто даведваецца пра праблему? Так становяцца бачнымі ручныя дзеянні і месцы, дзе губляецца інфармацыя.
- 02Праверка сістэм і дакументацыі
Праверце, ці ёсць у кожнай сістэмы API або webhook, як аўтэнтыфікуецца доступ, ці ёсць тэставае асяроддзе і якія існуюць абмежаванні. Запытайце ў знешняга пастаўшчыка дакументацыю, прыклады запытаў і правілы змяненняў інтэрфейсу.
- 03Вызначэнне даных і адказнасці
Узгадніце палі: нумар замовы, SKU, колькасць, цана, ПДВ, кліент, адрас і статус. Вызначце, якая сістэма можа змяняць кожнае значэнне і што адбываецца пры разыходжанні.
- 04Стварэнне невялікага першага сцэнарыя
Пачніце з аднаго патоку, напрыклад з перадачы новага заказу ў ERP або новага ліда ў CRM. Не ўключайце адначасова ўсе апавяшчэнні, справаздачы і выключэнні. Невялікі першы сцэнарый пакажа, ці правільна працуе логіка.
- 05Тэставанне памежных выпадкаў
Праверце адхілены плацеж, адсутнасць тавару, памылковы нумар тэлефона, вернуты заказ, выдалены тавар, перапыненне сувязі і паўторны webhook. Гэтыя выпадкі паказваюць, ці гатовая інтэграцыя да працы, а не толькі ці працуе яна падчас дэманстрацыі.
- 06Маніторынг і перадача камандзе
Забяспечце журнал запытаў, апавяшчэнне пра памылку і магчымасць паўторнай апрацоўкі. Каманда павінна бачыць, які заказ заблакаваны, чаму ён заблакаваны і як яго выправіць без умяшання ў базу даных.
Што часцей за ўсё ідзе не так?
Адзін запыт выконваецца двойчы
Webhook можа быць адпраўлены паўторна, калі атрымальнік своечасова не пацвердзіць яго атрыманне. Кожная падзея павінна мець унікальны ідэнтыфікатар, а сістэма, правяраць, ці была яна ўжо апрацаваная. Гэта асабліва важна для плацяжоў, рахункаў-фактур і адпраўкі пасылак.
Адна з сістэм недаступная
Калі ERP не адказвае, заказ не павінен знікнуць. Яго трэба захаваць у чарзе, выканаць кантраляваныя паўторныя спробы і адправіць апавяшчэнне адказнаму супрацоўніку, калі праблема не знікне.
Даныя маюць розную структуру
Адна сістэма можа выкарыстоўваць асобныя палі для імя і прозвішча, а другая, адно поле для імя. SKU, адзінкі вымярэння, стаўкі ПДВ, гадзінныя паясы і адрасы таксама часта адрозніваюцца. Гэтыя пераўтварэнні павінны быць часткай інтэграцыі, а не пакідацца супрацоўнікам.
Доступ занадта шырокі
Ключы API і паролі нельга захоўваць у кодзе або адпраўляць па электроннай пошце. Выкарыстоўвайце зашыфраванае злучэнне, асобныя доступы для тэставага і рэальнага асяроддзя, мінімальныя правы і працэдуру замены ключоў. Пры працы з персанальнымі данымі таксама праверце тэрміны захоўвання і правы доступу супрацоўнікаў.
Як зразумець, ці паспяхова прайшла інтэграцыя?
Вызначце крытэрыі да пачатку распрацоўкі. Усе новыя заказы павінны паступаць у ERP, у кожнага ліда павінен быць адказны, кожная памылка павінна быць бачная супрацоўніку, і ні адзін плацёж не павінен ствараць два рахункі-фактуры.
Не правярайце толькі, ці «паступілі» даныя. Праверце, ці завяршаецца працэс правільна, ці можа каманда адрэагаваць на праблему і ці выконваецца паўторная апрацоўка без ручнога рэдагавання базы даных. Каб зразумець, як могуць выглядаць звязаныя аб'екты, ролі і аперацыі, можна паглядзець дэма-сістэму ERP.
Калі выбраць гатовы інструмент, а калі, індывідуальную распрацоўку?
Make або Zapier зручныя для апавяшчэння, стварэння задачы або перадачы простай формы. Гэта добры спосаб праверыць ідэю і аўтаматызаваць невялікі працэс. Аднак пры большым аб'ёме трэба ўлічыць ліміты аперацый, штомесячную залежнасць і спосаб аднаўлення пасля памылкі.
Гатовая ўбудова падыходзіць, калі крама і бухгалтарская або кур'ерская сістэма падтрымліваюць менавіта патрэбны сцэнарый. Калі ў вас ёсць адмысловыя цэны для кампаній, некалькі складоў, складаныя вяртанні або розныя правілы для заказаў, магчымасцяў убудовы можа аказацца недастаткова.
Індывідуальная інтэграцыя мае сэнс, калі памылка азначае страчаную продажу, няправільныя рэшткі або праблемны рахунак-фактуру. Яна дазваляе рэалізаваць уласную логіку, кантраляваць даныя і лепш аднаўляцца пры недаступнасці сістэмы. Найважнейшае, мець дакументацыю і чалавека, адказнага за працэс пасля запуску.
Часта задаваныя пытанні
- У чым розніца паміж API і webhook?
- Пры выкарыстанні API ваша сістэма адпраўляе запыт, каб атрымаць або адправіць даныя. Пры выкарыстанні webhook іншая сістэма аўтаматычна паведамляе вам, калі адбываецца падзея, напрыклад новы заказ або паспяховы плацёж.
- Ці можна інтэграваць старую ERP без API?
- Часам, так: праз імпарт і экспарт CSV, доступ да базы даных, гатовы канектар або прамежкавы модуль. Гэта больш абмежаваны варыянт, чым API, і патрабуе асаблівай увагі да дублявання, бяспекі і графіка абмену.
- Колькі часу займае інтэграцыя API?
- Просты сцэнарый паміж добра дакументаванымі сістэмамі можна рэалізаваць у рамках кароткага праекта. Тэрмін павялічваецца пры наяўнасці некалькіх сістэм, адсутнасці дакументацыі, спецыфічных правілаў, міграцыі старых даных і патрэбы ў журнале або паўторнай апрацоўцы.
- Хто падтрымлівае інтэграцыю пасля запуску?
- З вашага боку павінен быць прызначаны канкрэтны адказны, а з боку распрацоўшчыка або пастаўшчыка, забяспечаная тэхнічная падтрымка. Знешняя сістэма можа змяніць версію API, поле або спосаб аўтэнтыфікацыі, таму маніторынг і апавяшчэнні з'яўляюцца часткай падтрымкі.






































