Contracts (contract)

Contracts. Domain: Project.


what	`contract`
Direction	Output (get), Input (put)
Endpoint	`POST https://login.directo.ee/xmlcore/cap_xml_direct/xmlcore.asp`
Schema (output)	ws_lepingud.xsd
Schema (input)	xml_IN_lepingud.xsd

Output (get)

Query (get)

Parameter	Description
`token`	interface token (required)
`get`	1
`what`	contract
`code`	optional filter
`customer`	optional filter
`supplier`	optional filter
`type`	optional filter
`status`	optional filter
`ts`	changed-since (for syncing)

XML field	SQL field	Type	Length	UI label	Description
`number`	number	int	9	Number
`salestart`	aeg_myyk	dateTime		Müük algus
`salesperiod`	per_myyk	int		Periood	every how many months the invoice would be generated
`salesperiodtype`	per_myyk_tyyp	int		Tüüp	month = 0; day = 1
`purchasestart`	aeg_ost	dateTime		Ost algus
`purchaseperiod`	per_ost	int		Periood
`purchaseperiodtype`	per_ost_tyyp	int		Tüüp	month = 0; day = 1
`salesterm`	tingimus_myyk	string	32	Tingimus
`purchasterm`	tingimus_ost	string	32	Tingimus
`priceformula`	hinnakiri	string	32	Hinnavalem
`salesobject`	objekt_myyk	string	255	Objekt
`purchaseobject`	objekt_ost	string	255	Objekt
`salescurrency`	valuuta_myyk	string	32	Valuuta
`purchasecurrency`	valuuta_ost	string	32	Valuuta
`customer`	klient_kood	string	32	Klient
`customername`	klient_nimi	string	255	Nimi
`supplier`	hankija_kood	string	32	Hankija
`suppliername`	hankija_nimi	string	255	Nimi
`project`	projekt	string	32	Projekt
`stock`	ladu	string	32	Ladu
`purchasestart2`	aeg_ost2	dateTime		Ostu lõpp
`salesend`	aeg_myyk2	dateTime		Müügi lõpp
`purchasecontract`	leping_ost	string	100	O lepingu algus
`salescontract`	leping_myyk	string	100	M lepingu algus
`comment`	kommentaar	string	255	Kommentaar
`relatedcontract`	seotud_leping	int		Seotud leping
`language`	keel	string	32	Keel
`resource`	ressurss	int		Ressurss
`fine`	viivis	int		Viivis
`salescost`	maksumus_myyk	decimal		Maksumus
`purchasecost`	maksumus_ost	decimal		Maksumus
`class`	klass	string	32	Klass
`salescomment`	kommentaar_myyk	string	255	Müügi kommentaar
`purchasecomment`	kommentaar_ost	string	255	Ostu kommentaar
`salescontractend`	garantii_myyk	dateTime		Lepingu lõpu kuupäev
`purchasecontractend`	garantii_ost	dateTime		Lepingu lõpu kuupäev
`salesman`	myyja	string	32	Müüja
`employee`	kasutaja	string	32
`supervisor`	vastutaja	string	32	Vastutaja
`vatcountry`	maa	int	1	Maa
`datafield1`	lisa_field1	string	100
`datafield2`	lisa_field2	string	100
`datafield3`	lisa_field3	string	100
`datafield4`	lisa_field4	string	50
`datafield5`	lisa_field5	string	50
`datafield6`	lisa_field6	string	50
`datafield7`	lisa_field7	string	50
`salescontact`	esindaja_myyk	string	100	Nende esindaja
`purchasecontact`	esindaja_ost	string	100	Nende esindaja
`salesmanager`	meie_esindaja_myyk	string	100	Meie esindaja
`purchasemanager`	meie_esindaja_ost	string	100	Meie esindaja
`salescontractstart`	aeg_leping_myyk	dateTime		M lepingu algus
`purchasecontractstart`	aeg_leping_ost	dateTime		O lepingu algus
`salesperiodtypeperiod`	per_myyk_periood	int		Perioodi valik	Advanced exact = 0; End exact= 1; Advanced month =
`orderer`	klient_tellija	string	32	Tellija
`manager2`	vastutaja2	string	32	Vastutaja 2
`asset`	inventar	string	32	Inventar
`salesemail`	email_myyk	string		Meil
`adupinvoices`	liida_arved	int		liida arved	sum up= 1
`finepercent`	viivis_protsent	decimal		Viivis
`nextcontrol`	jargmine_kontroll	dateTime		Järgmine kontroll
`status`	staatus	string	32	Staatus
`salesphone`	telefon_myyk	string	255
`closed`	suletud	int	1	Suletud	closed = 1
`salessum`	kokku_myyk	decimal		Kokku
`salesvat`	kaibemaks_myyk	decimal		KM
`salestotal`	tasuda_myyk	decimal		Tasuda
`purchasesum`	kokku_ost	decimal		Kokku
`purchasevat`	kaibemaks_ost	decimal		KM
`purchasetotal`	tasuda_ost	decimal		Tasuda
`createdts`	aeg_loodud	dateTime		Loodud
`createdcu`	looja	string	32	Looja
`cu`	cu	string	32	Viimati muutis	document last changed by
`ts`	ts	dateTime		Viimati muutis	document last changed

Rows

XML field	SQL field	Type	Length	UI label	Description
`type`	tyyp	int	1		sales = 0; purchase = 1; rent = 2
`code`	kood	string	32	Kood
`name`	nimi	string	255	Nimi
`qty`	kogus	decimal		Kogus
`price`	hind	decimal		Hind
`discount`	ale	decimal		%
`object`	objekt	string	255	Objekt
`project`	projekt	string	32	Projekt
`account`	konto	string	32	Konto
`vatcode`	kmk	int		KM kood
`actionplan`	tegevusplaan	string	32	Tegevusplaan
`start`	r_aeg1	dateTime		Algus
`end`	r_aeg2	dateTime		Lõpp või rendi puhul Tegelik lõpp
`user`	tegija	string	32	Tegija
`unit`	yhik	string	32	Ühik
`asset`	r_inventar	string	32	Inventar
`status`	r_staatus	string	32	Staatus- ainult rent tüüpi lepingul
`intcomment`	r_sisekommentaar	string	255	Sisekommentaar
`comment`	r_kommentaar	string	255	Kommentaar
`end2`	r_lopp	dateTime		Arvatav lõpp ainult rent tüüpi lepingul
`initialstart`	r_algne_aeg2	dateTime
`extid`	ext_id	int
`rn`	rn	int		Nr	row order number in document 1 - N
`rr`	rv	int		Rv	row reference for grouping, otherwise equals to rn

Input (put)

Create: send the document. Modify: requires xd_update=1 and posting the whole document. Default values (ALT.FROM): Mandatory fields.

A confirmed document cannot be modified (response Type=14).

Header

XML field	SQL field	Type	Length	Mandatory	UI label	Description
`number`	number	int	9	yes	Number	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
`salestart`	aeg_myyk	dateTime			Müük algus
`salesperiod`	per_myyk	int			Periood	every how many months the invoice would be generated
`salesperiodtype`	per_myyk_tyyp	int			Tüüp	month = 0; day = 1
`purchasestart`	aeg_ost	dateTime			Ost algus
`purchaseperiod`	per_ost	int			Periood
`purchaseperiodtype`	per_ost_tyyp	int			Tüüp	month = 0; day = 1
`salesterm`	tingimus_myyk	string	32		Tingimus	ALT.FROM: customer
`purchasterm`	tingimus_ost	string	32		Tingimus	ALT.FROM: supplier
`priceformula`	hinnakiri	string	32		Hinnavalem	ALT.FROM: customer
`salesobject`	objekt_myyk	string	255		Objekt	ALT.FROM: customer
`purchaseobject`	objekt_ost	string	255		Objekt	ALT.FROM: supplier
`salescurrency`	valuuta_myyk	string	32		Valuuta	ALT.FROM: customer > glob.setting > EUR
`purchasecurrency`	valuuta_ost	string	32		Valuuta	ALT.FROM: supplier
`customer`	klient_kood	string	32		Klient
`customername`	klient_nimi	string	255		Nimi	ALT.FROM: customer
`supplier`	hankija_kood	string	32		Hankija
`suppliername`	hankija_nimi	string	255		Nimi	ALT.FROM: supplier
`project`	projekt	string	32		Projekt
`stock`	ladu	string	32		Ladu	ALT.FROM: tr.setting
`purchasestart2`	aeg_ost2	dateTime			Ostu lõpp
`salesend`	aeg_myyk2	dateTime			Müügi lõpp
`purchasecontract`	leping_ost	string	100		O lepingu algus
`salescontract`	leping_myyk	string	100		M lepingu algus
`comment`	kommentaar	string	255		Kommentaar
`relatedcontract`	seotud_leping	int			Seotud leping
`language`	keel	string	32		Keel	ALT.FROM: customer > supplier
`resource`	ressurss	int			Ressurss
`fine`	viivis	int			Viivis
`salescost`	maksumus_myyk	decimal			Maksumus
`purchasecost`	maksumus_ost	decimal			Maksumus
`class`	klass	string	32		Klass
`salescomment`	kommentaar_myyk	string	255		Müügi kommentaar
`purchasecomment`	kommentaar_ost	string	255		Ostu kommentaar
`salescontractend`	garantii_myyk	dateTime			Lepingu lõpu kuupäev
`purchasecontractend`	garantii_ost	dateTime			Lepingu lõpu kuupäev
`salesman`	myyja	string	32		Müüja	ALT.FROM: tr.setting > XML
`employee`	kasutaja	string	32
`supervisor`	vastutaja	string	32		Vastutaja
`vatcountry`	maa	int	1		Maa	ALT.FROM: customer > supplier
`datafield1`	lisa_field1	string	100
`datafield2`	lisa_field2	string	100
`datafield3`	lisa_field3	string	100
`datafield4`	lisa_field4	string	50
`datafield5`	lisa_field5	string	50
`datafield6`	lisa_field6	string	50
`datafield7`	lisa_field7	string	50
`salescontact`	esindaja_myyk	string	100		Nende esindaja
`purchasecontact`	esindaja_ost	string	100		Nende esindaja
`salesmanager`	meie_esindaja_myyk	string	100		Meie esindaja
`purchasemanager`	meie_esindaja_ost	string	100		Meie esindaja
`salescontractstart`	aeg_leping_myyk	dateTime			M lepingu algus
`purchasecontractstart`	aeg_leping_ost	dateTime			O lepingu algus
`salesperiodtypeperiod`	per_myyk_periood	int			Perioodi valik	Advanced exact = 0; End exact= 1; Advanced month =
`orderer`	klient_tellija	string	32		Tellija
`manager2`	vastutaja2	string	32		Vastutaja 2
`asset`	inventar	string	32		Inventar
`salesemail`	email_myyk	string			Meil	ALT.FROM: customer
`adupinvoices`	liida_arved	int			liida arved	sum up= 1
`finepercent`	viivis_protsent	decimal			Viivis	ALT.FROM: customer > glob.setting
`nextcontrol`	jargmine_kontroll	dateTime			Järgmine kontroll
`status`	staatus	string	32		Staatus
`salesphone`	telefon_myyk	string	255
`closed`	suletud	int	1		Suletud	closed = 1
`customer_type`	klient_tyyp	int	32		Kliendikaardil: Tüüp	company = 0, private citizen = 1, government institution = 2
`customer_regno`	klient_regnr	string	50		Kliendikaardil: Reg nr
`customer_class`	klient_klass	string	32		Kliendikaardil: Klass
`customer_loyaltycard`	klient_kliendikaart	string	100		Kliendikaardil: Kliendikaart
`supplier_regno`	hankija_regnr	string	50		Hankija kaardil: Reg. nr

Do not send:

session_id – for internal use at Directo side, do not send this field!

Rows

XML field	SQL field	Type	Length	UI label	Description
`type`	tyyp	int	1		sales = 0; purchase = 1; rent = 2
`code`	kood	string	32	Kood
`name`	nimi	string	255	Nimi	ALT.FROM: item
`qty`	kogus	decimal		Kogus
`price`	hind	decimal		Hind
`discount`	ale	decimal		%
`object`	objekt	string	255	Objekt	ALT.FROM: item
`project`	projekt	string	32	Projekt	ALT.FROM: item
`account`	konto	string	32	Konto	ALT.FROM: item > item class (depending on vatregion)
`vatcode`	kmk	int		KM kood	ALT.FROM: customer > item > item class (depending on vatregion)
`actionplan`	tegevusplaan	string	32	Tegevusplaan
`start`	r_aeg1	dateTime		Algus
`end`	r_aeg2	dateTime		Lõpp või rendi puhul Tegelik lõpp
`user`	tegija	string	32	Tegija
`unit`	yhik	string	32	Ühik	ALT.FROM: item
`asset`	r_inventar	string	32	Inventar
`status`	r_staatus	string	32	Staatus- ainult rent tüüpi lepingul
`intcomment`	r_sisekommentaar	string	255	Sisekommentaar
`comment`	r_kommentaar	string	255	Kommentaar
`end2`	r_lopp	dateTime		Arvatav lõpp ainult rent tüüpi lepingul
`initialstart`	r_algne_aeg2	dateTime
`extid`	ext_id	int
`rn`	rn	int		Nr	row order number in document 1 - N ALT.FROM: random
`rr`	rv	int		Rv	row reference for grouping, otherwise equals to rn ALT.FROM: equals to rn

Extra fields

XML field	SQL field	Type	Length	UI label
`code`	kood	string	32
`content`	sisu	string	2000	Sisu
`param`	param	string	64	Parameeter

Transport parameters

Component-specific; add from the source wiki if this component has parameters.

Response

docid = number of the created/updated document. Error codes: Responses and error codes.

<results>
  <Result Type="0" Desc="Created" docid="100001" doctype="CONTRACT" submit="Contracts"/>
</results>