Payroll and Statutory Postings East Africa
Use When
Use when payroll journals, gross-to-net schedules, statutory deductions, payroll clearing, payslip tie-outs, or East Africa country payroll gates are in scope.
Do Not Use When
Do not use to hardcode final PAYE, NSSF, LST, WHT, levy, relief, threshold, or deadline values.
Required Inputs
Country, payroll run, employee master, component map, source-register snapshot, approval state, payslip evidence, and payment route.
Workflow
Validate source gates, post approved payroll through the posting service, reconcile payslips to GL, and block stale statutory output.
Quality Standards
Separate employer and employee obligations, source-backed final statutory values, balanced payroll journals, and payslip-to-GL traceability.
Anti-Patterns
Hardcoded statutory values, netting employer and employee lines, edited released payroll journals, and copied country rules.
Outputs
Payroll journals, statutory liability schedules, stale-rate blockers, payment clearing evidence, and payslip reconciliation fixtures.
References
Load the required references and examples listed below before implementation or review.
Prerequisites
- Read
doctrine/references/live-rate-verification-protocol.md.
- Read
tax-statutory-source-register-and-country-packs.
- Read
ledger-posting-engine-core.
- Confirm country, payroll period, employee population, payroll components, approved statutory surfaces, payroll clearing accounts, and reviewer roles.
- Do not use final PAYE, NSSF, LST, WHT, levy, relief, threshold, or deadline values unless the source register supports them.
Inputs
| Artifact |
Produced by |
Required? |
Validation |
| Payroll run event |
Payroll module |
Required |
Period, country, employee list, components, approval state, and idempotency key present. |
| Employee master |
HR/payroll |
Required |
Tax identifiers, statutory enrollment status, contract type, cost center, and bank/mobile-money details present. |
| Payroll component map |
Controller |
Required |
Earnings, deductions, employer costs, net pay, and clearing accounts mapped. |
| Source-register snapshot |
Tax statutory skill |
Required for final statutory output |
All statutory values usable for country and period. |
| Payslip evidence |
Payroll module |
Required |
Payslip totals tie to payroll register and journal lines. |
Outputs
| Artifact |
Consumed by |
Acceptance evidence |
| Payroll journal |
GL, close process |
Gross pay, deductions, employer costs, liabilities, and net-pay clearing balance. |
| Statutory liability schedule |
Tax pack |
PAYE, NSSF, LST, WHT, or country-specific liabilities tie to GL. |
| Payslip-to-GL reconciliation |
Employee support, audit pack |
Payslip totals reconcile to payroll register and control accounts. |
| Stale-rate rejection |
Payroll workflow |
Final run blocks when source entries are missing or stale. |
| Payment clearing journal |
Bank reconciliation |
Net pay and statutory payments clear liabilities through bank or mobile money. |
Decision Rules
- Payroll posting starts from approved gross-to-net payroll events, not manual GL entry.
- Employee deductions and employer contributions are separate lines and separate liability or expense mappings.
- Statutory deductions by country require verified source-register entries for final output.
- Draft payroll simulations may use planning placeholders only when visibly caveated.
- Net pay posts to payroll clearing until bank or mobile-money payment evidence clears it.
- Payroll liabilities remain open until statutory payment evidence and return schedule tie out.
- Reversals preserve payslip, payroll register, and statutory return lineage.
- Cross-country payroll must not share statutory calculations without country-specific verification.
Acceptance Evidence
examples/payroll-journal-fixture.md proves gross, deductions, employer cost, liabilities, and clearing.examples/statutory-liability-schedule.md proves liability schedule to GL tie-out without final rates.examples/stale-rate-rejection.md proves missing or expired source-register entries block final payroll.examples/payslip-to-gl-reconciliation.md proves payslip totals tie to journal and statutory schedule.references/domain-acceptance-tests.md is the minimum implementation test set.
Anti-Patterns
- Hardcoding PAYE, NSSF, LST, WHT, reliefs, thresholds, or filing deadlines.
- Netting employer contributions against employee deductions.
- Posting payroll expense only when cash is paid if accrual accounting applies.
- Editing a payroll journal after payslips have been released.
- Paying statutory liabilities without tying the payment to the filed schedule.
- Copying Uganda payroll rules into Kenya, Rwanda, Tanzania, or South Africa.
Required References
references/payroll-event-model.mdreferences/statutory-source-gates.mdreferences/domain-acceptance-tests.mdtax-statutory-source-register-and-country-packs/references/source-register-contract.mdledger-posting-engine-core/references/posting-service-contract.mddoctrine/references/live-rate-verification-protocol.md
Examples
examples/payroll-journal-fixture.mdexamples/statutory-liability-schedule.mdexamples/stale-rate-rejection.mdexamples/payslip-to-gl-reconciliation.md
Review Metadata
| Field |
Value |
| Owner role |
Payroll accounting specialist |
| Reviewer roles |
Country tax reviewer, controller, HR/payroll owner |
| Last reviewed |
2026-05-15 |
| Next review due |
2026-08-15 |
| Release state |
Draft until country statutory gates are validator-enforced |
| Caveat |
No final statutory rates are embedded; final payroll output depends on the source register. |
Last reviewed: 2026-05-15. Next review due: 2026-11-15.
1---2name: payroll-and-statutory-postings-east-africa3description: Use when designing, reviewing, or testing gross-to-net payroll, PAYE, NSSF, LST, WHT, payroll clearing, employer and employee contribution splits, payslip-to-GL reconciliation, and statutory source gates for East Africa country packs.4---56# Payroll and Statutory Postings East Africa78<!-- dual-compat-start -->9## Use When1011Use when payroll journals, gross-to-net schedules, statutory deductions, payroll clearing, payslip tie-outs, or East Africa country payroll gates are in scope.1213## Do Not Use When1415Do not use to hardcode final PAYE, NSSF, LST, WHT, levy, relief, threshold, or deadline values.1617## Required Inputs1819Country, payroll run, employee master, component map, source-register snapshot, approval state, payslip evidence, and payment route.2021## Workflow2223Validate source gates, post approved payroll through the posting service, reconcile payslips to GL, and block stale statutory output.2425## Quality Standards2627Separate employer and employee obligations, source-backed final statutory values, balanced payroll journals, and payslip-to-GL traceability.2829## Anti-Patterns3031Hardcoded statutory values, netting employer and employee lines, edited released payroll journals, and copied country rules.3233## Outputs3435Payroll journals, statutory liability schedules, stale-rate blockers, payment clearing evidence, and payslip reconciliation fixtures.3637## References3839Load the required references and examples listed below before implementation or review.40<!-- dual-compat-end -->4142## Prerequisites4344- Read `doctrine/references/live-rate-verification-protocol.md`.45- Read `tax-statutory-source-register-and-country-packs`.46- Read `ledger-posting-engine-core`.47- Confirm country, payroll period, employee population, payroll components, approved statutory surfaces, payroll clearing accounts, and reviewer roles.48- Do not use final PAYE, NSSF, LST, WHT, levy, relief, threshold, or deadline values unless the source register supports them.4950## Inputs5152| Artifact | Produced by | Required? | Validation |53|---|---|---|---|54| Payroll run event | Payroll module | Required | Period, country, employee list, components, approval state, and idempotency key present. |55| Employee master | HR/payroll | Required | Tax identifiers, statutory enrollment status, contract type, cost center, and bank/mobile-money details present. |56| Payroll component map | Controller | Required | Earnings, deductions, employer costs, net pay, and clearing accounts mapped. |57| Source-register snapshot | Tax statutory skill | Required for final statutory output | All statutory values usable for country and period. |58| Payslip evidence | Payroll module | Required | Payslip totals tie to payroll register and journal lines. |5960## Outputs6162| Artifact | Consumed by | Acceptance evidence |63|---|---|---|64| Payroll journal | GL, close process | Gross pay, deductions, employer costs, liabilities, and net-pay clearing balance. |65| Statutory liability schedule | Tax pack | PAYE, NSSF, LST, WHT, or country-specific liabilities tie to GL. |66| Payslip-to-GL reconciliation | Employee support, audit pack | Payslip totals reconcile to payroll register and control accounts. |67| Stale-rate rejection | Payroll workflow | Final run blocks when source entries are missing or stale. |68| Payment clearing journal | Bank reconciliation | Net pay and statutory payments clear liabilities through bank or mobile money. |6970## Decision Rules71721. Payroll posting starts from approved gross-to-net payroll events, not manual GL entry.732. Employee deductions and employer contributions are separate lines and separate liability or expense mappings.743. Statutory deductions by country require verified source-register entries for final output.754. Draft payroll simulations may use planning placeholders only when visibly caveated.765. Net pay posts to payroll clearing until bank or mobile-money payment evidence clears it.776. Payroll liabilities remain open until statutory payment evidence and return schedule tie out.787. Reversals preserve payslip, payroll register, and statutory return lineage.798. Cross-country payroll must not share statutory calculations without country-specific verification.8081## Acceptance Evidence8283- `examples/payroll-journal-fixture.md` proves gross, deductions, employer cost, liabilities, and clearing.84- `examples/statutory-liability-schedule.md` proves liability schedule to GL tie-out without final rates.85- `examples/stale-rate-rejection.md` proves missing or expired source-register entries block final payroll.86- `examples/payslip-to-gl-reconciliation.md` proves payslip totals tie to journal and statutory schedule.87- `references/domain-acceptance-tests.md` is the minimum implementation test set.8889## Anti-Patterns9091- Hardcoding PAYE, NSSF, LST, WHT, reliefs, thresholds, or filing deadlines.92- Netting employer contributions against employee deductions.93- Posting payroll expense only when cash is paid if accrual accounting applies.94- Editing a payroll journal after payslips have been released.95- Paying statutory liabilities without tying the payment to the filed schedule.96- Copying Uganda payroll rules into Kenya, Rwanda, Tanzania, or South Africa.9798## Required References99100- `references/payroll-event-model.md`101- `references/statutory-source-gates.md`102- `references/domain-acceptance-tests.md`103- `tax-statutory-source-register-and-country-packs/references/source-register-contract.md`104- `ledger-posting-engine-core/references/posting-service-contract.md`105- `doctrine/references/live-rate-verification-protocol.md`106107## Examples108109- `examples/payroll-journal-fixture.md`110- `examples/statutory-liability-schedule.md`111- `examples/stale-rate-rejection.md`112- `examples/payslip-to-gl-reconciliation.md`113114## Review Metadata115116| Field | Value |117|---|---|118| Owner role | Payroll accounting specialist |119| Reviewer roles | Country tax reviewer, controller, HR/payroll owner |120| Last reviewed | 2026-05-15 |121| Next review due | 2026-08-15 |122| Release state | Draft until country statutory gates are validator-enforced |123| Caveat | No final statutory rates are embedded; final payroll output depends on the source register. |124125Last reviewed: 2026-05-15. Next review due: 2026-11-15.
peterbamuhigire