Stripe-tuottosynkronointi

Saatavilla

Tämä integraatio on aktiivinen ja käyttövalmis kaikilla Pro-sopimuksilla.

Tuo automaattisesti Stripe-maksusi Frihetiin rekisteröityinä laskuina. Ihanteellinen SaaS-yrityksille, jotka veloittavat Stripen kautta ja joiden on pidettävä laskutuksensa järjestyksessä.

Mihin sitä käytetään?

Jos veloitat Stripen kautta ja haluat, että nuo maksut näkyvät laskuina Frihetissä luomatta niitä käsin:

• Automaattinen tuonti — Jokainen Stripen kautta maksettu lasku muuttuu laskuksi Frihetissä
• Inkrementaalinen synkronointi — Tuo vain uudet maksut viimeisimmästä synkronoinnista
• Duplikoinnin esto — Laskua ei koskaan duplikoida, vaikka suorittaisit tuonnin useita kertoja
• VeriFactu-yhteensopiva — Tuodut laskut käyvät läpi hash-ketjun ja aukottoman numerointijärjestelmän

Ero Stripe-integraatioon

	Stripe (OAuth)	Stripe-tuottosynkronointi
Yhteys	OAuth (ohjaa Stripeen)	Rajoitettu API-avain
Suunta	Kaksisuuntainen	Vain Stripe → Frihet
Tyyppi	Maksut + tilaukset + Connect	Vain maksetut laskut
Laskut	Automaattinen webhookin kautta	Tarvittaessa tapahtuva tuonti + automaattinen synkronointi
Käyttötapaus	Veloitus Frihetistä	Stripe-maksujen rekisteröinti Frihetiin

Käytä tuottosynkronointia jos: veloitat suoraan Stripestä (Dashboard, Billing jne.) ja haluat, että nuo maksut näkyvät Frihetissä kirjanpitoasi ja ilmoituksiasi varten.

Vaatimukset

• Aktiivinen Stripe-tili — Luo tili osoitteessa stripe.com
• Rajoitettu API-avain — Vain luku -oikeuksilla laskuihin (invoices) ja asiakkaisiin (customers)
• Frihet Pro tai korkeampi — Ei saatavilla Free-sopimuksessa

Stripe-tuottosynkronoinnin asetusten määrittäminen

Vaihe 1: Luo rajoitettu API-avain Stripessä

1. Mene Stripe Dashboard → Developers → API Keys
2. Napsauta Create restricted key
3. Nimi: Frihet Revenue Sync
4. Vaaditut oikeudet:
   • Invoices → Read
   • Customers → Read
5. Kopioi avain (rk_live_...)

Vaihe 2: Yhdistä Frihetissä

1. Mene Asetukset → Integraatiot
2. Etsi Stripe Revenue Sync
3. Napsauta Yhdistä
4. Liitä rajoitettu API-avaimesi
5. Valitse päivämäärä, josta alkaen haluat tuoda tiedot
6. Napsauta Tallenna ja yhdistä

Vaihe 3: Tuo laskut

1. Napsauta Tuo nyt
2. Frihet hakee Stripen maksetut laskut valitusta päivämäärästä alkaen
3. Jokainen lasku luodaan luonnoksena ja merkitään maksetuksi
4. Aukoton numerointi ja VeriFactu-hash-arvo sovelletaan automaattisesti

Vaihe 4: Aktivoi automaattinen synkronointi (valinnainen)

1. Aktivoi asetukset-välilehdellä Automaattinen synkronointi
2. Frihet tuo uudet maksut automaattisesti 6 tunnin välein
3. Vain uudet laskut tuodaan (inkrementaalinen synkronointi)

Miten se toimii

Manuaalinen tuonti

1. Napsautat Tuo nyt
2. Frihet kysyy GET /v1/invoices?status=paid Stripen API:sta
3. Jokaiselle laskulle, jota ei vielä ole Frihetissä (stripeInvoiceId-tunnuksen perusteella):
   • Luo luonnoslasku asiakkaan tiedoilla
   • Merkitsee sen maksetuksi
   • Firestore-triggerit suoritetaan: numerointi ja VeriFactu-hash-arvo
4. Tulos: laskut valmiina rekisterikirjaasi ja ilmoituksiasi varten

Automaattinen synkronointi (6 tunnin välein)

1. Joka 6. tunti suoritetaan ajoitettu funktio
2. Kysyy vain laskuja lastSync-arvosta alkaen (inkrementaalinen)
3. Tuo uudet automaattisesti
4. Päivittää lastSync-arvon nykyiseen päivämäärään
5. Jos havaitsee, että API-avaimesi on vanhentunut, merkitsee integraation tilaan requiresReconnect

Duplikoinnin esto

Jokainen tuotu lasku tallentaa Stripen laskun ID:n (stripeInvoiceId) metatietoihinsa. Jos yrität tuoda saman laskun kahdesti, Frihet ohittaa sen automaattisesti.

Tietojen yhdistäminen

Stripe	Frihet
invoice.customer_name tai customer_email	Asiakkaan nimi
invoice.number	Viite (viitteenä)
line_items[].description	Laskun rivit
line_items[].amount	Summa riviä kohti
invoice.tax	Verot (jos sovellettavissa)
invoice.created	Laskun päivämäärä
invoice.id	stripeInvoiceId (metatieto)

Turvallisuus

• Rajoitettu API-avain — Vain lukuoikeus laskuihin (invoices) ja asiakkaisiin (customers). Ei pääsyä rahaan.
• AES-256-GCM-salaus — API-avaimesi tallennetaan salattuna palvelimelle
• Välitön yhteys irrotus — Peruuta käyttöoikeus Asetuksista milloin tahansa
• Ei tietoja siirrossa — Yhteys Stripen kanssa on HTTPS-suojattu, avainta ei koskaan paljasteta käyttöliittymään

Katkaise yhteys

1. Mene Asetukset → Integraatiot
2. Etsi Stripe Revenue Sync
3. Napsauta Katkaise yhteys
4. Vahvista toiminto

Jo tuodut laskut säilyvät Frihetissä. Niitä ei poisteta yhteyden katkaisun yhteydessä.

Vianmääritys

"Laskuja ei tuotu"

• Varmista, että API-avaimellasi on lukuoikeudet Invoices- ja Customers-osiin
• Varmista, että tuontipäivämäärä on ennen maksujasi
• Vain Stripen tilassa paid olevat laskut tuodaan
• Tarkista, ettet ole Stripen testitilassa (käytä live-avaimia)

"Yhdistä tilisi uudelleen"

• API-avaimesi on vanhentunut tai kumottu
• Mene Stripe Dashboard → API Keys ja luo uusi
• Katkaise ja yhdistä yhteys Frihetissä uudella avaimella

"Lasku duplikoitu"

• Näin ei pitäisi tapahtua. Duplikoinnin esto stripeInvoiceId-tunnuksen perusteella estää sen.
• Jos näet duplikaatteja, ota yhteyttä tukeen

"Summat eivät täsmää"

• Frihet tuo summan sellaisena kuin Stripe sen ilmoittaa
• Stripen palkkiot eivät vähenny laskusta (ne ovat erillinen kulu)
• Tarkista valuutta: Stripe ilmoittaa sentteinä, Frihet muuntaa automaattisesti

Seuraavat vaiheet

• Käytä Stripeä suoraan veloittamiseen
• Määritä maksulinkit Stripe Connectin avulla
• Yhdistä myös WooCommerce, jos sinulla on verkkokauppa

---

Seuraava: Stripe Connect - Maksulinkit laskuissasi