md-adil/shyplite

SDK for Shyplite shipment service

Shyplite PHP And Laravel SDK

shyplite.com

Installing

Composer is the best friend to install any php libraries / dependancies with their dependancies. If you haven't already installed then follow the link Composer, _(*1)

Then run following command in your terminal/command prompt where your application is installed., _(*2)

composer require md-adil/shyplite dev-master

Login

Before making any request you need to set token first., _(*3)

Getting token, _(*4)

use Adil\Shyplite\Shyplite;

$congis = [
    'username'=> '<email-id>',
    'password' => '<password>',
    'app_id' => '<app-id>', // Your app's ID
    'seller_id' => '<seller-id>',   // Your seller ID
    'key' => '<key>'
];

$shyplite = new Shyplite($configs); // Constructor takes config array as argument
$response = $shyplite->login();
$shyplite->setToken($response->userToken);

Order

To create order, _(*5)

$orders = $shyplite->order()->add([/*order array provided in official doc*/])
    ->add([/*Add more order not more than 25*/])
    ->create() // finally create order and return array of Order model which hold the values you provided with response id and success status
    // or

foreach($orders as $order) {
    echo $order->id; // response success id
    echo $order->getError(); // if error on particular order
    echo $order->hasError(); // true or false
}

To cancel order, _(*6)

$shyplite->order()->cancel([/* array of order id */])

Shipment

Getting slip, _(*7)

$slip = $shyplite->shipment()->getSlip(/* order id */);

echo $slip->name; // name of slip

echo $slip->download(/* download location */);

Getting manifest, _(*8)

$menifest = $shyplite->shipment()->menifest(/* menifest id provided by getSlip function */);
echo $menifest->name; // name of menifest
echo $menifest->path // path to download menifest
$menifest->download(/*path to download*/);

Service

To check service availability., _(*9)

$available = $shyplite->service()->availability($sourcePincode, $destinationPincode);

print_r($avaialable);

Configuration

Required:, _(*10)

$config = [
    'username'=> '<email-id>',
    'password' => '<password>',
    'app_id' => '<app-id>', // Your app's ID
    'seller_id' => '<seller-id>',   // Your seller ID
    'key' => '<key>'
];

Default:, _(*11)

protected $configs = [
    'verified_request' => false,
    'base_uri' => 'https://api.shyplite.com',
    'order_uri' => 'order',
    'get_slip_uri' => 'getSlip',
    'availablity_uri' => 'getserviceability',
    'track_uri' => 'track',
    'manifest_uri' => 'getManifestPDF',
    'ordercancel_uri' => 'ordercancel'
];

You can override default configs by providing the key your own config like:, _(*12)

$configs = [
    /* our configs */,
    'verified_request' => true, // Now you need to add certificate to make verified reques.
    'order_uri' => 'orders', // If later on shyplite decide to change their uri.
]

Laravel Integration

Let the laravel know about your plugin., _(*13)

configs/app.php, _(*14)

    return [

        // providers section.

        'providers' => [
            // ...,
            Adil\Shyplite\Laravel\ShypliteServiceProvider::class
        ],

        'aliases' => [

            // ...
            'Shyplite' => Adil\Shyplite\Laravel\Facade\Shyplite::class

        ]

    ];

    // use it in your app

Shyplite::setToken($yourtoken);
Shyplite::order()->add()->create();

Now add shyplite specific settings in your configs directory., _(*15)

configs/shyplite.php, _(*16)

return [
    'username'=> '<email-id>',
    'password' => '<password>',
    'app_id' => '<app-id>', // Your app's ID
    'seller_id' => '<seller-id>',   // Your seller ID
    'key' => '<key>'
];

This is unofficial shyplite sdk for php / laravel., _(*17)

I appreciate your feedback. If you find any issues please don't forget to letme know either mail me or create github issue. if you like my efforts please dont forget to give star., _(*18)

Thank you :)