Sisujuht
Directo ja RIK e-arve (e-arveldaja) liidestamine
Käesolev juhend kirjeldab Directo ja RIKi koostööd ja häälestamist. Directo toetab nii müügiarvete saatmist läbi nimetatud keskkonna kui ka vastuvõtmist ja ostuarveks või laosissetulekus muutmist. RIKi edastatud e-arved jõuavad saajani eeldusel, et saaja on e-arve vastuvõtuvõimeline ehk valinud omale operaatoriks ühe Eestis tegutsevate operaatorite vahel - RIK, Telema, Unifiedpost jne. Liides on Directo kasutajale tasuta.
Loe veel e-arvetest üldisemalt
RIKi kaudu pole võimalik e-arved edastada pankadesse.
RIKi edastatakse nii e-arve kui ka PDF arvest, kuid mitte arvele lisatud manuseid.
Liidestamiseks EI TOHI liituda e-arveldajaga RIKi lehel, vaid protsessi peab algatama Directos vastavalt alltoodud juhendile. Kuni ettevõttel on e-arveldajaga kehtiv leping, Directost liitumine ei õnnestu.
Definitsioonid
- RIK- Registrite ja infosüsteemide keskus
- Klient- arve lõppadressaat
- eArve- RIKi kaudu edastatava müügiarve elektroonne kuju (mitte pdf-fail)
Üldine häälestamine
Directo ja RIK-earve liidestamiseks tuleb aktiveerida seadistus:
Süsteemi seadistused > Transport > RIK e-arvete liidestus
Eri juhtudel võib vaja minna ainult saatmist või ainult vastuvõttu, kuid üldjuhul on mõistlik valik saatmine ja vastuvõtt
Peale valiku teostamist ja Salvesta nupu vajutamist teostab süsteem päringu RIKi suunas lepingu aktiveerimiseks. Tulemusest kuvatakse vastava sisuline teade. Kui aktiveerimine õnnestus, saab kohe arveid saatma hakata.
- Kui valisite Saatmine ja vastuvõtt või Ainult vastuvõtt, tuleks:
- siseneda äriregistrisse
- valida Minu ettevõtmised, ning ettevõte, kellele lepingut sõlmite
- Muuda andmeid vaates otsida üles E-arve vastuvõtmise teenusepakkuja blokk, ning seal kinnitada RIKi oma e-arve operaatoriks.
Lepingu aktiveerimise info ei pruugi ettevõtjaportaali jõuda reaal-ajas, ideaalis peaks ka juhatus saama vastava sisulise meili. Kui kinnitamise valikut pole, siis vaata 10 minuti pärast uuesti
Ettevõtjaportaalis tuleks kinnitus teha ära esimesel võimalusel, sest 7 päeva pärast lõpetatakse leping automaatselt ning siis ei toimi ei saatmine ega ka vastuvõtt ning kogu protsessi tuleb uuesti alustada.
- Valiku Ainult saatmine korral kinnitamist teha pole vaja ja Directo on saatmiseks kohe valmis.
Valikut ei saa sisse välja klõpsida meelevaldselt - süsteem laseb päeva jooksul teha ühe valiku. Näiteks ei õnnestu lülitada liidestust sisse ja siis kohe seejärel välja.
Ettevõtjaportaali E-arve vastuvõtmise teenusepakkuja kinnitamise juhend
Liidestuse muutmine juba aktiveeritud olukorras
Kui RIK-earve leping on juba aktiivne - liides on juba varem seadistatud ja soov on muuta ainult seda, kas toimub saatmine või nii saatmine kui ka vastuvõtt, tuleb kõigepealt leping lõpetada. Selleks valida RIK e-arvete liidestus seadistuseks EI ning salvestada
- Kui eelnevalt oli valitud nii saatmine kui ka vastuvõtt, saab uue liitumise algatada järgmisel päeval
- Olles eelnevalt ainult e-arvete saatmise režiimil, saab uue lepingu algatada kohe peale lõpetamist
Süsteemiseadistused, mis mõjutavad eArvet
Saatmisel - eArve XMLi ehitamisel
Seadistus | Sisu |
---|---|
Firma pangakonto/IBAN | Saatja arveldusarve |
Firma reg. number | Saatja reg.number |
Firma panga SWIFT | Saatja panga BIC tunnus |
Transpordi pangakonto/IBAN | Kui täidetud, eelistakse siinset määrangut Firma pangakonto/IBAN seadistusele. Arvelduskonto (IBAN), mis edastatakse kui ettevõtte arvelduskonto. Sellele väljale tuleb sisestada AINULT arvelduskonto (IBAN) tühikuteta ja muude lisanditeta |
Transpordi viitenumber | Kui kasutusel on viitenumber, määrab milline viitenumber saadetavale arvele antakse. Variandid on ei saadeta, kliendilt - kliendikaardilt ja arvelt - arvepõhine (igal arvel erinev) |
Kliendi lisaväli, mis määrab e-arve kliendi reg. numbri | Kui kliendi reg peab eArvel erinema kliendikaardil defineeritust, saab seda muuta siin määratud kliendi lisavälja abil |
Kliendi lisaväli, mis määrab e-arve kliendi nime | Kui kliendi nimi peab eArvel erinema kliendikaardil defineeritust, saab seda muuta siin määratud kliendi lisavälja abil |
e-arve teenuse tunnuse (serviceId) alus | Invoice/@serviceId välja sisu alus. Siin saab määrata kas panga saadetav tunnus on Kliendi kood ; Kliendi viitenumber ; Arve viitenumber ; Lepingu number ; Kliendi Reg nr . Määära vastavalt nii nagu on kliendil pangaga sõlmitud lepingus |
e-arve tasuda välja alus (PaymentTotalSum) | InvoiceSumGroup/TotalToPay ja PaymentInfo/PaymentTotalSum väljade alus |
e-arvele lähevad ainult need read, kus rea RV võrdub rea NR | |
Võimalus määrata vajadusepõhiselt sisu SellerParty ja BuyerParty väljale DepId |
Kõiki eelnimetatud andmeid kasutatakse eArve loomisel ja edastatakse koos arve infoga eArve saajale (Klient). Seetõttu on oluline, et need ka tõesed oleks.
Vastuvõtmisel - Ostuarve/Sissetuleku loomisel
Seadistus | Sisu |
---|---|
Vaikimisi seeria | Numbriseeria, mis omistatakse imporditavale ostuarvele vaikimisi. Kui siin seeriat täidetud pole, üritatakse seeria tuvastada loomise aja järgi (1) |
Vaikimisi kasutaja | Kasutaja kood, mis määratakse sisse imporditavale eArvele (ostuarve) automaatselt väljale Kasutaja. Selle seade täitmine ei ole kohustuslik, kuid kui on soov automaatselt ostuarveid luua siis peab see olema täidetud (loe ka siit (1) (2) |
Vaikimisi objekt | objekti kood, mis määratakse sisse imporditavale eArvele (ostuarve) automaatselt väljale Objekt. Selle seade täitmine ei ole kohustuslik (1) (2) |
Vaikimisi projekt | projekti kood, mis määratakse sisse imporditavale eArvele (ostuarve) automaatselt väljale Projekt. Selle seade täitmine ei ole kohustuslik (1) (2) |
Omniva/Finbite/EAK e-arvete allalaadimine | Kas e-arveid üldse laetakse alla (võib-olla on soov ainult saata) |
Omniva/Finbite/EAK kulutuste allalaadimine | Kas ja mis hetkel laetakse alla kuluaruanded |
Omniva/Finbite/EAK manuste allatõmbamine | Kas alla laetakse ka manused Jah = Kõik manused Ei = Ainult arve peamanust (arve PDF) |
Dokumentide transpordi alt loodud ostuarve/sissetulek ei lase juba eksisteeriva hankija arve numbriga dokumenti uuesti luua | |
e-arve põhjal ostuarve loomisel täidetakse ka jagatav summa | |
(1) Välja võib vajadusel määrata igale imporditud eArvele käsitsi. Lisaks on välja võimalik hankija kaardi Transport sakis määrta hankijapõhiselt | |
(2) Välja võib (ridadel) täita ka rakenduv hankija automaatika |
Aadressi väljade seadistus
Directos saab kliendikaardi aadressi välju seadistada vastavalt kasutaja soovile - kasutada on 3 rida. Süsteemiseadistuste all filtreerida aadress järgi:
Aadress 1. nimi, Aadress 2. nimi ja Aadress 3. nimi määravad nimetuse aadressi väljale, mis kuvatakse kliendikaardile ja ka arvele ja muudele dokumentidele. Et süsteem teaks, kuidas eristada aadressi eri osi (näiteks posti indeksit) on eraldi seadistus Kliendi aadressi väljade järjekord , mis defineerib kuidas andmed aadressi väljadel asetsevad. Sama seadistus määrab ka uue kliendikaardi loomisel registrist defineeritud aadressi info täitmise. e-arve aadressi väljade sisu ehitatakse vastavalt siin määratud seadistustele. Viimased kaks valikut siin määravad olukorra, kus Linn (5.valik) või Indeks (6.valik) on kolmandal real.
Seadistust võetakse arvesse ka firma enda aadressi edastamisel, seega peaks ka siin olema andmed samas järjekorras
E-arvete saatmine
Kasutaja ei pea saatmisega eraldi tegelema - kui liides on aktiveeritud ja klient on e-arve vastuvõtuvõimeline, siis arve kinnitamisel määratakse ka e-arve saatmisele (eelduseks on kliendikaardil täidetud ettevõtte reg.number). Seda, kas klient toetab e-arvet või mitte, määrab Directo äriregistri alusel automaatselt (iga öiselt) ja on võimalik näha:
Saatmine toimub taustal eraldi protsessina. Kas saadeti juba või mitte, on näha arvel eraldi märkena:
Kui kuupäev on tavakirjas, on arve saatmisele määratud, kuid pole veel saadetud. Paksus kirjas kuupäev tähendab seda, et saatmine on toimunud.
RIKi saadetud arvet sinna enam uuesti saata ei saa
Saatmisele määramine toimub kohe peale kinnitamist. Üldine hea tava on see, et peale kinnitamist enam midagi ei muudeta - kinnitamine määrabki süsteemi jaoks lõpliku seisu. Mõnikord võib firmas kehtivate protsesside eripärast johtuvalt olla soov reaalset saatmist siiski edasi lükata. Selleks saab määrata saatmisele viivituse:
Süsteemi seadistused > Transport > RIK-earve saatmise viivitus tundides (0-24)
Kui määrata viivituseks näiteks 8 tundi, siis leiab saatmine aset alati töövälisel ajal, mis võimaldab arvet ka peale kinnitamist näiteks uuesti avada ja vajalikud muudatused sisse viia.
PDF väljatrükk
- e-arvega saadetakse kaasa ka PDF kujul trükitav dokument. Kaasa läheb vaikimisi väljatrükk, ehk siis see, mida Trüki nuppu vajutades kuvatakse.
Hea teada
- et näha mis andmed e-arvele jõuavad, saab e-arve kujul arve avada klaviatuuril Alt klahvi all hoides ja siis Trüki nuppu vajutades
- RIK-earve liidese aktiveerimisel hakkab arve kinnitaja kontrollima, kas e-arve vastab standardile. Standard paneb paika näiteks teatud väljade pikkused ja keelab või lubab konkreetsete sümbolite kasutamise. Halvemal juhul võib juhtuda, et kui arve andmetes esinevad mingid anomaaliad, siis ta enam ei kinnitu ehkki enne liidese aktiveerimist kinnitus probleemivabalt. Kuna e-arve loomisel lisatakse sinna andmeid, mis ei ole otseselt arvel, vaid ka näiteks kliendikaardil, aga ka süsteemiseadistustest, võib kuvatav viga segadust tekitada. Seda enam, et validaatori veateated on veidi krüptilised. Analüüsides e-arve XMLi, jõuab vea olemusele tegelikult hõlpsalt jälile, sest välja on toodud vigane sisu ning koht XML-struktuuris.
Näide veateatest:
Arve kuulub edastamiseks e-arvena, kuid saatja/kliendi/arve andmed pole korrektsed, kuna ei valideeru - XSD versioon:1.11 XML Validation: Invalid simple type value: 'ABTÜ222234'. Location: /:Invoice[1]/:InvoiceParties[1]/:BuyerParty[1]/:AccountInfo[1]/:AccountNumber[1]
Arve XML:
Antud veast saame järeldada, et sisu ABTÜ222234 ei sobi InvoiceParties/BuyerParty/AccountInfo/AccountNumber väljale, inimkeelde tõlgituna: kliendi arveldusarve on vigane (sest sisaldab täpitähti, mida standard ei luba).
Aruandlus
Kui tekib küsimus, millised arved on RIK-i saadetud või saatmata, siis annab vastuse aruanne „Arvete nimekiri“ . RIK-i edastatud või edastamata arved saab välja filtreerida aruande määranguga „Väljund“:
- RIK e-arve – RIKi edastatud arved
- pole RIK e-arve – arved, mida pole edastatud RIKi
E-arvete import
Nii Finbite, RIKi kui ka näiteks Unifiedposti (endine: Fitek; endine Opus Capita; endine Itella), aga ka Telema kui ka Envoice e-arve liidesed võimaldavad Directos ostuarveid (või sissetulekuid, aga ka kulutusi) mugavalt vastu võtta. Saabunud dokumendid ilmuvad Üldine > Dokumendid > Dokumentide transport
alla. Vastuvõtmiseks vajalikud seadistused kattuvad saatmise seadistustega. Lisaks neile on oluline, et hankija kaartidel oleksid reg nr täidetud, mille järgi programm saabunud ostuarve hankijaga seob. Kulutuste puhul on kulutaja tuvastamiseks vaja, et kulutajale oleks määratud isikukood.
Uue hankija automaatne loomine
Kui dokumendi loomise käigus ei leita sobivat hankijat (reg.numbri, km.reg numbri, nime, ja arveldusarve järgi tuvastamine ei õnnestu), pakutakse välja järgmine vaba hankija kood (või reg. number, kui süsteemiseadistustes on määratud uue hankija koodiks tulema reg. number).
Soovi korral saab siia asetada (olemasoleva) hankija koodi, kui on soov luua dokument olemasoleva hankijaga (hankija oli näiteks süsteemis olemas, kuid ei tuvastatud mingil põhjusel). Pakutud hankija koodi võib ka muuta mingiks muuks endale sobivaks uue loodava hankija koodiks. Kui sisestatud kood on aga olemas, siis mõistagi luuakse hoopis dokument selle koodiga hankijaga.
Teavitus
Sisenenud ostuarve Directosse jõudmise kohta saab määrata teavitus-emaili, kuhu saadetakse kiri kohe, kui dokument süsteemi jõuab. Selleks on kaks võimalust:
- Süsteemiseadistus
Siseneva e-arve (Dokumentide transport) teavitus e-mail
- Hankija kaart:
Transport>Teavitus e-mail sissetulnud dokumendi puhul
Kui täidetud on punkt 2. siis saadetakse teavitus siin määratud meilile, kui ei, siis süteemiseadistustesse määratud meilile.
Kui on seadistatud Dokumentide automaatne loomine, saabub teavitus juba konkreetse loodud dokumendi (ostuarve või sissetuleku) viitega. Kui automaatset loomist ei teostata (dokumendid jäävad loomisootele Dokumentide transpordi
alla), saabub teavitus viitega konkreetsele transpordi kirjele.
Automaatse dokumentide loomise puhul ebaõnnestunud kirjete loomise kohta teavitust ei saadeta (näiteks kui hankija süsteemis puudub). Seega tuleks aeg-ajalt käia kontrollimas, kas on nö „õhus“ kirjeid, mis on vigased, ning siis sekkuda käsitsi - luua hankija ning määrata järgmine sisenenud dokument sellelt hankijalt juba automaatselt loodama.
Saabunud dokumentide loetelu
- Numbrile klikates avaneb saabunud dokument, kus on võimalik valida, kas genereeritakse ostuarve või sissetulek. Lisaks kuvatakse dokumendi sisu ning ka PDF formaat, mis liigub ostuarve või sissetuleku manuseks.
- Tüüp näitab,millisest kanalist on dokument sisse tulnud
- Firma
- Sisend dok nr
- Dok kuupäev
- Tas.aeg - dokumendi tasumise tähtaeg
- Kellelt
- Summa
- Loodud viitab kuupäevale, millal on dokument sisse tulnud.
- Töödeldud näitab, kas sisse tulnud dokumendist on programmi juba vastav sissetulek või ostuarve genereeritud
- Töödeldi viitab kuupäevale, millal dokumendist ostuarve või sissetulek genereeriti
- Staatus viitab tekkinud veale
- Dokument näitab, mis liiki dokument genereeriti (ostuarve või sissetulek)
- Dok nr. näitab programmi loodud dokumendi numbrit. (see, millisesse seeriasse dokument luuakse on määratud süsteemiseadistuste alt vt punkt Üldine häälestamine) Dok nr klikates on võimalik dokument Directos avada
Saabunud dokumendi töötlemise vaheaken
- Ostuarve - Loob ostuarve
- Sissetulek - Loob sissetuleku
- XML - Kuvab sisenenud eArve XML kujul
- Määra suletuks - Suleb kirje (automaatlooja ei ürita seda enam luua, nimekirjas on kirje mahatõmmatud)
Dokumentide automaatne loomine
Et ostuarve või sissetuleku dokument loodaks automaatselt, tuleks teha järgmist:
- Süsteemi seadistustesse
Transport>Vaikimisi kasutaja
määrata kasutaja kood - selle kasutaja alt luuakse dokument
Tegemist peab olema reaalse kasutajate registris oleva kasutajaga, kellel on õigus dokumenti avada ja luua ning kellele on määratud parool. Lisaks peab kasutajal olema õigus Dokumentide Transpordi moodulile. Veendumaks eelmainitus, võiks selle kasutajaga enne seadistuse määramist sisse logida.
Vaikimisi on valitud Ostuarve, seega kohe kui määratakse Vaikimisi kasutaja
seadistus, hakatakse ostuarveid ka automaatselt looma.
Kui ei soovita konkreetset kirjet luua, tuleb dokumentide transpordi alt see kirje sulgeda või siis määrata hankija kaardil loodavaks dokumendiks -