Versandlabel im Admin drucken und herunterladen

Das PDF von DHL lag nur am Fulfillment in der Datenbank — der Admin zeigt
von sich aus bloß die Sendungsnummer. Jetzt gibt es auf der Bestellseite
ein Feld "Versandlabel" mit zwei Knöpfen je Sendung.

Drucken öffnet das PDF in einem eigenen Fenster und ruft den Druckdialog
auf. Im Hauptfenster würde der Browser sonst die ganze Admin-Seite
drucken statt des Etiketts.

Mehrere Pakete je Bestellung sind berücksichtigt: Jede Sendung bekommt
eine eigene Zeile mit ihrer Nummer.

Dazu das Druckformat ausdrücklich gesetzt (910-300-700, 105 x 205 mm).
Vorher galt die Voreinstellung des DHL-Kontos — ändert die sich, kommt
das Etikett plötzlich auf A4 und fällt erst am Drucker auf. Über
DHL_PRINT_FORMAT umstellbar.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
torbinus
2026-10-07 09:37:08 +02:00
parent 6d6d3a92a3
commit 0cd133fce9
3 changed files with 198 additions and 2 deletions
@@ -0,0 +1,136 @@
import { defineWidgetConfig } from "@medusajs/admin-sdk";
import { Button, Container, Heading, Text, toast } from "@medusajs/ui";
import type { DetailWidgetProps, AdminOrder } from "@medusajs/framework/types";
import { useState } from "react";
/**
* Versandlabel auf der Bestellseite im Admin.
*
* Medusa zeigt von sich aus nur die Sendungsnummer. Das PDF von DHL liegt am
* Fulfillment und wäre ohne diesen Knopf nur über die Datenbank erreichbar.
*
* Drucken öffnet das PDF in einem eigenen Fenster und ruft den Druckdialog
* auf. Der Umweg ist nötig, weil ein Etikett im Hauptfenster erst dann
* druckbar wäre, wenn man es von Hand öffnet — und weil der Browser sonst die
* ganze Admin-Seite drucken würde statt des Etiketts.
*/
const OrderLabelWidget = ({ data: order }: DetailWidgetProps<AdminOrder>) => {
const [laedt, setLaedt] = useState<string | null>(null);
// Nur Sendungen mit Label: Läuft eine Bestellung über Hermes oder wurde von
// Hand abgewickelt, gibt es keins — dann zeigt das Widget das auch so.
const sendungen = ((order as any).fulfillments ?? []).filter(
(f: any) => f?.data?.dhl_label_b64 || f?.data?.dhl_shipment_no
);
const holen = async (fulfillmentId: string) => {
const res = await fetch(`/admin/orders/${order.id}/label?fulfillment=${fulfillmentId}`, {
credentials: "include",
});
if (!res.ok) {
const fehler = await res.json().catch(() => ({}));
throw new Error(fehler.message ?? `Label nicht ladbar (${res.status}).`);
}
return URL.createObjectURL(await res.blob());
};
const drucken = async (fulfillmentId: string) => {
setLaedt(fulfillmentId);
try {
const url = await holen(fulfillmentId);
const fenster = window.open(url);
if (!fenster) {
toast.error("Fenster blockiert", {
description: "Der Browser hat das Druckfenster geblockt. Bitte Pop-ups für den Admin erlauben.",
});
return;
}
// Erst drucken, wenn das PDF wirklich da ist.
fenster.addEventListener("load", () => fenster.print());
} catch (fehler: any) {
toast.error("Fehler", { description: fehler.message });
} finally {
setLaedt(null);
}
};
const herunterladen = async (fulfillmentId: string, nummer: string) => {
setLaedt(fulfillmentId);
try {
const url = await holen(fulfillmentId);
const link = document.createElement("a");
link.href = url;
link.download = `versandlabel-${nummer}.pdf`;
document.body.appendChild(link);
link.click();
link.remove();
URL.revokeObjectURL(url);
} catch (fehler: any) {
toast.error("Fehler", { description: fehler.message });
} finally {
setLaedt(null);
}
};
return (
<Container className="divide-y p-0">
<div className="px-6 py-4">
<Heading level="h2">Versandlabel</Heading>
</div>
{sendungen.length === 0 ? (
<div className="px-6 py-4">
<Text size="small" className="text-ui-fg-subtle">
Noch kein Label. Es entsteht, sobald die Zahlung gebucht und die Sendung angelegt ist.
</Text>
</div>
) : (
sendungen.map((sendung: any, index: number) => {
const nummer = sendung.data?.dhl_shipment_no ?? "ohne Nummer";
const hatLabel = Boolean(sendung.data?.dhl_label_b64);
return (
<div key={sendung.id} className="flex flex-wrap items-center justify-between gap-3 px-6 py-4">
<div>
<Text size="small" weight="plus">
{sendungen.length > 1 ? `Paket ${index + 1}: ` : ""}
{nummer}
</Text>
{!hatLabel && (
<Text size="small" className="text-ui-fg-subtle">
Für diese Sendung liegt kein PDF vor.
</Text>
)}
</div>
{hatLabel && (
<div className="flex gap-2">
<Button
variant="secondary"
size="small"
isLoading={laedt === sendung.id}
onClick={() => herunterladen(sendung.id, nummer)}
>
Herunterladen
</Button>
<Button
variant="primary"
size="small"
isLoading={laedt === sendung.id}
onClick={() => drucken(sendung.id)}
>
Drucken
</Button>
</div>
)}
</div>
);
})
)}
</Container>
);
};
export const config = defineWidgetConfig({
zone: "order.details.side.after",
});
export default OrderLabelWidget;
@@ -0,0 +1,51 @@
import { MedusaRequest, MedusaResponse } from "@medusajs/framework/http";
/**
* Versandlabel einer Bestellung als PDF.
*
* GET /admin/orders/:id/label → das Label der ersten Sendung
* GET /admin/orders/:id/label?fulfillment=ful_… → das Label einer bestimmten
*
* Das PDF kommt von DHL und liegt am Fulfillment. Es wird hier nur
* durchgereicht, nicht neu erzeugt — ein zweiter Abruf kostet also kein Porto.
*
* Inline statt als Download: So öffnet der Browser das Druckfenster direkt.
* Das Widget im Admin bietet beides an.
*/
export async function GET(req: MedusaRequest, res: MedusaResponse) {
const query = req.scope.resolve("query");
const { id } = req.params;
const gewuenscht = req.query.fulfillment as string | undefined;
const { data } = await query.graph({
entity: "order",
fields: ["id", "display_id", "fulfillments.id", "fulfillments.data", "fulfillments.created_at"],
filters: { id },
});
const order = data?.[0] as any;
if (!order) {
return res.status(404).json({ message: "Bestellung nicht gefunden." });
}
const mitLabel = (order.fulfillments ?? []).filter((f: any) => f?.data?.dhl_label_b64);
const fulfillment = gewuenscht
? mitLabel.find((f: any) => f.id === gewuenscht)
: mitLabel[0];
if (!fulfillment) {
return res.status(404).json({
message:
mitLabel.length === 0
? "Zu dieser Bestellung gibt es kein Versandlabel. Entweder wurde noch keine Sendung angelegt, oder sie läuft über einen Dienstleister ohne Label."
: "Diese Sendung hat kein Label.",
});
}
const pdf = Buffer.from(fulfillment.data.dhl_label_b64 as string, "base64");
const nummer = fulfillment.data.dhl_shipment_no ?? order.display_id;
res.setHeader("Content-Type", "application/pdf");
res.setHeader("Content-Disposition", `inline; filename="versandlabel-${nummer}.pdf"`);
res.send(pdf);
}
@@ -39,6 +39,11 @@ const LIVE_URL = "https://api-eu.dhl.com/parcel/de/shipping/v2";
* Name unter Paket & Waren → Versenden → Einstellungen → Nutzergruppen. */
const DHL_PROFIL = process.env.DHL_PROFILE ?? "STANDARD_GRUPPENPROFIL";
/** Druckformat des Labels. "910-300-700" ist das Etikett mit 105 x 205 mm,
* das ein Etikettendrucker ohne Skalierung annimmt. Wer auf A4 druckt, setzt
* DHL_PRINT_FORMAT=A4; weitere Formate stehen in der DHL-Doku. */
const DHL_DRUCKFORMAT = process.env.DHL_PRINT_FORMAT ?? "910-300-700";
const SANDBOX_URL = "https://api-sandbox.dhl.com/parcel/de/shipping/v2";
/**
@@ -264,9 +269,13 @@ class DhlFulfillmentService extends AbstractFulfillmentProviderService {
],
};
// printFormat ausdrücklich setzen statt DHLs Voreinstellung zu nehmen:
// Die hängt am Konto und kann sich ändern, ohne dass wir es merken —
// ein Etikett, das plötzlich auf A4 kommt, fällt erst am Drucker auf.
const format = `&printFormat=${encodeURIComponent(DHL_DRUCKFORMAT)}`;
const query = this.options_.validate_only
? "?validate=true&includeDocs=include"
: "?includeDocs=include";
? `?validate=true&includeDocs=include${format}`
: `?includeDocs=include${format}`;
const body = await this.request(`/orders${query}`, {
method: "POST",
body: JSON.stringify(payload),