API integracija KPD klasifikacije u ERP i računovodstveni sustav
Ručno unošenje KPD šifara u ERP ili računovodstveni sustav gubi smisao kada se radi o stotinama transakcija dnevno. API integracija KPDinfo.hr omogućava automatsku KPD klasifikaciju direktno unutar vašeg poslovnog softvera, bez ikakvog ručnog rada.
Što je KPDinfo.hr API?
KPDinfo.hr REST API je programsko sučelje koje vam omogućava da:
- Automatski klasificirate stavke prema opisu iz vašeg ERP-a
- Dobijete KPD šifru, NKD razred i confidence score za svaku stavku
- Integrirate klasifikaciju u real-time tok izrade računa
- Batch klasificirate stotine stavki odjednom
Osnove REST API-ja
API koristi standardni JSON format i Bearer Token autentifikaciju:
POST https://kpdinfo.hr/api/v1/classify
Authorization: Bearer kpdai_xxxxxxxxxxxxxxxx
Content-Type: application/json
{
"query": "Razvoj mobilne aplikacije za Android",
"type": "Usluge"
}
Primjer odgovora
{
"mainKpdCode": "KPD 2025 (provjera točne podšifre u službenom šifrarniku)",
"mainKpdName": "Izrada softvera po narudžbi",
"nkdCode": "KPD 2025 (provjera točne podšifre u službenom šifrarniku)",
"nkdName": "Računalno programiranje",
"confidence": 92,
"status": "Visoka sigurnost",
"alternatives": [
{ "kpdCode": "KPD 2025 (provjera točne podšifre u službenom šifrarniku).19", "kpdName": "Ostale usluge razvoja softvera" }
]
}
Kako dobiti API ključ?
- Registrirajte se na KPDinfo.hr
- Prijavite se u korisnički panel
- Otvorite sekciju "API ključevi"
- Kliknite "Novi API ključ" i imenujte ga (npr. "ERP integracija")
- Kopirajte ključ — prikazuje se samo jednom!
API pristup dostupan je u Enterprise planu. Kontaktirajte nas za više informacija: info@kpdinfo.hr.
Integracija s popularnim ERP sustavima
SAP / Microsoft Dynamics
Za SAP i Dynamics integraciju koristite standardni HTTP konektor ili BTP (Business Technology Platform). Pozovite API pri kreiranju fakture u modulu SD (Sales & Distribution), automatizirajući mapiranje materijala na KPD šifre.
Minimax, 4D, Synesis (HR računovodstveni programi)
Majority HR računovodstvenih programa podržava webhook ili plugin arhitekturu. Naš tim može osigurati gotov plugin za popularne HR programe. Kontaktirajte nas na info@kpdinfo.hr.
Vlastiti razvoj (REST integracija)
Za vlastite aplikacije, koristite standardni HTTP klijent u vašem programskom jeziku:
# PHP primjer
$response = file_get_contents('https://kpdinfo.hr/api/v1/classify', false,
stream_context_create(['http' => [
'method' => 'POST',
'header' => "Authorization: Bearer kpdai_xxx\nContent-Type: application/json",
'content' => json_encode(['query' => $itemDescription])
]])
);
$kpd = json_decode($response, true);
$kpdCode = $kpd['mainKpdCode'];
Rate limiting i kvote
API kvote ovise o vašem planu:
- Starter: 100 API poziva/mj
- Pro: 1.000 API poziva/mj
- Enterprise: Neograničeno + SLA garancije
Svaki API poziv troši 1 upit iz vaše kvote.
Webhook notifikacije
Enterprise plan uključuje webhook podršku — KPDinfo.hr može slati notifikacije na vaš endpoint pri promjenama u KPD šifrarniku, što vam omogućava automatsko ažuriranje mapiranja u ERP-u.
Sigurnost i privatnost
- Svi API pozivi su zaštićeni HTTPS-om (TLS 1.2+)
- API ključevi se mogu ograničiti na specifične domene/IP adrese
- Podaci o upitima se čuvaju 12 mjeseci i dostupni su u panelu
- GDPR usklađenost — nema dijeljenja podataka s trećim stranama
Česta pitanja
Postoji li sandbox okruženje za testiranje?
Da. Koristite base URL https://kpdinfo.hr/api/v1/ s test API ključem dobivenim u panelu. Test ključevi ne troše kvotu.
Koliko je API brz?
Prosječno vrijeme odgovora je 150–300ms po zahtjevu. Za batch endpoint, obrada 100 stavki traje oko 3–5 sekundi.
Mogu li paralelno slati više zahtjeva?
Da, podržavamo paralelne zahtjeve. Enterprise plan ima povišene rate limits za visoke volumene.
Počnite s integracijom: Preuzmite API dokumentaciju ili kontaktirajte nas za besplatnu tehničku konzultaciju.