Directo abi

Kasutaja tarvikud

Lehe tööriistad


et:property_direct

Sisujuht

Property Management Direct liides

Liides on mõeldud kinnisvara halduse lahenduse pakkujate (Real Estate Management / Property Management) liidestamiseks.

Lahenduse eripärad, võttes arvesse Directo loogikat, on seotud kinnisvarahaldurite klientidega. Kui Directos on iga kinnisvaraobjekt eraldi baas, siis kinnisvaras on see eraldi objekt ning kliendid on ühised. Samas on Diretos võimalik ka olukord, kus sama klient on erinevates baasides erineva kliendikoodiga. Ainus ühine osa on ettevõtte reg.nr. ning eraisikutel isikukood. Seetõttu on oluline et reg.nr ja isikukoodid ei oleks directo baasis topelt!

Klientide loomine/haldamine käib tüüpiliselt kinnisvara platvormil - lisab uued kliendid läbi liidese (kliendid sisend) või kontrollib kliendi olemasolu reg.nr. järgi (kliendid väljund).

Hind

Hind ühe baasi kohta vastavalt hinnakirjale
Hind sisaldab:

  • paigaldust
  • standardliidese komponendid:
    • ostuarved väljund
    • kliendid sisend
    • kliendid väljund
    • arvete sisend
  • liidese täiendused (standardi täiendused)

Ühispöördumispunkt

Liidesele ligipääs käib POST meetodil, form/urlencoded järgneva URL'i suhtes: https://login.directo.ee/xmlcore/PropManag/xmlcore.asp

Ligipääsu tagamiseks tuleb kasutada token'it. 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“/>

Testimine

Test web liides https://login.directo.ee/xmlcore/PropManag/webupload.html

Liidese komponendid

Üldine

Väljundliidesed näitavad kõiki kirjeid ning piiranguid saab teha päringu filtritega!

Arvete sisend

Skeem: https://login.directo.ee/xmlcore/propmanag/xml_IN_arved.xsd
what=invoice
put=1

Tegevused

  • lisamine
  • muutmine

Erisused

  • Kliendi koodi asemel võib saata ettevõtte registri numbri. Registi numbri järgi leitakse tegelik kliendi kood
  • Kustutamised tuleb teha Directo UI's
  • Kui ei postitata kas price või sum välja, siis tuleb kontrollida Directo seadistust Arve rea summa või ühiku arvutamine salvestamisel ning muuta korrektseks
  • Kontrolli seadistust Arve on vaikimisi ladumuutev, kuna vaikimisi peaks olema tegu mitte ladumuutvate arvetega.

Transpordi parameetrid häälestamine
Võimalikud transpordi parameetrid:

TÜÜP KOOD PARAMEETER 1PARAMEETER 2Kirjeldus
XML md_changestock 0 INVOICEladumuutev arve (Param.1 =1 on muuda ladu)
XML md_uniqueid lisa_field7 INVOICEAndmebaasi väli, kuhu panna väline unikaalne identifikaator (Nt. kliendi_tellimus, lisa_field7, kliendikaart), kui dokumendi numbrit/koodi ei saadeta, väli „ext_unique_id“ peab ka skeemis olema
XML md_autocustomer_autocode 0INVOICESeotud kliendi loomisel luuakse kood liideses, unikaalne email on vajalik ja kliendi koodi süsteemiseadistused on vajalikud
XML md_update 1 INVOICELuba dokumendi update, kui puuduvad seotud dokumendid
XML md_series DOK INVOICESeeria, juhul kui luuakse dokumendi number liideses, „uniqueid“ transpordi parameeter peab olema ka seadistatud toimimiseks ja skeemis peab olema väli „ext_unique_id“
XML md_object OBJEKT INVOICE Vaikimisi objekt, kui ei saadeta
XML md_stock PLINVOICE Vaikimisi ladu, kui ei saadeta
XML md_confirm 0INVOICE Automaatne dokumendi kinnitamine, seda saab ka juhtida XML väljaga „confirm“
XML md_autocustomer 0 INVOICE Automaatne seotud kliendi loomine, kui kliendi koodi ei eksisteeri
XML md_2_salesman TESTINVOICE Vaikimisi müüja

:!: Oluline md_update parameeter mida on enamus juhtudel vaja. Täpsustada see koostöös partneriga.

Arved päis:

XML väliSQL väliUI väliSelgitus
session_idx for internal use at Directo side, do not send this field!
numbernumberArve document number/ID, mandatory; It must be unique for each document and remain same if more than one transaction of the same document is necessary
dateaegKuupäev ALT.FROM: current time
ordernumbertellimusenrTell. nr.
objectobjektObjekt ALT.FROM: tr.params
projectprojektProjekt
customercodeklient_koodKlient mandatory by default!
customernameklient_nimi ALT.FROM: customer
orderer_codeklient_tellija Tellija
commentkommentaarKommentaar
intcommentsisekommentaarSisekommentaar
salesmanmyyjaMüügiagent ALT.FROM: tr.params > 'XML'
datafield1lisa_field1Lisaväli 1, ! või vastavalt seadetele
datafield2lisa_field2Lisaväli 2, ! või vastavalt seadetele
datafield3lisa_field3Lisaväli 3, ! või vastavalt seadetele
datafield4lisa_field4Lisaväli 4, ! või vastavalt seadetele
datafield5lisa_field5Lisaväli 5, ! või vastavalt seadetele
datafield6lisa_field6Lisaväli 6, ! või vastavalt seadetele
datafield7lisa_field7Lisaväli 7, ! või vastavalt seadetele
contractnumberlepingLeping
statusstaatusStaatus
confirmkinnita „1“ - confirm document
stockladuLadu ALT.FROM: tr.params
customer_regnoklient_regnrKliendikaardil: Reg nr

Arved read:

XML väliSQL väliUI väliSelgitus
itemartikkelArtikkel
descriptionseletusSisu ALT.FROM: item
pricehindÜhikuhind unit price without vat
discountpross%
quantitykogusKogus
unityhikÜhik ALT.FROM: item
sumsummaSumma
accountkontoKonto ALT.FROM: item > item class (depending on vatregion)
objectobjektidObjekt
projectprojektProjekt
vatcodekmkKMkALT.FROM: customer > item > item class (depending on vatregion)
commentr_kommentaarKommentaar
salesmanr_myyjaMüüja
stockr_laduLadu
text1tekst1Tekst1
text2tekst2Tekst2
text3tekst3Tekst3
text4tekst4Tekst4
rnrnNrrow order number in document 1 - N , ALT.FROM: random
rrrvRvrow reference for grouping, otherwise equals to rn , ALT.FROM: equals to rn

Ostuarvete väljund

Skeem: https://login.directo.ee/xmlcore/propmanag/ws_oarved.xsd
what=purchase
get=1
Filter „number“,„date1“,„date2“,„supplier“,„confirmed“,„ts“

Ostu arved päis:

XML väliSQL väliUI väliSelgitus
numbernumber
supplierhankija_kood
supplier_namehankija_nimi
dateaeg
totalsumma
paytermtingimus
duedatetas_aeg
transactiondatekande_aeg
commentkommentaar
supplierinvoicenumberhankija_arve
objectobjekt
currencyvaluuta
currencyreatekurssbv1
confirmedkinnitatud
tsts

Ostu arved read:

XML väliSQL väliUI väliSelgitus
itemartikkel
objectobjekt
projectprojekt
descriptionsisu
amountsumma
vatkm
vatcodekmkood
customerklient_kood
qtykogus
rnrn

Ostu arved menetlused:

XML väliSQL väliUI väliSelgitus
userkasutaja
signatureallkiri_cu
signaturedateallkiri_ts
signaturestatusvastatud 1 - allkirjastatud; 2 - keeldutud
commentkommentaar
user_namekasutaja_nimi
signature_nameallkiri_nimi

Kliendid

Kliendid väljund

Skeem: https://login.directo.ee/xmlcore/propmanag/ws_kliendid.xsd
what=customer
get=1
Filter „code“,„loyaltycard“,„regno“,„email“,„phone“,„closed“,„ts“

XML väliSQL väliUI väliSelgitus
codekoodKood
namenimiNimi
objectobjektObjekt
address1aadress1aadress, ! vastavalt seadetele
address2aadress2aadress, ! vastavalt seadetele
address3aadress3aadress, ! vastavalt seadetele
deliveryaddress1lahaadress1aadress, ! vastavalt seadetele
deliveryaddress2lahaadress2aadress, ! vastavalt seadetele
deliveryaddress3lahaadress3aadress, ! vastavalt seadetele
countymaakondMaakond
countryasumaaAsumaa
contactkontaktEsindaja
phonetelefonTelefon
emailemailMeil
regnoregnrReg nr
vatregnokmregnrKm reg nr
classklassKlass
typeklient_tyypTüüp company = 0, private citizen = 1, government institution = 2
loyaltycardkliendikaartKliendikaart also used for personal ID code
deliverynamenimi_lahetuselNimi lähetusel
deliverymodelahetusviisLäh. viis
faxfaksFaks
commentkommentaarKommentaar
paytermtingimusTas. ting.
vatregionmaaMaa local = 0, EU = 1, export = 2
languagekeelKeel
salesmanmyyjaMüüja
statusstaatusStaatus
accountmanagerkliendihaldurHaldur
destinationsihtriikSihtriik
firstnameeesnimi
lastnameperenimi
vatcodekmkoodKM kood
referencenoviitenumber
closedsuletudSuletud closed = 1
cucuViimati muutis document last changed by
tsts document last changed
kliendid lisa:
XML väliSQL väliUI väliSelgitus
codekood
contentsisu
paramparam

Kliendid sisend

Skeem: https://login.directo.ee/xmlcore/propmanag/xml_IN_kliendid.xsd
what=customer
put=1

Tegevused

  • lisamine
  • muutmine

Erisused

  • Kliendi lisamine registrikoodi järgi - kui kliendi kood on teadmata, siis kasutada välja ext_unique_id, kuhu panna registri number.
  • Kliendi update registrikoodi järgi
  • VATZone on vaikimisi siseriiklik (0)
Kliendid:
XML väliSQL väliUI väliSelgitus
session_idx for internal use at Directo side, do not send this field!
ext_unique_idext_unique_id! vastavalt seadetele if Directo number/code is not used, this is alternative ID; It must be unique for each document and remain same if more than one transaction of the same document is necessary
codekoodKood document number/ID, mandatory; It must be unique for each document and remain same if more than one transaction of the same document is necessary , Kas on võimalik et saadetakse ilma koodita vaid ainult reg.nr ja selle järgi toimub update või insert. Insert puhul on vaja kood
namenimiNimi
objectobjektObjekt
address1aadress1aadress, ! vastavalt seadetele
address2aadress2aadress, ! vastavalt seadetele
address3aadress3aadress, ! vastavalt seadetele
deliveryaddress1lahaadress1aadress, ! vastavalt seadetele
deliveryaddress2lahaadress2aadress, ! vastavalt seadetele
deliveryaddress3lahaadress3aadress, ! vastavalt seadetele
countymaakondMaakond
countryasumaaAsumaa
contactkontaktEsindaja
phonetelefonTelefon
emailemailMeil mandatory , Võimalik lisada mitu meili aadressi semikooloniga eraldatud
regnoregnrReg nr
vatregnokmregnrKm reg nr
noticemargukiriMärgukirjad yes = 1
birthdayklient_synnipaevSünnipäev
genderklient_suguSugu female = 1, male = 0
classklassKlass
typeklient_tyypTüüp company = 0, private citizen = 1, government institution = 2
loyaltycardkliendikaartKliendikaart also used for personal ID code
deliverynamenimi_lahetuselNimi lähetusel
deliverymodelahetusviisLäh. viis
alerthoiatusHoiatus
factoringarvetasubArve tasub
faxfaksFaks
commentkommentaarKommentaar
paytermtingimusTas. ting.
vatzonemaaKM maa local = 0, EU = 1, export = 2 , Vaikimisi siseriiklik (0)
languagekeelKeel
salesmanmyyjaMüüja
bankpankPank
bankaccountarveldusarveA/a
urlURLUrl
statusstaatusStaatus
accountmanagerkliendihaldurHaldur
dealtypetehinguliikTehinguliik
creditlimitlimiitLimiit
priceformulahinnakiriHinnavalem
specialpriceformulahinnavalem_eriEripakkumised
discountaleSoodus %
destinationsihtriikSihtriik
firstnameeesnimi
lastnameperenimi
vatcodekmkoodKM kood
extcodevaline_koodVäline kood
closedsuletud
Kliendid lisa:
XML väliSQL väliUI väliSelgitus
codekood
contentsisuSisu
paramparamParameeter
et/property_direct.txt · Viimati muutnud: 2024/05/02 13:01 persoon toomas
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki