rojtjo/bol-api-client

Bol.com Retailer API client v10

0.5.1 2024-04-02 14:44 UTC

Requires

• php: ^8.1
• ext-openssl: *
• illuminate/collections: ^9.26|^10.0|^11.0
• league/csv: ^9.0
• psr/http-client: ^1.0
• psr/simple-cache: ^3.0
• webmozart/assert: ^1.11

Requires (Dev)

• guzzlehttp/guzzle: ^7.0.1
• phpunit/phpunit: ^9.3.3
• spatie/phpunit-snapshot-assertions: ^4.2

MIT

• api
• client
• bol
• Bol.com

README

Interact with the Bol.com API v10.

Installation

You can install the package via composer:

composer require rojtjo/bol-api-client

Usage

use Rojtjo\Bol\Bol;
use Rojtjo\Bol\Connection;
use Rojtjo\Bol\Environment;
use Rojtjo\Bol\Secure\CachedAuthentication;
use Rojtjo\Bol\Secure\ClientCredentialsAuthentication;
use Rojtjo\Bol\Types\FulfilmentMethod;
use Rojtjo\Bol\Types\OrderStatus;
use Some\Psr\Http\Client\Implementation as Http;
use Some\Psr\SimpleCache\Implementation as Cache;

$http = new Http();
$cache = new Cache();

$bol = new Bol(
    new Connection(
        new CachedAuthentication(
            new ClientCredentialsAuthentication(
                'Your Client ID',
                'Your Client Secret',
            ),
            $cache,
            'bol-credentials-cache',
        ),
        Environment::Demo,
        $http,
    ),
    $cache,
);

// Retrieve an offer
$offer = $bol->offers()->offer('00000000-0000-0000-0000-000000000000');

// Retrieve open orders
$openOrders = $bol->orders()->orders(FulfilmentMethod::ByRetailer, OrderStatus::Open);

Testing

Create a copy of phpunit.xml.dist named phpunit.xml and fill out the test credentials to be used.

vendor/bin/phpunit

License

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