Integrácie NetSuite: API, konektory a väzby na slovenské systémy

Hľadáte konektor NetSuite pre e-shop, banku alebo skladový systém? Najprv si ujasnite, čo presne sa má medzi systémami prenášať. NetSuite je cloudový ERP systém od spoločnosti Oracle a jeho integrácia stojí na troch cestách: štandardné API, hotové rozšírenia a vývoj na mieru. Ktorá z nich sa hodí, rozhoduje konkrétny tok dát, nie značka konektora.

Táto stránka vysvetľuje, čo NetSuite ponúka, ako sa líši REST od vyraďovaného SOAP, ktoré kategórie prepojení slovenské firmy riešia najčastejšie a ako integráciu zadať tak, aby po spustení nezostala bez majiteľa.

Ako sa NetSuite pripája k iným systémom

API NetSuite predstavuje rodina webových služieb SuiteTalk. Dnes sa pri novej práci rátajú dve veci: REST a vlastné skripty.

REST služby SuiteTalk

Verzia REST ponúka operácie CRUD nad záznamami (vytvorenie, čítanie, úprava, zmazanie), prístup k metaúdajom, filtrovanie zbierok, akcie a transformácie záznamov a asynchrónne spracovanie. Dá sa cez ňu spustiť aj dátový súbor zo SuiteAnalytics Workbook alebo dotaz SuiteQL. Podstatné je, že to funguje bez nasadenia skriptu, na rozdiel od RESTletov.

V praxi to znamená, že externý systém môže čítať a zapisovať štandardné záznamy NetSuite bez toho, aby ste museli v ERP spravovať vlastný kód. Pre jednoduchšie toky je to najčistejšia cesta.

RESTlet a SuiteScript

RESTlet je koncový bod, ktorý si v NetSuite napíšete a nasadíte ako skript. Hodí sa, keď štandardné záznamy nestačia: potrebujete jedno volanie, ktoré spojí viac krokov, vlastnú validáciu alebo upravený tvar odpovede. Platíte za to tým, že kód treba udržiavať, testovať a prispôsobovať pri každej zmene verzie. Viac o tejto téme je na stránke o úprave NetSuite na mieru.

SOAP sa končí

Webové služby SOAP sú vo fáze vyraďovania. WSDL 2025.2 je posledný plánovaný prístupový bod SOAP, od vydania 2027.1 sa bude podporovať iba on a po vydaní 2028.2 už SOAP nebude k dispozícii. Dokumentácia pre každú novú integráciu odporúča REST s autorizáciou OAuth 2.0.

SOAP v SuiteTalk používa kódovanie Document (XML správy, RPC sa nepodporuje), prenos výlučne cez HTTPS, riadenie prístupu cez rolu (existuje rola „Web Services Only“) a synchrónne alebo asynchrónne požiadavky. Ak už taký konektor máte, nečakajte na posledný moment: v zmluve s integrátorom si dohodnite plán prechodu na REST.

Hotové rozšírenia a SuiteApp

Okrem API existuje trhovisko rozšírení SuiteApp, kde dodávatelia ponúkajú hotové konektory a doplnky pre NetSuite. Dostupnosť a rozsah konkrétnych rozšírení sa mení, preto ich vždy overte u integrátora a u samotného dodávateľa, a to pred rozhodnutím o architektúre. Pri hodnotení sa pýtajte na tieto veci:

• aké záznamy a smery prenosu konektor pokrýva (jednosmerne alebo obojsmerne),
• ako rieši chyby a opakovanie prenosu,
• kto ho podporuje a ako reaguje na novú verziu NetSuite,
• ako sa prejavia vaše úpravy polí a procesov,
• či rieši slovenské špecifiká, alebo ide o všeobecné riešenie.

Hotové riešenie sa nevypláca, ak ho budete musieť zo všetkých strán obkladať vlastnými úpravami. Vtedy býva rozumnejšie použiť REST a postaviť prepojenie primerané vašim pravidlám.

Najčastejšie kategórie integrácií

E-shop a predajné kanály

Pre internetový obchod je typický tok: produkty a ceny z ERP do obchodu, objednávky z obchodu do ERP, stav skladu a stav doručenia späť. Rovnaká logika platí pre trhoviská. Podstatné je určiť, ktorý systém je „pánom“ každého údaja; bežne ERP vlastní sklad a cenníky, obchod vlastní košík. Súvisiace sektorové súvislosti nájdete na stránke ERP pre e-shopy a v časti o riadení skladu a nákupu v NetSuite.

Banky a platby

Bankové výpisy sa do ERP prenášajú ako súbor alebo cez bankové rozhranie a párujú sa s faktúrami. Platobné brány zasa dodávajú údaje o úhradách, poplatkoch a vrátených platbách. Pri slovenskej firme sa pýtajte, v akom formáte vaša banka výpisy poskytuje, či ide o účty v eurách aj v cudzej mene a kto rieši párovanie, ktoré sa nepodarí automaticky. Účtovné dôsledky sú popísané v časti o účtovníctve a financiách v NetSuite.

CRM a zákaznícky servis

Ak obchodný tím pracuje v samostatnom CRM, treba rozhodnúť, ktorý systém vlastní zákazníka, ponuku a objednávku. NetSuite má vlastné funkcie predaja, ktoré popisuje stránka o CRM a predaji v NetSuite; integrácia s externým CRM dáva zmysel najmä vtedy, keď ho tím už používa a prechod by bol drahší ako prepojenie.

Kancelárske nástroje, reporting a BI

Tabuľky, e-mail či kalendár sa s ERP spájajú najčastejšie cez exporty alebo jednoduché prepojenia. Pre reporting sa využíva SuiteAnalytics a dotazy SuiteQL; BI nástroj môže čítať dáta z ERP a zostavovať prehľady pre vedenie. Dôležité je dohodnúť, či sa analytika robí priamo v ERP, alebo v samostatnom dátovom sklade, pretože od toho závisí, kto zodpovedá za kvalitu čísel.

EDI a elektronické podpisy

Obchodní partneri, najmä väčšie siete, môžu požadovať výmenu objednávok, dodacích listov a faktúr v štruktúrovanej podobe. Prepojenie sa zvyčajne rieši cez sprostredkovateľa EDI alebo cez vlastný konektor. Podobne sa k ERP pripájajú nástroje na elektronický podpis zmlúv alebo dokumentov. Tu platí zásada: ukladajte do NetSuite odkaz a stav, nie súbory, ktoré tam nepatria.

Slovenské väzby, ktoré treba vyriešiť

Pri slovenskej firme sa integračný zoznam nekončí na všeobecných kategóriách. Do zadania patria aj povinnosti, ktoré sa viažu na krajinu:

• E-kasa a pokladničné predaje. Maloobchod a služby s hotovostným predajom musia riešiť väzbu medzi pokladnicou a ERP. Čo to znamená pre výber systému, rozoberá stránka o e-kase a ERP.
• DPH a kontrolný výkaz. Doklady v ERP musia niesť údaje potrebné pre priznanie aj kontrolný výkaz; podrobnosti sú v prehľade kontrolného výkazu DPH v ERP.
• Elektronická fakturácia. Výmena faktúr medzi firmami a štátom si žiada správny formát a spoľahlivý prenos; súvislosti vysvetľuje stránka o elektronickej fakturácii v ERP.
• Externý účtovník. Mnohé malé a stredné firmy vedú účtovníctvo cez externého účtovníka. Zistite, v akom formáte chce dostávať doklady a či potrebuje prístup priamo do NetSuite, alebo mu stačí export.

Pokrytie týchto povinností sa v NetSuite zvyčajne rieši lokalizáciou, rozšírením alebo prepojením na iný systém. Čo presne je k dispozícii a v akej kvalite, si nechajte overiť u integrátora ešte pred podpisom zmluvy. Na stránke NetSuite na Slovensku nájdete širší kontext pre náš trh.

Ako integráciu správne zadať

Väčšina problémov s integráciou nevzniká v kóde, ale v zadaní. Dobrý zadávací list pre každý tok obsahuje:

1. Zdroj a cieľ. Odkiaľ údaj prichádza, kam smeruje a ktorý systém je jeho vlastníkom.
2. Spúšťač a frekvenciu. Prenáša sa po udalosti, v pravidelnom intervale, alebo na požiadanie.
3. Mapovanie polí. Ktoré polia sa zhodujú, ktoré sa musia prepočítať a čo sa deje s údajom bez zhody.
4. Chybový scenár. Čo sa stane, keď cieľový systém neodpovedá, a kto o tom vie.
5. Testovacie prostredie a dáta. Na čom sa prenos overí pred ostrou prevádzkou.
6. Prístupové práva. Aká rola a aké oprávnenia má integračný používateľ; princíp najmenších práv.

Zadávací list je východiskom aj pre porovnanie ponúk. Ak dva dodávatelia ponúkajú rôzne riešenia toho istého toku, rozdiel v cene zvyčajne vychádza z toho, čo je v ponuke a čo nie. Rozsah a cenotvorbu rozoberá stránka o cenách NetSuite.

Tabuľka rozhodnutí pred štartom

Kto integráciu udržiava

Integrácia nie je projekt s koncom, ale prevádzková súčasť ERP. Po spustení sa mení API pripojeného systému, vaše procesy aj samotné NetSuite. Preto vopred určte:

• vlastníka toku na strane firmy (zvyčajne človek zo skladu, financií alebo e-commerce),
• technického správcu (integrátor, dodávateľ rozšírenia alebo interná IT),
• monitoring chýb a oznamovanie, aby sa porucha nezistila až od zákazníka,
• postup zmeny, teda kto ju schvaľuje, testuje a nasadzuje.

Tieto body patria do zmluvy o podpore; viac o nich nájdete v časti o podpore a údržbe NetSuite. Vybrať vhodného dodávateľa vám pomôže stránka o výbere partnera pre NetSuite a obecný popis nášho postupu v časti ako to funguje.

Integrácia ako súčasť projektu

Integrácie sa najlepšie plánujú spolu s celým nasadením, nie dodatočne. Pri implementácii NetSuite ich zaraďte do harmonogramu rovnako ako migráciu dát a školenia, pretože sa často stávajú kritickou cestou projektu. Ak plánujete aj presun dát zo starého systému, pozrite si stránku o migrácii do NetSuite.

Ako postupovať

1. Zoznam systémov, s ktorými sa má ERP spájať, rozdeľte na toky a pri každom určte vlastníka údaja.
2. Pre každý tok rozhodnite: hotové rozšírenie, REST, alebo vlastný skript.
3. Nové riešenia stavajte na REST s OAuth 2.0 a nezačínajte nič nové na SOAP.
4. Slovenské povinnosti (e-kasa, DPH, e-fakturácia) zapíšte do zadania ako samostatné body.
5. Dohodnite si, kto integráciu udržiava, a zapíšte to do zmluvy.

Ak chcete získať ponuky od integrátorov, ktorí už podobné prepojenia riešili, vyplňte krátku žiadosť. Služba je pre vás bezplatná a nezáväzná; tok dát si môžete popísať vlastnými slovami.

Uvedené názvy softvéru sú ochranné známky ich príslušných výrobcov a uvádzajú sa len na informačné účely. Táto stránka je nezávislá a nie je prepojená so žiadnym výrobcom.