Ugrás a tartalomhoz
Árak

Nyelv

Kezdje ingyen
← Vissza a Journalhoz
categories.technológia
5 perc olvasás

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.

Szerző Equipo Frihet
Megosztás
Importáld Stripe kifizetéseidet számlaként 3 kattintással

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:

  1. Lekérdezi a kifizetett számláidat a Stripe-ban — csak azokat, amelyek paid állapotúak
  2. Létrehoz egy számlát a Frihet-ben minden kifizetéshez — ügyféllel, tételsorokkal és összegekkel
  3. Fizetettre jelöli a számlát — a VeriFactu folyamata automatikusan aktiválódik
  4. 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

Hozzászólások

Frihet — Üzlet dráma nélkül

Indulj Ingyen