Submit CIS Return

POST /tenants/{tenant}/tasks/{taskCode}/workflow/groups/{groupNumber}/steps/{stepNumber}/cis/submit

"Submit to HMRC" on a Submit CIS return step: submits the step's tax month's return through CIS Manager now, as
the signed-in user, with the declarations given (a nil return sends neither). Refused (400) with the reason
when the return has changed since the contractor confirmed it, unless ignoreConfirmedChanges is set. Allowed
for a step not started (its dependencies met), blocked, or in progress with a return HMRC rejected; 400
otherwise. A return already submitted or accepted in CIS Manager is not filed again: the step waits on HMRC
or completes. CIS Manager's refusals (filing credits, unfinished HMRC settings, validation) block the step
with the reason and are the 400's message. On success the step is in progress, waiting on HMRC.

Requires: Update on Tasks.

Parameters

NameTypeDescription
tenant* path string

The Tenant.Code

The Tenant.Code

groupNumber* path integer (int32)
stepNumber* path integer (int32)
taskCode* path string

Request Body*

{
  "declareEmploymentStatus": false,
  "declareVerification": false,
  "ignoreConfirmedChanges": false
}

Responses

204 No Content
400 Bad Request
401 Unauthorized – Invalid or missing API key
403 Forbidden – the caller lacks the permissions this endpoint requires; the detail lists every one missing
application/problem+json
404 Not Found