Supported Accounting Apps
Enable & Credentials
The Octal Accounts integration lives on a single settings page. Go to Settings → Octal Accounts.
.env file, not in the settings UI. Ask your administrator if the connection needs to be repointed to a different Octal Accounts environment.
CoA Mapping
Octal HR posts every payroll run as a single journal against three chart-of-accounts codes. Set each code once on the Octal Accounts settings page — the defaults shown below match the standard Octal Accounts CoA and usually don't need to change.
| Setting | Default Code | What it posts |
|---|---|---|
| Salary Expense Code | 710101 | Debit — total gross salary for the run |
| WHT Payable Code | 120401 | Credit — income tax withheld |
| Statutory Payable Code | 120701 | Credit — EOBI, PESSI and other statutory deductions |
Below the three codes, choose which salary components feed each payable bucket:
- WHT components — the components (e.g. Income Tax) that credit WHT Payable.
- Loan components — the loan/advance recovery components netted from salary.
- Statutory components — the components (e.g. EOBI, PESSI) that credit Statutory Payable.
Payroll Journal Entries
Payload generation happens on the payroll run's Export action, not automatically on finalise. When you click Export on an approved run, Octal HR builds a single journal payload from the CoA mapping and queues it for delivery to Octal Accounts.
A typical payroll journal looks like:
- Dr Salary Expense (710101) — total gross salaries for the run
- Cr WHT Payable (120401) — income tax withheld
- Cr Statutory Payable (120701) — EOBI / PESSI / other statutory
- Cr Net Pay — balance payable to employees
CSV Export (Other Apps)
For any accounting software other than Octal Accounts, export a formatted CSV after each payroll run and import it into your software:
Sync Now & Recent Exports
The Octal Accounts settings page has a Sync Now button for each entity — Employees, Payroll, Payments, Loans, Pull Employees, and Banks. Clicking one runs the corresponding sync command synchronously and shows the CLI output inline. The Payroll Sync Now also auto-enqueues any approved payroll runs that haven't been queued yet.
Below the sync buttons, status cards show pending and failed queue counts per entity (employees, payroll_run, payment_voucher, loans, banks) alongside the last export timestamp. A Recent exports panel lists the last 10 rows from payroll_export_log — adapter, status, error message, payload, response, and exported-at time — so you can inspect exactly what was sent and how Octal Accounts responded.