Čia matote skirtumus tarp pasirinktos versijos ir esamo dokumento.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
lt:xmlcore [2021/12/16 16:11] ignas [2.1. Informacijos pasiėmimas iš Directo (OUT)] |
lt:xmlcore [2021/12/16 16:20] ignas [2.3. Informacijos siuntimas į Directo (IN)] |
||
---|---|---|---|
Linija 32: | Linija 32: | ||
- | ==== Pavydžiai ==== | + | ====2. Pavydžiai ==== |
Toliau pateikti pavyzdžiai turi būti laikomi tik apytiksliais ir svarbu atsiminti, kad konkrečioje kuriamoje sąsajoje beveik tikrai bus naudojamos kitokios **schemos, URL, parametrai, apribojimai, žinutės atsakymai ir raktai** nei pateiktos pavyzdyje. Jokiu būdu negarantuojama, kad šie URL iš tikrųjų atitiks užklausą. Jei užklausos metu duomenys yra gaunami, jie yra 100% fiktyvūs ir nesusiję su jokių tikrų įmonių duomenimis. | Toliau pateikti pavyzdžiai turi būti laikomi tik apytiksliais ir svarbu atsiminti, kad konkrečioje kuriamoje sąsajoje beveik tikrai bus naudojamos kitokios **schemos, URL, parametrai, apribojimai, žinutės atsakymai ir raktai** nei pateiktos pavyzdyje. Jokiu būdu negarantuojama, kad šie URL iš tikrųjų atitiks užklausą. Jei užklausos metu duomenys yra gaunami, jie yra 100% fiktyvūs ir nesusiję su jokių tikrų įmonių duomenimis. | ||
Norėdami išbandyti, naudokite šią formą: [[https://login.directo.ee/xmlcore/demo_ee/webupload.html]] | Norėdami išbandyti, naudokite šią formą: [[https://login.directo.ee/xmlcore/demo_ee/webupload.html]] | ||
Linija 40: | Linija 40: | ||
GET metodo atveju bent 3 parametrai turi būti nurodyti: | GET metodo atveju bent 3 parametrai turi būti nurodyti: | ||
- | * **get**=1 | + | * ''get=1'' |
- | * **what**=SERVISO_KODAS | + | * ''what=SERVISO_KODAS'' |
- | * **key**=SUGENERUOTAS_RAKTAS | + | * ''key=SUGENERUOTAS_RAKTAS'' |
Papildomi parametrai yra derinami individualiai pagal poreikį, integracijos derinimo metu. | Papildomi parametrai yra derinami individualiai pagal poreikį, integracijos derinimo metu. | ||
- | Šiame pavyzdyje naudojami **what=item** ir **get**=1. Visi filtrai galimi, jei schemoje yra atitinkamas laukas. Pavyzdžiui, "class", "code", "barcode", "supplier", "supplieritem", "closed", "ts" straipsnių aprašomoji struktūros schema: [[https://login.directo.ee/xmlcore/demo_ee /ws_artiklid.xsd]] | + | Šiame pavyzdyje naudojami ''what=item'' ir ''get=1''. Visi filtrai galimi, jei schemoje yra atitinkamas laukas. Pavyzdžiui, "class", "code", "barcode", "supplier", "supplieritem", "closed", "ts" straipsnių aprašomoji struktūros schema: [[https://login.directo.ee/xmlcore/demo_ee /ws_artiklid.xsd]] |
Užklausa prekėms pagal išsaugojimo datą (ts = Time stamp): [[https://login.directo.ee/xmlcore/demo_ee/xmlcore.asp?what=item&get=1&ts=01.01.2021]] | Užklausa prekėms pagal išsaugojimo datą (ts = Time stamp): [[https://login.directo.ee/xmlcore/demo_ee/xmlcore.asp?what=item&get=1&ts=01.01.2021]] | ||
Linija 71: | Linija 71: | ||
- | ==== 2.3. Informacijos siuntimas į Directo (IN) ==== | + | === 2.3. Informacijos siuntimas į Directo (IN) === |
Duomenys siunčiami naudojant ''form/urlencoded'' POST metodą. | Duomenys siunčiami naudojant ''form/urlencoded'' POST metodą. | ||
Užpildomi formos kintamieji: | Užpildomi formos kintamieji: | ||
- | * **put**=1 | + | * ''put=1'' |
- | * **what**=INVOICE | + | * ''what=INVOICE'' |
- | * **key**=SUGENERUOTAS_RAKTAS | + | * ''key=SUGENERUOTAS_RAKTAS'' |
- | * **xmldata**=<?xml version="1.0" encoding="utf-8"?><PAYLOAD> | + | * ''xmldata=<?xml version="1.0" encoding="utf-8"?><PAYLOAD>'' |
- | Šis siuntimas naudojamas, pavyzdžiui, kai pardavimo sąskaita yra sugeneruojama išorinėje sistemoje, kurią reikia perduoti į „Directo“. | + | Įvesties sąsajoje XML turi būti išsiųstas adresu [[https://login.directo.ee/xmlcore/demo_ee/xmlcore.asp]] POST su kintamaisiais ''put = 1'', ''key = [appkey value]'', ''what = order'' (arba ''what = customer'' arba ''what = item'') ir ''xmldata = [XML turinys]'' XML įvestis turi atitikti schemą. |
<wrap important> | <wrap important> | ||
Linija 87: | Linija 87: | ||
</wrap> | </wrap> | ||
- | Tarkime, kad šiuo atveju URL pvz. https://login.directo.ee/xmlcore/this_is_the_worlds_greatest_company/xmlcore.asp | + | **Praktinis pavyzdys** |
- | Pavyzdinio serviso XSD schemą: [[http://wiki.directo.ee/_media/et/xml_in_arved.xsd|xml_in_arved.xsd]]. | + | Tokio tipo įvestis naudojama, pavyzdžiui, kai išorinėje sistemoje generuojami pardavimo užsakymai, kurie turi būti atspindėti Directo. Taip pat, pateikiamas pirkėjų schemos aprašymas. |
+ | |||
+ | Tarkime, kad šiuo atveju URL pvz. [[https://login.directo.ee/xmlcore/this_is_the_worlds_greatest_company/xmlcore.asp]] | ||
+ | |||
+ | Pavyzdinio serviso XSD schemą: [[http://wiki.directo.ee/_media/et/xml_in_arved.xsd]]. | ||
Pavyzdinis XML: | Pavyzdinis XML: | ||
Linija 141: | Linija 145: | ||
Svarbu sulaukti atsakymo apie sėkmingą įkėlimą. Jeigu tokio rezultato nesulaukiama arba yra gaunama klaida, siuntimą reikia pakartoti ne anksčiau kaip po minutės. Reikėtų vengti kelių užklausų siuntimo vienu metu. | Svarbu sulaukti atsakymo apie sėkmingą įkėlimą. Jeigu tokio rezultato nesulaukiama arba yra gaunama klaida, siuntimą reikia pakartoti ne anksčiau kaip po minutės. Reikėtų vengti kelių užklausų siuntimo vienu metu. | ||
</wrap> | </wrap> | ||
+ | |||
+ | **Pirkėjo įvesties sąsaja:** | ||
+ | |||
+ | Duomenys aprašyti schemoje [[https://login.directo.ee/xmlcore/demo_ee/xml_IN_kliendid.xsd]] . Duomenų registravimas yra toks pat kaip užsakymų registravimas. XML, kuris atitinka schemą, bet nenaudoja visų galimų atributų, gali atrodyti taip: | ||
+ | |||
+ | <code xml> | ||
+ | <? xml version = "1.0" encoding = "utf-8" ?> | ||
+ | <customers > | ||
+ | <customer code = "Customer code1 " name = "Name" address1 = "address11" address2 = "address21" address3 = "address31" email = " email1 " regno = " regno1 " class = " class1 " type = " 1 " > | ||
+ | </ customer > | ||
+ | </ customers > | ||
+ | </code> | ||
==== 2.4. HTML forma ==== | ==== 2.4. HTML forma ==== |