PHPackages                             firewizard/innoship-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. firewizard/innoship-sdk

ActiveLibrary[API Development](/categories/api)

firewizard/innoship-sdk
=======================

Consumer SDK for Innoship API

v1.1.1(1y ago)22.0k↓83%2MITPHPPHP ^7.0

Since Jan 12Pushed 1y ago1 watchersCompare

[ Source](https://github.com/firewizard/innoship-sdk)[ Packagist](https://packagist.org/packages/firewizard/innoship-sdk)[ RSS](/packages/firewizard-innoship-sdk/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (4)DependenciesVersions (5)Used By (0)

Innoship SDK
============

[](#innoship-sdk)

Make sure to read the Innoship [API Docs](https://docs.innoship.io/innoship) or [Swagger Docs](https://api.innoship.com/index.html) first.

Requirements
------------

[](#requirements)

- PHP >= 7.0
- curl extension
- json extension

Installation
------------

[](#installation)

Require the package via composer

```
composer require firewizard/innoship-sdk
```

Usage
-----

[](#usage)

To interact with the API, you need to create a new instance of `Innoship\Innoship`, using your API key:

```
$innoship = new Innoship\Innoship('my-api-key-123');
```

This exposes several service objects, following the swagger grouping:

- courier
- feedback
- label
- location
- order
- price
- track

So, for instance, to get all client locations, the call would look like this:

```
$locations = $innoship->location()->clientLocations()->getContent();
```

All requests return an instance of Innoship\\Response\\Contract, which offers two public methods:

1. `isSuccessful()` - to make sure the request was sucesseful and the content is not an error message
2. `getContent()` - to get the actual response

### Get a list of countries

[](#get-a-list-of-countries)

```
$countries = $innoship->location()->countries()->getContent();
```

### Get a list of cities in a giver region

[](#get-a-list-of-cities-in-a-giver-region)

```
$cities = $innoship->location()->cities('94')->getContent();
```

### Get a list of regions for a given country

[](#get-a-list-of-regions-for-a-given-country)

```
$innoship->location()->regions('HU')->getContent());
```

### Get feedback for a given time period

[](#get-feedback-for-a-given-time-period)

```
$innoship->feedback()->get('2021-12-01', '2021-12-10')->getContent();
```

### Get tracking info

[](#get-tracking-info)

- for a single AWB

```
$info = $innoship->track()->byAwb('3', '5749162310001')->getContent();
```

- for a list of AWB's

```
$info = $innoship->track()->byAwb('3', ['5749162310001', '5749162310002'])->getContent();
```

### Get PDF label for AWB

[](#get-pdf-label-for-awb)

```
file_put_contents('awb-5749162310001.pdf', $innoship->label()->byCourierAwb('3', '5749162310001')->getContent();
```

### Get a list of fixed locations

[](#get-a-list-of-fixed-locations)

```
$request = new Innoship\Request\GetFixedLocations();
$request
    ->setCourier('Sameday')
    ->setCountryCode('RO')
    ->setCountyName('Bucuresti')
    ->setLocalityName('Bucuresti')
    ->setFixedLocationType($request::TYPE_LOCKER);

$locations = $innoship->location()->fixedLocations($request);
```

### Get rates for shipment

[](#get-rates-for-shipment)

```
$address = new Innoship\Request\CreateOrder\Address();
$address
    ->setName('Tester Testerson')
    ->setContactPerson('Tester Testerson')
    ->setPhone('0723000000')
    ->setEmail('tester.testerson@example.com')
    ->setAddressText('Sos Principala nr 1')
    ->setLocalityName('Socolari')
    ->setCountyName('Caras-Severin')
    ->setCountry('RO');

$content = new Innoship\Request\CreateOrder\Content();
$content
    ->setParcelsCount(1)
    ->setTotalWeight(10)
    ->setContents('Obiecte de artă')
    ->setPackage('carton');

$extra = new Innoship\Request\CreateOrder\Extra();
$extra
    //->setOpenPackage(true)
    //->setSaturdayDelivery(true)
    ->setBankRepaymentAmount(125)
    ->setBankRepaymentCurrency('RON');

$request = new Innoship\Request\CreateOrder();
$request
    ->setServiceId(1)
    ->setShipmentDate(now())
    ->setAddressTo($address)
    ->paidBySender()
    ->setContent($content)
    ->setExtra($extra)
    ->setExternalClientLocation('Default')
    ->setExternalOrderId('10000001')
    ->setSourceChannel('website')
    ->setCustomAttributes(['x' => 1, 'y' => 2])
    //->includePriceBreakdown()
    //->includeCourierResponse()
    ;

$rates = $innoship->price()->get($request)->getContent();
```

### Create new shipment AWB

[](#create-new-shipment-awb)

Using the same request object as above, call:

```
$response = $innoship->order()->create($request);
```

Make sure that you set the courier id and the service id on this call, otherwise the request will fail.

### Delete an existing shipment AWB

[](#delete-an-existing-shipment-awb)

```
$response = $innoship->order()->delete('3', '5749162310001');
```

Contributing
------------

[](#contributing)

Found a bug or have something you consider to be an improvement? Feel free to open a PR, all contributions are appreciated!

License
-------

[](#license)

This package is open-source software licensed under the [MIT license](./LICENSE).

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~352 days

Total

4

Last Release

575d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/35505409f9e5afadb08ba22c146d224a1ec9af6f3c4acd83c4adeee0f3288c26?d=identicon)[firewizard](/maintainers/firewizard)

---

Top Contributors

[![firewizard](https://avatars.githubusercontent.com/u/1143980?v=4)](https://github.com/firewizard "firewizard (4 commits)")

### Embed Badge

![Health badge](/badges/firewizard-innoship-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/firewizard-innoship-sdk/health.svg)](https://phpackages.com/packages/firewizard-innoship-sdk)
```

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35916.4M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24016.2M20](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172445.0k15](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

93459.5k6](/packages/botman-driver-telegram)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)