Dokumentáció az integrációkhoz: lookup, validáció, küldés, fogadás, webhookok és audit kimenet. Leírja az ajánlott bevezetési módot, biztonsági szabályokat és integrációs forgatókönyveket.
Az elérhető végpontok környezetenként és bevezetési típusonként eltérhetnek. Az éles kulcsok a szerveren maradnak, nem a böngészőben. A nyilvános frontend nem hívhatja közvetlenül a privát éles útvonalakat.
A privát API kulcsok a szerveren maradnak, nem a böngésző JS-ben. A küldésnek és az újrapróbálkozásnak Idempotency-Key-t kell használnia.
A végpontok nemcsak a küldést, hanem a fogadást, jóváhagyásokat, válaszkódokat, evidence csomagokat és az archiválási folyamatot is figyelembe veszik.
Egy integrátornak rövid quickstartra, payload példákra, retry szabályokra, webhookokra és a teszt/éles mód közötti egyértelmű különbségre van szüksége.
Az enterprise ügyfeleknél fontos a teljesen automatizált folyamat: a rendszer fogadja a feedet, validálja, konvertálja, elküldi, és a végleges artefaktumokat visszaadja az archívumnak vagy az ERP-nek.
Az integráció JSON/XML feeddel, kötegelt feldolgozással és biztonságos csatornákkal (pl. SFTP) számol. Az Interface Control Document lehet OpenAPI/Swagger specifikáció, leképezési és retry szabályokkal kiegészítve.
Hiba esetén a rendszernek részletes okot, rule ID-t, XML csomópontot és javasolt javítást kell visszaadnia. A javítás forrása a forrásrendszer marad, az eFaktúra centrum pedig webhookon keresztül adja vissza az eredményt.
Az enterprise ügyfeleknek gyakran szükségük van a végleges XML és PDF visszakapására, egy portálra a feldolgozott számlák áttekintéséhez, és saját márkázott PDF sablon elkészítésére.
Szerződés a feedhez, leképezéshez, hibakatalógushoz, verziózáshoz és ellenőrzőlistához enterprise csapatoknak.
Kézbesítési életciklus, callback payloadok, aláírási modell, retryk és eseménysorrend.
A végleges XML/PDF visszaadása, egyedi sablon csomag és archívum-átadás az ügyfél belső rendszerébe.
Promóciós ellenőrzőlista, teszt payloadok, idempotencia védőkorlátok és cutover szabályok az éles indulás előtt.
Rule ID-k, súlyosság, XML útvonal, javítási tippek és owner modell az enterprise triage-hoz.
Elnevezési konvenciók, manifesztek, ACK fájlok, részleges retry és nyomon követhetőség vállalati feedekhez.
EU adatrezidencia, audit naplók, megőrzés és az enterprise üzemeltetési modell a technikai átvilágításhoz.
SSO, életciklus és szerepkör-kormányzás vállalati tenantoknak és integrációs csapatoknak.
Pay-as-you-go API, könyvelőknek szóló csomagok és enterprise middleware egy kereskedelmi modellben.
Admin, könyvelő és fejlesztői jogosultságok szétválasztása, beleértve az API kulcsokat és audit szerepköröket.
Prioritási lista a szlovák piacra jellemző rendszerekről kompatibilitási státusszal. Az import már működik POHODA XML-lel, KROS exportokkal, Money/MRP CSV-vel és ISDOC-kal; további közvetlen konnektorok folyamatosan bővülnek.
Technikai alapkövetelmények edge fejlécekhez, CORS-hoz, payload ellenőrzésekhez, authhoz és enterprise hardeninghez.
Státuszoldal, webhook kézbesítési napló, correlation ID-k és incidensjelentés enterprise támogatáshoz.
e-Discovery csomag ügyfeleknek, akiknek egy adott időszakra XML/PDF/log exportra van szükségük.
Szabályok, PO-egyeztetés, viták és smart intake fejlettebb automatizálási forgatókönyvekhez.
Factur-X, clearance és roaming mint többországos irány további integrációkhoz.
Partner lookup 0245:2020123456 formátumban. Kimenet: regisztráció, név, támogatott dokumentumok, felkészültségi státusz és javasolt csatorna.
Az XML validáció visszaadja a rule_id-t, a probléma súlyosságát és egy javítási javaslatot. Egy helyi áttekintésben mindig egyértelműen jelezni kell, hogy ez nem éles eredmény.
Excel, CSV vagy előkészített exportok bemenetként, egy ZIP a kész XML-lel vagy kötegelt jelentéssel kimenetként. Alkalmas fokozatos átállásra új ERP nélkül.
A dokumentum előkészítése és küldése egy csatlakoztatott hitelesített partneren keresztül, hangsúllyal az Idempotency-Key-en, a transmission ID-n, az evidence-en és a következő válaszeseményeken.
Az ACK, NACK, elutasítás és egyéb események áttekintése, beleértve az üzleti jelentésüket és a feldolgozási idővonalat.
Csomag audithoz vagy belső ellenőrzéshez: payload, validációs összefoglaló, válaszesemények, szabályverzió és feldolgozási idővonal.
Az alábbi példák sandbox vagy szerveroldali integrációs mintaként szolgálnak. Az éles URL, az engedélyezés és az elérhető végpontok a választott bevezetéstől függenek.
A szállítási réteg megerősítette a kézbesítést a hálózatba vagy a címzetthez.
Szállítási vagy üzleti elutasítás. Jellemzően megnyitja a remediation flow-t.
Feltételes elfogadás, timeout vagy workflow adatkonfliktus.
A dokumentumot lezárták és archiválásra jelölték egy evidence csomaggal.
A végleges XML és PDF készen áll az ügyfél belső archívumába vagy számlázási rendszerébe való visszaadásra.
Az alacsony megbízhatóságú bemeneteknek emberi felülvizsgálaton kell átmenniük, nem autonóm küldésen.
A Peppol ID-t, adószámot, IBAN-t és partnerazonosítókat a köteg előtt validálni kell.
Az ACK nem jelent üzleti elfogadást. A workflow-nak várnia kell a következő válaszeseményre.
Nem kész partner esetén javasolt csatornát adjon vissza, ne csak egy "partner nem található" üzenetet.