Quotations (quotation)

Quotations. Domain: Sales.


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

Output (get)

Query (get)

Parameter	Description
`token`	interface token (required)
`get`	1
`what`	quotation
`number`	optional filter
`customercode`	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	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
`version`	versioon	int		Versioon	ALT.FROM: 1
`type`	tyyp	string	50
`validity`	kehtivus	string	50
`ourrep`	meie_esindaja	string	100
`ordercomment`	tellimusekommentaar	string	255
`customercode`	klient_kood	string	32	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
`email`	field53	string	255	meil	ALT.FROM: customer
`phone`	telefon	string	100	Telefon	ALT.FROM: customer
`fax`	faks	string	50	Faks
`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
`text1`	tekst1	string	4000	Tekst1, ! või vastavalt seadetele	or infinite (slower)
`text2`	tekst2	string	4000	Tekst2, ! või vastavalt seadetele	or infinite (slower)
`deliveryname`	klient_nimi_lahetusele	string	200	Nimi lähetusel
`vatzone`	maa	int		Maa	local = 0, EU = 1, export = 2 ALT.FROM: customer > 0
`priceformula`	hinnakiri	string	32	Hinnavalem
`salesman`	myyja	string	30	Müügiagent	ALT.FROM: tr.params > 'XML'
`currency`	valuuta	string	32	Valuuta	ALT.FROM: glob.settings > 'EUR'
`currencyrate`	kurssbv1	decimal		Kurss	ALT.FROM: ECB current published rates
`language`	keel	string	32	Keel	ALT.FROM: customer
`factoring`	arvetasub	string	32	Arve tasub	ALT.FROM: customer
`project`	projekt	string	32	Projekt
`vatregno`	kmregnumber	string	32	KM Reg. nr	ALT.FROM: customer
`country`	asumaa	string	2	Sihtriik	ALT.FROM: customer
`status`	staatus	string	50	Staatus
`confirmed`	kinnitatud	int	1		confirmed
`delivery`	lahetusaeg	dateTime		Lähetusaeg
`deliveryterm`	lahetustingimus	string	32	Läh. ting.	ALT.FROM: customer
`manager`	haldur	string	32	Vastutaja
`customerordernumber`	field54	string	100	Kliendi tell. nr.
`vat`	kaibemaks	decimal
`sum`	summa	decimal
`total`	summakokku	decimal
`cu`	cu	string	32	Viimati muutis	document last changed by
`ts`	ts	dateTime

Rows

XML field	SQL field	Type	Length	UI label	Description
`item`	artikkel	string	255	Artikkel
`description`	nimetus	string	255	Sisu	ALT.FROM: item
`price`	yhikuhind	decimal		Ühikuhind	unit price without vat
`quantity`	kogus	decimal		Kogus
`discount`	ale	decimal		%
`purchaseprice`	ostuhind	decimal		Ostuhind	ALT.FROM: item
`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)
`sn`	sn	string	128	Seerianr
`project`	projekt	string	32	Projekt	ALT.FROM: item > item class
`unit`	yhik	string	32	Ühik	ALT.FROM: item
`comment`	r_kommentaar	string	200	Kommentaar
`variant`	variant	string	32	Variant
`salesman`	r_myyja	string	32	Müüja
`sum`	summa	decimal		Summa
`package`	pakis	decimal		Pakis	ALT.FROM: item
`stock`	r_ladu	string	32	Ladu
`height`	korgus	decimal		Kõrgus
`width`	laius	decimal		Laius
`depth`	sygavus	decimal		Sügavus
`volume`	maht	decimal		Maht
`weight`	kaal	decimal		Kaal
`deliverytime`	lahetusaeg	dateTime		Lähetusaeg
`date1`	r_aeg1	dateTime
`date2`	r_aeg2	dateTime
`periods`	perioodid	string
`text1`	tekst1	string
`text2`	tekst2	string
`text3`	tekst3	string
`text4`	tekst4	string
`constant1`	konstant1	decimal
`constant2`	konstant2	decimal
`constant3`	konstant3	decimal
`constant4`	konstant4	decimal
`orderqty`	tellitud	decimal
`invoiceqty`	arvega	decimal
`object`	field9	string	255	Objekt
`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

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).
Confirmation can be controlled via the XML field confirm (in addition to xd_confirm).

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
`ext_unique_id`	ext_unique_id	string	100		! 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
`version`	versioon	int			Versioon	ALT.FROM: 1
`type`	tyyp	string	50
`validity`	kehtivus	string	50
`ourrep`	meie_esindaja	string	100
`ordercomment`	tellimusekommentaar	string	255
`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
`email`	email	string	255		meil	ALT.FROM: customer
`phone`	telefon	string	100		Telefon	ALT.FROM: customer
`fax`	faks	string	50		Faks
`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
`text1`	tekst1	string	4000		Tekst1, ! või vastavalt seadetele	or infinite (slower)
`text2`	tekst2	string	4000		Tekst2, ! või vastavalt seadetele	or infinite (slower)
`deliveryname`	klient_nimi_lahetusele	string	200		Nimi lähetusel
`vatzone`	maa	int			Maa	local = 0, EU = 1, export = 2 ALT.FROM: customer > 0
`priceformula`	hinnakiri	string	32		Hinnavalem
`salesman`	myyja	string	30		Müügiagent	ALT.FROM: tr.params > 'XML'
`currency`	valuuta	string	32		Valuuta	ALT.FROM: glob.settings > 'EUR'
`currencyrate`	kurssbv1	decimal			Kurss	ALT.FROM: ECB current published rates
`language`	keel	string	32		Keel	ALT.FROM: customer
`factoring`	arvetasub	string	32		Arve tasub	ALT.FROM: customer
`project`	projekt	string	32		Projekt
`vatregno`	kmregnumber	string	32		KM Reg. nr	ALT.FROM: customer
`country`	asumaa	string	2		Sihtriik	ALT.FROM: customer
`status`	staatus	string	50		Staatus
`confirm`	kinnita	int	1			confirm document = 1
`deliverydate`	lahetusaeg	dateTime			Lähetusaeg
`deliveryterm`	lahetustingimus	string	32		Läh. ting.	ALT.FROM: customer
`manager`	haldur	string	32		Vastutaja	ALT.FROM: kliendilt
`nextcontact`	jargmine_kontakt_aeg	dateTime
`timeclose`	sulgemise_aeg	dateTime
`competitor`	konkurendid	string
`closeingcomment`	sulgemise_komm	string
`statuschanged`	staatus_muutus	dateTime
`budget`	eelarve	int
`prepaymentpercentage`	e_pross	decimal
`campaignnotallowed`	keela_kampaania	int
`contract`	leping	int
`validitycomment`	kehtivuse_kommentaar	string
`customerorderno`	field54	string	50		Kliendi tell. nr.
`probability`	toenaosus	decimal
`asset`	inventar	string	255
`dealtype`	tehinguliik	string	255
`deliverytermcomment`	lahetustingimus_komm	string	255
`deliverymethodcomment`	lahetusviis_komm	string	255
`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

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	255	Artikkel
`description`	nimetus	string	255	Sisu	ALT.FROM: item
`price`	yhikuhind	decimal		Ühikuhind	unit price without vat
`quantity`	kogus	decimal		Kogus
`discount`	ale	decimal		%
`purchaseprice`	ostuhind	decimal		Ostuhind	ALT.FROM: item
`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)
`sn`	sn	string	128	Seerianr
`project`	projekt	string	32	Projekt	ALT.FROM: item > item class
`unit`	yhik	string	32	Ühik	ALT.FROM: item
`comment`	r_kommentaar	string	200	Kommentaar
`variant`	variant	string	32	Variant
`salesman`	r_myyja	string	32	Müüja
`sum`	summa	decimal		Summa
`package`	pakis	decimal		Pakis	ALT.FROM: item
`stock`	r_ladu	string	32	Ladu
`height`	korgus	decimal		Kõrgus
`width`	laius	decimal		Laius
`depth`	sygavus	decimal		Sügavus
`volume`	maht	decimal		Maht
`weight`	kaal	decimal		Kaal
`deliverydate`	lahetusaeg	dateTime		Lähetusaeg
`date1`	r_aeg1	dateTime
`date2`	r_aeg2	dateTime
`periods`	perioodid	string
`text1`	tekst1	string
`text2`	tekst2	string
`text3`	tekst3	string
`text4`	tekst4	string
`constant1`	konstant1	decimal
`constant2`	konstant2	decimal
`constant3`	konstant3	decimal
`constant4`	konstant4	decimal
`replacementitem`	artikkel_asendus	string	32
`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

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="QUOTATION" submit="Quotations"/>
</results>

Directo help

Table of Contents

Quotations (quotation)

Output (get)

Query (get)

Header

Rows

Input (put)

Header

Rows

Transport parameters

Response