CisManagerReturnDto

One CIS monthly return, identified by the calendar year and month its tax month ends in

Properties

Name Type Description
yearinteger

The calendar year the tax month ends in

The calendar year the tax month ends in

monthinteger

The calendar month the tax month ends in (on the 5th)

The calendar month the tax month ends in (on the 5th)

statusenum

Open Submitted Accepted Error Submitting

Open Submitted Accepted Error Submitting

dueDatestring

When it is due at HMRC (the 19th)

When it is due at HMRC (the 19th)

isOverdueboolean

Not accepted and past its due date

Not accepted and past its due date

errorsarray of string

HMRC's or the submission's errors, when in error

HMRC's or the submission's errors, when in error

submissionBlockedReasonstring

Why it cannot be submitted now (filing credits, billing), or null

Why it cannot be submitted now (filing credits, billing), or null

creditsRequiredinteger

The filing credits submitting it will use, when it is paid for with them

The filing credits submitting it will use, when it is paid for with them

invoiceCountinteger

The invoices paid in the month

The invoices paid in the month

contactCountinteger

The subcontractors paid in the month

The subcontractors paid in the month

deductionsnumber

The CIS deducted in the month

The CIS deducted in the month

JSON Example

{
  "year": 0,
  "month": 0,
  "status": "Open",
  "dueDate": "2024-01-01",
  "isOverdue": false
}

Contained in Schemas