API Dokumentacija
REST API za provjeru statusa e-racuna, pregled informacijskih posrednika i statistike trzista.
Content-Type: application/json).
X-RateLimit-Limit i X-RateLimit-Remaining.
Ako prekoracite limit, dobit cete 429 Too Many Requests s Retry-After headerom.
Za vece potrebe javite se na
info@informacija.hr.
Provjeri je li tvrtka registrirana za primanje e-racuna. Vraca status registracije, informacijskog posrednika, datume aktivacije i tehnicke detalje.
Parametri
| Parametar | Opis |
|---|---|
| oib obavezno string |
OIB tvrtke (tocno 11 znamenki). Primjer: 51404356549 |
Primjer zahtjeva
# Provjera statusa e-racuna za OIB
curl https://eracun.informacija.hr/api/lookup/51404356549
fetch('https://eracun.informacija.hr/api/lookup/51404356549') .then(function(response) { return response.json(); }) .then(function(data) { if (data.success) { console.log('Status:', data.status); console.log('Posrednik:', data.posrednikNaziv || data.posrednikOib); } else { console.log('Nije registriran:', data.errorMessage); } });
using System.Net.Http; using System.Text.Json; HttpClient client = new HttpClient(); string url = "https://eracun.informacija.hr/api/lookup/51404356549"; HttpResponseMessage response = client.GetAsync(url).GetAwaiter().GetResult(); string json = response.Content.ReadAsStringAsync().GetAwaiter().GetResult(); JsonDocument doc = JsonDocument.Parse(json); bool success = doc.RootElement.GetProperty("success").GetBoolean(); if (success) { string status = doc.RootElement.GetProperty("status").GetString(); string posrednik = doc.RootElement.GetProperty("posrednikOib").GetString(); Console.WriteLine($"Status: {status}, Posrednik: {posrednik}"); }
Polja odgovora
Active, Pending, Expired ili NotRegistered
yyyy-MM-dd)
yyyy-MM-dd)
success = false)
Primjeri odgovora
200 OK Tvrtka je registrirana
{
"success": true,
"errorMessage": "",
"oib": "51404356549",
"status": "Active",
"endpointUri": "https://test.as4.eposlovanje.hr/services/msh",
"mpsUrl": "https://gateway.apis-it.hr/eRacun-SMP",
"posrednikOib": "62781739468",
"posrednikNaziv": "FINA d.o.o.",
"activationDate": "2025-01-01",
"expirationDate": "2025-12-31",
"serviceDescription": "Zaprimanje elektronickih dokumenata",
"technicalContactUrl": "https://www.fina.hr",
"timestamp": "2025-01-13T15:30:00Z"
}
404 Tvrtka nije registrirana
{
"success": false,
"errorMessage": "Primatelj nije registriran",
"oib": "00000000000",
"status": "NotRegistered",
"timestamp": "2025-01-13T15:30:00Z"
}
400 Neispravan OIB format
{
"success": false,
"errorMessage": "OIB mora sadrzavati tocno 11 znamenki.",
"oib": "123",
"status": ""
}
Isprobaj
Testiraj lookup
Dohvati podatke o tvrtki iz Sudskog registra (naziv, adresa, MBS, status). Rezultati se cacheiraju 30 dana.
Parametri
| Parametar | Opis |
|---|---|
| oib obavezno string |
OIB tvrtke (tocno 11 znamenki). Primjer: 51404356549 |
Primjer zahtjeva
curl https://eracun.informacija.hr/api/company/51404356549
Polja odgovora
Primjeri odgovora
200 OK Tvrtka pronadena
{
"success": true,
"oib": "51404356549",
"naziv": "Informacija d.o.o. za informaticke usluge",
"skraceniNaziv": "Informacija d.o.o.",
"adresa": "Vukovarska 12",
"mjesto": "Zagreb",
"postanskiBroj": "10000",
"mbs": "081234567",
"statusSubjekta": "Aktivan",
"vrstaSubjekta": "d.o.o.",
"cachedResult": false,
"timestamp": "2025-01-13T15:30:00Z"
}
404 Tvrtka nije u registru
{
"success": false,
"errorMessage": "Tvrtka nije pronadena u Sudskom registru.",
"oib": "00000000000"
}
Isprobaj
Testiraj company lookup
Vraca listu svih registriranih informacijskih posrednika (access pointova) u Hrvatskoj, zajedno s brojem klijenata i tehnickim detaljima.
Polja odgovora
Primjer odgovora
200 OK
{
"providers": [
{
"oib": "85821130368",
"naziv": "FINA",
"clientCount": 1247,
"endpointUri": "https://as4.fina.hr/services/msh",
"firstSeen": "2025-01-10T08:00:00Z",
"lastSeen": "2025-01-13T15:30:00Z"
}
]
}
Isprobaj
Vraca detalje o pojedinom informacijskom posredniku.
| Parametar | Opis |
|---|---|
| oib obavezno string |
OIB informacijskog posrednika |
Primjer odgovora
200 OK
{
"oib": "85821130368",
"naziv": "FINA",
"endpointUri": "https://as4.fina.hr/services/msh",
"mpsUrl": "https://gateway.apis-it.hr/eRacun-SMP",
"serviceDescription": "Zaprimanje elektronickih dokumenata",
"technicalContactUrl": "https://www.fina.hr",
"clientCount": 1247,
"firstSeen": "2025-01-10T08:00:00Z",
"lastSeen": "2025-01-13T15:30:00Z"
}
404 Posrednik ne postoji
{
"error": "Posrednik nije pronaden."
}
Primjeri integracije
Primjer kako provjeriti vise OIB-ova s pauzom izmedju zahtjeva.
#!/bin/bash # Batch provjera OIB-ova iz datoteke (jedan OIB po liniji) while IFS= read -r oib; do echo "Provjera: $oib" curl -s "https://eracun.informacija.hr/api/lookup/$oib" \ | jq '{oib: .oib, status: .status, posrednik: .posrednikNaziv}' sleep 1 # pauza od 1 sekunde done < oib-lista.txt
// Batch provjera s pauzom od 1 sekunde izmedju zahtjeva const oibs = ['51404356549', '85821130368', '62781739468']; const BASE = 'https://eracun.informacija.hr'; function sleep(ms) { return new Promise(function(resolve) { setTimeout(resolve, ms); }); } async function batchLookup() { for (const oib of oibs) { const res = await fetch(BASE + '/api/lookup/' + oib); const data = await res.json(); console.log(oib, data.success ? data.status : data.errorMessage); await sleep(1000); } } batchLookup();
using System; using System.Collections.Generic; using System.Net.Http; using System.Text.Json; using System.Threading; HttpClient client = new HttpClient(); string baseUrl = "https://eracun.informacija.hr"; List<string> oibs = new List<string> { "51404356549", "85821130368", "62781739468" }; foreach (string oib in oibs) { string url = baseUrl + "/api/lookup/" + oib; HttpResponseMessage response = client.GetAsync(url).GetAwaiter().GetResult(); string json = response.Content.ReadAsStringAsync().GetAwaiter().GetResult(); JsonDocument doc = JsonDocument.Parse(json); bool success = doc.RootElement.GetProperty("success").GetBoolean(); Console.WriteLine("{0}: {1}", oib, success ? doc.RootElement.GetProperty("status").GetString() : doc.RootElement.GetProperty("errorMessage").GetString()); Thread.Sleep(1000); // pauza 1 sek }
HTTP status kodovi
| Kod | Znacenje |
|---|---|
| 200 | Uspjesno. OIB je registriran (za lookup) ili podaci su dohvaceni (za ostale endpointe). |
| 400 | Neispravan zahtjev. OIB nema 11 znamenki ili sadrzi nedozvoljene znakove. |
| 404 | Nije pronadeno. OIB nije registriran za e-racune, ili trazeni posrednik ne postoji. |
| 429 | Prekoracen rate limit (60 zahtjeva/min). Sacekajte prema Retry-After headeru. |
| 500 | Interna greska servera. Pokusajte ponovno ili kontaktirajte nas. |