Egytételes pénztár bizonylat importot valósít meg SOAP-n keresztül.
Beállítások összefoglalva
1. A sERPa-s adatbázishoz hozzá kell pipálni a cégfüggő kiegészítő modult.
2. IIS telepíteni kell és be kell állítani a jogosultságokat, valamint létre kell hozni a virtuális mappát, a megfelelő fájlokkal, és adatbázis eléréssel. (részletes leírás)
4. Skidata WSDL és ConnString.inc fájl másolása az IIS paraméterezése során létrejött könyvtárba.
5. ConnString.inc fájl átírása a helyi SQL elérésekre a leírás szerint(a mintafájlban is ki van töltve, ki kell cserélni a megfelelőre.)
- SQL hitelesítéses felhasználót kell beállítani(SQL Server-nek működnie kell SQL hitelesítéssel, a felhasználónak SQL-esnek kell lennie)
6. B2Bpartner funkcióban fel kell venni egy új előfizetőt, SkiData pipával, és az azonosító jelszót megadni, ami majd a SOAP hívásban(az XML-ben) meg kell adni (nem kötelező).
6. Rendszerfunkciók\Napló\SOAP service napló funkcióba nézhető meg, hogy mit fogadott a program, ha megkapta az adatot.(ha ide nem kerül be, akkor az IIS logját lehet megnézni, pl gond lehet: tűzfal, rossz felhasználó,…)
Algoritmus
A hívás módja: szinkronos.
Az eljárás bevétel típusú pénztárbizonylatot generál, amelynek egy tétele van.
Fejléc:
Pénztárkód: xml:DeviceNo
Dátum : xml:DateTimeTransaction
Kézi bizonylatszáma: xml:IDIgény: 30165
Aláírótípus: Külső
Aláíró: xml:PersonalNo
Végösszeg: mentéskor kerül kiszámításra a tétel adatok alapján
Tétel:
Típus: Egyéb bevétel / Csak szöveg
Szöveg: xml:CardNo - xml:CarPakName (xml:ParkingTransactionID) - / xml:DeviceName
Összeg: xml:Revenue
Címletkerekítés: : -
F.szám: -
Költséghely: üres
Témaszám: xml:CardParkNo - témaszámkód szerint, ha nincs akkor üresen marad.
Pozíciószám: xml:DeviceNo - pozíciószám szerint, ha nincs akkor üresen marad.
Teszt URL: https://iroda.progen.hu/serpasoaptest/soap/skidata/?wsdl
Minta SOAP hívás
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:skid="http://www.serpa.hu/webservice/SkiData">
<soapenv:Header>
<Security
xmlns="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<UsernameToken>
<Username>gipsz</Username>
<Password>jakab</Password>
</UsernameToken>
</Security>
</soapenv:Header>
<soapenv:Body>
<skid:PaymentTransaction>
<!--Optional:-->
<skid:ID>2354</skid:ID>
<!--Optional:-->
<skid:CardNo>156973291654729812650055742387</skid:CardNo>
<skid:DeviceNo>105</skid:DeviceNo>
<!--Optional:-->
<skid:DeviceName>FA 15</skid:DeviceName>
<skid:Revenue>350</skid:Revenue>
<!--Optional:-->
<skid:NetRevenue></skid:NetRevenue>
<!--Optional:-->
<skid:CarParkNo>12</skid:CarParkNo>
<!--Optional:-->
<skid:CarParkName>Kőbánya Kispest külső</skid:CarParkName>
<!--Optional:-->
<skid:DeviceType>1</skid:DeviceType>
<!--Optional:-->
<skid:PersonalNo>9999</skid:PersonalNo>
<!--Optional:-->
<skid:ItemCount>1</skid:ItemCount>
<skid:DateTimeTransaction>2016-04-20T10:11:22</skid:DateTimeTransaction>
<!--Optional:-->
<skid:ParkingTransactionID>181250327</skid:ParkingTransactionID>
</skid:PaymentTransaction>
</soapenv:Body>
</soapenv:Envelope>
Minta SOAP válasz
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<PaymentTransactionResponse xmlns="http://www.serpa.hu/webservice/SkiData">
<success>0</success>
<warningMessage Code="50537">Nem létező pénztár (DeviceNo).</warningMessage>
</PaymentTransactionResponse>
</soap:Body>
</soap:Envelope>
Eredményhalmaz
XML |
|
|
Success=0, esetén rendben van minden.
Success=1, esetén hiba van, ekkor a warningMessage részben található a hibakód és hibaüzenet.
Ellenőrzés
Lehetséges hibaüzenetek:
50537 --Nem létező pénztár (DeviceNo).
50538 --Bruttó érték (Revenue) kitöltése kötelező!
50539 --A pénztárbizonylat bevételezési dátumanak (DateTimeTransaction) kitöltése kötelező!
