Stripe kobzások importálása számlákként: Frihet Revenue Sync útmutató

Ha Stripe-on szeded be a bevételeidet – Checkout-on, Payment Links-en, vagy API-on keresztül – előfordulhat, hogy a számlázás külön kézzel zajlik. A Stripe fizetési igazolást küld, de a jogi számlát neked kell kiállítani. Ez kettős munkát jelent.

A Frihet Stripe Revenue Sync felszámolja ezt a kettős munkát: minden Stripe-tranzakciót automatikusan importál és számlát generál belőle.

Hogyan működik a Revenue Sync

A Revenue Sync a Stripe webhook-rendszerén alapul. Aktiválás után a Frihet:

1. Feliratkozik a Stripe payment_intent.succeeded, charge.succeeded, invoice.paid és refund.created eseményeire
2. Minden beérkező eseményt számlává konvertál a Frihet-rendszerben
3. Az ügyfél azonosítása email-cím alapján (meglévő ügyfél párosítása, vagy új ügyfél létrehozása)
4. A termék/leírás a Stripe metadata-ból töltődik ki
5. A számla bekerül a VeriFactu hash-láncba

Az egész folyamat 2-5 másodpercen belül zajlik a Stripe-esemény után.

Aktiválás lépések

1. Stripe-kapcsolat

1. Menj a Beállítások → Integrációk → Stripe menüponthoz
2. Kattints a “Csatlakoztatás” gombra
3. Átirányít a Stripe OAuth-folyamatra
4. Engedélyezd a hozzáférést (olvasás + webhook)
5. Visszairányítás a Frihetbe, a kapcsolat aktív

2. Revenue Sync aktiválása

Az integráció-oldalon a Stripe kapcsolat után:

1. Kapcsold be a “Revenue Sync” kapcsolót
2. Válaszd ki a kezdő dátumot (ajánlott: az aktuális adóév első napja)
3. Válaszd ki az alapértelmezett számlázási sorozatot az importált számlákhoz
4. Mentsd

Az első futáskor a Frihet lekéri az összes Stripe-tranzakciót a megadott kezdő dátumtól és számlát generál belőlük. Ez a kezdeti szinkronizálás néhány percet vehet igénybe nagy tranzakciómennyiségnél.

Az importált számlák formátuma

Minden importált Stripe-tranzakcióból a Frihet a következőket generálja:

Fejléc adatok:

• Kiállítás dátuma: a Stripe-tranzakció dátuma
• Sorszám: a Frihet sorozat következő száma
• Ügyfél: email-cím alapján párosítva vagy létrehozva

Tartalom:

• Leírás: Stripe charge/invoice description mezőből
• Összeg: a Stripe-tól kapott összeg (multi-currency esetén az eredeti devizában)
• ÁFA: az alapértelmezett beállítás szerint (manuálisan módosítható importálás után)

VeriFactu:

• SHA-256 hash automatikusan generálva az előző hash alapján
• QR-kód hozzáadva a számlához
• Szekvenciális sorszám biztosítva

Ügyfél-párosítás logika

A Revenue Sync az ügyfélpárosítást email-cím alapján végzi:

1. Meglévő ügyfél találat: Ha az ügyfél email-je már szerepel a Frihet-ügyféllistában, az importált számla hozzárendelődik
2. Új ügyfél: Ha nem ismert email-cím, a Frihet automatikusan létrehozza az ügyfelet a Stripe-adatokból (név, email, esetleges cím)
3. Kézi párosítás: Ha az automatikus párosítás nem egyértelmű (pl. más email-cím az ügyfélprofilban), a Frihet jelöli az egyeztetésre váró számlát

Visszatérítések kezelése

A Stripe refund.created esemény automatikusan jóváíró számlát generál:

• Az eredeti számla hivatkozása a jóváíróban
• A visszatérítés összege (teljes vagy részleges)
• Dátum: a Stripe visszatérítés dátuma
• VeriFactu hash-láncba illesztés

A jóváíró számla NEM törli az eredeti számlát – a VeriFactu rendszer nem enged törlést. Az összes számlára vonatkozó könyvelési egyenleg az eredeti + jóváíró összege.

Kétirányú integráció: Stripe Connect

A Revenue Sync (bejövő importálás) mellett a Stripe Connect (kimenő fizetés) is elérhető:

Stripe Connect: A Frihet-számlák tartalmazzák a “Fizetés most” gombot, amely a Stripe-fizetési oldalra irányít. Az ügyfél kártyával fizet, a Stripe értesíti a Frihetet, a számla automatikusan “Kifizetve” státuszba kerül.

Ez a két funkció kombinálva jelenti a teljes körű Stripe-integrációt:

• Minden Frihet-számla kifizetésére Stripe-ot használhatod (Connect)
• Minden Stripe-on keresztül érkező bevételből Frihet-számla lesz (Revenue Sync)

Mikor nem megfelelő a Revenue Sync?

A Revenue Sync nem minden esetben ideális:

• B2B, ahol az ügyfél manuális számlaadatokat igényel: Ha az ügyfeled speciális purchase order számot, projekt-hivatkozást vagy egyedi feltételeket kér, az automatikus importálás nem tartalmazza ezeket
• Komplex adókezelés: Ha az importált számla adókulcsa nem egyezik az alapértelmezett beállítással (pl. különböző ÁFA-kulcsok terméktípusonként), manuális felülvizsgálat szükséges
• Többfelhasználós szeparálás: Ha több felhasználónak kell elkülönített Stripe-számlát rendelni különböző Frihet-sorozatokhoz, a konfiguráció összetettebb

Ezek a kivételek jelzik, mikor érdemes a könyvelőddel vagy gestoroddal konzultálni a Revenue Sync konfigurációjáról.