Skip to main content

Brzi početak

Za integraciju su potrebni client_id, jednokratno prikazani client_secret i popis dodijeljenih ovlasti. Vjerodajnice se izdaju izvan Public API-ja kroz administrativni postupak.

1. Dohvatite token​

POST/oauth2/token
curl --request POST 'https://iiproxy.sekkun.co/oauth2/token' \
  --user "$CLIENT_ID:$CLIENT_SECRET" \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'scope=invoices:read invoices:draft invoices:issue'
{
  "access_token": "opaque-token",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "invoices:draft invoices:issue invoices:read"
}

Token čuvajte samo na poslužitelju. Nemojte ga ugrađivati u preglednik, mobilnu aplikaciju ili javni repozitorij.

2. Izradite i odmah izdajte račun​

POST/public/v1/outgoing-invoices
curl --request POST 'https://iiproxy.sekkun.co/public/v1/outgoing-invoices' \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: invoice-$ERP_DOCUMENT_UUID" \
  --data '{
    "numberMode": "AUTO",
    "issueDate": "2026-09-27",
    "deliveryDate": "2026-09-27",
    "dueDate": "2026-10-12",
    "currency": "EUR",
    "deliveryChannel": "AS4",
    "customer": {
      "oib": "10987654321",
      "name": "Primatelj d.o.o.",
      "countryCode": "HR"
    },
    "lines": [{
      "code": "SVC-01",
      "name": "Usluga održavanja",
      "quantity": 1,
      "unitCode": "H87",
      "unitPrice": 100,
      "taxCode": "PDV25",
      "taxRate": 25,
      "ublTaxCategory": "S",
      "classification": { "value": "62.01.11", "schemeId": "CG" }
    }],
    "issue": true
  }'

Odgovor 202 Accepted sadrži račun i operationId. issue: true zahtijeva i invoices:issue.

3. Pratite operaciju​

GET/public/v1/operations/{operationId}
curl 'https://iiproxy.sekkun.co/public/v1/operations/OPERATION_ID' \
  --header "Authorization: Bearer $ACCESS_TOKEN"

Terminalni status je ISSUED, CORRECTED, REVERSED ili FAILED. ACTION_REQUIRED znači da je vanjski ishod nepoznat i da automatsko ponovno slanje nije sigurno.

4. Preuzmite stvarno izdani UBL​

curl 'https://iiproxy.sekkun.co/public/v1/outgoing-invoices/INVOICE_ID/extract-xml/ubl' \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --output invoice.xml

Za integraciju koja polazi od XML-a nastavite na Izvorni UBL.