Instalacija

Vodič za početno podešavanje eFiskalizacija.cloud servisa u 5 koraka.

Pregled procesa

eFiskalizacija.cloud je cloud servis (SaaS) - nema potrebe za instalacijom softvera na vašem serveru. Ceo proces podešavanja se svodi na registraciju, dostavu sertifikata i integraciju API-ja.

Korak	Opis	Trajanje
1	Registracija	1 dan
2	Upload PEM sertifikata	Odmah
3	Generisanje API ključeva	Odmah
4	Testiranje u sandbox-u	1-2 dana
5	Prelazak na produkciju	Odmah

Korak 1: Registracija

Kontaktirajte nas za otvaranje naloga:

Email: info@efiskalizacija.cloud
Potrebni podaci: naziv firme, PIB, kontakt osoba, email

Nakon obrade zahteva dobićete pristupne podatke za admin panel.

Napomena: eFiskalizacija.cloud je namenjen isključivo za web šopove i daljinsku prodaju. Nije predviđen za maloprodajne objekte sa fizičkim POS terminalima.

Korak 2: Upload PEM sertifikata

Za fiskalizaciju je neophodan PEM sertifikat izdat od Poreske uprave RS:

Nabavite sertifikat od Poreske uprave (detalji u vodiču za sertifikate)
U admin panelu idite na Podešavanja → Sertifikat
Uploadujte PEM fajl (*_nochain.CERiKEY.pem) i unesite lozinku
Opciono: uploadujte CA chain fajl (*_chain.pem)

Format: PURS dostavlja 7 fajlova. Za eFiskalizaciju koristite PEM format:

*_nochain.CERiKEY.pem - glavni sertifikat (obavezno)
*_chain.pem - CA lanac (opciono, za SSL verifikaciju)

Bezbednost: Lozinka sertifikata se čuva enkriptovano (Sodium). Privatni ključ se nikada ne prenosi van servera.

Korak 3: Generisanje API ključeva

API kredencijale generišete sami u admin panelu:

Prijavite se u admin panel sa dobijenim pristupnim podacima
Idite na Podešavanja → API ključevi
Kliknite Generiši novi ključ
Sačuvajte prikazane kredencijale na sigurno mesto

Podatak	Opis	Primer
API Key	Javni identifikator	`efisk_1_a1b2c3d4...`
API Secret	Tajni ključ za HMAC (64 karaktera)	`x9y8z7w6v5u4t3...`
API URL	Bazni URL endpointa	`https://efiskalizacija.cloud/api/multitenant.php`

Važno: API Secret se prikazuje samo jednom prilikom generisanja! Sačuvajte ga odmah na sigurnom mestu. Ako ga izgubite, morate generisati novi ključ.

Korak 4: Testiranje u sandbox okruženju

Pre prelaska na produkciju, testirajte integraciju u sandbox okruženju:

Koristite sandbox API URL za testne zahteve
Pošaljite testni račun (tip: Obuka/Training)
Verifikujte odgovor - proverite PFR broj i QR kôd
Testirajte refundaciju i kopiju računa
Proverite PDF generisanje

Primer testnog zahteva

<?php
// composer require infogrambeg/efiskalizacija-php-sdk
use Efiskalizacija\EfiskalizacijaClient;
use Efiskalizacija\DTO\Invoice;
use Efiskalizacija\DTO\InvoiceItem;
use Efiskalizacija\Enum\PaymentType;

$client = EfiskalizacijaClient::sandbox(
    getenv('EFISK_API_KEY'),
    getenv('EFISK_API_SECRET')
);

$invoice = Invoice::create()
    ->addItem(new InvoiceItem(
        naziv: 'Test proizvod',
        kolicina: 1,
        jedinicnaCena: 100.00, // cena BEZ PDV-a (osnovica); ukupno = 120 RSD za PDV 20%
        pdvStopa: 19, // sandbox koristi stopu 19%
    ))
    ->setPaymentType(PaymentType::Kartica);

$result = $client->fiskalizacija()->fiskalizuj($invoice);

echo "PFR broj: " . $result->pfrBroj;

Napomena: jedinicnaCena je cena BEZ PDV-a (osnovica). PDV se obračunava i dodaje na vrh. U primeru iznad: 100,00 RSD × 19% PDV (sandbox) = ukupno 119,00 RSD. Sandbox koristi PDV stopu 19%, produkcija 20% — koristite EfiskalizacijaClient::create() za produkcijsko okruženje. PFR broj je dostupan u $result->pfrBroj.

Korak 5: Prelazak na produkciju

Kada ste zadovoljni testiranjem:

Kontaktirajte nas za aktivaciju produkcijskog okruženja
Zamenite sandbox URL sa produkcijskim u vašoj konfiguraciji
Pošaljite prvi pravi račun
Verifikujte na portalu Poreske uprave (suf.purs.gov.rs)

Napomena: PDV stope se razlikuju između sandbox i produkcije:
Sandbox: 19% (Ж), 10% (A), 0% oslobodjen (B), 0% nije u PDV (C)
Produkcija: 20% (Ђ), 10% (Е), 0% oslobodjen (Г), 0% nije u PDV (А)

Sistemski zahtevi

Za integraciju sa vašim web šopom potrebno je:

Zahtev	Detalji
HTTPS	Vaš server mora podržavati SSL/TLS konekciju
Programski jezik	PHP 8.3+, Python 3.8+, Node.js 18+ (ili bilo koji sa HMAC podrškom)
Internet	Stabilna internet konekcija za komunikaciju sa API-jem
JSON podrška	Mogućnost parsiranja JSON odgovora
HMAC-SHA256	Kriptografska biblioteka za potpisivanje zahteva

Nakon uspešne instalacije, pogledajte konfiguraciju za napredna podešavanja ili korisničko uputstvo za rad u admin panelu.