From c3328ab54fe99d88b8dfd9807773836c2cbf1938 Mon Sep 17 00:00:00 2001 From: torbinus Date: Fri, 2 Oct 2026 12:13:23 +0200 Subject: [PATCH] =?UTF-8?q?DHL:=20Gruppenprofil=20und=20Mindestl=C3=A4nge?= =?UTF-8?q?=20der=20Referenznummer?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Zwei Fehler, die erst am echten Dienst auffielen: Im Feld "profile" stand "STANDARD". DHL erwartet dort den Namen des Gruppenprofils aus dem Geschäftskundenportal, also "STANDARD_GRUPPENPROFIL". Die Antwort lautete "You are not permitted to this user group profile" und klang nach einem Rechteproblem, war aber keines. Über DHL_PROFILE umstellbar, falls eure Einrichtung abweicht. Die Referenznummer war die blanke Bestellnummer. DHL verlangt 8 bis 35 Zeichen, "31" ist zu kurz. Jetzt mit Präfix "Bestellung-". Gegen den Sandkasten geprüft: Validierung meldet "1 of 1 shipment validated OK", und mit abgeschaltetem Prüfmodus kommt ein echtes Musterlabel samt Sendungsnummer zurück. Co-Authored-By: Claude Opus 5 (1M context) --- .../src/modules/dhl-fulfillment/service.ts | 17 ++++++++++++++--- .../apps/backend/src/scripts/check-carriers.ts | 2 +- 2 files changed, 15 insertions(+), 4 deletions(-) diff --git a/backend/apps/backend/src/modules/dhl-fulfillment/service.ts b/backend/apps/backend/src/modules/dhl-fulfillment/service.ts index 99552ec..d8c4628 100644 --- a/backend/apps/backend/src/modules/dhl-fulfillment/service.ts +++ b/backend/apps/backend/src/modules/dhl-fulfillment/service.ts @@ -34,6 +34,11 @@ type Options = { }; const LIVE_URL = "https://api-eu.dhl.com/parcel/de/shipping/v2"; +/** Name des Gruppenprofils im Geschäftskundenportal. Im Sandkasten und in + * der Standardeinrichtung heißt es so; weicht eure Einrichtung ab, steht der + * Name unter Paket & Waren → Versenden → Einstellungen → Nutzergruppen. */ +const DHL_PROFIL = process.env.DHL_PROFILE ?? "STANDARD_GRUPPENPROFIL"; + const SANDBOX_URL = "https://api-sandbox.dhl.com/parcel/de/shipping/v2"; /** @@ -198,7 +203,9 @@ class DhlFulfillmentService extends AbstractFulfillmentProviderService { return { product: params.product, billingNumber: o.billing_number, - refNo: params.reference.slice(0, 35), + // DHL verlangt 8 bis 35 Zeichen. Eine Bestellnummer wie "31" ist zu + // kurz, deshalb das Präfix — es steht später auch auf dem Label. + refNo: `Bestellung-${params.reference}`.slice(0, 35), shipper: { name1: o.shipper_name, addressStreet: o.shipper_street, @@ -234,7 +241,11 @@ class DhlFulfillmentService extends AbstractFulfillmentProviderService { const weightGrams = await this.resolveWeightGrams(items); const payload = { - profile: "STANDARD", + // Nicht "STANDARD": DHL erwartet hier den Namen des Gruppenprofils aus + // dem Geschäftskundenportal. Mit dem falschen Wert antwortet die + // Schnittstelle mit "You are not permitted to this user group profile", + // was wie ein Rechteproblem klingt, aber keines ist. + profile: DHL_PROFIL, shipments: [ this.buildShipment({ product, @@ -290,7 +301,7 @@ class DhlFulfillmentService extends AbstractFulfillmentProviderService { async cancelFulfillment(data: Record): Promise { const shipmentNo = data.dhl_shipment_no as string | undefined; if (!shipmentNo || data.dhl_validate_only) return {}; - await this.request(`/orders?shipment=${encodeURIComponent(shipmentNo)}&profile=STANDARD`, { + await this.request(`/orders?shipment=${encodeURIComponent(shipmentNo)}&profile=${DHL_PROFIL}`, { method: "DELETE", }); return {}; diff --git a/backend/apps/backend/src/scripts/check-carriers.ts b/backend/apps/backend/src/scripts/check-carriers.ts index 8be7d22..36f03fc 100644 --- a/backend/apps/backend/src/scripts/check-carriers.ts +++ b/backend/apps/backend/src/scripts/check-carriers.ts @@ -45,7 +45,7 @@ async function checkDhl() { console.log(` Abrechnungsnr: ${process.env.DHL_BILLING_NUMBER} (${String(process.env.DHL_BILLING_NUMBER).length} Zeichen, erwartet 14)`); const payload = { - profile: "STANDARD", + profile: process.env.DHL_PROFILE ?? "STANDARD_GRUPPENPROFIL", shipments: [ { product: "V01PAK",