janmuran/qdl-sdk

QDL php client

1.1.0 2024-10-01 22:16 UTC

Requires

• php: ^7.4 || ^8.1
• ext-json: *
• doctrine/annotations: ^1.0 || ^2.0
• guzzlehttp/guzzle: ^7.0
• janmuran/object-builder: ^1.0

Requires (Dev)

• mockery/mockery: ^1.4
• phpstan/phpstan: ^1.10
• squizlabs/php_codesniffer: ^3.10

MIT

• Jan Muran

• qdl
• qdl api

README

Php client for QDL API (Quality Delivery Logistics

###Laravel setup

1. Install package

composer require janmuran/qdl-sdk

1. Add config to config/qdl.php

return [
    'login' => env('QDL_API_LOGIN'),
    'password' => env('QDL_API_PASSWORD'),
    'url' => env('QDL_API_URL'),
];

1. Add env variables to .env

QDL_API_LOGIN=
QDL_API_PASSWORD=
QDL_API_URL=https://qdl.sk

1. Add service provider app/Providers/AppServiceProvider.php

$this->app->when(Config::class)
      ->needs('$login')->give(config('qdl.login'));
$this->app->when(Config::class)
       ->needs('$password')->give(config('qdl.password'));
$this->app->when(Config::class)
       ->needs('$baseUri')->give(config('qdl.url'));

Example:

$login = '';
$pass = '';
$sender = 1;

require_once __DIR__ . '/../../vendor/autoload.php';

$config = new Janmuran\QdlSdk\Config\Config($login, $pass, 'https://qdl.sk');
$client = new Janmuran\QdlSdk\Client\Client($config);
$serializer =  JMS\Serializer\SerializerBuilder::create()->build();
$responseBuilder = new Janmuran\ObjectBuilder\ResponseBuilder($serializer);
$qdl = new Janmuran\QdlSdk\Qdl($client, $responseBuilder);

$shipments = new Janmuran\QdlSdk\Model\Shipments();

$date = new DateTimeImmutable();

$shipment = new Janmuran\QdlSdk\Model\Shipment(
    '123456',
    $date->format('d.m.Y'),
    0.0,
    '',
    '',
    'Test note',
    new \Janmuran\QdlSdk\Model\Sender(
        1,
        0,
        'Name Surname',
        'Hlavna 1',
        '84545',
        'Bratislava',
        'SK'
    ),
    new \Janmuran\QdlSdk\Model\Recipient(
        'Jan Muran',
        'Hlavna 1',
        '84545',
        'Bratislava',
        'SK',
        '[phone]',
        '[e-mail]',
        'Name Surname'
    ),
    \Janmuran\QdlSdk\Model\Insurance::createNoInsurance(),
    new \Janmuran\QdlSdk\Model\Services(false, false, true, true, false, '[e-mail]'),
    [
        new \Janmuran\QdlSdk\Model\Item(10.0, '1123')
    ]
);

$shipments->addShipment($shipment);

$response = $qdl->sendShipments($shipments);
print_r($response->getShipments());
print_r($response->getShipmentNumbersByRef());