Kündigungsbestätigung per Mail (§ 312k BGB)

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) <noreply@anthropic.com>
This commit is contained in:
torbinus
2026-10-26 10:18:59 +01:00
parent ad75738c07
commit f4756998d9
6 changed files with 144 additions and 10 deletions
+4 -6
View File
@@ -61,12 +61,10 @@ PayPal und PayPal-Card.
## 2. Rechtlich offen ## 2. Rechtlich offen
- [ ] **§ 312k Abs. 2 BGB — Bestätigung in Textform.** Pflicht, aktuell nicht - [x] ~~**§ 312k BGB — Bestätigung in Textform.**~~ Seit 26.10.2026: Beide
erfüllt. In `medusa-config.ts` ist **kein** Notification-Modul registriert, Kündigungswege (`/kuendigung` und Kundenkonto) schicken eine
es geht also keine Kündigungsbestätigung raus. Die Druckansicht auf Kündigungsbestätigung per Mail. Geht erst wirklich raus, wenn SMTP im
`/kuendigung` ist ein Behelf, kein Ersatz. Stack gesetzt ist — bis dahin steht sie nur im Log.
Lösung: `@medusajs/notification` + SendGrid-Provider einhängen → braucht
einen SendGrid-API-Key. Betrifft auch Bestell- und Versandbestätigungen.
- [ ] Kontaktformulare haben **kein `action`**. Sie sehen richtig aus, senden - [ ] Kontaktformulare haben **kein `action`**. Sie sehen richtig aus, senden
aber nirgendwohin: `/kontakt`, `/business/kontakt`, `/business/anfrage`. aber nirgendwohin: `/kontakt`, `/business/kontakt`, `/business/anfrage`.
@@ -1,6 +1,7 @@
import { AuthenticatedMedusaRequest, MedusaResponse } from "@medusajs/framework/http"; import { AuthenticatedMedusaRequest, MedusaResponse } from "@medusajs/framework/http";
import { SUBSCRIPTION_MODULE } from "../../../../../../modules/subscription"; import { SUBSCRIPTION_MODULE } from "../../../../../../modules/subscription";
import { HONEY_SIZES } from "../../../../../../lib/honey-picker"; import { HONEY_SIZES } from "../../../../../../lib/honey-picker";
import { sendeKuendigungsbestaetigung } from "../../../../../../lib/kuendigung-mail";
/** /**
* Ändert ein Abo: Menge, Größe, Sortenwahl, Zustand. * Ä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 updated = await service.updateSubscriptions(update);
const result = Array.isArray(updated) ? updated[0] : updated; 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({ res.json({
subscription: { subscription: {
id: result.id, id: result.id,
@@ -1,5 +1,6 @@
import { MedusaRequest, MedusaResponse } from "@medusajs/framework/http"; import { MedusaRequest, MedusaResponse } from "@medusajs/framework/http";
import { SUBSCRIPTION_MODULE } from "../../../../modules/subscription"; import { SUBSCRIPTION_MODULE } from "../../../../modules/subscription";
import { sendeKuendigungsbestaetigung } from "../../../../lib/kuendigung-mail";
/** /**
* Kündigung ohne Anmeldung — § 312k BGB. * 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()}).`); logger.info(`[kuendigung] Abo ${subscription.id} gekündigt (${canceledAt.toISOString()}).`);
// § 312k Abs. 2 verlangt zusätzlich eine sofortige Bestätigung in Textform. // § 312k Abs. 4 verlangt zusätzlich eine sofortige Bestätigung in Textform.
// Solange kein Versandweg eingerichtet ist, bleibt das der offene Punkt — await sendeKuendigungsbestaetigung(req.scope, subscription, {
// siehe Hinweis in der Antwort. 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({ res.json({
subscription_id: subscription.id, subscription_id: subscription.id,
canceled_at: canceledAt.toISOString(), canceled_at: canceledAt.toISOString(),
@@ -0,0 +1,47 @@
import { Modules } from "@medusajs/framework/utils";
import { kuendigungsbestaetigung } from "./order-emails";
const RHYTHMUS: Record<string, string> = {
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)
}`
);
}
}
@@ -359,6 +359,78 @@ export function geschenkAnkuendigung(abo: GeschenkAbo) {
return { subject: "Für Sie: ein Honig-Abo von place4bees", html, text }; 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(`
<h1 style="margin:0 0 4px;font-size:22px">Ihre Kündigung ist eingegangen</h1>
<p style="margin:24px 0 0">Hallo,</p>
<p style="margin:12px 0 0">
hiermit bestätigen wir den Eingang Ihrer Kündigung. Ihr Abo endet
sofort: Es folgen keine weiteren Lieferungen und keine Abbuchungen.
</p>
<table style="margin:20px 0 0;border-collapse:collapse;width:100%">
${zeilen
.map(
([feld, wert]) => `<tr>
<td style="padding:6px 12px 6px 0;color:#6b6b66;vertical-align:top;white-space:nowrap">${feld}</td>
<td style="padding:6px 0">${html(wert)}</td>
</tr>`
)
.join("")}
</table>
<p style="margin:24px 0 0;color:#6b6b66;font-size:13px">
Bewahren Sie diese E-Mail als Nachweis auf. War die Kündigung ein
Versehen? Schreiben Sie uns einfach.
</p>`);
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. */ /** Versandnachricht an den Beschenkten — dieselbe Sendung, ohne Beträge. */
export function geschenkVersandnachricht( export function geschenkVersandnachricht(
empfaengerName: string, empfaengerName: string,
+2 -1
View File
@@ -101,7 +101,8 @@ import Layout from "../layouts/Layout.astro";
</h2> </h2>
<p class="mt-4 leading-relaxed text-brand-text"> <p class="mt-4 leading-relaxed text-brand-text">
Ihr Abo ist gekündigt. Es wird nichts mehr abgebucht und nichts mehr 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:
</p> </p>
<dl class="mt-6 grid gap-3 border-t border-brand-border pt-5 text-sm"> <dl class="mt-6 grid gap-3 border-t border-brand-border pt-5 text-sm">
<div class="flex justify-between gap-4"> <div class="flex justify-between gap-4">