Receptek

A receptek teljes, működő fájlok, nem kódrészletek. Next.js App Router projektre készültek, de a kassza hívásai bármilyen szerveren ugyanígy működnek. Mindegyik a gyakorlatban bevált mintát követi: rendelésszám minden bizonylaton, lekérdezés a kiállítás előtt, és soha nincs újraküldés ciklusban.

Alapok#

Közös kliens

Egyetlen szerveroldali kliens alapbeállításokkal, naplózással és közös munkamenettel.

Fizetett rendelés számlája

Idempotens számlázás rendelésszámmal, amelyet minden fizetési webhook újrahasznosít.

Fizetések#

Stripe, SimplePay, Barion, Revolut és PayPal fizetéshez kész webhookkezelő is van, amely pontosan egyszer állít ki nyugtát vagy számlát: lásd Fizetésből bizonylat. Az alábbi receptek a lépéseket mutatják, saját vezérléssel.

Stripe webhook

checkout.session.completed esemény, aláírás-ellenőrzés, dupla számla nélkül.

Nevezés díjbekérővel

Díjbekérő a nevezéskor, számla a befizetés után, törlés lemondáskor.

IPN webhook

A Számlázz.hu fizetési értesítésének ellenőrzött, idempotens feldolgozása.

Pénztári nyugta

Food truck nyugta createOnce-szal, e-mail kiküldéssel, dupla nyugta nélkül.

Adatok és tárolás#

PDF mentése S3-ba vagy R2-be

A számla PDF-je saját tárhelyre, lejáró letöltési linkkel, AWS SDK nélkül.

Adószám alapú kitöltés

Számlázási űrlap, amely a NAV adataiból tölti ki a cégnevet és a címet.

Devizás számla EU-s cégnek

Euróban kiállított, angol nyelvű számla közösségi adószámmal.

Futtatás és tesztelés#

Cloudflare Workers

Worker KV munkamenettel és R2-ben gyorsítótárazott számla PDF-ekkel.

Egységtesztek

Vitest tesztek mock klienssel: idempotencia, hálózati hiba, időtúllépés.

Hamis Számla Agent

Integrációs tesztek a valódi kassza kódon, elveszett válasszal és karbantartással.