📡 HrFiskalizator – SUPER Plugin API Dokumentacija

const res = await fetch('/super/ping');
const txt = await res.text();
console.log(txt);

 {
  "message": "SUPER plugin OK",
  "version": 1,
  "mode": "PRODUKCIJSKI",
  "endpoint": "https://api.super.hr"
}
                

const res = await fetch('/super/getmode');
const txt = await res.text();
// npr. "TEST" ili "PRODUCTION"

TEST

const res = await fetch('/super/accounts');
const list = await res.json();
// [{oib, naziv}, ...]

[
  { "oib": "12345678901", "naziv": "Firma d.o.o." },
  { "oib": "98765432109", "naziv": "Druga d.o.o." }
]

const res = await fetch('/super/setactiveoib?oib=12345678901');
const data = await res.json();

{
  "success": true,
  "oib": "12345678901",
  "naziv": "Firma d.o.o.",
  "message": "Active OIB set"
}

const xmlContent = '<?xml version="1.0"...>';
const res = await fetch('/super/sendxmlinvoice?oib=12345678901', {
    method: 'POST',
    headers: { 'Content-Type': 'text/plain; charset=UTF-8' },
    body: xmlContent
});
const data = await res.json();
console.log(data);

const res = await fetch(
    '/super/sendxmlinvoice?oib=12345678901&pdfname=racun-001.pdf',
    {
        method: 'POST',
        headers: { 'Content-Type': 'text/plain; charset=UTF-8' },
        body: xmlContent
    }
);
const data = await res.json();

const guid = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx';
const res = await fetch(
    '/super/getxmlinvoice/outgoing/' + guid + '?oib=12345678901'
);
const xml = await res.text();
// Content-Type: application/xml; charset=UTF-8

const guid = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx';
const url = '/super/getxmlinvoice/incoming/' + guid + '?oib=12345678901';
const a = document.createElement('a');
a.href = url;
a.download = 'racun.xml';
a.click();

const guid = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx';
const res = await fetch(
    '/super/getinvoicepdf/outgoing/' + guid + '?oib=12345678901'
);
const blob = await res.blob();
// Content-Type: application/pdf

const url = '/super/getinvoicepdf/incoming/' + guid + '?oib=12345678901';
const a = document.createElement('a');
a.href = url;
a.download = 'racun.pdf';
a.click();

const guid = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx';
const res = await fetch(
    '/super/nativevizualizacija/outgoing/' + guid + '?oib=12345678901'
);
const blob = await res.blob();
const url = URL.createObjectURL(blob);
window.open(url, '_blank');
// Content-Type: application/pdf

const url = '/super/nativevizualizacija/incoming/'
    + guid + '?oib=12345678901';
const a = document.createElement('a');
a.href = url;
a.download = 'vizualizacija.pdf';
a.click();

const guid = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx';
const res = await fetch(
    '/super/getinvoicehtml/outgoing/' + guid + '?oib=12345678901'
);
const html = await res.text();
// Content-Type: text/html; charset=UTF-8
document.getElementById('preview').innerHTML = html;

const url = '/super/getinvoicehtml/incoming/'
    + guid + '?oib=12345678901';
document.getElementById('iframe').src = url;

const guid = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx';
const res = await fetch(
    '/super/getinvoicevisualization/outgoing/' + guid + '?oib=12345678901'
);
const blob = await res.blob();
// Content-Type: application/pdf

const res = await fetch(
    '/super/Invoice/GetInvoiceList?oib=12345678901',
    {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
            DateFrom: '2026-01-01',
            DateTo:   '2026-01-31'
        })
    }
);
const data = await res.json();
const list = data.invoices || [];

const res = await fetch(
    '/super/SendingInvoice/GetSendingInvoiceList?oib=12345678901',
    {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
            DateFrom: '2026-01-01',
            DateTo:   '2026-01-31'
        })
    }
);
const data = await res.json();
const list = data.sendingInvoices || [];

const qs = new URLSearchParams({
    oib:          '12345678901',
    targetfolder: 'C:\\Racuni\\2026-01',
    smjer:        'incoming',
    odDatuma:     '2026-01-01',
    doDatuma:     '2026-01-31'
});
const res = await fetch(
    '/super/downloadperiodtoserverfolder?' + qs,
    { method: 'POST' }
);
const data = await res.json();

{
  "success": true,
  "smjer": "incoming",
  "folder": "C:\\Racuni\\2026-01",
  "downloaded": 42,
  "failed": 0
}

{
  "success": true,
  "smjer": "outgoing",
  "folder": "C:\\Racuni\\2026-01",
  "downloaded": 39,
  "failed": 3,
  "failedList": [
    "2026-1-7",
    "2026-1-15",
    "2026-1-28"
  ]
}

const res = await fetch(
    '/super/EReporting/RejectInvoice?oib=12345678901',
    {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
            Guid: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
            RejectReasonType: 1,
            RejectionReasonDescription: 'Pogrešan iznos'
        })
    }
);
const data = await res.json();

{
  "MessageId": "...",
  "ErrorMessage": null
}

const res = await fetch(
    '/super/EReporting/AddPaymentForSendingInvoice?oib=12345678901',
    {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
            Guid:             'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
            PaymentDate:      '2026-01-20',
            PaymentAmount:    1234.56,
            PaymentMethod:    1,
            MarkAsPaidInFull: true
        })
    }
);
const data = await res.json();

{
  "MessageId": "...",
  "ErrorMessage": null
}

const res = await fetch('/super/token?oib=12345678901');
const data = await res.json();

{
  "oib":     "12345678901",
  "token":   "eyJhbGciOiJSUzI1NiIsInR5cCI6...",
  "message": "Token refreshed"
}

// Npr. dohvat detalja računa direktno
const res = await fetch(
    '/super/SendingInvoice/GetSendingInvoice?oib=12345678901',
    {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ Guid: 'xxxxxxxx-...' })
    }
);
const data = await res.json();

const res = await fetch(
    '/super/SendingInvoice/GetSendingInvoice?oib=12345678901&response=INI',
    {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ Guid: 'xxxxxxxx-...' })
    }
);
const ini = await res.text();
// MessageId=xxxxxxxx-...
// Guid=yyyyyyyy-...

const res = await fetch('/super/getinvoicestatuses');
const data = await res.json();

{
  "outgoing": {
    "10":  "Račun u stanju nacrta",
    "40":  "Poslano",
    "50":  "Greška kod slanja",
    "55":  "Nemogućnost dostave",
    "60":  "Dostavljeno",
    "90":  "Odbijeno",
    "100": "Djelomično plaćeno",
    "110": "Plaćeno"
  },
  "incoming": {
    "10": "Zaprimljeno",
    "40": "Odbijeno"
  },
  "paymentMethods": {
    "1":  "Transakcijski račun",
    "2":  "Obračunsko plaćanje",
    "11": "Ostalo"
  },
  "rejectReasons": {
    "1":  "Neusklađenost koja ne utječe na obračun poreza",
    "2":  "Neusklađenost koja utječe na obračun poreza",
    "11": "Ostalo"
  }
}