Contents
1. What Time and Leave is for2. Clocking in and out from the phone3. Day close: how the hours are calculated4. Monthly timesheet5. Leave request and approval chain6. Monthly labour cost and budget6b. Overtime check — legal cap, cost before approval, department budget7. Performance targets8. On the phone: Garden, Pulse and the employee portal9. Permissions10. FAQ11. Manual punch and the timesheet periodLeave days must fall within the employment periodWho can change the settings in this windowRoster and Day closing on the phoneTargets: why Save is disabledTime and Leave — clock-in from the phone, leave approval, labour budget, targets
1. What Time and Leave is for
The Time and Leave window brings together the employee's clock-in/out from the phone, the day close that turns punches into regular / overtime / night / holiday hours, the monthly timesheet, the supervisor → HR leave approval chain, the monthly labour cost against budget and per-person performance targets. The payroll source does not change: the final record of a day is the Human Resources timesheet, a leave request is the HR leave record and the balance is the HR entitlement calculation — this window writes to them and keeps no copy.
Tabs: Mine (my own clock-in/out, balance and leave request) · Timesheet · Leave · Approvals · Labour budget · Targets. Only the tabs your permissions allow are shown. On a phone (screen smaller than 7 inches) the same window opens with the Me · Approve · Team steps; a field employee without an HNR account does the same from the employee portal (/personel).
2. Clocking in and out from the phone
- The big CLOCK IN / CLOCK OUT button chooses the direction from your last valid punch. A double tap does no harm: if the same request arrives twice or the button is pressed again within 60 seconds, no new punch is written ("This punch was just recorded").
- Location is optional: if "Add my location" is ticked the browser asks for permission; if you refuse or no position arrives within 6 seconds the punch is saved without location and nothing stops. The location stays on the punch row only and is shown in the day details.
- A raw punch is never changed. For a forgotten or wrong punch use Request correction: time, direction and a reason are entered and the row goes to the supervisor as "Correction awaiting approval". Once the supervisor approves it becomes valid and that day is closed again; a rejection ignores it. HR can Add a manual punch directly with a reason.
- Punch sources are read together: phone / Pulse, the card reader (HR › time-clock raw data, by card number), the MES terminal session (the operator's log-in/out on the terminal — only if there is no other punch that day) and manual punches.
3. Day close: how the hours are calculated
Day close on the Timesheet tab pairs the punches in the chosen date range into in-out pairs, calculates each day and writes it to the HR timesheet (source: Timesheet close). Preview writes nothing. All numbers come from HR › Legislation parameters — there are no hours, multipliers or caps in the code; a missing parameter shows as a warning above the timesheet and that item is not calculated.
| Item | Türkiye (TR set) | Indonesia (ID set) |
|---|---|---|
Overtime basis (fm.esas) | week — hours above 45 per week (4857/41) | day — hours above the daily normal (8 h on 5 days / 7 h on 6 days); weekly 40 is also a cap (PP 35/2021 art.26) |
| Overtime multiplier | ×1,5 | first hour ×1.5, next ×2 — PER DAY |
| Holiday / rest-day work | ×2 | tiered: first 8 (7 on a 6-day week) hours ×2, next hour ×3, after that ×4 |
| Night window | 20:00–06:00 | 23:00–07:00 |
| Break (if no shift break is defined) | 15 min up to 4 h, 30 min up to 7.5 h, 60 min above (4857/68) | none up to 4 h, 30 min above (UU 13/2003 art.79) |
| Overtime caps (warning only) | 3 h per day, 270 h per year | 4 h per day, 18 h per week |
- Day boundary: a work span belongs to the day of clock-in; a 22:00 → 06:00 night shift counts as one day and is not split.
- Missing clock-out: a clock-in without a clock-out produces no hours; the day is skipped with "Clock-out punch missing" and waits for a correction. The close never overwrites a manually entered HR timesheet day (a reasoned "force" only for the HR manager) and does not write into a locked period.
- Overtime equivalent: the multiplied total of the day's overtime and holiday hours (e.g. Indonesia 2.5 h lembur = 1×1.5 + 1.5×2 = 4.5). On these days the payroll summary calculates overtime pay as OT equivalent × hourly rate (ID: monthly ÷ 173) — Indonesia's "first hour ×1.5" rule is applied every day, not once a month.
“Close and write to timesheet” (day close) is open only to the HR role (HR Manager or HR Staff; an administrator counts as HR Manager): for a user without the role the button is disabled and “Day close (writing to the timesheet) is open only to the HR role…” is written under it; Preview is open to everyone and writes nothing. The role is assigned under Personnel › Registration forms › HR roles. Manual day entry and “apply to timesheet” from absences follow the same rule.
Writing the same punch a second time does not open a new record: if the same person, the same time and the same direction (valid or pending) already exist the punch is not written and the screen shows the existing record. A punch, correction, day close or leave cannot be written to a month whose net payroll is finalised (see A finalised payroll period); a punch on a day outside employment is not written either.
4. Monthly timesheet
A person × day grid: green a regular day, amber a day with overtime, purple holiday work, blue approved leave, red "!" a missing punch; a dashed border is the preview of a day that has punches but is not closed yet. Totals for regular / OT / holiday / night / OT equivalent / worked days / leave days are on the right. Clicking a cell opens that day's punches (source, location, status); a manual punch (HR) or a correction request is sent from there. A supervisor sees only their own team (the manager link chain on the employee card + department supervisor).
5. Leave request and approval chain
- 3-step wizard: 1) type — the list comes from the country legislation set (TR: annual, excused, sick, marriage, paternity, bereavement, maternity, unpaid, administrative · ID: annual, sick, marriage, child's wedding, circumcision, baptism, wife giving birth, bereavement, menstrual, maternity, miscarriage, religious, unpaid) · 2) dates — the estimated number of days (public holidays and non-working weekdays are not counted; calendar days for unpaid leave) · 3) summary + note → send.
- Chain: first the supervisor (the manager on the employee card; otherwise the department supervisor), then HR. The supervisor's approval moves the request to HR; the final decision is the existing HR leave decision (balance overrun on annual leave requires a reason, the four-eyes rule, the HR Manager role). A rejection at any step closes the chain. HR can decide without waiting for the supervisor — the step leaves the trace "decided by HR". A request from an employee without a supervisor goes straight to HR.
- A request overlapping existing dates is refused. The per-event day cap (e.g. marriage 3 days) and insufficient balance are only warnings. You cannot decide on your own request and cannot see other people's records. HR can cancel approved leave that has not started — the balance returns automatically.
- Notification: when a request arrives the next approver gets an in-app message (plus a WhatsApp subscription when the Notification and Approval Centre is set up; the same request is not notified twice); the decision is sent to the employee's HNR user if there is one, and a portal user sees it in their history. The "Leave request" cards in the Approval Centre use this chain.
Leave calendar (Leave tab): the month's approved (blue) and pending (amber) leave on a person × day strip; overlapping leave in the same department has a red border, and days on which the threshold (default 2) or more people of the same department are on leave are listed as a warning. The balance for annual leave is the HR entitlement calculation itself: TR 14/20/26 days by seniority (+ under-18 / over-50 floor), ID a fixed 12 days; the entitlement arises on the service anniversary and carry-over comes from the year-end transfer.
Leave overlap. A new leave request that overlaps the same person’s approved, pending or draft leave is not written (422): “This person already has leave dated 10.11.2026 – 09.12.2026; the leave of 11.11.2026 – 13.11.2026 overlaps it. First cancel the existing leave or change the dates.” Adjacent days do not count as an overlap; cancelled and rejected leave does not hold a place. In bulk leave the overlapping people appear in a separate list in the preview and are added to the exceptions.
6. Monthly labour cost and budget
The actual cost per person-month is the payroll summary earnings (gross + piece-rate + minimum top-up + bonus + overtime + allowances) plus the employer share — in the Indonesian set the BPJS programmes (JKK, JKM, JHT, JP, JKP, Kesehatan) are calculated per person, in the Turkish set gross × sosyal.isveren_oran. Hours come from the timesheet (regular + overtime + holiday). A budget is entered per department (or company total) × month as an amount and/or hours; several months can be written at once. The comparison comes with a monthly bar (actual) and line (budget) chart, a department table (variance amount and %, hour variance) and person details. When the variance percentage exceeds the threshold (default 5%) the row becomes "Budget exceeded" and the Owner Dashboard attention box shows "Labour cost exceeded the budget by …%" (red at twice the threshold).
The Settings tab (time and attendance managers only): department managers — the request of an employee with no manager on the employee card goes to the manager selected here for the department, and straight to HR if there is none; the double-tap window (seconds), the time after which an open clock-in counts as a missing clock-out (hours), the budget variance threshold (%) and the leave overlap threshold (people); the list of saved budget rows with delete. Employee portal service account: the portal runs PIN users' requests with an HNR user in this company — create a separate user just for the portal and set it here (system administrator; the password is stored encrypted and never shown again). If the account does not work, the tab shows a red warning and the portal login says the service account is not set. Statutory numbers (overtime multipliers, night window, breaks, whether holiday work counts toward the overtime cap) are not here but in the HR Legislation window; if a required parameter is missing, day closing is not written to payroll.
6b. Overtime check — legal cap, cost before approval, department budget
On the Overtime tab, overtime is requested and approved before it is worked. The team's supervisor or a timesheet manager chooses the employees, the day and the hours (0.25–12, in quarter hours) in the New overtime request wizard. The Check step shows three things for each person: the legal cap — daily, weekly (Monday–Sunday) and annual overtime from the HR regulation parameters (fm.gunluk_azami, fm.haftalik_azami, fm.yillik_azami; Indonesia 4 h/day and 18 h/week — PP 35/2021 art. 26, Türkiye 270 h/year — 4857 art. 41); hours used = actual overtime in the timesheet + approved requests not yet worked (once the day's timesheet is written, the actual figure is used and nothing is counted twice); the estimated cost — the paid-hour equivalent per day (first-hour and later-hour multipliers on a working day, the holiday multiplier or scale on a holiday) × the hourly wage (gross ÷ fm.bolen), with the SGK employer share added in Türkiye (fm.isveren_payi_dahil); and the department budget. At 80% of a cap (adjustable) a near the limit warning appears, above the cap an over the limit warning. If the regulation requires written consent (fm.riza_gerekli), the consent box must be ticked. In Indonesia holiday work does not count toward the cap (fm.tatil_tavana_sayilir).
Check and decision. By default the check only warns. If the legal cap check is set to Block in Check settings, a request over a cap or without ticked consent cannot be approved; the budget check can be Off, Warn or Block. The check runs again at approval: other requests approved in the meantime are counted, and two approvals at the same moment cannot exceed the budget together. Only a system administrator can override a block, with a justification of at least 10 characters; the row then shows an Approved by override badge and a trail remains. A timesheet manager cannot decide on a request they opened themselves. Rejecting and cancelling require a justification; no request can be opened for a past day, and rejected or cancelled rows are not deleted (numbers are never reused). Pending requests also appear in the Approval Centre and can be decided there; a new request is messaged to the timesheet managers and the decision to the person who opened it.
Board, unapproved overtime and budget. The Board shows, per person, this month's actual and approved-plan hours, the year total, today's day / week / year cap bars and when the annual cap will be reached at this pace, plus the use of department budgets. Unapproved overtime lists days that have overtime in the timesheet but no approved request, or more hours than approved (tolerance 15 minutes by default) — hours already worked are not deducted from pay; the list is for review. In the Overtime budget, hours and/or an amount are entered per department × month (* = whole company); the amount used is the overtime amount from the payroll summary + the estimated cost of approved requests. A supervisor sees only the team and the hours; amounts are visible to timesheet managers. On the phone (Garden / Step) the Overtime step opens request cards, the 3-step request wizard and the 2-step decision wizard.
7. Performance targets
| Metric | Source | Measurement |
|---|---|---|
| Production quantity | MES terminal or production confirmation | MES: the operator's good quantity · confirmation: confirmed quantity of the employee's HNR user |
| OEE | MES terminal | the single OEE definition, same as the MES efficiency scorecard |
| Scrap rate | MES terminal | scrap ÷ total (lower is better) |
| On-time completion | MES terminal | share of operations with a planned end (APS) finished on time |
| Attendance rate | Timesheet | worked days ÷ working days (to date) |
| Units per hour | MES terminal | good quantity ÷ run hours |
Card: actual / target, a progress bar and a status — Target met (≥ 100%), Close to target (≥ 90%), Below target, No measurement data. Only the time-and-attendance manager writes targets; a supervisor sees the team's targets.
8. On the phone: Garden, Pulse and the employee portal
- Garden + Step: on the phone the Time and Leave window opens with Me (big clock in/out, balance, leave wizard) · Approve (supervisor/HR queue: leave + punch correction, approve/reject with a reason) · Team (the team's monthly summary; tap a person for a day-by-day strip).
- Pulse › Me: if your HNR user is linked to an employee record (employee card › user) a My timesheet section appears at the top: the clock in/out button, today's duration, leave balance and, if you are a supervisor, a "My team's pending requests" counter.
- Employee portal (
/personel, registration number + PIN): the Clock in/out tab carries the same big button, balance, 3-step leave wizard, my pending requests (withdraw), forgotten punch (correction request) and my recent punches. For a portal account that is a supervisor, "Waiting for my approval" (supervisor step only — HR's final approval cannot be given from the portal) and the team's month appear. The CLOCK button on the Shift tab writes to the same punch ledger. The portal identity lock is unchanged: the employee number always comes from the session and other people's records cannot be reached.
9. Permissions
| Permission | What it grants |
|---|---|
puantaj_yonet | Day close, labour budget, targets and settings (a manual punch also needs an HR role); the HR step of leave (the final gate is still the HR Manager role) |
izin_onay | As a supervisor: decisions on the team's leave and punch corrections; team timesheet |
personel | Seeing everyone's timesheet, leave and targets |
| (no permission needed) | One's own clock-in/out, balance and leave request — when the HNR user is linked to an employee record |
10. FAQ
- "Your user is not linked to an employee record" — HR must enter your HNR user name in the user field of the employee card.
- A day is empty in the timesheet but has punches — the day is not closed yet (dashed preview) or the clock-out is missing; write it with Day close or request a correction.
- "A timesheet parameter is missing in the legislation" — enter the named key (e.g.
fm.esas) in HR › Legislation; it is added automatically to the TR and ID sets, and arrives empty in a third-country set.
11. Manual punch and the timesheet period
HR writes a forgotten clock-in or clock-out from the Manual punch and period tab (the same panel also sits under Personnel › Shift / Timesheet; on a phone it is the Timesheet › Manual step; there is also “Add manual punch” in Calendar › day detail). Only a user with an HR role can write: HR Manager or HR Staff (Personnel › Record forms › HR roles); an administrator without a role counts as HR Manager. Fields: employee, punch time (date and time are mandatory; no future dates), In/Out and a reason (at least 5 characters, mandatory). You cannot write a manual punch on your own record. The record is stored with the source “manual”, the writer and the reason; it appears in the access log as “Timesheet — record”.
In a manual punch the exit time cannot be before the entry time: “The clock-out time cannot be earlier than the clock-in time.” (when a later entry exists on the same day). A night shift is allowed: the exit of an entry left open from the previous day can be written on the next day. A punch cannot be written into a locked accounting month (409).
For a user without the permission the button is disabled and says why: an HR role is required, and the role is assigned in Personnel › Record forms › HR roles. Before, the puantaj_yonet permission was enough; now an HR role is also needed. A puantaj_yonet user without an HR role sees “Request correction” in the Calendar day detail; the day-close permission did not change.
Timesheet period: the tab shows the state of the period (open/closed). Close the period and reopen are the HR Manager’s job only; reopening also needs a reason of at least 5 characters. While the period is closed, no manual punch is written for that month, and neither a correction request (in the window and in the personnel portal) nor a correction approval can be made — PUANTAJ_DONEM_KAPALI, 422. If any calendar row in the period is locked, the period counts as locked. Closing and reopening go to the access log as “Timesheet — closing / opening”.
No punch is written for a day outside employment. A punch cannot be written for a day before the hire date or after the leaving date (including the gap between two employments): “A punch cannot be written for a day before the hire date ….” The rule applies to every source: manual punch (window and phone wizard), correction request and correction approval, phone/Pulse punch, the staff portal, MES terminal entry and PDKS import. The server returns 422 PERSONEL_DONEM_DISI; in a bulk PDKS import that row is skipped and the result shows the skipped count with the first examples, and a live push returns 422.
A shortcut for the HR Manager in a closed period. An HR Manager trying to write a punch into a closed period sees “Reopen the period with a justification first.” and the Reopen the period › link (under the date field and in the Save reason); the link opens the period box with that period and focuses the justification field (on the phone it switches to the “Attendance period” step). For HR staff who cannot reopen periods, the message only says the period is closed.
Leave days must fall within the employment period
Timekeeping › Leave and the leave request in the personnel portal go through the same function: leave days must fall between the employee’s hire and termination dates, otherwise the record is refused; leave dates are also within the document-date range. Details: Leave and date-of-birth limits.
Leave, absence, sick leave and overtime cannot be written to a closed timesheet period either: “… timesheet period is closed; no leave, absence, sick note or overtime record can be written to it.” (422). Reopening the period asks for a reason of at least 5 characters.
Who can change the settings in this window
The company-wide settings in this window can be changed only by an Administrator. A user with the module right can see the setting, but Save is disabled and the reason (“Only an Administrator can change this company-wide setting — Settings › Users.”) is written next to the button. An empty or incomplete settings request does not reset the setting: an empty request returns 422 and a partial request changes only the setting that was sent. Details: Who can change company-wide settings.
Roster and Day closing on the phone
On the phone the monthly team roster step is now called Roster (it is the step called “Team” in the list above). For the timekeeping manager Day closing appears at the top: Preview writes nothing, Close and write to timekeeping is in the bottom bar; the HR role rule is the same as on the desktop. In the timekeeping settings, when Save is disabled the reason is written next to the setting; a setting is sent to the server as a single setting key (an empty request returns 422).
Related guides: Human Resources · MES · Notification and Approval Centre · Owner Dashboard · Mobile.
Targets: why Save is disabled
On the Targets step (on the phone, Garden + Steps), if Save is disabled the reason is written under the button; for example if no person is chosen: “Select staff”. The desktop shows the same reason sentence.
Related guides
- Human Resources — A Guide from ScratchThis module puts the person at the centre. Previously one employee lived in four separate places: a name on a customer card, another record in production.
- Settings and Log — Making the Program YoursThe Settings window holds two kinds of setting side by side: those that are yours alone (theme, window layout, shortcuts) and those that affect company.
- MES — Operator Terminal, Live OEE and AndonMES (manufacturing execution) connects the shop floor to the office. The operator at the machine starts, pauses and finishes the job from a terminal.
- Official Obligations — A Guide from ScratchThis window answers a single question: what must this company, in this country, for this period, file — by when, and in what form; which one is ready.