Manually reject filing

POST/payroll/filings/{id}/reject

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

Request

Path parameters

Name	Type	Required	Description
id	integer	Yes	The numeric ID of the filing to reject.

Request body

Content type application/json.

Field	Type	Required	Description
reason	string	No	Rejection reason or authority-issued error code.

Example

{
  "reason": "ERR_INVALID_TIN: Employer TIN does not match GRA records."
}

Responses

200 Filing marked as rejected; available for correction

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/payroll/filings/{id}/reject" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"reason": "ERR_INVALID_TIN: Employer TIN does not match GRA records."}'