### Install kwaadpepper/chronopost-relay

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Use Composer to install the library. Ensure PHP version 8.1 or higher and the `ext-soap`, `ext-dom`, and `ext-mbstring` extensions are enabled.

```bash
composer require kwaadpepper/chronopost-relay
```

--------------------------------

### Get All Chronopost Agencies

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Retrieves a comprehensive list of all Chronopost agencies within the network. Requires initializing the `Get` service object. Handles potential errors by printing messages.

```php
<?php
$get = new \ChronopostRelay\ServiceType\Get($options);

$params = new \ChronopostRelay\StructType\GetAllChronopostAgences();

$result = $get->getAllChronopostAgences($params);

if ($result !== false) {
    /** @var \ChronopostRelay\StructType\GetAllChronopostAgencesResponse $result */
    $agences = $result->getReturn();
    foreach ((array) $agences as $agence) {
        echo $agence->getNomEnseigne()         . ' — '
           . $agence->getAdresse1()            . ', '
           . $agence->getCodePostal()          . ' '
           . $agence->getLocalite()            . PHP_EOL;
        echo 'ID : '   . $agence->getIdentifiantChronopost() . PHP_EOL;
        echo 'Type : ' . $agence->getTypeDePoint()           . PHP_EOL;
    }
} else {
    $errors = $get->getLastError();
    foreach ($errors as $method => $soapFault) {
        echo "Erreur dans $method : " . $soapFault->getMessage() . PHP_EOL;
    }
}
```

--------------------------------

### Get::getAllChronopostAgences()

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Retrieves a list of all available Chronopost agencies.

```APIDOC
## Get::getAllChronopostAgences()

### Description
Returns the complete list of all available Chronopost agencies in the network.

### Method
Not specified (likely a method call within a PHP client library).

### Endpoint
Not applicable (client-side method).

### Parameters
#### Path Parameters
None.

#### Query Parameters
None.

#### Request Body
None.

### Request Example
```php
<?php
$get = new \ChronopostRelay\ServiceType\Get($options);

$params = new \ChronopostRelay\StructType\GetAllChronopostAgences();

$result = $get->getAllChronopostAgences($params);

if ($result !== false) {
    /** @var \ChronopostRelay\StructType\GetAllChronopostAgencesResponse $result */
    $agences = $result->getReturn();
    foreach ((array) $agences as $agence) {
        echo $agence->getNomEnseigne()         . ' — '
           . $agence->getAdresse1()            . ', '
           . $agence->getCodePostal()          . ' '
           . $agence->getLocalite()            . PHP_EOL;
        echo 'ID : '   . $agence->getIdentifiantChronopost() . PHP_EOL;
        echo 'Type : ' . $agence->getTypeDePoint()           . PHP_EOL;
    }
} else {
    $errors = $get->getLastError();
    foreach ($errors as $method => $soapFault) {
        echo "Erreur dans $method : " . $soapFault->getMessage() . PHP_EOL;
    }
}
```

### Response
#### Success Response
A list of all Chronopost agencies, including their name, address, postal code, locality, Chronopost ID, and agency type.

#### Response Example
(Output of the `echo` statements in the success block)
```

--------------------------------

### Get WSDL to PHP Class Map

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Retrieve the associative array mapping WSDL types to their corresponding PHP classes. This map is essential for initializing the SOAP client.

```php
<?php
$classMap = \ChronopostRelay\ClassMap::get();
// Résultat partiel :
// [
//   'recherchePointChronopost'         => '\ChronopostRelay\StructType\RecherchePointChronopost',
//   'recherchePointChronopostResponse' => '\ChronopostRelay\StructType\RecherchePointChronopostResponse',
//   'pointChronopost'                  => '\ChronopostRelay\StructType\PointChronopost',
//   'pointCHR'                         => '\ChronopostRelay\StructType\PointCHR',
//   'horaireOuverture'                 => '\ChronopostRelay\StructType\HoraireOuverture',
//   ...
// ]

$options = [
    \WsdlToPhp\PackageBase\AbstractSoapClientBase::WSDL_URL      => 'https://ws.chronopost.fr/recherchebt-ws-cxf/PointRelaisServiceWS?wsdl',
    \WsdlToPhp\PackageBase\AbstractSoapClientBase::WSDL_CLASSMAP => $classMap,
];
```

--------------------------------

### Get Tobacco Shop Information by Chronopost A2Pas ID

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Retrieves details for a partner tobacco shop using its Chronopost A2Pas identifier. This is useful for fetching specific information about a known tobacco shop.

```php
<?php
$params = new \ChronopostRelay\StructType\RechercheBtParIdChronopostA2Pas(
    identifiantChronopostA2Pas: 'BT_69001_001' // Identifiant A2Pas
);

$result = $recherche->rechercheBtParIdChronopostA2Pas($params);

if ($result !== false) {
    $bureau = $result->getReturn();
    print_r($bureau);
} else {
    print_r($recherche->getLastError());
}
?>
```

--------------------------------

### Recherche::rechercheBtParIdChronopostA2Pas()

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Retrieves the information of a partner tobacco shop using its Chronopost A2Pas identifier. This method is used to get specific details about a known tobacco shop.

```APIDOC
## Recherche::rechercheBtParIdChronopostA2Pas()

### Description
Retrieves information of a partner tobacco shop using its Chronopost A2Pas identifier.

### Parameters
- **identifiantChronopostA2Pas** (string) - Required - The Chronopost A2Pas identifier for the tobacco shop.

### Request Example
```php
<?php
$params = new \ChronopostRelay\StructType\RechercheBtParIdChronopostA2Pas(
    identifiantChronopostA2Pas: 'BT_69001_001'
);

$result = $recherche->rechercheBtParIdChronopostA2Pas($params);

if ($result !== false) {
    $bureau = $result->getReturn();
    print_r($bureau);
} else {
    print_r($recherche->getLastError());
}
?>
```

### Response
- **Return** (object) - A single tobacco shop object containing its details.
```

--------------------------------

### Initialize Chronopost SOAP Client

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Instantiate the SOAP client services with minimal options including the WSDL URL and class map. Authentication options can be added if required by the service.

```php
<?php
require_once __DIR__ . '/vendor/autoload.php';

use WsdlToPhp\PackageBase\AbstractSoapClientBase;

// Options minimales (sans authentification)
$options = [
    AbstractSoapClientBase::WSDL_URL      => 'https://ws.chronopost.fr/recherchebt-ws-cxf/PointRelaisServiceWS?wsdl',
    AbstractSoapClientBase::WSDL_CLASSMAP => \ChronopostRelay\ClassMap::get(),
];

// Options avec authentification (si requise par le service)
$optionsAuth = [
    AbstractSoapClientBase::WSDL_URL      => 'https://ws.chronopost.fr/recherchebt-ws-cxf/PointRelaisServiceWS?wsdl',
    AbstractSoapClientBase::WSDL_CLASSMAP => \ChronopostRelay\ClassMap::get(),
    AbstractSoapClientBase::WSDL_TRACE    => true,
    AbstractSoapClientBase::WSDL_LOGIN    => 'votre_login',
    AbstractSoapClientBase::WSDL_PASSWORD => 'votre_mot_de_passe',
];

// Instanciation des services
$recherche = new \ChronopostRelay\ServiceType\Recherche($options);
$get       = new \ChronopostRelay\ServiceType\Get($options);
```

--------------------------------

### Search Delivery Tour Information

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Fetches Chronopost delivery tour information. The specific parameters required depend on the WSDL definition for tours. The `Recherche` object must be initialized.

```php
<?php
$params = new \ChronopostRelay\StructType\RechercheTournee(
    // Paramètres selon la définition WSDL de la tournée
);

$result = $recherche->rechercheTournee($params);

if ($result !== false) {
    $tournees = $result->getReturn();
    foreach ((array) $tournees as $tournee) {
        /** @var \ChronopostRelay\StructType\Tournee $tournee */
        print_r($tournee);
    }
} else {
    print_r($recherche->getLastError());
}
```

--------------------------------

### Search Chronopost Points by Address

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Finds nearby Chronopost points based on a given postal address, product code, package weight, and shipping date. Ensure all required parameters like accountNumber, password, address, zipCode, city, countryCode, productCode, service, weight, and shippingDate are correctly provided.

```php
<?php
$recherche = new \ChronopostRelay\ServiceType\Recherche($options);

$params = new \ChronopostRelay\StructType\RecherchePointChronopost(
    accountNumber:      '12345678',   // Numéro de compte Chronopost
    password:           'motdepasse', // Mot de passe
    address:            '13 rue de la Paix',
    zipCode:            '75001',
    city:               'Paris',
    countryCode:        'FR',
    type:               null,         // Type de point (null = tous)
    productCode:        '01',         // Code produit Chronopost
    service:            'T',
    weight:             '1000',       // Poids en grammes
    shippingDate:       '20240610',   // Date d'expédition AAAAMMJJ
    maxPointChronopost: '5',          // Nombre maximum de résultats
    maxDistanceSearch:  '10',         // Distance max en km
    holidayTolerant:    '1'           // 1 = tolérant aux jours fériés
);

$result = $recherche->recherchePointChronopost($params);

if ($result !== false) {
    /** @var \ChronopostRelay\StructType\RecherchePointChronopostResponse $result */
    $points = $result->getReturn(); // Tableau de PointChronopost
    foreach ((array) $points as $point) {
        /** @var \ChronopostRelay\StructType\PointChronopost $point */
        echo $point->getNomEnseigne() . ' — ' . $point->getAdresse1() . ', ' . $point->getCodePostal() . PHP_EOL;
        echo 'Identifiant : ' . $point->getIdentifiantChronopost() . PHP_EOL;
        echo 'Horaires lundi : ' . $point->getHorairesOuvertureLundi() . PHP_EOL;
    }
} else {
    // Récupération de la dernière erreur SOAP
    $errors = $recherche->getLastError();
    print_r($errors);
}

```

--------------------------------

### Search Tobacco Shops by Product Code, Postal Code, and Date

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Finds tobacco shops that accept a specific product for a given postal code and shipping date. Requires product code, postal code, and shipping date as parameters.

```php
<?php
$params = new \ChronopostRelay\StructType\RechercheBtParCodeproduitEtCodepostalEtDate(
    codeProduit: '01',      // Code produit Chronopost
    codePostal:  '69001',   // Code postal de recherche
    date:        '20240610' // Date d'expédition AAAAMMJJ
);

$result = $recherche->rechercheBtParCodeproduitEtCodepostalEtDate($params);

if ($result !== false) {
    $bureaux = $result->getReturn();
    foreach ((array) $bureaux as $bureau) {
        /** @var \ChronopostRelay\StructType\BureauDeTabac $bureau */
        echo $bureau->getNomEnseigne() . ' — ' . $bureau->getAdresse1() . PHP_EOL;
    }
} else {
    print_r($recherche->getLastError());
}
?>
```

--------------------------------

### Recherche::recherchePointChronopost()

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Searches for the nearest Chronopost pickup points to a given postal address, considering product code, parcel weight, and shipping date.

```APIDOC
## Recherche::recherchePointChronopost()

### Description
Searches for the nearest Chronopost pickup points to a given postal address, considering product code, parcel weight, and shipping date.

### Parameters
#### Request Body
- **accountNumber** (string) - Required - Chronopost account number
- **password** (string) - Required - Password
- **address** (string) - Required - Street address
- **zipCode** (string) - Required - Postal code
- **city** (string) - Required - City
- **countryCode** (string) - Required - Country code (e.g., 'FR')
- **type** (string) - Optional - Type of pickup point (null for all)
- **productCode** (string) - Required - Chronopost product code
- **service** (string) - Required - Service type
- **weight** (string) - Required - Parcel weight in grams
- **shippingDate** (string) - Required - Shipping date in 'YYYYMMDD' format
- **maxPointChronopost** (string) - Optional - Maximum number of results
- **maxDistanceSearch** (string) - Optional - Maximum search distance in km
- **holidayTolerant** (string) - Optional - '1' to be tolerant of holidays, '0' otherwise

### Response
#### Success Response (200)
- **return** (array) - An array of `PointChronopost` objects representing the found pickup points.

#### Error Response
- Returns `false` on error, with error details available via `getLastError()`.
```

--------------------------------

### Recherche::rechercheTournee()

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Searches for Chronopost delivery route information.

```APIDOC
## Recherche::rechercheTournee()

### Description
Searches for Chronopost delivery route information.

### Method
Not specified (likely a method call within a PHP client library).

### Endpoint
Not applicable (client-side method).

### Parameters
#### Path Parameters
None.

#### Query Parameters
None.

#### Request Body
None.

### Request Example
```php
<?php
$params = new \ChronopostRelay\StructType\RechercheTournee(
    // Parameters according to the WSDL definition of the route
);

$result = $recherche->rechercheTournee($params);

if ($result !== false) {
    $tournees = $result->getReturn();
    foreach ((array) $tournees as $tournee) {
        /** @var \ChronopostRelay\StructType\Tournee $tournee */
        print_r($tournee);
    }
} else {
    print_r($recherche->getLastError());
}
```

### Response
#### Success Response
Information about the delivery routes.

#### Response Example
(Output of `print_r($tournee)`)
```

--------------------------------

### Search Chronopost Points by Coordinates and Service

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Locates Chronopost points using geographic coordinates, with an option to filter by a specific delivery service. Requires account credentials and delivery details. The `Recherche` object must be initialized.

```php
<?php
$params = new \ChronopostRelay\StructType\RecherchePointChronopostParCoordonneesGeographiquesParService(
    accountNumber:      '12345678',
    password:           'motdepasse',
    coordGeoLatitude:   '48.5734',  // Strasbourg
    coordGeoLongitude:  '7.7521',
    type:               null,
    productCode:        '01',
    service:            'T',
    weight:             '1200',
    shippingDate:       '20240610',
    maxPointChronopost: '5',
    maxDistanceSearch:  '10',
    holidayTolerant:    '1'
);

$result = $recherche->recherchePointChronopostParCoordonneesGeographiquesParService($params);

if ($result !== false) {
    foreach ((array) $result->getReturn() as $point) {
        echo $point->getNomEnseigne() . PHP_EOL;
    }
} else {
    print_r($recherche->getLastError());
}
```

--------------------------------

### Recherche::rechercheTourneeParTypeTourneeEtPosteComptable()

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Searches for Chronopost routes filtered by route type and accounting office.

```APIDOC
## Recherche::rechercheTourneeParTypeTourneeEtPosteComptable()

### Description
Searches for Chronopost routes filtered by route type and accounting office.

### Method
Not specified (likely a method call within a PHP client library).

### Endpoint
Not applicable (client-side method).

### Parameters
#### Path Parameters
None.

#### Query Parameters
None.

#### Request Body
None.

### Request Example
```php
<?php
$params = new \ChronopostRelay\StructType\RechercheTourneeParTypeTourneeEtPosteComptable(
    typeTournee:     'T1',       // Route type
    posteComptable:  'PC_75001'  // Accounting office identifier
);

$result = $recherche->rechercheTourneeParTypeTourneeEtPosteComptable($params);

if ($result !== false) {
    $tournees = $result->getReturn();
    foreach ((array) $tournees as $tournee) {
        /** @var \ChronopostRelay\StructType\TourneeComplete $tournee */
        echo 'Tournée : ' . $tournee->getIdentifiantTournee() . PHP_EOL;
    }
} else {
    print_r($recherche->getLastError());
}
```

### Response
#### Success Response
List of Chronopost routes matching the criteria.

#### Response Example
(Output of `echo 'Tournée : ' . $tournee->getIdentifiantTournee() . PHP_EOL;`)
```

--------------------------------

### Recherche::recherchePointChronopostInterParService()

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Searches for international Chronopost points filtered by delivery service type. It requires account credentials and address details, along with product and service codes.

```APIDOC
## Recherche::recherchePointChronopostInterParService()

### Description
Searches for international Chronopost points filtered by delivery service type.

### Method
Not specified (likely a method call within a PHP SDK)

### Parameters
- **accountNumber** (string) - Required - Account number for authentication.
- **password** (string) - Required - Password for authentication.
- **address** (string) - Required - The street address for the search.
- **zipCode** (string) - Required - The postal code for the search.
- **city** (string) - Required - The city for the search.
- **countryCode** (string) - Required - The ISO country code (e.g., 'DE').
- **productCode** (string) - Required - The product code for the service.
- **service** (string) - Required - The service type code.
- **weight** (string) - Required - The weight of the shipment.
- **shippingDate** (string) - Required - The desired shipping date in 'YYYYMMDD' format.

### Request Example
```php
$params = new \ChronopostRelay\StructType\RecherchePointChronopostInterParService(
    accountNumber: '12345678',
    password:      'motdepasse',
    address:       'Marienplatz 1',
    zipCode:       '80331',
    city:          'München',
    countryCode:   'DE',
    productCode:   'CX',
    service:       'T',
    weight:        '1500',
    shippingDate:  '20240610'
);

$result = $recherche->recherchePointChronopostInterParService($params);
```

### Response
#### Success Response
- **Return** (object) - An object containing the search results, accessible via `getReturn()`.

#### Error Response
- **getLastError()** (string) - Returns an error message if the search fails.
```

--------------------------------

### Search Tours by Type and Accounting Post

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Finds Chronopost tours filtered by tour type and accounting post identifier. Requires specifying `typeTournee` and `posteComptable`. The `Recherche` object must be initialized.

```php
<?php
$params = new \ChronopostRelay\StructType\RechercheTourneeParTypeTourneeEtPosteComptable(
    typeTournee:     'T1',       // Type de tournée
    posteComptable:  'PC_75001'  // Identifiant du poste comptable
);

$result = $recherche->rechercheTourneeParTypeTourneeEtPosteComptable($params);

if ($result !== false) {
    $tournees = $result->getReturn();
    foreach ((array) $tournees as $tournee) {
        /** @var \ChronopostRelay\StructType\TourneeComplete $tournee */
        echo 'Tournée : ' . $tournee->getIdentifiantTournee() . PHP_EOL;
    }
} else {
    print_r($recherche->getLastError());
}
```

--------------------------------

### Search Chronopost Points by Geographic Coordinates

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Finds Chronopost points near a specified geographic location defined by latitude and longitude. This method requires account credentials, coordinates, product code, service, weight, shipping date, and search radius parameters.

```php
<?php
$params = new \ChronopostRelay\StructType\RecherchePointChronopostParCoordonneesGeographiques(
    accountNumber:      '12345678',
    password:           'motdepasse',
    coordGeoLatitude:   '48.8566',  // Latitude — Paris
    coordGeoLongitude:  '2.3522',   // Longitude — Paris
    type:               null,
    productCode:        '01',
    service:            'T',
    weight:             '500',
    shippingDate:       '20240610',
    maxPointChronopost: '3',
    maxDistanceSearch:  '5',
    holidayTolerant:    '0'
);

$result = $recherche->recherchePointChronopostParCoordonneesGeographiques($params);

if ($result !== false) {
    $points = $result->getReturn();
    foreach ((array) $points as $point) {
        /** @var \ChronopostRelay\StructType\PointChronopostAvecCoord $point */
        echo $point->getNomEnseigne() . PHP_EOL;
    }
} else {
    print_r($recherche->getLastError());
}

```

--------------------------------

### Search Tobacco Shops with Closing Periods by Product Code, Postal Code, and Date

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Finds tobacco shops and their closing periods for a given product code, postal code, and shipping date. This method provides information on when shops might be closed.

```php
<?php
$params = new \ChronopostRelay\StructType\RechercheBtAvecPFParCodeproduitEtCodepostalEtDate(
    codeProduit: '01',
    codePostal:  '33000', // Bordeaux
    date:        '20240610'
);

$result = $recherche->rechercheBtAvecPFParCodeproduitEtCodepostalEtDate($params);

if ($result !== false) {
    $bureaux = $result->getReturn();
    foreach ((array) $bureaux as $bureau) {
        /** @var \ChronopostRelay\StructType\BureauDeTabacAvecPF $bureau */
        echo $bureau->getNomEnseigne() . PHP_EOL;
        // Accès aux périodes de fermeture
        $periodes = $bureau->getPeriodesFermeture();
        foreach ((array) $periodes as $periode) {
            /** @var \ChronopostRelay\StructType\PeriodeFermeture $periode */
            echo '  Fermeture du ' . $periode->getDateDebut() . ' au ' . $periode->getDateFin() . PHP_EOL;
        }
    }
} else {
    print_r($recherche->getLastError());
}
?>
```

--------------------------------

### Recherche::recherchePointChronopostInter()

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Performs an international search for Chronopost pickup points based on an address.

```APIDOC
## Recherche::recherchePointChronopostInter()

### Description
Performs an international search for Chronopost pickup points based on an address.

### Parameters
#### Request Body
- **accountNumber** (string) - Required - Chronopost account number
- **password** (string) - Required - Password
- **address** (string) - Required - Street address
- **zipCode** (string) - Required - Postal code
- **city** (string) - Required - City
- **countryCode** (string) - Required - Country code
- **productCode** (string) - Required - Chronopost product code
- **service** (string) - Required - Service type
- **weight** (string) - Required - Parcel weight in grams
- **shippingDate** (string) - Required - Shipping date in 'YYYYMMDD' format

### Response
#### Success Response (200)
- **return** (mixed) - The result of the international pickup point search.

#### Error Response
- Returns `false` on error, with error details available via `getLastError()`.
```

--------------------------------

### Détail d'un point Chronopost

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Retrieves comprehensive details for a specific Chronopost point, including daily opening hours and closure periods. Requires the unique point ID.

```php
<?php
$params = new \ChronopostRelay\StructType\RechercheDetailPointChronopost(
    id: 'A2P75001' // Identifiant unique du point
);

$result = $recherche->rechercheDetailPointChronopost($params);

if ($result !== false) {
    $detail = $result->getReturn();
    // Accès aux horaires détaillés par jour
    echo 'Lundi : '    . $detail->getHorairesOuvertureLundi()    . PHP_EOL;
    echo 'Mardi : '    . $detail->getHorairesOuvertureMardi()    . PHP_EOL;
    echo 'Mercredi : ' . $detail->getHorairesOuvertureMercredi() . PHP_EOL;
    echo 'Jeudi : '    . $detail->getHorairesOuvertureJeudi()    . PHP_EOL;
    echo 'Vendredi : ' . $detail->getHorairesOuvertureVendredi() . PHP_EOL;
    echo 'Samedi : '   . $detail->getHorairesOuvertureSamedi()   . PHP_EOL;
    echo 'Dimanche : ' . $detail->getHorairesOuvertureDimanche() . PHP_EOL;
    echo 'Horaires formatés : ' . $detail->getHorairesOuverturesFormates() . PHP_EOL;
} else {
    print_r($recherche->getLastError());
}
```

--------------------------------

### Point Chronopost avec coordonnées GPS par identifiant

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Searches for a Chronopost point by its ID and returns its information enriched with geographical coordinates (latitude and longitude). Requires the point's ID.

```php
<?php
$params = new \ChronopostRelay\StructType\RecherchePointChronopostAvecCoordParId(
    id: 'A2P75001'
);

$result = $recherche->recherchePointChronopostAvecCoordParId($params);

if ($result !== false) {
    /** @var \ChronopostRelay\StructType\PointChronopostAvecCoord $point */
    $point = $result->getReturn();
    echo 'Nom : '         . $point->getNomEnseigne()     . PHP_EOL;
    echo 'Latitude : '    . $point->getCoordGeoLatitude()  . PHP_EOL;
    echo 'Longitude : '   . $point->getCoordGeoLongitude() . PHP_EOL;
} else {
    print_r($recherche->getLastError());
}
```

--------------------------------

### Handle SOAP Errors with getLastError()

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

When a SOAP method fails, it returns `false`. Use `getLastError()` to retrieve an array of `SoapFault` objects, indexed by method name, for detailed error analysis.

```php
<?php
$params = new \ChronopostRelay\StructType\RecherchePointChronopost(
    zipCode: '99999', // Code postal inexistant
);

$result = $recherche->recherchePointChronopost($params);

if ($result === false) {
    $errors = $recherche->getLastError();
    // Structure : ['ChronopostRelay\ServiceType\Recherche::recherchePointChronopost' => SoapFault]
    foreach ($errors as $method => $fault) {
        echo "Méthode  : $method"                . PHP_EOL;
        echo "Code     : " . $fault->faultcode   . PHP_EOL;
        echo "Message  : " . $fault->getMessage() . PHP_EOL;
    }
}

// Activation du mode trace pour déboguer les échanges SOAP bruts
$optionsDebug = [
    \WsdlToPhp\PackageBase\AbstractSoapClientBase::WSDL_URL      => 'https://ws.chronopost.fr/recherchebt-ws-cxf/PointRelaisServiceWS?wsdl',
    \WsdlToPhp\PackageBase\AbstractSoapClientBase::WSDL_CLASSMAP => \ChronopostRelay\ClassMap::get(),
    \WsdlToPhp\PackageBase\AbstractSoapClientBase::WSDL_TRACE    => true,
];
$rechercheDebug = new \ChronopostRelay\ServiceType\Recherche($optionsDebug);

```

--------------------------------

### Search Relay Points by GPS Coordinates

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Use this method to find all types of relay points near specified geographical coordinates. Requires account credentials, coordinates, product code, service, weight, shipping date, and search radius parameters.

```php
<?php
$params = new \ChronopostRelay\StructType\RecherchePointRelaisParCoordonneesGeographiques(
    accountNumber:      '12345678',
    password:           'motdepasse',
    coordGeoLatitude:   '45.7640',  // Lyon
    coordGeoLongitude:  '4.8357',
    type:               null,
    productCode:        '01',
    service:            'T',
    weight:             '750',
    shippingDate:       '20240610',
    maxPointChronopost: '5',
    maxDistanceSearch:  '7',
    holidayTolerant:    '1'
);

$result = $recherche->recherchePointRelaisParCoordonneesGeographiques($params);

if ($result !== false) {
    foreach ((array) $result->getReturn() as $point) {
        echo $point->getNomEnseigne() . ' — ' . $point->getAdresse1() . PHP_EOL;
    }
} else {
    print_r($recherche->getLastError());
}
?>
```

--------------------------------

### Recherche::recherchePointChronopostInterParServiceAGL()

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

An extended version of the international search by service, covering an additional network of partners (AGL).

```APIDOC
## Recherche::recherchePointChronopostInterParServiceAGL()

### Description
An extended version of the international search by service, covering an additional network of partners (AGL).

### Method
Not specified (likely a method call within a PHP SDK)

### Parameters
- **accountNumber** (string) - Required - Account number for authentication.
- **password** (string) - Required - Password for authentication.
- **address** (string) - Required - The street address for the search.
- **zipCode** (string) - Required - The postal code for the search.
- **city** (string) - Required - The city for the search.
- **countryCode** (string) - Required - The ISO country code (e.g., 'IT').
- **productCode** (string) - Required - The product code for the service.
- **service** (string) - Required - The service type code.
- **weight** (string) - Required - The weight of the shipment.
- **shippingDate** (string) - Required - The desired shipping date in 'YYYYMMDD' format.

### Request Example
```php
$params = new \ChronopostRelay\StructType\RecherchePointChronopostInterParServiceAGL(
    accountNumber: '12345678',
    password:      'motdepasse',
    address:       'Via Roma 1',
    zipCode:       '00100',
    city:          'Roma',
    countryCode:   'IT',
    productCode:   'CX',
    service:       'T',
    weight:        '800',
    shippingDate:  '20240610'
);

$result = $recherche->recherchePointChronopostInterParServiceAGL($params);
```

### Response
#### Success Response
- **Return** (object) - An object containing the search results, accessible via `getReturn()`.

#### Error Response
- **getLastError()** (string) - Returns an error message if the search fails.
```

--------------------------------

### Recherche::recherchePointChronopostParCoordonneesGeographiques()

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Finds Chronopost pickup points near a geographical location defined by latitude and longitude.

```APIDOC
## Recherche::recherchePointChronopostParCoordonneesGeographiques()

### Description
Finds Chronopost pickup points near a geographical location defined by latitude and longitude.

### Parameters
#### Request Body
- **accountNumber** (string) - Required - Chronopost account number
- **password** (string) - Required - Password
- **coordGeoLatitude** (string) - Required - Latitude of the location
- **coordGeoLongitude** (string) - Required - Longitude of the location
- **type** (string) - Optional - Type of pickup point (null for all)
- **productCode** (string) - Required - Chronopost product code
- **service** (string) - Required - Service type
- **weight** (string) - Required - Parcel weight in grams
- **shippingDate** (string) - Required - Shipping date in 'YYYYMMDD' format
- **maxPointChronopost** (string) - Optional - Maximum number of results
- **maxDistanceSearch** (string) - Optional - Maximum search distance in km
- **holidayTolerant** (string) - Optional - '1' to be tolerant of holidays, '0' otherwise

### Response
#### Success Response (200)
- **return** (array) - An array of `PointChronopostAvecCoord` objects representing the found pickup points.

#### Error Response
- Returns `false` on error, with error details available via `getLastError()`.
```

--------------------------------

### Recherche::rechercheDetailPointChronopost()

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Retrieves comprehensive details for a specific Chronopost point, including daily opening hours and closure periods.

```APIDOC
## Recherche::rechercheDetailPointChronopost()

### Description
Retrieves comprehensive details for a specific Chronopost point, including daily opening hours and closure periods.

### Method
Not specified (likely a method call within a PHP SDK)

### Parameters
- **id** (string) - Required - The unique identifier of the Chronopost point.

### Request Example
```php
$params = new \ChronopostRelay\StructType\RechercheDetailPointChronopost(
    id: 'A2P75001' // Identifiant unique du point
);

$result = $recherche->rechercheDetailPointChronopost($params);
```

### Response
#### Success Response
- **Return** (object) - An object containing the detailed information of the point, with methods like `getHorairesOuvertureLundi()`, `getHorairesOuvertureMardi()`, etc., and `getHorairesOuverturesFormates()`.

#### Error Response
- **getLastError()** (string) - Returns an error message if the retrieval fails.
```

--------------------------------

### Recherche::recherchePointChronopostParCoordonneesGeographiquesParService()

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Searches for Chronopost points by geographic coordinates with a filter for a specific delivery service.

```APIDOC
## Recherche::recherchePointChronopostParCoordonneesGeographiquesParService()

### Description
Searches for Chronopost points by geographic coordinates with a filter for a specific delivery service.

### Method
Not specified (likely a method call within a PHP client library).

### Endpoint
Not applicable (client-side method).

### Parameters
#### Path Parameters
None.

#### Query Parameters
None.

#### Request Body
None.

### Request Example
```php
<?php
$params = new \ChronopostRelay\StructType\RecherchePointChronopostParCoordonneesGeographiquesParService(
    accountNumber:      '12345678',
    password:           'motdepasse',
    coordGeoLatitude:   '48.5734',  // Strasbourg
    coordGeoLongitude:  '7.7521',
    type:               null,
    productCode:        '01',
    service:            'T',
    weight:             '1200',
    shippingDate:       '20240610',
    maxPointChronopost: '5',
    maxDistanceSearch:  '10',
    holidayTolerant:    '1'
);

$result = $recherche->recherchePointChronopostParCoordonneesGeographiquesParService($params);

if ($result !== false) {
    foreach ((array) $result->getReturn() as $point) {
        echo $point->getNomEnseigne() . PHP_EOL;
    }
} else {
    print_r($recherche->getLastError());
}
```

### Response
#### Success Response
List of Chronopost points matching the geographic coordinates and service filter.

#### Response Example
(Output of `echo $point->getNomEnseigne() . PHP_EOL;`)
```

--------------------------------

### Recherche::rechercheBtParCodeproduitEtCodepostalEtDate()

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Searches for tobacco shops (relay partners) that accept a given product for a specific postal code and shipping date. This is useful for finding available pickup points for specific shipments.

```APIDOC
## Recherche::rechercheBtParCodeproduitEtCodepostalEtDate()

### Description
Searches for tobacco shops (relay partners) accepting a given product for a specific postal code and shipping date.

### Parameters
- **codeProduit** (string) - Required - Chronopost product code.
- **codePostal** (string) - Required - The postal code for the search.
- **date** (string) - Required - The shipping date in YYYYMMDD format.

### Request Example
```php
<?php
$params = new \ChronopostRelay\StructType\RechercheBtParCodeproduitEtCodepostalEtDate(
    codeProduit: '01',
    codePostal:  '69001',
    date:        '20240610'
);

$result = $recherche->rechercheBtParCodeproduitEtCodepostalEtDate($params);

if ($result !== false) {
    $bureaux = $result->getReturn();
    foreach ((array) $bureaux as $bureau) {
        /** @var \ChronopostRelay\StructType\BureauDeTabac $bureau */
        echo $bureau->getNomEnseigne() . ' — ' . $bureau->getAdresse1() . PHP_EOL;
    }
} else {
    print_r($recherche->getLastError());
}
?>
```

### Response
- **Return** (array) - An array of tobacco shop objects, each containing details like `NomEnseigne` and `Adresse1`.
```

--------------------------------

### Recherche::recherchePointChronopostParId()

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Retrieves detailed information for a specific Chronopost pickup point using its unique Chronopost identifier.

```APIDOC
## Recherche::recherchePointChronopostParId()

### Description
Retrieves detailed information for a specific Chronopost pickup point using its unique Chronopost identifier.

### Parameters
#### Request Body
- **id** (string) - Required - Chronopost identifier of the pickup point

### Response
#### Success Response (200)
- **return** (`PointChronopost` object) - A `PointChronopost` object containing the details of the pickup point.

#### Error Response
- Returns `false` on error, with error details available via `getLastError()`.
```

--------------------------------

### Détail d'un point Chronopost international

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Fetches detailed information for an international Chronopost point using its unique identifier. Returns detailed information about the point.

```php
<?php
$params = new \ChronopostRelay\StructType\RechercheDetailPointChronopostInter(
    id: 'DE_POINT_001' // Identifiant du point international
);

$result = $recherche->rechercheDetailPointChronopostInter($params);

if ($result !== false) {
    print_r($result->getReturn());
} else {
    print_r($recherche->getLastError());
}
```

--------------------------------

### Search Chronopost Point by ID

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Retrieves detailed information for a specific Chronopost relay point using its unique Chronopost identifier. This method is useful when you already know the ID of the desired relay point.

```php
<?php
$params = new \ChronopostRelay\StructType\RecherchePointChronopostParId(
    id: 'A2P75001' // Identifiant Chronopost du point relais
);

$result = $recherche->recherchePointChronopostParId($params);

if ($result !== false) {
    /** @var \ChronopostRelay\StructType\RecherchePointChronopostParIdResponse $result */
    $point = $result->getReturn();
    if ($point instanceof \ChronopostRelay\StructType\PointChronopost) {
        echo 'Nom : '        . $point->getNomEnseigne()   . PHP_EOL;
        echo 'Adresse : '    . $point->getAdresse1()      . PHP_EOL;
        echo 'Localité : '   . $point->getLocalite()      . PHP_EOL;
        echo 'Type : '       . $point->getTypeDePoint()   . PHP_EOL;
        echo 'Arrivée colis: '. $point->getDateArriveColis() . PHP_EOL;
    }
} else {
    print_r($recherche->getLastError());
}

```

--------------------------------

### Recherche internationale par service Chronopost

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

Searches for international Chronopost points filtered by delivery service type. Requires account credentials, address details, product code, service type, weight, and shipping date.

```php
<?php
$params = new \ChronopostRelay\StructType\RecherchePointChronopostInterParService(
    accountNumber: '12345678',
    password:      'motdepasse',
    address:       'Marienplatz 1',
    zipCode:       '80331',
    city:          'München',
    countryCode:   'DE',
    productCode:   'CX',
    service:       'T',
    weight:        '1500',
    shippingDate:  '20240610'
);

$result = $recherche->recherchePointChronopostInterParService($params);

if ($result !== false) {
    print_r($result->getReturn());
} else {
    print_r($recherche->getLastError());
}
```

--------------------------------

### Search Relay Points by GPS Coordinates and Service

Source: https://context7.com/kwaadpepper/chronopost-relay/llms.txt

This method searches for relay points using GPS coordinates and allows filtering by specific delivery service types. It requires similar parameters to the general GPS search but focuses on service-specific results.

```php
<?php
$params = new \ChronopostRelay\StructType\RecherchePointRelaisParCoordonneesGeographiquesParService(
    accountNumber:      '12345678',
    password:           'motdepasse',
    coordGeoLatitude:   '43.2965',  // Marseille
    coordGeoLongitude:  '5.3698',
    type:               null,
    productCode:        '01',
    service:            'T',
    weight:             '500',
    shippingDate:       '20240610',
    maxPointChronopost: '3',
    maxDistanceSearch:  '5',
    holidayTolerant:    '0'
);

$result = $recherche->recherchePointRelaisParCoordonneesGeographiquesParService($params);

if ($result !== false) {
    print_r($result->getReturn());
} else {
    print_r($recherche->getLastError());
}
?>
```