Formulaire douanier Limites d'articles

La documentation relative aux anciennes API se trouve souvent dans des guides du développeur téléchargeables au format PDF.

Il s'agit d'un extrait partiel de requête SOAP/XML portant sur la section CustomsClearanceDetail . Notez la verbosité par rapport à JSON.

XML

    
        
            SENDER
            
        NON_DOCUMENTS
        
            USD
            1550.00
                 

        
            T-Shirt coton homme
            50
            T-Shirt coton homme
            VN
            
                KG
                10.0
            
            50
            EA
            
                USD
                15.00
            
            
                USD
                750.00
            
            910
        
        
            Ceinture en cuir
            20
            Ceinture en cuir
            IT
            
                KG
                4.0
            
            20
            EA
            
                USD
                40.00
            
            
                USD
                800.00
            
            420330
        
    
    

La documentation officielle de l'API est disponible sur le portail des développeurs de DHL Express.

Il s'agit d'une charge utile JSON partielle qui se concentre sur l'objet contenu pour montrer comment structurer plusieurs éléments de ligne.

JSON

{ "customerDetails" : { /* ... Détails du client ... */ }, "accounts" : [ { "typeCode" : "shipper", "number" : "YourAccountNumber" } ], "productCode" : "P", "plannedShippingDateAndTime" : "2025-09-16T11:00:00 GMT+01:00", "pickup" : { "isRequested" : false }, "ship" : { /* ... Détails de l'expéditeur et du destinataire ... */ }, "packages" : [ { /* ... Détails du colis ... */ } ], "content" : {"isCustomsDeclarable" : true, "incoterm" : "DAP", "unitOfMeasurement" : "metric", "exportDeclaration" : {"invoice" : { "number" : "INV-2025-12345", "date" : "2025-09-15" } }, "exportLineItems" : [ // Il s'agit du tableau de vos articles de douane (max. 999). { "number" : 1, "quantity" : {"value" : 10, "unitOfMeasurement" : "BOX" }, "description" : "Grade A Circuit Boards", "value" : 500.00, "commodityCode" : "8473.30.11", "countryOfOrigin" : "KR", "grossWeight" : {"valeur" : 5.5 }, "netWeight" : {"valeur" : 5 }, "poids net" : {"valeur" : 0 } : 5.0 } }, { "number" : 2, "quantity" : { "valeur" : 100, "unitOfMeasurement" : "PCS" }, "description" : "Power Supply Units", "value" : 1500.00, "commodityCode" : "8504.40.95", "countryOfOrigin" : "CN", "grossWeight" : {"valeur" : 20.5 }, "netWeight" : {"valeur" : 18.0 } } ] } }

La documentation se trouve sur le portail des développeurs de DHL, mais dans les sections Post & Parcel Germany ou eCommerce Solutions , qui utilisent une API différente de celle de DHL Express.

Cet exemple montre la structure d'un envoi avec des détails douaniers pour DHL eCommerce.

JSON

{ "profile" : "STANDARD_GRUPPENPROFIL", "shipments" : [ { "product" : "V55WPAK", "billingNumber" : "YourBillingNumber", "refNo" : "Customer-Ref-123", "shipper" : { /* ... Adresse de l'expéditeur ... */ }, "receiver" : { /* ... Adresse du destinataire ... */ }, "details" : { "dim" : { "uom" : "cm", "length" : 20, "width" : 15, "height" : 10 }, "weight" : { "uom" : "kg", "value" : 2.5 }, "customsDetails" : { "exportType" : "OTHER", "placeOfCommital" : "Hamburg", "additionalInfo" : "Articles cadeaux", "exportTypeDescription" : "SALE_OF_GOODS", "invoiceNo" : "INV-2025-12345", "items" : [ // Il s'agit du tableau de vos articles de douane (max 99).
            { "itemDescription" : "Foulard en laine", "packagedQuantity" : 2, "countryOfOrigin" : "GB", "hsCode" : "611710", "itemValue" : 25.00, "itemWeight" : 0.4 }, {"itemDescription" : "Gants en cuir", "packagedQuantity" : 1, "countryOfOrigin" : "IT", "hsCode" : "420321", "itemValue" : 60.00, "itemWeight" : 0.3 } ] } } } ] }

La documentation officielle de cette API spécifique se trouve sur le portail des développeurs de DHL eCommerce Solutions Americas. Il est essentiel d'utiliser ce portail et non le portail européen pour les expéditions basées aux États-Unis.

Vous trouverez ci-dessous un exemple de charge utile JSON pour la création d'un envoi. Il met en évidence l'objet customs et la structure du tableau commodities dans lequel vous listerez vos articles.

JSON

{ "shipper" : { /* ... Détails de l'expéditeur ... */ }, "consignee" : { /* ... Détails sur le destinataire ... */ }, "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" : [ // Il s'agit du tableau de vos articles de douane (max 99). { "description" : "Polo en coton pour homme", "quantity" : 3, "value" : 25.00, "hsCode" : "610510", "countryOfOrigin" : "VN" }, {"description" : "Sac à main en cuir pour femme", "quantity" : 1, "valeur" : 50.00, "hsCode" : "420221", "countryOfOrigin" : "MX" } ] 
     } } ], "labelOptions" : {"format" : "PDF", "resolution" : 300 }, "billing" : { "shipperAccountNumber" : "YourAccountNumber", "billingAccountNumber" : "YourAccountNumber" }, "serviceType" : "plg" }