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
$client = new EfiskalizacijaClient(
    getenv('EFISK_API_KEY'),
    getenv('EFISK_API_SECRET'),
    getenv('EFISK_API_URL')
);

$racun = $client->fiskalizuj([
    'tip_racuna' => 'prodaja',
    'nacin_placanja' => 'kartica',
    'stavke' => [
        [
            'naziv' => 'Test proizvod',
            'kolicina' => 1,
            'cena' => 100.00,
            'pdv_stopa' => 20,
        ]
    ]
]);

echo "PFR broj: " . $racun['pfr_broj'];

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.