Orders (order)

Orders. Domain: Sales.


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

Output (get)

Query (get)

Parameter	Description
`token`	interface token (required)
`get`	1
`what`	order
`number`	optional filter
`customercode`	optional filter
`class`	optional filter
`orderercode`	optional filter
`project`	optional filter
`customerordernumber`	optional filter
`stock`	optional filter
`status`	optional filter
`date1`	period start
`date2`	period end
`ts`	changed-since (for syncing)

XML field	SQL field	Type	Length	UI label	Description
`number`	number	int	9	Tellimus
`date`	aeg	string		Kuupäev
`delivery`	lahetusaeg	dateTime		Lähetusaeg
`reqdelivery`	soovitud_lahetusaeg	dateTime		Soov.läh.aeg
`vatzone`	maa	int		Maa	local = 0, EU = 1, export = 2
`paymentterm`	tingimus	string	32	T-ting
`quotation`	pakkumine	int	9	Pakkumine
`priceformula`	hinnakiri	string	32	Hinnavalem
`object`	objekt	string	255	Objekt
`currency`	valuuta	string	32	Valuuta
`currate`	kurssbv1	decimal		Kurss
`language`	keel	string	32	Keel
`factoring`	arvetasub	string	32	Arve tasub
`project`	projekt	string	32	Projekt
`customercode`	klient_kood	string	32	Klient
`customername`	klient_nimi	string	200
`salesman`	myyja	string	30	Müügiagent
`vatregno`	kmregnumber	string	32	KM Reg. nr
`deliveryterm`	lahetustingimus	string	32	Läh. ting.
`deliverymethod`	lahetusviis	string	32	Lähetusviis
`deliverymethodcomment`	lahetusviis_komm	string	255	Lähetusviisi kommentaar
`customerordernumber`	kliendi_tellimus	string	100	Kliendi tell. nr.
`email`	email	string	255	meil
`fax`	faks	string	50	Faks
`stock`	ladu	string	32	Ladu
`country`	asumaa	string	2	Sihtriik
`status`	staatus	string	50	Staatus
`manager`	haldur	string	32	Vastutaja
`comment`	kommentaar	string	255	Kommentaar
`contact`	esindaja	string	100	Nende esindaja
`datafield1`	lisa_field1	string	255	Lisaväli 1
`datafield2`	lisa_field2	string	255	Lisaväli 2
`datafield3`	lisa_field3	string	255	Lisaväli 3
`datafield4`	lisa_field4	string	255	Lisaväli 4
`datafield5`	lisa_field5	string	255	Lisaväli 5
`datafield6`	lisa_field6	string	255	Lisaväli 6
`datafield7`	lisa_field7	string	255	Lisaväli 7
`text1`	tekst1	string		Tekst1	infinite
`text2`	tekst2	string		Tekst2	infinite
`phone`	telefon	string	100	Telefon
`confirmed`	kinnitatud	int	1		confirmed document = 1
`deliveryname`	klient_nimi_lahetusel	string	200	Nimi lähetusel
`address1`	aadress1	string	255	! vastavalt seadetele
`address2`	aadress2	string	200	! vastavalt seadetele
`address3`	aadress3	string	100	! vastavalt seadetele
`deliveryaddress1`	lahetusaadress1	string	255	! vastavalt seadetele
`deliveryaddress2`	lahetusaadress2	string	200	! vastavalt seadetele
`deliveryaddress3`	lahetusaadress3	string	100	! vastavalt seadetele
`type`	tell_tyyp	string	32	Tüüp
`closed`	suletud	int	9	Suletud	closed document = 1
`ts`	ts	string			document last changed

Rows

XML field	SQL field	Type	Length	UI label	Description
`item`	artikkel	string	255	Artikkel
`description`	nimetus	string	255	Sisu
`price`	yhikuhind	decimal		Ühikuhind	unit price without vat
`delivery`	lahetatud	decimal		Lähetatud
`oninvoice`	arvega	decimal		Arvega
`quantity`	kogus	decimal		Kogus
`discount`	pross	decimal
`unit`	yhik	string	32	Ühik
`comment`	r_kommentaar	string	200	Kommentaar
`variant`	variant	string	32	Variant
`sum`	summa	decimal		Summa
`object`	objekt	string	255	Objekt
`project`	projekt	string	32	Projekt
`vatcode`	kmkood	int		KMk
`stock`	r_ladu	string	32	Ladu
`deliverytime`	lahetusaeg	dateTime		Lähetusaeg
`date1`	r_aeg1	dateTime		Algus
`date2`	r_aeg2	dateTime		Lõpp
`rn`	rn	int
`rr`	rv	int

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 can be modified only when xd_updateconfirmed=1; otherwise the response is Type=14.
Transport parameter xd_order_assemble=1 triggers order assembly with item recipes.

Header

XML field	SQL field	Type	Length	Mandatory	UI label	Description
`number`	number	int	9	yes	Tellimus	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
`customercode`	klient_kood	string	32	yes	Klient	mandatory by default!
`customername`	klient_nimi	string	200			ALT.FROM: customer
`date`	aeg	dateTime			Kuupäev	ALT.FROM: current time
`address1`	aadress1	string	255		aadress, ! vastavalt seadetele	ALT.FROM: customer
`address2`	aadress2	string	200		aadress, ! vastavalt seadetele	ALT.FROM: customer
`address3`	aadress3	string	100		aadress, ! vastavalt seadetele	ALT.FROM: customer
`deliveryaddress1`	lahetusaadress1	string	255		lähetusaadress, ! vastavalt seadetele
`deliveryaddress2`	lahetusaadress2	string	200		lähetusaadress, ! vastavalt seadetele
`deliveryaddress3`	lahetusaadress3	string	100		lähetusaadress, ! vastavalt seadetele
`paymentterm`	tingimus	string	32		T-ting	ALT.FROM: customer kui on kasutusel laekumiste loomine, läheb see kood ka laekumise makseviisiks
`deliverymethod`	lahetusviis	string	32		Lähetusviis	ALT.FROM: customer
`deliverymethodcomment`	lahetusviis_komm	string	255		Lähetusviisi kommentaar
`customerordernumber`	kliendi_tellimus	string	100		Kliendi tell. nr.
`email`	email	string	255		meil	ALT.FROM: customer
`phone`	telefon	string	100		Telefon	ALT.FROM: customer
`fax`	faks	string	50		Faks
`comment`	kommentaar	string	255		Kommentaar
`stock`	ladu	string	32		Ladu	ALT.FROM: tr.params
`object`	objekt	string	255		Objekt	ALT.FROM: tr.params
`contact`	esindaja	string	100		Nende esindaja	ALT.FROM: customer
`datafield1`	lisa_field1	string	255		Lisaväli 1, ! või vastavalt seadetele
`datafield2`	lisa_field2	string	255		Lisaväli 2, ! või vastavalt seadetele
`datafield3`	lisa_field3	string	255		Lisaväli 3, ! või vastavalt seadetele
`datafield4`	lisa_field4	string	255		Lisaväli 4, ! või vastavalt seadetele
`datafield5`	lisa_field5	string	255		Lisaväli 5, ! või vastavalt seadetele
`datafield6`	lisa_field6	string	255		Lisaväli 6, ! või vastavalt seadetele
`datafield7`	lisa_field7	string	255		Lisaväli 7, ! või vastavalt seadetele
`paymenttotal`	laekumine_summa	decimal				positive number will create receipt with same doc. number
`vatzone`	maa	int			Maa	local = 0, EU = 1, export = 2 ALT.FROM: customer > 0
`priceformula`	hinnakiri	string	32		Hinnavalem
`currency`	valuuta	string	32		Valuuta	ALT.FROM: glob.settings > 'EUR'
`currencyrate`	kurssbv1	decimal			Kurss	ALT.FROM: ECB current published rates
`vatregno`	kmregnumber	string	32		KM Reg. nr	ALT.FROM: customer
`country`	asumaa	string	2		Sihtriik	ALT.FROM: customer
`status`	staatus	string	50		Staatus
`delivery`	lahetusaeg	dateTime			Lähetusaeg
`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_loyaltycard`	klient_kliendikaart	string	100		Kliendikaardil: Kliendikaart
`salesman`	myyja	string	30		Müügiagent	ALT.FROM: customer > tr.params > 'XML'
`project`	projekt	string	32		Projekt
`deliveryname`	klient_nimi_lahetusel	string	200		Nimi lähetusel
`factoring`	arvetasub	string	32		Arve tasub	ALT.FROM: customer
`deliveryterm`	lahetustingimus	string	32		Läh. ting.
`language`	keel	string	32		Keel	ALT.FROM: customer
`dealtype`	tehinguliik	string	2		Tehinguliik
`reqdelivery`	soovitud_lahetusaeg	dateTime
`suletud`	suletud	int	9		Tellimus
`text1`	tekst1	string	4000		Tekst1, ! või vastavalt seadetele	or infinite (slower)
`text2`	tekst2	string	4000		Tekst2, ! või vastavalt seadetele	or infinite (slower)
`type`	tyyp	string	32		Tüüp

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
`item`	artikkel	string	32	Artikkel
`description`	nimetus	string	255	Sisu	ALT.FROM: item
`price`	yhikuhind	decimal		Ühikuhind	unit price without vat
`quantity`	kogus	decimal		Kogus
`discount`	pross	decimal		%
`account`	konto	string	255	Konto	ALT.FROM: item > item class (depending on vatregion)
`vatcode`	kmkood	int		KMk	ALT.FROM: customer > item > item class (depending on vatregion)
`unit`	yhik	string	32	Ühik	ALT.FROM: item
`comment`	r_kommentaar	string	200	Kommentaar
`variant`	variant	string	32	Variant
`rsum`	rsum	decimal		RSKM (kui on saadetud price/ühikuhind, siis rskm'i ei kasutata)
`deliverytime`	lahetusaeg	dateTime		Lähetusaeg
`requesteddeliverytime`	soovitud_lahetusaeg	dateTime		Soovitud lähetusaeg
`stock`	r_ladu	string	32	Ladu
`project`	projekt	string	32	Projekt	ALT.FROM: item > item class
`purchaseprice`	ostuhind	decimal		Ostuhind
`object`	objekt	string	255	Objekt	ALT.FROM: item > item class
`oid`	oid	int
`ext_sum`	ext_sum	decimal
`ext_id`	ext_id	int
`date1`	r_aeg1	dateTime		Algus
`date2`	r_aeg2	dateTime		Lõpp
`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

Transport parameters

Configured on the token (interface), not sent in xmldata. PARAMETER 2 = document type.

TYPE	CODE	PARAMETER 1	PARAMETER 2	DESCRIPTION
XML	`xd_stock`	PL	ORDER	Default warehouse if not sent
XML	`xd_object`	VEEB	ORDER	Default object if not sent
XML	`xd_autocustomer`	1	ORDER	Auto-create linked customer if code not found
XML	`xd_confirm`	0	ORDER	Auto-confirm document; also via XML field confirm
XML	`xd_update`	1	ORDER	Allow update when no linked documents
XML	`xd_salesman`	XML	ORDER	Default salesman
XML	`xd_updateconfirmed`	1	ORDER	Allow modifying a confirmed document

Response

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

<results>
  <Result Type="0" Desc="Created" docid="100001" doctype="ORDER" submit="Orders"/>
</results>