smart-dato/eushipments

EuShipments Laravel SDK

This is our EuShipments Laravel SDK. API documentation can be found here

Installation

You can install the package via composer:

composer require smart-dato/eushipments

You can publish the config file with:

php artisan vendor:publish --tag="eushipments-config"

EUSHIPMENTS_BASE_URL=https://test-api.inout.bg/api/v1/
EUSHIPMENTS_TOKEN=your-api-token

The test environment is https://test-api.inout.bg/api/v1/; production is https://api1.inout.bg/api/v1/.

Usage

use SmartDato\EuShipments\Data\AddressData;
use SmartDato\EuShipments\Data\AirWaybillData;
use SmartDato\EuShipments\Data\ShipmentData;
use SmartDato\EuShipments\Enums\Payer;
use SmartDato\EuShipments\Enums\Service;
use SmartDato\EuShipments\EuShipmentsConnector;
use SmartDato\EuShipments\Requests\Shipment\CreateShipmentRequest;

$connector = new EuShipmentsConnector();

$response = $connector->send(new CreateShipmentRequest(new ShipmentData(
    senderId: 1234,
    courierId: 999,
    waybillAvailableDate: now(),
    serviceName: Service::crossborder,
    recipient: new AddressData(
        name: 'Jane Doe',
        countryIsoCode: 'PL',
        streetName: 'ul. Przykladowa 1',
        buildingNumber: '1',
        addressText: 'ul. Przykladowa 1',
        phoneNumber: '000000000',
        cityName: 'Warszawa',
        zipCode: '00-001',
        contactPerson: 'Jane Doe',
        email: 'jane@example.com',
    ),
    awb: new AirWaybillData(
        parcels: 1,
        envelopes: 0,
        totalWeight: 0.7,
        openPackage: false,
        saturdayDelivery: false,
        referenceNumber: 'order-1001',
        products: 'Clothes',
        bankRepayment: 0,
        shipmentPayer: Payer::sender,
        declaredValue: 0,
        otherRepayment: null,
        observations: null,
        fragile: true,
        productsInfo: 'Clothes',
        piecesInPack: 1,
    ),
)));

senderId and courierId are the IDs from your EuShipments account.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• SmartDato
• All Contributors

License

The MIT License (MIT). Please see License File for more information.