Etikettendruck

Hilfe beim Generieren, Dekodieren und Drucken von DPD-Versandetiketten.

---

Etiketten in der API-Antwort

Eine erfolgreiche Sendungserstellung gibt jedes Etikett als Base64-kodierte PDF-Zeichenkette im Feld success[].label zurück.

{
  "success": [
    {
      "id": 1,
      "parcelNumber": "05305000123456",
      "label": "JVBERi0xLjQKJeLjz9MK..."
    }
  ]
}

---

Etikett dekodieren und speichern

Shell:

echo "JVBERi0xLjQK..." | base64 --decode > etikett.pdf

JavaScript (Browser):

function etiketteHerunterladen(base64Label, parcelNumber) {
  const bytes = atob(base64Label);
  const array = new Uint8Array(bytes.length);
  for (let i = 0; i < bytes.length; i++) array[i] = bytes.charCodeAt(i);

  const blob = new Blob([array], { type: 'application/pdf' });
  const url = URL.createObjectURL(blob);

  const a = document.createElement('a');
  a.href = url;
  a.download = `etikett-${parcelNumber}.pdf`;
  a.click();
  URL.revokeObjectURL(url);
}

---

Das richtige Etikettenformat wählen

Setzen Sie printOptions.labelFormat in Ihrer Sendungsanfrage:

Format	Wert	Anwendungsfall
A4	"A4"	Standard-Bürodrucker. Bis zu 4 Etiketten pro Blatt – Position über labelStartPosition (1–4)
Thermodruck / A6	"A6"	Direkt-Thermoetikett-Drucker (Zebra, Citizen usw.)

---

Mehrere Etiketten auf einem A4-Blatt

[
  { "...", "printOptions": { "labelFormat": "A4", "labelStartPosition": 1 } },
  { "...", "printOptions": { "labelFormat": "A4", "labelStartPosition": 2 } },
  { "...", "printOptions": { "labelFormat": "A4", "labelStartPosition": 3 } },
  { "...", "printOptions": { "labelFormat": "A4", "labelStartPosition": 4 } }
]

---

Etikett leer oder beschädigt

Ursache 1: Base64-Dekodierfehler – zusätzliche Leerzeichen oder Zeilenumbrüche.

Lösung: Leerzeichen vor der Dekodierung entfernen:

const cleanBase64 = base64String.replace(/\s+/g, '');

Ursache 2: PDF-Viewer-Kompatibilität.

Lösung: PDF in einem anderen Viewer öffnen. Etiketten sind gültige PDF 1.4+-Dateien.

Ursache 3: DPI-Konflikt beim Thermodrucker.

Lösung: Drucker auf 203 oder 300 DPI konfigurieren.

---

Noch nicht gelöst?

Geben Sie dem DPD-Support folgende Informationen:

• tracingId aus der API-Antwort
• parcelNumber des betroffenen Etiketts
• Verwendetes Etikettenformat (A4 / A6)
• Druckermodell und Treiberversion