Nyugta leadása egyszerű API-n
A saját rendszerednek nem kell pénztárgép-protokollt, soros kapcsolatot vagy helyszíni hibakezelést fejlesztenie. Leadja a feladatot, eltárolja a feladatId-t, majd lekérdezi az eredményt.
Pénztárgép-kapcsolat fejlesztési teher nélkül
Nyugtát kell adnod? Ne a pénztárgéppel töltsd az időt.
Kész szolgáltatás szoftverfejlesztő cégeknek, akik gyorsan szeretnék összekötni saját rendszerüket Sam4s NR-330 pénztárgéppel. Egyszerű feladatleadás, lekérdezhető nyomtatási állapot, helyszíni Pénztárgép vezérlő és kevesebb egyedi hardveres hibakeresés.
Saját rendszer
Nyugtafeladat leadása
rendelés, fizetés, tételek
POST
Nyugtaszolgáltatás
Feladat sorba áll
feladatId azonnal visszaér
átvétel
Pénztárgép vezérlő
Helyszíni nyomtatás
Sam4s NR-330 kapcsolat
Állapotlekérdezés
GET /api/v1/nyugta/{feladatId}
vár, átvette, kész, hiba, bizonytalan
eredmény
NYUGTA
0012/00034
1 API
nyugta, számla, sztornó és állapot egy helyen
9
feladattípus
pár mp
tipikus átfutás működő helyszíni kapcsolattal
0 protokoll
pénztárgép-specifikus fejlesztés a te oldaladon
Szolgáltatás
A pénztárgép-kapcsolatot mi tesszük integrálhatóvá
A fejlesztőcsapatodnak elég a feladatleadási és állapotlekérdezési szerződéshez igazodnia. A helyszíni Pénztárgép vezérlő kezeli a Sam4s NR-330 sajátosságait, a kapcsolat állapotát és a nyomtatási eredmény visszajelzését.
A helyszíni gép intézi a hardvert
A Pénztárgép vezérlő a boltban fut, figyeli az új feladatokat, ellenőrzi a pénztárgép állapotát, majd elvégzi a nyomtatást a Sam4s NR-330-on.
RDP és régi rendszerek mellett is működik
Ha az API-hívás nem megoldható, a küldő program egy JSON fájlt tesz a figyelt mappába. A Pénztárgép vezérlő csak a teljesen kiírt fájlt veszi át, így nem dolgozik félig elkészült adatokból.
Licenc pénztárgépenként
A bizonylatnyomtatás érvényes licenchez kötött. Ha a licenc nincs rendben, vagy a pénztárgép átmenetileg nem elérhető, a feladat megmarad várakozó állapotban, és a probléma rendezése után folytatható.
Feladattípusok
Nem csak nyugta
Ugyanaz az endpoint kezeli a nyugtát, sztornót, visszárut, egyszerűsített számlát, pénzmozgást, napnyitást, napi zárást, állapotot és megszakítást.
Kiválasztott típus
nyugta
Alap bizonylat tétellel, fizetéssel, opcionális nyomtatott azonosítóval.
- Végpont
- POST /api/v1/nyugta
- API példa
{"tipus":"nyugta","tetelek":[{"arunev":"Kave","ar":500,"mennyiseg":2}],"fizetesek":[{"fizetoeszkoz":1,"ertek":1000}]}
Fejlesztői integráció
Három végpont, világos felelősségekkel
A leadás nem egyszerű mellékhatásként kezelendő, hanem állapotváltásként a saját rendszeredben. A feladatId lesz a horgony a rendelés és a későbbi nyugtaszám között.
curl -X POST "https://pelda.hu/nyugtaszerver/api/v1/nyugta" \
-H "Authorization: Bearer nyk_..." \
-H "Content-Type: application/json" \
-d '{"tipus":"nyugta","tetelek":[{"arunev":"Kave","ar":500,"mennyiseg":2}],"fizetesek":[{"fizetoeszkoz":1,"ertek":1000}]}'Üzemi szabályok
A rendszer a duplázás ellen van hangolva
Adóügyi bizonylatnál a kimaradt nyugta pótolható, a véletlenül duplán kinyomtatott viszont nem vonható vissza. Ezért a várakozás és az emberi ellenőrzés tudatos döntés.
- A nyugta leadása aszinkron: a POST nem várja meg a papírt.
- Hálózati hiba után nincs automatikus újraküldés, mert második nyugta készülhet.
- A készpénz és az euró legyen az utolsó fizetés, mert visszajáró csak készpénzből adható.
- A \ és | karakter tiltott minden szövegmezőben, mert protokoll elválasztók.
- Az azonosito mező a bizonylatra kerül, ezért nem belső rendelésazonosító.
Feladat leadása
A webalkalmazás vagy fájlküldő létrehozza a nyugta, számla vagy állapot feladatot.
Sorba állítás
A nyugtaszerver eltárolja, a fájl alapú út pedig a be mappában várakoztatja.
Átvétel
A Pénztárgép vezérlő csak akkor vesz át munkát, ha elérhető a pénztárgép és rendben van a licenc.
Nyomtatás vagy hiba
A PTG lánc validál, küld, választ értelmez, majd visszaírja a nyugtaszámot vagy a hibát.
Kapcsolat
Árakért és további információért
Írj vagy hívj, ha szoftverfejlesztőként Sam4s NR-330 pénztárgép-kapcsolatot szeretnél beépíteni kevesebb saját fejlesztési munkával.