Az interface célja
Vevőszámlá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 adatokat naplózásra került, amelyet a Soap service napló funkcióval nézhető vissza.
Ebben az esetben az ellenőrzés szigorúbb, mint a sima xml import.
A válaszban visszaadásra került a generált bizonylat (vevőszámla) száma, pl 2016-A01/000639
Kiegészítésre került az adat import:
1.) Ügyfél adatok módosításakor szigorúbb ellenőrzés került beállításra. Az import az Ügyfél kódot figyeli, Ügyfél név és cím módosításakor nem érkezik hibaüzenet és elkészül a vevőszámla. Adószám, EU adószám, Külföldi adószám és Ügyfél típus módosításakor hiba üzenetet küldünk és nem jön létre a számla.
Hibaüzenet: Az ügyfél adószáma, típusa megváltozott!
2.) Az import XML-ben folyamatos teljesítés fizetési módok esetén, átküldjük az időszak kezdete, vége dátumot, ami a vevőszámla fejlécében megjelenik.
3.) A vevőszámla sorozatban, ha a pénztábizonylat mező értéke generálás, akkor a számla importálásakor a vevőszámla paraméterben megadott Pénztárba generálódik automatikusan pénztárbizonylat is.
4.) Gyűjtőszámla vagy Devizás gyűjtőszámla importálási lehetőség. A GyujtoSzlaTeljDatum mező segítségével megadható a gyűjtőszámla tételeinek teljesítési dátuma. Amennyiben kitöltésre kerül a mező, abban az esetben a számla gyűjtőszámlának minősül ha pedig a devizaneme HUF-tól eltérő, akkor devizás gyűjtőszámlaként importálható.
5.) Bankkártyás fizetési mód esetén (Fizetési mód funkcióban a fizetési mód jellege Bankkártya) a számlaimportálásakor egy Egyéb jóváírás kapcsolódó eseményt generálunk a felvett számlához, hogy az így felvett számlakiegyenlített legyen. Később ezeketa számlákat össze lehet vezetni az kézzel importált bankkivonattal.
A fenti működéshez szükséges a vevőszámla paraméter funkció, Normál paraméterében felvenni egy Egyéb fizetési eszközt, illetve az Automatikus Felvétel és Használható nevű jelölőnégyzeteket bepipálni.
6.) Az XML kiegészítésre került Előlegbekérő bizonylat hivatkozási lehetőséggel. A továbbiakban megadható az előlegbekérő bizonylat éve, sorozata és sorszáma. Az importálást követően, az Előlegbekérő funkcióban, az érintett előlegbekérőnél megjelenik az Előlegszámla elnevezésű mező, ahol lehetőség van kapcsolódó funkcióval átnavigálni a vevőszámla funkcióban található előlegszámlához. A Kivonat és Pénztárbizonylat funkcióban, a Számlák táblázat Számlaszám mezőjébe is megjelenítésre kerül a beimportált előlegszámla száma.
XML minta: <ElolegB Ev="2023" Sorozat="TSZ" Sorszam="25"/>
7.) Az időszakos elszámolású vevőszámláknál a teljesítési dátumra vonatkozó jogszabályi megfelelőség ellenőrzése kikapcsolásra került azon számlák esetében, melyek olyan számla sorozatra kerülnek beküldésre, amik nem nyomtathatók.
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>gipsz</Username>
<Password>jakab</Password>
</UsernameToken>
</Security>
</soapenv:Header>
<soapenv:Body>
<adat:VevoSz>
<Szamlaszam Ev="2016" Sorozat="A01"/>
<SzamlaTipus>Folyószámla nélküli (ü.t.-)</SzamlaTipus>
<Ugyfel>
<Ugyfel ID="1" Kod="00000001">
<Nev>Tóa Attila</Nev>
<Cim Helyseg="1118" UtcaHSzam="Homonna utca 8/A" IrSzam="1118"/>
<Orszag Kod="?" Nev="?"/>
</Cim>
<Telefon>+36-1(1)-481-90-00</Telefon>
<Fax>?</Fax>
<EMail>toa@proeng.hu</EMail>
<Adoszam>?</Adoszam>
<EUAdoszam>?</EUAdoszam>
<KulfoldiAdoszam>?</KufoldiAdoszam>
<JovedekiEngedelyszam>?</JovedekiEngedelyszam>
<Nyelv ID="0" Nev="?"/>
<Ugyfel>
<SzamlaDatum>2016-11-10</SzamlaDatum>
<Deviza Kod="HUF"/>
<FizetesiMod Nev="Kp"/>
<EsedekessegDatum>2016-11-10</EsedekessegDatum>
<TeljesitesDatum>2016-11-10</TeljesitesDatum>
<KonyvelesDatum>2016-11-10</KonyvelesDatum>
<AfaDatum>2016-11-10</AfaDatum>
<VegOsszeg>19990</VegOsszeg>
<Tetelek>
<Tetel>
<Szoveg>jegy</Szoveg>
<Mennyiseg>1</Mennyiseg>
<NettoEgysegar>15740.1575</NettoEgysegar>
<NettoErtek>15740</NettoErtek>
<AfaErtek>4250</AfaErtek>
<AfaKulcs>27</AfaKulcs>
<Megjegyzes Nyomtatas="1">BLszektor 12b</Megjegyzes>
</Tetel>
</Tetelek>
</adat:VevoSz>
</soapenv:Body>
</soapenv:Envelope>
Válasz minta XML
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<VevoSzResponse xmlns="http://www.serpa.hu/webservice/Adatimport">
<success>1</success>
<NoDocument>2016-A01/000639</NoDocument>
</VevoSzResponse>
</soap:Body>
</soap:Envelope>
Ellenőrzés
Érvénytelen idegen azonosító típus!
Érvénytelen ár/engedménymeghatározás!
A dátum kitöltése kötelező!
Lezárt időszakba eső számla!
Nincsenek tételek!
Érvénytelen ügyfél!
Érvénytelen ügyfél telephely!
Érvénytelen ügyfél ügyintéző!
Érvénytelen személy!
Érvénytelen ügynök!
Érvénytelen áruházi ár!
Érvénytelen fizetési mód!
Érvénytelen deviza!
Érvénytelen késedelmi kamat!
Érvénytelen bankszámla!
Érvénytelen kötésszám!
Érvénytelen szállítási feltétel!
Érvénytelen szállítási mód!
Érvénytelen főkönyvi szám!
Érvénytelen számlatípus!
Érvénytelen megjegyzés nyomtatás!
Érvénytelen helyesbített számla!
Érvénytelen ország!
Az ügyfél nem belföldi vevő!
Az ügyfél nem külföldi vevő!
Érvénytelen számlaszám!
Érvénytelen főkönyvi szám!
Érvénytelen költséghely!
Érvénytelen témaszám!
Érvénytelen pozíciószám!
Érvénytelen termék!
Érvénytelen besorolási szám!
Érvénytelen vámtarifa!
Érvénytelen származási hely!
Érvénytelen mennyiség egység!
Érvénytelen ügyletkód!
Érvénytelen főkönyvi szám!
Érvénytelen költséghely!
Érvénytelen témaszám!
Érvénytelen pozíciószám!
Érvénytelen megjegyzés nyomtatás!
