Bauwise standardliides on mõeldud klientidele kes kasutavad Directot ostuarve loomisel ning Bauwise toimub info töötlemine ja Directo ostuarvete täiendamine. Uued objektid luuakse nii Directo, kui ka Bauwise poolel.

Erisuste puhul liides ei sobi ning siis tuleb teha eriliides.

Viited

Bauwise häälestuse juhend

Bauwise liidese kuutasu on vastavalt XML liidese komponentidele ~80 €/kuus + km. Täpne hind sõltub valitud komponentidest:

• Sisendid: kulutused, projektid, ostuarved ja objektid
• 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.

Võrreldes tavapärase xmlcore liidestega on Bauwise liidese puhul kasutusel uus ühine pöördumispunkt. Sellest tulenevalt on mõned erisused millega peab arvestama.

Erisused

• 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 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

Token asendab vanemat tüüpi liideste appkey ja andmebaasi nime korraga. Token tuleb POST meetodil muutujas TOKEN (sarnaselt siis html vormi postitamisele) saata antud URL'i pihta tulemuse saamiseks. Ebakorrektse või valesti saadetud tokeni korral on vastus <result type=„5“ desc=„Unauthorized“/>

Kui ei kasuta muutujat TOKEN, siis on vastus <err>token required</err>

curl näide

curl --location 'https://login.directo.ee/xmlcore/cap_bauwise/xmlcore.asp' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=••••••' \
--data-urlencode 'get=1' \
--data-urlencode 'what=supplier' \
--data-urlencode 'code=' \
--data-urlencode 'type=' \
--data-urlencode 'ts='

Et leida liidese XML võti ja edastada see arendajale:

1. Logi Directosse sisse kasutajaga kellel on SUPER õigused
   
2. 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'
   
   
3. Liigu Admin sakile
   
   
4. Liigu sektsioonini XML liidesed
   
5. Real Bauwise vajuta nuppu et näha võtit

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.

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

• Menetlejad – menetluse info lisab Bauwise. Directo liides vaikimisi menetlejaid juurde ei lisa, vajadusel saab seda lahendada after_save protseduuriga.
• Ridade väljade täitmine – kasutatakse esimest täidetud allikat:

• Objektid – Bauwise postitab reale projekti koodi, liides lisab kõik projektikaardil olevad objektid.
• Kogus – kui saadetakse artikkel, täidetakse kogus artiklikaardi vaikimisi kogusega.

Ettemaks

Ettemaksu artikkel peab olema häälestatud nii, et Kinkekaart = Ettemaks ja Seeria nr = Seerianumber. Siis leitakse ridadele postitatud ettemaksu artiklile SN (seerianumber).

1. 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.
2. 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).

Väljund skeema: https://login.directo.ee/xmlcore/cap_bauwise/ws_oarved.xsd
what=purchase
get=1
Filter „number“,„date1“,„date2“,„supplier“,„confirmed“,„status“,„ts“

Sisend skeema: https://login.directo.ee/xmlcore/cap_bauwise/xml_IN_oarved.xsd
what=purchase
put=1
transpordi parameetri prefix=bw_
transpordi parameetrid=autosupplier, uniqueid, autosupplier_autocode, series, confirm, supplier_update
näide tüüp=XML KOOD=bw_series PARAMETER1=DOK

Väljund skeema: https://login.directo.ee/xmlcore/cap_bauwise/ws_kulutused.xsd
what=expense
get=1
Filter „number“,„date1“,„date2“,„status“,„ts“

Sisend skeema: https://login.directo.ee/xmlcore/cap_bauwise/xml_IN_kulutused.xsd
what=expense
put=1

Väljund skeema: https://login.directo.ee/xmlcore/cap_bauwise/ws_laekumised.xsd
what=receipt
get=1
Filter „number“,„date1“,„date2“,„confirmed“,„ts“

Väljund skeema: https://login.directo.ee/xmlcore/cap_bauwise/ws_tasumised.xsd
what=payment
get=1
Filter „number“,„date1“,„date2“,„confirmed“,„ts“

Väljund skeema: https://login.directo.ee/xmlcore/cap_bauwise/ws_kanded.xsd
what=transaction
get=1
Filter „number“,„date1“,„date2“,„type“,„ts“

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

Väljund skeema: https://login.directo.ee/xmlcore/cap_bauwise/ws_projektid.xsd
what=project
get=1
Filter „code“,„customer“,„supplier“,„orderer“,„contract“,„closed“,„ts“

Sisend skeema: https://login.directo.ee/xmlcore/cap_bauwise/xml_IN_projektid.xsd
what=project
put=1

Väljund skeema: https://login.directo.ee/xmlcore/cap_bauwise/ws_hankijad.xsd
what=supplier
get=1
Filter „code“,„regno“,„email“,„closed“,„type“,„ts“

Väljund skeema: https://login.directo.ee/xmlcore/cap_bauwise/ws_kliendid.xsd
what=customer
get=1
Filter „code“,„loyaltycard“,„regno“,„email“,„phone“,„closed“,„type“,„ts“

Väljund skeema: https://login.directo.ee/xmlcore/cap_bauwise/ws_objektid.xsd
what=object
get=1
Filter „code“,„master“,„type“,„level“,„ts“

Sisend skeema: https://login.directo.ee/xmlcore/cap_bauwise/xml_in_objektid.xsd
what=object
put=1

Väljund skeema: https://login.directo.ee/xmlcore/cap_bauwise/ws_kustutamised.xsd
what=delete
get=1
Filter „document“,„ts“