Dokumentacija API

Vse kar potrebujete za integracijo e-Račun Hub API v vašo aplikacijo.

POST /api/v1/convert

Pretvori univerzalni JSON model v e-SLOG 2.0 XML in/ali PDF račun. PDF različica lahko vključuje UPN QR kodo za takojšnje plačilo — pišite na [email protected].

Query parametri

Parameter Vrednosti Privzeto
formateslog20eslog20
outputxml · pdf · bothxml

Primer zahteve

POST /api/v1/convert?format=eslog20&output=xml
Content-Type: application/json

{
  "invoiceIdentifier": "2026-0001",
  "issueDate": "2026-04-23",
  "serviceDate": "2026-04-23",
  "dueDate": "2026-05-08",
  "seller": {
    "name": "Moje Podjetje d.o.o.",
    "taxId": "12345679",
    "iban": "SI56020170014356205",
    "isVatObligated": true
  },
  "buyer": { "name": "Kupec d.o.o.", "taxId": "87654326" },
  "items": [{ "description": "Svetovanje", "quantity": 10, "unitPrice": 85, "vatRate": 0.22 }],
  "paymentInfo": { "iban": "SI56020170014356205", "reference": "SI1220260008" }
}

Primer odgovora

{
  "success": true,
  "xmlContent": "<?xml version=\"1.0\" ...><Invoice xmlns=\"urn:eslog:2.00\">...</Invoice>",
  "pdfBase64": null,
  "issues": []
}
POST /api/v1/validate

3-nivojsko preverjanje JSON modela (poslovna pravila + slovenska skladnost + XSD shema).

{
  "isValid": false,
  "issues": [
    {
      "field": "seller.taxId",
      "message": "Davčna številka prodajalca ni veljavna.",
      "severity": "Error"
    }
  ]
}
POST /api/v1/validate-raw-xml

Validacija obstoječe XML datoteke proti e-SLOG 2.0 XSD shemi. Telo zahteve mora biti text/plain ali application/xml. 

POST /api/v1/validate-raw-xml
Content-Type: text/plain

<?xml version="1.0" encoding='UTF-8'?>
<Invoice xmlns="urn:eslog:2.00">...</Invoice>

Nivoji preverjanja

Nivo 1 XSD shema POST /api/v1/validate & /api/v1/validate-raw-xml

Preverja strukturno ustreznost XML glede na uradno e-SLOG 2.0 XSD shemo (UJP/GZS).

Nivo 2 Poslovna pravila POST /api/v1/validate

Preverja SI davčno številko (kontrolna številka), veljavnost IBAN, datumsko logiko in obvezna polja.

Nivo 3 Slovenska skladnost POST /api/v1/validate

UJP-specifična pravila: zaokroževanje zneskov, kontrolna številka za SI12 sklice, pravilna uporaba DDV kategorij (S, E, AE).