API je cesta, ktorou si aplikácie vymieňajú údaje a vykonávajú operácie. Pri ERP však samotná existencia tejto cesty nestačí. Podstatné je, či cez ňu dokážete napríklad rezervovať materiál a spoľahlivo zistiť výsledok.
Dobrá integrácia spája aj význam údajov, pravidlá zmien a zodpovednosť pri chybe. Rovnaké základy potrebuje web, prevádzková aplikácia aj AI asistent. Inak môže prepojenie technicky fungovať, zatiaľ čo ľudia naďalej opravujú výsledky ručne.
Požiadavka musí mať overiteľný výsledok
- Schválená zákazka Stabilný identifikátor operácie
- Kontrola pravidiel Sklad, množstvo a oprávnenie
- Zápis do ERP Jednoznačný výsledok alebo chyba
- Overenie stavu Rezervácia existuje iba raz
- Potvrdenie používateľovi Dokončené alebo čaká na riešenie
Za technickým rozhraním je obchodný výsledok
„Po schválení zákazky rezervujeme materiál a potvrdíme výsledok obchodníkovi.“ Tejto vete rozumie obchod aj vývojár. Zároveň otvára podstatné otázky: ktorý sklad, aké množstvo a čo ak sa zásoba medzitým zmení?
Práve odpovede vytvárajú zadanie integrácie. Opisujú vstup, povolený úkon a výsledok, na ktorý sa môže človek spoľahnúť. Technické detaily sa odvíjajú od tejto dohody.
Osobitnú pozornosť potrebuje rozdiel medzi „prijaté“ a „dokončené“. Služba môže požiadavku zaradiť na spracovanie bez toho, aby už vznikla rezervácia. Rozhranie pre používateľa nemá tieto stavy zamieňať.
Rovnaký názov ešte neznamená rovnaký údaj
Cena v obchodnej aplikácii môže byť dohodnutá suma za zákazku, kým ERP pod ňou rozumie cenníkovú cenu položky. Prepojenie podľa názvu poľa potom prenesie platné číslo s nesprávnym významom.
Podobne záleží na jednotkách, mene, zaokrúhľovaní a dátumoch. Objednané, dodané a rezervované kusy nie sú zameniteľné. Pri partnerovi je spoľahlivejší stabilný identifikátor než názov, ktorý sa môže zmeniť.
Mapovanie zahŕňa aj opravy a zrušenia. Zrušená objednávka má svoju históriu; nemá zmiznúť ako neznámy záznam. Keď tieto významy sedia, z rovnakých údajov môže správne čerpať skladník aj AI.
Rovnaký názov poľa nemusí znamenať rovnaký údaj
| Jedna hodnota | Iná hodnota | |
|---|---|---|
| Cena | Dohodnutá cena zákazky | Cenníková cena položky |
| Množstvo | Objednané kusy | Dodané kusy |
| Zásoba | Dostupné kusy | Rezervované kusy |
| Partner | Názov, ktorý sa môže zmeniť | Stabilný identifikátor |
Dokumentácia má pokryť celý život požiadavky
OpenAPI poskytuje štandardný spôsob opisu HTTP API. Pomáha pomenovať operácie, vstupy a odpovede, ktoré môžu spracovať aj vývojové nástroje. Nehovorí však za dodávateľa, ktoré vaše obchodné situácie podporuje. Špecifikácia OpenAPI
Okrem dokumentácie sa pýtajte na limity, verzie, testovacie prostredie a oznamovanie zmien. Kto vám dá vedieť, že staré pole prestane fungovať? Ako dlho môžete používať predchádzajúcu verziu? Viete si pripraviť testy ešte pred aktualizáciou?
Vypýtajte si aj chybové odpovede. Potrebujete rozlíšiť dočasný výpadok, chýbajúce oprávnenie a neplatnú objednávku. Pri prvej situácii môže pomôcť opakovanie. Pri ďalších by automatické opakovanie iba vytváralo hluk a odďaľovalo opravu.
Výpadok nesmie znamenať druhú objednávku
Predstavme si, že ERP objednávku vytvorí, ale odpoveď sa stratí počas prenosu. Vlastná aplikácia nevie, či operácia prebehla. Ak požiadavku bez kontroly zopakuje, môže vzniknúť duplicita.
Pri návrhu žiadajte spôsob bezpečného opakovania. Môže zahŕňať jedinečný identifikátor operácie a kontrolu už vytvoreného záznamu. Konkrétne riešenie závisí od rozhrania, no obchodný výsledok musí zostať rovnaký: jedna schválená požiadavka vytvorí jednu objednávku.
Podobne otestujte udalosti, ktoré prídu oneskorene alebo opakovane. Oznámenie „zákazka vytvorená“ môže doraziť až po jej zmene. Príjemca musí vedieť, či pracuje s aktuálnym stavom, alebo si ho má znovu načítať.
CloudEvents štandardizuje opis udalostí, aby sa dali prenášať medzi rôznymi službami. Spoločný formát však sám neurčuje vaše obchodné pravidlá ani postup pri chýbajúcej udalosti. Tie ostávajú súčasťou integračného návrhu. Projekt CloudEvents
Tri rôzne úlohy rozhraní
- MCP nástroj Sprístupní konkrétnu úlohu AI aplikácii
- API operácia Prenesie požiadavku na čítanie alebo zmenu
- Pravidlá ERP Overia stav, množstvo a oprávnenia
MCP sprístupňuje nástroje, obchodnú logiku držte v systéme
API môže poskytovať operácie ERP. MCP môže tieto operácie sprístupniť AI aplikácii cez pomenované nástroje a ďalší kontext. Obe vrstvy majú iný účel a v jednom návrhu sa môžu dopĺňať. Úvod do MCP
Pre asistenta radšej pripravte nástroj „navrhni nákupnú požiadavku“ než všeobecný prístup na ľubovoľný zápis. Systém má overiť dodávateľa, množstvo, dostupný rozpočet a oprávnenia. Pokyn v prompte nenahrádza tieto kontroly.
Používateľské oprávnenia musia platiť aj cez AI. Vedúci jednej pobočky nemá dostať dáta celej skupiny len preto, že položil otázku asistentovi. Obmedzenia testujte na konkrétnych záznamoch a operáciách. OWASP označuje chybné overovanie prístupu k objektom za jednu z kategórií rizík API. OWASP API Security Top 10
Jeden súbor pravidiel pre rôznych používateľov
- Prevádzková aplikácia
- AI asistent cez MCP
- Schválená automatizácia
- Čítať stav zákazky
- Pripraviť návrh nákupu
- Potvrdiť oprávnenú zmenu
Prevádzková aplikácia, AI asistent cez MCP, Schválená automatizácia → Pravidlá a oprávnenia → Čítať stav zákazky, Pripraviť návrh nákupu, Potvrdiť oprávnenú zmenu
Krátka skúška odhalí drahé obmedzenia
Pred rozsiahlym vývojom dáva zmysel prejsť jednu dôležitú operáciu v testovacom prostredí. Vytvorenie, načítanie a oprava záznamu ukážu, či sú potrebné možnosti skutočne dostupné.
Odobrať oprávnenie alebo prerušiť spojenie potom odhalí druhú polovicu kvality: ako sa práca obnoví. Človek potrebuje vedieť, či objednávka vznikla, alebo čaká na ďalší pokus.
Výsledkom je konkrétny opis možností a obmedzení pre rozsah projektu. Integrácia prestane byť neurčitým prísľubom, ktorý sa začne objasňovať až po podpise.
Rozhranie má pomôcť aj pri budúcom odchode
Firma môže neskôr vymeniť ERP alebo tím, ktorý integráciu prevádzkuje. Export kontaktov vtedy nestačí. Pokračovanie práce vyžaduje väzby, vlastné polia a stav otvorených zákaziek.
Ukážkový export pomôže odhaliť, či sú údaje použiteľné aj mimo pôvodnej aplikácie. Do podmienok spolupráce patrí dostupnosť rozhrania počas prechodu a prípadné samostatné poplatky za jeho používanie.
Pri vlastnej integrácii je rovnako dôležité mapovanie, dokumentácia prevádzky a postup obnovy. Samotný kód nezaručí nezávislosť. Ďalší tím potrebuje rozumieť aj pravidlám, ktoré tento kód vykonáva.
Odovzdanie, s ktorým môže pokračovať ďalší tím
- 1 Exportujte vzorku
Údaje, väzby, vlastné polia a potrebná história.
- 2 Overte význam
Nový tím rozumie mapovaniu a otvoreným zákazkám.
- 3 Prevezmite prevádzku
Účty, dokumentácia rozhraní a postup obnovy.
Vlastná integračná vrstva chráni vaše možnosti
Ak každý nový nástroj pripájate priamo do ERP, zmena jedného systému môže zasiahnuť viacero miest naraz. Vlastná vrstva vie sústrediť mapovanie údajov, pravidlá a sledovanie prenosov. Jej zmyslom je znížiť počet miest, kde sa opakuje rovnaká logika.
Aj táto vrstva potrebuje podporu, dokumentáciu a človeka zodpovedného za prevádzku. Výhodou vývoja na mieru je, že jej rozhrania navrhnete podľa skutočnej práce firmy. ERP, web aj AI asistent potom používajú dohodnuté operácie namiesto vzájomných obchádzok.
Napojenia majú slúžiť konkrétnej práci. V Transfer International zahŕňajú overenie osoby, doplnenie klientskych údajov a elektronický podpis. Pri integráciách a modernizácii systémov podobne určujeme hranicu medzi pôvodným systémom a novou funkciou.
Prejdime spolu jeden integračný scenár. Navrhneme, aké rozhrania potrebujete, kde majú platiť pravidlá a čo treba otestovať ešte pred rozhodnutím o ERP.
