2017 © Pedro PelĆ”ez
 

library bpost-api-library

image

antidot-be/bpost-api-library

  • Sunday, July 29, 2018
  • by kouinkouin
  • Repository
  • 6 Watchers
  • 10 Stars
  • 2,719 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 31 Forks
  • 2 Open issues
  • 11 Versions
  • 12 % Grown

The README.md

bpost API client

Build Status Latest Stable Version Latest Unstable Version Scrutinizer Quality Score Code Coverage Total Downloads License, (*1)

About

bpost API library is a PHP library which permit to your PHP application to communicate with the bpost API., (*2)

Installation

composer require antidot-be/bpost-api-library

Usages

Orders

Common objects


/* Call the Composer autoloader */
require '../vendor/autoload.php';

use Bpost\BpostApiClient\Bpost;
use Bpost\BpostApiClient\Bpost\Order;
use Bpost\BpostApiClient\Bpost\Order\Address;
use Bpost\BpostApiClient\Bpost\Order\Box;
use Bpost\BpostApiClient\Bpost\Order\Box\AtBpost;
use Bpost\BpostApiClient\Bpost\Order\Box\AtHome;
use Bpost\BpostApiClient\Bpost\Order\Box\CustomsInfo\CustomsInfo;
use Bpost\BpostApiClient\Bpost\Order\Box\International;
use Bpost\BpostApiClient\Bpost\Order\Box\Option\Insured;
use Bpost\BpostApiClient\Bpost\Order\Box\Option\Messaging;
use Bpost\BpostApiClient\Bpost\Order\Line;
use Bpost\BpostApiClient\Bpost\Order\PugoAddress;
use Bpost\BpostApiClient\Bpost\Order\Receiver;
use Bpost\BpostApiClient\Bpost\ProductConfiguration\Product;
use Bpost\BpostApiClient\BpostException;
use Psr\Log\LoggerInterface;


$apiUrl = "https://api-parcel.bpost.be/services/shm/";
$apiUsername = "107423";
$apiPassword = "MyGreatApiPassword";

$bpost = new Bpost($apiUsername, $apiPassword, $apiUrl);

/* We set the receiver postal address, without the name */
$receiverAddress = new Address();
$receiverAddress->setStreetName("Rue du Grand Duc");
$receiverAddress->setNumber(13);
$receiverAddress->setPostalCode(1040);
$receiverAddress->setLocality("Etterbeek");
$receiverAddress->setCountryCode("BE"); // ISO2

/* We set the receiver postal address, without the name */
$receiver = new Receiver();
$receiver->setAddress($receiverAddress);
$receiver->setName("Alma van Appel");
$receiver->setPhoneNumber("+32 2 641 13 90");
$receiver->setEmailAddress("alma@antidot.com");

$orderReference = "ref_0123456789"; // An unique order reference
$order = new Order($orderReference);

/**
 * A order line is an order item, like a article
 */
$order->addLine(
    new Line("Article description", 1)
);
$order->addLine(
    new Line("Some others articles", 5)
);

/**
 * A box is used to split your shipping in many packages
 * The box weight must be littlest than to 30kg
 */
$box = new Box();

/**
 * Available boxes for national box:
 * - AtHome: Delivered at the given address
 * - AtBpost: Delivered in a bpost office
 * - BpostOnAppointment: Delivered in a shop
 *
 * Available boxes for international box:
 * - International: Delivered at the given address
 */
$atHome = new AtHome();
$atHome->setProduct(Product::PRODUCT_NAME_BPACK_24H_BUSINESS);
$atHome->setReceiver($receiver);

/* Add options */
$atHome->addOption(
    new Insured(
        Insured::INSURANCE_TYPE_ADDITIONAL_INSURANCE,
        Insured::INSURANCE_AMOUNT_UP_TO_2500_EUROS
    )
);

$box->setNationalBox($atHome);

$order->addBox($box);

Create an order

We use the variables set before., (*3)

$bpost->createOrReplaceOrder($order); // The order is created with status Box::BOX_STATUS_PENDING

Update order status

$bpost->modifyOrderStatus($orderReference, Box::BOX_STATUS_OPEN);

Get order info

$order = $bpost->fetchOrder($orderReference);

$boxes = $order->getBoxes();
$lines = $order->getLines();

Labels

Get labels from an order

$labels = $bpost->createLabelForOrder(
    $orderReference,
    Bpost::LABEL_FORMAT_A6, // $format
    false, // $withReturnLabels
    true // $asPdf
);
foreach ($labels as $label) {
    $barcode = $label->getBarcode();
    $mimeType = $label->getMimeType(); // Label::LABEL_MIME_TYPE_*
    $bytes = $label->getBytes();
    file_put_contents("$barcode.pdf", $bytes);
}

Get labels from an existing barcode

$labels = $bpost->createLabelForOrder(
    $boxBarcode,
    Bpost::LABEL_FORMAT_A6, // $format
    false, // $withReturnLabels
    true // $asPdf
);
foreach ($labels as $label) {
    $barcode = $label->getBarcode(); // Can be different than $boxBarcode if this is a return label
    $mimeType = $label->getMimeType(); // Label::LABEL_MIME_TYPE_*
    $bytes = $label->getBytes();
    file_put_contents("$barcode.pdf", $bytes);
}

Get labels from an existing barcode

$labels = $bpost->createLabelInBulkForOrders(
    array(
        $orderReference1,
        $orderReference2,
    ),
    Bpost::LABEL_FORMAT_A6, // $format
    false, // $withReturnLabels
    true // $asPdf
);
foreach ($labels as $label) {
    $barcode = $label->getBarcode(); // Can be different than $boxBarcode if this is a return label
    $mimeType = $label->getMimeType(); // Label::LABEL_MIME_TYPE_*
    $bytes = $label->getBytes();
    file_put_contents("$barcode.pdf", $bytes);
}

Geo6 services

$geo6Partner = '999999';
$geo6AppId = 'A001';
$geo6 = new Geo6($geo6Partner, $geo6AppId);

Get nearest points

$points = $geo6->getNearestServicePoint(
    'Grand Place', // Street name
    '3', // Street number
    '1000', // Zip code
    'fr', // Language: 'fr' or 'nl'
    3, // Point types: Sum of some Geo6::POINT_TYPE_*
    5 // Points number
);
foreach ($points as $point) {
    $distance = $point['distance']; // float
    /** @var Poi $poi */
    $poi = $point['poi'];
}

Get point details

/** @var Poi $poi */
$poi = $geo6->getServicePointDetails(
    200000, // Point ID
    'fr', // Language: 'fr' or 'nl'
    3 // Point types: Sum of some Geo6::POINT_TYPE_*
);

Get point map URL

$url = $geo6->getServicePointPageUrl(
    200000, // Point ID
    'fr', // Language: 'fr' or 'nl'
    3 // Point types: Sum of some Geo6::POINT_TYPE_*
);

Sites using this class

Would like contribute ?

You can read the CONTRIBUTING.md file, (*4)

The Versions

29/07 2018

dev-3.0-bpack247

dev-3.0-bpack247

  Sources   Download

27/06 2018

dev-master

9999999-dev https://github.com/Antidot-be/bpost-api-library

bpost API library is a PHP library to communicate with the bpost API.

  Sources   Download

BSD

The Requires

 

The Development Requires

by Avatar kouinkouin
by Tijs Verkoyen
by Raphaƫl Pommier

04/03 2018

1.0.0

1.0.0.0

  Sources   Download

04/03 2018

1.0.1

1.0.1.0

  Sources   Download

24/08 2016

3.4.0

3.4.0.0 https://github.com/Antidot-be/bpost-api-library

bpost API library is a PHP library to communicate with the bpost API.

  Sources   Download

BSD

The Requires

 

The Development Requires

by Avatar kouinkouin
by Tijs Verkoyen
by Raphaƫl Pommier

10/06 2016

3.3.0

3.3.0.0 https://github.com/Antidot-be/bpost-api-library

bpost API client is a PHP library to communicate with the bpost API.

  Sources   Download

BSD

The Requires

 

The Development Requires

by Avatar kouinkouin
by Tijs Verkoyen
by Raphaƫl Pommier

16/12 2014

3.0.2

3.0.2.0 https://github.com/tijsverkoyen/bpost

PHP bPost is a (wrapper)class to communicate with the bPost Webservices.

  Sources   Download

BSD

The Requires

  • php >=5.3.0
  • ext-curl *

 

by Tijs Verkoyen

18/06 2014

3.0.1

3.0.1.0 https://github.com/tijsverkoyen/bpost

PHP bPost is a (wrapper)class to communicate with the bPost Webservices.

  Sources   Download

BSD

The Requires

  • php >=5.3.0
  • ext-curl *

 

by Tijs Verkoyen

14/05 2014

dev-track-and-trace

dev-track-and-trace https://github.com/tijsverkoyen/bpost

PHP bPost is a (wrapper)class to communicate with the bPost Webservices.

  Sources   Download

BSD

The Requires

  • php >=5.3.0
  • ext-curl *

 

by Tijs Verkoyen

09/05 2014

3.0.0

3.0.0.0 https://github.com/tijsverkoyen/bpost

PHP bPost is a (wrapper)class to communicate with the bPost Webservices.

  Sources   Download

BSD

The Requires

  • php >=5.3.0
  • ext-curl *

 

by Tijs Verkoyen

09/05 2014

3.0.x-dev

3.0.9999999.9999999-dev https://github.com/tijsverkoyen/bpost

PHP bPost is a (wrapper)class to communicate with the bPost Webservices.

  Sources   Download

BSD

The Requires

  • php >=5.3.0
  • ext-curl *

 

by Tijs Verkoyen