Poczta Polska Integration (eNadawca)

El módulo Poczta Polska conecta los pedidos de WooCommerce con el seguimiento de Poczta Polska. Introduces el número de envío en el pedido y el plugin genera el enlace de emonitoring y trae el estado actual del transportista a la pantalla del pedido, a la página del pedido del cliente y a los correos de envío.

Configuración

Las credenciales de Poczta Polska se guardan en la opción polski_pro_shipping y se escriben mediante el endpoint REST de ajustes PRO polski-pro/v1/settings. Una pantalla de envíos propia en el escritorio está planificada, pero todavía no se ha publicado, así que hoy los valores se establecen a través de ese endpoint o actualizando la opción directamente.

Clave	Descripción
`poczta_enabled`	Activa el proveedor Poczta Polska
`poczta_login`	Usuario del sistema eNadawca
`poczta_password`	Contraseña del sistema eNadawca

Puedes obtener las credenciales de acceso registrándote en el sistema eNadawca en poczta-polska.pl.

La opción también admite poczta_environment, poczta_default_service y poczta_cod_bank_account. En esta versión nada las lee, están reservadas para el código de etiquetas aún no publicado del que trata la sección Etiquetas y máquinas de paquetería más abajo.

El proveedor solo se considera disponible cuando poczta_enabled está activo y tanto el usuario como la contraseña están rellenados. La consulta a emonitoring es una petición pública, pero el plugin no la lanza hasta que las credenciales estén puestas.

Introducir un número de seguimiento

Abre un pedido en WooCommerce > Orders
Debajo de la dirección de envío, busca la sección Shipment Tracking
En Carrier selecciona Poczta Polska
Pega el número de envío en Tracking number
Deja Tracking URL vacío para que se genere, o escribe tu propio enlace para sustituirlo
Actualiza el pedido

El enlace generado tiene este formato:

https://emonitoring.poczta-polska.pl/?numer={number}

Seguimiento en vivo

Cuando el pedido ya tiene transportista y número, la sección Shipment Tracking muestra una Live preview con el estado del transportista y el historial del envío leído del servicio emonitoring. La respuesta se cachea durante 10 minutos, de modo que abrir el pedido varias veces no consulta a Poczta Polska en cada carga.

Refresh live tracking vacía esa caché para el pedido y recarga la pantalla con una consulta nueva. Úsalo cuando el paquete acabe de moverse y la sección siga mostrando el evento anterior.

Dónde aparece el seguimiento

Lugar	Qué se muestra
Lista de pedidos	Una columna Tracking con el transportista y el número
Pantalla del pedido	La sección Shipment Tracking con estado en vivo, historial y el botón de actualizar
Mi cuenta > Pedidos	La acción Track shipment en la fila del pedido
Detalles del pedido y correos al cliente	Un recuadro de seguimiento con estado, transportista, número y un botón Track shipment

El módulo de fulfillment añade además a la lista de pedidos las acciones masivas Packed, Shipped y Delivered, con las que se lleva la parte de estados de un envío de Poczta Polska.

Etiquetas y máquinas de paquetería

La generación de etiquetas y la búsqueda de máquinas de paquetería están escritas, pero no conectadas. PocztaPolskaProvider::generateLabel() y la búsqueda de puntos de recogida están en el código, pero nada en el escritorio ni en la finalización de compra las alcanza, así que no hay botón para generar etiquetas, ni acción masiva, ni descarga de etiquetas, y el número de envío se crea en eNadawca (u otra herramienta de Poczta Polska) y se pega en el pedido a mano.

Requisitos técnicos

El seguimiento en vivo usa peticiones HTTPS normales, así que para lo que hace el módulo hoy no hace falta ninguna extensión de PHP adicional. La extensión PHP SOAP (ext-soap) solo la necesitaría el código de etiquetas al que nada llama. Comprueba si está activa:

phpinfo(); // Busca la sección "soap"

La mayoría de los proveedores de hosting PHP tienen SOAP activado de forma predeterminada.