Filings

Generate, submit, and track statutory tax filings (PAYE, SSNIT, etc.) to authorities.

📄️List statutory filings

Returns all statutory tax filings (PAYE, SSNIT, etc.) for the tenant. Use to track submission status and identify overdue filings.

📄️Generate statutory filings for run

Generates all required statutory filing records (PAYE, SSNIT, etc.) for an approved payroll run based on the configured jurisdiction and employee data. Generated filings start in 'draft' status and must be explicitly submitted to the authority connector.

📄️Validate statutory filing payload

Runs automated validation checks on a filing's payload against the authority's schema requirements before submission. Returns a validation report with per-field errors. Fix all errors before submitting — authorities typically reject malformed filings with penalties.

📄️Submit filing to tax authority connector

Transmits a validated filing to the configured statutory authority connector (e.g. GRA for PAYE, SSNIT for social security). The filing transitions to 'submitted' status; poll /filings/{id}/status to track authority acknowledgement.

📄️Poll filing status

Polls the current status of a submitted filing from the authority connector. Use after submission to check whether the authority has acknowledged, accepted, or rejected the filing. Rejection responses include the authority's reason codes.

📄️Manually accept filing

Manually marks a filing as accepted when authority confirmation arrives out-of-band (e.g. via email or portal). Records the acceptance with the provided authority reference.

📄️Manually reject filing

Manually marks a filing as rejected, recording the rejection reason. The filing returns to draft for correction and resubmission.