Formulario de aduanas Límites de artículos

La documentación de las API heredadas suele encontrarse en guías para desarrolladores descargables en PDF.

Este es un fragmento parcial de solicitud SOAP/XML centrado en la sección CustomsClearanceDetail . Observe la verbosidad en comparación con JSON.

XML

    
        
            REMITENTE
            
        NO_DOCUMENTOS
        
            USD
            1550,00
                 

        
            Camiseta de algodón para hombre
            50
            Camiseta de algodón para hombre
            VN
            
                KG
                10,0
            
            50
            EA
            
                USD
                15,00
            
            
                USD
                750,00
            
            610910
        
        
            Cinturón de cuero
            20
            Cinturón de cuero
            IT
            
                KG
                4,0
            
            20
            EA
            
                USD
                40,00
            
            
                USD
                800,00
            
            420330
        
    
    

La documentación oficial de la API está disponible en el Portal de Desarrolladores de DHL Express.

Esta es una carga útil JSON parcial que se centra en el objeto de contenido para mostrar cómo estructurar varios elementos de línea.

JSON

{ "detallesdelcliente": { /* ... Detalles del cliente ... */ }, "accounts": [ { "typeCode": "shipper", "number": "YourAccountNumber" } ], "productCode": "P", "plannedShippingDateAndTime": "2025-09-16T11:00:00 GMT+01:00", "pickup": { "isRequested": false }, "ship": { /* ... Detalles del remitente y destinatario ... */ }, "packages": [ { /* ... Detalles del paquete ... */ } ], "content": { "isCustomsDeclarable": true, "incoterm": "DAP", "unitOfMeasurement": "metric", "exportDeclaration": {"invoice": { "number": "INV-2025-12345", "date": "2025-09-15" }, "exportLineItems": [ // Esta es la matriz para sus partidas de aduanas (máx. 999). { "number": 1, "quantity": { "value": 10, "unitOfMeasurement": "BOX" }, "description": "Placas de circuito de grado A", "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": "Unidades de Fuente de Alimentación", "value": 1500.00, "commodityCode": "8504.40.95", "countryOfOrigin": "CN", "grossWeight": {"value": 20.5 }, "netWeight": { "value": 18.0 } } ] } }

La documentación se encuentra en el Portal de Desarrolladores de DHL, pero en las secciones Post & Parcel Germany o eCommerce Solutions , que utilizan una API diferente a la de DHL Express.

Este ejemplo muestra la estructura de un envío con detalles aduaneros para DHL eCommerce.

JSON

{ "profile": "STANDARD_GRUPPENPROFIL", "shipments": [ { "product": "V55WPAK", "billingNumber": "YourBillingNumber", "refNo": "Customer-Ref-123", "shipper": { /* ... Dirección del remitente ... */ }, "receiver": { /* ... Dirección del destinatario ... */ }, "details": { "dim": { "uom": "cm", "length": 20, "width": 15, "height": 10 }, "weight": { "uom": "kg", "value": 2.5 }, "customsDetails": {"exportType": "OTROS", "placeOfCommital": "Hamburgo", "additionalInfo": "Artículos de regalo", "exportTypeDescription": "SALE_OF_GOODS", "invoiceNo": "INV-2025-12345", "items": [ // Esta es la matriz para sus artículos de línea de aduanas (máx. 99).
            { "itemDescription": "Bufanda de lana", "packagedQuantity": 2, "countryOfOrigin": "GB", "hsCode": "611710", "itemValue": 25.00, "itemWeight": 0.4 }, { "itemDescription": "Guantes de cuero", "packagedQuantity": 1, "countryOfOrigin": "IT", "hsCode": "420321", "itemValue": 60.00, "itemWeight": 0.3 } ] } } } ] }

La documentación oficial de esta API específica se encuentra en el Portal para Desarrolladores de DHL eCommerce Solutions Americas. Es crucial utilizar este portal y no el europeo para realizar envíos desde Estados Unidos.

A continuación se muestra un ejemplo de carga JSON para crear un envío. Destaca el objeto customs y la estructura de la matriz commodities donde se listarían los artículos.

JSON

{ "cargador": { /* ... Detalles del remitente ... */ }, "consignatario": { /* ... Detalles del consignatario (receptor) ... */ }, "packages": [ { "packageId": "YourPackageID123", "weight": 2.5, "weightUom": "lb", "dimensions": { "longitud": 10, "width": 8, "height": 4, "dimUom": "in" }, "customs": { "currency": "USD", "customsValue": 125.00, "customsContentType": "MERCHANDISE", "commodities": [ // Esta es la matriz para sus artículos de línea de aduanas (máx. 99). {"description": "Polo de algodón para hombre", "quantity": 3, "value": 25.00, "hsCode": "610510", "countryOfOrigin": "VN" }, {"description": "Bolso de piel para mujer", "quantity": "cantidad": 1, "value": 50.00, "hsCode": "420221", "countryOfOrigin": "MX" } ] 
     } } ], "labelOptions": { "format": "PDF", "resolution": 300 }, "billing": { "shipperAccountNumber": "YourAccountNumber", "billingAccountNumber": "YourAccountNumber" }, "serviceType": "plg" }