Short-term lets: data collection specification
Data collection specification and example XML schema for the collection of licencing data for short-term lets.
Application details
This section gives the details for the fields related to the application details and describes each of the variables to be exported, their names, the acceptable responses, the values to be returned for those responses, and the automatic validation checks which will be performed by the ProcXed system when they are uploaded.
Date application received
XML Tag:
ApplicationDate
Description:
Date that the application for licence was received by the licencing authority
Format
Date (YYYY-MM-DD)
Validation
Mandatory
Date application determined valid
XML Tag:
ApplicationValidDate
Description:
Date that the application for licence was determined to be valid by the licencing authority
Format
Date (YYYY-MM-DD)
Validation
Mandatory (Optional when Application Status is “Invalid”)
Date application determined
XML Tag:
ApplicationCloseDate
Description:
Date that the application for licence was determined.
Format
Date (YYYY-MM-DD)
Validation
Mandatory except when application is still being determined, in which case should be left blank
Must be after licence applications opened.
Must not be after the present day.
Status of application
XML Tag:
ApplicationStatus
Description:
Description of the decision on the application for licence.
Format
List (two digits codes with leading zeros)
Validation
Mandatory (Optional if application is invalid)
|
Response |
Code |
Description |
|
Granted - no additional conditions |
01 |
Application has been granted, with no additional conditions other than those mandatory conditions which are required by legislation |
|
Granted - with additional conditions |
02 |
Application has been granted, with additional conditional added along with those mandatory conditions required by legislation |
|
Withdrawn |
03 |
Application has been withdrawn by the applicant |
|
Pending determination |
04 |
Application is being determined by the licencing authority |
|
Revoked |
05 |
Licence was granted, but subsequently revoked |
|
Lapsed |
06 |
Licence was granted, but has expired without renewal |
|
Suspended |
07 |
Licence was granted, but has been suspended |
|
Refused |
08 |
Application was refused licence by Local Authority |
|
Invalid |
09 |
Application did not contain sufficient information for determination |
Reason for refusal or revocation
XML Tag:
ApplicationRefusalReason
(Multiple of these tags can be used, and these tags are themselves wrapped within ApplicationRefusalReasonList xml tags)
Description:
The reason for an application’s refusal or revocation.
Format
List (two digits codes with leading zeros)
Repeatable
Validation
Mandatory if application status is refused or revoked
All valid reasons should be selected
|
Reason for refusal |
Code |
|
Applicant not fit and proper |
01 |
|
Premises not suitable |
02 |
|
Planning permission required and not held |
03 |
|
Cannot secure compliance with any other mandatory or additional licencing authority conditions |
04 |
|
Other |
98 |
Contact
Email: housingstatistics@gov.scot
There is a problem
Thanks for your feedback