Dnevnik sprememb

2026-06-11 — števila obrokov po vrsti, izvor tečaja, koda za nedosegljiv tečaj

Tri dodatne spremembe površine. Vse so združljive za nazaj: obstoječi zahtevki še naprej delujejo nespremenjeno, nova polja v odgovorih pa so dodatki, ki jih lahko prezrete, dokler jih ne potrebujete.

  • Števila obrokov po vrsti pri ustvarjanju/posodabljanju dnevnice. Zahtevki za dnevnice zdaj sprejemajo breakfastsProvided, lunchesProvided in dinnersProvided (celoštevilska števila obrokov po vrsti) ter neobvezno razporeditev po dnevu mealsProvidedAllocation. So kanonski model za zapis: strežnik iz teh števil znova izračuna zmanjšanje. Obstoječi v1 skupni mealsProvided se še vedno sprejema; kadar polja po vrsti manjkajo, strežnik preslika vsoto kot prej, zato starejši odjemalci niso prizadeti. Odgovori še naprej vračajo izpeljani mealsProvided (kosilo + večerja, oblika HR Pravilnika) skupaj s števili po vrsti, zato so poti branja nespremenjene.
  • Izvor tečaja v odgovorih. Odgovori za stroške in dnevnice pridobijo exchangeRateSource, odgovor potnega naloga pa advancePaymentExchangeRateSource, ki zabeleži, od kod prihaja uporabljeni tečaj: koda ponudnika ("HNB", "ECB") za uradni tečaj, "MANUAL" za ročno vnesen tečaj, ali null za vrstico v isti valuti (brez pretvorbe) ali starejšo vrstico, shranjeno pred sledenjem izvora. Samo za branje, brez spremembe zahtevka.
  • Nova koda napake EXCHANGE_RATE_UNAVAILABLE (HTTP 400). Pojavi se, kadar ponudnik tečaja tenanta ne objavi tečaja za valuto na zahtevani datum in ni zgodovinskega tečaja, na katerega bi se lahko zanesli. Napaka je iz družine preverjanj s standardnim telesom errors po poljih, zato lahko specifično razločite primer nedosegljivega tečaja in zahtevate ročni tečaj. Dodano v katalog napak.

2026-05-23 — časi dnevnic iz itinerarja se shranjujejo kot pravi UTC (popravek)

Časi dnevnic, shranjeni prek POST /api/v1/travel-entries/{id}/per-diems/from-itinerary, se zdaj shranjujejo kot pravi trenutki UTC. Prej se je odhod/prihod vsakega odseka shranil z vrednostjo stenske ure, označeno kot UTC brez zamika (lokalni odsek ob 08:00 se je shranil kot 08:00Z namesto 07:00Z/06:00Z), zato so vrstice, ustvarjene iz itinerarja, od ročno dodanih odstopale za 1–2 uri in se prikazovale z zamudo. Shemi zahteve in odgovora sta nespremenjeni, vendar vrednosti departureTime/arrivalTime, ki jih ta endpoint vrne (in ki jih vrnejo poznejša branja istih vrstic), zdaj odražajo popravljeni trenutek UTC. Kalkulator za predogled še vedno vrača čase stenske ure. Zneski dnevnic niso prizadeti.

2026-05-23 — kalkulator dnevnic + shranjevanje celotne poti

Površina za izračun dnevnic je združena in pridobi enakovrednost shranjevanja celotne poti z locco spletno aplikacijo.

  • Novo POST /api/v1/utilities/per-diems/calculate — kalkulator brez stanja. Pošljite itinerar (en odsek = itinerar z dvema postajama) in prejmite nazaj izračunane vrstice z uporabljeno prerazporeditvijo na ravni itinerarja. Brez konteksta naloga, nič se ne shrani.
  • Novo POST /api/v1/travel-entries/{id}/per-diems/from-itinerary — znova izračunajte dnevnice potnega naloga iz itinerarja v enem klicu. Strežnik znova zažene svoj lasten mehanizem nad postajami (poslanim zneskom se nikoli ne zaupa), uporabi obroke po odseku vezane s ključem (countryCode, departureTime) (pari, ki jih vrne kalkulator), nato atomarno zamenja dnevnice naloga. S tem se reproducirata prerazporeditev na ravni itinerarja in nadgradnje domačih enot, ki jih pošiljanje vrstic ena za drugo ne more.
  • Odstranjeno POST /api/v1/travel-entries/{id}/per-diems/compute in POST /api/v1/per-diems/calculate-simple. Oba sta zajeta v utilities/per-diems/calculate — en odsek je le itinerar z dvema postajama. Premaknite integracije na novi kalkulator.

2026-05-22 — Podpora za slovenski trg

Začetna podpora za slovenske tenante. Posodobite odjemalca z osveženim OpenAPI snapshotom na /sl/api-reference/:

  • Slovenske občine — nov GET /api/v1/reference/slovenian-municipalities vrne SURS-ov seznam občin za izbiro kraja v spustnih seznamih na slovenskih potnih nalogih. Klic je mogoč iz katerega koli tenanta.
  • Davčno rezidentstvo zaposlenih — zapisom zaposlenih je dodano polje residency (Resident / NonResident) za slovensko poročanje o dnevnicah in davkih na plačo. Privzeta vrednost je Resident.

2026-04-28 — v1.0 izdana

Prva stabilna izdaja locco partnerskega API-ja. Vse površine so povezane, tipizirane in pokrite z OpenAPI snapshotom na /api-reference/:

  • Potni nalogi — popoln CRUD in akcije toka odobritev (oddaja, odobritev, zavrnitev, preklic, zahteva po spremembah), z atomarnim ustvarjanjem z vgnezdenimi stroški, dnevnicami, razdelitvami po stroškovnih mestih in prilogami v enem klicu.
  • Priloge — neposreden prenos na potni nalog prek POST /api/v1/travel-entries/{id}/attachments. Multipart, do 5 datotek na zahtevek.
  • Webhooks — registracija naročnine z enkratnim prikazom signing-secret-a, zgodovina dostav po naročnini in endpoint za ponovni poskus neuspelih ali izčrpanih dostav.
  • Izplačila — seznam nalogov, pripravljenih za izplačilo, ustvarjanje serij, zgodovina, brisanje serije.
  • Zaposleni, Oddelki, Vozila, Stroškovna mesta — CRUD in seznami, s prilagojenimi polji na zaposlenih.
  • Reference — hrvaške občine, HNB tečajne liste, tabela dnevnic, seznami dovoljenih držav in valut podjetja.
  • Podjetje — branje profila.

Vrednosti enumeracij za Status, TravelType, PayoutMethod in ostale so dokumentirane v OpenAPI shemi kot enum: [...] seznami dovoljenih vrednosti, zato se generirani odjemalci vežejo na kanonične nize ("PendingApproval", "BankTransfer" itd.) namesto na neprozorne vrednosti.