PHPackages piteurstudio/courierdz - 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. [API Development](/categories/api) 4. / 5. piteurstudio/courierdz ActiveLibrary[API Development](/categories/api) piteurstudio/courierdz ====================== CourierDZ is a PHP client for integrating multiple Algerian shipping providers, including ZR Express, Procolis, Yalidine, Ecotrack, Mayesto Delivery, and more, offering seamless order and tracking management. v1.0.1(9mo ago)69880↓83.3%20[3 PRs](https://github.com/PiteurStudio/CourierDZ/pulls)MITPHPPHP ^8.2CI passing Since Dec 13Pushed 1mo ago4 watchersCompare [ Source](https://github.com/PiteurStudio/CourierDZ)[ Packagist](https://packagist.org/packages/piteurstudio/courierdz)[ Docs](https://github.com/PiteurStudio/CourierDZ)[ RSS](/packages/piteurstudio-courierdz/feed)WikiDiscussions main Synced 3w ago READMEChangelog (8)Dependencies (9)Versions (18)Used By (0) [![CourierDZ Banner](https://camo.githubusercontent.com/54ee9079e40846f7aa3525e5edfd6b394f07bf407db514467c9319a22b13e674/68747470733a2f2f62616e6e6572732e6265796f6e64636f2e64652f436f7572696572445a2e706e673f7468656d653d6c69676874267061636b6167654d616e616765723d636f6d706f7365722b72657175697265267061636b6167654e616d653d70697465757273747564696f253246636f7572696572647a267061747465726e3d617263686974656374267374796c653d7374796c655f31266465736372697074696f6e3d53696d706c6966792b7468652b696e746567726174696f6e2b6f662b416c67657269616e2b7368697070696e672b70726f7669646572732b696e746f2b796f75722b6170706c69636174696f6e73266d643d312673686f7757617465726d61726b3d3126666f6e7453697a653d313030707826696d616765733d68747470732533412532462532467777772e7068702e6e6574253246696d616765732532466c6f676f732532466e65772d7068702d6c6f676f2e737667267769647468733d33303026686569676874733d6175746f)](https://camo.githubusercontent.com/54ee9079e40846f7aa3525e5edfd6b394f07bf407db514467c9319a22b13e674/68747470733a2f2f62616e6e6572732e6265796f6e64636f2e64652f436f7572696572445a2e706e673f7468656d653d6c69676874267061636b6167654d616e616765723d636f6d706f7365722b72657175697265267061636b6167654e616d653d70697465757273747564696f253246636f7572696572647a267061747465726e3d617263686974656374267374796c653d7374796c655f31266465736372697074696f6e3d53696d706c6966792b7468652b696e746567726174696f6e2b6f662b416c67657269616e2b7368697070696e672b70726f7669646572732b696e746f2b796f75722b6170706c69636174696f6e73266d643d312673686f7757617465726d61726b3d3126666f6e7453697a653d313030707826696d616765733d68747470732533412532462532467777772e7068702e6e6574253246696d616765732532466c6f676f732532466e65772d7068702d6c6f676f2e737667267769647468733d33303026686569676874733d6175746f) [![PHP 8.2](https://camo.githubusercontent.com/c4c6076a6ff0da58c126ae0826527b7874bd8be313b40f58dde656952d116bf5/68747470733a2f2f706f7365722e707567782e6f72672f70697465757273747564696f2f436f7572696572445a2f726571756972652f706870)](https://php.net) [![Latest Version on Packagist](https://camo.githubusercontent.com/53779a61e3a2dd28c6bf0fdc48ceab01c024ec6722007343b8d767e4436a15d7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f70697465757273747564696f2f636f7572696572647a2e737667)](https://packagist.org/packages/piteurstudio/courierdz) [![Tests](https://camo.githubusercontent.com/97c671e6928b9658ad94a4f91ca6b5d5e68682e1b13e4eb9762a6ddfc8befe2b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f70697465757273747564696f2f636f7572696572647a2f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473)](https://github.com/piteurstudio/courierdz/actions/workflows/run-tests.yml) [![Coverage Status](https://camo.githubusercontent.com/2f87e9929f7dabd2bafa9e477580a1d633a357e5e45cf933a4b9e28c9ba06cc9/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f50697465757253747564696f2f436f7572696572445a2f62616467652e7376673f6272616e63683d6d61696e)](https://coveralls.io/github/PiteurStudio/CourierDZ?branch=main) [![Total Downloads](https://camo.githubusercontent.com/652ccdfdc01532194f39f1cfcd089e9275402b9a0f02d2b5cd407b1e63d3d8bd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f70697465757273747564696f2f636f7572696572647a2e737667)](https://packagist.org/packages/piteurstudio/courierdz) [![Supported providers](https://camo.githubusercontent.com/1bc294bde26e24c4189f6e0b1bbc80354c25ddffa7ae61d94771d9da1e54eaee/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f537570706f727465645f70726f7669646572732d32362d626c7565)](https://github.com/PiteurStudio/CourierDZ/tree/main/src/ShippingProviders) CourierDZ ========= [](#courierdz) CourierDZ is a PHP client designed to simplify the integration of Algerian shipping providers into your applications. Whether you're working on an e-commerce platform or logistics solution, and provides a unified and easy-to-use interface for managing orders, tracking shipments. Features -------- [](#features) - **Multi-Provider Support**: Integrate with popular Algerian shipping services such as: - `Yalidine` , `Yalitec` - `Mayesto Delivery` - `Procolis` ( `Zr Express` ) - `Ecotrack` ( `DHD` , `Conexlog/UPS` and many more... ) - **Unified API**: A consistent interface to interact with all supported providers. - **Order Management**: Create, update, and cancel shipping orders effortlessly. - **Extensible Design**: Easily add new providers or customize existing ones. Requirements ------------ [](#requirements) > - PHP 8.2 or higher > - cURL extension Installation ------------ [](#installation) You can install the package via composer: ``` composer require piteurstudio/courierdz ``` ### Current Supported Methods [](#current-supported-methods) **Provider/Feature****Yalidine****Procolis****Ecotrack****Maystro Delivery**testCredentials✅✅✅✅getRates❌✅✅❔getRates(null , $to\_wilaya\_id)❌✅✅❌getRates($from\_wilaya\_id , $to\_wilaya\_id)✅❌❌❌getCreateValidationRules✅✅✅✅createOrder✅✅✅✅getOrder✅✅❔✅updateOrder❔❔❔❔cancelOrder❔❔❔❔orderLabel✅❌✅✅createProduct❌❌❌✅- ✅ Implemented - ❌ Unsupported by the provider - ⌛ In Progress - ❔ Not implemented yet ( unknown if supported or not ) *Note : Unsupported method can be implemented in the future by using user and password instead of API.* Usage ----- [](#usage) ### Initialize the shipping provider and set your credentials. [](#initialize-the-shipping-provider-and-set-your-credentials) ``` // Ecotrack providers $credentials = ['token' => '****']; // Procolis providers ( ZREXPRESS ) $credentials = ['id' => '****', 'token' => '****']; // Yalidine providers $credentials = ['token' => '****', 'key' => '****']; // Mayestro Delivery providers $credentials = ['token' => '****']; $shipping_provider = CourierDZ::provider(ShippingProvider::ZREXPRESS, $credentials); // or $shipping_provider = new XyzProvider($credentials); // where Xyz is the provider name ``` ### Create a parcel ( order ) [](#create-a-parcel--order-) ``` /* * return array of provider response * Note : results may vary depending on the provider */ $result = $shipping_provider->createOrder([ 'Tracking' => 'CourierDz-123', 'TypeLivraison' => 1, 'TypeColis' => 0, 'Confrimee' => 0, 'Client' => 'Mohamed', 'MobileA' => '0990909090', 'MobileB' => '0880808080', 'Adresse' => 'Rue 39', 'IDWilaya' => "09", 'Commune' => 'Maraval', 'Total' => "2000", 'Note' => 'test test', 'TProduit' => 'Article1', "id_Externe" => 'CourierDz-123', "Source" => 'CourierDz', ])) ``` To know the required fields for the order creation depend on the provider requirements, use ``` $rules = $shipping_provider->getCreateOrderValidationRules(); ``` ### Retrieving a label ( order ) [](#retrieving-a-label--order-) ``` /* * return array of label data ( base64 encoded string or url ) */ $label = $shipping_provider->orderLabel('CourierDz-123'); ``` ***Output :*** ``` [ [type] => 'pdf' [data] => 'base64 encoded string' ] -- OR -- [ [type] => 'url' [url] => 'https://example.com/label.pdf' ] ``` --- #### **More examples and methods can be found in the [DOCUMENTATION.md](DOCUMENTATION.md) file.** [](#more-examples-and-methods-can-be-found-in-the-documentationmd-file) Contribution ------------ [](#contribution) We welcome all contributions! Please follow these guidelines: 1. Document any changes in behavior — ensure `README.md` updated accordingly. 2. Write tests to cover any new functionality. 3. Please ensure that your pull request passes all tests. ### Testing [](#testing) ``` composer test ``` Issues & Suggesting Features -------------------------------- [](#issues--suggesting-features) If you encounter any issues or have ideas for new features, please [open an issue](https://github.com/PiteurStudio/CourierDZ/issues/new/choose). We appreciate your feedback and contributions to help improve this package. Provider not yet included? -------------------------- [](#provider-not-yet-included) [Request Provider](https://github.com/PiteurStudio/CourierDZ/discussions/new?category=ideas) and provide the following information: - Provider Name - Provider Website - API Documentation - Any other relevant information ### Future Planned Features [](#future-planned-features) - Add more methods - Add more tests - Add more examples - Add more documentation - Add more shipping providers ( eg : [Elogistia](https://documenter.getpostman.com/view/21600448/2s8YzP14j2), E-Com Delivery, Abex Express , Flash Delivery, E-Send , WIN DELIVERY , COLILOG EXPRESS, GODYMA EXPRESS , LETS GO DELIVERY, LEOPARD EXPRESS , MR LIVREUR, EL AMANA DELIVERY, ALLO LIVRAISON, COLIRELI , Yalitec , [GuepEX](https://guepex.app/app/login.php) , [Zimou Express](https://zimou-express.app/app/login.php)) Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Nassim](https://github.com/n4ss1m) / [Piteur Studio](https://github.com/PiteurStudio) - [All Contributors](../../contributors) Disclaimer ---------- [](#disclaimer) - This package is not officially affiliated with or endorsed by any shipping providers. - Names, logos, and trademarks are the property of their respective owners. - Before using any shipping provider, ensure it is authorized by **ARPCE**. ( Check the approved list [here](https://www.arpce.dz/ar/service/post-sd#operators). ) - This package may include providers not listed by ARPCE; verify their compliance before use. ⭐ Support --------- [](#-support) If you find this package helpful, please consider giving it a ⭐ on [GitHub](https://github.com/PiteurStudio/CourierDZ) ! Your support encourages us to keep improving the project. Thank you! [![Stargazers repo roster for @PiteurStudio/CourierDZ](https://camo.githubusercontent.com/af0a24276115e22e29b10912435fda7898fc3a2e69715562ff46484bf8d6c7a3/68747470733a2f2f7265706f726f737465722e636f6d2f73746172732f6461726b2f50697465757253747564696f2f436f7572696572445a)](https://github.com/PiteurStudio/CourierDZ/stargazers) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 49 — FairBetter than 94% of packages Maintenance75 Regular maintenance activity Popularity32 Limited adoption so far Community17 Small or concentrated contributor base Maturity60 Established project with proven stability Bus Factor1 Top contributor holds 92.9% 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 ~23 days Recently: every ~66 days Total 13 Last Release 274d ago Major Versions v0.2.1 → v1.0.02025-02-24 ### Community Maintainers ![](https://www.gravatar.com/avatar/5a296ccb9da91508036477d715ab4295a2b8fc47a8c0f468733cac6691995d9a?d=identicon)[Nassim](/maintainers/Nassim) --- Top Contributors [![n4ss1m](https://avatars.githubusercontent.com/u/1750845?v=4)](https://github.com/n4ss1m "n4ss1m (91 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (3 commits)") --- Tags algeriaecotrackmayesto-deliveryphpprocolisshippingyalidinezr-expressapitrackingshippingAlgeriaPiteurStudioYalidineProcolisEcotrackzr-expresscourierdzMayesto Delivery ### Code Quality TestsPest Static AnalysisPHPStan, Rector Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/piteurstudio-courierdz/health.svg) ``` [![Health](https://phpackages.com/badges/piteurstudio-courierdz/health.svg)](https://phpackages.com/packages/piteurstudio-courierdz) ``` ### Alternatives [gabrielbull/ups-api PHP UPS API 4582.4M10](/packages/gabrielbull-ups-api)[tencentcloud/tencentcloud-sdk-php TencentCloudApi php sdk 3661.2M46](/packages/tencentcloud-tencentcloud-sdk-php)[easypost/easypost-php EasyPost Shipping API Client Library for PHP 1743.3M5](/packages/easypost-easypost-php)[gavroche/ups-api PHP UPS API 45813.3k](/packages/gavroche-ups-api)[files.com/files-php-sdk Files.com PHP SDK 2478.1k](/packages/filescom-files-php-sdk)[jasara/php-amzn-selling-partner-api A fluent interface for Amazon's Selling Partner API in PHP 1348.1k1](/packages/jasara-php-amzn-selling-partner-api) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)