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
@@ -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,
@@ -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(),
@@ -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 };
}
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. */
export function geschenkVersandnachricht(
empfaengerName: string,