Geodis Integration
Geodis handles freight and pallet shipping for large or heavy items. The integration manages shipment creation, label generation, and tracking for both parcel and pallet deliveries.
Components
| Component | File | Role |
|---|---|---|
GeodisApi | src/CoreBundle/Api/GeodisApi.php | API client for Geodis |
GeodisService | src/CoreBundle/Services/GeodisService.php | Shipment business logic |
Configuration
Required parameters in parameters.yml:
geodis:
api_url: "https://..."
user_id: "..."
password: "..."
customer_code: "..."
:::info Parameter injection
Like DPD, the Geodis service receives the full %geodis% parameter array rather than individual keys. See the DPD documentation for details on this pattern.
:::
Data Flow
Shipment Types
Geodis supports multiple shipment types depending on the goods being shipped:
| Type | Use Case |
|---|---|
| Parcel | Standard-sized packages |
| Pallet | Large or heavy items on EUR pallets |
| Freight | Oversized or multi-pallet shipments |
Error Handling
| Scenario | Behavior |
|---|---|
| API timeout | Retry with backoff |
| Invalid address or dimensions | Logged and skipped; alert raised |
| Authentication failure | Check credentials in parameters.yml |
| Weight limit exceeded | Rejected; operator must split the shipment |
:::warning Pallet dimensions Geodis requires accurate weight and dimension data for pallet shipments. Incorrect values may result in surcharges or rejected shipments. Verify product dimensions in Logidav before creating pallet shipments. :::