Suivi Colis - Nouvelle beta suite changement API

Xav-74 · Août 29, 2024, 6:56

Hello à tous !

Me revoilà enfin reconnecté au nuage
Je viens donc de pousser la nouvelle beta !

Gros changement pour la bascule sur les API 17Track

→ Repassez bien sur les paramètres du plugin pour modifier les modifier (notamment la clé API 17Track). Petit changement également sur le tag #hour# qui devient #time# (je ne sais pas ce qui m’est passé par la tête ). Et une nouveauté que je vous laisse découvrir
PS : l’option langue (traduction des infos par 17Track) consomme 2 suivis pour un numéro de tracking. Attention donc à son utilisation. Et pour info, cela n’a rien changé pour moi sur mon colis test. A suivre donc
→ Je vous conseille fortement de supprimer vos colis et d’en créer de nouveau pour éviter les effets de bord avec la version précédente !
→ le bouton Synchroniser est remplacé par le bouton Enregistrement. C’est une étape obligatoire pour récupérer les infos du colis. C’est à partir de ce moment que le compteur des 100 suivis est décrémenté.
PS : la suppression d’un colis (qq soit la méthode) entraine également une requête pour désenregistrer le trackingID de 17Track. Si vous recréez par la suite un colis avec ce même numéro, il sera réenregistré et de nouveau comptabilisé dans le compteur. Attention donc lors de vos tests

Pour le reste, il faut vraiment tout retester car tout le code a été réécrit
Merci d’avance et à votre dispo si bug !!

Xav

OUARZA · Août 29, 2024, 8:00

Hello @Xav-74 ,
Un grand merci.
J’ai testé avec un colis et c’est parfait.
Par contre, je ne sais pas comment tu vas pouvoir gérer.
Avec mondial relay il faut saisir un code postal.

Mathieu

Ocbsd · Août 29, 2024, 8:03

Bonjour,
Je viens de faire la mise à jour sur ma machine test :

Top le lien pour la création de compte 17track super facile
Super d’avoir le quota des colis restants
La mise à jour est beaucoup plus rapide qu’avec Parcelsapp .

Après avoir utilisé le site, j’avais une appréhension sur l’efficacité, mais mes doutes sont dissipés (pour @OUARZA )

Par contre, lors de la création du colis, 17Track en a compté 2, à voir donc, je dois créer un deuxième colis dans la journée.

@Xav-74 : faites-vous un fils de discussion pour la nouvelle Bêta ?

Bonne Journée

Xav-74 · Août 29, 2024, 8:08

Je dois pouvoir rajouter ca !
Tu peux me pousser en MP les logs en debug du plugin quand tu ajoute ce colis ?

Xav-74 · Août 29, 2024, 8:10

Hello @Ocbsd

Je confirme ! C’est sans commune mesure !

Tu as du forcer la langue dans la partie configuration. Laisse sur l’option par défaut et regarde si ca te convient Pas vu de différence pour moi !

On va suivre la beta sur ce sujet

Xav

Ocbsd · Août 29, 2024, 8:17

Exact ! j’ai mis en francais

Xav-74 · Août 29, 2024, 8:31

forcer la trad décomptabilise 2 suivis !
Et chez moi ça marche pas !
Le paramétrage se fait au moment de l’action « Enregistrement » donc re clique sur le bouton de l’équipement pour prise en compte

Ocbsd · Août 29, 2024, 8:51

Je viens de faire un essai avec un colis venant de Chine :
Le transporteur est Cainiao :
Avec la version stable :

Avec la bêta :

le log :

[2024-08-29 10:44:14] DEBUG  : ┌─Command execution : refresh
[2024-08-29 10:44:14] DEBUG  : | Parcel trackingId : LP00674063310927 - Language : en
[2024-08-29 10:44:15] DEBUG  : | Result getTrackingResult() request : [200] - {"code":0,"data":{"accepted":[],"rejected":[{"number":"LP00674063310927","error":{"code":-18019902,"message":"The tracking number 'LP00674063310927' does not register, please register first."}}]}}
[2024-08-29 10:44:15] DEBUG  : └─End of parcel info refresh : [200]

Il faut donc prévoir un transporteur par defaut pour le colis.

Le site web en complétant le transporteur (Aliexpress et non Cainiao)

Xav-74 · Août 29, 2024, 8:53

Je peux avoir le log de la partie registration ?

Ocbsd · Août 29, 2024, 9:03

Voilà je l’ai recréé, pour avoir un log tout propre !

[2024-08-29 10:57:40] DEBUG  : Add command Statut colis (LogicalId : status)
[2024-08-29 10:57:40] DEBUG  : Add command Transporteur (LogicalId : carrier)
[2024-08-29 10:57:40] DEBUG  : Add command Origine (LogicalId : origin)
[2024-08-29 10:57:40] DEBUG  : Add command Destination (LogicalId : destination)
[2024-08-29 10:57:40] DEBUG  : Add command Etats (LogicalId : states)
[2024-08-29 10:57:40] DEBUG  : Add command Dernier évènement (LogicalId : lastEvent)
[2024-08-29 10:57:40] DEBUG  : Add command Dernier état (LogicalId : lastState)
[2024-08-29 10:57:40] DEBUG  : Add command Date de livraison (LogicalId : deliveryDate)
[2024-08-29 10:57:40] DEBUG  : Add command Rafraichir (LogicalId : refresh)
[2024-08-29 10:57:59] DEBUG  : ┌─Command execution : registerParcel
[2024-08-29 10:57:59] DEBUG  : | Parcel trackingId : LP00674063310927 - Language : en
[2024-08-29 10:57:59] DEBUG  : | Result registerTrackingId() request : [200] - {"code":0,"data":{"accepted":[{"origin":3,"number":"LP00674063310927","email":null,"lang":"en","carrier":190271}],"rejected":[]}}
[2024-08-29 10:58:00] DEBUG  : | Result getTrackingResult() request : [200] - {"code":0,"data":{"accepted":[{"number":"LP00674063310927","carrier":190271,"param":null,"tag":null,"track_info":{"shipping_info":{"shipper_address":{"country":null,"state":null,"city":null,"street":null,"postal_code":null,"coordinates":{"longitude":null,"latitude":null}},"recipient_address":{"country":null,"state":null,"city":null,"street":null,"postal_code":null,"coordinates":{"longitude":null,"latitude":null}}},"latest_status":{"status":"NotFound","sub_status":"NotFound_Other","sub_status_descr":null},"latest_event":null,"time_metrics":{"days_after_order":0,"days_of_transit":0,"days_of_transit_done":0,"days_after_last_update":0,"estimated_delivery_date":{"source":null,"from":null,"to":null}},"milestone":[],"misc_info":{"risk_factor":0,"service_type":null,"weight_raw":null,"weight_kg":null,"pieces":null,"dimensions":null,"customer_number":null,"reference_number":null,"local_number":null,"local_provider":null,"local_key":0},"tracking":{"providers_hash":0,"providers":[{"provider":{"key":190271,"name":"Cainiao","alias":"Cainiao 菜鸟","tel":"","homepage":"https://www.cainiao.com/","country":"CN"},"provider_lang":null,"service_type":null,"latest_sync_status":"Success","latest_sync_time":"2024-08-29T08:53:59Z","events_hash":0,"events":[]}]}}}],"rejected":[]}}
[2024-08-29 10:58:00] DEBUG  : └─End of parcel registration : [200]

Sinon j’ai complété ma réponse précédente, il donne comme transporteur Cainiao alors que le transporteur est Aliexpress, par contre il y a du mieux car lors de la création il trouve un transporteur (Cainiao)

Xav-74 · Août 29, 2024, 9:12

Merci pour les infos !

C’est bizarre ca ! Sur le site avec carrier auto, il trouve mais pas via les API.
Bon je vais rajouter un liste de choix pour forcer le transporteur
Par contre y aura 2300 ligne
Je vais les extraire depuis le json que fournit 17Track ! A voir si c’est mieux

lvdtime · Août 29, 2024, 10:39

Bonjour à tous et merci pour ce travail
Il y a le même souci de code postal pour GLS, sans le code postal il ne trouve rien
Bon courage et bonne journée

Xav-74 · Août 29, 2024, 10:41

Hello @lvdtime,

Merci
Possible d’avoir les logs de l’enregistrement en MP ?
Je vais rajouter ça aussi du coup

lvdtime · Août 29, 2024, 11:23

[2024-08-29 13:20:35] DEBUG : Add command Statut colis (LogicalId : status)
[2024-08-29 13:20:35] DEBUG : Add command Transporteur (LogicalId : carrier)
[2024-08-29 13:20:35] DEBUG : Add command Origine (LogicalId : origin)
[2024-08-29 13:20:35] DEBUG : Add command Destination (LogicalId : destination)
[2024-08-29 13:20:35] DEBUG : Add command Etats (LogicalId : states)
[2024-08-29 13:20:35] DEBUG : Add command Dernier évènement (LogicalId : lastEvent)
[2024-08-29 13:20:35] DEBUG : Add command Dernier état (LogicalId : lastState)
[2024-08-29 13:20:35] DEBUG : Add command Date de livraison (LogicalId : deliveryDate)
[2024-08-29 13:20:35] DEBUG : Add command Rafraichir (LogicalId : refresh)
[2024-08-29 13:20:41] DEBUG : ┌─Command execution : registerParcel
[2024-08-29 13:20:41] DEBUG : | Parcel trackingId : XXX- Language : fr
[2024-08-29 13:20:43] DEBUG : | Result registerTrackingId() request : [200] - {« code »:0,« data »:{« accepted »:,« rejected »:[{« number »:« XXX »,« error »:{« code »:-18010019,« message »:« The ‹ param › field is required for this tracking. Please provide postal code. Example: ‹ Postal code ›. »}}]}}
[2024-08-29 13:20:43] DEBUG : | Result getTrackingResult() request : [200] - {« code »:0,« data »:{« accepted »:,« rejected »:[{« number »:« XXX »,« error »:{« code »:-18019902,« message »:« The tracking number ‹ XXX › does not register, please register first. »}}]}}
[2024-08-29 13:20:44] DEBUG : └─End of parcel registration : [200]

Xav-74 · Août 29, 2024, 12:39

Bon alors j’ai réussi à avoir les infos pour @OUARZA (même si elles sont vide pour le moment) et pour @Ocbsd avec la saisie du code transporteur !
Reste à coder tout cela proprement

@lvdtime : accepterais-tu de me communiquer en MP le tracking ID, le transporteur et le code postal pour que je puisse tester avec ce paramètre ? Merci

J’essaie de faire ca d’ici demain soir

Xav

lvdtime · Août 29, 2024, 4:03

Hello
Autre exemple de colis en défaut sur la PostNL :

> Citation
[2024-08-29 17:59:54] DEBUG  : ┌─Command execution : registerParcel
[2024-08-29 17:59:54] DEBUG  : | Parcel trackingId : XXX- Language : fr
[2024-08-29 17:59:56] DEBUG  : | Result registerTrackingId() request : [200] - {"code":0,"data":{"accepted":[],"rejected":[{"number":"XXX","error":{"code":-18010018,"message":"The 'param' field is required for this tracking. Please provide Alpha-2 country code and postal code. Example: 'FR-1000 AA'."}}]}}
[2024-08-29 17:59:57] DEBUG  : | Result getTrackingResult() request : [200] - {"code":0,"data":{"accepted":[],"rejected":[{"number":"XXX","error":{"code":-18019902,"message":"The tracking number 'XXX' does not register, please register first."}}]}}
[2024-08-29 17:59:57] DEBUG  : └─End of parcel registration : [200]

Xav-74 · Août 29, 2024, 7:29

@Ocbsd tu pourrais stp me donner le code postal pour ce colis ? (en MP si tu préfères)
Merci

Xav-74 · Août 29, 2024, 8:33

Bon résultat des courses (ceux qui m’ont donné les N° suivi en clair, ils sont en clair ci-dessous, pour les autres je masque)

@Ocbsd :

@lvdtime :

@OUARZA :

Il me manque le code postal !

Ca fonctionne pas trop mal. Pour ce faire j’ai rajouté sur la page des équipements :

Dans la partie « Transporteur », vous retrouvez la liste des 2300 transporteurs dispo avec 17Track. Si vous tapez les premières lettres, cela affine la recherche. Cette liste est extraite de leur fichier json. Il sera donc facile de la mettre à jour.
Dans la partie « Paramètre optionnel », il conviendra de renseigner la chaine de caractère attendu pour certains transporteurs. Attention, ce n’est pas forcément un code postal. Ex pour le colis de @lvdtime, il est de la forme FR-12345. Raison pour laquelle le code postal par défaut dans la config du plugin ne sera pas de retour.
D’autant plus que si vous ajouter un code postal alors que ce n’est pas attendu, les infos ne remontent pas.

Il y a également le bouton « Mise à jour » qui a fait son apparition. Comme son nom l’indique il permet de mettre à jour l’enregistrement. Si le colis a déjà été enregistré sans paramètre par exemple, un nouvel enregistrement génère une erreur. Il faut obligatoirement passer par la mise à jour !

Je conseille d’ailleurs de tester sans transporteur et sans paramètre au départ. Et en fonction des messages d’erreur du logs, vous pouvez ajuster ensuite les paramètres un à un.

: ces 2 boutons déclenchent à la suite des enregistrements, un refresh auto des données. J’ai du paramétrer une pause de 10s entre les requêtes car il arrive parfois que l’on recoive un message « No tracking information at this time ». Si c’est qd même le cas malgré la pause, il faudra attendre qq minutes avant de relancer un refresh manuel

Je vais pousser la beta sur le market d’ici 30min ! A vos tests et surtout retours

Ocbsd · Août 30, 2024, 5:59

Bonjour, mon code postal est 76150

Ocbsd · Août 30, 2024, 6:06

Ok, le suivi fonctionne, sinon petite question, la sauvegarde de l’équipement lance t’il l’enregistrement dans 17track ? Sinon est-il possible de le faire automatiquement ?