Returns
CIS monthly returns (CIS300; contractor module only), one per tax month (the 6th to the 5th), identified by the calendar year and month the tax month ends in. An Open return collects the subcontractor invoices paid in its month; its totals, invoice and subcontractor counts and a per-subcontractor breakdown follow the payments. The submission child sends it to HMRC (POST), which is polled in the background until HMRC accepts it or reports errors (translated onto the return), and re-opens an accepted return (DELETE). Webhooks: return.submitted, return.accepted, return.failed, return.opened.
-
GET List ReturnsLists the tenant's monthly returns, latest tax period first by default. Filter by the year the tax month ends in and by status (Open, Submitted, Accep.../tenants/{tenant}/returns
-
POST Create ReturnOpens a return for the tax month ending on the 5th of the given month. It collects the subcontractor invoices paid in that month from then on. A tax m.../tenants/{tenant}/returns
-
GET List Return YearsThe calendar years the tenant has returns in, latest first: the year values the list can be filtered by./tenants/{tenant}/returns/years
-
GET Get ReturnReturns the monthly return for the tax month ending in the given year and month, with its totals, status and, after a rejected submission, HMRC's erro.../tenants/{tenant}/returns/{year}/{month}
-
GET Get Return BreakdownThe return broken down by subcontractor: identity, rate, invoice counts, labour, materials, gross, deduction, net and VAT, with a total row last (isTo.../tenants/{tenant}/returns/{year}/{month}/breakdown
-
GET Get Return SubmissionThe return's latest submission to HMRC: when it was sent and last polled, its correlation id and its polling state. The GovTalk request and response X.../tenants/{tenant}/returns/{year}/{month}/submission
-
POST Submit ReturnSends the return to HMRC as a CIS300 with the declarations (that the information is correct is always declared; the employment status and verification.../tenants/{tenant}/returns/{year}/{month}/submission
-
DELETE Re-open ReturnRe-opens an Accepted return (400 otherwise) so the month's payments can be corrected and the return submitted again (webhook return.opened). The submi.../tenants/{tenant}/returns/{year}/{month}/submission