Documents and printing is where you decide how SolaHR's paper looks. Payslips, advance vouchers and cash disbursement sheets all come from one print system: the same company branding, the same bilingual layout, the same rules for what counts as an official copy. You set the branding and the templates once on System → Documents & Printing, and every print, PDF download and email afterwards follows them.
The system exists to make three things reliable. First, an issued document never changes: once a payslip or voucher is final, SolaHR stores the figures that were printed, so changing the logo or the template next year does not alter last year's payslip. Second, proof of receipt: an employee can acknowledge a document with a signature or a digital confirmation, and SolaHR keeps the evidence. Third, delivery: payslips can be emailed to each employee securely, one document per person.
Where to find it
| What | Where | URL |
|---|---|---|
| Branding, templates, acknowledgment and delivery | System → Documents & Printing | /settings/documents |
| Edit one template | Edit on a template row (opens the template editor on the same page) | /settings/documents |
| Print / PDF / email payslips | Payroll & Compensation → Payroll Runs and Payroll & Compensation → Payslips | Payroll, Payslips |
| Print vouchers and the cash sheet | Payroll & Compensation → Advances | Advances |
The menu item appears when your plan includes payroll and you can manage document branding and print templates, or print/export payslips, or view advances.
Permissions
| Action | Permission |
|---|---|
| Open the page, preview templates | Manage document branding and print templates, or Print/export payslips, or View advances & loans |
| Change branding, templates, acknowledgment policy, cash denominations | Manage document branding and print templates |
| Print and PDF payslips | View payroll runs / Print/export payslips |
| Email payslips, upload signed copies | Generate payslips (payslips) or Create/edit advances & loans (vouchers) |
| Upload a new organization logo | Organization owner |
| Role | Access |
|---|---|
| Owner, SolaHR Administrator | Everything. |
| Users with view access only | The banner View only — "You can view these settings and preview templates. Only members allowed to manage documents can change them." |
The three document types
| Type | What it is | When it becomes an official document |
|---|---|---|
| Payslip | The month's pay for one employee. | When the payroll run is final or paid. A draft payslip prints clearly marked as a draft and is never issued. |
| Advance voucher | The paper for a salary advance or loan. | From disbursement onward (disbursed, received, repaid). A request prints marked as a request. |
| Cash disbursement sheet | A list of employees and the notes and coins to hand out. | A working sheet; it is not issued or acknowledged. |
Branding tab
Names and text on documents — "Leave a field empty to use the organization profile value."
| Field | Notes |
|---|---|
| Display name (Arabic and English) | The name printed in the header. |
| Legal name (Arabic) | "The English legal name comes from the organization profile." |
| Address (Arabic and English) | Printed in the header and the footer. |
| Footer text (Arabic and English) | A line at the bottom of every page. |
| Signatory name, Signatory title (Arabic and English) | Printed on the signature block. The title defaults to "Authorized signatory". |
Colours and language
| Field | Notes |
|---|---|
| Primary colour, Accent colour | Hex codes (for example #1f4e79). Clear returns to "Not set — the organization colour is used." |
| Document language | Automatic (the reader's language), Arabic, English or Bilingual (Arabic and English). |
Logo — shows the current logo or "No logo uploaded yet." The owner can Upload a new logo (PNG, JPG or WebP, up to 600 KB): "The logo is saved to the organization profile." It is the same logo used in the top bar and across your Solavel apps.
From the organization profile — a read-only card: Name, Legal name, Registration number, Email, Phone, Website, Registered city, Brand colour. "These details are edited in the organization profile and appear on every document."
Click Save settings. Changing branding affects documents printed from then on; documents already issued keep the content they were issued with.
Templates tab
A template is a structured layout, not free HTML. SolaHR checks every layout so it cannot break a document or hide required figures.
The tab lists, per document type, Default: name (the template currently used) and two groups:
- Built-in templates (cannot be changed): Payslip — A4, Payslip — A6 compact, Advance voucher — A6 landscape, Advance voucher — A5, Cash disbursement sheet — A4.
- Your templates: copies you made. "No custom templates yet. Duplicate a built-in template to customize it."
| Column | Meaning |
|---|---|
| Name | Template name, with a Default badge on the one in use. |
| Paper | Size and orientation. |
| Status | Built-in, Draft vn or Published vn. |
| Actions | Preview, Duplicate to customize (built-ins), Edit / View, Publish, Set as default / Use as default, Discard draft, Restore built-in default. |
Work with a template
- Duplicate to customize a built-in: give the copy a Template name (default "name (copy)") → "Draft created".
- Edit opens the template editor (see below), with a live Preview on sample data.
- Save draft keeps your changes without affecting printing ("Draft saved").
- Publish turns the draft into the new published version; "The previous published version is archived." You can tick Make it the default for type at the same time. "Template published".
- Set as default / Use as default makes a published template the one used for that type ("Default template updated"). Use this built-in as the default adds a published copy of the built-in and makes it the default.
- Discard draft deletes unpublished edits; the published version is not affected.
- Restore built-in default: "The built-in template 'name' becomes the default again. Your templates are kept."
The template editor
Title Edit template: name (Template: name if you can only view). Built-in templates show "Built-in templates cannot be changed. Duplicate it to customize." A banner Unsaved changes / All changes saved tracks your edits; Close asks "Close without saving?" when needed. Settings on the left, Preview on the right ("Fictional sample data only."), with a Sample selector (payslips: Standard, Long (many lines), Draft payroll; vouchers: Request, Disbursement, Receipt, Repaid, Void).
| Group | Fields |
|---|---|
| Paper | Paper size (A4, A5, A6, Letter or Custom size with Width (mm) 74–420 and Height (mm) 74–594), Orientation (Portrait / Landscape), Margins (mm, 3–30): Top, End side, Bottom, Start side. |
| Text and style | Language (as above), Font size (pt), Spacing (Comfortable / Compact), Header style (Coloured band, Line, Plain), Accent colour (or Use organization colour). |
| Sections | "Order, visibility and optional details. Required sections are always shown." Move each section up or down, Show or hide the optional ones. Sections: Header, Title, Employee, Earnings and deductions, Totals, Employer contributions, Attendance, Payment details, Notes, Signature, Acknowledgment (QR), Footer; for vouchers Amount, Repayment plan, Salary context; for the cash sheet Employee table. Some sections have Columns (employee block) and Arrangement (Side by side or Stacked) options. |
| Optional details | Tick boxes such as Logo, Legal name, Registration number, Address, Phone and email, Department, Job title, Start date, National ID, Email, Phone, Quantities and rates, Itemized deductions, Cash denominations. Identity, figures and status can never be hidden. |
Signature and acknowledgment sections are also controlled by the acknowledgment policy: "Also controlled by the acknowledgment policy." If settings are invalid, the editor says "Some settings are not valid. Fix them to save and update the preview."
Acknowledgment & delivery tab
Acknowledgment
"How employees confirm they received a payslip or an advance voucher." Choose a Default policy and optionally a different policy Per document type (Use default (policy)):
| Policy | What is printed |
|---|---|
| No acknowledgment | "No signature line and no QR code are printed." |
| Signed paper copy | A signature line, and a QR code used to match the signed copy when it is uploaded. |
| Digital confirmation | A QR code (and link). The employee confirms with their portal PIN; no signature line. |
| Signed copy or digital confirmation | Both. Either one counts. |
"Acknowledging a payslip confirms receiving the document, not payment; it never marks salary paid."
How it works: the QR code opens a page that says which document it is (never the amounts). The employee enters their portal PIN and ticks the confirmation. Possessing the paper or the link is not enough. A signed paper copy is scanned and uploaded with Signed copy next to the document ("Signed copy saved. It does not mark anything paid."); files may be PDF, PNG or JPG up to 10 MB and are kept privately as evidence. Employees can also Acknowledge receipt from their portal payslip list ("Confirms you received this payslip document. It is not a confirmation of payment.").
Cash denominations
"Notes and coins counted on the cash disbursement sheet, per currency." For each Currency code (3 letters) enter Denominations separated by commas (for example 500, 200, 100, 50, 20, 10, 5, 1, up to 12). Add currency / Remove currency. With none set, "The sheet uses the standard ones."
Email delivery
Shows whether sending is live: "Email sandbox — Messages are recorded but not sent until an administrator enables sending." or "Sending is on: emailed documents are delivered to employees." It also says whether PDF attachments are available: "PDF attachments are available." or "PDF attachments are not available on this server. Emails can carry a secure link instead."
Printing, PDF and email in daily use
| Where | Controls | What they do |
|---|---|---|
| Payroll run | Print All, PDF, Email payslips; per employee Print, PDF, Signed copy | One salary slip each, or all in one file. |
| Payslips list | The same per payslip | See Payslips. |
| Advances | Print All, PDF, Cash sheet, Email vouchers; per advance Print, PDF, Signed copy | Vouchers and the cash sheet. |
| Overtime | Print on a paid overtime row | The A6 landscape overtime payment receipt. |
Each document row shows its state: Not issued yet, "n copies", Acknowledged, Signed copy (n), Superseded, and the email state (Email queued, Email sending, Emailed, Email recorded (sandbox), Email failed, Email skipped).
Issuing, copies and revisions
- The first print of a document of record issues it, with a reference such as
PS-202610-00007, and stores the printed figures and the template version. - Every later print is a copy of the same issue: the number of copies increases, nothing is recalculated.
- If the authoritative figures change (for example a payroll month is reopened and recalculated), a new revision is issued with a reference ending
-R2. The earlier revision and its acknowledgments stay as evidence and show Superseded. - Changing branding or templates never changes an issued document.
Email documents
- Click Email payslips (payroll run) or Email vouchers (advances). The dialog Email documents says "Each employee receives only their own document. Emailing never marks salary paid and is not an acknowledgment."
- Choose How to send: Secure link (employee confirms their portal PIN) or PDF attached (when available).
- The dialog previews: "n documents will be emailed.", "n were already emailed and are skipped unless you choose to send again." (tick Send again to people already emailed), "No email address: names", "n are drafts or requests and cannot be emailed."
- Click Queue n emails: "n emails queued, n skipped." A background job sends them in small batches every five minutes. In sandbox mode the messages are recorded, not sent.
Worked example 1: branding and an A6 payslip
Al Noor Trading LLC wants payslips on half a page, bilingual, with its blue.
- HR opens System → Documents & Printing → Branding. The owner uploads
al-noor.png. Under Names and text on documents: Display name (Arabic) and (English), Footer text "Al Noor Trading LLC · Office 1204, Al Habtoor Business Tower, Dubai", Signatory name "Mariam Al Falasi", Signatory title "Finance Director". Primary colour#1f4e79. Document language Bilingual (Arabic and English). Save settings. - Templates: under Payslip HR clicks Duplicate to customize on Payslip — A6 compact, names it "Al Noor payslip A6", then Edit. She hides Employer contributions, ticks Itemized deductions, checks the Sample preview "Long (many lines)" fits on one page, Save draft, then Publish with Make it the default for Payslip ticked.
- In October's payroll run she clicks Print All: every slip is A6, bilingual, with the logo.
Worked example 2: acknowledgments, a signed copy and an email
- On Acknowledgment & delivery, the Default policy is Signed copy or digital confirmation; for Advance voucher HR chooses Signed paper copy.
- After October is approved, HR clicks Generate Payslips and prints. Omar Haddad's payslip
PS-202610-00007is issued as revision 1: his row, which said Not issued yet, now shows the issued document and its copies. - Omar scans the QR code with his phone, sees "Payslip PS-202610-00007" without any amount, enters his portal PIN and confirms. His row shows Acknowledged.
- Sara Khan prefers paper. She signs her slip; HR scans it and clicks Signed copy in her row: "Signed copy saved. It does not mark anything paid." Her row shows Signed copy (1).
- On 3 November payroll is reopened to fix an allowance and recalculated. Omar's figures change, so his next print is issued as
PS-202610-00007-R2; the first one shows Superseded and keeps its acknowledgment. - HR clicks Email payslips → Secure link; 41 documents queue, 1 is skipped ("No email address: Ahmed Saleh"). The sandbox note says messages are only recorded until sending is enabled.
How it connects
| Area | Connection |
|---|---|
| Payroll, Payslips | Payslip print, PDF, email, acknowledgment. |
| Advances | Vouchers, receipts and the cash sheet. |
| Overtime | The overtime payment receipt reuses the voucher layout. |
| Settings | The organization logo and company details are shared with documents. |
| Employee portal | Employees view and acknowledge payslips there; the secure link asks for the portal PIN. |
| Audit Log | Settings, templates and deliveries are logged. |
Tips and common problems
| Problem | Cause | Fix |
|---|---|---|
| My new logo did not change an old payslip. | Issued documents keep their content. | Expected. New prints of new documents use the new logo. |
| The editor will not save. | A setting is outside its range (margins 3–30 mm, custom size limits, font size). | Read "Some settings are not valid." and fix the marked field. |
| "No email address" for an employee. | No Email or Work email on the profile. | Add one on the employee profile. |
| Emails are "recorded" but not received. | The email sandbox is on. | An administrator must enable sending. |
| PDF download fails or is missing. | PDF generation is not available on the server. | Use Print and your browser's print-to-PDF, or email with the secure link. |
| Employees cannot confirm with the QR. | Their portal PIN is not set or portal access is off. | Set up their portal access. |
| The payslip is marked as a draft or cannot be emailed. | The run is not final, so it is not a document of record. | Approve the run; then print or email. |