DHL: Gruppenprofil und Mindestlänge der Referenznummer

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) <noreply@anthropic.com>
This commit is contained in:
torbinus
2026-10-02 12:13:23 +02:00
parent 0195d13ca7
commit c3328ab54f
2 changed files with 15 additions and 4 deletions
@@ -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<string, unknown>): Promise<any> {
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 {};
@@ -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",