PHPackages                             wdev-rs/netracuni-php - 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. wdev-rs/netracuni-php

ActiveLibrary[API Development](/categories/api)

wdev-rs/netracuni-php
=====================

PHP library for NetRacuni API

1.0.2(1y ago)044MITPHPPHP ^7.4|^8.0

Since Jan 2Pushed 1y agoCompare

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

READMEChangelogDependencies (3)Versions (4)Used By (0)

NetRačuni PHP SDK
=================

[](#netračuni-php-sdk)

[![Latest Version on Packagist](https://camo.githubusercontent.com/7c7a6dbf7afd3f5e57b5846a8c66f8fe329586c792a9edcd78c0c223e0324058/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f776465762d72732f6e6574726163756e692d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/wdev-rs/netracuni-php)[![Total Downloads](https://camo.githubusercontent.com/b6373620bf144ca40c0c54904d7ce98165c9fb88008127a8f768d649fa005355/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f776465762d72732f6e6574726163756e692d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/wdev-rs/netracuni-php)[![Tests](https://github.com/wdev-rs/netracuni-php/actions/workflows/main.yml/badge.svg)](https://github.com/wdev-rs/netracuni-php/actions/workflows/main.yml/badge.svg)

The NetRačuni PHP sdk makes it easy to use the NetRačuni API from any PHP based webshop. It supports all the features from the API, easy to use and compatible with PHP version >= 7.4

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

[](#installation)

You can install the package via composer:

```
composer require wdev-rs/netracuni-php
```

Dependencies
------------

[](#dependencies)

The NetRačuni client depends on the Guzzle library. If you use composer it will be installed automatically.

Usage
-----

[](#usage)

To use the API, you need to create a token in your NetRačuni account. Please consult the [documentation](https://netracuni.com/register-help/sr#28) how to do it.

When you have the token, you can start the integration by creating an instance of the NetRačuni client:

```
$netRacuni = new WdevRs\NetRacuniPhp\NetRacuniClient('net_racuni_staging_************************************************');
```

### Using sandbox or production

[](#using-sandbox-or-production)

During development and testing you can use the sandbox environment. The client automatically recognises the token and sets up the correct endpoint urls. If you want to make sure you are using the correct environment use the following methods:

Switch to sandbox:

```
$netRacuni->sandbox();
```

Switch to production

```
$netRacuni->production();
```

### Check the settings

[](#check-the-settings)

Using the `ping` method you can check the connection with the NetRačuni API and also check if the settings in your account are correct.

```
$netRacuni->ping()
```

The method returns boolean, or throws an error when something went wrong.

### Get the tax labels

[](#get-the-tax-labels)

You can get the actual tax labels from the API, which returns the actual tax labels from the server of the tax authority.

```
$netRacuni->getTaxLabels()
```

The method returns an array with the tax labels, or throws an exception if an error occurred.

Example response from the sandbox:

```
[
  {
    "order_id": 1,
    "name": "ECAL",
    "category_type": 0,
    "label": "F",
    "rate": 11
  },
  {
    "order_id": 2,
    "name": "N-TAX",
    "category_type": 0,
    "label": "N",
    "rate": 0
  },
  {
    "order_id": 3,
    "name": "PBL",
    "category_type": 2,
    "label": "P",
    "rate": 0.5
  },
  {
    "order_id": 4,
    "name": "STT",
    "category_type": 0,
    "label": "E",
    "rate": 6
  },
  {
    "order_id": 5,
    "name": "TOTL",
    "category_type": 1,
    "label": "T",
    "rate": 2
  },
  {
    "order_id": 6,
    "name": "VAT",
    "category_type": 0,
    "label": "A",
    "rate": 10
  },
  {
    "order_id": 6,
    "name": "VAT",
    "category_type": 0,
    "label": "B",
    "rate": 0
  },
  {
    "order_id": 6,
    "name": "VAT",
    "category_type": 0,
    "label": "\u0416",
    "rate": 19
  },
  {
    "order_id": 7,
    "name": "VAT-EXCL",
    "category_type": 0,
    "label": "C",
    "rate": 0
  }
]
```

To create and invoice with the NetRačuni client use the `createInvoice` method. Please note that by using the API you can only create sale invoice (promet prodaja). The argument is an array which defines the products what you will have on the invoice.

**IMPORTANT**: The taxLabels needs to be an array, and the letters have to correspond to the labels received from the `getTaxLabels` method. In production all the tax labels **MUST** use cyrillic letters, even if some letters look the same on cyrillic and latin these are not the same (for example tax label "A").

```
$items = [
    "items" => [
        [
            "name" => "Test Item",
            "taxLabels" => [
                "A"
            ],
            "unit" => "KOM",
            "quantity" => 2,
            "price" => 152.66
        ]
    ]
];

$result = $netRacuni->createInvoice($items);
```

The result is an instance of the `WdevRs\NetRacuniPhp\InvoiceResponse`

To get the invoice in pdf format use the `getInvoicePdfUrl` method. It returns the url of the pdf what you can download or open in a new browser window.

```
$invoiceUrl = $result->getInvoicePdfUrl();
```

To retrieve all the invoice data received from the server of the tax authority use the `getInvoice` method.

```
$invoice = $result->getInvoice();
```

While it is not mandatory we highly encourage you to store both the invoice data and the pdf url, and connect it to the order in your webshop.

### Error handling

[](#error-handling)

The NetRačuni Client transform the errors received from the API to PHP exceptions. You can simply catch the exception, and the exception message will tell you what the actual problem is. For more details about the possible error messages, please check the [documentation](https://netracuni.com/register-help/sr#28).

```
try {
    $result = $netRacuni->createInvoice($items);
} catch(\Exception $e) {
    Log::error($e->getMessage())
    // Example  Company no uploaded certificate, please upload one in https://netracuni.com/teams/ site
}
```

### Testing

[](#testing)

```
composer test
```

### Changelog

[](#changelog)

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

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

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

### Security

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Daniel Werner](https://github.com/wdev-rs)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

PHP Package Boilerplate
-----------------------

[](#php-package-boilerplate)

This package was generated using the [PHP Package Boilerplate](https://laravelpackageboilerplate.com) by [Beyond Code](http://beyondco.de/).

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance41

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

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

Total

3

Last Release

489d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f9d3224345657674b5199e36cc4cadc9d7d90e6d272bf004114254290d4c8007?d=identicon)[wdev-rs](/maintainers/wdev-rs)

---

Top Contributors

[![daniel-werner](https://avatars.githubusercontent.com/u/38726367?v=4)](https://github.com/daniel-werner "daniel-werner (12 commits)")

---

Tags

invoicesinvoicingsaassdkwdev-rsnetracuni-php

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/wdev-rs-netracuni-php/health.svg)

```
[![Health](https://phpackages.com/badges/wdev-rs-netracuni-php/health.svg)](https://phpackages.com/packages/wdev-rs-netracuni-php)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

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