Analitika360

Rivilė API ir Power BI: kaip sujungti duomenis ataskaitoms

Rivile ERP duomenys į Power BI patenka per analitikai skirtą API: Power BI siunčia užklausą GET https://api.rivile.cloud/bi/collect su API raktu antraštėje ir gauna pardavimų, pirkimų, atsargų, skolų ar didžiosios knygos duomenis. Prisijungti pavyksta greitai, tačiau ataskaitų modelis, kuris kasdien atsinaujina be klaidų, reikalauja puslapiavimo, inkrementinio atnaujinimo ir tvarkingos duomenų struktūros. Todėl įmonėms, kurioms reikia ne techninio eksperimento, o patikimų kasdienių rodiklių, Analitika360 siūlo paruoštus Rivilė Power BI paketus: Basic už 59 € per mėnesį ir PRO už 89 € per mėnesį, su automatiniu atnaujinimu be papildomo vartotojo darbo.

Trumpai

  • Rivile ERP analitikos API grąžina duomenų šaltinius, tokius kaip pardavimų ir pirkimų sąskaitų eilutės, atsargų likučiai, skolos, DK įrašai ir apmokėjimai.
  • Kiekvienai užklausai reikia API rakto, perduodamo antraštėje „X-SessionToken“.
  • Vienas GET atsakymas grąžina iki 100 įrašų, todėl didesniems kiekiams būtinas puslapiavimas.
  • Power BI Pro leidžia iki 8 suplanuotų atnaujinimų per dieną, Premium per user ir talpos licencijos iki 48.
  • Paruoštas Analitika360 paketas šiuos žingsnius perima ir pateikia jau veikiančias pajamų, sąnaudų, pelno, skolų ir sandėlio ataskaitas.

Turinys

Ką Rivilė API duoda Power BI

API (programų sąsaja) yra kelias, kuriuo viena programa automatiškai paima duomenis iš kitos, be rankinio eksporto į Excel. Rivile ERP turi atskirą analitikai skirtą tašką, o Rivile ERP analitikos gide išvardyti dažniausiai naudojami duomenų šaltiniai:

Duomenų šaltinisKas jame yraKam naudinga
SALES_INVOICE_DETAILEDPardavimų sąskaitų eilutėsPajamos, marža, prekių ir klientų analizė
PURCHASE_INVOICE_DETAILEDPirkimų sąskaitų eilutėsSąnaudos, tiekėjai, savikaina
INVENTORY_STOCKAtsargų likučiaiSandėlio vertė, trūkstamos prekės
PAYABLE_RECEIVABLES_FLATPirkėjų ir tiekėjų dokumentai, terminai, likučiai, apmokėjimo būsenosSkolų ir pinigų srautų kontrolė
GENERAL_LEDGERDidžiosios knygos įrašaiPelno (nuostolių) ataskaita, balansas
PAYMENTSApmokėjimaiGautinų sumų surinkimas
CLIENT, CLIENT_GROUP, PRODUCT, PRICEKlientai, jų grupės, prekės, kainodaraDimensijos filtrams ir segmentams

Bendrasis Rivile ERP API skirtas ir kitoms integracijoms: e. parduotuvėms, užsakymų bei likučių sinchronizacijai, dokumentų kūrimui. Ataskaitoms Power BI svarbiausias yra būtent analitikos taškas /bi/collect.

Jei įmonė dirba su Rivilė GAMA, kuri įdiegta kompiuteryje ar serveryje, duomenys į Power BI paprastai keliauja kitu keliu, per duomenų bazės kopiją. Apie tai plačiau rašome straipsnyje apie Rivilė duomenų replikaciją.

Ko reikia prieš jungiant

  1. API rakto. Jį sukuria Rivile ERP sistemoje vartotojas, turintis tam teises. Pagal API naudojimo taisykles kiekvienoje užklausoje privaloma antraštė „X-SessionToken“ su rakto reikšme. Kaip raktas kuriamas ir kodėl jį verta iškart išsaugoti, aprašėme gide Rivilė, Excel ir Power BI.
  2. Apgalvotų teisių. Rivile ERP teisių grupėse galima riboti prieigą prie modulių (Pardavimai, Pirkimai, Sandėlis, Atsargos, Ataskaitos) ir drausti, pavyzdžiui, finansinių duomenų peržiūrą. Ataskaitoms skirtam vartotojui pakanka skaitymo teisių.
  3. Power BI Desktop ir licencijos. Ataskaita kuriama nemokamoje Power BI Desktop programoje, tačiau norint ją paskelbti ir dalytis su kolegomis, reikia Power BI Pro licencijos. Analitika360 perparduoda Microsoft Pro ir Premium licencijas, todėl jas galima užsisakyti kartu su ataskaitomis.
  4. Žinomų ribų. GET užklausa grąžina iki 100 įrašų, POST ir PUT užklausos dydis ribojamas iki 5 MB, o atsakymo laukiama ne ilgiau kaip 5 minutes.

Prijungimas žingsnis po žingsnio

Rivile ERP gide aprašyta seka atrodo taip. Prie kiekvieno žingsnio nurodome, kur dažniausiai kyla problemų.

  1. Sukurkite parametrus. Power BI Desktop lange „Manage Parameters“ sukurkite BaseUrl = “https://api.rivile.cloud”, ApiKey, FromDate ir ToDate. Kur klystama: raktas įrašomas tiesiai į užklausos tekstą, ir jis lieka matomas kiekvienam, gavusiam .pbix failą.
  2. Pasirinkite jungtį. Naudokite Get Data > Web arba „Blank Query“ ir rašykite užklausą M kalba (Power Query formulių kalba). Kur klystama: paprasta Web jungtis be parametrų vėliau neleidžia keisti laikotarpio ar duomenų tipo.
  3. Suformuokite užklausą. Adresas sudaromas iš /bi/collect, parametro type (pvz., SALES_INVOICE_DETAILED) ir filtro, o raktas perduodamas antraštėje X-SessionToken. Schematiškai:
let
    Saltinis = Json.Document(Web.Contents(BaseUrl, [
        RelativePath = "bi/collect",
        Query = [type = "SALES_INVOICE_DETAILED"],
        Headers = [#"X-SessionToken" = ApiKey]
    ])),
    Duomenys = Saltinis[success][data],
    Lentele = Table.FromRecords(Duomenys)
in
    Lentele
  1. Ištraukite duomenis. Iš atsakymo paimkite success.data masyvą ir paverskite jį lentele. Kur klystama: paimamas tik pirmas atsakymas, o kadangi jame iki 100 įrašų, metų pardavimai atrodo kaip kelių dienų. Reikia funkcijos, kuri cikle surenka visus puslapius.
  2. Sudėliokite modelį. Gide rekomenduojama žvaigždės schema: faktų lentelės (sąskaitų eilutės, DK įrašai) centre ir dimensijos (klientai, prekės, datos) aplink. Kur klystama: viskas sujungiama į vieną plačią lentelę, modelis išauga, o skaičiai pradeda dubliuotis.
  3. Įjunkite inkrementinį atnaujinimą. Pagal datos stulpelį, pvz., dokumento datą, Power BI kaskart atnaujina tik naujausią laikotarpį, o ne visą istoriją.

Analitika360 Rivilė paketuose šie žingsniai jau atlikti: duomenys iš Rivilė sujungti į vieną Power BI modelį, ataskaitos atsinaujina automatiškai, o prireikus prie to paties modelio prijungiami SharePoint, Excel, CRM ar logistikos duomenys.

Atnaujinimas: kaip dažnai ir kodėl duomenys gali vėluoti

Pagal Microsoft Learn suplanuoto atnaujinimo aprašą Power BI Pro leidžia iki 8 suplanuotų atnaujinimų per dieną, o Premium per user, Premium ir Fabric talpa iki 48. Atnaujinimas pradedamas per 15 minučių nuo nustatyto laiko, bet gali vėluoti iki valandos. Jei ataskaitos niekas neatidaro du mėnesius, suplanuotas atnaujinimas sustabdomas.

Rivilės pusėje svarbi talpykla (cache): pakartotinė užklausa su tuo pačiu filtru 8 valandas grąžinama iš talpyklos, o ne iš aktualios duomenų bazės. Praktiškai tai reiškia, kad filtras ir atnaujinimo laikas turi būti suderinti, kitaip vadovas ryte mato vakarykščius skaičius. Rivile ERP gide taip pat patariama duomenų ištraukimą planuoti naktį.

Dar viena dažna kliūtis yra modelio dydis. Pro licencijai jis ribojamas 1 GB, o bandant paskelbti didesnį modelį Power BI grąžina klaidą „(400) Bad Request“. Tada padeda Premium per user licencija arba Premium talpa, tačiau dažniau pakanka tvarkingos žvaigždės schemos ir tik reikalingų stulpelių.

Atnaujinimas: kaip dažnai ir kodėl duomenys gali vėluoti

Kokias ataskaitas kurti iš Rivilė duomenų

Tie patys API duomenų šaltiniai skirtingiems vartotojams duoda skirtingą naudą:

  • Restoranų savininkams: pajamos pagal dieną, savaitę ir padalinį, maisto produktų sąnaudos iš pirkimų sąskaitų, bendroji marža ir sandėlio likučiai. Restoranų tinklui svarbu matyti visus padalinius viename ekrane.
  • Buhalteriams: pirkėjų ir tiekėjų skolos pagal terminus, apmokėjimų būsenos, DK apyvartos. Kaip tai sutaupo laiko kas savaitę, rodome straipsnyje apie Rivilė skolų kontrolę, o metų pabaigai pravers Rivilės balanso analizė.
  • Finansų vadovams: pelno (nuostolių) ataskaita pagal mėnesius, sąnaudų struktūra, planas ir faktas, kai biudžetas laikomas Excel ar SharePoint faile.
  • Mažų įmonių savininkams ir konsultantams: keli pagrindiniai rodikliai, pajamos, sąnaudos, pelnas ir skolos, kurie atsinaujina be rankinio darbo ir matomi telefone.

Pardavimų pusei skirta atskira Rivilės pardavimų analizė, o sandėliui Rivilės sandėlio ataskaitos.

Duomenų sauga

Rivile ERP gide pabrėžiama, kad API raktai turi būti laikomi slaptai, o gauti duomenys saugiai laikomi savo infrastruktūroje. Power BI pusėje kitas svarbus klausimas yra tai, kas ką mato: padalinio vadovas neturėtų matyti kitų padalinių ar viso įmonės pelno. Tam naudojama eilutės lygio sauga, kai ta pati ataskaita kiekvienam vartotojui rodo tik jam leistus duomenis. Analitika360 savo sprendimuose užtikrina duomenų saugą, o IT vadovams parengėme Power BI saugos žingsnius.

Mūsų požiūris

Rivile ERP analitikos API yra geras pagrindas: duomenys pasiekiami per vieną adresą, aiškiomis duomenų šaltinių pavadinimais. Vis dėlto vadovui vertę kuria ne pats prisijungimas, o modelis, kuriuo galima pasitikėti kiekvieną rytą.

Todėl kuriame paruoštus ataskaitų rinkinius Rivilė naudotojams. Juose jau sutvarkytas duomenų paėmimas, modelio struktūra ir automatinis atnaujinimas, o pajamos, sąnaudos, pelnas, balansas, pardavimai, sandėlis ir skolos matomi vienoje vietoje. Kai įmonė turi savų procesų, pavyzdžiui, restoranų tinklo padalinius, logistikos ar statybos projektų duomenis, sprendimą pritaikome prie jos sistemų.

Mūsų nuomone, finansų komandos laikas geriausiai panaudojamas ne užklausų taisymui, o sprendimams, kuriuos padeda priimti tikslūs skaičiai.

Analitika360

Paruošti Rivilė Power BI paketai

Jei norite Rivilė duomenis matyti Power BI be API užklausų rašymo, rinkitės paruoštą paketą. Rivilė Basic kainuoja 59 € per mėnesį, Rivilė PRO 89 € per mėnesį. Specifinėms ataskaitoms ir integracijoms su kitais šaltiniais atliekame individualius projektus už 70 € per valandą, o reikiamas Microsoft Pro ir Premium licencijas galima užsisakyti kartu.

Analitika360

Visas kainas ir paketų palyginimą rasite verslo analitikos kainų puslapyje.

DUK

Ar Rivilė API veikia su Rivilė GAMA?

Šiame straipsnyje aprašytas analitikos API taškas /bi/collect priklauso Rivile ERP debesijos sistemai. Rivilė GAMA duomenys į Power BI dažniausiai perkeliami per duomenų bazės replikaciją. Šį kelią išsamiai aprašome straipsnyje apie Rivilė ir Finvalda duomenų replikaciją.

Kodėl Power BI rodo tik 100 eilučių?

Rivile ERP API vienu GET atsakymu grąžina iki 100 įrašų. Kad gautumėte visus duomenis, Power Query užklausa turi cikle surinkti visus puslapius. Analitika360 paketuose ataskaitos atsinaujina automatiškai, be papildomo vartotojo darbo.

Power Query surenka API duomenis puslapiais

Kiek kartų per dieną atsinaujina ataskaita?

Su Power BI Pro licencija galima suplanuoti iki 8 atnaujinimų per dieną, su Premium per user ar talpos licencija iki 48. Rivilės pusėje pakartotinės užklausos su tuo pačiu filtru 8 valandas grąžinamos iš talpyklos, todėl atnaujinimo laikus verta suderinti.

Ar reikia mokėti už Power BI licencijas?

Ataskaitai kurti pakanka nemokamos Power BI Desktop programos, tačiau paskelbti ir dalytis ataskaitomis reikia Pro licencijos. Skaitytojams licencijos nereikia tik P1 ar didesnėje arba F64 ar didesnėje talpoje. Licencijas galima užsisakyti per Analitika360.

Šaltiniai

Rekomendacijos

Taip pat skaitykite

Naudojate Rivilę?

Analitika360 paruošia Power BI ataskaitas tiesiai iš Rivilės duomenų. Ataskaitos atsinaujina automatiškai, nuo 59 Eur/mėn.

Rivilės ataskaitos
Analitika360 klientų sėkmės istorijos

Duomenys, kurie padeda priimti sprendimus

Sužinokite, kaip įmonės, tokios kaip jūsų, pritaikė Analitika360 ataskaitas savo veikloje naudodami Power BI.

“
Gavome standartinį R-Keeper ataskaitų paketą ir dar pritaikė pagal mūsų poreikius. Viskas veikia!
TB
Tomas B.restorano savininkas
“
20 paruoštų ataskaitų – nereikėjo galvoti, ko prašyti. Finvaldos duomenys pagaliau matomi vizualiai. Rekomenduoju.
IM
Ingrida M.buhalterė
“
Labai patiko, kad Analitika360 turi paruoštą 20 ataskaitų paketą Rivile naudotojams – nereikėjo nuo nulio aiškintis, ko mums reikia. Startavome greitai, o vėliau dar pritaikė kelias ataskaitas pagal mūsų gamybos specifiką. Sutaupėme ir laiko, ir pinigų.
MK
Marius K.finansų vadovas
“
Turime kelių įmonių grupę su Rivile, ir konsoliduotos ataskaitos visada buvo galvos skausmas. Analitika360 pasiūlė standartinį 20 ataskaitų paketą kaip pagrindą, o tada pritaikė jį mūsų grupės struktūrai – dabar matome viską viename Power BI modelyje, atsinaujina automatiškai.
GJ
Giedrė Jankauskaitėfinansininkė
“
Valdome 6 restoranus su R-Keeper ir ilgai ieškojome būdo matyti palyginamus rezultatus tarp objektų. Standartinis 20 ataskaitų paketas padengė didžiąją dalį poreikių, o vėliau buvo pritaikytos individualios ataskaitos mūsų tinklui.
AŠ
Andrius Š.restoranų tinklo direktorius
“
Kreipėmės po rekomendacijos ir iš karto maloniai nustebino paruoštas 20 ataskaitų standartas Finvalda naudotojams. Vadovybė dabar kas pirmadienį gauna aiškią finansinę nuotrauką, o aš nebeleidžiu dienų eksportuojant duomenis į Excel.
RP
Rasa Petrauskienėapskaitos vadovė
“
Naudojame Rivile, bet niekada neturėjome laiko kurti ataskaitų nuo nulio. 20 ataskaitų paketas buvo tiesiog tai, ko reikėjo – įsidiegėme per savaitę.
VP
Vaidas P.prekybos tinklo vadovas
“
Turime 4 kavines su R-Keeper sistema ir ilgai dirbome „pagal nuojautą“. Analitika360 ataskaitos parodė dalykų, kurių anksčiau net nepastebėdavome. Dabar sprendimus priimame remdamiesi duomenimis, ne spėliojimais.
LK
Laura Kazlauskienėkavinių tinklo finansų vadovė