Czym różni się od standardowej integracji ze Stripe?

Standardowa integracja używa OAuth i jest dwukierunkowa: pobierasz płatności z Frihet. Revenue Sync jest jednokierunkowy: importuje już zapłacone faktury ze Stripe za pomocą ograniczonego klucza API tylko do odczytu. Nie ma dostępu do Twoich pieniędzy.

Czy faktury są duplikowane, jeśli importuję je wielokrotnie?

Nie. Każda importowana faktura zapisuje identyfikator Stripe jako metadane. Jeśli już istnieje w Frihet, jest automatycznie ignorowana.

Czy importowane faktury są zgodne z VeriFactu?

Tak. Przechodzą przez łańcuch hash SHA-256 i numerację bez luk Frihet, dokładnie tak samo, jak faktury tworzone ręcznie. Gotowe na Twój Model 303 i księgę rejestrową.

Czy mogę wybrać, które faktury importować?

Możesz ustawić datę początkową. Wszystkie faktury zapłacone od tej daty zostaną zaimportowane. Deduplikacja gwarantuje, że faktura nigdy się nie powtórzy.

Importuj swoje płatności Stripe jako faktury w 3 kliknięciach

Pobierasz płatności za pomocą Stripe. Twoi klienci płacą. Ale te transakcje nie są fakturami, dopóki ktoś ich nie przekształci. Tym „kimś” już nie musisz być Ty.

Dziś uruchamiamy Stripe Revenue Sync: integrację, która automatycznie importuje Twoje płatności Stripe jako zarejestrowane faktury w Frihet. Z deduplikacją, łańcuchem hash VeriFactu i autosynchronizacją co 6 godzin.

Problem: pobieranie płatności z jednej strony, fakturowanie z drugiej

Jeśli jesteś założycielem SaaS, freelancerem pobierającym płatności przez Stripe lub sprzedajesz produkty cyfrowe, prawdopodobnie znajdujesz się w takiej sytuacji:

Stripe pobiera płatności. Twoi klienci płacą kartą, odnawiają się subskrypcje, docierają terminowe płatności.
Twoja księgowość o tym nie wie. Te płatności istnieją w Stripe, ale nie w Twoim oprogramowaniu do fakturowania.
Pełnisz rolę pośrednika. Co miesiąc tworzysz faktury ręcznie, kopiując dane ze Stripe. Lub co gorsza: nie robisz tego, a Twój księgowy wpada w szał w następnym kwartale.

Stripe wystawia potwierdzenia, ale nie faktury ważne podatkowo w Hiszpanii. Nie zawiera Twojego NIF-u, nie stosuje numeracji wymaganej przez Hacienda, nie generuje łańcucha hash wymaganego przez VeriFactu. Aby spełnić hiszpańskie przepisy podatkowe, musisz tworzyć prawdziwe faktury w oprogramowaniu do fakturowania.

Do tej pory oznaczało to podwójną pracę. Już nie.

Czym jest Stripe Revenue Sync

Revenue Sync łączy Twoje konto Stripe z Frihet za pomocą ograniczonego klucza API tylko do odczytu. Bez OAuth, bez przekierowań, bez nadawania uprawnień do zapisu dla Twoich pieniędzy.

Co robi:

Sprawdza Twoje opłacone faktury w Stripe — tylko te, które mają status paid
Tworzy fakturę w Frihet dla każdej płatności — z klientem, szczegółowymi pozycjami i kwotami
Oznacza fakturę jako opłaconą — proces VeriFactu aktywuje się automatycznie
Deduplikuje według ID Stripe — jeśli faktura już istnieje, jest ignorowana

Rezultat: Twoje płatności Stripe pojawiają się w Frihet jako zarejestrowane faktury, z sekwencyjną numeracją, hashem SHA-256 i gotowe na Twój Model 303.

Jak to działa w praktyce

Trzy kroki. Bez kodu, bez skomplikowanych konfiguracji.

Krok 1: Utwórz ograniczony klucz API w Stripe

Przejdź do swojego Stripe Dashboard > Developers > API Keys. Utwórz ograniczony klucz z dwoma uprawnieniami:

Invoices → Read
Customers → Read

Tylko tyle. Nie potrzebujesz uprawnień do zapisu ani dostępu do płatności, przelewów czy sald. Klucz zaczyna się od rk_live_ i jest tylko do odczytu.

Krok 2: Połącz w Frihet

Przejdź do Ustawienia > Integracje > Stripe Revenue Sync. Wklej swój klucz API i wybierz datę, od której chcesz importować. Możesz zaimportować dane z ostatnich 90 dni lub wybrać konkretną datę.

Krok 3: Importuj

Kliknij „Importuj teraz”. Frihet wysyła zapytanie do Stripe, pobiera opłacone faktury i tworzy je na Twoim koncie. Każda faktura przechodzi przez triggery Firestore: numeracja bez luk i łańcuch hash VeriFactu.

Zgodność z VeriFactu od pierwszego importu

Importowane faktury ze Stripe nie są „gorszej jakości”. Przechodzą dokładnie przez ten sam proces co faktury tworzone ręcznie w Frihet:

Numeracja bez luk — Atomowy licznik na serwerze. Bez luk, bez przeskoków.
Hash SHA-256 — Łańcuch hash z 8 polami, wymagany przez AEAT. Każda faktura odwołuje się do hasha poprzedniej.
Niezmienność — Po zarejestrowaniu krytyczne pola zostają zablokowane. Modyfikacje generują korekty.
Księga rejestrowa — Importowane faktury pojawiają się w eksporcie CSV z 19 kolumnami wymaganymi przez Hacienda.

Oznacza to, że Twoje płatności Stripe są gotowe na Model 303, Model 130 i każdą inspekcję. Bez dodatkowych kroków.

Dla kogo jest Revenue Sync

Założyciel SaaS, który pobiera płatności za pomocą Stripe Billing

Pobierasz subskrypcje bezpośrednio w Stripe. Co miesiąc odnawia się dziesiątki lub setki klientów. Dzięki Revenue Sync każde odnowienie automatycznie pojawia się jako faktura w Frihet. Twój MRR, kwartalny VAT i księga rejestrowa zawsze aktualne.

Freelancer, który pobiera płatności za projekty przez Stripe

Twoi klienci płacą Ci przez Stripe, a Ty chcesz mieć wszystkie faktury w jednym miejscu dla swoich rozliczeń kwartalnych. Bez ręcznego tworzenia każdej faktury, bez krzyżowania danych między Stripe a arkuszem kalkulacyjnym.

E-commerce z bezpośrednią integracją Stripe

Sprzedajesz produkty cyfrowe lub fizyczne i pobierasz płatności za pomocą Stripe (nie przez Shopify lub WooCommerce). Każda sprzedaż staje się zarejestrowaną fakturą. Szczególnie przydatne, jeśli sprzedajesz klientom z UE i potrzebujesz kontroli nad VAT-em.

Agencja z fakturowaniem mieszanym

Niektórzy klienci płacą Ci przez Stripe, a inni przelewem. Revenue Sync importuje te ze Stripe, podczas gdy resztę fakturujesz ręcznie lub za pomocą bezpośredniego fakturowania w Frihet. Wszystko współistnieje w tej samej księdze rejestrowej.

Czym NIE jest Revenue Sync

Warto to wyjaśnić, aby uniknąć nieporozumień:

To nie jest integracja OAuth ze Stripe. Ta już istnieje w Frihet i umożliwia pobieranie płatności z samej aplikacji za pomocą linków do płatności. Revenue Sync jest jednokierunkowy: tylko importuje.
Nie wystawia płatności. Nie przetwarza płatności ani nie tworzy obciążeń w Stripe. Odczytuje tylko już opłacone faktury.
Nie zastępuje Stripe Billing. Uzupełnia go. Stripe pobiera płatności, Frihet rejestruje.
Nie filtruje według klienta. Importuje wszystkie faktury opłacone od wybranej daty. Deduplikacja dba o to, aby nie było duplikatów.

Bezpieczeństwo

Ograniczony klucz API ma uprawnienia tylko do odczytu dla dwóch zasobów: invoices i customers. Nie może przenosić pieniędzy, tworzyć płatności ani modyfikować Twojego konta Stripe.

Klucz jest przechowywany zaszyfrowany za pomocą AES-256-GCM na serwerze Frihet. Nigdy nie jest udostępniany frontendowi. Jeśli Stripe wykryje, że klucz wygasł lub został cofnięty, Frihet oznacza integrację jako „wymaga ponownego połączenia” i powiadamia Cię.

Możesz odłączyć w dowolnym momencie z Ustawienia > Integracje. Już zaimportowane faktury pozostają w Frihet.

Zacznij teraz

Jeśli pobierasz płatności za pomocą Stripe, Twoje faktury już tam są. Muszą tylko trafić do Twojej księgowości. Stripe Revenue Sync robi to w 3 kliknięciach, bez OAuth, bez niebezpiecznych uprawnień i z VeriFactu od pierwszego dnia.

Połącz swoje konto Stripe i pozwól, aby Twoje płatności automatycznie stały się zarejestrowanymi fakturami.