A lényeg

A szolgáltató felhasználói API-ja és az Access Pointok közötti AS4 különböző interfészek. Tesztelje a fogadást, a küldést, a duplikációt és a hibákat; a HTTP-siker önmagában nem igazolja a kézbesítést.

Hogyan kapcsolódik a szoftver a Peppolhoz API-n keresztül?

A szokásos integráció a számlázó vagy ERP-rendszerét köti össze a kézbesítési szolgáltató interfészével. A program előkészíti az adatokat, átadja a bizonylatot, és átveszi az eredményeket vagy a fogadott számlákat. A szolgáltató a kézbesítési hálózatban rá eső feladatot látja el.

Az ügyféloldali API és az Access Pointok közötti továbbítás különböző rétegek. A Peppol AS4 a szolgáltatók közötti kommunikációt írja le. Az API konkrét címeit, a hitelesítés módját és a válaszok formátumát a programja számára a választott szolgáltató dokumentációja határozza meg.

Mielőtt a programozás megkezdődne, erősítse meg a terjedelmet: csak küldés, csak fogadás vagy mindkét irány. Adja meg a több céget, a javító bizonylatokat, a mellékleteket és a könyveléssel való kívánt összekapcsolást is.

Mely feladatokat kell felosztani az ERP és a szolgáltató között?

Feladat Miben kell megállapodni
A számla létrejötte Hol van az adatok forrása, és ki hagyja jóvá a bizonylatot
UBL-export Ki hozza létre az XML-t, és melyik profilt vagy kiadást támogatja
Címzés Honnan veszik át a Peppol ID-t, és hogyan ellenőrzik a címzettet
Validálás Mely rétegeket hajtják végre, és hogyan jutnak vissza a hibák
Kézbesítés Milyen üzenetazonosítást és eredményt kap az ERP
Fogadás Hogyan szerzik be az eredeti XML-t, a mellékleteket és a fogadás időpontját
Adatszolgáltatás Hogyan követik a Szlovák Köztársaság Pénzügyi Igazgatóságának (Finančná správa SR) szánt adatok eredményét

A szolgáltató átvehet kész XML-t, vagy felajánlhatja annak más adatokból történő létrehozását. Mindkét esetben ellenőrizze, hogy a mezők üzleti jelentése megmarad-e. A megfeleltetést a magyarázatokkal ellátott XML-minta magyarázza el.

Hogyan tervezze meg a küldést és az eredmény visszaérkezését?

A bizonylatot először mentse el, és technikailag ellenőrizze. Az átadáskor rögzítse a saját hivatkozását és a szolgáltató üzenetazonosítóját. Az API válaszának legyen tisztázott jelentése: a kérés átvétele megelőzheti a továbbítás végső eredményét.

Aszinkron feldolgozás esetén az eredmény webhookkal érkezhet, vagy a program a dokumentáció szerint ismételt lekérdezéssel állapítja meg. Ezeket a lehetőségeket ne tekintse minden API kötelező funkciójának. Állapodjon meg abban, hogyan kerül vissza az eredmény a megfelelő bizonylathoz, és mit lát a munkatárs hiba esetén.

Az integráció szemléltető folyamata:

Az ERP előkészíti és elmenti a számlát
→ ellenőrzi az XML-t, és saját hivatkozást rendel hozzá
→ átadja a bizonylatot a szolgáltatónak
→ elmenti az üzenetazonosítót
→ átveszi a továbbítás eredményét
→ megjeleníti az állapotot vagy a javítási feladatot

Az ábra nem egy konkrét API definíciója. Az állapotok elnevezését és az elérhető visszaigazolásokat a szolgáltatás dokumentációjából vegye át. A technikai kézbesítést különböztesse meg a vevő általi üzleti jóváhagyástól.

Mi történik kiesés vagy ismételt kérés esetén?

Ha a küldés után időtúllépés történik, az eredmény ismeretlen lehet: a szolgáltató átvehette a bizonylatot. Az ismételt küldéshez egyeztetett védelemre van szükség a duplikáció ellen. Ellenőrizze, hogy az API támogatja-e az idempotens kérést, vagy az üzenet visszakeresését az Ön hivatkozása alapján.

Webhookok esetén számoljon az esemény ismétlődésével, és a dokumentáció szerint ellenőrizze annak eredetét. Fogadáskor mentse el az üzenet azonosítóját és a számla azonosító adatait is; az ellenőrzést ne csak a fájlnévre alapozza. A továbbítás technikai duplikációja és két üzletileg hasonló bizonylat különböző helyzetek.

Készüljön fel annak az esetnek a kézi megoldására is, amely egyértelmű eredmény nélkül maradt. Az eredményt ne jelölje automatikusan sikeresnek csak azért, mert megszűnt a hibakód érkezése.

Hogyan állítsa be több cég fogadását és hozzáféréseit?

A beszerzett XML-t őrizze meg, és vesse össze az adatokat a megfelelő cégbe történő importálással. Az ezt követő jóváhagyás, a számlák hozzárendelése és a kifizetés az Ön munkafolyamatához tartozik. A hivatalos UBL-szerkezet segít meghatározni, hová tartoznak az üzleti adatok.

A teszt- és az éles fiókokat tartsa elkülönítve. A kulcsokat a szerveren tárolja, és csak a szükséges folyamatok számára tegye hozzáférhetővé. Több alany esetén ellenőrizze minden jogosultság terjedelmét, hogy az egyik cég kérése ne dolgozhassa fel a másik cég bizonylatait.

Határozza meg a hozzáférés helyreállítását és az adatok cseréjét is a szolgáltatás váltása esetén. Az üzemi naplónak segítenie kell a probléma felderítését anélkül, hogy a számlák teljes tartalmát feleslegesen minden naplóba átmásolnák.

Minek kell átmennie a próbán az indulás előtt?

Tesztelje a szokásos küldést és fogadást, az érvénytelen bizonylatot, az ismeretlen címzettet, a javítást és az ismételt importálást. Adja hozzá az átadás utáni időtúllépést, az ismétlődő eseményt és a szolgáltatás átmeneti elérhetetlenségét. Minden forgatókönyvnél határozza meg a várt eredményt és a kezelő teendőit.

Rögzítse a szabályok használt kiadását és a konnektor verzióját. Frissítéskor vesse össze őket a hatályos eDelivery specifikációkkal. A bizonylat ellenőrzését az e-számla validálása magyarázza el.

Szlovákiai üzemeltetés esetén egészítse ki a megállapodást az adatszolgáltatással is. A Pénzügyi Igazgatóság a digitális postáson (Digitálny poštár) keresztüli automatikus továbbítást írja le; az integrációnak lehetővé kell tennie, hogy a felhasználó visszakeresse annak eredményét. Az általános folyamatot a számlák kézbesítése írja le.

A munka megszervezését és a szoftverbeszállítóval végzett próbákat a könyvelőprogram bekötéséről szóló útmutató egészíti ki. A meglévő dokumentumok átalakításával a PDF eFaktúrává alakításának menete foglalkozik.

Anyagok, amelyekhez bármikor visszatérhet

Ellenőrzött források

Hivatalos anyagokból dolgozunk. Az eredeti dokumentumokat az alábbi hivatkozásokon találja. Ha a szabályok változnak, ezt az útmutatót is frissítjük.

Tartalom ellenőrizve 2026. 10. 01.. Egy konkrét adóügyben a törvény vonatkozó szövege és a teljesítés körülményei a döntők.