diff --git a/backend/apps/backend/src/admin/widgets/order-label-widget.tsx b/backend/apps/backend/src/admin/widgets/order-label-widget.tsx new file mode 100644 index 0000000..5883456 --- /dev/null +++ b/backend/apps/backend/src/admin/widgets/order-label-widget.tsx @@ -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) => { + const [laedt, setLaedt] = useState(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 ( + +
+ Versandlabel +
+ + {sendungen.length === 0 ? ( +
+ + Noch kein Label. Es entsteht, sobald die Zahlung gebucht und die Sendung angelegt ist. + +
+ ) : ( + sendungen.map((sendung: any, index: number) => { + const nummer = sendung.data?.dhl_shipment_no ?? "ohne Nummer"; + const hatLabel = Boolean(sendung.data?.dhl_label_b64); + return ( +
+
+ + {sendungen.length > 1 ? `Paket ${index + 1}: ` : ""} + {nummer} + + {!hatLabel && ( + + Für diese Sendung liegt kein PDF vor. + + )} +
+ {hatLabel && ( +
+ + +
+ )} +
+ ); + }) + )} +
+ ); +}; + +export const config = defineWidgetConfig({ + zone: "order.details.side.after", +}); + +export default OrderLabelWidget; diff --git a/backend/apps/backend/src/api/admin/orders/[id]/label/route.ts b/backend/apps/backend/src/api/admin/orders/[id]/label/route.ts new file mode 100644 index 0000000..abc996e --- /dev/null +++ b/backend/apps/backend/src/api/admin/orders/[id]/label/route.ts @@ -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); +} diff --git a/backend/apps/backend/src/modules/dhl-fulfillment/service.ts b/backend/apps/backend/src/modules/dhl-fulfillment/service.ts index 92c19c5..65738bd 100644 --- a/backend/apps/backend/src/modules/dhl-fulfillment/service.ts +++ b/backend/apps/backend/src/modules/dhl-fulfillment/service.ts @@ -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),