PHPackages                             it-delmax/laravel-efaktura - 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. it-delmax/laravel-efaktura

ActiveLibrary[API Development](/categories/api)

it-delmax/laravel-efaktura
==========================

Laravel 12 wrapper for Serbian eFaktura API (Ministarstvo finansija)

v1.2.0(4mo ago)017MITPHPPHP ^8.2

Since Dec 18Pushed 4mo agoCompare

[ Source](https://github.com/it-delmax/laravel-efaktura)[ Packagist](https://packagist.org/packages/it-delmax/laravel-efaktura)[ RSS](/packages/it-delmax-laravel-efaktura/feed)WikiDiscussions main Synced 1mo ago

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

Laravel eFaktura
================

[](#laravel-efaktura)

Laravel 12 paket za integraciju sa eFaktura API sistemom Ministarstva finansija Republike Srbije.

Zahtevi
-------

[](#zahtevi)

- PHP 8.2+
- Laravel 11.x ili 12.x
- Guzzle HTTP Client

Instalacija
-----------

[](#instalacija)

```
composer require it-delmax/laravel-efaktura
```

Paket koristi Laravel auto-discovery, pa će se automatski registrovati.

### Publikovanje konfiguracije

[](#publikovanje-konfiguracije)

```
php artisan vendor:publish --tag=efaktura-config
```

### Podešavanje okruženja

[](#podešavanje-okruženja)

Dodajte sledeće u vaš `.env` fajl:

```
EFAKTURA_API_KEY=vaš-api-ključ
EFAKTURA_ENVIRONMENT=production  # ili "demo" za testiranje

# Opciono
EFAKTURA_TIMEOUT=30
EFAKTURA_LOGGING_ENABLED=false
EFAKTURA_CACHE_ENABLED=true
```

Korišćenje
----------

[](#korišćenje)

### Facade pristup

[](#facade-pristup)

```
use ItDelmax\LaravelEfaktura\Facades\Efaktura;
use ItDelmax\LaravelEfaktura\Facades\SalesInvoice;
use ItDelmax\LaravelEfaktura\Facades\PurchaseInvoice;

// Prodajne fakture
$invoice = SalesInvoice::get(12345);
echo $invoice->invoiceNumber;

// Ulazne fakture
$invoice = PurchaseInvoice::get(12345);
PurchaseInvoice::accept(12345, 'Prihvaćeno');

// Preko glavnog Efaktura facade-a
$invoice = Efaktura::salesInvoice()->get(12345);
$companies = Efaktura::publicApi()->getAllCompanies();
```

### Dependency Injection

[](#dependency-injection)

```
use ItDelmax\LaravelEfaktura\Services\SalesInvoiceService;
use ItDelmax\LaravelEfaktura\Services\PurchaseInvoiceService;
use ItDelmax\LaravelEfaktura\Services\PublicApiService;

class InvoiceController extends Controller
{
    public function __construct(
        protected SalesInvoiceService $salesInvoice,
        protected PurchaseInvoiceService $purchaseInvoice,
        protected PublicApiService $publicApi
    ) {}

    public function show(int $id)
    {
        $invoice = $this->salesInvoice->get($id);

        return view('invoice.show', compact('invoice'));
    }
}
```

### Korišćenje Interface-a za DI

[](#korišćenje-interface-a-za-di)

```
use ItDelmax\LaravelEfaktura\Contracts\SalesInvoiceServiceInterface;
use ItDelmax\LaravelEfaktura\Contracts\PurchaseInvoiceServiceInterface;

class InvoiceService
{
    public function __construct(
        protected SalesInvoiceServiceInterface $salesInvoice,
        protected PurchaseInvoiceServiceInterface $purchaseInvoice
    ) {}
}
```

Primeri
-------

[](#primeri)

### Prodajne fakture (Sales Invoice)

[](#prodajne-fakture-sales-invoice)

```
use ItDelmax\LaravelEfaktura\Facades\SalesInvoice;
use ItDelmax\LaravelEfaktura\Enums\SendToCir;
use ItDelmax\LaravelEfaktura\Enums\SalesInvoiceStatus;

// Dohvati fakturu
$invoice = SalesInvoice::get(12345);
echo $invoice->invoiceNumber;
echo $invoice->payableAmount;
echo $invoice->accountingCustomerParty->name;

// Upload UBL fajla
$result = SalesInvoice::uploadUbl(
    storage_path('invoices/invoice.xml'),
    'request-123',
    SendToCir::Yes
);

// Import XML sadržaja
$xml = file_get_contents(storage_path('invoices/invoice.xml'));
$result = SalesInvoice::importUbl($xml);

// Otkaži fakturu
SalesInvoice::cancel(12345, 'Razlog otkazivanja');

// Storno fakture
SalesInvoice::storno(12345, 'Razlog storniranja');

// Preuzmi PDF
$pdf = SalesInvoice::getPdf(12345);
Storage::put('invoice.pdf', $pdf);

// Ili direktno sačuvaj
SalesInvoice::downloadPdf(12345, storage_path('invoices/12345.pdf'));

// Dohvati promene statusa
$changes = SalesInvoice::getChanges(now()->subDay());
foreach ($changes as $change) {
    logger()->info("{$change->invoiceNumber}: {$change->status}");
}

// Dohvati fakture po statusu
$ids = SalesInvoice::getIds(
    SalesInvoiceStatus::Approved->value,
    now()->startOfMonth(),
    now()->endOfMonth()
);

// Razlozi oslobođenja od PDV-a (keširano)
$reasons = SalesInvoice::getVatExemptionReasons();
```

### Ulazne fakture (Purchase Invoice)

[](#ulazne-fakture-purchase-invoice)

```
use ItDelmax\LaravelEfaktura\Facades\PurchaseInvoice;
use ItDelmax\LaravelEfaktura\Enums\PurchaseInvoiceStatus;

// Dohvati fakturu
$invoice = PurchaseInvoice::get(12345);

// Prihvati fakturu
PurchaseInvoice::accept(12345, 'Prihvaćeno');

// Odbij fakturu
PurchaseInvoice::reject(12345, 'Odbijeno zbog...');

// Prihvati po CIR ID-u
PurchaseInvoice::acceptByCirId('CIR-123456', 'OK');

// Dohvati nove (neobrađene) fakture
$newInvoices = PurchaseInvoice::getNew();
foreach ($newInvoices as $invoice) {
    // Procesiraj fakturu
    PurchaseInvoice::accept($invoice->purchaseInvoiceId);
}

// Pregled faktura sa filterima
$overview = PurchaseInvoice::getOverview(
    PurchaseInvoiceStatus::New->value,
    now()->subMonth(),
    now()
);

// PDV obrnuta naplata
PurchaseInvoice::recordVatReverseCharge(12345, 2000.00, 'Komentar');

// Cesija
PurchaseInvoice::assignCirInvoice('CIR-123', 'JBKJS-456', 'CONTRACT-789');
PurchaseInvoice::cancelCirAssignment('CIR-123');
```

### Public API

[](#public-api)

```
use ItDelmax\LaravelEfaktura\Facades\Efaktura;

// Verzija eFakture
$version = Efaktura::publicApi()->getVersion();

// Sve registrovane kompanije (keširano 24h)
$companies = Efaktura::publicApi()->getAllCompanies();

// Provera da li je kompanija registrovana
$result = Efaktura::publicApi()->checkByPib('123456789');
if ($result->hasAccount && $result->isActive) {
    echo "Kompanija {$result->name} je aktivna";
}

// Jedinice mere (keširano)
$units = Efaktura::publicApi()->getUnitMeasures();

// Pretplata na notifikacije
Efaktura::publicApi()->subscribe();

// Očisti keš
Efaktura::publicApi()->clearCache();
```

Error Handling
--------------

[](#error-handling)

```
use ItDelmax\LaravelEfaktura\Exceptions\EfakturaException;
use ItDelmax\LaravelEfaktura\Facades\SalesInvoice;

try {
    $invoice = SalesInvoice::get(99999);
} catch (EfakturaException $e) {
    logger()->error('eFaktura error', [
        'message' => $e->getMessage(),
        'status' => $e->getHttpStatusCode(),
        'body' => $e->getResponseBody(),
    ]);

    return back()->with('error', 'Greška pri dohvatanju fakture');
}
```

Enumi
-----

[](#enumi)

Paket uključuje PHP 8.1+ enume sa helper metodama:

```
use ItDelmax\LaravelEfaktura\Enums\SalesInvoiceStatus;
use ItDelmax\LaravelEfaktura\Enums\PurchaseInvoiceStatus;

// Status label na srpskom
echo SalesInvoiceStatus::Approved->label(); // "Odobrena"
echo PurchaseInvoiceStatus::New->label();   // "Nova"

// Provera finalnog statusa
if (SalesInvoiceStatus::Approved->isFinal()) {
    // Faktura je u finalnom statusu
}

// Provera da li zahteva akciju
if (PurchaseInvoiceStatus::New->requiresAction()) {
    // Potrebno prihvatiti ili odbiti
}
```

Konfiguracija
-------------

[](#konfiguracija)

```
// config/efaktura.php

return [
    'api_key' => env('EFAKTURA_API_KEY'),

    'environment' => env('EFAKTURA_ENVIRONMENT', 'production'),

    'urls' => [
        'production' => 'https://efaktura.mfin.gov.rs',
        'demo' => 'https://demoefaktura.mfin.gov.rs',
    ],

    'http' => [
        'timeout' => 30,
        'connect_timeout' => 10,
        'retry' => [
            'times' => 3,
            'sleep' => 100,
        ],
    ],

    'logging' => [
        'enabled' => false,
        'channel' => 'stack',
    ],

    'cache' => [
        'enabled' => true,
        'prefix' => 'efaktura_',
        'ttl' => [
            'companies' => 86400,      // 24h
            'unit_measures' => 86400,  // 24h
            'vat_exemptions' => 86400, // 24h
        ],
    ],
];
```

Scheduler (Subscribe)
---------------------

[](#scheduler-subscribe)

eFaktura API zahteva da se svaki dan pozove `subscribe` endpoint da biste primali notifikacije o promenama statusa faktura za sledeći dan.

### Automatski scheduler

[](#automatski-scheduler)

Omogućite automatski scheduler u `.env`:

```
EFAKTURA_SCHEDULER_ENABLED=true
EFAKTURA_SUBSCRIBE_AT=00:05
EFAKTURA_SCHEDULER_LOG=true
```

Paket će automatski registrovati scheduled task koji pokreće `efaktura:subscribe` komandu svaki dan u podešeno vreme.

### Ručno pokretanje

[](#ručno-pokretanje)

Možete ručno pokrenuti subscribe komandu:

```
php artisan efaktura:subscribe
```

### Manualna konfiguracija schedulera

[](#manualna-konfiguracija-schedulera)

Ako želite više kontrole, možete onemogućiti automatski scheduler i dodati task ručno u `routes/console.php`:

```
use Illuminate\Support\Facades\Schedule;

Schedule::command('efaktura:subscribe')
    ->dailyAt('00:05')
    ->withoutOverlapping()
    ->onOneServer()
    ->emailOutputOnFailure('admin@example.com');
```

### .env opcije za scheduler

[](#env-opcije-za-scheduler)

```
# Omogući/onemogući automatski scheduler
EFAKTURA_SCHEDULER_ENABLED=true

# Vreme pokretanja (format HH:MM)
EFAKTURA_SUBSCRIBE_AT=00:05

# Logovanje rezultata
EFAKTURA_SCHEDULER_LOG=true
```

Testiranje
----------

[](#testiranje)

Za testiranje koristite demo okruženje:

```
EFAKTURA_ENVIRONMENT=demo
```

Struktura paketa
----------------

[](#struktura-paketa)

```
src/
├── Contracts/
│   ├── EfakturaClientInterface.php
│   ├── SalesInvoiceServiceInterface.php
│   └── PurchaseInvoiceServiceInterface.php
├── DTO/
│   ├── BaseDTO.php
│   ├── SimpleSalesInvoiceDto.php
│   ├── SimplePurchaseInvoiceDto.php
│   └── ... (ostali DTO-ovi)
├── Enums/
│   ├── SendToCir.php
│   ├── SalesInvoiceStatus.php
│   ├── PurchaseInvoiceStatus.php
│   └── CirInvoiceStatus.php
├── Exceptions/
│   └── EfakturaException.php
├── Facades/
│   ├── Efaktura.php
│   ├── SalesInvoice.php
│   └── PurchaseInvoice.php
├── Services/
│   ├── EfakturaClient.php
│   ├── SalesInvoiceService.php
│   ├── PurchaseInvoiceService.php
│   └── PublicApiService.php
├── EfakturaManager.php
└── EfakturaServiceProvider.php

```

Licenca
-------

[](#licenca)

MIT License

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance74

Regular maintenance activity

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

Total

3

Last Release

146d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3828422?v=4)[Nikola Marčić](/maintainers/marcha)[@marcha](https://github.com/marcha)

---

Top Contributors

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

---

Tags

apilaravelinvoiceserbiaefakturamfin

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/it-delmax-laravel-efaktura/health.svg)

```
[![Health](https://phpackages.com/badges/it-delmax-laravel-efaktura/health.svg)](https://phpackages.com/packages/it-delmax-laravel-efaktura)
```

###  Alternatives

[andreaselia/laravel-api-to-postman

Generate a Postman collection automatically from your Laravel API

1.0k586.2k3](/packages/andreaselia-laravel-api-to-postman)[smodav/mpesa

M-Pesa API implementation

16363.7k1](/packages/smodav-mpesa)[simplestats-io/laravel-client

Client for SimpleStats!

4515.5k](/packages/simplestats-io-laravel-client)[ardakilic/mutlucell

Mutlucell SMS API wrapper for sending sms text messages for Laravel

457.3k](/packages/ardakilic-mutlucell)[dariusiii/tmdb-laravel

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

1821.1k](/packages/dariusiii-tmdb-laravel)[dragon-code/laravel-json-response

Automatically always return a response in JSON format

1118.6k1](/packages/dragon-code-laravel-json-response)

PHPackages © 2026

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