Stripe Revenue Sync

Tilgjengelig

Denne integrasjonen er aktiv og klar til bruk på alle Pro-planer.

Importer automatisk dine Stripe-innbetalinger som fakturaer registrert i Frihet. Ideelt for SaaS-virksomheter som tar betalt med Stripe og trenger å holde faktureringen sin i orden.

Hva er det til?

Hvis du tar betalt med Stripe og vil at disse innbetalingene skal vises som fakturaer i Frihet uten å opprette dem manuelt:

• Automatisk import — Hver betalte faktura i Stripe blir en faktura i Frihet
• Inkrementell synkronisering — Importerer kun nye innbetalinger siden forrige synkronisering
• Deduplisering — En faktura dupliseres aldri selv om du kjører importen flere ganger
• VeriFactu-kompatibel — De importerte fakturaene går gjennom hash-kjeden og gap-free nummerering

Forskjell fra Stripe-integrasjonen

	Stripe (OAuth)	Stripe Revenue Sync
Tilkobling	OAuth (omdirigere til Stripe)	Begrenset API-nøkkel
Retning	Toveis	Kun Stripe → Frihet
Type	Betalinger + abonnementer + Connect	Kun betalte fakturaer
Fakturaer	Automatisk via webhook	Import ved behov + auto-synkronisering
Bruksområde	Ta betalt fra Frihet	Registrere Stripe-innbetalinger i Frihet

Bruk Revenue Sync hvis: du tar betalt direkte fra Stripe (Dashboard, Billing, osv.) og vil at disse innbetalingene skal vises i Frihet for regnskapet og erklæringene dine.

Krav

• Aktiv Stripe-konto — Opprett en på stripe.com
• Begrenset API-nøkkel — Med skrivebeskyttede tillatelser for Invoices og Customers
• Frihet Pro eller høyere — Ikke tilgjengelig på Free-planen

Konfigurere Stripe Revenue Sync

Trinn 1: Opprett en begrenset API-nøkkel i Stripe

1. Gå til Stripe Dashboard → Developers → API Keys
2. Klikk på Create restricted key
3. Navn: Frihet Revenue Sync
4. Nødvendige tillatelser:
   • Invoices → Read
   • Customers → Read
5. Kopier nøkkelen (rk_live_...)

Trinn 2: Koble til i Frihet

1. Gå til Innstillinger → Integrasjoner
2. Søk etter Stripe Revenue Sync
3. Klikk på Koble til
4. Lim inn din begrensede API-nøkkel
5. Velg datoen du vil importere fra
6. Klikk på Lagre og koble til

Trinn 3: Importer fakturaer

1. Klikk på Importer nå
2. Frihet vil spørre etter de betalte fakturaene i Stripe fra den valgte datoen
3. Hver faktura opprettes som et utkast og merkes som betalt
4. Gap-free nummerering og VeriFactu hash anvendes automatisk

Trinn 4: Aktiver auto-synkronisering (valgfritt)

1. På innstillingsfanen, aktiver Auto-sync
2. Frihet vil automatisk importere nye innbetalinger hver 6. time
3. Kun nye fakturaer importeres (inkrementell synkronisering)
4. Hvis den oppdager at API-nøkkelen din har utløpt, merker den integrasjonen som requiresReconnect

Hvordan det fungerer

Manuell import

1. Du trykker Importer nå
2. Frihet spør etter GET /v1/invoices?status=paid i Stripe
3. For hver faktura som ikke allerede eksisterer i Frihet (ved stripeInvoiceId):
   • Oppretter en utkastfaktura med kundedata
   • Merker den som betalt
   • Firestore-triggerne kjøres: nummerering og VeriFactu hash
4. Resultat: fakturaer klare for din regnskapsbok og erklæringer

Auto-synkronisering (hver 6. time)

1. Hver 6. time kjøres en planlagt funksjon
2. Spør kun etter fakturaer siden lastSync (inkrementell)
3. Importerer de nye automatisk
4. Oppdaterer lastSync med gjeldende dato
5. Hvis den oppdager at API-nøkkelen din har utløpt, merker den integrasjonen som requiresReconnect

Deduplisering

Hver importerte faktura lagrer Stripe-fakturaens ID (stripeInvoiceId) i metadataene sine. Hvis du prøver å importere den samme fakturaen to ganger, ignorerer Frihet den automatisk.

Datamapping

Stripe	Frihet
invoice.customer_name eller customer_email	Kundens navn
invoice.number	Referanse (i konsept)
line_items[].description	Fakturalinjer
line_items[].amount	Beløp per linje
invoice.tax	Skatter (hvis aktuelt)
invoice.created	Fakturadato
invoice.id	stripeInvoiceId (metadata)

Sikkerhet

• Begrenset API-nøkkel — Kun lesetilgang til Invoices og Customers. Ingen tilgang til penger.
• AES-256-GCM-kryptering — Din API-nøkkel lagres kryptert på serveren
• Øyeblikkelig frakobling — Trekk tilbake tilgang i Innstillinger når du vil
• Ingen data i transitt — Kommunikasjonen med Stripe er HTTPS, nøkkelen eksponeres aldri til frontend

Koble fra

1. Gå til Innstillinger → Integrasjoner
2. Søk etter Stripe Revenue Sync
3. Klikk på Koble fra
4. Bekreft handlingen

De allerede importerte fakturaene forblir i Frihet. De slettes ikke ved frakobling.

Feilsøking

"Ingen fakturaer ble importert"

• Verifiser at API-nøkkelen din har lesetillatelser for Invoices og Customers
• Sørg for at importdatoen er tidligere enn innbetalingene dine
• Kun fakturaer med status paid i Stripe importeres
• Sjekk at du ikke er i Stripe testmodus (bruk live-nøkler)

"Koble til kontoen din på nytt"

• API-nøkkelen din har utløpt eller er blitt tilbakekalt
• Gå til Stripe Dashboard → API Keys og opprett en ny
• Koble fra og koble til på nytt i Frihet med den nye nøkkelen

"Duplisert faktura"

• Dette skal ikke skje. Deduplisering via stripeInvoiceId forhindrer det
• Hvis du ser duplikater, kontakt support

"Beløpene stemmer ikke overens"

• Frihet importerer beløpet slik det rapporteres av Stripe
• Stripe-kommisjoner trekkes ikke fra fakturaen (de er en separat utgift)
• Verifiser valutaen: Stripe rapporterer i cent, Frihet konverterer automatisk

Neste trinn

• Bruk Stripe for å ta betalt direkte
• Konfigurer betalingslenker med Stripe Connect
• Koble også til WooCommerce hvis du har en butikk

---

Neste: Stripe Connect - Betalingslenker på dine fakturaer