Skip to main content

Izvorni UBL XML

Izvorni XML je prvorazredni oblik unosa. Šalje se cijeli UBL 2.1/HR-CIUS Invoice ili CreditNote, ne FIS zahtjev Porezne uprave.

Izravni XML​

POST /public/v1/outgoing-invoices HTTP/1.1
Authorization: Bearer TOKEN
Content-Type: application/ubl+xml
Idempotency-Key: erp-ubl-2026-000001
IIProxy-Auto-Issue: true
IIProxy-Delivery-Channel: AS4

<?xml version="1.0" encoding="UTF-8"?>
<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2" ...>
  ...
</Invoice>

Podržane vrste sadržaja su application/xml, text/xml i application/ubl+xml. IIProxy-Auto-Issue: true zahtijeva i ovlast invoices:issue.

JSON omotnica​

Omotnica je korisna kada uz XML trebate zadati više alokacija avansa ili druge upravljačke opcije.

{
  "format": "UBL",
  "ublXml": "<?xml version=\"1.0\"?><Invoice ...>...</Invoice>",
  "deliveryChannel": "AS4",
  "advanceApplications": [
    { "sourceInvoiceId": "...", "amount": 100.00 },
    { "documentNumber": "AV-2/2026", "issueDate": "2026-09-10", "amount": 50.00 }
  ],
  "issue": true
}

Što Klik Račun provjerava​

Prije spremanja sustav:

  • odbija DOCTYPE i entity deklaracije;
  • iz SBDH omotnice izdvaja samo samostalni UBL dokument;
  • provjerava OIB dobavljača prema organizaciji vezanoj uz vjerodajnicu;
  • provjerava operatorov OIB prema profilu klijenta;
  • provodi exchange i fiskalizacijsku validaciju;
  • provjerava da se porezni iznosi i iznosi podmirenja mogu sigurno preslikati u interni model;
  • čuva klasifikaciju procesa P1–P12 iz validiranog UBL-a.

Jamstvo očuvanja​

Klik Račun privatno sprema samostalni XML i njegov SHA-256 sažetak. Pri izdavanju ne izrađuje ponovno dokument iz JSON prikaza.

Jedina dopuštena izmjena jest determinističko dodavanje nedostajućih, sustavom upravljanih BG-3 referenci. To je potrebno kada Klik Račun prije konačnog računa izradi storno iskorištenog avansa. Dodavanje poštuje namespace prefikse izvornog dokumenta i UBL redoslijed elemenata.

Efektivni dokument uvijek možete preuzeti na:

GET /public/v1/outgoing-invoices/{invoiceId}/extract-xml/ubl

Ispravci nisu običan unos​

Opća ruta za izradu odbija P10 i InvoiceTypeCode 384. Takav XML mora proći pregled i potvrdu ispravka, gdje se provjeravaju lanac, referenca i inačica izvornika.

Samostalno P9/381 odobrenje dopušteno je kao običan dokument jer nije zamjena za zaštićeni P10 ispravak.