GovernmentFormsController
| Base path | /api/government-forms |
| Module | PH Statutory |
| Endpoints | 16 |
| OpenAPI tag | Government Forms |
| Source | backend/src/main/java/com/motorph/payroll/controller/GovernmentFormsController.java |
Endpoints
| Method | Path | Requires | Handler |
|---|---|---|---|
GET | /api/government-forms/bir-2316 | hr.employees.view or payroll.manage | bir2316() |
GET | /api/government-forms/bir-2316/{employeeNumber}/summary | hr.employees.view or payroll.manage | bir2316Summary() |
GET | /api/government-forms/bir-2316/{employeeNumber}/pdf | hr.employees.view or payroll.manage | bir2316Pdf() |
GET | /api/government-forms/bir-2316/zip | hr.employees.view or payroll.manage | bir2316Zip() |
GET | /api/government-forms/bir-2316/{employeeNumber}/inputs | hr.employees.view or payroll.manage | bir2316Inputs() |
PUT | /api/government-forms/bir-2316/{employeeNumber}/inputs | payroll.manage | saveBir2316Inputs() |
GET | /api/government-forms/bir-1601c | hr.employees.view or payroll.manage | bir1601c() |
GET | /api/government-forms/bir-1601c/pdf | hr.employees.view or payroll.manage | bir1601cPdf() |
GET | /api/government-forms/alphalist-dat | hr.employees.view or payroll.manage | alphalistDat() |
GET | /api/government-forms/thirteenth-month | hr.employees.view or payroll.manage | thirteenthMonth() |
GET | /api/government-forms/remittance/summary | hr.employees.view or payroll.manage | remittanceSummary() |
GET | /api/government-forms/remittance/pdf | hr.employees.view or payroll.manage | remittancePdf() |
GET | /api/government-forms/diagnostics | hr.employees.view or payroll.manage | diagnostics() |
GET | /api/government-forms/dole-thirteenth-month | hr.employees.view or payroll.manage | doleThirteenthMonth() |
GET | /api/government-forms/payroll-register | hr.employees.view or payroll.manage | payrollRegister() |
GET | /api/government-forms/dtr | hr.employees.view or payroll.manage | dtr() |
Notes
GET /api/government-forms/bir-2316— Employees who get a 2316 for the year, with each one's readiness, for the dialog's picker.GET /api/government-forms/bir-2316/{employeeNumber}/summary— One employee's certificate in figures: what the dialog shows before generating the PDF.GET /api/government-forms/bir-2316/{employeeNumber}/pdf— One employee's BIR 2316, rendered by JasperReports.GET /api/government-forms/bir-2316/zip— Every employee's BIR 2316 for the year: a ZIP with one PDF each.GET /api/government-forms/bir-2316/{employeeNumber}/inputs— What the preparer entered for the year: employer type, previous employer, PERA, CTC.GET /api/government-forms/bir-1601c— BIR 1601-C figures for the dialog; the same optional inputs as the PDF so the summary matches it.GET /api/government-forms/bir-1601c/pdf— BIR 1601-C filing worksheet PDF: every eFPS field with the value to enter, plus the employee schedule.GET /api/government-forms/remittance/summary— SSS, PhilHealth and Pag-IBIG remittance figures for the dialog; agency=ALL returns all three.GET /api/government-forms/remittance/pdf— The remittance worksheet PDF for one agency or, with agency=ALL, all three.GET /api/government-forms/diagnostics— Whether each form can be prepared for the reporting month, and why not.
Call chain
10 of 11 reachable repositories shown.
Dependencies
Constructor-injected by Lombok's @RequiredArgsConstructor: GovernmentFormsService, Bir1601cService, Bir1601cWorksheet, ContributionMonth, RemittanceWorksheet, FormDiagnosticsService, Bir2316Service, Bir2316Certificate.
Tables reached
| Entity | Table | Tenant-scoped |
|---|---|---|
| Bir2316Inputs | bir_2316_inputs | Yes |
| Bonus | bonus | Yes |
| CompanyProfile | company_profile | Yes |
| Employee | employee | Yes |
| GovernmentFiling | government_filing | Yes |
| Payroll | payroll | Yes |
| PayrollSettings | payroll_settings | Yes |
| Payslip | payslip | Yes |
| PayslipDeductionItem | payslip_deduction_items | Yes |
| Timesheet | timesheet | Yes |
| WithholdingTaxBracket | withholding_tax_brackets | — |
Generated page
This page is rebuilt from the source on every docs build by docs-site/scripts/gen-code-wiki.mjs. Editing it has no effect — change the code, or, if what you want to say is prose, write it in docs/.