Erinevused

Siin näed erinevusi valitud versiooni ja hetkel kehtiva lehekülje vahel.

--- et:xml_direct [2025/12/16 16:29] – [Table] toomas
+++ et:xml_direct [2026/01/20 11:15] (Hetkel kehtiv) – [Table] toomas
@@ Rida 22: / Rida 22: @@
 Ligipääsuks tuleb kasutada token'it (vaata eelmises peatükis saadud ''API võti''). 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“/>'' ja  kui ei kasuta muutujat TOKEN, siis on vastus ''<err>token required</err>''
-**curl näide **
+{{page>et:xmlcore#ueldised_tehnilised_nouded}}
+====curl näited ====
+**get **
 <code>
 curl --location 'https://login.directo.ee/xmlcore/cap_xml_direct/xmlcore.asp' \
@@ Rida 31: / Rida 35: @@
 --data-urlencode 'ts=xx.xx.xxxx'
 </code>
+:!: ts on siin näites filter, et pärida ainult muutunud andmeid
+**put**
+<code>
+url --location 'https://login.directo.ee/xmlcore/cap_xml_direct/xmlcore_maht.asp' \
+--header 'Content-Type: application/x-www-form-urlencoded' \
+--data-urlencode 'token=••••••' \
+--data-urlencode 'put=1' \
+--data-urlencode 'what=order' \
+--data-urlencode 'xmldata=<?xml version="1.0" encoding="utf-8"?>
+<orders>
+    <order number="100034" date="2024-07-11T00:00:00" vatzone="0" paymentterm="K" object="xx,WEB,XML,WEBSHOP" currency="EUR" currate="1.000000000" customercode="TEST1" customername="Test klient OÜ" salesman="XML" deliverymethod="KULLER" customerordernumber="#1" email="xx.yyy@directo.ee" stock="PL" country="EE" phone="+372xxxxxx" address1="Mõisa tee 4" address2="10101, Tallinn" address3="Eesti" deliveryaddress1="Mõisa 4" deliveryaddress2="10101, Tallinn" deliveryaddress3="Eesti" deliveryname="deliveryname3" factoring="001" deliveryterm="CFR" language="eng" deliverymethodcomment="Testing field" text1="Testing field 2" text2="Testing field 3">
+        <rows>
+            <row item="0001" price="37.5" quantity="1" sum="37.5" rn="1" rr="1"/>
+            <row item="0002" price="20.83" quantity="1" sum="20.83" rn="2" rr="2"/>
+        </rows>
+		 <attachments>
+			<attachment>
+				<data>VGVzdA==</data>
+				<name>Test.txt</name>
+      </attachment>
+    </attachments>
+    </order>
+</orders>'
+</code>
 =====Hind ======
 **Hind sõltub valitud komponentidest.** \\
@@ Rida 70: / Rida 97: @@
 | Artikli ajalugu (itemhistoryrow)              |                                         |  [[et:xml_direct#artikliajalugu_itemhistoryrow| x  ]]                                    |
 | Hinnavalemi read (priceformularow)            |                                         |  [[et:xml_direct#hinnavalemi_read_price_formula_rows| x ]]                               |
+| Laod (stock)                                  |                                         |  [[et:xml_direct#laod_stock| x  ]]                                                       |
 | Laoseis (stocklevel)                          |                                         |  [[et:xml_direct#laoseis_stock_levels| x  ]]                                             |
 | Laoseis variantidega (stocklevel_variant_sn)  |                                         |  [[et:xml_direct#laoseis_stock_levels| x  ]]                                             |
@@ Rida 86: / Rida 114: @@
 | Finantskanded (transaction)                   |  [[et:xml_direct#kanded| x  ]]          |  [[et:xml_direct#finantskanded_transactions_ja_finantskande_read_transactionrows| x  ]]  |
 | Finantskanderead (transactionrow)             |                                         |  [[et:xml_direct#finantskanded_transactions_ja_finantskande_read_transactionrows| x  ]]  |
-| Projektid (project)                           |                                         |  [[et:xml_direct#projektid_project| x  ]]                                                |
+| Projektid (project)                           |  [[et:xml_direct#projektid| x]]         |  [[et:xml_direct#projektid_project| x  ]]                                                |
 | Ressursid (resource)                          |  [[et:xml_direct#ressursid| x  ]]       |  [[et:xml_direct#ressursid_resource| x  ]]                                               |
 | Kasutajad(user)                               |  [[et:xml_direct#kasutajad| x  ]]       |  [[et:xml_direct#kasutajad_user| x  ]]                                                   |
@@ Rida 416: / Rida 444: @@
 ==Tellimuse transpordi parameetrid ==
-^TÜÜP^KOOD^PARAMEETER 1^PARAMEETER 2^SELGITUS^
+^ TÜÜP  ^ KOOD                      ^ PARAMEETER 1  ^ PARAMEETER 2  ^ SELGITUS                                                                                                                     ^
-|XML|xd_stock|PL|ORDER|Vaikimisi ladu, kui ei saadeta|
+| XML   | xd_stock                  | PL            | ORDER         | Vaikimisi ladu, kui ei saadeta                                                                                               |
-|XML|xd_object|VEEB|ORDER|Vaikimisi objekt, kui ei saadeta|
+| XML   | xd_object                 | VEEB          | ORDER         | Vaikimisi objekt, kui ei saadeta                                                                                             |
-|XML|xd_autocustomer|1|ORDER|Automaatne seotud kliendi loomine, kui kliendi koodi ei eksisteeri|
+| XML   | xd_autocustomer           | 1             | ORDER         | Automaatne seotud kliendi loomine, kui kliendi koodi ei eksisteeri                                                           |
-|XML|xd_confirm|0|ORDER|Automaatne dokumendi kinnitamine, seda saab ka juhtida XML väljaga "confirm"|
+| XML   | xd_confirm                | 0             | ORDER         | Automaatne dokumendi kinnitamine, seda saab ka juhtida XML väljaga "confirm"                                                 |
-|XML|xd_update|1|ORDER|Luba dokumendi update, kui puuduvad seotud dokumendid|
+| XML   | xd_update                 | 1             | ORDER         | Luba dokumendi update, kui puuduvad seotud dokumendid                                                                        |
-|XML|xd_autocustomer_autocode|0|ORDER|Seotud kliendi loomisel luuakse kood liideses, unikaalne email on vajalik ja kliendi koodi süsteemiseadistused on vajalikud|
+| XML   | xd_autocustomer_autocode  | 0             | ORDER         | Seotud kliendi loomisel luuakse kood liideses, unikaalne email on vajalik ja kliendi koodi süsteemiseadistused on vajalikud  |
-|XML|xd_customer_update|0|ORDER|Kliendi andmete osaline update, (nimi, email, telefon) või vastavalt spekile|
+| XML   | xd_customer_update        | 0             | ORDER         | Kliendi andmete osaline update, (nimi, email, telefon) või vastavalt spekile                                                 |
-|XML|xd_salesman|XML|ORDER|Vaikimisi müüja|x
+| XML   | xd_salesman               | XML           | ORDER         | Vaikimisi müüja                                                                                                              |
-|XML|xd_confirmpayment|1|ORDER|Automaatne laekumise kinnitamine|
+| XML   | xd_confirmpayment         | 1             | ORDER         | Automaatne laekumise kinnitamine                                                                                             |
-|XML|xd_paymentvatcode|11|ORDER|Loodava seotud laekumise rea km kood, laekumine tekib välja „paymentamount“ saatmisel, mis peab skeemis olemas olema |
+| XML   | xd_paymentvatcode         | 11            | ORDER         | Loodava seotud laekumise rea km kood, laekumine tekib välja „paymentamount“ saatmisel, mis peab skeemis olemas olema         |
-|XML|xd_order_assemble|1|ORDER|Käivitab tellimuse komplekteerija retseptidega artiklitele |
+| XML   | xd_order_assemble         | 1             | ORDER         | Käivitab tellimuse komplekteerija retseptidega artiklitele                                                                   |
+| XML   | xd_updateconfirmed        | 1             | ORDER         | Lubab kinnitatud tellimuse muutmist                                                                                          |
 Tellimuse vaikimisi väärtuste seadistamiseks loe täpsemalt [[https://wiki.directo.ee/et/kohustuslik|siit]]
@@ Rida 1105: / Rida 1134: @@
 |rn|rn| | |
+==Tellimuse transpordi parameetrid ==
+^ TÜÜP  ^ KOOD                      ^ PARAMEETER 1  ^ PARAMEETER 2  ^ SELGITUS                                                                                                                     ^
+| XML   | xd_updateconfirmed        | 1             | PURCHASEORDER         | Lubab kinnitatud ostutellimuse muutmist                                                                                          |
@@ Rida 1184: / Rida 1217: @@
 ^XML väli^SQL väli^UI väli^Selgitus^
 |session_id|x| | for internal use at Directo side, do not send this field! |
+|ext_unique_id|ext_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 |
 |number|number|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 |
 |date|aeg|Arve aeg| ALT.FROM: current time |
@@ Rida 1233: / Rida 1267: @@
 |confirm|kinnita|Olek| "1" - confirm document |
-==read ==
+==read: ==
 ^XML väli^SQL väli^UI väli^Selgitus^
 |account|konto|Konto| |
@@ Rida 1265: / Rida 1299: @@
 ==manused ==
-^XML väli^SQL väli^UI väli^Selgitus^
+^ XML väli         ^ SQL väli              ^ UI väli  ^ Selgitus                                                                                                                                                                                                                                                                                                     ^
-|name |attachment_name | | |
+| element: data    | attachment            |          | Use this field when the document attachment is stored internally in Directo. Embedded attachment that will be saved to Directo server, size is unlimited, but whole XML size limit is 19 Mb                                                                                                                  |
-|description |attachment_kirjeldus | | |
+| element:name     | attachment_name       |          | Use this field when the document attachment is stored internally in Directo. This field MUST be used exclusively and MUST NOT be combined with SharePoint, Google Drive or Public URL attachment fields.                                                                                                     |
-|code |kood| | for updating excisting attachments, do not send this field for new attachments |
+| attributes:                                                                                                                                                                                                                                                                                                                                                     ||||
-|sharepoint_link |cloud_preview_query| | external Sharepoint attachment link  |
+| name             | attachment_name       |          | 200; Use this field when the document attachment is stored in Microsoft SharePoint, Google Drive or document attachment is publicly accessible via a direct URL                                                                                                                                              |
-|gdrive_link |cloud_gdrive| | external Google Drive attachment link  |
+| description      | attachment_kirjeldus  |          | Use this field when the document attachment is stored in Microsoft SharePoint, Google Drive or document attachment is publicly accessible via a direct URL                                                                                                                                                   |
-|ext_link|cloud_ext_link | | external attachment link, must be full external link starting with <code>http://</code>  |
+| code             | kood                  |          | Only for updating excisting attachments, do not send this field for new attachments                                                                                                                                                                                                                          |
+| sharepoint_link  | cloud_preview_query   |          | external Sharepoint attachment link. Use this field when the document attachment is stored in Microsoft SharePoint. Do NOT use this field if the attachment is stored in Directo, Google Drive or published via a public URL.                                                                                |
+| gdrive_link      | cloud_gdrive          |          | external Google Drive attachment link. Use this field when the document attachment is stored in Google Drive. This field is mutually exclusive with Directo, SharePoint and Public URL attachment references and MUST NOT be used together with them.                                                        |
+| ext_link         | cloud_ext_link        |          | external attachment link, must be full external link starting with <code>http://</code>     Use this field when the document attachment is publicly accessible via a direct URL without authentication. This field MUST NOT be used together with Directo, SharePointor Google Drive attachment references.  |
 ==Ostuarve transpordi parameetrid ==
@@ Rida 1278: / Rida 1315: @@
 | XML   | xd_autosupplier_autocode  | 0             | PURCHASE      | Seotud hankija loomisel luuakse kood liideses, unikaalne reg.number on vajalik ja hankija koodi süsteemiseadistused on vajalikud  |
 | XML   | xd_update                 | 0             | PURCHASE      | Luba dokumendi update, kui puuduvad seotud dokumendid                                                                             |
-| XML   | supplier_update           | 0             | PURCHASE      | Hankija andmete osaline update, (email, ... ) väljad on vaja spekis täpsustada                                                    |
+| XML   | xd_supplier_update        | 0             | PURCHASE      | Hankija andmete osaline update, (email, ... ) väljad on vaja spekis täpsustada                                                    |
 | XML   | xd_object                 | VEEB          | PURCHASE      | Vaikimisi objekt, kui ei saadeta                                                                                                  |
 | XML   | xd_confirm                | 0             | PURCHASE      | Automaatne dokumendi kinnitamine, seda saab ka juhtida XML väljaga "confirm"                                                      |
+===Projektid===
+what=project
+[[https://login.directo.ee/xmlcore/cap_xml_direct/xml_IN_projektid.xsd|Skeem ]]
+== Päis: ==
+^XML väli^SQL väli^UI väli^Selgitus^
+|session_id|x| | for internal use at Directo side, do not send this field! |
+|code|kood|Kood| 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 |
+|name|nimi|Nimi| |
+|manager|juht|Juht| |
+|members|liikmed|Liikmed| |
+|start|aeg1|Algus| |
+|end|aeg2|Lõpp| |
+|currency|valuuta|Valuuta| |
+|master|master|Peaprojekt| |
+|customer|klient_kood|Kliendi kood| ALT.FROM: using "customerregno" |
+|customerregno|klient_regnr|Kliendi reg.nr| |
+|customername|klient_nimi|Kliendi nimi| ALT.FROM: customer |
+|customercontact|kl_kontakt|Kl.kontakt| ALT.FROM: customer |
+|customercontactphone|kl_kontakt_telefon|Kliendi telefon| ALT.FROM: customer |
+|customercontactemail|kl_kontakt_email|Kliendi e-mail| ALT.FROM: customer |
+|supplier|hankija_kood|Hankija kood| ALT.FROM: using "supplierregno" |
+|supplierregno|hankija_regnr|Hankija reg.nr| |
+|suppliername|hankija_nimi|Hankija nimi| ALT.FROM: supplier |
+|suppliercontact|h_kontakt|H.kontakt| ALT.FROM: supplier |
+|suppliercontactphone|h_kontakt_telefon|Hankija telefon| ALT.FROM: supplier |
+|suppliercontactemail|h_kontakt_email|Hankija email| ALT.FROM: supplier |
+|memo|memo|Memo| |
+|memo2|memo2|Memo2| |
+|plannedprofit|pl_kate|Plan.kate| |
+|url|url|Url| |
+|object|objekt|objekt| |
+|customerinventory|kl_inventar|Kl. inventar| |
+|type|proj_tyyp|Tüüp| ALT.FROM: tr.params |
+|address1|aadress1|Tänav| ALT.FROM: customer |
+|address2|aadress2|Indeks,linn| ALT.FROM: customer |
+|address3|aadress3|Maa| ALT.FROM: customer |
+|country|asumaa|Asumaa| ALT.FROM: customer |
+|county|maakond|Maakond| ALT.FROM: customer |
+|sraccount|lskonto|LS konto| |
+|contract|leping|Leping| |
+|orderer|tellija_kood|Tellija kood| |
+|orderername|tellija_nimi|Tellija nimi| ALT.FROM: orderer |
+|orderercontact|tl_kontakt|Tl.kontakt| ALT.FROM: orderer |
+|orderercontactphone|tl_kontakt_telefon|Tellija telefon| ALT.FROM: orderer |
+|orderercontactemail|tl_kontakt_email|Tellija email| ALT.FROM: orderer |
+|ordereraddress1|tellija_aadress1|Tellija tänav| ALT.FROM: orderer |
+|ordereraddress2|tellija_aadress2|Tellija Indeks, linn| ALT.FROM: orderer |
+|ordereraddress3|tellija_aadress3|Tellija maa| ALT.FROM: orderer |
+|orderercountry|tellija_asumaa|Tellija asumaa| ALT.FROM: orderer |
+|orderercounty|tellija_maakond|Tellija maakond| ALT.FROM: orderer |
+|payterm|tingimus|Tas.ting| ALT.FROM: customer |
+|status|staatus|staatus| ALT.FROM: tr.params |
+|closed|suletud|suletud| closed = 1, open = 0 |
+|contractend|garantii|Garantii%| |
+|worth|maksumus|Maksumus| |
+|costbudget|summa_kulud|Kulude eelarve| |
+|customer_vatregno|klient_kmregnumber|Kliendikaardil: Km reg nr| |
+|customer_vatzone|klient_maa|Kliendikaardil: Maa| local = 0, EU = 1, export = 2 |
+|customer_type|klient_tyyp|Kliendikaardil: Tüüp| |
+|customer_class|klient_klass|Kliendikaardil: Klass| |
+|customer_loyaltycard|klient_kliendikaart|Kliendikaardil: Kliendikaart| |
+==read: ==
+^XML väli^SQL väli^UI väli^Selgitus^
+|action|tegevus|Tegevus| ALT.FROM: item |
+|start|algus|Algus| |
+|manager|juht|Juht| |
+|workers|tegijad|Tegijad| |
+|comment|kommentaar|Kommentaar| |
+|Preliminiaryend|oletatav_lopp|Oletatav valmimisaeg| |
+|done|valmis|Valmis| |
+|actualend|tegelik_lopp|Tegelik valmimisaeg | |
+|sum|summa|Summa| |
+|plannedtime|aeg_raha1|Planeeritud| |
+|actualtime|aeg_raha2|Tegelik| |
+|points|punktid|Punktid| |
+|after|peale|Peale| |
+|event|event|| |
+|object|objekt|| |
+|item|r_artikkel|| |
+|quotation|pakkumine|| |
+|costs|kulud|Kulud| |
+|worker|teostaja|Teostaja| |
+|budget|eelarve|| |
+|amount|rea_kogus|| |
+|invoice|arve|| |
+|text1|tekst1|| |
+|text2|tekst2|| |
+|constant1|konstant1|Konstant1| |
+|constant2|konstant2|Konstant2| |
+|rn|rn|Nr|row order number in document 1 - N ,  ALT.FROM: random |
+==lisaväljad: ==
+^XML väli^SQL väli^UI väli^Selgitus^
+|code|kood| | |
+|content|sisu|Sisu| |
+|param|param|Parameeter| |
@@ Rida 1534: / Rida 1672: @@
   * [[https://login.directo.ee/xmlcore/cap_xml_direct/ws_kontaktid.xsd|Skeem ]] \\
   * Filtrid: code,customercode,suppliercode,email,closed,ts
+=== Laod(stock) ===
+  * what=stock
+  * [[https://login.directo.ee/xmlcore/cap_xml_direct/ws_laod.xsd|Skeem ]] \\
+  * Filtrid: code
 === Laoseis (Stock levels) ===
   * what=stocklevel [[https://login.directo.ee/xmlcore/cap_xml_direct/ws_laoseis.xsd|Skeem ]] \\