Directo abi

Kasutaja tarvikud

Lehe tööriistad


et:bauwise_integration

Erinevused

Siin näed erinevusi valitud versiooni ja hetkel kehtiva lehekülje vahel.

Lõlita võrdlemise vaatele

Both sides previous revisionPrevious revision
Next revision		Previous revision
et:bauwise_integration [2025/04/02 14:05] – [Väljund] toomaset:bauwise_integration [2026/10/19 14:43] (Hetkel kehtiv) – [Oluline] raili
Rida 5: Rida 5:
  
 Erisuste puhul liides ei sobi ning siis tuleb teha eriliides.  Erisuste puhul liides ei sobi ning siis tuleb teha eriliides. 
 +
 +**Viited**
 +
 +[[https://bauwise.atlassian.net/wiki/spaces/KB/pages/726827009/K+ibemaksum+rade+muutmine+2025 |Bauwise häälestuse juhend ]]
 =====Hind ===== =====Hind =====
  
-Bauwise liidese kuutasu on vastavalt XML liidese komponentidele [[https://directo.ee/hinnad#Liidesed|~80 €/kuus + km]] sõltub valitud komponentidest:+Bauwise liidese kuutasu on vastavalt XML liidese komponentidele [[https://directo.ee/hinnad#Liidesed|~80 €/kuus + km]]. Täpne hind sõltub valitud komponentidest:
  
-  * Sisendid: ostuarved ja objektid +  * Sisendid: kulutused, projektid, ostuarved ja objektid 
-  * Väljundid: ostuarved, kanded, projektid, objektid, hankijad, kliendid, kustutamised (tasuta)+  * Väljundid: kulutused, ostuarved, laekumised, tasumised, kanded, projektid, objektid, hankijad, kliendid, kustutamised (tasuta)
  
 Kõik uuendused sisalduvad kuupõhises tasus. Samuti sisalduvad kuutasus ka paigalduskulud. Kõik uuendused sisalduvad kuupõhises tasus. Samuti sisalduvad kuutasus ka paigalduskulud.
Rida 19: Rida 23:
   * Testimise web vorm: https://login.directo.ee/xmlcore/cap_bauwise/webupload.html \\   * Testimise web vorm: https://login.directo.ee/xmlcore/cap_bauwise/webupload.html \\
   * Ligipääsu pöördumispunkt (Base URL):  https://login.directo.ee/xmlcore/cap_bauwise/xmlcore.asp \\   * Ligipääsu pöördumispunkt (Base URL):  https://login.directo.ee/xmlcore/cap_bauwise/xmlcore.asp \\
-  * Ligipääsu tagamiseks tuleb kasutada token'it [[et:bauwise_integration#token|Tokeni leidmine]]+  * Ligipääsu tagamiseks tuleb kasutada token'it [[et:bauwise_integration#tokenapi_voti|Tokeni leidmine]]
   * **Kui on juba vanemat tüüpi Bauwise liides kasutusel, siis uus ja vana ei saa korraga toimida ning uue lisamisel lõpetab vana töötamise **   * **Kui on juba vanemat tüüpi Bauwise liides kasutusel, siis uus ja vana ei saa korraga toimida ning uue lisamisel lõpetab vana töötamise **
  
Rida 40: Rida 44:
 --data-urlencode 'ts=' --data-urlencode 'ts='
 </code> </code>
-====Token  ==== +=====Token / API võti ===== 
-Et leida liidese Token (XML võtit): \\ +Et leida liidese XML võti ja edastada see arendajale: 
-1. Logi Directosse sisse kasutajaga kellel on ''SUPER'' õigused \\ +  - Logi Directosse sisse kasutajaga kellel on ''SUPER'' õigused \\ 
-2. Ava töötaja kaart 'XML' \\ {{:et:toomas20230213-104217.png?300}} \\ +  - Kuna API võtmeid võib olla mitu, siis pead avama töötaja kaardi kellele on võti loodud. Näiteks ava töötaja kaart 'XML' \\ {{:et:toomas20250905-114646.png?400}} \\ 
-3. Liigu ''Admin'' sakile \\ {{:et:toomas20230213-104458.png}} \\ +  - Liigu ''Admin'' sakile \\ {{:et:toomas20230213-104458.png?400}} \\ 
-4. Liigu sektsioonini ''XML liidesed'' \\ +  - Liigu sektsioonini ''XML liidesed'' \\ 
-5. Real ''Bauwise'' vajuta nuppu {{:et:toomas20230213-104941.png?50}} et näha võtit \\+  - Real ''Bauwise'' vajuta nuppu {{:et:toomas20230213-104941.png?50}} et näha võtit
  
-=====Oluline ===== 
-**Üldine** 
-  * Väljundliidesed näitavad kõiki kirjeid ning piiranguid saab teha päringu filtritega! 
-  * On vajalik, et projektid on loodud mõlemas süsteemis identsete koodidega. 
-  * Bauwise-s kulukohtade ja Directo kontode vahel peab olema seosetabel, kuna Bauwise-s sisestatakse kulukohtasid, mitte kontosid aga Directosse peavad jõudma finantskontod dokumendi ridadele. 
-  * Kasutajad peavad olema loodud mõlemas süsteemis identsete koodidega. 
-  * Liides eeldab, et dokumentide manuseid hoitakse **Sharepointis**. 
-  * Süsteemiseadistus "e-arve põhjal ostuarve loomisel täidetakse ka jagatav summa" peab olema valikuga "käibemaksuta". 
-  * Et Bauwise teaks, mis dokumendid vajavad allalaadimist, on vajalik häälestada ostuarvele staatused. Näiteks „BW menetlus“, „BW aktsepteeritud“. Staatuste järgi saab Bauwise poolelt hääestada mis ostuarveid laetakse. 
-    * Ostuarve staatused: 
-      * ''BW menetlus'' – tavaline ostuarve staatus BW saatmiseks 
-      * ''BW EM menetlus''- ettemaksuarve staatus BW saatmiseks (kulu konto on vara oma) 
-      * ''BW erimenetlus'' – tähendab, et tuleb read kaasa võtta ja tagasi postitada erand on ettemaksu kasutamine kuluarvel 
  
-  * Liides toetab ka menetluse allkirja punkte ja menetluse uuendusi (refresh peale Bauwise saatmist). +===== Oluline ===== 
-  * :!: Enne juurutust kontrollida kas Bauwise kasutuselevõtmine nõuab **Objektidel** (alamprojekt ''AP_''; lepingud ''WP_'' ja Töökood ''EAK_'') **Projektidel** (''PR_'') lisa prefiksi kasutusele võtmist (Bauwise poolne vajadus)!+ 
 +**Eeldused enne juurutust** 
 + 
 +Mõlemas süsteemis peavad kattuma: 
 +  * **Projektid** – identsed koodid mõlemas süsteemis; ostuarve ridadel peab olema Directo projekti kood. 
 +  * **Kasutajad** – identsed koodid mõlemas süsteemis. 
 +  * :!: **Prefiksid** – kontrolli, kas Bauwise nõuab koodidele prefiksit: objektidel (alamprojekt ''AP_'', leping ''WP_'', töökood ''EAK_'') ja projektidel (''PR_''). 
 + 
 +Seadistused: 
 +  * **Kulukohtade seosetabel** – Bauwise-s sisestatakse kulukohti, kuid Directo dokumendiridadele on vaja finantskontosid. Seetõttu peab Bauwise-s olema seosetabel kulukohtade ja Directo kontode vahel. 
 +  * **Manused** – liides eeldab, et dokumentide manuseid hoitakse **Sharepointis**. 
 +  * **Süsteemiseadistus** – „e-arve põhjal ostuarve loomisel täidetakse ka jagatav summa" peab olema valikuga „käibemaksuta". 
 + 
 +**Ostuarve staatused** – Bauwise valib staatuse järgi, milliseid ostuarveid alla laadida. 
 + 
 +^ Staatus ^ Kasutus ^ 
 +| ''BW menetlus'' | Tavaline ostuarve Bauwise-sse saatmiseks | 
 +| ''BW EM menetlus'' | Ettemaksuarve Bauwise-sse saatmiseks (kulukonto on varakonto) | 
 +| ''BW erimenetlus'' | Read võetakse kaasa ja postitatakse tagasi (nt ettemaksu kasutamine kuluarvel) | 
 +| ''BW aktsepteeritud'' | Bauwisest tagasi postitatud | 
 +| ''BW keeldumine'' | Bauwise-s keeldutud dokument, alati koos keeldumise kommentaariga | 
 + 
 +**Liidese käitumine** 
 +  * Väljundliidesed näitavad kõiki kirjeid, piiranguid saab teha päringu filtritega. 
 +  * Liides toetab menetluse allkirja punkte ja menetluse uuendusi (refresh pärast Bauwise-sse saatmist).
  
 **Ostuarvete sisendi erisused** **Ostuarvete sisendi erisused**
-     * Menetluse info lisab Bauwise ning Directo liides vaikimisi menetlejaid juurde ei lisa. Vajadusel saab seda lahendada ''after_save'' protseduuriga + 
-     * Ridade kulukonto: +  * **Menetlejad** – menetluse info lisab Bauwise. Directo liides vaikimisi menetlejaid juurde ei lisa, vajadusel saab seda lahendada ''after_save'' protseduuriga. 
-        * liides saadab, +  * **Ridade väljade täitmine** – kasutatakse esimest täidetud allikat: 
-        * kui saadetakse artikkel aga puudub konto, siis konto võetakse artikli/klassi ostukontolt, + 
-        * kui liides ei saada kontot ega artiklit, siis Directo lisab ostuarve ridadele konto hankija LS konto väljalt, +^ Väli ^ 1. ^ 2. ^ 3. ^ Muidu ^ 
-        * kui kõik eelnevad tingimused on täitmata, siis jääb konto tühjaks. +| **Kulukonto** | Liidese saadetud konto | Artikli/klassi ostukonto (kui saadetakse artikkel) | Hankija LS konto | Jääb tühjaks | 
-     * Ridade objektid: +| **KM-kood** | Liidese saadetud kood | Artikli/klassi kood hankija km maa järgi (kui saadetakse artikkel) | Hankija km kood | Jääb tühjaks | 
-       * Bauwise postitab ostuarve ridadele projekti koodi ning kõik projektikaardil olevad objektid lisab liides + 
-     * Ridade km-kood: +  * **Objektid** – Bauwise postitab reale projekti koodi, liides lisab kõik projektikaardil olevad objektid. 
-        * liides saadab, +  * **Kogus** – kui saadetakse artikkel, täidetakse kogus artiklikaardi vaikimisi kogusega. 
-        * kui saadetakse artikkel aga puudub km kood, siis km kood võetakse artikli/klassi küljest vastavalt hankijakaardile määratud km maale, + 
-        * kui liides ei saada km koodi ega artiklit, siis Directo lisab ostuarve ridadele km kood hankija km kood väljalt, +**Ettemaks** 
-        * liides ei saada ja hankija km kood on täitmata, jääb km kood tühjaks. + 
-      * Vaikimisi kogus: +Ettemaksu artikkel peab olema häälestatud nii, et ''Kinkekaart = Ettemaks'' ja ''Seeria nr = Seerianumber''. Siis leitakse ridadele postitatud ettemaksu artiklile SN (seerianumber). 
-        * kui saadetakse artikkel, siis täidetakse kogus artiklikaardi vaikimisi kogus väärtusega. + 
-      * **ETTEMAKS** +  - **Ettemaksuarve saatmine** – staatus alati ''BW EM menetlus''. Jagatav summa on neto, ridadel kliendi etteantud varakonto. Igal real peab olema kogus ja artikkel, mis tuleb ka tagasi postitada. Kuna ettemaks võib jaguneda mitme projekti vahel, postitatakse artikkel tagasi igale reale. 
-        * Kui postitakse ridadele ettemaksu artikkel, siis leitakse sellele SN (seerianumber). Ettemaksu artikkel peab olema häälestatud nii, et ''Kinkekaart= Ettemaks'' ja ''Seeria nr=Seerianumber''. +  - **Ettemaksu kasutamine** – staatus ''BW menetlus'' või ''BW erimenetlus''. Iga kinnitatud ettemaksuarve saab oma SN, mis tuleb tagasi postitada. Mõistlikum on tagasi postitada kogu rida ettemaksu artiklina koos täidetud SN-iga (klient täpsustab, millised need on, kui see on oluline).
-        * Ettemaksu protsess: +
-          * **Ettemaksuarve saatmine BW** – alati staatus BW EM menetlus, jagatav summa (neto), ridadel varakonto, mille klient on etteandnud, real peab olema märgitud kogus ja artikkel, mis tuleb ka tagasi postitada. Kuna tegemist on ettemaksuarve kinnitamisega, siis ettemaks võib olla mitmel ehitusobjektile (Directos projektile), tuleb igale reale tagasi postitada artikkel. +
-          * **Ettemaksu kasutamine** – staatus BW menetlus või BW erimenetlus – Directo tarkavarast lähtuvalt saab iga ettemaks, mis on ettemaksuarvena kinnitatud oma SN, mis tuleb tagasi postitada. Kõige mõistlikum on tagasi postitada kogu rida kui ettemaksu artikkel (klient ütleb, mis need on kui see on oluline) ja sn on täidetud. +
  
  
Rida 102: Rida 114:
 transpordi parameetrid=autosupplier, uniqueid, autosupplier_autocode, series, confirm, supplier_update \\ transpordi parameetrid=autosupplier, uniqueid, autosupplier_autocode, series, confirm, supplier_update \\
 ''näide tüüp=XML KOOD=bw_series PARAMETER1=DOK''  ''näide tüüp=XML KOOD=bw_series PARAMETER1=DOK'' 
 +
 +====Kulutused ====
 +===Väljund===
 +Väljund skeema: https://login.directo.ee/xmlcore/cap_bauwise/ws_kulutused.xsd \\
 +what=expense \\
 +get=1 \\
 +**Filter** "number","date1","date2","status","ts"
 +===Sisend===
 +Sisend skeema: https://login.directo.ee/xmlcore/cap_bauwise/xml_IN_kulutused.xsd \\
 +what=expense \\
 +put=1 \\
 +
 +====Laekumised ====
 +===Väljund===
 +Väljund skeema: https://login.directo.ee/xmlcore/cap_bauwise/ws_laekumised.xsd \\
 +what=receipt \\
 +get=1 \\
 +**Filter** "number","date1","date2","confirmed","ts"
 +
 +====Tasumised ====
 +===Väljund===
 +Väljund skeema: https://login.directo.ee/xmlcore/cap_bauwise/ws_tasumised.xsd \\
 +what=payment \\
 +get=1 \\
 +**Filter** "number","date1","date2","confirmed","ts"
  
 ====Kanded==== ====Kanded====
Rida 109: Rida 146:
 get=1 \\ get=1 \\
 **Filter** "number","date1","date2","type","ts" **Filter** "number","date1","date2","type","ts"
 +
 +
 +===Sisend ===
 +Sisend skeema: https://login.directo.ee/xmlcore/cap_bauwise/xml_IN_kanded.xsd \\
 +what=transaction \\
 +put=1 \\
 +transpordi parameetrid=bw_update, bw_autoproject \\
 +tüüp: XML, kood: bw_update, param1: 1, param2: TRANSACTION
  
 ====Projektid==== ====Projektid====
Rida 116: Rida 161:
 get=1 \\ get=1 \\
 **Filter** "code","customer","supplier","orderer","contract","closed","ts" **Filter** "code","customer","supplier","orderer","contract","closed","ts"
 +===Sisend=== 
 +Sisend skeema: https://login.directo.ee/xmlcore/cap_bauwise/xml_IN_projektid.xsd \\ 
 +what=project \\ 
 +put=1 \\
  
 ====Hankijad==== ====Hankijad====
Rida 139: Rida 187:
  
 ===Sisend=== ===Sisend===
-Sisend skeema: https://login.directo.ee/xmlcore/bauwise/xml_in_objektid.xsd \\+Sisend skeema: https://login.directo.ee/xmlcore/cap_bauwise/xml_in_objektid.xsd \\
 what=object \\ what=object \\
 put=1 \\ put=1 \\
Rida 145: Rida 193:
 ====Kustutamised ==== ====Kustutamised ====
 ===Väljund=== ===Väljund===
-Väljund skeema: https://login.directo.ee/xmlcore/bauwise/ws_kustutamised.xsd \\+Väljund skeema: https://login.directo.ee/xmlcore/cap_bauwise/ws_kustutamised.xsd \\
 what=delete                 \\ what=delete                 \\
 get=1 \\ get=1 \\
et/bauwise_integration.1743591906.txt.gz · Viimati muutnud: 2025/04/02 14:05 persoon toomas
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki