DHL Parcel Poland Integration

El módulo DHL integra WooCommerce con la API REST de DHL Parcel Poland. Genera etiquetas, rastrea envíos y ofrece ubicaciones ServicePoint en el checkout.

Configuración

Ve a WooCommerce > Ajustes > Polski PRO > Envío.

Autenticación de la API

Ajuste	Descripción
Clave de API de DHL	Bearer token del DHL Developer Portal
Número de cuenta de DHL	Número de cuenta de cliente de DHL Parcel Poland

Puedes obtener la clave de API registrándote en developer.dhl.com y creando una aplicación con acceso a la DHL Parcel Poland API.

Activar el módulo

Ve a Polski PRO > Módulos
Activa el módulo DHL Parcel Poland
Completa la clave de API y el número de cuenta en los ajustes de envío

Generar etiquetas

Las etiquetas se generan desde el editor de pedidos:

Abre un pedido en WooCommerce > Pedidos
En la sección Shipment Tracking, selecciona el transportista DHL
Haz clic en Generar etiqueta
El sistema crea un envío mediante la API REST de DHL y devuelve un número de seguimiento más un enlace a la etiqueta en PDF

Tipos de servicio

Tipo	Descripción
AH	Entrega estándar a una dirección (predeterminado)
AP	Entrega a un DHL ServicePoint / casillero de paquetería

Para los servicios AP (ServicePoint) debes indicar el ID del punto de recogida.

Datos del envío

El módulo obtiene automáticamente del pedido los datos del destinatario y el peso de los productos. Dimensiones predeterminadas del paquete: 40x30x20 cm.

DHL ServicePoint

El módulo permite buscar ubicaciones ServicePoint (POP y casilleros de paquetería de DHL):

Búsqueda por ciudad
Búsqueda por coordenadas GPS (radio de 5 km)
Datos devueltos: nombre, dirección, tipo (POP/casillero), coordenadas

Seguimiento de envíos

Tras generar una etiqueta, el número de seguimiento se guarda automáticamente. El enlace de seguimiento de DHL se genera con el siguiente formato:

https://www.dhl.com/pl-pl/home/sledzenie-przesylek.html?tracking-id={number}

El cliente recibe un correo con el número de seguimiento cuando el estado cambia a Enviado.

Códigos de error

Código	Descripción	Solución
HTTP 401	Clave de API no válida	Comprueba el Bearer token en los ajustes
HTTP 400	Datos de envío no válidos	Comprueba la dirección, el código postal y el número de cuenta
HTTP 429	Límite de solicitudes de la API	Espera un momento e inténtalo de nuevo

Filtros y acciones

// Filter shipment data before sending it to DHL
add_filter('polski_pro/shipping/dhl/parcel_data', function (array $data, WC_Order $order): array {
    $data['service_type'] = 'AP'; // Force delivery to a ServicePoint
    $data['servicepoint_id'] = 'PL-12345';
    return $data;
}, 10, 2);