DPD Polska Integration

El módulo DPD integra WooCommerce con la API de DPD Polska. Genera etiquetas de envío, rastrea los envíos y permite que los clientes elijan un punto DPD Pickup.

Configuración

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

Autenticación de la API

Ajuste	Descripción
Login DPD	Login para la DPD Web Service API
Contraseña DPD	Contraseña para la DPD Web Service API
Master FID	Número FID del remitente (identificador de cliente DPD)

Puedes obtener los datos de acceso desde el panel de cliente de DPD o de tu gestor comercial.

Activar el módulo

Ve a Polski PRO > Módulos
Activa el módulo DPD Polska
Completa los datos de la API 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 DPD
Haz clic en Generar etiqueta
El sistema crea un envío a través de la DPD SOAP API y devuelve un número de carta de porte

La etiqueta se asigna al pedido automáticamente. El número de seguimiento y el enlace de seguimiento se muestran en el panel del pedido y en el correo electrónico al cliente.

Datos del envío

El módulo obtiene automáticamente del pedido:

Nombre y apellidos / nombre de la empresa del destinatario
Dirección de entrega (calle, ciudad, código postal)
Teléfono y correo electrónico
Peso (de los datos del producto o por defecto)

Generación masiva

Selecciona varios pedidos en la lista y usa la acción masiva Generar etiquetas DPD para procesar varios pedidos a la vez.

Puntos DPD Pickup

El módulo permite buscar puntos DPD Pickup cercanos al cliente:

Búsqueda por ciudad
Búsqueda por coordenadas GPS (radio de 5 km)
Datos devueltos: nombre, dirección, código postal, coordenadas

Seguimiento de envíos

Una vez generada la etiqueta, el número de seguimiento se guarda automáticamente en el pedido. El enlace de seguimiento de DPD se genera automáticamente.

El cliente recibe un correo electrónico con el número de seguimiento y el enlace cuando el estado del pedido cambia a Enviado.

Códigos de error

Código	Descripción	Solución
HTTP 401	Datos de acceso incorrectos	Comprueba el login y la contraseña en los ajustes
HTTP 500	Error del servidor de DPD	Inténtalo de nuevo en unos minutos
Validation error	Datos de dirección incorrectos	Comprueba el formato del código postal (XX-XXX)

Filtros y acciones

// Filtra los datos del envío antes de enviarlos a DPD
add_filter('polski_pro/shipping/dpd/parcel_data', function (array $data, WC_Order $order): array {
    $data['weight'] = 2.5; // Establece un peso fijo
    return $data;
}, 10, 2);