Az interface célja
Számlaérkeztetés igazolási adatok importját(jóváhagyás) valósít meg SOAP-n keresztül.
Adatcsere iránya
B2Bpartner > sERPa
Adatcsere kezdeményezője
B2Bpartner
Adatcsere gyakorisága
-
Adatcsere módja
SOAP, XML
Minta XML
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:eur="http://www.serpa.hu/webservice/EuroOne" xmlns:sec="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<soapenv:Header>
<sec:Security>
<sec:UsernameToken>
<sec:Username>gipsz</sec:Username>
<sec:Password>jakab</sec:Password>
</sec:UsernameToken>
</sec:Security>
</soapenv:Header>
<soapenv:Body>
<eur:SzamlaErk>
<eur:Iktatoszam>2016-BS/000021</eur:Iktatoszam>
<eur:IgazoloSzemely>
<eur:SzemelyKod>031</eur:SzemelyKod>
<eur:Igazolas>1</eur:Igazolas>
<!--Optional:-->
<eur:Megjegyzes>új ember</eur:Megjegyzes>
</eur:IgazoloSzemely>
</eur:SzamlaErk>
</soapenv:Body>
</soapenv:Envelope>
Válasz minta XML
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<SzamlaErkResponse xmlns="http://www.serpa.hu/webservice/EuroOne">
<success>1</success>
<NoDocument>2016-BS/000021</NoDocument>
</SzamlaErkResponse>
</soap:Body>
</soap:Envelope>
Mezők megfeleltetése <SzamlaErk>
Srsz. |
Interface mező név |
Mezőtípus |
sERPa mező |
Algoritmus |
|
Iktatoszam |
|
dbo.BizSzam(Ev+Sorozat+Sorszam) |
Iktatószám (sERPa bizonylatszáma) |
|
<IgazoloSzemely |
|
|
Bizonylatban megadott igazolók |
|
<Szemely |
|
|
Személy kód, név |
|
Kod |
KodKoz |
|
|
|
Nev |
NevKoz |
|
|
|
Szemely> |
SzovegKicsi |
|
|
|
Igazolas |
Felsorolt |
|
0: Folyamatban, 1: Jóváhagyva, 2: Elutasítva |
|
Megjegyzes |
|
|
|
|
IgazoloSzemely> |
|
|
|
Algoritmus
1. Az itt kapott XML-ben levő bizonylatszám szerinti számlaérkeztetés Könyvelhető állapota = Jóváhagyva állapotra kerül átállításra, ha igazolás gridben minden soron az igazolás állapota Jóváhagyva lesz, és ha a könyvelhető állapota Folyamatban, egyéb esetben hibaüzenet kerül visszaadásra: „Nem folyamatban levő számlaérkeztetés”. (ha átállításra került, akkor az üzenet: OK)
2 A kapott XML-ben az igazolás részben levő személyek meg kell, egyezzen a sERPa-ban levővel, vagy kevesebb személy kell, legyen az XML-be, ha nem akkor hibaüzenet. (Olyan személy nem igazolhat, aki nincs megadva a bizonylathoz.)
3. Ha a számlaérkeztetés paraméterében a sorozathoz be van állítva, hogy szállítószámla generálás, akkor az előbbi módon beküldött számlaérkeztetésből szállítószámla kerül generálásra, ha az könyvelhető állapota Jóváhagyva lesz.
Eredményhalmaz
XML |
|
|
Success=0, esetén rendben van minden.
Success=1, esetén hiba van, ekkor a warningMessage/errorMessage részben található a hibakód és hibaüzenet.
Ellenőrzés
Lehetséges hibaüzenetek:
50703 - Ismeretlen számlaérkeztetés iktatószám: %1
50704 - Ismeretlen szállítószámla bizonylatszám: %1
