lt:xmlcore
Skirtumai
Čia matote skirtumus tarp pasirinktos versijos ir esamo dokumento.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
lt:xmlcore [2020/07/13 13:20] – robertas | lt:xmlcore [2021/10/11 16:30] – [2.4. Pavyzdys PHP kalba] jaroslav | ||
---|---|---|---|
Linija 10: | Linija 10: | ||
* Į POST užklausą atsakoma sinchronizuotu XML pranešimu, kurio apdorojimas gali daryti įtaką sėkmingam procesui; | * Į POST užklausą atsakoma sinchronizuotu XML pranešimu, kurio apdorojimas gali daryti įtaką sėkmingam procesui; | ||
* Duomenų struktūra turi atitikti paruoštą XSD schemą. Pageidaujama reikšmes siųsti atributuose. | * Duomenų struktūra turi atitikti paruoštą XSD schemą. Pageidaujama reikšmes siųsti atributuose. | ||
+ | * Directo dokumentų numerių tipas yra // | ||
+ | * Tuščios (NULL) reikšmės nebus įtraukiamos į XML su lauko pavadinimu. Tą patį darykite ir siųsdami duomenis į Directo - praleiskite laukus, kuriuose turi būti tuščių (NULL) reikšmių. Reikėtų vengti siųsti laukus su tuščia reikšme, kaip pavyzdžiui: | ||
- | * **Endpoint URL:** https://directo.gate.ee/ | + | * **Endpoint URL:** https://login.directo.ee/ |
- | ==== 2.1. Informacijos pasiėmimas iš Directo (OUT) ==== | ||
- | GET metodo atveju bent 3 parametrai turi būti nurodyti: | + | ==== 2.1. Prieiga prie serviso ==== |
- | * get=1 | + | |
- | * what=SERVISO_KODAS | + | |
- | * key=SUGENERUOTAS_RAKTAS | + | |
- | Papildomi parametrai | + | Serviso nuorodos |
+ | <code xml>< | ||
+ | Pavyzdys naudojant cURL: | ||
+ | <code bash> | ||
+ | curl -v -d " | ||
+ | </ | ||
- | Šio pavyzdžio atveju yra naudjamas **what** = " | ||
+ | ==== 2.2. Informacijos pasiėmimas iš Directo (OUT) ==== | ||
- | Užklausos pavyzdys, norint gauti visų prekių sąrašą: | + | GET metodo atveju bent 3 parametrai turi būti nurodyti: |
+ | * **get**=1 | ||
+ | * **what**=SERVISO_KODAS | ||
+ | * **key**=SUGENERUOTAS_RAKTAS | ||
- | https:// | + | Papildomi parametrai yra derinami individualiai pagal poreikį, integracijos derinimo metu. |
- | Užklausos pavyzdys, norint gauti konkrečios prekės informaciją: | + | <wrap important> |
+ | Šiuose pavyzdžiuose esančios nuorodos yra iliustracinio pobūdžio. Jokiu būdu negarantuojama, | ||
+ | </ | ||
- | https:// | ||
- | **PHP pavyzdys** | + | Šio pavyzdžio atveju yra naudojamas |
- | < | + | |
- | $url = 'https://directo.gate.ee/xmlcore/demo_ee/xmlcore.asp? | + | |
- | $ch = curl_init(); | ||
- | curl_setopt($ch, | ||
- | curl_setopt($ch, | ||
- | curl_setopt($ch, | ||
- | curl_setopt($ch, | ||
- | curl_setopt($ch, | ||
- | $result = curl_exec($ch); | + | Užklausos pavyzdys, norint gauti visų prekių sąrašą: |
- | + | ||
- | header(' | + | https://login.directo.ee/xmlcore/ |
- | + | ||
- | print '< | + | Užklausos pavyzdys, norint gauti konkrečios prekės informaciją: |
- | + | ||
- | $data = new SimpleXMLElement($result); | + | |
- | + | ||
- | print '< | + | |
- | + | ||
- | foreach ($data-> | + | |
- | print $item[' | + | |
- | | + | |
- | print chr(9) . $df[' | + | |
- | } | + | |
- | } | + | |
- | </ | + | |
- | ==== 2.2. Informacijos siuntimas į Directo (IN) ==== | + | https:// |
- | Duomenys siunčiami naudojant POST metodą. | + | ==== 2.3. Informacijos siuntimas į Directo (IN) ==== |
- | Užpildomi trys formos kintamieji: | + | Duomenys siunčiami naudojant '' |
- | * put=1 | + | |
- | * what=INVOICE | + | |
- | * xmldata=<? | + | |
+ | Užpildomi formos kintamieji: | ||
+ | * **put**=1 | ||
+ | * **what**=INVOICE | ||
+ | * **key**=SUGENERUOTAS_RAKTAS | ||
+ | * **xmldata**=<? | ||
Šis siuntimas naudojamas, pavyzdžiui, | Šis siuntimas naudojamas, pavyzdžiui, | ||
- | Šiame pavyzdyje nurodyti URL ir XML pvz. yra visiškai išgalvoti ir negali būti naudojami testavimui. Testavimas visada atliekamas realiame procese. | + | <wrap important> |
+ | Šiame pavyzdyje nurodyti URL ir XML pavyzdžiai | ||
+ | </ | ||
- | Tarkime, kad šiuo atveju URL pvz. https://directo.gate.ee/ | + | Tarkime, kad šiuo atveju URL pvz. https://login.directo.ee/ |
Pavyzdinio serviso XSD schemą: | Pavyzdinio serviso XSD schemą: | ||
Linija 84: | Linija 75: | ||
Pavyzdinis XML: | Pavyzdinis XML: | ||
- | < | + | < |
<?xml version=" | <?xml version=" | ||
< | < | ||
- | < | + | <invoice InvoiceNr=" |
InvoiceDate=" | InvoiceDate=" | ||
< | < | ||
Linija 97: | Linija 88: | ||
</ | </ | ||
- | + | Servisas | |
- | Servisas | + | |
Pavyzdžiui įkėlimas buvo sėkmingas ir Directo sąskaitos dokumentui priskyrė numerį 123: | Pavyzdžiui įkėlimas buvo sėkmingas ir Directo sąskaitos dokumentui priskyrė numerį 123: | ||
- | < | + | < |
<?xml version=" | <?xml version=" | ||
< | < | ||
Linija 113: | Linija 103: | ||
Pavyzdžiui sąskaita numeriu 123 buvo atmesta, nes Directo sistemoje jau egzistavo sąskaitos dokumentas tokiu numeriu: | Pavyzdžiui sąskaita numeriu 123 buvo atmesta, nes Directo sistemoje jau egzistavo sąskaitos dokumentas tokiu numeriu: | ||
- | < | + | < |
<?xml version=" | <?xml version=" | ||
< | < | ||
Linija 122: | Linija 112: | ||
Vienu siuntimu galima įkelti kelias sąskaitas iš karto. Tokiu atveju rezultatas turi būti grąžinamas kiekvienai sąskaitai: | Vienu siuntimu galima įkelti kelias sąskaitas iš karto. Tokiu atveju rezultatas turi būti grąžinamas kiekvienai sąskaitai: | ||
- | < | + | < |
<?xml version=" | <?xml version=" | ||
< | < | ||
Linija 130: | Linija 120: | ||
</ | </ | ||
- | :!: 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. | + | <wrap important> |
+ | 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. | ||
+ | </ | ||
- | ==== 2.3. HMTL forma ==== | + | ==== 2.4. HTML forma ==== |
Parametrai, kuriuos reikia nurodyti: | Parametrai, kuriuos reikia nurodyti: | ||
- | * **What** – webserviso | + | * **What** – web serviso |
* **Put** – statinis. Visada „1“ jei tai importas į Directo. | * **Put** – statinis. Visada „1“ jei tai importas į Directo. | ||
* **Get** - statinis. Visada „1“ jei tai eksportas iš Directo. | * **Get** - statinis. Visada „1“ jei tai eksportas iš Directo. | ||
+ | * **Key** - web serviso autorizacijos raktas. | ||
* **Xmldata** – dinaminis. Laukus reiktų derinti, kadangi servisas būtų programuojamas individualiai pagal poreikį. | * **Xmldata** – dinaminis. Laukus reiktų derinti, kadangi servisas būtų programuojamas individualiai pagal poreikį. | ||
Linija 143: | Linija 136: | ||
Pavyzdinė užsakymo forma: | Pavyzdinė užsakymo forma: | ||
- | < | + | < |
- | <form method=" | + | <form method=" |
<input name=" | <input name=" | ||
Linija 150: | Linija 143: | ||
<input name=" | <input name=" | ||
- | < | + | <input name=" |
+ | |||
+ | < | ||
<input TYPE=" | <input TYPE=" | ||
</ | </ | ||
+ | </ | ||
+ | |||
+ | |||
+ | ==== 2.4. Pavyzdys PHP kalba ==== | ||
+ | |||
+ | Į servisą | ||
+ | |||
+ | **OUT** | ||
+ | <code php> | ||
+ | $url = ' | ||
+ | $key = ' | ||
+ | |||
+ | $ch = curl_init(); | ||
+ | curl_setopt($ch, | ||
+ | curl_setopt($ch, | ||
+ | curl_setopt($ch, | ||
+ | curl_setopt($ch, | ||
+ | curl_setopt($ch, | ||
+ | curl_setopt($ch, | ||
+ | |||
+ | $result = curl_exec($ch); | ||
+ | |||
+ | header(' | ||
+ | |||
+ | print '< | ||
+ | |||
+ | $data = new SimpleXMLElement($result); | ||
+ | |||
+ | print '< | ||
+ | print_r($data); | ||
+ | foreach ($data-> | ||
+ | print ' | ||
+ | foreach ($item-> | ||
+ | print chr(9) . $df[' | ||
+ | } | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | |||
+ | **IN** | ||
+ | <code php> | ||
+ | $url = ' | ||
+ | $key = ' | ||
+ | |||
+ | $xmldata = <<< | ||
+ | <?xml version=" | ||
+ | <invoice InvoiceNr=" | ||
+ | InvoiceDate=" | ||
+ | < | ||
+ | <line ProductID=" | ||
+ | <line ProductID=" | ||
+ | </ | ||
+ | </ | ||
+ | XML; | ||
+ | |||
+ | |||
+ | $ch = curl_init(); | ||
+ | |||
+ | curl_setopt($ch, | ||
+ | curl_setopt($ch, | ||
+ | curl_setopt($ch, | ||
+ | curl_setopt($ch, | ||
+ | curl_setopt($ch, | ||
+ | curl_setopt($ch, | ||
+ | |||
+ | $result = curl_exec($ch); | ||
+ | curl_close($ch); | ||
+ | |||
+ | echo '< | ||
+ | |||
+ | print '</ | ||
+ | |||
</ | </ |
lt/xmlcore.txt · Keista: 2023/09/15 15:27 vartotojo jaroslav