mpluskassa/soap

PHP Client for the MplusKASSA SOAP API

v0.22 2020-11-24 13:03 UTC

Requires

• php: ^7.4
• guzzlehttp/guzzle: ^6.5

MIT

README

WARNING : This is a pre-alpha release, use at your own risk. All features, interfaces are subject to change !

This SOAP API Client is intended to be lightweight and fast, so no wrappers, WSDL-file or SoapClient is used.

Use your personal MplusKASSA API documentation for reference: https://api.mpluskassa.nl:YOUR_API_PORT/?docs

Please note that all "List" elements will be filtered and standardized by the client. E.g. GetProductsResponse has $response->productList which contains an array with all products and loses the $response->productList->product property.

Usage:

<?php

use MplusKASSA\SOAP\Client;
use MplusKASSA\Support\ApiException;

$apiServer = "https://api.mpluskassa.nl";
$apiPort = YOUR_API_PORT;
$apiIdent = YOUR_API_IDENT;
$apiSecret = YOUR_API_SECRET;

$client = new Client($apiServer, $apiPort, $apiIdent, $apiSecret);

$apiMethod = "getArticleGroupChanges"; // <-- This is the API method, get this from documentation after "Input:" for the desired call

// Build the request array as documented in your personal documentation for the specific API method. Please note : Don't add list elements, this will be done by the prepareRequest method
$requestArray = [
    'request' => [
        [
            'syncMarker' => 0,
            'syncMarkerLimit' => 10,
            'groupNumbers' => [
                1, 2, 3, 9,
            ]
        ]
    ]
];

try {
// If your request is an object or mixed object/array, then the prepareRequest will convert it to an array suitable for the execute call
// If your request contains one or more 'List's, the can be wrapped in the required element using the prepareRequest second parameter
    $client->prepareRequest($requestArray, [ 
        'productList' => 'product',             // This will convert the productList array in a items wrapped in the product element
        'articleList' => 'article',             // See the wsdl/doc for required elements
        'lineList' => 'line',
        'paymentList' => 'payment',
        'preparationList' => 'line',
        'preparationMethodList' => 'preparationMethod',
        'imageList' => 'image',
        'customFieldList' => 'customField',
        'sortOrderGroupList' => 'sortOrderGroup',
    ]);
    $response = $client->execute($apiMethod, $requestArray); // <-- execute the request
    print_r($response);
    foreach($response->changedArticleGroupList->changedArticleGroups as $articleGroup) { // <-- access the response as an object
        print_r($articleGroup->name);
    }
    echo sprintf("Duration : %.1f seconds\n", $client->getLastCallDurationInSeconds()); // <-- retrieve last call duration
} catch (ApiException $e) {
    echo "Exception : " . $e->getMessage() . "\n"; // <-- get exception message
    echo "Code : ".$e->getCode()."\n"; // <-- get last exception code
    echo "Trace : ".print_r($e->getTrace(), true)."\n"; //<-- get backtrace
    echo "RequestId : ".$e->getRequestId()."\n"; //<-- get request id
    echo "Request :\n" . $client->getLastRequestXML() . "\n"; // <-- get last request XML
    echo "Response :\n" . $client->getLastResponseXML() . "\n"; // <-- get last response XML
}