Ami a Stripe a fizetésben, az a TACITo a számlázásban
A TACITo a te szolgáltatásodhoz igazodik: minden sikeres fizetés után magától kiállítja a NAV-kompatibilis számlát, elküldi a vevődnek és jelenti a NAV-nak. Akár AI-jal építetted a szoftveredet, akár hagyományosan, a beállítás percek alatt kész, és a kódot az agented írja meg.
Illeszd be a kódoló agentednek:
Integrate TACITo invoicing into this app: https://tacito.hu/sdk
Ennyi az egész. Az agent elolvassa ezt az oldalt, megnézi a kódodat, és a saját fizetési szolgáltatódhoz (Stripe, Barion, SimplePay, PayPal vagy átutalás) és adatbázisodhoz igazítja a számlázást. Ha valamit nem tud, előbb megkérdez. Neked egy API-kulcsot kell létrehoznod a TACITo-fiókodban; ha a számlázáshoz még hiányzik valami (például a NAV-kapcsolat vagy a számlaszámozás), az agent megmondja, mit állíts be.
For AI coding agents: the complete integration guide is https://tacito.hu/llms.txt. Read it first and follow its "Fitting TACITo into your app" section.
Gyakori kérdések
Milyen fizetési szolgáltatóval működik?
Bármelyikkel: a TACITo nem kapcsolódik a fizetési szolgáltatóhoz, a te kódod hívja meg, amikor a fizetés sikerült. Az llms.txt lépésenként leírja a Stripe (egyszeri és előfizetéses), a Barion, a SimplePay, a PayPal és az átutalás esetét. Ha a szolgáltató viszonteladóként maga számláz a vevődnek (merchant of record, például Paddle vagy Lemon Squeezy), a vevőnek nem kell még egy számla; hogy ilyenkor mit és kinek számlázz, egyeztesd a könyvelőddel.
Előfizetéses SaaS díjait is számlázhatom vele?
Igen: minden kifizetett időszakról (az első fizetésről és minden megújításról) külön számla készül, a fizetési szolgáltató eseményéből indítva. Stripe-nál ez az invoice.paid esemény.
Csak JavaScriptből lehet használni?
Az SDK TypeScripthez és JavaScripthez készült. Bármely más nyelvből (Python, PHP, Go, Ruby) ugyanez a REST API-n keresztül megy: az llms.txt második fele pontosan ezt írja le, sima HTTP-hívásokkal, és van OpenAPI-leírás is.
Mi történik, ha az agentem vagy a kódom hibázik?
Az ismételt hívás nem hoz létre új számlát, a rossz vagy hiányos adatra mezőnkénti hibát kapsz, a hiányzó beállításokat pedig a readiness() mutatja meg. A kiállított számlát nem lehet törölni, csak sztornózni, és ez is egy hívás.
Hogyan regisztrálhatok?
A regisztráció nyitott, meghívókód nem kell. Számlát kiállítani előfizetéssel lehet; kérdés esetén írj az info@tacitproject.hu címre.
Milyen adatbázissal működik?
Bármelyikkel. Az SDK nem nyúl az adatbázisodhoz: az appod kiolvassa a rendelést, a visszakapott számlaszámot pedig eltárolja. Postgres, MySQL, SQLite, MongoDB, Prisma, Drizzle vagy Supabase egyaránt jó; az agent a projekted meglévő migrációs eszközével veszi fel az új mezőket.
Mennyibe kerül az API és az SDK?
Az SDK ingyenes és nyílt forráskódú. Az API-használat benne van a TACITo-előfizetésben, nincs külön API-díj és nincs hívásdíj. Árak
Nincs saját backendem, csak frontend és Supabase. Így is megy?
Igen, Supabase Edge Functionnel. A csomagban lévő recipes/supabase-edge-function.ts a kész minta: a kulcs a függvény titkosított beállításai (secrets) között van, a böngésző csak a függvényt hívja.
Ki felel a kiállított számláért?
Te, ugyanúgy, mint a kézzel kiállított számláért: a számla a te céged nevében készül. Minden kulcs egy céghez tartozik, a műveletek naplózva vannak, és bármelyik kulcs azonnal visszavonható.
Van MCP-szerver is, AI-asszisztensekhez?
Igen. A tacito-mcp csomaggal a Claude Desktop, a Claude Code, a Cursor vagy a Codex a saját TACITo-fiókodban kereshet számlát és készíthet piszkozatot; számlát csak akkor állít ki, ha ezt külön bekapcsolod. MCP-szerver
Három lépés, és számláz a rendszered.
Nem kell NAV-XML-t, számlaszámozást vagy áfalogikát írni. Ezt mind a TACITo intézi; a szoftverednek csak azt kell megmondania, kinek és miről szól a számla.
-
Add oda az agentednek
Másold be a fenti sort a Claude Code-ba, a Codexbe vagy a Cursorba. Az agent megnézi a kódodat, és a saját fizetési folyamatodhoz igazítja a számlázást.
-
Hozz létre egy API-kulcsot
Beállítások → Integrációk és API: hozz létre egy „Olvasás + írás” jogú kulcsot. Az agent megmondja, hová tedd: a szerver TACITO_API_KEY környezeti változójába, sosem a böngészőbe.
-
Számláz a rendszered
Minden sikeres fizetés után magától elkészül a számla, a számlaszám a rendeléshez kerül, a NAV-adatszolgáltatás pedig a háttérben megy. Élesítés előtt az agent megmondja, mi hiányzik még.
Ezt intézi el helyetted az SDK
A számlázásban nem a hívás a nehéz, hanem az, ami közben elromolhat. Ezt a csomag kezeli, a te kódod rövid marad.
Nincs dupla számla
A kiállításhoz, a befizetéshez és a sztornóhoz egy reference tartozik (például a rendelésed azonosítója). Ha a hívást időtúllépés vagy összeomlás után megismétled, az első eredményt kapod vissza, nem egy második számlát. Ugyanaz a reference más tartalommal 409-es hibát ad, sosem csendben létrejött duplikátumot.
Automatikus újrapróbálkozás
Olvasásnál, és írásnál is, ha van reference, hálózati hiba, 429 vagy 5xx esetén összesen legfeljebb három kísérletet tesz, a Retry-After fejlécet tiszteletben tartva. Az e-mail-küldést szándékosan sosem ismétli meg, hogy a vevő ne kapja meg kétszer a számlát.
Hibaüzenet, amiből dönteni lehet
Minden hiba TacitoError: benne van a HTTP-státusz, egy gépi hibakód (például invalid_tax_number), a mezőnkénti hibák és egy kérésazonosító az ügyfélszolgálatnak, és jelzi, érdemes-e újrapróbálni.
Élesítési ellenőrzőlista
A readiness() megmondja, mi hiányzik még az élesítéshez (kiállítói adatok, számlasorozat, előfizetés, NAV éles hozzáférés), mindegyikhez a megfelelő beállítási oldalra mutató linkkel.
NAV-állapot és fizetés
Az events.iterate() sorban adja a kiállítást, a befizetést és a NAV-visszaigazolást. A befizetés rögzítése, a sztornó és az e-mail-küldés egy-egy hívás.
Bármilyen szerveren
Futásidejű függőség nélkül fut Node 18+, Deno, Bun, Vercel és Cloudflare edge alatt. Más programnyelvből ugyanez sima HTTP-n keresztül megy, nyilvános OpenAPI-leírással.
Add oda a kódoló agentednek.
Nem kell magadnak beépítened: a Claude Code, a Codex vagy a Cursor a tacito.hu/llms.txt alapján megcsinálja. Ott géppel olvasható formában minden benne van, az is, hogyan kösse be a számlázást a te fizetési szolgáltatódhoz és a te adatbázisodhoz.
- Fizetés
- Megtalálja, hol tudja meg az appod, hogy a fizetés sikerült (Stripe, Stripe-előfizetés, Barion, SimplePay, PayPal vagy átutalás), és ott állítja ki a számlát. Teljes visszatérítésnél sztornóz, részleges visszatérítésnél előbb megkérdez.
- Adatbázis
- A projekted saját adatbázisával és migrációs eszközével dolgozik (Postgres, MySQL, Prisma, Drizzle, Supabase vagy más), és felveszi a számlaszámot meg a vevő számlázási adatait.
- Előbb kérdez
- Alanyi adómentes vagy-e, kik a vevőid, nettó vagy bruttó áraid vannak. Az adózást nem találgatja.
1Telepítés: add oda az agentnek, vagy futtasd a projekt mappájában
npm install tacito-sdk && mkdir -p .claude/skills && cp -r node_modules/tacito-sdk/skill/tacito-invoicing .claude/skills/
npm install tacito-sdk && cat node_modules/tacito-sdk/skill/tacito-invoicing/SKILL.md >> AGENTS.md
npm install tacito-sdk && mkdir -p .cursor/rules && cp node_modules/tacito-sdk/skill/tacito-invoicing/SKILL.md .cursor/rules/tacito-invoicing.mdc
2Utána ezt a promptot
Add TACITo invoicing (Hungarian invoices with automatic NAV reporting) to this app. First read https://tacito.hu/llms.txt and follow it exactly, especially the section "Fitting TACITo into your app". Find out which payment processor and which database and ORM this project uses, and ask me the questions listed there before you write code. Then: use tacito-sdk only in server code (if this is not a JavaScript or TypeScript project, use the plain-HTTP API instead), with the API key in the server-side environment variable TACITO_API_KEY; add the billing-details fields and the invoice columns with this project's migration tool; issue the invoice with createAndIssue from the processor's verified payment-succeeded event, using an app-prefixed reference and the buyer and amounts from the database; storno the invoice on a full refund; serve the PDF only from a route that checks that the logged-in user owns the order. At the end, call readiness() and tell me which go-live steps are missing.
Nem JavaScript a projekted? Az 1. lépést hagyd ki, a prompt elég: az agent az llms.txt alapján sima HTTP-n keresztül köti be.
Add oda az agentednek ezt az oldalt, és percek alatt számláz a szoftvered.
Regisztrálok