Zum Inhalt
HALOWERK

Rohstoffwerk

dhl shipping label

Sends one domestic German shipment to the official DHL Parcel DE Shipping v2 API. Validation-only is the default and causes no DHL state change. Test-label creation is permitted only in the configured sandbox; production creation stays disabled unless the operator explicitly enables it. Address and contact values are forwarded to DHL solely for this request and are never archived by HALOWERK. The caller confirms authority and any consent required for forwarding recipient data.

POST https://material.halowerk.com/dhl-shipping-label

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
profilestringNein
productstringNein
billing_numberstringJa
referencestringJa
ship_datestringNein
shipperobjectJa
consigneeobjectJa
weight_kgnumberJa
dimensions_cmobjectNein
print_formatstringNein
validate_onlybooleanNein
authorization_confirmedbooleanJa
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "billing_number",
    "reference",
    "shipper",
    "consignee",
    "weight_kg",
    "authorization_confirmed"
  ],
  "additionalProperties": false,
  "properties": {
    "profile": {
      "type": "string",
      "minLength": 1,
      "maxLength": 35,
      "default": "STANDARD_GRUPPENPROFIL"
    },
    "product": {
      "type": "string",
      "enum": [
        "V01PAK",
        "V62KP"
      ],
      "default": "V01PAK"
    },
    "billing_number": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{14}$"
    },
    "reference": {
      "type": "string",
      "minLength": 8,
      "maxLength": 35
    },
    "ship_date": {
      "type": "string",
      "format": "date"
    },
    "shipper": {
      "type": "object",
      "required": [
        "name",
        "street",
        "postal_code",
        "city"
      ],
      "additionalProperties": false,
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 50
        },
        "street": {
          "type": "string",
          "minLength": 1,
          "maxLength": 50
        },
        "house_number": {
          "type": "string",
          "minLength": 1,
          "maxLength": 10
        },
        "postal_code": {
          "type": "string",
          "pattern": "^[0-9]{5}$"
        },
        "city": {
          "type": "string",
          "minLength": 1,
          "maxLength": 40
        },
        "email": {
          "type": "string",
          "minLength": 3,
          "maxLength": 80
        }
      }
    },
    "consignee": {
      "type": "object",
      "required": [
        "name",
        "street",
        "postal_code",
        "city"
      ],
      "additionalProperties": false,
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 50
        },
        "street": {
          "type": "string",
          "minLength": 1,
          "maxLength": 50
        },
        "house_number": {
          "type": "string",
          "minLength": 1,
          "maxLength": 10
        },
        "postal_code": {
          "type": "string",
          "pattern": "^[0-9]{5}$"
        },
        "city": {
          "type": "string",
          "minLength": 1,
          "maxLength": 40
        },
        "email": {
          "type": "string",
          "minLength": 3,
          "maxLength": 80
        }
      }
    },
    "weight_kg": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 31.5
    },
    "dimensions_cm": {
      "type": "object",
      "required": [
        "length",
        "width",
        "height"
      ],
      "additionalProperties": false,
      "properties": {
        "length": {
          "type": "integer",
          "minimum": 1,
          "maximum": 200
        },
        "width": {
          "type": "integer",
          "minimum": 1,
          "maximum": 200
        },
        "height": {
          "type": "integer",
          "minimum": 1,
          "maximum": 200
        }
      }
    },
    "print_format": {
      "type": "string",
      "enum": [
        "A4",
        "910-300-600",
        "910-300-610",
        "910-300-700",
        "910-300-700-oz",
        "910-300-710",
        "910-300-300",
        "910-300-300-oz",
        "910-300-400",
        "910-300-410"
      ],
      "default": "A4"
    },
    "validate_only": {
      "type": "boolean",
      "default": true
    },
    "authorization_confirmed": {
      "type": "boolean",
      "const": true
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "billing_number": "33333333330102",
  "reference": "HALOWERK-TEST-0001",
  "shipper": {
    "name": "HALOWERK Test",
    "street": "Sträßchensweg",
    "house_number": "10",
    "postal_code": "53113",
    "city": "Bonn"
  },
  "consignee": {
    "name": "Testempfänger",
    "street": "Kurt-Schumacher-Str.",
    "house_number": "20",
    "postal_code": "53113",
    "city": "Bonn"
  },
  "weight_kg": 0.5,
  "validate_only": true,
  "authorization_confirmed": true
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →