myparcelbe/sdk

This package is designed to send and receive data from MyParcel by means of an API.

Tuesday, July 10, 2018
by Reindert Vetter
Repository
2 Watchers
0 Stars
21 Installations

PHP
1 Dependents
0 Suggesters
7 Forks
0 Open issues
41 Versions
0 % Grown

The README.md

MyParcel SDK

Installation
Installation without composer
Requirements
Quick start and examples
Available Methods
Contribute

Please, star this repository if you use this repository. :star:, _(*1)

Installation with composer

This SDK uses composer., _(*2)

Composer is a tool for dependency management in PHP. It allows you to declare the libraries your project depends on and it will manage (install/update) them for you., _(*3)

For more information on how to use/install composer, please visit: https://github.com/composer/composer, _(*4)

To install the MyParcel SDK into your project, simply, _(*5)

$ composer require myparcelbe/sdk

Installation without composer

If you don't have experience with composer, it is possible to use the SDK without using composer., _(*6)

You can download the zip on the projects releases page., _(*7)

Download the package zip (SDKvx.x.x.zip).
Unzip the contents of the zip, and upload the vendor directory to your server.
In your project, require the file src/AutoLoader.php
You can now use the SDK in your project

Requirements

The MyParcel SDK works on php versions 5.6, 7.x. Also the php curl extension needs to be installed., _(*8)

Quick start and examples

$myParcelCollection = new \MyParcelBE\Sdk\src\Helper\MyParcelCollection();

$consignment = (new \MyParcelBE\Sdk\src\Model\Repository\MyParcelConsignmentRepository())
    ->setApiKey('api_key_from_MyParcel_backoffice')
    ->setReferenceId('Order 1203')
    ->setCountry('BE')
    ->setPerson('Piet Hier')
    ->setCompany('Piet BV')
    ->setFullStreet('Plein 1945 55b')
    ->setPostalCode('2231JE')
    ->setCity('Amsterdam')
    ->setEmail('test@test.nl');

$myParcelCollection
    ->addConsignment($consignment)
    ->setPdfOfLabels()
    ->downloadPdfOfLabels()
    ->setUserAgent('name_of_cms', '1.0');

Available Methods

$myParcelCollection = new \MyParcelBE\Sdk\src\Helper\MyParcelCollection();

$consignment = (new \MyParcelBE\Sdk\src\Model\Repository\MyParcelConsignmentRepository())
    ->setApiKey('api_key_from_MyParcel_backoffice')
    ->setReferenceId('Order 1203')
    ->setCountry('BE')
    ->setPerson('Piet Hier')
    ->setCompany('Piet BV')
    ->setFullStreet('Plein 1945 55b')
    ->setPostalCode('2231JE')
    ->setPackageType(1)
    ->setCity('Amsterdam')
    ->setEmail('test@test.nl')
    ->setPhone('+31 (0)634213465')
    ->setLargeFormat(true)
    ->setOnlyRecipient(true)
    ->setSignature(true)
    ->setReturn(true)
    ->setInsurance(250)
    ->setLabelDescription('Order 10034');

$myParcelCollection
    ->addConsignment($consignment)

User-agent

To give us insight into which CMS system you make a connection from, you should send a User-Agent. If you're using a known CMS system it's required. You must send the name of the CMS system followed by a version number. A version is not required., _(*9)

    ->setUserAgent('name_of_cms', '1.0')

Submitting full address

    ->setFullStreet('Plein 1945 55b')

Submitting address in pieces

    ->setStreet('Plein 1945')
    ->setNumber((string)55)
    ->setBoxNumber('b')

Create concept

$myParcelCollection->createConcepts();

Download labels

$myParcelCollection->setPdfOfLabels();
$myParcelCollection->downloadPdfOfLabels();

Get label link

$myParcelCollection
    ->setLinkOfLabels()
    ->getLinkOfLabels()

MyParcel consignment id

If you don't use setReferenceId(), you can also use the MyParcelConsignmentId when you create a concept: After setPdfOfLabels(), setLinkOfLabels() and createConcepts(), you can save the api id to your database. With this id you can easily retrieve the latest status., _(*10)

$consignment->getMyParcelConsignmentId();

Get status

After setPdfOfLabels(), setLinkOfLabels() and createConcepts() you can get the status., _(*11)

$status = $consignment->getStatus();

Get barcode

The barcode is available after setPdfOfLabels() and setLinkOfLabels(), _(*12)

$barcode = $consignment->getBarcode();

Multiple shipments

To create multiple consignments or get one pdf with multiple consignments, set multiple consignments. It's faster and cleaner., _(*13)

$myParcelCollection = new \MyParcelBE\Sdk\src\Helper\MyParcelCollection();

foreach ($yourShipments as $yourShipment) {

    $consignment = (new \MyParcelBE\Sdk\src\Model\Repository\MyParcelConsignmentRepository())
        ->setApiKey('api_key_from_MyParcel_backoffice')
        ->setReferenceId($yourShipment->getOrderId()
        ->setName('Piet Hier');
        /** @todo; set all info */

    $myParcelCollection
        ->setUserAgent('name_of_cms', '1.0')
        ->addConsignment($consignment)
}

Later on

In a new request, you can get all the data again., _(*14)

$consignment = (new \MyParcelBE\Sdk\src\Model\Repository\MyParcelConsignmentRepository())
    ->setApiKey('api_key_from_MyParcel_backoffice')
    ->setReferenceId('Order 1203'); // or setMyParcelConsignmentId(123456)

$myParcelCollection
    ->addConsignment($consignment)
    ->setLatestData();

$consignments = $myParcelCollection
    ->getConsignments();

$firstConsignment = $consignments[0];

$status = $firstConsignment->getStatus();
$barcode = $firstConsignment->getBarcode();

Contribute

Check for open issues or open a new issue to start a discussion around a bug or feature.
Fork the repository on GitHub to start making your changes.
Write one or more tests for the new feature or that expose the bug.
Make code changes to implement the feature or fix the bug.
Send a pull request to get your changes merged and published.

The Versions

10/07 2018

dev-master

9999999-dev https://www.sendmyparcel.be

This package is designed to send and receive data from MyParcel by means of an API.

library sdk

This package is designed to send and receive data from MyParcel by means of an API.

myparcelbe/sdk

The README.md

MyParcel SDK

Installation with composer

Installation without composer

Requirements

Quick start and examples

Available Methods

User-agent

Submitting full address

Submitting address in pieces

Create concept

Download labels

Get label link

MyParcel consignment id

Get status

Get barcode

Multiple shipments

Later on

Contribute

The Versions

dev-master

The Requires

The Development Requires

by Richard Perdaan

v1.3.9

The Requires

The Development Requires

by Richard Perdaan

dev-develop

The Requires

The Development Requires

by Richard Perdaan

v1.3.8

The Requires

The Development Requires

by Reindert Vetter

v1.3.7

The Requires

The Development Requires

by Reindert Vetter

v1.3.6

The Requires

The Development Requires

by Reindert Vetter

v1.3.5

The Requires

The Development Requires

by Reindert Vetter

v1.3.4

The Requires

The Development Requires

by Reindert Vetter

v1.3.3

The Requires

The Development Requires

by Reindert Vetter

v1.3.2

The Requires

The Development Requires

by Reindert Vetter

v1.3.1

The Requires

The Development Requires

by Reindert Vetter

v1.3.0

The Requires

The Development Requires

by Reindert Vetter

v1.2.4

The Requires

The Development Requires

by Reindert Vetter

v1.2.3

The Requires

The Development Requires

by Reindert Vetter

v1.2.2