junior-dev/fedex-bundle

Symfony bundle for integrating with the FedEx REST API (OAuth2, shipping, rates, tracking).

v1.0.0 2025-08-13 20:48 UTC

Requires

• php: >=8.1.0
• symfony/http-client: ^6.1|^7.0
• symfony/stimulus-bundle: ^2.9.1
• symfony/twig-bundle: ^6.1|^7.0
• twig/extra-bundle: ^2.12|^3.0

Requires (Dev)

• dg/bypass-finals: ^1.6
• friendsofphp/php-cs-fixer: ^3.1
• friendsoftwig/twigcs: ^6.4
• phpstan/phpstan: ^2.1.17
• phpunit/phpunit: ^9.5
• symfony/asset-mapper: ^6.3|^7.0
• symfony/browser-kit: ^6.1|^7.0
• symfony/framework-bundle: ^6.1|^7.0
• symfony/test-pack: ^1.1

MIT

• Zohoré Junior

• symfony
• rest
• api
• oauth2
• bundle
• FedEx
• shipping
• tracking
• label
• logistics
• carrier
• fedex api
• fedex shipping
• fedex integration
• fedex symfony

README

FedexBundle est un bundle Symfony permettant de communiquer avec l'API REST de FedEx : authentification OAuth2, suivi de colis, et prochainement création d'envois, tarification, et étiquettes d’expédition.

🚀 Fonctionnalités

• ✅ Authentification OAuth2 avec cache du token
• 📦 Suivi de colis par numéro de tracking
• 🛠️ Extensible : création d’envois, labels, tarifs (bientôt)
• 🧪 Compatible Symfony 6 & 7
• 🧰 Services typés, Developer Experience soignée

🧰 Installation

composer require junior-dev/fedex-bundle

⚙️ Configuration

🛠️ config/packages/fedex.yaml

fedex:
    api_key: '%env(FEDEX_CLIENT_ID)%'
    api_password: '%env(FEDEX_CLIENT_SECRET)%'
    account_number: '%env(FEDEX_ACCOUNT_NUMBER)%'
    meter_number: '%env(FEDEX_METER_NUMBER)%'
    mode: 'test' # ou 'production'

🗝️ .env

FEDEX_CLIENT_ID=your_client_id
FEDEX_CLIENT_SECRET=your_client_secret
FEDEX_ACCOUNT_NUMBER=your_account_number
FEDEX_METER_NUMBER=your_meter_number

FEDEX_CLIENT_AUTH_LINK=https://apis-sandbox.fedex.com/oauth/token
FEDEX_API_TRACKING=https://apis-sandbox.fedex.com/track/v1/trackingnumbers

🧱 Roadmap

• Authentification OAuth2
• Suivi de colis
• Création d'envois
• Téléchargement d'étiquettes
• Estimation des tarifs
• Annulation d'envois
• Workflow Github
• Écriture des tests

📚 Documentation

• 🔍 Section Tracking — exemple d'utilisation, explication du DTO FedexTrackingEvent, et commande CLI.

📜 Licence

MIT © Zohoré Junior

🤝 Contribuer

Les contributions sont bienvenues ! Ouvre une issue ou une pull request 🚀