PHPackages                             cleverage/colissimo-bundle - 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 &amp; Networking](/categories/http)
4. /
5. cleverage/colissimo-bundle

ActiveSymfony-bundle[HTTP &amp; Networking](/categories/http)

cleverage/colissimo-bundle
==========================

Simple colissimo REST bundle for Symfony

v1.1.2(1y ago)87.0k↓40.6%4MITPHPPHP &gt;=7.4

Since Jul 20Pushed 1y ago3 watchersCompare

[ Source](https://github.com/cleverage/ColissimoBundle)[ Packagist](https://packagist.org/packages/cleverage/colissimo-bundle)[ Docs](https://github.com/cleverage/ColissimoBundle)[ RSS](/packages/cleverage-colissimo-bundle/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (5)Versions (5)Used By (0)

CleverAge/ColissimoBundle
=========================

[](#cleveragecolissimobundle)

Introduction
------------

[](#introduction)

This bundle provides services to access and consume the Colissimo WS.

### Services

[](#services)

- [Shipping](https://www.colissimo.entreprise.laposte.fr/sites/default/files/2022-04/DT_Flexibilite_Expedition_Web_Service_Affranchissement_202204_FR.pdf)
- [Pickup points](https://www.colissimo.entreprise.laposte.fr/sites/default/files/2021-10/WebService-points-retrait_FR.pdf)
- [Tracking](https://www.colissimo.entreprise.laposte.fr/sites/default/files/2021-08/CDC_WebServiceTrackingTL-v2.1_FR.pdf)

### Requirements

[](#requirements)

- Php &gt;= 7.4
- Symfony 4, 5 or 6

Installation
------------

[](#installation)

### Pretty simple with [Composer](http://packagist.org), run

[](#pretty-simple-with-composer-run)

```
composer require cleverage/colissimo-bundle
```

### Register bundle inside your application :

[](#register-bundle-inside-your-application-)

```
// config/bundles.php
CleverAge\ColissimoBundle\CleverAgeColissimoBundle::class => ['all' => true],
```

### Configuration example :

[](#configuration-example-)

Inside `config/packages/cleverage_colissimo.yaml`

```
clever_age_colissimo:
  testModeEnabled: true
  auth:
    contractNumber: '22020'
    password: 'password'
  letter:
    service:
      commercialName: 'CommercialName'
    sender:
      companyName: 'CompanyName'
      line0: null
      line1: null
      line2: '9 rue André darbon'
      line3: null
      countryCode: 'FR'
      zipCode: '33300'
      city: 'Bordeaux'
```

Usage examples :
----------------

[](#usage-examples-)

### Get pickup points

[](#get-pickup-points)

```
class PickupPointsController extends AbstractController
{
    private PickupPointsService $pickupPointsService;

    public function __construct(
        PickupPointsService $pickupPointsService
    ) {
        $this->pickupPointsService = $pickupPointsService;
    }

    public function index()
    {
        $searchModel = new PickupPointsSearchModel(
            '33300',
            'Bordeaux',
            'FR',
            '18/07/2022',
        );

        // Return an array of PickupPoint::class
        $pickupPoints = $this->pickupPointsService->call($searchModel);

        foreach ($pickupPoints as $pickupPoint) {
            // Get data by identifier.
            // @see PickupPoint to show all identifiers available.
            echo $pickupPoint->get('id'); // 987178
            echo $pickupPoint->get('name'); // ALEX TISSUS
        }

        // ....
    }
}
```

### Get pickup point by ID

[](#get-pickup-point-by-id)

```
class PickupPointByIdController extends AbstractController
{
    private PickupPointByIdService $pickupPointByIdService;

    public function __construct(
        PickupPointByIdService $pickupPointByIdService
    ) {
        $this->pickupPointByIdService = $pickupPointByIdService;
    }

    public function index()
    {
        $searchByIdModel = new PickupPointSearchByIdModel('987178', '18/07/2022');
        $pickupPoint = $this->pickupPointByIdService->call($searchByIdModel);

        if (null !== $pickupPoint) {
            echo $pickupPoint->get('name'); // ALEX TISSUS
        }

        // ....
    }
}
```

### Tracking

[](#tracking)

```
class TrackingController extends AbstractController
{
    private TrackingService $trackingService;

    public function __construct(
        TrackingService $trackingService
    ) {
        $this->trackingService = $trackingService;
    }

    public function index()
    {
        $trackingSearchModel = new TrackingSearchModel();
        $trackingSearchModel
            ->setLang('FR') // FR is set by default. This line is optionnal.
            ->setParcelNumber('ABNUABSASNLK');

        $tracking = $this->trackingService->call($trackingSearchModel);

        $tracking->getParcel();
        $tracking->getSteps();
        $tracking->getEvents();

        // @see TrackingResponse::class for usable getters.
        // ....
    }
}
```

### Shipping

[](#shipping)

```
class ShippingController extends AbstractController
{
    private ShippingService $shippingService;

    public function __construct(
        ShippingService $shippingService
    ) {
        $this->shippingService = $shippingService;
    }

    public function index()
    {
        $label = new Label();

        $outputFormat = new OutputFormat();
        $outputFormat->setOutputPrintingType(OutputPrintingType::ZPL_10x10_300dpi);

        $label->setOutputFormat($outputFormat);

        $letter = new Letter();

        $service = new Letter\Service();
        $service->setProductCode(ProductCode::DOM)
            ->setDepositDate((new \DateTime())->format('Y-d-m'))
            ->setOrderNumber('orderNumber');

        $letter->setService($service);

        $parcel = new Letter\Parcel();
        $parcel->setWeight(3);
        // If it's delivery on pickup point
        $parcel->setPickupLocationId('987178');

        $letter->setParcel($parcel);

        $addressee = new Letter\Addressee();
        $addressee->setEmail('test@clever-age.com')
            ->setFirstName('John')
            ->setLastName('Doe')
            ->setLine2('9 rue André darbon')
            ->setCity('Bordeaux')
            ->setCountryCode('FR')
            ->setZipCode('33300');

        $letter->setAddressee($addressee);

        $label->setLetter($letter);

        $shipping = $this->shippingService->call($label);

        echo $shipping->getParcelNumber(); // AIAOBOIABS
        echo $shipping->getPdfUrl(); // null or the pdf url.
        echo $shipping->getParcelNumberPartner(); // null or the parcel number partner.
        echo $shipping->getFields(); // Array of custom fields.

        // ...
    }
}
```

### Product inter

[](#product-inter)

```
class ProductInterController extends AbstractController
{
    private ProductInterService $productInterService;

    public function __construct(
        ProductInterService $productInterService
    ) {
        $this->productInterService = $productInterService;
    }

    public function index()
    {
        $productInter = new ProductInter();
        $productInter->setCountryCode('FR')
            ->setZipCode('33300')
            ->setProductCode(ProductCode::DOM)
            ->setInsurance(false) // Default false. Optional.
            ->setNonMachinable(false) // Default false. Optional.
            ->setReturnReceipt(false); // Default false. Optional.

        $response = $this->productInterService->call($productInter);

        $response->getProduct(); // Array of product codes.
        $response->getReturnTypeChoice(); // Array of return choice types.

        // ...
    }
}
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance43

Moderate activity, may be stable

Popularity31

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor3

3 contributors hold 50%+ of commits

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 ~314 days

Total

4

Last Release

455d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4d408c6ae2e5f73eff1f279b35eb21009d7ded0b4c1f97f8ca45dca4a21f3911?d=identicon)[Clever Age](/maintainers/Clever%20Age)

---

Top Contributors

[![QuentG](https://avatars.githubusercontent.com/u/33687186?v=4)](https://github.com/QuentG "QuentG (3 commits)")[![ernoufv](https://avatars.githubusercontent.com/u/8958997?v=4)](https://github.com/ernoufv "ernoufv (3 commits)")[![tpeyrou-clever](https://avatars.githubusercontent.com/u/195278181?v=4)](https://github.com/tpeyrou-clever "tpeyrou-clever (2 commits)")[![vernouf-clever](https://avatars.githubusercontent.com/u/70691518?v=4)](https://github.com/vernouf-clever "vernouf-clever (2 commits)")[![rvigneron64](https://avatars.githubusercontent.com/u/188593050?v=4)](https://github.com/rvigneron64 "rvigneron64 (2 commits)")[![RSHKDL](https://avatars.githubusercontent.com/u/18140340?v=4)](https://github.com/RSHKDL "RSHKDL (1 commits)")[![masev](https://avatars.githubusercontent.com/u/242431?v=4)](https://github.com/masev "masev (1 commits)")

---

Tags

restcolissimocolissimo-webservicessymfony-colissimocolissimo-bundle

### Embed Badge

![Health badge](/badges/cleverage-colissimo-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/cleverage-colissimo-bundle/health.svg)](https://phpackages.com/packages/cleverage-colissimo-bundle)
```

###  Alternatives

[nelmio/api-doc-bundle

Generates documentation for your REST API from attributes

2.3k63.6M233](/packages/nelmio-api-doc-bundle)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[contao/core-bundle

Contao Open Source CMS

1231.6M2.4k](/packages/contao-core-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
