Bauwise standardliides

Bauwise standard liides 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:

• Sisendid: ostuarved ja objektid
• Väljundid: ostuarved, 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/bauwise/webupload.html
  
• Ligipääsu pöördumispunkt (Base URL): https://login.directo.ee/xmlcore/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/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 Token (XML võtit):
1. Logi Directosse sisse kasutajaga kellel on SUPER õigused
2. 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.
• 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.
• Kui postitakse ridadele ettemaksu artikkel, siis leitakse sellele SN (seerianumber). Ettemaksu artikkel peab olema häälestatud nii, et Kinkekaart= Ettemaks ja Seeria nr=Seerianumber.

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

Sisend skeema: https://login.directo.ee/xmlcore/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/bauwise/ws_kanded.xsd
what=transaction
get=1
Filter „number“,„date1“,„date2“,„type“,„ts“

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

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

Väljund skeema: https://login.directo.ee/xmlcore/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/bauwise/ws_objektid.xsd
what=object
get=1
Filter „code“,„master“,„type“,„level“,„ts“

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

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