Integración externa - Seguimiento de envíos internacionales (17TRACK, DHL)

cover-colis

¡Hola a todos!

La integración de La Poste (Intégration externe - La Poste (suivi de colis)) sigue los paquetes de La Poste, Colissimo y Chronopost… pero nuestros paquetes también pasan por UPS, DPD, GLS, Mondial Relay, o llegan de China después de tres semanas de viaje. Aquí está su complemento para todo lo demás, incluido lo internacional. @ruegerth, pediste DHL y los correos austriacos y suizos: esto es para ti ^^

Qué hace

  • Un dispositivo por paquete, con un estado común a todos los transportistas: registrado, en tránsito, en entrega, para recoger, problema, entregado. Y también el último paso con el texto del transportista, el lugar, la fecha, el transportista y la fecha de entrega prevista.
  • Tres activadores: « En proceso de entrega », « Entregado » y « El paquete requiere su atención » (para recoger en punto de recogida, o problema), cada uno filtrado en un paquete específico.
  • Tres acciones de escena: seguir un paquete (incluso a partir del objeto de un correo electrónico), dejar de seguirlo y leer el estado de mis paquetes.
  • Un widget « Mis paquetes », que muestra primero los que te esperan; un toque abre el historial y el enlace de seguimiento.
  • Un paquete entregado se archiva automáticamente después de 7 días (ajustable).
  • En francés, inglés, alemán y español.

Quién usa qué: los números DHL y Deutsche Post pasan por la API oficial de DHL. Todo lo demás pasa por 17TRACK, que reconoce el transportista a partir del número: UPS, FedEx, USPS, GLS, DPD, Royal Mail, los envíos de China… y los correos nacionales, incluidos el correo austriaco y el correo suizo. UPS, FedEx y USPS tienen sus propias API, pero requieren una cuenta profesional: 17TRACK es mucho más simple. Para La Poste, Colissimo y Chronopost, mantén la integración de La Poste, que lee la API oficial.

La parte divertida

Paquete en proceso de entrega y nadie en casa → « El paquete de Amazon llega hoy »
Paquete para recoger en punto de recogida → recordatorio al día siguiente por la mañana con la dirección del último paso
Todas las mañanas a las 8 h → anuncio de voz « Tiene 2 paquetes en camino, uno de los cuales se entregará hoy »

Instalación

:warning: Gladys 5.1 mínimo.

Llega a la tienda en el próximo paso del indexador. Mientras tanto: Integraciones → Instalar desde GitHub, con GitHub - guim31/gladys-colis: International parcel tracking (17TRACK, DHL and more) for Gladys Assistant · GitHub

  1. Crea una clave gratuita 17TRACK en https://api.17track.net, una clave gratuita DHL en https://developer.dhl.com (API « Seguimiento de envíos - Unificado »), o ambas. Con solo la clave DHL, solo se siguen los paquetes DHL.
  2. Pega la o las claves en la configuración.
  3. Usa la acción « Seguir un paquete » con el número, luego añade el dispositivo del paquete en la pestaña Descubrimiento.

Pequeñas reservas honestas

  • Las ofertas gratuitas están limitadas, y la integración se ajusta a ellas: 240 consultas DHL por día como máximo, y un solo registro 17TRACK por paquete. En cuanto a 17TRACK, la oferta gratuita da un número limitado de registros de números (200 al principio según su ayuda, es un poco confuso); « Leer los paquetes ahora » muestra lo que queda.
  • 40 paquetes seguidos como máximo, y el dispositivo de un paquete archivado permanece en Gladys: debe eliminarse manualmente.
  • DHL no dice « en entrega » ni « para recoger »: la integración lo deduce a partir del texto del paso, en inglés y en alemán. Una formulación inusual puede quedar en « En tránsito ».
  • Los pasos conservan el texto del transportista, sin traducción.
  • Desarrollado sin cuenta 17TRACK ni DHL. Verifiqué desde mi casa que las verdaderas API de 17TRACK y DHL responden y rechazan adecuadamente una clave falsa, pero ningún paquete real ha sido seguido aún. Los correos austriacos y suizos pasan por 17TRACK y no han sido verificados uno por uno: @ruegerth, tus comentarios serán valiosos.

Como los anteriores, desarrollado con Claude Code. Proyecto independiente, no afiliado a 17TRACK, a DHL ni a los transportistas mencionados.

Depósito: GitHub - guim31/gladys-colis: International parcel tracking (17TRACK, DHL and more) for Gladys Assistant · GitHub