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 freqency 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>2020-01-24T00: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": "2020-01-24T00: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"
  }
}