Zollformblatt Positionslimits

Die Dokumentation für die Legacy-APIs findet sich häufig in herunterladbaren PDF-Entwicklerhandbüchern.

Dies ist ein Ausschnitt aus einer SOAP/XML-Anfrage mit Schwerpunkt auf dem Abschnitt CustomsClearanceDetail . Beachten Sie die Ausführlichkeit im Vergleich zu JSON.

XML

    
        
            Absender
            
        NON_DOCUMENTS
        
            USD
            1550.00
                 

        
            Herren T-Shirt aus Baumwolle
            50
            Herren T-Shirt aus Baumwolle
            VN
            
                KG
                10.0
            
            50
            EA
            
                USD
                15.00
            
            
                USD
                750.00
            
            610910
        
        
            Ledergürtel
            20
            Ledergürtel
            IT
            
                KG
                4.0
            
            20
            EA
            
                USD
                40.00
            
            
                USD
                800.00
            
            420330
        
    
    

Die offizielle API-Dokumentation ist auf dem DHL Express Developer Portal verfügbar.

Dies ist eine partielle JSON-Nutzlast, die sich auf das Inhaltsobjekt konzentriert, um zu zeigen, wie man mehrere Positionen strukturiert.

JSON

{ "customerDetails": { /* ... Kundendetails ... */ }, "accounts": [ { "typeCode": "shipper", "number": "YourAccountNumber" } ], "productCode": "P", "plannedShippingDateAndTime": "2025-09-16T11:00:00 GMT+01:00", "pickup": { "isRequested": false }, "ship": { /* ... Absender & Empfänger Details ... */ }, "packages": [ { /* ... Paketdetails ... */ } ], "content": { "isCustomsDeclarable": true, "incoterm": "DAP", "unitOfMeasurement": "metric", "exportDeclaration": { "invoice": { "number": "INV-2025-12345", "date": "2025-09-15" } }, "exportLineItems": [ // Dies ist das Array für Ihre Zollpositionen (max. 999). { "number": 1, "quantity": { "value": 10, "unitOfMeasurement": "BOX" }, "description": "Grade A Circuit Boards", "value": 500.00, "commodityCode": "8473.30.11", "countryOfOrigin": "KR", "grossWeight": { "value": 5.5 }, "netWeight": { "value": 5.0 } }, { "number": 2, "quantity": { "value": 100, "unitOfMeasurement": "PCS" }, "description": "Power Supply Units", "value": 1500.00, "commodityCode": "8504.40.95", "countryOfOrigin": "CN", "grossWeight": { "value": 20.5 }, "netWeight": { "value": 18.0 } } ] } }

Die Dokumentation befindet sich auf dem DHL Developer Portal, jedoch unter den Rubriken Post & Parcel Germany oder eCommerce Solutions , die eine andere API als DHL Express verwenden.

Dieses Beispiel zeigt die Struktur für eine Sendung mit Zollangaben für DHL eCommerce.

JSON

{ "Profil": "STANDARD_GRUPPENPROFIL", "Sendungen": [ { "product": "V55WPAK", "billingNumber": "YourBillingNumber", "refNo": "Customer-Ref-123", "shipper": { /* ... Absenderadresse ... */ }, "receiver": { /* ... Adresse des Empfängers ... */ }, "details": { "dim": { "uom": "cm", "length": 20, "width": 15, "height": 10 }, "weight": { "uom": "kg", "value": 2.5 }, "customsDetails": { "exportType": "OTHER", "placeOfCommital": "Hamburg", "additionalInfo": "Geschenkartikel", "exportTypeDescription": "SALE_OF_GOODS", "invoiceNo": "INV-2025-12345", "items": [ // Dies ist das Array für Ihre Zollpositionen (max. 99).
            { "itemDescription": "Wool Scarf", "packagedQuantity": 2, "countryOfOrigin": "GB", "hsCode": "611710", "itemValue": 25.00, "itemWeight": 0.4 }, { "itemDescription": "Lederhandschuhe", "packagedQuantity": 1, "countryOfOrigin": "IT", "hsCode": "420321", "itemValue": 60.00, "itemWeight": 0.3 } ] } } } ] }

Die offizielle Dokumentation für diese spezielle API finden Sie auf dem DHL eCommerce Solutions Americas Developer Portal. Für den Versand in die USA ist es wichtig, dieses Portal und nicht das europäische zu verwenden.

Nachstehend finden Sie ein Beispiel für eine JSON-Nutzlast zur Erstellung einer Sendung. Es hebt das Objekt customs und die Struktur des Arrays commodities hervor, in dem Sie Ihre Artikel auflisten würden.

JSON

{ "Versender": { /* ... Versender Details ... */ }, "consignee": { /* ... Empfänger (Receiver) Details ... */ }, "packages": [ { "packageId": "YourPackageID123", "weight": 2.5, "weightUom": "lb", "dimensions": { "length": 10, "width": 8, "height": 4, "dimUom": "in" }, "customs": { "currency": "USD", "customsValue": 125.00, "customsContentType": "MERCHANDISE", "commodities": [ // Dies ist das Array für Ihre Zollpositionen (max 99). { "description": "Men's Cotton Polo Shirt", "quantity": 3, "Wert": 25.00, "hsCode": "610510", "countryOfOrigin": "VN" }, { "description": "Women's Leather Handbag", "quantity": 1, "value": 50.00, "hsCode": "420221", "countryOfOrigin": "MX" } ] 
     } } ], "labelOptions": { "format": "PDF", "resolution": 300 }, "billing": { "shipperAccountNumber": "YourAccountNumber", "billingAccountNumber": "YourAccountNumber" }, "serviceType": "plg" }