Dokumentų siuntimo procesas
Norint išsiųsti dokumentą savo prekybos partneriui per „Edisoft“ platformą naudojama API komandą ‘Send’. Užklausoje reikia perduoti lentelėje aprašytus parametrus:
Parametras |
Aprašymas |
Privalomas |
Name | Prisijungimo vardas | Taip |
Password | Slaptažodis | Taip |
PartnerIln | Jūsų partnerio ILN / GLN numeris | Ne |
DocumentType | Dokumento tipas, kurį siunčiate (ORDER, INVOICE, DESADV, RECADV ar kt.) | Ne |
DocumentContent | CDATA viduje įterpiamas pilnas Edisoft XML formato dokumentas | Ne |
Užklausos pavyzdys naudojant komandą ‘Send’
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:wsedi">
<soapenv:Header/>
<soapenv:Body>
<urn:Send>
<urn:Name>SomeName</urn:Name>
<urn:Password>SomePassword</urn:Password>
<urn:PartnerIln>2000000000110</urn:PartnerIln>
<urn:DocumentType>ORDER</urn:DocumentType>
<urn:DocumentContent><![CDATA[…SomeContent…]]></urn:DocumentContent>
<urn:Timeout>100</urn:Timeout>
</urn:Send>
</soapenv:Body>
</soapenv:Envelope>
Įvykdžius ‘Send’ komandą, dokumentas perduodamas į „Edisoft“ sistemą ir atsiunčiamas atsakymas, kuriame pateikiami sekantys laukai:
Parametras |
Aprašymas |
<ns1:cnt> | Jei išsiuntimas sėkmingas, gaunamas dokumentui priskirtas ID |
<ns1:res> | Jei išsiuntimas nepavyko, gaunamas klaidos kodas |
Galimi klaidų kodai ir jų aprašymai:
Klaidos kodas | Aprašymas |
---|---|
00000000 | API operacija sėkmingai įvykdyta |
00000001 | Autentifikacijos klaida |
00000003 | Neteisingi parametrai |
00000004 | Nėra tokio ryšio |
00000005 | Baigėsi užklausos vykdymui skirtas laikas |
00000006 | Sistemos klaida |
Atsakymo pavyzdys naudojant komandą ‘Send’
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
<SendResponse xmlns="urn:wsedi">
<ns1:SendResult xmlns:ns1="urn:wsedi">
<ns1:Res>00000000</ns1:Res>
<ns1:Cnt>21823756</ns1:Cnt>
</ns1:SendResult>
</SendResponse>
</soapenv:Body>
</soapenv:Envelope>