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:
@@ -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",
|
||||
|
||||
Reference in New Issue
Block a user