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.
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.