Hop til hovedindhold

Stripe Revenue Sync

Tilgængelig

Denne integration er aktiv og klar til brug på alle Pro-planer.

Importer automatisk dine Stripe-indbetalinger som fakturaer registreret i Frihet. Ideel til SaaS-virksomheder, der opkræver betaling via Stripe og har brug for at holde deres fakturering i orden.

Hvad bruges det til?​

Hvis du opkræver betaling med Stripe og ønsker, at disse indbetalinger vises som fakturaer i Frihet uden at oprette dem manuelt:

  • Automatisk import — Hver betalt faktura i Stripe bliver til en faktura i Frihet
  • Inkrementel synkronisering — Importerer kun nye indbetalinger siden sidste synkronisering
  • Deduplikering — En faktura duplikeres aldrig, selvom du kører importen flere gange
  • VeriFactu-kompatibel — De importerede fakturaer gennemgår hash-kæden og gap-fri nummerering

Forskel fra Stripe-integrationen​

Stripe (OAuth)Stripe Revenue Sync
ForbindelseOAuth (videreledning til Stripe)Begrænset API-nøgle
RetningTovejsKun Stripe → Frihet
TypeBetalinger + abonnementer + ConnectKun betalte fakturaer
FakturaerAutomatisk via webhookImport on-demand + auto-synkronisering
AnvendelsesscenarieOpkræv betaling fra FrihetRegistrer Stripe-indbetalinger i Frihet

Brug Revenue Sync hvis: du opkræver betaling direkte fra Stripe (Dashboard, Billing, osv.) og ønsker, at disse indbetalinger vises i Frihet til din regnskabsføring og dine erklæringer.

Krav​

  • Aktiv Stripe-konto — Opret en på stripe.com
  • Begrænset API-nøgle — Med læseadgang til invoices og customers
  • Frihet Pro eller højere — Ikke tilgængelig på Free-planen

Konfigurer Stripe Revenue Sync​

Trin 1: Opret en begrænset API-nøgle i Stripe​

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

Trin 2: Forbind i Frihet​

  1. Gå til Indstillinger → Integrationer
  2. Find Stripe Revenue Sync
  3. Klik på Forbind
  4. Indsæt din begrænsede API-nøgle
  5. Vælg datoen, du vil importere fra
  6. Klik på Gem og forbind

Trin 3: Importer fakturaer​

  1. Klik på Importer nu
  2. Frihet vil forespørge de betalte fakturaer i Stripe fra den valgte dato
  3. Hver faktura oprettes som en kladde og markeres som betalt
  4. Den gap-fri nummerering og VeriFactu-hashen anvendes automatisk

Trin 4: Aktiver auto-synkronisering (valgfrit)​

  1. På konfigurationstabben skal du aktivere Auto-sync
  2. Frihet vil importere nye indbetalinger automatisk hver 6. time
  3. Kun nye fakturaer importeres (inkrementel synkronisering)
  4. Hvis den registrerer, at din API-nøgle er udløbet, markerer den integrationen som requiresReconnect

Hvordan det fungerer​

Manuel import​

  1. Du klikker på Importer nu
  2. Frihet forespørger GET /v1/invoices?status=paid i Stripe
  3. For hver faktura, der endnu ikke findes i Frihet (via stripeInvoiceId):
    • Opretter en kladde-faktura med kundedata
    • Marker den som betalt
    • Firestore-triggere udføres: nummerering og VeriFactu-hash
  4. Resultat: fakturaer klar til din regnskabsbog og erklæringer

Auto-synkronisering (hver 6. time)​

  1. Hver 6. time udføres en planlagt funktion
  2. Forespørger kun fakturaer siden lastSync (inkrementel)
  3. Importerer de nye automatisk
  4. Opdaterer lastSync med den aktuelle dato
  5. Hvis den registrerer, at din API-nøgle er udløbet, markerer den integrationen som requiresReconnect

Deduplikering​

Hver importeret faktura gemmer Stripe faktura-ID'et (stripeInvoiceId) i dens metadata. Hvis du forsøger at importere den samme faktura to gange, ignorerer Frihet den automatisk.

Datamapping​

StripeFrihet
invoice.customer_name o customer_emailKundens navn
invoice.numberReference (i koncept)
line_items[].descriptionFakturalinjer
line_items[].amountBeløb per linje
invoice.taxSkatter (hvis relevant)
invoice.createdFakturadato
invoice.idstripeInvoiceId (metadata)

Sikkerhed​

  • Begrænset API-nøgle — Kun læseadgang til invoices og customers. Ingen adgang til penge.
  • AES-256-GCM-kryptering — Din API-nøgle gemmes krypteret på serveren
  • Øjeblikkelig frakobling — Tilbagekald adgang under Indstillinger når som helst
  • Ingen data under transit — Kommunikationen med Stripe er HTTPS, nøglen eksponeres aldrig til frontend

Frakobl​

  1. Gå til Indstillinger → Integrationer
  2. Find Stripe Revenue Sync
  3. Klik på Frakobl
  4. Bekræft handlingen

De allerede importerede fakturaer forbliver i Frihet. De slettes ikke ved frakobling.

Fejlfinding​

"Ingen fakturaer blev importeret"​

  • Kontrollér, at din API-nøgle har læseadgang til Invoices og Customers
  • Sørg for, at importdatoen er tidligere end dine indbetalinger
  • Kun fakturaer med status paid i Stripe importeres
  • Kontrollér, at du ikke er i Stripe testtilstand (brug live-nøgler)

"Genforbind din konto"​

  • Din API-nøgle er udløbet eller er blevet tilbagekaldt
  • Gå til Stripe Dashboard → API Keys og opret en ny
  • Frakobl og genforbind i Frihet med den nye nøgle

"Duplikeret faktura"​

  • Det burde ikke ske. Deduplikering via stripeInvoiceId forhindrer det
  • Hvis du ser dubletter, kontakt support

"Beløbene stemmer ikke overens"​

  • Frihet importerer beløbet, som Stripe rapporterer det
  • Stripe-gebyrer fratrækkes ikke fakturaen (de er en separat udgift)
  • Kontrollér valutaen: Stripe rapporterer i cents, Frihet konverterer automatisk

Næste trin​

Næste: Stripe Connect - Betalingslinks på dine fakturaer