--- title: Časovni zapisi description: "#### Podatkovna struktura Skyplannerja Preden se poglobimo v časovne zapise, moramo nekaj povedati o strukturi podatkov v programu Skyplanner in o tem, kako stvari delujejo pod pokrovom. Vse to bo prišlo v poštev pozneje. Če ste podatke o naročilu/delovnem nalogu/delu…" url: "https://skyplanner.ai/sl/docs/casovni-zapisi/" updated: "2025-10-07" category: Integracije tags: - API - Integracija --- # Časovni zapisi #### Podatkovna struktura Skyplannerja Preden se poglobimo v časovne zapise, moramo nekaj povedati o strukturi podatkov v programu Skyplanner in o tem, kako stvari delujejo pod pokrovom. Vse to bo prišlo v poštev pozneje. Če ste podatke o naročilu/delovnem nalogu/delu vključili v program Skyplanner, ste najverjetneje uporabili vsaj te točke API: - phaser-orders - phaser-order-rows - phaser-jobs Podatki, vstavljeni v te končne točke, so v uporabniškem vmesniku programa Skyplanner prikazani na naslednji način: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-25-1024x714.png) **Slika 1.** Naročilo (phaser-orders) ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-26-1024x715.png) **Slika 2.** Elementi naročila (phaser-order-rows (rdeča)), Koraki procesa (phaser-jobs (zelena)) Po vnosu naročil v program Skyplanner **jih** boste želeli **izvoziti** (to lahko storite prek uporabniškega vmesnika ali končne točke /phaser-orders/export-endpoint) v modul za načrtovanje proizvodnje: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-27-1024x596.png) **Slika 3.** Izvoz prek uporabniškega vmesnika ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-28-1024x597.png) **Slika 4.** Izvoženo naročilo v načrtovanju proizvodnje Pri izvozu naročil Skyplanner dejansko kopira podatke o naročilu iz ene tabele podatkovne zbirke v drugo. Če torej nekaj spremenite, na primer prek končne točke /phaser-orders, morate podatke ponovno izvoziti, da jih posodobite v načrtovanju proizvodnje. To tudi pomeni, da morate za dostop do naročil, ki jih vidite v oknu načrtovanja proizvodnje, uporabiti različne končne točke API! "Spremenjene" končne točke so naslednje: - /phaser-orders → /orders - /phaser-order-rows → /order-rows - /phaser-jobs → /jobs To je pomembno vedeti, ker **morate** pri uporabi končne točke /timelogs za beleženje proizvodnih dogodkov itd. **uporabiti povezane entitete, ki jih najdete v končnih točkah za načrtovanje proizvodnje!** Za pošiljanje novega časovnega dnevnika potrebujete na primer podatek **production_planning_job_id**(ponovimo: production_planning_jobs so entitete, do katerih dostopate s končne točke /jobs): ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-29.png) **Slika 5.** Zahteva POST za časovni dnevnik Potrebni podatek production_planning_job_id lahko najdete v končni točki /phaser-jobs: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-30.png) **Slika 6.** Zahtevek GET za opravilo Phaser (rdeče je phaser_job_id, **NE UPORABLJAJTE ga v časovnih zapisih**) Ali iz končne točke /job: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-31.png) **Slika 7.** /job GET zahteva #### Ustvarjanje časovnih zapisov z uporabo vmesnika REST-API Pri ustvarjanju časovnih zapisov v programu Skyplanner prek vmesnika API se uporabljajo ista pravila in sistemi kot v uporabniškem vmesniku. Zato je morda koristno, da se seznanite z delovanjem sistema v uporabniškem vmesniku, preden ga poskušate uporabljati prek API. ##### Osnove časovnega zapisa Skyplanner ima štiri vrste dogodkov časovnega zapisa: - shift_begin - prekinitev - nadaljevanje - shift_end Dogodek Shift_begin se pošlje, ko se delo prvič zažene. **Nikoli ne pošiljajte več kot enega dogodka shift_begin za vsako delovno mesto!** Dogodek Paused ustavi delo. Nadaljevanje dogodka nadaljuje prekinjeno delo. Shift_end zaključi delo. **Nikoli ne pošiljajte več kot enega dogodka shift_end za vsako delo!** Zahtevani podatki za časovne zapise: - person_id - Najdete ga v končni točki /people - Ni isto kot user_id! - planned_workstation_id - Delovno mesto, na katerem se opravlja delo - Najdete ga v končni točki /workstations-endpoint - datum_čas - trenutek izvedbe dogodka - Format: 2024-01-01 10:30:11 Če želite določiti, kateri časovni dnevnik programa Skyplanner je povezan s časovnim dnevnikom iz katerega koli zunanjega sistema, ki ga uporabljate, lahko uporabite polje **external_id**. S tem id lahko na primer zahtevate GET, da bi našli določen časovni dnevnik iz Skyplannerja. ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-32-1024x438.png) **Slika 8.** External_id v časovnih dnevnikih #### Začetek dela Delovna mesta lahko zaženete tako, da API-ju pošljete POST-zahtevek, kot je ta: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-33.png) **Slika 9.** Shift_begin časovnica Pri nastavljanju podatkov POST za časovne dnevnike nastavite **workshift_id**kot 0 in **timelog_finalized**kot **true** #### Prekinitev opravila Delovna mesta zaustavite tako, da pošljete zahtevo POST, kot je ta: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-34.png) **Slika 10.** Ustavljen časovni dnevnik V časovnih dnevnikih z začasno prekinitvijo lahko nastavite **znesek**in **znesek napake**. Upoštevajte tudi **vrsto**časovnega dnevnika in **datum_čas**. #### Nadaljevanje dela Tukaj je opisano, kako nadaljujete ustavljen časovni dnevnik: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-35.png) **Slika 11.** Nadaljevanje časovnega zapisa Če poskušate nadaljevati delo, ki se je končalo z dogodkom shift_end, se pojavi napaka. #### Zaključek delovnega mesta Tukaj je prikazano, kako končate delo s časovnim zapisom shift_end: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-36.png) **Slika 12.** Časovni zapis Shift_end V ukazu shift_end-events lahko podate vrednosti **amount**in **faulty_amount**enako kot v ukazu paused-events. Upoštevajte, da se pri poskusu izvedbe dogodka shift_end-event za opravilo, ki ne teče, pojavi napaka. #### Posodabljanje časovnih zapisov Podatke časovnega dnevnika lahko posodobite tako, da na končno točko /timelogs-endpoint pošljete zahtevke PUT, kot sledi: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-37.png) **Slika 13.** Urejanje časovnic Upoštevajte, da morate imeti nastavljene podatke **beginTimelog**in **endTimelog**, če želite izvesti posodobitev. Časovni zapisi v programu Skyplanner so shranjeni takole: vsak "polni" (časovni zapis, ki ima začetek in konec (npr. shift_begin/continued & paused/shift_end) časovni zapis ima ločeno entiteto za začetek in konec. Te so seznanjene z vrednostjo **begin_id**, ki jo najdete v dnevniku endlog. V zgornjem primeru ima beginTimelog vrednost id 1, zato ima endTimelog vrednost **begin_id**1. Vrednosti **person_id**in **endTimelog**morate navesti tudi ob vsaki zahtevi za posodobitev, tudi če jih ne spreminjate. #### Alternativni načini za izdelavo časovnih zapisov Tukaj je nekaj alternativnih načinov prijave v delovna mesta prek vmesnika API. ##### Logfull Če želite v eni zahtevi poslati začetni in končni dnevnik, lahko uporabite **/timelogs/log-full** -endpoint, kot sledi: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-38.png) **Slika 14.** Zahtevek Logfull Upoštevajte, kako so tu poslani zneski: prva vrednost "znesek" označuje **napačni znesek**, druga pa **znesek**. Ta zahteva ustvari entiteti beginlog in endlog v eni sami zahtevi. ##### Hitri dnevnik "Hitra prijava" k nalogu ga zaključi z enim samim zahtevkom in nastavi zaključeno količino izdelkov tako, da se ujema z vrednostjo, nastavljeno v elementu naročila. Hitro beleženje se izvede z uporabo končne točke **/timelogs/quick-log**: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-39.png) **Slika 15.** Hitro beleženje Upoštevajte, da morate tukaj navesti samo podatke **production_planning_job_id**, **planned_workstation_id**in **person_id**. Vrednosti časa in zneska se izpolnijo samodejno. Upoštevajte tudi, da se hitro prijavljena delovna mesta vedno zaključijo z dogodkom shift_end-event, zato po quicklogu nadaljnje prijavljanje ni mogoče!