InPost integration (Paczkomaty)

La integración con InPost cubre el seguimiento de envíos. Usted guarda el token de la API ShipX, escribe el número de seguimiento en el pedido y la pantalla del pedido muestra el estado en vivo y el historial de eventos obtenido de InPost. La generación de etiquetas está prevista, pero hoy no forma parte del plugin, así que nada de lo descrito aquí crea un envío en ShipX.

Activar el módulo

Vaya a Polski > Módulos y active Fulfillment. El módulo está desactivado de forma predeterminada y, mientras lo esté, los campos de seguimiento, la columna de seguimiento y los bloques visibles para el cliente ni siquiera se registran.

Credenciales de ShipX

Las credenciales de InPost se guardan en la opción polski_pro_shipping:

Clave	Descripción
`inpost_enabled`	Debe ser verdadero, de lo contrario se omite la consulta en vivo
`inpost_api_token`	Token de autorización del panel de InPost Manager (manager.paczkomaty.pl)
`inpost_organization_id`	Se guarda, pero la consulta de seguimiento no lo usa
`inpost_environment`	Se guarda, pero no se usa. Las consultas siempre van al host de producción de ShipX

Todavía no existe una pantalla de ajustes que muestre estos campos. Guárdelos mediante la ruta REST de ajustes de PRO:

PUT /wp-json/polski-pro/v1/settings
Content-Type: application/json
X-WP-Nonce: {nonce wp_rest}

{
  "shipping": {
    "inpost_enabled": true,
    "inpost_api_token": "eyJhbGciOi..."
  }
}

La ruta requiere la capacidad manage_woocommerce. El contenido guardado sustituye toda la opción polski_pro_shipping, así que envíe en la misma petición las claves de sus otros transportistas si ya están configurados.

WP-CLI también sirve:

wp option patch update polski_pro_shipping inpost_api_token "eyJhbGciOi..."
wp option patch update polski_pro_shipping inpost_enabled 1

El token se envía en la cabecera Authorization: Bearer {token} con cada solicitud a ShipX. Basta con acceso de lectura al seguimiento, no hacen falta permisos para crear envíos.

Número de seguimiento en el pedido

En la página de edición del pedido, bajo la dirección de envío, el bloque Seguimiento de envíos ofrece tres campos:

Campo	Descripción
Transportista	InPost, DPD, DHL, Poczta Polska u Otro
Número de seguimiento	Introducido a mano, por ejemplo `6230000123456789`
URL de seguimiento	Déjela vacía y se construye a partir del transportista y el número

Para InPost el enlace generado es:

https://inpost.pl/sledzenie-przesylek?number={numero_de_seguimiento}

Los campos se guardan con el pedido. Nada los rellena automáticamente, el número procede de donde haya creado el envío (InPost Manager, la aplicación del mensajero, el albarán).

Actualizar seguimiento en vivo

Una vez guardado un número o una URL de seguimiento, en el mismo bloque, encima de la vista previa en directo, aparece el botón Actualizar seguimiento en vivo. Borra la respuesta almacenada en caché y recarga la pantalla del pedido, lo que dispara una consulta nueva:

GET https://api-shipx-pl.easypack24.net/v1/tracking/{numero_de_seguimiento}

La respuesta se almacena en caché durante 10 minutos en un transient de WordPress, de modo que abrir el pedido varias veces no vuelve a llamar a la API. La vista previa muestra el estado del transportista, el nombre del transportista, el número de seguimiento, un enlace Seguimiento del envío y hasta ocho de los eventos más recientes con fecha y ubicación.

No hay ninguna consulta de estado programada ni cambio automático del estado del pedido. Los datos en vivo se obtienen cuando se abre una pantalla de pedido con la caché caducada o cuando usted pulsa el botón.

Dónde se muestra el seguimiento

Lista de pedidos - una columna “Seguimiento” con el transportista, el número, el estado en vivo y un enlace de seguimiento
Edición del pedido - los campos y la vista previa en directo descrita arriba
Mi cuenta > Pedidos - una acción de fila “Seguimiento del envío” y una sección “Seguimiento de envíos” en los detalles del pedido
Correos al cliente - el mismo bloque de seguimiento tras la tabla del pedido, solo en los correos al cliente, no en las copias para el administrador

Estados de preparación

El módulo registra tres estados de pedido de WooCommerce justo después de “Procesando”: packed, shipped y delivered. En la lista de pedidos están disponibles como acciones masivas:

Acción masiva	Resultado
Cambiar estado a Empaquetado	Pedido marcado como empaquetado, correo “Su pedido ha sido empacado”
Cambiar estado a Enviado	Pedido marcado como enviado, correo “Su pedido ha sido enviado”
Cambiar estado a Entregado	Pedido marcado como entregado, correo “Su pedido ha sido entregado”

Cada correo repite el transportista, el número de seguimiento y el enlace de seguimiento cuando están rellenos. Estos estados los establece usted, no los dirige el estado de InPost.

Todavía no disponible

La generación de etiquetas está prevista, pero no se ha publicado. El plugin no contiene código que cree un envío en ShipX, por lo que no hay botón para generar, descargar ni imprimir etiquetas, ni acción masiva de etiquetas, ni descarga en ZIP, ni ajuste de tamaño de paquete. El mapa de selección de Paczkomat en el pago y un método de envío propio de InPost tampoco están implementados, y no existe ningún filtro ni acción polski_pro/inpost/*. Si hoy necesita elegir un Paczkomat, use un plugin aparte o un campo propio en el pago.

Resolución de problemas

El bloque Seguimiento de envíos no aparece El módulo Fulfillment está desactivado, o el pedido no tiene guardado ni un número ni una URL de seguimiento. La vista previa en directo y el botón de actualización solo se muestran cuando uno de los dos existe.

Se ven el número y el enlace, pero no hay estado en vivo inpost_enabled es falso o inpost_api_token está vacío, así que el proveedor se considera no disponible y la consulta se omite. Para transportistas distintos de InPost, DPD, DHL y Poczta Polska solo se construye el enlace, no hay consulta en vivo alguna.

“Actualizar seguimiento en vivo” no cambia nada El token ha caducado o no es válido, y la respuesta fallida deja el estado vacío. Pruébelo fuera de WordPress: curl -H "Authorization: Bearer {token}" https://api-shipx-pl.easypack24.net/v1/tracking/{numero}. Compruebe también que el número sea realmente un número de envío de ShipX.

Próximos pasos

Notificar problemas: GitHub Issues
Documentación de la API ShipX: https://docs.inpost24.com/

Esta página tiene únicamente carácter informativo y no constituye asesoramiento legal. Consulte con un abogado antes de la implementación. Polski for WooCommerce es software de código abierto (GPLv2) que se proporciona sin garantía.