Stripe Revenue Sync

Tillgänglig

Denna integration är aktiv och redo att användas i alla Pro-planer.

Importera automatiskt dina Stripe-betalningar som fakturor registrerade i Frihet. Idealisk för SaaS-företag som tar betalt med Stripe och behöver ha sin fakturering i ordning.

Vad används det till?

Om du tar betalt med Stripe och vill att dessa betalningar ska visas som fakturor i Frihet utan att skapa dem manuellt:

• Automatisk import — Varje betald faktura i Stripe omvandlas till en faktura i Frihet
• Inkrementell synkronisering — Importerar endast nya betalningar sedan den senaste synkroniseringen
• Deduplicering — En faktura dupliceras aldrig även om du kör importen flera gånger
• VeriFactu-kompatibel — De importerade fakturorna genomgår hashkedjan och gap-free numrering

Skillnad mot Stripe-integrationen

	Stripe (OAuth)	Stripe Revenue Sync
Anslutning	OAuth (omdirigera till Stripe)	Begränsad API-nyckel
Riktning	Dubbelriktad	Endast Stripe → Frihet
Typ	Betalningar + prenumerationer + Connect	Endast betalda fakturor
Fakturor	Automatisk via webhook	Import på begäran + auto-synk
Användningsfall	Ta betalt från Frihet	Registrera Stripe-betalningar i Frihet

Använd Revenue Sync om: du tar betalt direkt från Stripe (Dashboard, Billing, etc.) och vill att dessa betalningar ska visas i Frihet för din bokföring och deklarationer.

Krav

• Aktivt Stripe-konto — Skapa ett på stripe.com
• Begränsad API-nyckel — Med läsbehörighet för invoices och customers
• Frihet Pro eller högre — Inte tillgänglig i Free-planen

Konfigurera Stripe Revenue Sync

Steg 1: Skapa en begränsad API-nyckel i Stripe

1. Gå till Stripe Dashboard → Developers → API Keys
2. Klicka på Create restricted key
3. Namn: Frihet Revenue Sync
4. Nödvändiga behörigheter:
   • Invoices → Read
   • Customers → Read
5. Kopiera nyckeln (rk_live_...)

Steg 2: Anslut i Frihet

1. Gå till Inställningar → Integrationer
2. Sök efter Stripe Revenue Sync
3. Klicka på Anslut
4. Klistra in din begränsade API-nyckel
5. Välj datum från vilket du vill importera
6. Klicka på Spara och anslut

Steg 3: Importera fakturor

1. Klicka på Importera nu
2. Frihet kommer att hämta de betalda fakturorna i Stripe från det valda datumet
3. Varje faktura skapas som utkast och markeras som betald
4. Gap-free numrering och VeriFactu hash tillämpas automatiskt

Steg 4: Aktivera auto-synk (valfritt)

1. På konfigurationsfliken, aktivera Auto-synk
2. Frihet kommer automatiskt att importera nya betalningar var 6:e timme
3. Endast nya fakturor importeras (inkrementell synkronisering)

Hur det fungerar

Manuell import

1. Du klickar på Importera nu
2. Frihet hämtar GET /v1/invoices?status=paid från Stripe
3. För varje faktura som inte redan finns i Frihet (via stripeInvoiceId):
   • Skapar en utkastfaktura med kunddata
   • Markerar den som betald
   • Firestores triggers exekveras: numrering och VeriFactu hash
4. Resultat: fakturor redo för din registerbok och deklarationer

Auto-synk (var 6:e timme)

1. Var 6:e timme körs en schemalagd funktion
2. Hämtar endast fakturor från lastSync (inkrementell)
3. Importerar de nya automatiskt
4. Uppdaterar lastSync med aktuellt datum
5. Om den upptäcker att din API-nyckel har gått ut, markeras integrationen som requiresReconnect

Deduplicering

Varje importerad faktura sparar Stripes faktura-ID (stripeInvoiceId) i sina metadata. Om du försöker importera samma faktura två gånger, ignorerar Frihet den automatiskt.

Data-mappning

Stripe	Frihet
invoice.customer_name eller customer_email	Kundens namn
invoice.number	Referens (i beskrivningen)
line_items[].description	Fakturarader
line_items[].amount	Belopp per rad
invoice.tax	Skatter (om tillämpligt)
invoice.created	Fakturadatum
invoice.id	stripeInvoiceId (metadata)

Säkerhet

• Begränsad API-nyckel — Endast läsbehörighet för invoices och customers. Ingen åtkomst till pengar.
• AES-256-GCM-kryptering — Din API-nyckel lagras krypterad på servern
• Omedelbar frånkoppling — Återkalla åtkomst i Inställningar när du vill
• Inga data i transit — Kommunikationen med Stripe sker via HTTPS, nyckeln exponeras aldrig för frontend

Koppla från

1. Gå till Inställningar → Integrationer
2. Sök efter Stripe Revenue Sync
3. Klicka på Koppla från
4. Bekräfta åtgärden

De redan importerade fakturorna finns kvar i Frihet. De raderas inte vid frånkoppling.

Felsökning

"Inga fakturor importerades"

• Kontrollera att din API-nyckel har läsbehörighet för Invoices och Customers
• Se till att importdatumet är före dina betalningar
• Endast fakturor med status paid i Stripe importeras
• Kontrollera att du inte är i Stripes testläge (använd live-nycklar)

"Återanslut ditt konto"

• Din API-nyckel har gått ut eller har återkallats
• Gå till Stripe Dashboard → API Keys och skapa en ny
• Koppla från och återanslut i Frihet med den nya nyckeln

"Duplicerad faktura"

• Det borde inte hända. Dedupliceringen med stripeInvoiceId förhindrar det
• Om du ser dubbletter, kontakta support

"Beloppen matchar inte"

• Frihet importerar beloppet precis som Stripe rapporterar det
• Stripes avgifter dras inte av från fakturan (de är en separat utgift)
• Kontrollera valutan: Stripe rapporterar i cent, Frihet konverterar automatiskt

Nästa steg

• Använd Stripe för att ta betalt direkt
• Konfigurera betalningslänkar med Stripe Connect
• Anslut även WooCommerce om du har en butik

---

Nästa: Stripe Connect - Betalningslänkar på dina fakturor