Importáld Stripe kifizetéseidet számlaként 3 kattintással
A Stripe Revenue Sync átalakítja a Stripe kifizetéseidet regisztrált számlákká a Frihet-ben. Automatikus szinkronizálás 6 óránként, VeriFactu és nulla manuális munka.
Kulcspontok
- A Stripe Revenue Sync beimportálja a kifizetett Stripe számlákat a Frihet-be egy csak olvasható API kulccsal — OAuth nélkül, veszélyes engedélyek nélkül
- Automatikus szinkronizálás 6 óránként: az új kifizetések megjelennek a könyvelésedben anélkül, hogy bármit tenned kellene
- Az importált számlák megfelelnek a VeriFactu-nak: SHA-256 hash lánc és automatikus, hézagmentes számozás
Tartalomjegyzék
Kifizetéseket fogadsz Stripe-pal. Az ügyfeleid fizetnek. De ezek a tranzakciók nem számlák, amíg valaki számlává nem alakítja őket. Ez a „valaki” többé nem te leszel.
Ma elindítjuk a Stripe Revenue Sync-et: egy integrációt, amely automatikusan importálja a Stripe kifizetéseidet regisztrált számlaként a Frihet-be. Deduplikációval, VeriFactu hash lánccal és automatikus szinkronizálással 6 óránként.
A probléma: egyfelől a kifizetések, másfelől a számlázás
Ha egy SaaS alapítója vagy, Stripe-on keresztül fizetést fogadó szabadúszó, vagy digitális termékeket értékesítesz, valószínűleg ebben a helyzetben élsz:
- Stripe gyűjti a kifizetéseket. Ügyfeleid kártyával fizetnek, megújulnak az előfizetések, beérkeznek az egyszeri kifizetések.
- A könyvelésed nem tud róla. Ezek a kifizetések léteznek a Stripe-ban, de nem a számlázó szoftveredben.
- Te vagy a híd. Minden hónapban manuálisan hozol létre számlákat a Stripe adatok másolásával. Vagy ami még rosszabb: nem teszed, és a könyvelőd megőrül a következő negyedévben.
A Stripe nyugtákat állít ki, de Spanyolországban adóügyileg nem érvényes számlákat. Nem tartalmazza az NIF-edet, nem alkalmazza az Adóhivatal által előírt számozást, nem generálja a VeriFactu által megkövetelt hash láncot. A spanyol adószabályok betartásához valódi számlákat kell létrehoznod egy számlázó szoftverben.
Eddig ez kettős munkát jelentett. Már nem.
Mi az a Stripe Revenue Sync
A Revenue Sync összeköti a Stripe fiókodat a Frihet-tel egy csak olvasható, korlátozott API kulcs segítségével. OAuth nélkül, átirányítások nélkül, és anélkül, hogy írási engedélyeket adnál a pénzedre.
Amit tesz:
- Lekérdezi a kifizetett számláidat a Stripe-ban — csak azokat, amelyek
paidállapotúak - Létrehoz egy számlát a Frihet-ben minden kifizetéshez — ügyféllel, tételsorokkal és összegekkel
- Fizetettre jelöli a számlát — a VeriFactu folyamata automatikusan aktiválódik
- Deduplikálja a Stripe ID alapján — ha a számla már létezik, figyelmen kívül hagyja
Az eredmény: a Stripe kifizetéseid regisztrált számlákként jelennek meg a Frihet-ben, szekvenciális számozással, SHA-256 hash-sel és készen állnak a 303-as adóbevallásodra.
Hogyan működik a gyakorlatban
Három lépés. Kód nélkül, bonyolult konfigurációk nélkül.
1. lépés: Hozz létre egy korlátozott API kulcsot a Stripe-ban
Menj a Stripe Dashboard > Developers > API Keys oldalra. Hozz létre egy korlátozott kulcsot két engedéllyel:
- Invoices → Read
- Customers → Read
Semmi más. Nincs szükséged írási engedélyekre, sem hozzáférésre a kifizetésekhez, átutalásokhoz vagy egyenlegekhez. A kulcs rk_live_ kezdetű és csak olvasható.
2. lépés: Kapcsolódj a Frihet-ben
Menj a Beállítások > Integrációk > Stripe Revenue Sync menüpontra. Illeszd be az API kulcsodat, és válaszd ki, mely dátumtól szeretnél importálni. Importálhatod az elmúlt 90 napot, vagy választhatsz egy konkrét dátumot.
3. lépés: Importálás
Kattints az „Importálás most” gombra. A Frihet lekérdezi a Stripe-ot, beolvassa a kifizetett számlákat, és létrehozza azokat a fiókodban. Minden számla átesik a Firestore triggerein: hézagmentes számozás és VeriFactu hash lánc.
VeriFactu kompatibilis az első importálástól kezdve
Az importált Stripe számlák nem „másodrangúak”. Pontosan ugyanazon a folyamaton mennek keresztül, mint a Frihet-ben manuálisan létrehozott számlák:
- Hézagmentes számozás — Atomikus számláló a szerveren. Hézagok és ugrások nélkül.
- SHA-256 hash — Az AEAT által megkövetelt 8 mezős hash lánc. Minden számla hivatkozik az előző hash-ére.
- Megváltoztathatatlanság — Regisztrálás után a kritikus mezők zárolva maradnak. A módosítások helyesbítő számlákat generálnak.
- Nyilvántartási könyv — Az importált számlák megjelennek a CSV exportálásban az Adóhivatal által kért 19 oszloppal.
Ez azt jelenti, hogy a Stripe kifizetéseid készen állnak a 303-as adóbevallásra, a 130-as adóbevallásra és bármilyen ellenőrzésre. További lépések nélkül.
Kinek szól a Revenue Sync
SaaS alapító, aki Stripe Billing-gel számláz
Közvetlenül a Stripe-ban gyűjtesz előfizetéseket. Minden hónapban több tíz vagy száz ügyfél megújítja az előfizetését. A Revenue Sync segítségével minden megújítás automatikusan számlaként jelenik meg a Frihet-ben. Az MRR-ed, a negyedéves ÁFÁ-d és a nyilvántartási könyved mindig naprakész.
Szabadúszó, aki Stripe-on keresztül számláz projekteket
Ügyfeleid Stripe-on keresztül fizetnek neked, és minden számlát egy helyen szeretnél tartani a negyedéves adóbevallásaidhoz. Anélkül, hogy minden számlát manuálisan kellene létrehoznod, és anélkül, hogy adatokat kellene egyeztetned a Stripe és a táblázatod között.
Közvetlen Stripe-pal rendelkező eCommerce
Digitális vagy fizikai termékeket értékesítesz és Stripe-pal gyűjtesz kifizetéseket (nem Shopify vagy WooCommerce-en keresztül). Minden eladás regisztrált számlává válik. Különösen hasznos, ha EU-s ügyfeleknek értékesítesz, és szükséged van az ÁFA ellenőrzésére.
Ügynökség vegyes számlázással
Néhány ügyfél Stripe-on keresztül fizet neked, mások átutalással. A Revenue Sync importálja a Stripe-os kifizetéseket, miközben a többit manuálisan vagy a Frihet közvetlen számlázásával számlázod. Minden ugyanabban a nyilvántartási könyvben él együtt.
Mi NEM a Revenue Sync
Érdemes tisztázni a félreértések elkerülése végett:
- Nem a Stripe OAuth integrációja. Az már létezik a Frihet-ben, és lehetővé teszi a kifizetések gyűjtését magából az alkalmazásból fizetési linkekkel. A Revenue Sync egyirányú: csak importál.
- Nem hajt végre kifizetéseket. Nem dolgoz fel kifizetéseket, és nem hoz létre terheléseket a Stripe-ban. Csak a már kifizetett számlákat olvassa be.
- Nem helyettesíti a Stripe Billing-et. Kiegészíti azt. A Stripe gyűjti a kifizetéseket, a Frihet rögzíti.
- Nem szűr ügyfél szerint. Az összes kifizetett számlát importálja a kiválasztott dátumtól kezdve. A deduplikáció gondoskodik arról, hogy ne legyenek duplikációk.
Biztonság
A korlátozott API kulcs csak olvasható engedélyekkel rendelkezik két erőforráshoz: számlákhoz és ügyfelekhez. Nem mozgathat pénzt, nem hozhat létre kifizetéseket, és nem módosíthatja a Stripe fiókodat.
A kulcs AES-256-GCM titkosítással van tárolva a Frihet szerverén. Soha nem kerül ki a frontendre. Ha a Stripe észleli, hogy a kulcs lejárt vagy visszavonásra került, a Frihet az integrációt „újracsatlakozást igényel” állapotúra jelöli, és értesít téged.
Bármikor lekapcsolódhatsz a Beállítások > Integrációk menüpontból. A már importált számlák megmaradnak a Frihet-ben.
Kezd el most
Ha Stripe-pal gyűjtesz kifizetéseket, a számláid már ott vannak. Már csak a könyvelésedbe kell bekerülniük. A Stripe Revenue Sync 3 kattintással megteszi ezt, OAuth nélkül, veszélyes engedélyek nélkül, és az első naptól kezdve VeriFactu kompatibilisen.
Csatlakoztasd Stripe fiókodat és hagyd, hogy a kifizetéseid automatikusan regisztrált számlákká váljanak.
Hasznos volt ez a cikk?
Gyakran ismételt kérdések
Miben különbözik a normál Stripe integrációtól?
A normál integráció OAuth-ot használ és kétirányú: a Frihet-ből is gyűjthetsz kifizetéseket. A Revenue Sync egyirányú: csak olvasható, korlátozott API kulcsot használva importálja a már kifizetett Stripe számlákat. Nincs hozzáférése a pénzedhez.
Megduplázódnak a számlák, ha többször importálok?
Nem. Minden importált számla elmenti a Stripe ID-t metaadatként. Ha már létezik a Frihet-ben, automatikusan figyelmen kívül hagyja.
Az importált számlák megfelelnek a VeriFactu-nak?
Igen. Átesnek a Frihet SHA-256 hash láncán és a hézagmentes számozásán, pontosan ugyanúgy, mint a manuálisan létrehozott számlák. Készen állnak a 303-as adóbevallásodra és a nyilvántartási könyvedre.
Kiválaszthatom, hogy mely számlákat importáljam?
Beállíthatsz egy kezdő dátumot. Az összes, az adott dátumtól kifizetett számla importálásra kerül. A deduplikáció biztosítja, hogy soha ne ismétlődjön egy számla.
Kapcsolódó cikkek
Újdonságok
MCP Szerver v1.2: erőforrások, promptok és strukturált kimenet
6 perc olvasás
categories.termék
Frihet MCP Szerver v1.2.1: erőforrások, promptok és strukturált kimenet
3 perc olvasás
categories.technológia
Könyvelő és egyéni vállalkozó a Frihetben: a többügyfeles munkaterület.
5 perc olvasás