Uvod u FiskalAPI

FiskalAPI je REST API koji omogućuje jednostavnu integraciju fiskalizacije (F1) i eRačuna (F2) u vaš sustav. Mi se brinemo o kompleksnosti, vi dobijete jednostavan JSON API.

🚀 Brzi početak

Za početak trebate samo API ključ. Sandbox ključ dobijete odmah po registraciji.

Registriraj se besplatno →

Što FiskalAPI rješava?

Integracija s Poreznom upravom tradicionalno zahtijeva:

SOAP protokol s XML porukama
Digitalni certifikat (FINA)
Potpisivanje XML-a s certifikatom
Razumijevanje XSD shema
Handling grešaka i retry logika

FiskalAPI sve to apstrahira. Vi šaljete jednostavan JSON, mi vraćamo JIR (jedinstveni identifikator računa) ili potvrdu eRačuna.

Bez FiskalAPI-ja

• Kupnja i instalacija FINA certifikata
• Implementacija SOAP klijenta
• XML potpisivanje (XMLDSig)
• Parsiranje XML odgovora
• Handling svih edge caseova
• Održavanje i rotacija certifikata

~2-4 tjedna development

S FiskalAPI-jem

• REST API s JSON payloadima
• Jedan API ključ
• Standardni HTTP statusi
• Webhooks za notifikacije
• Dashboard za monitoring
• Mi brinemo o certifikatima

~1-2 sata integracije

Arhitektura

┌─────────────┐      ┌─────────────┐      ┌─────────────┐
│   Vaš app   │ ───▶ │  FiskalAPI  │ ───▶ │   Porezna   │
│   (JSON)    │ ◀─── │  (SOAP/XML) │ ◀─── │    FINA     │
└─────────────┘      └─────────────┘      └─────────────┘
       │                    │
       │              ┌─────┴─────┐
       │              │ Certifikat │
       │              │  (FINA)    │
       │              └───────────┘
       │
       └──▶ Webhook notifikacije

Dvije vrste fiskalizacije

F1 — Fiskalizacija računa

Za gotovinske i kartične transakcije. Račun se šalje Poreznoj u realnom vremenu, dobijete JIR koji mora biti na računu.

• Gotovina, kartice, PayPal
• Real-time (sync)
• Obavezno od 2013.

F1 dokumentacija →

F2 — eRačuni

Za B2B i B2G transakcije. Strukturirani račun u UBL formatu koji se šalje kroz FINA infrastrukturu.

• Računi prema firmama (B2B)
• Računi prema državi (B2G)
• Obavezno od 2026. za PDV obveznike

F2 dokumentacija →

Okruženja

Okruženje	Base URL	Svrha
`Sandbox`	`https://sandbox.fiskalapi.hr/v1`	Testiranje bez stvarnih računa
`Production`	`https://api.fiskalapi.hr/v1`	Stvarni računi prema Poreznoj

Sandbox okruženje simulira sve odgovore Porezne uprave. Možete testirati cijelu integraciju bez straha od stvarnih posljedica.

Sljedeći koraci

1. Autentifikacija

Postavite API ključ

2. Prvi račun

Fiskalizirajte test račun

3. Webhooks

Postavite notifikacije