PHPackages ladromelaboratoire/chronopostws - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [HTTP & Networking](/categories/http) 4. / 5. ladromelaboratoire/chronopostws ActiveLibrary[HTTP & Networking](/categories/http) ladromelaboratoire/chronopostws =============================== Chronopost SOAP web-service module for various integrations 0.0.13(3y ago)3172BSD-3-ClausePHPPHP >=7.3 Since Feb 2Pushed 3y ago2 watchersCompare [ Source](https://github.com/ladromelaboratoire/ChronopostWS)[ Packagist](https://packagist.org/packages/ladromelaboratoire/chronopostws)[ RSS](/packages/ladromelaboratoire-chronopostws/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (5)DependenciesVersions (6)Used By (0) ChronopostWS ============ [](#chronopostws) Ce module PHP propose une intégration au WebServices de Chronopost. L'objectif est de pouvoir générer des étiquettes de transport et de les gérer. Techniquement le module reçoit un tableau correspondants aux étiquettes à créer. Ce tableau est enrichi sous forme d'un objet en fonction des requêtes exéécutées. Fonctionnement choisi --------------------- [](#fonctionnement-choisi) Tous les appels sont considérés multi colis et multi format d'étiquettes. Afin d'avoir un fonctionnement uniforme, toutes les étiquettes sont réservées et récupérées dans un second temps. Par construction du web-service, toutes les étiquettes sont envoyées dans un seul document. Il n'est donc pas possible d'attacher, dans ce cas là, un unique document au numéro de suivi. Les services Chronopost ciblés : ``` ShippingServices - shippingMultiParcelV4 - getReservedSkybillWithTypeAndMode TrackingServices - searchPOD - cancelSkybill - trackSkybillV2 QuickcostServices - quickCost ``` Attention, le fonctionnement du module répond à un besoin. Les uses-cases doivent être étudiés pour définir la stratégie d'appel au module qui se contente de faire des vérifications basiques. Il ne peut pas prendre en compte les spécificités du contrat Chronopost de chaque utilisateur (fuiltrer les produits et services, les coûts additionnels, le fonctionnement douanier). Fonctions supportées -------------------- [](#fonctions-supportées) Seule la partie Shipping est implémentée et fonctionnelle pour le moment. - Réservation d'étiquettes de transport - 1 destinataire, 1 expéditeur, N colis - N destinataires, N expéditeurs, N colis - N destinataires, 1 expéditeur, N colis (sauf en mode A/R) - Mode aller / retour - Etiquettes multi formats (PDF, ZPL, ...) - Validation du format de chaque donnée en fonction de la documentation Chronopost - Contrôle général de cohérence (Readiness For Launch) - Enrichissement de l'objet shipment avec les réponses du web-service - Enregistrement sur disque des étiquettes - Tracking - Annulation d'une lettre de transport - Mode debug complet (dump des objets, dump des requêtes et réponses) - Génèrera des exceptions PHP si l'application fonctionne de cette manière. Non supporté ou à optimiser (à ce jour) --------------------------------------- [](#non-supporté-ou-à-optimiser-à-ce-jour) - Shipment - Classe de détermination du nom du pays normalisé et de contrôle de la cohérence du code postal en fonction du code pays - Trouver un moyen plus élégant de faire des étiquettes aller / retour - Gérer le cas des déclarations douane en multi colis - Tracking - A terminer - Récupération des preuves de livraison - Suivi d'un colis - Quickcost - A terminer - Récupération du coût d'un envoi - Optimisation des classes et des objets - Ecrire une vraie documentation - Introduire PHPUnit Usage ----- [](#usage) ### Pour tester [](#pour-tester) Utiliser `composer update` pour déclarer le `namespace` et utilisez directement les scripts du dossier `./tests`. Le dossier `./tests/logs` contient 3 exemples d'appels réussis en mode "Debug". Les fichiers `.json` sont les dumps des objets, les fichiers `.xml` sont les appels et réponses au web-service. Les autres fichiers sont les étiquettes. ### Pour intégrer [](#pour-intégrer) Tout repose sur composer. Tous les objets sont appelables manuellement. Néanmoins, il est bien plus facile de charger un tableau de données préparé ailleurs. La lecture de la documentation Chronopost est impérative pour comprendre ce qu'il faut fournir (la liste est longue) et la signification de certains paramètres. La fonction `RFLCheck()` de chaque object s'assure de la cohérence apparente avant appel du web-service. Notez qu'il existe des paramètres dits optionnels dans la documentation mais bloquants lors des appels si absents. La convention est que le tableau associatif donné en entrée utilise le nom exact des propriétés des objets attendu par le webService. Chaque élément passera par un *"setter"* qui contrôlera sa forme aussi précisément que possible. Les expressions régulières sont massivement utilisées (voir la classe `wsregex.php`). Le dossier `/src/wsdata` contient l'ensemble des classes manipulant les objets unitaires à transettre au webservice. Le dossier `/src/utils` contient des classes annexes Le dossier `/src/exceptions` contient les classes de gestion des exception Les 3 classes principales sont: - `/src/chronopost.php` qui gère les appels et les réponses au/du web-service - `/src/shipment.php` qui gère l'objet d'appel au service `ShipphingService` - `/src/tracking.php` qui gère les objets d'appel au service `TrackingService` - `/src/quickcost.php` qui gère les objets d'appel au service `QuickcostService` ### Note aux développeurs [](#note-aux-développeurs) Le web-service est chatouilleux sur les données envoyées. `RFLCheck()` tient compte de ce qui a été vu lors du développement. Néanmoins, d'autres particularités peuvent exister. L'erreur `29` est caractéristique d'un problème de données ou de la forme de l'appel SOAP. Les exemples fournis ont été testés fonctionnels. Inspirez vous en. Contribuer ---------- [](#contribuer) La contribution est la bienvenue sous forme de PR documentée unitaire ou de remontée de bug documentée également. Les demandes fonctionnelles ne seront traitées que si nous en avons le temps et si cela a un sens pour nous. Préférez les PRs. Disclaimer ---------- [](#disclaimer) Ce module est fourni tel qu'il existe. Des changements peuvent apparaître chez Chronopost ou ne pas correspondre à vos règles d'usage métier. Bien que ce module se veuille générique, tous les cas ne sont pas intégrables. Avant de vous appuyer dessus, il est vivement recommandé de le tester. L'ajout de fonctionnalités peut être proposé par la contribution. ### Health Score 21 — LowBetter than 19% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity11 Limited adoption so far Community11 Small or concentrated contributor base Maturity38 Early-stage or recently created project Bus Factor1 Top contributor holds 60% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~92 days Total 5 Last Release 1191d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/aa34622d5727ab942aa6268f58f7b913c43b4b6ccfcae26211c7f7dd6a8646d4?d=identicon)[ladromelaboratoire](/maintainers/ladromelaboratoire) --- Top Contributors [![ladromelaboratoire](https://avatars.githubusercontent.com/u/45164229?v=4)](https://github.com/ladromelaboratoire "ladromelaboratoire (3 commits)")[![noec764](https://avatars.githubusercontent.com/u/58433943?v=4)](https://github.com/noec764 "noec764 (2 commits)") --- Tags chronopostcomposer-packagesoap-web-services ### Embed Badge ![Health badge](/badges/ladromelaboratoire-chronopostws/health.svg) ``` [![Health](https://phpackages.com/badges/ladromelaboratoire-chronopostws/health.svg)](https://phpackages.com/packages/ladromelaboratoire-chronopostws) ``` ### Alternatives [friendsofsymfony/rest-bundle This Bundle provides various tools to rapidly develop RESTful API's with Symfony 2.8k73.3M319](/packages/friendsofsymfony-rest-bundle)[php-http/discovery Finds and installs PSR-7, PSR-17, PSR-18 and HTTPlug implementations 1.3k309.5M1.2k](/packages/php-http-discovery)[nyholm/psr7 A fast PHP7 implementation of PSR-7 1.3k235.4M2.4k](/packages/nyholm-psr7)[pusher/pusher-php-server Library for interacting with the Pusher REST API 1.5k94.8M293](/packages/pusher-pusher-php-server)[spatie/crawler Crawl all internal links found on a website 2.8k16.3M52](/packages/spatie-crawler)[react/http Event-driven, streaming HTTP client and server implementation for ReactPHP 78126.4M414](/packages/react-http) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)