Skip to main content

SSS, PhilHealth and Pag-IBIG remittances

How MotorPH prepares the monthly contribution remittances: where the figures come from, what the remittance worksheet contains, and how it ties to the other contribution reports.

1. Overview​

  • UI: Payroll → Government Forms (/government-forms) → SSS / PhilHealth / Pag-IBIG → Generate.
    • Pick an agency, or All agencies, and a month. The dialog shows one card per agency: members, employee share, employer share (SSS with EC), total to remit, deadline, and payment status.
    • For a single agency it also previews the member list.
  • Outputs:
    • Preview / Download PDF: the remittance worksheet, rendered on the server with JasperReports in the report design system.
    • Excel / CSV: one agency's member list, from the SSS Contribution Collection List, PhilHealth Contribution Summary and Pag-IBIG Remittance Summary reports (/api/payroll-reports/{code}).
  • Scope: only the signed-in user's tenant. Every query runs on tenant-owned entities (Hibernate tenant filter + row-level security). RemittanceTenantIsolationIT checks it.

2. Which payroll counts​

  • Shares as stored on each payslip. These are what employees were charged and what the employer owes. The payroll engine sets them when payslips are generated.
  • Month = pay-period end. This matches how the pay engine reconciles a month's contributions against the monthly caps.
  • Processed runs only. Pending and Approved runs ending in the month are listed in a DRAFT warning, in the dialog and the PDF. Cancelled (including reversed) and Rejected runs never count.
  • SSS EC: the stored SSS employer share includes Employees' Compensation. The worksheet shows EC on its own, taken from the SSS schedule for the employee's monthly basis and never more than the stored share.

The worksheet, the dialog and the three contribution reports all read report/contributions/ContributionMonth, so they always agree.

3. The worksheet​

One agency:

  • Alerts:
    • DRAFT runs;
    • members without a member number;
    • payslips with no stored employer share;
    • a missing employer number in the Company Profile;
    • under- or over-remittance.
  • KPI tiles: amount to remit, employee share, employer share, deadline.
  • Portal fields:
    • employer number, name and TIN;
    • applicable month (MM/YYYY);
    • number of members;
    • employee share, employer share, EC (SSS);
    • total amount to remit;
    • a blank box for the payment reference (SSS PRN, PhilHealth SPA, Pag-IBIG reference);
    • deadline;
    • recorded payment.
  • Member contribution list: employee number, name, member number, monthly basis, employee share, employer share, EC (SSS), total, with a total row.

All agencies: combined KPIs, a summary table per agency, and a stacked bar chart of employee against employer shares. Then each agency's portal fields and member list, on its own page.

Payment status comes from Filings & Receipts records of type SSS, PHILHEALTH and PAGIBIG for the month. Not recorded, remitted (within ₱0.01), under-remitted and over-remitted are each reported, with the reference numbers.

4. Deadlines​

AgencyDeadline shownRule
SSSLast day of the following monthOn or before the last day of the month after the applicable month
PhilHealth20th of the following monthWithin the first 20 days of the following month (EPRS)
Pag-IBIG25th of the following month10th–25th of the following month, by the first letter of the employer's name

When a deadline falls on a weekend or holiday, the next working day applies.

5. Endpoints​

EndpointReturns
GET /api/government-forms/remittance/summary?agency=SSS|PHILHEALTH|PAGIBIG|ALL&year&monthJSON for the dialog
GET /api/government-forms/remittance/pdf?agency&year&monthThe worksheet PDF, e.g. SSS-Remittance-2026-09.pdf or Contribution-Remittances-2026-09.pdf

Access: hr.employees.view or payroll.manage.

6. Known limitations​

  • The worksheet is not an agency form. The SSS R-3 / collection list, PhilHealth RF-1 and Pag-IBIG MCRF are produced or uploaded through each agency's portal.
  • Payslips generated before employer shares were stored show a zero employer share. The worksheet counts and flags them.
  • Pag-IBIG's exact day within the 10th–25th window depends on the employer's name; the deadline shown is the end of the window.

7. Testing​

TestWhat it covers
backend/.../report/builders/ContributionMonthTest.javaProcessed-only, DRAFT runs, EC split and cap, missing numbers and employer shares, payment status, deadlines
backend/.../report/forms/RemittanceWorksheetTest.javaSSS (with EC), Pag-IBIG (no EC, missing employer ID), All agencies with the DRAFT banner
backend/.../report/builders/GovernmentReportsTest.java, EmployeeOrderTest.javaThe table reports built on the same source
backend/.../tenancy/RemittanceTenantIsolationIT.javaTwo tenants in the same month see only their own members
e2e/HR_Recruitment/remittance-form.spec.tsDialog defaults, agency cards, All-agencies view, PDF and Excel downloads, empty month