FiscalNET dokumentáció.
Lépésről lépésre történő integráció.

Válassza ki az integrációs módszert.

Egyetlen hívási mód. Windows és Android.

Az integrált webszerver POST-kéréseket fogad a következő címen: http://localhost:65400/api/Receipt. A kérés törzse lehet egy JSON-karakterlánclista, ahol minden egyes karakterlánc egy parancsot reprezentál. A Postmanben válassza a POST, Body → raw → JSON lehetőséget, valamint a fejlécet. Content-Type: application/json.

Windows rendszeren továbbra is elérhető a Bonuri mappába helyezett fájlokon keresztüli folyamat is. A banki POS-nak az API-n keresztül küldött parancs csak Windows rendszeren érhető el.

Webalkalmazások: ellenőrizze a böngésző szabályait is

Egy HTTPS-oldal és egy helyi HTTP-szolgáltatás a böngésző biztonsági korlátozásaiba ütközhet. Konfigurálja az engedélyezett eredetet és a CORS/OPTIONS választ, és amikor a telepítés helyi HTTPS-t biztosít, használja az adott verzióhoz konfigurált címet és tanúsítványt. Ne feltételezze, hogy az IP-cím egyszerű cseréje megoldja ezeket a követelményeket; ne kapcsolja ki a böngésző védelmi funkcióit.

[
  "CF^RO 123456789",
  "S^ARTICOL DE STORNAT^600^1000^buc^1^1",
  "VS^ARTICOL STORNO^600^1000^buc^1^1",
  "S^ARTICOL 1^500^1000^buc^1^1",
  "DP^1000",
  "S^ARTICOL 2^500^1000^buc^1^1",
  "DV^100",
  "S^ARTICOL 3^415^1000^buc^1^1",
  "MP^500",
  "S^ARTICOL 4^315^1000^buc^1^1",
  "MV^50",
  "ST^",
  "DP^500",
  "CB^5940000000820^2",
  "TL^Rand text liber 1",
  "TL^Alt rand text liber",
  "P^2^1000",
  "P^1^2000"
]

Integrációval kapcsolatos pontosítások: FiscalNET csapata, 2026. október 19. A PDF-ben szereplő példák a /api/receipt írásmódot is használják; a fenti cím az integrátoroknak közölt formát tükrözi. Ellenőrizze a telepített verzió útvonalát és konfigurációját.

Közös HTTP API Windows és Android rendszerhez.

Az útmutató helyi adatbázisa: http://localhost:65400. Használja az Ön példányában beállított címet és portot. Ne tegye ki a helyi szolgáltatást közvetlenül az internetnek.

curl.exe http://localhost:65400/api/health

A parancsok végrehajtásához az útmutató támogatja a többsoros szöveget vagy a sorok JSON-listáját. Példa az állapot lekérdezésére:

curl.exe -X POST "http://localhost:65400/api/receipt" -H "Content-Type: text/plain" --data-binary "STATUS"

Windows-fájlok: könnyen követhető folyamat.

1. Készítse el a fájlt

   Kérjük, használja a .txt, .inp vagy .json formátumot az útmutatóban szereplő megfelelő szintaxissal.

2. Küldje el a parancsot

   Helyezze a teljes fájlt a Bonuri mappába vagy a konfigurált eszköz mappájába.

3. Kérjük, olvassa el az eredményt

   A feldolgozás után a parancs az Istoric mappába kerül, az eredményt pedig a Raspuns mappából olvashatja.

4. Tartsa meg a párt

   A parancsot és a választ együtt archiválja a diagnosztika és a nyomon követhetőség céljából.

A parancsok hivatkozása szöveges formátumban.

A sima szöveges formátumban minden sor egy utasítást jelöl. A mezőelválasztó a ^. Az alábbi jelölésben a kapcsos zárójelek a helyettesítendő értékeket jelölik, a ? pedig egy opcionális paramétert; ezek a jelek nem képezik a küldött érték részét.

A teljes szintaxis és a példák a PDF-ben · 5–8. oldal

Android Intent: alkalmazások ugyanazon az eszközön.

A műszaki csomag változatlan marad com.econmedia.fiscalnet; ez az alkalmazás azonosítója, nem a társaság neve.

Az eredményekre vonatkozó extrák a com.econmedia.fiscalnet.result előtagot használják.: SUCCESS, RESPONSE_JSON, HTTP_STATUS_CODE, RECEIPT_STATUS, RECEIPT_NUMBER, RECEIPT_INFO, ERROR_CODE és ERROR_INFO. Kérjük, tartsa meg az azonosítókat pontosan úgy, ahogyan az útmutatóban szerepelnek.

Kotlin-példák és Android-eredmények · 13. oldal

INP: őrizze meg a kompatibilitást, ellenőrizze a jelentést.

Az INP egy parancsformátum a meglévő integrációkhoz. Használjon vesszőt és pontosvesszőt elválasztóként, tizedes számokat az összegeknél és a mennyiségeknél, valamint ugyanazt az 1 és 99 közötti logikai számot a dokumentum minden sorában. A sorok sorrendje határozza meg a kontextust.

Ne alakítson át parancsot egyszerű szöveg és INP között csupán az elválasztójelek lecserélésével. A fizetési kódoknak, az összegek ábrázolásának és egyes parancskaraktereknek eltérő jelentése van. Kérjük, tekintse meg az INP-sorok teljes szerkezetét a PDF-dokumentumban, a 8–10. oldalon.

POS-fizetések: ellenőrizze a tényleges műveletet.

A banki POS integrációjához ellenőrizze a PLUS licencet, a beállított terminált és több terminál esetén a POS azonosítóját. Ellenőrizze az adott terminálhoz és platformhoz használható csatlakozási módot.

Különleges szabályok a POS-parancshoz · 14. oldal

A FiscalNET PLUS banki POS-rendszerrel való integrációjának részletei

Értelmezze az eredményt, ne csak a továbbítást.

Hibaelhárítás: a tünettel kezdje.

Tekintse meg a telepítéssel, a licencekkel és a támogatással kapcsolatos gyakran ismételt kérdéseket is

Az éles üzemben történő használat előtt.

1. Azonosítsa az eszközt

   Ha több készülék van, kérjük, kifejezetten adja meg az adóügyi eszköz azonosítóját. Banki fizetés esetén kérjük, adja meg a POS azonosítóját is, ha rendelkezésre áll, és ellenőrizze a PLUS licencet, valamint a konfigurált terminált.

2. Tesztelje a válaszokat

   Ellenőrzött környezetben lefedi a sikeres műveleteket, az elérhetetlen eszközt, a papírhiányt és a parancshibákat.

3. Válassza el a fizetést a visszaigazolástól

   Ne feltételezze, hogy az időtúllépés sikertelenséget jelent. Kérjük, ellenőrizze a műveletet az újraküldés előtt.

4. Dokumentálja az integrációt

   Kérjük, őrizze meg a verziókat, a beállításokat, valamint a parancs/válasz példákat, de kártyaadatok és egyéb érzékeny információk nélkül.

Források: az általános integrátori útmutató 2026. április 30-i kiadása (15 oldal), a FiscalNET csapat 2026. október 19-i pontosításai a Windows/Android-hívásokról és a helyi böngészőről, valamint a 2026. november 3-i megerősítés az Android banki POS-integrációjáról.

Példák és hivatkozások a meglévő integrációkra

Új integráció esetén kérjük, induljon ki a 2026-os általános útmutatóból és a fenti parancsokra vonatkozó hivatkozásból. A 2024-es anyagokat megőrizzük referenciaként a meglévő integrációkhoz.