Construction Industry Scheme Transaction

CIS transactions represent the communications between PayRunIO and the HMRC Gateway.



CisTransaction [Schema]

Name Type Required Description
CisMessageType xsd:string (enumeration)
  • Verification
  • Return
yes The type of CIS message used in this transaction.
TransactionStatus RtiTransactionStatus yes The current status of the CIS transaction.
Timestamp xsd:dateTime yes The timestamp of the CIS transaction.
TransmissionDate xsd:date no The date the CIS submission was made to Government Gateway.
TaxYear xsd:integer yes The relevant tax year for the RTI transaction.
RequestData xsd:string yes The serialised XML message sent to the Government Gateway. This property is [CDATA].
ResponseData xsd:string yes The serialised XML message from the Government Gateway. Where the message has been successfully accepted by the Government Gateway, the response will contain a cryptographic receipt as proof of the transaction. This property is [CDATA].
EmployerCore Link yes A link to the related Employer.

Example

<?xml version="1.0"?>
<CisTransaction xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <CisMessageType>Verification</CisMessageType>
  <TransactionStatus>New</TransactionStatus>
  <Timestamp>2019-11-11T00:00:00+00:00</Timestamp>
  <TransmissionDate>2019-11-11T00:00:00+00:00</TransmissionDate>
  <TaxYear>123</TaxYear>
  <RequestData><![CDATA[string]]></RequestData>
  <ResponseData><![CDATA[string]]></ResponseData>
  <EmployerCore title="string" href="string" rel="string" />
</CisTransaction>
{
  "CisTransaction": {
    "CisMessageType": "Verification",
    "TransactionStatus": "New",
    "Timestamp": "2019-11-11T00:00:00+00:00",
    "TransmissionDate": "2019-11-11T00:00:00+00:00",
    "TaxYear": "123",
    "RequestData": {
      "#cdata-section": "string"
    },
    "ResponseData": {
      "#cdata-section": "string"
    },
    "EmployerCore": {
      "@title": "string",
      "@href": "string",
      "@rel": "string"
    }
  }
}