Az interface célja
Előlegbekérők beküldhetők SOAP-on keresztül is. Részletes SOAP telepítési leírás, és a wsdl fájl elérhetőséget itt olvasható.
Az itt beküldött adatok naplózásra kerülnek, melyek a Soap service napló funkcióval nézhetőek vissza.
Ebben az esetben az ellenőrzés szigorúbb lehet, mint a sima xml import esetén.
A válaszban visszaadásra kerül a generált bizonylat (Előlegbekérő) száma, pl 2017-ELB/000100
Az Ügyfél beazonosítására használt függvény Adószám, vagy Kód, vagy Név alapján azonosíthatja az ügyfelet.
Több találat esetén ID szerinti első találatot fogjuk figyelembe venni, így érdemes pl az Adószám ismétlődéseket megszűntetini.
ügyfél
Az XML ügyfél részén megadott adatok alapján, az új ügyfél felvételre kerül importáláskor, illetve a meglévő ügyfelek adatai módosíthatóak. Ha ügyfél kód vagy adószám alapján beazonosítható az ügyfél, újként nem kerül felvételre.
Továbbá az ügyfél levelezési nyelve is átadható, az XML ügyfél részében (<Nyelv Nev="magyar"/>). Az Ügyfél funkció / Általános fül / További adatok / Levelezési nyelv mezőjébe fog bekerülni a hívásban megadott nyelv.
Az Előlegbekérő (Vevő) - PDF számlakép elkészítése nevű AUT-ban a További adatok fülön található Adat nyelv és Felirat nyelv mező kitöltött, akkor abban az esetben minden előlegbekérő nyomtatásakor az ott beállított nyelv érvényesül a számlaképre vonatkozóan. Ha ezek a mezők nincsenek kitöltve, akkor az Ügyfélben található levelezési nyelvet kell alapul venni. Amennyiben ez a mező is üres, akkor magyar nyelvű Előlegbekérő készül el. Ha olyan nyelv van beállítva az ügyfél levelezési nyelveként, ami magyartól és angoltól is eltérő, akkor angol nyelvű listakép kerül nyomtatásra.
Ügyfél XML rész minta:
<Ugyfel Kod="?" Nev="?" IdegenKod="?" GLN="?" Adoszam="?">
<!--Optional:-->
<Nev>?</Nev>
<!--Optional:-->
<Cim Helyseg="?" UtcaHSzam="?" IrSzam="?">
<!--Optional:-->
<Orszag Kod="?" Nev="?"/>
</Cim>
<Nyelv Nev="magyar"/>
<!--Optional:-->
<Telefon>?</Telefon>
<!--Optional:-->
<Fax>?</Fax>
<!--Optional:-->
<EMail>?</EMail>
<!--You have a CHOICE of the next 3 items at this level-->
<!--Optional:-->
<Adoszam>?</Adoszam>
<!--Optional:-->
<EUAdoszam>?</EUAdoszam>
<!--Optional:-->
<KulfoldiAdoszam>?</KulfoldiAdoszam>
<!--Optional:-->
<JovedekiEngedelyszam>?</JovedekiEngedelyszam>
</Ugyfel>
Adatcsere iránya
B2Bpartner > sERPa
Adatcsere kezdeményezője
B2Bpartner
Adatcsere gyakorisága
Egyedi
Adatcsere módja
SOAP, XML
Minta XML
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:adat="http://www.serpa.hu/webservice/Adatimport">
<soapenv:Header>
<Security xmlns="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<UsernameToken>
<Username>gipsz1</Username>
<Password>jakab1</Password>
</UsernameToken>
</Security>
</soapenv:Header>
<soapenv:Body>
<adat:ElolegB>
<Szamlaszam Ev="2022" Sorozat="SZND"/>
<SzamlaTipus>Normál</SzamlaTipus>
<HelyesbitesTipus>Nincs</HelyesbitesTipus>
<Elolegszamla>1</Elolegszamla>
<!--<HelyesbitettSzamla Ev="?" Sorozat="?" Sorszam="?"/>-->
<KeziSzamlaszam>AXO13298</KeziSzamlaszam>
<Ugyfel Kod="ND1234">
<!--<Telephely Kod="?" Nev="?" GLN="?"/>-->
<!--<Ugyintezo Nev="?"/>-->
</Ugyfel>
<SajatUgyintezo Kod="ND"/>
<!--<Ugynok ID="?" Kod="?" Nev="?"/>-->
<SzamlaDatum>2022-10-19</SzamlaDatum>
<FizetesiMod Nev="Kp"/>
<!--<Bankszamla ID="?" Kod="?" Szam="?"/>-->
<EsedekessegDatum>2022-10-19</EsedekessegDatum>
<SzamlazasAlapja>Teszt</SzamlazasAlapja>
<!--<Kotesszam ID="?" Kod="?" Nev="?"/>-->
<!--<FizetesiFeltetel>?</FizetesiFeltetel>-->
<!--<SzallitasiFeltetel ID="?" Nev="?"/>-->
<!--<SzallitasiMod ID="?" Nev="?"/>-->
<!--<Deviza ID="?" Kod="?" Nev="?"/>-->
<VegOsszeg>1270</VegOsszeg>
<!--<Megjegyzes Nyomtatas="?">?</Megjegyzes>-->
<Tetelek>
<Tetel>
<Termek Kod="AR0002"/>
<!--<Szoveg>?</Szoveg>-->
<!--<BesorolasiSzam ID="?" Kod="?" Nev="?"/>-->
<!--<Vamtarifa ID="?" Kod="?" Nev="?"/>-->
<!--<SzarmazasiHely ID="?" Nev="?"/>-->
<Mennyiseg>10</Mennyiseg>
<!--<MennyisegEgyseg ID="?" Nev="?"/>-->
<NettoEgysegar>100</NettoEgysegar>
<!--<EngedmenySzazalek>?</EngedmenySzazalek>-->
<!--<EngedmenyOsszeg>?</EngedmenyOsszeg>-->
<!--<Termekdij>?</Termekdij>-->
<!--<NettoErtek>?</NettoErtek>-->
<!--<AfaErtek>?</AfaErtek>-->
<!--<AfaAnalitika1>Normál</AfaAnalitika1>-->
<!--<AfaAnalitika2>Normál</AfaAnalitika2>-->
<!--<AfaAnalitika3>Normál</AfaAnalitika3>-->
<!--<AfaKulcs>?</AfaKulcs>-->
<KHely Kod="100"/>
<TSzam Kod="0002"/>
<PSzam Kod="000000_19"/>
<FSzam Kod="0"/>
<AfaFSzam Kod="467"/>
<!--<Ugyletkod ID="?" Kod="?" Nev="?"/>-->
<Megjegyzes Nyomtatas="0">TESZT</Megjegyzes>
<!--<NettoTomeg>?</NettoTomeg>-->
<!--<Elhatarolas>-->
<!--<Tetel Datum="?" Mennyiseg="?" Osszeg="?"/>-->
<!--</Elhatarolas>-->
<!--<Megosztas>-->
<!--<Tetel>-->
<!--<Mennyiseg>1</Mennyiseg>-->
<!--<NettoOsszeg>?</NettoOsszeg>-->
<!--<AfaOsszeg>?</AfaOsszeg>-->
<!--<KHely ID="?" Kod="?" Nev="?"/>-->
<!--<TSzam ID="?" Kod="?" Nev="?"/>-->
<!--<PSzam ID="?" Kod="?" Nev="?"/>-->
<!--<FSzam ID="?" Kod="?" Nev="?"/>-->
<!--<AfaFSzam ID="?" Kod="?" Nev="?"/>-->
<!--</Tetel>-->
<!--</Megosztas>-->
</Tetel>
</Tetelek>
</adat:ElolegB>
</soapenv:Body>
</soapenv:Envelope>
Válasz minta XML
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ElolegBResponse xmlns="http://www.serpa.hu/webservice/Adatimport">
<Eredmeny Leiras="ElolegB[1] OK 2022-SZND/000024"/>
</ElolegBResponse>
</soap:Body>
</soap:Envelope>
Ellenőrzés
Adatimport funkciónak megfelelően.
