dinja/inpost-global-sdk

PHP SDK for InPost Global Rest API

1.0.2 2025-07-04 16:23 UTC

Requires

• php: >=5.4
• ext-json: *
• guzzlehttp/guzzle: ^7.5

Requires (Dev)

• phpunit/phpunit: ^10.0
• squizlabs/php_codesniffer: ^3.7

MIT

• Beniamino Carriero

• ecommerce
• logistics
• inpost

README

This package is a PHP SDK for InPost Global Rest API.

Installing

Install with composer

composer require dinja/inpost-global-sdk

Features

Shipment Services

• Create Address to Point Shipment
• Create Address to Address Shipment
• Create Point to Point Shipment
• Create Point to Address Shipment
• Get Label

Usage

Create Address to Point Shipment

$debug = true;
$timestamp = new \DateTime();
$timezone = new \DateTimeZone('Europe/Rome');
$timestamp->setTimezone($timezone);

$recipient = new ShipmentContact();
$recipient->setFirstName("Mario")
    ->setLastName("Rossi")
    ->setPhonePrefix("+39")
    ->setPhoneNumber("0803009954")
    ->setEmail("[e-mail]");

$sender = new ShipmentContact();
$sender->setCompanyName("Dinja Srl")
    ->setPhonePrefix("+39")
    ->setPhoneNumber("0803009954")
    ->setEmail("[e-mail]");

$origin = new ShipmentAddress();
$origin->setStreet("Via Leonardo da Vinci")
    ->setHouseNumber("22")
    ->setCity("Polignano a Mare")
    ->setPostalCode("70044")
    ->setCountryCode("IT");

$destination = new ShipmentPoint();
$destination->setCountryCode("IT")
    ->setPointName("AAATESTPOK9");

$parcel = new ShipmentParcel();
$parcel->setWeightAmount("1")
    ->setWeightUnit("KG")
    ->setHeight("1")
    ->setLength("1")
    ->setWidth("1")
    ->setDimensionsUnit("CM");

$shipment = new Shipment();
$shipment->setSender($sender)
    ->setRecipient($recipient)
    ->setOriginAddress($origin)
    ->setDestinationPoint($destination)
    ->setParcel($parcel);

$request = new ShipmentRequest("inpost_api_client_id", "inpost_api_client_secret", $debug);
$request->setLabelFormat("PDF_URL")
    ->setShipment($shipment);

$shipmentResponse = $request->call();

if ($shipmentResponse->hasError()) {
    echo $shipmentResponse->getTitle();
} else {
    $shipmentLabelUrl = $shipmentResponse->getLabel();
}

Get PDF Label

$debug = true;

$request = new LabelRequest("inpost_api_client_id", "inpost_api_client_secret", $debug);
$request->setApiPath($shipmentLabelUrl);

$response = $request->call();

if ($response->hasError()) {
    echo $response->getStatus();
} else {
    $pdfLabel = base64_decode($response->getLabel());
}

Get ZPL Label

$debug = true;

$request = new LabelRequest("inpost_api_client_id", "inpost_api_client_secret", $debug);
$request->setApiPath($shipmentLabelUrl);
$request->setLabelFormat("ZPL");

$response = $request->call();

if ($response->hasError()) {
    echo $response->getStatus();
} else {
    $zplLabel = base64_decode($response->getLabel());
}

Credits

• Dinja Srl
• All Contributors

License

This project is licensed under the MIT License (MIT). Please see License File for more information.