Generate statutory filings for run

POST/payroll/runs/{run_id}/filings/generate

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.

Request

Path parameters

Name	Type	Required	Description
run_id	integer	Yes	The numeric ID of the payroll run to generate filings for.

Responses

201 Filings generated for the run

Content type application/json, object.

Field	Type	Required	Description
generated	integer	No	Number of filing records created.
filing_ids	array of integer	No

Example

{
  "generated": 2,
  "filing_ids": [
    19,
    20
  ]
}

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/payroll/runs/{run_id}/filings/generate" \
  -H "Accept: application/json"