From f4756998d9059b4aa258d1a6867006a36a6858fa Mon Sep 17 00:00:00 2001 From: torbinus Date: Mon, 26 Oct 2026 10:18:59 +0100 Subject: [PATCH] =?UTF-8?q?K=C3=BCndigungsbest=C3=A4tigung=20per=20Mail=20?= =?UTF-8?q?(=C2=A7=20312k=20BGB)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Nach einer Kündigung ging bisher keine Bestätigung raus, nur die Druckansicht auf /kuendigung. § 312k Abs. 4 verlangt sie in Textform, mit Inhalt der Kündigung, Eingang (Datum und Uhrzeit) und Vertragsende. Beide Wege verschicken sie jetzt: die Kündigungsschaltfläche ohne Anmeldung und die Kündigung im Kundenkonto. Scheitert der Versand, gilt die Kündigung trotzdem; der Fehler steht im Log zum Nachholen. Co-Authored-By: Claude Opus 5.5 (1M context) --- TODO.md | 10 ++- .../customers/me/subscriptions/[id]/route.ts | 10 +++ .../api/store/subscriptions/cancel/route.ts | 12 +++- .../apps/backend/src/lib/kuendigung-mail.ts | 47 ++++++++++++ backend/apps/backend/src/lib/order-emails.ts | 72 +++++++++++++++++++ frontend/src/pages/kuendigung.astro | 3 +- 6 files changed, 144 insertions(+), 10 deletions(-) create mode 100644 backend/apps/backend/src/lib/kuendigung-mail.ts diff --git a/TODO.md b/TODO.md index 4750721..8b56476 100644 --- a/TODO.md +++ b/TODO.md @@ -61,12 +61,10 @@ PayPal und PayPal-Card. ## 2. Rechtlich offen -- [ ] **§ 312k Abs. 2 BGB — Bestätigung in Textform.** Pflicht, aktuell nicht - erfüllt. In `medusa-config.ts` ist **kein** Notification-Modul registriert, - es geht also keine Kündigungsbestätigung raus. Die Druckansicht auf - `/kuendigung` ist ein Behelf, kein Ersatz. - Lösung: `@medusajs/notification` + SendGrid-Provider einhängen → braucht - einen SendGrid-API-Key. Betrifft auch Bestell- und Versandbestätigungen. +- [x] ~~**§ 312k BGB — Bestätigung in Textform.**~~ Seit 26.10.2026: Beide + Kündigungswege (`/kuendigung` und Kundenkonto) schicken eine + Kündigungsbestätigung per Mail. Geht erst wirklich raus, wenn SMTP im + Stack gesetzt ist — bis dahin steht sie nur im Log. - [ ] Kontaktformulare haben **kein `action`**. Sie sehen richtig aus, senden aber nirgendwohin: `/kontakt`, `/business/kontakt`, `/business/anfrage`. diff --git a/backend/apps/backend/src/api/store/customers/me/subscriptions/[id]/route.ts b/backend/apps/backend/src/api/store/customers/me/subscriptions/[id]/route.ts index 2ac3da9..803d707 100644 --- a/backend/apps/backend/src/api/store/customers/me/subscriptions/[id]/route.ts +++ b/backend/apps/backend/src/api/store/customers/me/subscriptions/[id]/route.ts @@ -1,6 +1,7 @@ import { AuthenticatedMedusaRequest, MedusaResponse } from "@medusajs/framework/http"; import { SUBSCRIPTION_MODULE } from "../../../../../../modules/subscription"; import { HONEY_SIZES } from "../../../../../../lib/honey-picker"; +import { sendeKuendigungsbestaetigung } from "../../../../../../lib/kuendigung-mail"; /** * Ändert ein Abo: Menge, Größe, Sortenwahl, Zustand. @@ -108,6 +109,15 @@ export async function POST(req: AuthenticatedMedusaRequest, res: MedusaResponse) const updated = await service.updateSubscriptions(update); const result = Array.isArray(updated) ? updated[0] : updated; + // § 312k Abs. 4: auch die Kündigung im Kundenkonto wird in Textform bestätigt. + if (body.action === "cancel") { + await sendeKuendigungsbestaetigung(req.scope, result, { + art: "Ordentliche Kündigung im Kundenkonto", + eingegangen: update.canceled_at as Date, + grund: (update.cancel_reason as string | undefined) ?? null, + }); + } + res.json({ subscription: { id: result.id, diff --git a/backend/apps/backend/src/api/store/subscriptions/cancel/route.ts b/backend/apps/backend/src/api/store/subscriptions/cancel/route.ts index 52e9460..1592670 100644 --- a/backend/apps/backend/src/api/store/subscriptions/cancel/route.ts +++ b/backend/apps/backend/src/api/store/subscriptions/cancel/route.ts @@ -1,5 +1,6 @@ import { MedusaRequest, MedusaResponse } from "@medusajs/framework/http"; import { SUBSCRIPTION_MODULE } from "../../../../modules/subscription"; +import { sendeKuendigungsbestaetigung } from "../../../../lib/kuendigung-mail"; /** * Kündigung ohne Anmeldung — § 312k BGB. @@ -73,9 +74,14 @@ export async function POST(req: MedusaRequest, res: MedusaResponse) { logger.info(`[kuendigung] Abo ${subscription.id} gekündigt (${canceledAt.toISOString()}).`); - // § 312k Abs. 2 verlangt zusätzlich eine sofortige Bestätigung in Textform. - // Solange kein Versandweg eingerichtet ist, bleibt das der offene Punkt — - // siehe Hinweis in der Antwort. + // § 312k Abs. 4 verlangt zusätzlich eine sofortige Bestätigung in Textform. + await sendeKuendigungsbestaetigung(req.scope, subscription, { + art: `${kind}e Kündigung`, + eingegangen: canceledAt, + name: body.name ? String(body.name).slice(0, 120) : null, + grund: body.reason ? String(body.reason).slice(0, 500) : null, + }); + res.json({ subscription_id: subscription.id, canceled_at: canceledAt.toISOString(), diff --git a/backend/apps/backend/src/lib/kuendigung-mail.ts b/backend/apps/backend/src/lib/kuendigung-mail.ts new file mode 100644 index 0000000..112542e --- /dev/null +++ b/backend/apps/backend/src/lib/kuendigung-mail.ts @@ -0,0 +1,47 @@ +import { Modules } from "@medusajs/framework/utils"; +import { kuendigungsbestaetigung } from "./order-emails"; + +const RHYTHMUS: Record = { + monthly: "monatlich", + quarterly: "vierteljährlich", + biannual: "halbjährlich", +}; + +/** + * Schickt die Kündigungsbestätigung (§ 312k Abs. 4 BGB) an die Adresse des + * Abos. Wirft nie: die Kündigung gilt auch, wenn die Mail scheitert — der + * Fehler steht dann im Log und muss von Hand nachgeholt werden. + */ +export async function sendeKuendigungsbestaetigung( + container: any, + abo: any, + angaben: { art: string; eingegangen: Date; name?: string | null; grund?: string | null } +) { + const logger = container.resolve("logger"); + try { + const inhalt = kuendigungsbestaetigung({ + aboId: abo.id, + art: angaben.art, + eingegangen: angaben.eingegangen, + rhythmus: RHYTHMUS[abo.interval] ?? abo.interval, + groesse: abo.size, + name: angaben.name, + grund: angaben.grund, + }); + const notification: any = container.resolve(Modules.NOTIFICATION); + await notification.createNotifications({ + to: abo.email, + channel: "email", + template: "subscription-canceled", + content: inhalt, + data: { subscription_id: abo.id }, + }); + logger.info(`[mail] Kündigungsbestätigung für ${abo.id} an ${abo.email}.`); + } catch (error) { + logger.error( + `[mail] Kündigungsbestätigung für ${abo.id} fehlgeschlagen — bitte von Hand schicken: ${ + error instanceof Error ? error.message : String(error) + }` + ); + } +} diff --git a/backend/apps/backend/src/lib/order-emails.ts b/backend/apps/backend/src/lib/order-emails.ts index 17c27b5..afd06d3 100644 --- a/backend/apps/backend/src/lib/order-emails.ts +++ b/backend/apps/backend/src/lib/order-emails.ts @@ -359,6 +359,78 @@ export function geschenkAnkuendigung(abo: GeschenkAbo) { return { subject: "Für Sie: ein Honig-Abo von place4bees", html, text }; } +export type Kuendigung = { + aboId: string; + /** "Ordentliche" oder "Außerordentliche" — wie angegeben. */ + art: string; + eingegangen: Date; + rhythmus: string; + groesse?: string | null; + name?: string | null; + grund?: string | null; +}; + +/** + * Kündigungsbestätigung nach § 312k Abs. 4 BGB: Inhalt der Kündigung, + * Datum und Uhrzeit des Eingangs und wann der Vertrag endet. + */ +export function kuendigungsbestaetigung(k: Kuendigung) { + const zeitpunkt = new Intl.DateTimeFormat("de-DE", { + dateStyle: "long", + timeStyle: "short", + timeZone: "Europe/Berlin", + }).format(k.eingegangen); + const vertrag = `Honig-Abo ${k.rhythmus}${k.groesse ? `, ${k.groesse}` : ""} (Abo-Nummer ${k.aboId})`; + + const zeilen: [string, string][] = [ + ["Vertrag", vertrag], + ["Art der Kündigung", k.art], + ["Eingegangen am", `${zeitpunkt} Uhr`], + ["Vertragsende", "mit sofortiger Wirkung"], + ]; + if (k.name) zeilen.push(["Name", k.name]); + if (k.grund) zeilen.push(["Grund", k.grund]); + + const htmlInhalt = RAHMEN(` +

Ihre Kündigung ist eingegangen

+

Hallo,

+

+ hiermit bestätigen wir den Eingang Ihrer Kündigung. Ihr Abo endet + sofort: Es folgen keine weiteren Lieferungen und keine Abbuchungen. +

+ + ${zeilen + .map( + ([feld, wert]) => ` + + + ` + ) + .join("")} +
${feld}${html(wert)}
+

+ Bewahren Sie diese E-Mail als Nachweis auf. War die Kündigung ein + Versehen? Schreiben Sie uns einfach. +

`); + + const text = [ + "Ihre Kündigung ist eingegangen", + "", + "Hallo,", + "", + "hiermit bestätigen wir den Eingang Ihrer Kündigung. Ihr Abo endet", + "sofort: Es folgen keine weiteren Lieferungen und keine Abbuchungen.", + "", + ...zeilen.map(([feld, wert]) => `${feld}: ${wert}`), + "", + "Bewahren Sie diese E-Mail als Nachweis auf.", + "", + `${SHOP.name} · ${SHOP.web} · ${SHOP.email}`, + ].join("\n"); + + return { subject: "Bestätigung Ihrer Kündigung – place4bees Honig-Abo", html: htmlInhalt, text }; +} + /** Versandnachricht an den Beschenkten — dieselbe Sendung, ohne Beträge. */ export function geschenkVersandnachricht( empfaengerName: string, diff --git a/frontend/src/pages/kuendigung.astro b/frontend/src/pages/kuendigung.astro index b906074..cddf6f6 100644 --- a/frontend/src/pages/kuendigung.astro +++ b/frontend/src/pages/kuendigung.astro @@ -101,7 +101,8 @@ import Layout from "../layouts/Layout.astro";

Ihr Abo ist gekündigt. Es wird nichts mehr abgebucht und nichts mehr - versandt. Bitte bewahren Sie diese Bestätigung auf: + versandt. Dieselbe Bestätigung schicken wir Ihnen per E-Mail. Bitte + bewahren Sie sie auf: