Bauwise standardliides

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.

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

Ü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
    • BW aktsepteeritud - Bauwisest tagasi postitatud
• Liides toetab ka menetluse allkirja punkte ja menetluse uuendusi (refresh peale Bauwise saatmist).
• 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)!

Ostuarvete sisendi erisused

• Menetluse info lisab Bauwise ning Directo liides vaikimisi menetlejaid juurde ei lisa. Vajadusel saab seda lahendada after_save protseduuriga
• Ridade kulukonto:
  • liides saadab,
  • 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,
  • kui kõik eelnevad tingimused on täitmata, siis jääb konto tühjaks.
• Ridade objektid:
  • Bauwise postitab ostuarve ridadele projekti koodi ning kõik projektikaardil olevad objektid lisab liides
• Ridade km-kood:
  • liides saadab,
  • 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,
  • liides ei saada ja hankija km kood on täitmata, jääb km kood tühjaks.
• Vaikimisi kogus:
  • kui saadetakse artikkel, siis täidetakse kogus artiklikaardi vaikimisi kogus väärtusega.
• ETTEMAKS
  • 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 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.

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“

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“