Erinevused

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

--- et:bauwise_integration [2026/03/05 12:16] – [Sisend] toomas
+++ et: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.
+**Viited**
+[[https://bauwise.atlassian.net/wiki/spaces/KB/pages/726827009/K+ibemaksum+rade+muutmine+2025 |Bauwise häälestuse juhend ]]
 =====Hind =====
@@ Rida 19: / Rida 23: @@
   * 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 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 **
@@ Rida 40: / Rida 44: @@
 --data-urlencode 'ts='
 </code>
-=====API võti =====
+=====Token / API võti =====
 Et leida liidese XML võti ja edastada see arendajale:
   - Logi Directosse sisse kasutajaga kellel on ''SUPER'' õigused \\
@@ Rida 49: / Rida 53: @@
-=====Oluline =====
+===== Oluline =====
-**Üldine**
-  * Väljundliidesed näitavad kõiki kirjeid ning piiranguid saab teha päringu filtritega!
+**Eeldused enne juurutust**
-  * 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.
+Mõlemas süsteemis peavad kattuma:
-  * Kasutajad peavad olema loodud mõlemas süsteemis identsete koodidega.
+  * **Projektid** – identsed koodid mõlemas süsteemis; ostuarve ridadel peab olema Directo projekti kood.
-  * Liides eeldab, et dokumentide manuseid hoitakse **Sharepointis**.
+  * **Kasutajad** – identsed koodid mõlemas süsteemis.
-  * Süsteemiseadistus "e-arve põhjal ostuarve loomisel täidetakse ka jagatav summa" peab olema valikuga "käibemaksuta".
+  * :!: **Prefiksid** – kontrolli, kas Bauwise nõuab koodidele prefiksit: objektidel (alamprojekt ''AP_'', leping ''WP_'', töökood ''EAK_'') ja projektidel (''PR_'').
-  * 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:
+Seadistused:
-      * ''BW menetlus'' – tavaline ostuarve staatus BW saatmiseks
+  * **Kulukohtade seosetabel** – Bauwise-s sisestatakse kulukohti, kuid Directo dokumendiridadele on vaja finantskontosid. Seetõttu peab Bauwise-s olema seosetabel kulukohtade ja Directo kontode vahel.
-      * ''BW EM menetlus''- ettemaksuarve staatus BW saatmiseks (kulu konto on vara oma)
+  * **Manused** – liides eeldab, et dokumentide manuseid hoitakse **Sharepointis**.
-      * ''BW erimenetlus'' – tähendab, et tuleb read kaasa võtta ja tagasi postitada erand on ettemaksu kasutamine kuluarvel
+  * **Süsteemiseadistus** – „e-arve põhjal ostuarve loomisel täidetakse ka jagatav summa" peab olema valikuga „käibemaksuta".
-      * ''BW aktsepteeritud'' - Bauwisest tagasi postitatud
-  * Liides toetab ka menetluse allkirja punkte ja menetluse uuendusi (refresh peale Bauwise saatmist).
+**Ostuarve staatused** – Bauwise valib staatuse järgi, milliseid ostuarveid alla laadida.
-  * :!: 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)!
+^ 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**
-     * 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 141: / Rida 152: @@
 what=transaction \\
 put=1 \\
-transpordi parameetrid=bw_update, bw_autoproject
+transpordi parameetrid=bw_update, bw_autoproject \\
 tüüp: XML, kood: bw_update, param1: 1, param2: TRANSACTION