The first open-source PHP library for SUUS (Rohlig Logistics) freight API integration. Shipment creation, status tracking, and label downloads, with full type safety.
SUUS (now part of Rohlig Logistics) is a freight and courier carrier operating across Central and Eastern Europe, commonly used for B2B parcel and pallet shipments in Poland, Germany, and neighbouring countries. Platforms and systems that ship packages through SUUS need to communicate with their API.
The challenge: SUUS exposes a legacy SOAP interface with sparse official documentation, non-obvious status codes, and no official PHP SDK. suus-php is the first open-source PHP client library wrapping this API in a clean, modern interface: typed DTOs for every request and response, a normalised shipment status enum, sandbox mode for development, and PHPStan level 8 type safety throughout.
Available on Packagist, it installs with a single Composer command. A working shipment creation fits in under ten lines of code.
Shipment orders are built using typed PHP objects: sender, receiver, package dimensions, incoterms. Data is validated locally before it reaches the SUUS servers, so mistakes are caught early.
Live shipment events are fetched and translated into a normalised ShipmentStatus enum (Created, InTransit, Delivered, Failed) instead of cryptic native codes like ROZF or WTRF.
Shipping labels are returned as raw PDF bytes - standard A4 or thermal A6 format. Shipping orders and loading lists are also available through the same typed interface.
Full typed support for extra services: COD (cash on delivery), shipment insurance, SMS delivery notifications for the recipient, and lift service for heavy freight.
The client can be pointed at the SUUS sandbox environment during development. No live shipments are created, and no production credentials are needed for initial integration work.
Every method, DTO, and enum is fully typed. IDEs know exactly what they're working with - no magic arrays, no guessing what fields come back in a response.
composer require very-code-com/suus-php$client = SuusClient::sandbox('ws_yourlogin', 'your_password');
$result = $client->createShipment(new ShipmentOrder(
reference: 'ORDER-2025-001',
sender: new Address('Sender GmbH', 'Musterstr.', '1', '10115', 'Berlin', 'DE'),
receiver: new Address('Odbiorca Sp. z o.o.', 'Marszalkowska', '100', '00-026', 'Warszawa', 'PL'),
packages: [new Package(PackageSymbol::EUR, weightKg: 120.0)],
incoterms: Incoterm::DAP,
));
echo $result->shipmentNo; // OPLKRI2600895
echo $result->trackingUrl; // https://portal.suus.com/order-details/OPLKRI2600895suus-php is intended for PHP developers integrating their platform - an online shop, an ERP system, a warehouse management tool, or any custom logistics workflow - with the SUUS carrier network. For teams shipping B2B freight through SUUS with a PHP backend, the library removes weeks of reverse-engineering SUUS's SOAP interface from the integration effort.