Rechnungen für deine Bolt-App

Bolt baut den Checkout, aber nicht die Rechnung

Mit Bolt baust du in Minuten eine App und schaltest Stripe per Ein-Klick frei, inklusive Webhook-Verarbeitung für Zahlungen und Abos. Was danach fehlt: Bolt erzeugt eine Zahlung, aber keine Rechnung im deutschen Rechtssinn. Kein strukturierter Beleg nach EN 16931, kein GoBD-Archiv, keine Umsatzsteuerlogik nach Land, kein DATEV-Export.

Diese Lücke schließt Rechnungskit genau dort, wo Bolt die Zahlung ohnehin verarbeitet: in der Supabase Edge Function hinter deinem Stripe-Webhook. Ein API-Aufruf, und aus dem Verkauf wird eine ZUGFeRD-Rechnung mit deinem Nummernkreis, revisionssicher archiviert und fertig für die DATEV-Buchung.

Warum Bolt besonders gut passt

Bolt generiert eine echte Full-Stack-App: React-Frontend plus serverseitige Funktionen auf Basis von Supabase Edge Functions, dazu die native Stripe-Anbindung mit Webhooks. Das ist genau die Umgebung, die die Anbindung braucht: eine serverseitige Funktion, in der dein API-Schlüssel sicher liegt und in der du beim erfolgreichen Checkout einen Aufruf an Rechnungskit ergänzt. Du baust also keine neue Infrastruktur, sondern nutzt die, die Bolt schon angelegt hat.

Der Aufruf, den du ergänzt

In der Edge Function, die deinen Stripe-Webhook verarbeitet, kommt im Erfolgszweig ein fetch auf POST /v1/orders dazu. Beträge in ganzzahligen Cent, die Stripe-Zahlungsreferenz als paymentRef, der Schlüssel aus den Secrets:

// Supabase Edge Function (Bolt), im Stripe-Webhook nach erfolgreicher Zahlung
const res = await fetch('https://api.rechnungskit.de/v1/orders', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${Deno.env.get('RECHNUNGSKIT_API_KEY')}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': session.id
  },
  body: JSON.stringify({
    orderNo: session.id,
    paymentRef: session.payment_intent, // pi_... aus Stripe
    email: session.customer_details?.email,
    billingAddress: {
      name: session.customer_details?.name,
      country_code: session.customer_details?.address?.country, // Pflicht für die USt
      postal_code: session.customer_details?.address?.postal_code,
      city: session.customer_details?.address?.city,
      street: session.customer_details?.address?.line1
    },
    items: [{ name: 'Pro-Plan', quantity: 1, unitGrossCents: 2900, taxRate: 19 }]
  })
})

Ein wichtiger Hinweis zu Bolt: Verifiziere in deiner eigenen Funktion die Stripe-Signatur des Webhooks, bevor du daraus eine Bestellung ableitest. Bolt lässt diesen Schritt in den generierten Webhooks gern aus. Auf der Rechnungskit-Seite ist das abgesichert, denn Rechnungskit prüft die Signatur der Stripe-Zahlung beim eigenen Eingang selbst.

Woher kommt der API-Schlüssel?

Den Schlüssel erstellst du in Rechnungskit unter Einstellungen, API (direkt unter app.rechnungskit.de/settings/api), mit der Berechtigung orders:write. Er wird genau einmal angezeigt. Den Wert legst du in Bolt bzw. Supabase als Secret ab (zum Beispiel RECHNUNGSKIT_API_KEY), nie im Frontend, und liest ihn in der Edge Function mit Deno.env.get('RECHNUNGSKIT_API_KEY').

Einmalige Einrichtung, ehrlich benannt

Der Code ist einfach, aber ein paar Dinge richtest du einmal ein:

• Stripe im Dashboard verbinden und auf API stellen. Deinen Stripe-Account verbindest du einmalig in Rechnungskit unter Einstellungen, Verbinden, Verkaufsgrundlage API-Bestellungen. Ein Klick-Schritt, kein Code.
• Länderkürzel mitschicken. Ohne country_code in der Rechnungsadresse wird die Bestellung abgelehnt, die Umsatzsteuer lässt sich sonst nicht bestimmen.
• Idempotency-Key setzen. Jeder POST braucht den Header, sonst erzeugt ein doppelter Webhook zwei Bestellungen. Die Stripe-Session-ID ist ein guter Wert.
• Stripe-Signatur in Bolt prüfen. Verifiziere den Webhook in deiner eigenen Funktion, bevor du die Bestellung ableitest.
• Bei 5xx erneut senden. Wiederhol den Aufruf mit etwas Abstand, dann geht keine Bestellung verloren.

Zeig deiner KI die Doku

Rechnungskit veröffentlicht eine vollständige OpenAPI-3.1-Spezifikation unter api.rechnungskit.de/v1/openapi.json. Gib sie Bolts KI mit der Bitte, im Stripe-Webhook nach erfolgreicher Zahlung eine Bestellung an Rechnungskit zu melden. Die komplette Referenz mit lauffähigen Beispielen steht in der API-Dokumentation. Baust du deine App lieber mit Lovable, Replit oder v0? Das funktioniert genauso, siehe Rechnungen für no-code und KI-App-Builder.