Repository navigation
HR and Payroll
Home › Using Granary › People › HR and Payroll
On this page: AI in this module · Find your way around · Employees · Attendance · Leave · Payroll · Recruiting · Settings that affect this module · Permissions
The HR module holds your people records and the work around them: employees, the org chart, attendance, leave, monthly payroll with contributions and income tax, overtime, recruiting from hiring request to offer letter, and recurring allowances. Every payroll rate (contributions, wage caps, income tax brackets, overtime multiples) is a setting, so the same module fits any country. HR staff use it daily; managers use it to request hires and approve leave; every employee uses it to request leave and clock in.

Nary has no HR or payroll tools yet: it can't read or change employees, attendance, leave or payroll. In the chat it can explain how this module works, from the ERP guide built into Granary. See AI Across Granary for what the AI does in the other modules.
Open HR in the sidebar:
| Page | What it is for |
|---|---|
| Org Chart | The company structure by department, with coordinative links between departments |
| Employees | Employee records, face enrollment, allowances |
| Attendance | Attendance records, clock events and the review of unconfirmed clock-ins |
| Payroll | Monthly payroll runs |
| Leave | Leave requests and their review |
| Hiring | Hiring requests from managers |
| Job Openings | Open positions |
| Recruitment | The applicant pipeline |
| Offer Letters | Offers to candidates, approved by the Owner before they are issued |
- Open HR > Employees and click Add employee.
- Enter the First name, Last name and Email (for example
kenji.mori@example.com), and optionally the Phone. - Pick the Department, the Job title, the Employment type (Full-time, Part-time, Contract, Intern), the Start date and who the person Reports to.
- To let the person sign in, tick Also create a system user account and enter a Temporary password. They are asked to change it on first sign-in. The role bundle for the job title is assigned automatically.
- Click Add employee.
A user with the same email cannot be created twice. The employee record links the sign-in to attendance, leave, payroll and project time logs.
- Click Edit on a row to change the name, department, job title, phone or manager, then Save changes.
- Click Allowances to manage recurring allowances (see Allowances).
- Click Face ID to enroll the face for clock-in (see Face Clock-In).
- Click the delete icon and confirm. The record is removed from the lists and the linked sign-in is deactivated.
Use the tabs (All, Active, Probation, On leave) and Search employees to find people. Anyone
can open an employee record, but the salary is shown only to holders of hr:view_compensation.
Payroll uses each employee's base salary and salary currency from the employee record. The Add employee form has no salary field: the values are set when the record is created through the API.
HR > Org Chart shows active, probation and on-leave employees grouped by department, with reporting lines. Dashed lines are coordinative links, for example "Finance coordinates with Operations". A superadmin can add and remove these with Manage links: pick the From department and the To department (they must differ), add Notes (optional), and click Add link.

Employees clock in and out with their face, on their own device or on a kiosk tablet. That is described on Face Clock-In. This section covers the HR side.
Open HR > Attendance. The Records tab shows each employee's day: Date, Check in, Check out, Hours, Late (min), OT (hrs) and Status (Present, Absent, Half day, On leave, Holiday, Remote). Filter by Month, Year and employee.
- A clock-in after the Work start time setting is flagged late.
- A clock-out after midnight closes the previous day's shift if it began within the Overnight shift window.
- To record a day by hand, click Log attendance, pick the Employee, Date and Status, and enter the Check in, Check out, Late (min), Overtime (hrs) and Notes.
The overtime hours on attendance records feed payroll. Days with status Holiday count as rest days for overtime pay.
The other tabs, Pending overrides, Clock events and Attempts, are explained on Face Clock-In. Kiosk clock opens the kiosk screen in a new tab.
- Open HR > Leave and click Request leave.
- Pick the Leave type (Annual, Sick, Unpaid, Maternity, Paternity, Emergency, Other).
- Enter the Start date, End date and a Reason.
- Click Submit request.
The number of days counts every calendar day from start to end. The end date cannot be before the start date. Your account must be linked to an employee record.
- Open HR > Leave. Use the Pending tab to see what waits for you.
- Click Review on a request.
- Pick the Decision (Approve or Reject), add review notes if you like, and click Submit review.
Only pending requests can be reviewed. You cannot approve your own leave request. Pending and rejected requests can be deleted; approved ones cannot.
Without hr:view_leave or hr:approve_leave you see only your own requests.
Payroll refuses to run while a setting it needs is empty or malformed, and the error names the setting. Set these first, under Settings > General, area People & payroll:
- Contributions: the social security, health and pension contributions your jurisdiction requires. Each has an employee rate and an employer rate (percent of the fixed wage), an optional monthly wage cap, and flags for whether the employer share is taxable income and the employee share is tax-deductible. An empty list means no contributions.
-
Income tax:
{"method": "none"}, or progressive annual brackets with a yearly tax-free allowance per tax status, an optional work-expense deduction and rounding. - Overtime: the hourly wage divisor, the overtime multiples per day type, and the rest days.
Check your local rates before the first run. Granary ships no country's rates.
For each active employee (and anyone whose last day falls in the month):
- Base pay: the base salary, prorated by the days employed in the month, converted into the company's functional currency (for Kumo Trading Co., JPY). A missing exchange rate stops the run.
- Allowances: the employee's active recurring allowances.
- Overtime: the hourly wage (the monthly fixed wage divided by Hourly wage divisor) times the overtime hours from attendance, at the multiple for that day type.
- Gross = base pay + allowances + overtime.
- Contributions are charged on the fixed wage (base pay plus fixed allowances), up to each contribution's wage cap.
- Income tax is withheld on the annualized year-to-date income, so each month corrects the months before it. The final month of the year, or the month an employee leaves, settles the year on actual amounts.
- Net salary = gross minus the employee contributions and income tax.
- Open HR > Payroll and click New payroll run.
- Pick the Month and Year, add Notes if you like, and click Create and calculate. Granary creates a draft run and calculates every line.
- Open the run to check each employee's Gross, Contributions, Income tax and Net salary.
- Click Approve. If an approval policy exists for payroll runs, the run goes through it; otherwise you
need
hr:manage_compensation. - When the salaries are paid, click Mark paid, enter the Paid date and pick the bank account in Paid from, then confirm. Granary posts the payroll journal entry to the ledger.
Only one run per month can exist (cancelled runs aside). Only a draft run can be approved, and only an approved run can be marked paid.

- Open HR > Employees and click Allowances on the employee.
- Enter a Name (for example "Transport"), the Monthly amount and Currency.
- Tick Fixed if it is part of the fixed wage, and Taxable if it counts as taxable income. Keep Active on.
Fixed allowances count toward the contribution wage and the overtime hourly wage. Managing allowances needs
hr:manage_compensation.
Recruiting follows four steps: a manager asks for headcount, HR posts an opening, applicants move through the pipeline, and the chosen candidate gets an offer letter.
- Open HR > Hiring and click New request.
- Enter the Position title, Department, Headcount, Type and a Justification (why the hire is needed, and the impact if it is not filled).
- Click Submit request.
The request goes to the Owner for approval (status Awaiting Owner), then to HR. Only holders of
hr:request_hire (management and team leads) can submit one.
- Open HR > Job Openings and click Post opening.
- Enter the Job title, Department, Employment type, Location (for example "Tokyo / Remote"), Headcount, Description and Requirements.
- Click Post opening.
Openings can be Open, Paused, Filled or Cancelled. Only open openings are visible outside the recruiting team.
- Open HR > Recruitment and click Add applicant.
- Enter the Full name, Email, Phone, pick the Opening and the Source (for example LinkedIn, Referral, Website), and add a Resume URL.
- Click Add applicant.
To move an applicant along, click Update stage, pick the stage in Move to stage, give a Rating (1 to 5) and Notes, and save. The stages are Applied, Screening, Phone screen, Interview 1, Interview 2, Technical, Offer sent, Accepted, Hired and Rejected.

- Open HR > Offer Letters and click New offer.
- Pick the Candidate, then fill in the Position, Department, Employment type, Gross per month and Currency, the Start date, Probation (months, max 3), Benefits and Other terms.
- Respond by defaults to 5 business days from today.
- Click Create draft.
- Open the offer and click Issue to candidate. The Owner approves every offer before it is issued: if the offer is not yet approved, it is submitted for approval and you see a notice; issue it again once it is approved. Any change to the draft needs a new approval.
- When the candidate answers, click Record response and pick Accepted, Declined or Countered, with notes.
The applicant's stage follows the offer: Offer sent when issued, Accepted when accepted. Cancel offer needs a reason and stops its approvals counting. Only drafts and cancelled offers can be deleted.
Under Settings > General, area People & payroll:
| Setting | Key | What it does |
|---|---|---|
| Work start time | hr.work_start_time |
Clock-ins after this time are flagged late (default 09:00) |
| Overnight shift window | hr.overnight_shift_hours |
A clock-out after midnight closes yesterday's shift if it began within this many hours |
| Contributions | payroll.contributions |
The list of contributions, with employee and employer rates, wage caps and tax flags |
| Income tax | payroll.income_tax |
No income tax, or progressive brackets with allowances per tax status |
| Hourly wage divisor | payroll.overtime_hours_divisor |
Hourly wage is the monthly fixed wage divided by this (for example 173) |
| Overtime multiples | payroll.overtime_multipliers |
Per day type: cumulative hour bound and the multiple of the hourly wage |
| Rest days | payroll.rest_weekdays |
Weekdays, Monday 0 to Sunday 6; days marked Holiday in attendance also count |
The face clock-in settings, office locations and kiosk tablets are in the same area: see Face Clock-In.
Under Settings > General, area Approvals & signing, Approval policies decide who approves payroll runs, hiring requests and offer letters.
The company time zone and functional currency (Company & branding > Regional) and the exchange rates in Finance > Exchange Rates also affect payroll.
| Permission | Allows |
|---|---|
hr:view_all_employees |
See all employees and the org chart |
hr:manage_employees |
Add, edit and delete employees; enroll faces |
hr:view_compensation |
See salaries and payroll runs |
hr:manage_compensation |
Create, approve and mark paid payroll runs; manage allowances |
hr:view_attendance |
See everyone's attendance and clock events |
hr:manage_attendance |
Log attendance, manage office locations and kiosks, approve or reject clock events |
hr:submit_leave |
Request leave |
hr:view_leave |
See all leave requests |
hr:approve_leave |
Review leave requests |
hr:request_hire |
Submit hiring requests |
hr:manage_job_openings |
Post and manage job openings |
hr:manage_applicants |
Add applicants, move them through stages, manage offer letters |
hr:initiate_termination |
Request an employee's termination (the direct senior only, never HR) |
Managing coordinative links on the org chart is for superadmins only.
- Face Clock-In: clock-in on phones and kiosk tablets
- Projects: employee salaries set the hourly cost of logged time
- Finance: bank accounts, journal entries and exchange rates
- Approvals and Signing: approval policies for payroll runs, hiring requests and offers
- Knowledge and Documents: HR policies and SOPs
← Previous: Operations | Next: Face Clock-In →
Getting started
AI in Granary
Using Granary
- Sell
- Approve and sign
- Money
- Buy and make
- People
- Work together
Administration
Developers