API a prepojenie systémov

Prepisujete údaje z webu ručne do fakturácie a e-mailingu?

Prepájam weby a e-shopy s fakturáciou, platobnými bránami, e-mailingom a internými systémami. Údaje putujú automaticky, s logom prenosov a riešením chýb.

Prebrať integráciu Späť na hlavnú stránku

Ručné prepisovanie je najdrahšia integrácia, akú firma môže mať. Objednávka príde e-mailom, niekto ju prepíše do fakturačného systému, adresu skopíruje do prepravcu, kontakt pridá do newslettera a do tabuľky poznačí stav. Každý krok stojí čas a pri každom vzniká priestor na preklep, ktorý sa objaví až v reklamácii alebo v účtovníctve. Prepojenie systémov cez API tento reťazec odstráni. Údaje vzniknú raz, na jednom mieste, a ďalej sa presúvajú automaticky v dohodnutom tvare. Integrácie robím denne, takže viem, že podstatná časť práce nie je v šťastnom scenári, ale v tom, čo sa stane, keď je vzdialená služba nedostupná, vráti chybu alebo zmení formát odpovede.

Som freelance vývojár z Popradu s 19 rokmi praxe v PHP a webových systémoch, pracujem remote-first a komunikujete priamo so mnou. Sadzba je 40 € za hodinu vrátane DPH. Jednoduchšie prepojenie, napríklad odoslanie objednávky do fakturácie, býva otázkou 4 až 10 hodín. Obojsmerná synchronizácia skladu, cien a stavov s podnikovým systémom je väčší projekt a rozsah vždy odhadujem až po tom, čo si pozriem dokumentáciu druhej strany. Ak dokumentácia neexistuje alebo je rozhranie neúplné, poviem to skôr, než sa pustíme do práce, a navrhnem realistickú náhradu, napríklad dohodnutý export a import.

Fakturácia a účtovníctvo

Najčastejšia požiadavka je, aby objednávka z webu skončila ako faktúra bez toho, aby ju niekto prepisoval. Napojím fakturačné služby typu SuperFaktúra a podobné rozhrania, pošlem doklad zákazníkovi, uložím jeho kópiu k objednávke a stav úhrady vrátim späť do e-shopu. Riešim aj detaily, ktoré rozhodujú o použiteľnosti: variabilné symboly, rôzne sadzby DPH, dobropisy, zálohové faktúry, číselné rady a firemné údaje pri B2B nákupe. Pri opakovaných platbách nastavím generovanie dokladov podľa obdobia. Ak účtovníčka potrebuje dávkový export, pripravím ho v presnom formáte, ktorý jej systém prijíma.

Automatické faktúry z objednávok
DPH, dobropisy a číselné rady
Export v tvare pre účtovníctvo

Platobné brány a doprava

Platobnú bránu nasadím tak, aby platba, jej potvrdenie a prípadné vrátenie peňazí zodpovedali stavu objednávky aj vtedy, keď zákazník zavrie prehliadač skôr, ako sa vráti na web. To znamená spracovanie notifikácií na pozadí, overenie podpisu správy a ochranu proti dvojitému započítaniu tej istej platby. Podobne pracujem s prepravcami: odoslanie zásielky, tlač štítkov, výber odberného miesta a spätné sťahovanie stavov doručenia. Zákazník tak vidí pravdivý stav a obsluha nemusí stav dohľadávať v troch rôznych administráciách.

Platby vrátane notifikácií na pozadí
Vrátenia a čiastočné úhrady
Štítky a stavy zásielok

E-mailing, CRM a marketingové nástroje

Kontakty majú najväčšiu hodnotu vtedy, keď sú na správnom mieste s potrebným kontextom. Prepojím web s nástrojmi ako Mailchimp či iné e-mailingové a CRM systémy, prenesiem súhlasy so spracovaním, segmentáciu podľa nákupu alebo formulára a v prípade potreby aj históriu objednávok. Nastavím obojsmerné odhlásenie, aby sa odhlásený kontakt neobjavil v ďalšej kampani cez inú cestu. Doplniť viem tiež odosielanie transakčných e-mailov cez spoľahlivú službu, čo výrazne zlepší doručiteľnosť oproti odosielaniu priamo z hostingu.

Kontakty, súhlasy a segmenty
Obojsmerné odhlásenie z kampaní
Doručiteľnosť transakčných e-mailov

Interné a projektové systémy

Firmy zvyčajne už niečo používajú: skladový alebo podnikový systém, projektový nástroj, tabuľky, dochádzku alebo vlastnú databázu. Web s nimi prepojím tak, aby si každá strana ponechala svoju úlohu. Sklad a ceny vie prevziať web z podnikového systému, dopyt z formulára sa založí ako úloha v projektovom nástroji, schválená objednávka sa premietne do interného prehľadu. Pracujem aj s Google službami, kde sa najčastejšie rieši zápis do tabuliek, kalendár a prístup k dokumentom. Ak systém nemá API, hľadám najbližšiu spoľahlivú cestu: dohodnutý súbor na výmenu, databázový pohľad alebo naplánovaný import s kontrolou obsahu.

Sklad, ceny a stavy z podnikového systému
Dopyty do projektových nástrojov
Google tabuľky, kalendár a dokumenty

Vlastné REST API a spoľahlivá prevádzka

Keď má z vášho systému čerpať údaje partner, mobilná aplikácia alebo ďalší web, pripravím vlastné REST API s prehľadnou dokumentáciou, autentifikáciou, verziovaním a rozumnými limitmi. Rovnakú pozornosť venujem prevádzke integrácií: opakovanie neúspešných prenosov, radenie úloh na pozadí, log s históriou volaní a upozornenie, keď niečo prestane fungovať. Tichá integrácia, o ktorej sa dozviete až od zákazníka, je horšia ako žiadna. Preto k odovzdaniu patrí aj krátky prehľad, kde sa stav prenosov kontroluje a čo robiť pri výpadku druhej strany. Chcem, aby prepojenie prežilo aj obdobie, keď sa mu nikto nevenuje.

REST API s dokumentáciou a autentifikáciou
Opakovanie prenosov a fronty úloh
Log prenosov a upozornenia na chyby

Časté otázky o integráciách a API

Koľko stojí prepojenie webu s iným systémom?

Jednoduchšia jednosmerná integrácia býva 4 až 10 hodín, obojsmerná synchronizácia s podnikovým systémom 15 až 40 hodín. Pri sadzbe 40 € za hodinu vrátane DPH ide teda o rozsah zhruba od 160 €. Presný odhad dám po prezretí dokumentácie druhej strany.

Čo ak systém nemá API alebo dokumentáciu?

Stáva sa to pomerne často. Vtedy hľadám náhradnú cestu: pravidelný export a import súborov, prístup k databáze alebo rozhranie dodávateľa, ktoré sa dá vyžiadať. Ak žiadna spoľahlivá cesta neexistuje, poviem to priamo a nebudem sľubovať prepojenie, ktoré by sa lámalo pri každej aktualizácii.

Ako sa rieši výpadok druhej strany?

Prenosy navrhujem tak, aby výpadok neznamenal stratu údajov. Neúspešné volanie sa zaradí do fronty a zopakuje, chyba sa zapíše do logu a pri opakovanom zlyhaní vám príde upozornenie. Objednávka teda počká, kým je služba dostupná, namiesto toho aby zmizla.

Je to to isté ako AI integrácie?

Nie. Táto stránka je o prepojení webu s firemnými systémami, teda o fakturácii, platbách, sklade, e-mailingu a interných nástrojoch. AI asistenti, spracovanie textu a automatizácia pomocou jazykových modelov majú vlastnú stránku AI integrácie.

Zvládnete integráciu do existujúceho webu od iného vývojára?

Áno, je to bežná situácia. Najprv si pozriem, ako je web postavený, aké má verzie a či zásah nespôsobí konflikt pri aktualizácii. Integráciu potom pripravím tak, aby prežila aj budúce aktualizácie webu, a odovzdám krátky popis riešenia.

Chcete, aby si systémy odovzdávali údaje samy?

Napíšte, ktoré systémy máte a čo sa dnes prepisuje ručne. Poviem, či sa dajú prepojiť a v akom rozsahu.

Prebrať integráciu