Construction Industry Scheme Line
CIS lines are generated by invoking a CIS calculation job. The lines represent the calculated result of the sub-contractors CIS instructions.
CisLine [Schema]
Name | Type | Required | Description |
---|---|---|---|
Generated | xsd:dateTime | yes | Indicates the line generation date and time. |
NominalCodeKey | xsd:string ( min: 1 max: 15) | yes | The associated nominal code for the line. |
TaxTreatment | CisTaxTreatment | yes | Indicates the CIS tax treatment. |
CisLineType | CisLineTypeName | yes | The CIS line type identifier. |
PayFrequency | SubContractorPayFrequency | yes | Determines the CIS pay frequency to be calculated. |
TaxYear | TaxYear | yes | Determines the CIS calculation tax year. E.g 2018. |
TaxPeriod | xsd:integer ( min: 1 max: 52) | yes | Determines the CIS calculation tax period. 1 - 12 for monthly or 1 - 52 for weekly. |
TaxMonth | xsd:integer ( min: 1 max: 12) | yes | Determines the reporting tax period. Always 1 - 12 . |
UOM | UomBasicPay | no | The unit of measure. Optional - Used when calculation unit based payments only. |
Units | xsd:decimal | no | The number of units. Optional - Used when calculation unit based payments only. |
UnitRate | xsd:decimal | no | Determines the value of a single unit. Optional - Used when calculation unit based payments only. |
VAT | xsd:decimal | no | The VAT amount to be added. Optional. |
GrossPay | xsd:decimal | yes | Indicates the gross payment value for this line. |
CisDeduction | xsd:decimal | yes | Indicates the amount deducted for CIS contribution. |
Description | xsd:string ( min: 1 max: 250) | no | The optional CIS line type description. |
Example
<?xml version="1.0"?>
<CisLine xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<Generated>2021-01-18T00:00:00+00:00</Generated>
<NominalCodeKey>string</NominalCodeKey>
<TaxTreatment>Taxable</TaxTreatment>
<CisLineType>string</CisLineType>
<PayFrequency>Monthly</PayFrequency>
<TaxYear>123</TaxYear>
<TaxPeriod>123</TaxPeriod>
<TaxMonth>123</TaxMonth>
<UOM>NotSet</UOM>
<Units>123.99</Units>
<UnitRate>123.99</UnitRate>
<VAT>123.99</VAT>
<GrossPay>123.99</GrossPay>
<CisDeduction>123.99</CisDeduction>
<Description>string</Description>
</CisLine>
{
"CisLine": {
"Generated": "2021-01-18T00:00:00+00:00",
"NominalCodeKey": "string",
"TaxTreatment": "Taxable",
"CisLineType": "string",
"PayFrequency": "Monthly",
"TaxYear": "123",
"TaxPeriod": "123",
"TaxMonth": "123",
"UOM": "NotSet",
"Units": "123.99",
"UnitRate": "123.99",
"VAT": "123.99",
"GrossPay": "123.99",
"CisDeduction": "123.99",
"Description": "string"
}
}