omnibus / bluedart

2.x-dev 2026-10-15 13:14 UTC

Requires

• php: >=8.2
• glitchr/omnibus: ^2.0@dev
• symfony/http-client: ^6.4|^7.0|^8.0

Requires (Dev)

• phpunit/phpunit: ^11.0

MIT

• Marco Meyer

• shipping
• carrier
• omnibus
• bluedart

Published on Packagist.org on 2026-10-15 13:23 UTC

README

Blue Dart for glitchr/omnibus: serviceability and transit time (Transit API), waybills with their labels (Waybill API), tracking (Tracking API) and cancellation - Blue Dart's API gateway with a JWT.

$gateway = (new BluedartGatewayFactory($http))->create($options);   // $http: the application's HTTP client - none given, the factory makes its own; the options below

No framework needed: the package requires glitchr/omnibus and symfony/http-client. In a Symfony application, the same through the bundle's configuration:

omnibus:
    gateways:
        bluedart:
            factory: bluedart
            options:
                client_id: '%env(BLUEDART_CLIENT_ID)%'
                client_secret: '%env(BLUEDART_CLIENT_SECRET)%'
                login_id: '%env(BLUEDART_LOGIN)%'
                licence_key: '%env(BLUEDART_LICENCE)%'
                customer_code: '%env(BLUEDART_CUSTOMER)%'
                origin_area: BOM
                sandbox: true
                rates: [...]        # or prices per product through the shipment option "prices"

The service is the product code (A Domestic Priority, E Dart Apex, D Dart Surfaceline). Blue Dart quotes no price: rating checks which products serve the lane and in how many days, and takes the amount from the shipment option prices (product => minor units) or from configured rates. Shipment options: description, instructions, sub_product (P by default), register_pickup. No pickup points: Blue Dart delivers to the door.

Credentials: an app on Blue Dart's developer portal gives the client id and secret; the ShipDart profile (login id, licence key, customer code, area) comes from your account manager.

Built from Blue Dart's published API documentation and tested on recorded answers; unverified against the sandbox until an account's keys are at hand.

Responsibility

This package is an independent, unofficial client: it is not affiliated with, endorsed by or sponsored by Blue Dart Express Limited. It reaches their service on behalf of whoever runs it, and it does not redistribute their data beyond the short excerpts recorded as test fixtures. Its MIT licence covers this package's code only and grants no right to the service or to its data.

Whoever installs and runs this package is responsible for complying with Blue Dart's terms (bluedart.com/webterms), for obtaining whatever they require (an account, a key, a licence or subscription, an attribution or a citation, a rate limit to respect), and for any use made of what it returns. The authors publish it free of charge, make no commercial use of it, and accept no liability for how it is used (see LICENSE).

License: MIT since 2026-10-09; earlier versions remain published under LGPL-3.0-or-later.