PHPackages                             tsekka/omniva - 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. tsekka/omniva

ActiveLibrary

tsekka/omniva
=============

Quick way to connect your php app with Omniva, a Baltic carrier serving Estonia, Latvia and Lithuania. Sends XML data via SOAP. Generates an Omniva order, outputs tracking number &amp; orders package label via email to your email.

0.1.4(2y ago)06[2 PRs](https://github.com/tsekka/php-omniva/pulls)MITPHPPHP ^8.0

Since Nov 4Pushed 2y ago1 watchersCompare

[ Source](https://github.com/tsekka/php-omniva)[ Packagist](https://packagist.org/packages/tsekka/omniva)[ RSS](/packages/tsekka-omniva/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (8)Versions (8)Used By (0)

Omniva for Laravel or other PHP applications
============================================

[](#omniva-for-laravel-or-other-php-applications)

[![Latest Version on Packagist](https://camo.githubusercontent.com/171a696729aa9053173d9da7d70b0fad7f52f6517fe5832e9de681a3024eee72/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7473656b6b612f6f6d6e6976612e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tsekka/omniva)[![GitHub Tests Action Status](https://camo.githubusercontent.com/e8535f111d7c90847772f6b160d61df9e08d6b9290e005489ca0b7fc9b19cd17/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f7473656b6b612f7068702d6f6d6e6976612f72756e2d74657374733f6c6162656c3d7465737473)](https://github.com/tsekka/php-omniva/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/ed530be81131ecc8aae54819a9ec7695ae2cc4ee824da74fbc02bf40f96578ab/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f7473656b6b612f7068702d6f6d6e6976612f466978253230504850253230636f64652532307374796c652532306973737565733f6c6162656c3d636f64652532307374796c65)](https://github.com/tsekka/php-omniva/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/ea5be97b86599fb65f432cdf4a99917ffee500fa48414ce91e8e8460bcb3c316/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7473656b6b612f6f6d6e6976612e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tsekka/omniva)

Omniva is a shipping carrier serving Baltic countries Estonia, Latvia and Lithuania. With this package, you'll be able to generate parcels and request shipping labels.

Features
--------

[](#features)

- Generate shipments (type of request responds to [businessToClientMsgRequest](https://www.omniva.ee/public/files/failid/manual_xml_dataexchange_eng.pdf)) and get the shipment's barcode.
- Get the shipment's barcode (can be used to show tracking code or to get shipping label).
- Request shipping label to be sent via email from Omniva's server.
- Get parcel label as file.

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

[](#installation)

You can install the package via composer:

```
composer require tsekka/omniva
```

Usage examples
--------------

[](#usage-examples)

### Generating the shipment

[](#generating-the-shipment)

*This example assumes you'll use the Omniva's parcel machine as the destination and that you know its zip code.*

*The list of parcel machines is easily available in json, xml and csv formats. Please see the [Omniva's manual](https://www.omniva.ee/public/files/failid/manual_xml_dataexchange_eng.pdf) to get the list of destination points and service codes used in this example.*

```
    use Tsekka\Omniva\Client;
    use Tsekka\Omniva\Parcel;
    use Tsekka\Omniva\Address;
    use Tsekka\Omniva\PickupPoint;

    /**
     * Set your authentication details.
     */
    $client = new Client(
        username: 'your Omniva web service username',
        password: 'your Omniva web service password'
    );

    /**
     * Set & define delivery service,
     * pickup point's information
     * and additional services.
     */
    $parcel = new Parcel(
        deliveryService: 'PA'
    );
    $pickupPoint = new PickupPoint(
        offloadPostcode: 96094,
        type: 0
    );
    $parcel
        ->addAdditionalService('ST')
        ->addAdditionalService('SF');

    /**
     * Set & define receiver and returnee.
     */
    $receiver = new Address();
    $receiver->pickupPoint = $pickupPoint;
    $receiver->name = 'Jane Doe';
    $receiver->mobile = '+3725511223';
    $receiver->email = 'client@example.com';
    $returnee = new Address();
    $returnee->country = 'EE';
    $returnee->name = 'John Roe';
    $returnee->mobile = '+3725566778';
    $returnee->email = 'returnee@example.com';
    $returnee->postcode = '80040';
    $returnee->deliverypoint = 'PARNU';
    $returnee->street = 'Savi 20';
    $returnee->country = 'EE';
    $parcel->receiver = $receiver;
    $parcel->returnee = $returnee;

    /**
     * Generate the shipment & get the barcode
     */
    $barcode = $client->createShipment($parcel);
```

### Getting the shipping label

[](#getting-the-shipping-label)

```
    /**
     * Request the label to be emailed to you from Omniva's server
     */
    $client->sendLabel($barcode, 'business@example.com');

    /**
     * Or get the content of pdf file & save or output it
     */
    $fileData = $client->getLabel($barcode);
    $fileName = "label_{$barcode}.pdf";
    file_put_contents(storage_path() . "/{$fileName}", base64_decode($fileData));
    header('Content-type: application/pdf');
    header('Content-Disposition: attachment; filename="' . $fileName . '"');
    echo base64_decode($fileData);
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

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

[](#contributing)

Contributions are welcome and will be credited.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please report security vulnerabilities by email `pintek@pintek.ee`.

Credits
-------

[](#credits)

- [Kristjan Käärma](https://github.com/tsekka)
- [Aurimas Baubkus](https://github.com/nebijokit/omniva)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~67 days

Total

5

Last Release

1017d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/fd70f75eaf1a9e85571351602af4bf02b8e5d963e91a9a95e60ff418da84008a?d=identicon)[tsekka](/maintainers/tsekka)

---

Top Contributors

[![tsekka](https://avatars.githubusercontent.com/u/43533692?v=4)](https://github.com/tsekka "tsekka (7 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (6 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (4 commits)")

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/tsekka-omniva/health.svg)

```
[![Health](https://phpackages.com/badges/tsekka-omniva/health.svg)](https://phpackages.com/packages/tsekka-omniva)
```

###  Alternatives

[neuron-core/neuron-ai

The PHP Agentic Framework.

1.8k245.3k21](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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