baarkerlounger
/
submit-social-housing-lettings-and-sales-data
mirror of https://github.com/communitiesuk/submit-social-housing-lettings-and-sales-data.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Browse Source

CLDC-4203: Update bulk upload field numbers (#3189) 

* CLDC-4141: copy person questions refactor from CLDC-4142

* CLDC-4141: remove gender same as sex and replace gender identity q

* CLDC-4141: replace sex with sexrab where relevant for 2026

* CLDC-4141: update download order

* CLDC-4140: remove sex from rowparser entirely

* CLDC-4140: keep sex in factory for now

* CLDC-4140: update household characteristics test

* CLDC-4140: update log variable spec

* CLDC-4140: update csv export tests

* CLDC-4140: update validator tests

* CLDC-4140: update row-parser spec

* CLDC-4140: update csv-parser spec

* CLDC-4140: update export spec

* CLDC-4140: update log var defs spec

* CLDC-4140: update export spec

* CLDC-4140: update row parser spec

* CLDC-4140: update validator spec

* CLDC-4140: update csv parser spec

* CLDC-4143: Update gender retirement validations

rename functions as the new wording is more related to those that identify as male and any other option

* CLDC-4143: Add 2026 tests

* CLDC-4143: Update legacy json files

causes issues with some old tests

* CLDC-4143: Add error mappings for gender fields

* CLDC-4143: Add new gender age retirement soft validation

replaces the many check pages from previous years with a single one

shows if either of the previous ones would show

has agreed wording on ticket

* fixup! CLDC-4143: Update gender retirement validations

improve gender comment wording

* CLDC-4143: Update non males validation name

reference to 'soft validation' we found confusing

* fixup! CLDC-4143: Add new gender age retirement soft validation

update subsection specs

* CLDC-4140: update parsers post merge

* CLDC-4140: update tests after field renumbering

* CLDC-4140: update tests after field renumbering

* CLDC-4203: Remove builtype from BU

* CLDC-4203: Renumber sex/gender fields

* CLDC-4203: Renumber source of referral fields

* CLDC-4203: Renumber lettings_log_to_csv to_2026_row comments

* CLDC-4140: update spacing in to_2026_row

* CLDC-4140: update row parser spec field numbers

* CLDC-4140: update row parser field types

* CLDC-4203: Swap age and relat fields

as age is now asked first

* CLDC-4203: Update error messages for fields to match BU

* CLDC-4203: Add a new example BU file

* CLDC-4203: Update tests

* CLDC-4164: Fix spacing in lettings_log_to_csv

* CLDC-4203: Fix error description q order

Co-authored-by: Nat Dean-Lewis <94526761+natdeanlewissoftwire@users.noreply.github.com>

* CLDC-4203: Fix attribute ordering in row_parser

---------

Co-authored-by: Nat Dean-Lewis <nat.dean-lewis@softwire.com>
Co-authored-by: Nat Dean-Lewis <94526761+natdeanlewissoftwire@users.noreply.github.com>
pull/3179/head^2
Samuel Young 2 days ago committed by GitHub
parent
e01ae69f21
commit
f1d53bfe01
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
7 changed files with 1184 additions and 1189 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 111
      app/helpers/bulk_upload/lettings_log_to_csv.rb
  2. 2
      app/services/bulk_upload/lettings/year2026/csv_parser.rb
  3. 1089
      app/services/bulk_upload/lettings/year2026/row_parser.rb
  4. 70
      spec/fixtures/files/2026_27_lettings_bulk_upload.csv
  5. 4
      spec/services/bulk_upload/lettings/validator_spec.rb
  6. 8
      spec/services/bulk_upload/lettings/year2026/csv_parser_spec.rb
  7. 1089
      spec/services/bulk_upload/lettings/year2026/row_parser_spec.rb

111
app/helpers/bulk_upload/lettings_log_to_csv.rb
Unescape View File

@ -105,8 +105,8 @@ class BulkUpload::LettingsLogToCsv
renewal,
log.startdate&.day,
log.startdate&.month,
log.startdate&.strftime("%y"), # 10
log.startdate&.strftime("%y"), # 10
rent_type,
log.irproduct_other,
log.tenancycode,
@ -116,20 +116,19 @@ class BulkUpload::LettingsLogToCsv
log.unitletas,
log.uprn,
log.address_line1&.tr(",", " "),
log.address_line2&.tr(",", " "), # 20
log.address_line2&.tr(",", " "), # 20
log.town_or_city&.tr(",", " "),
log.county&.tr(",", " "),
((log.postcode_full || "").split(" ") || [""]).first,
((log.postcode_full || "").split(" ") || [""]).last,
log.la,
log.unittype_gn,
log.builtype,
log.wchair,
log.beds,
log.voiddate&.day, # 30
log.voiddate&.day,
log.voiddate&.month,
log.voiddate&.month, # 30
log.voiddate&.strftime("%y"),
log.mrcdate&.day,
log.mrcdate&.month,
@ -138,98 +137,119 @@ class BulkUpload::LettingsLogToCsv
log.joint,
log.startertenancy,
log.tenancy,
log.tenancyother, # 40
log.tenancyother,
log.tenancylength,
log.tenancylength, # 40
log.age1 || overrides[:age1],
log.sexrab1,
log.gender_same_as_sex1,
log.gender_description1,
log.ethnic,
log.nationality_all_group,
log.ecstat1,
relat_number(log.relat2),
log.age2 || overrides[:age2],
log.sexrab2,
log.ecstat2, # 50
relat_number(log.relat2),
relat_number(log.relat3),
log.sexrab2, # 50
log.gender_same_as_sex2,
log.gender_description2,
log.ecstat2,
log.age3 || overrides[:age3],
relat_number(log.relat3),
log.sexrab3,
log.gender_same_as_sex3,
log.gender_description3,
log.ecstat3,
log.age4 || overrides[:age4], # 60
relat_number(log.relat4),
log.age4 || overrides[:age4],
log.sexrab4,
log.gender_same_as_sex4,
log.gender_description4,
log.ecstat4,
log.age5 || overrides[:age5],
relat_number(log.relat5),
log.age5 || overrides[:age5], # 60
log.sexrab5,
log.gender_same_as_sex5,
log.gender_description5, # 70
log.ecstat5,
relat_number(log.relat6),
log.age6 || overrides[:age6],
relat_number(log.relat6),
log.sexrab6,
log.gender_same_as_sex6,
log.gender_description6,
log.ecstat6,
relat_number(log.relat7),
log.age7 || overrides[:age7],
log.sexrab7,
log.ecstat7, # 70
relat_number(log.relat7),
relat_number(log.relat8),
log.sexrab7, # 80
log.gender_same_as_sex7,
log.gender_description7,
log.ecstat7,
log.age8 || overrides[:age8],
relat_number(log.relat8),
log.sexrab8,
log.gender_same_as_sex8,
log.gender_description8,
log.ecstat8,
log.armedforces,
log.armedforces, # 90
log.leftreg,
log.reservist,
log.preg_occ,
log.housingneeds_a,
log.housingneeds_b, # 80
log.housingneeds_b,
log.housingneeds_c,
log.housingneeds_f,
log.housingneeds_g,
log.housingneeds_h,
overrides[:illness] || log.illness,
overrides[:illness] || log.illness, # 100
log.illness_type_1,
log.illness_type_2,
log.illness_type_3,
log.illness_type_4,
log.illness_type_5, # 90
log.illness_type_5,
log.illness_type_6,
log.illness_type_7,
log.illness_type_8,
log.illness_type_9,
log.illness_type_10,
log.illness_type_10, # 110
log.layear,
log.waityear,
log.reason,
log.reasonother,
log.prevten, # 100
log.prevten,
homeless,
previous_postcode_known,
((log.ppostcode_full || "").split(" ") || [""]).first,
((log.ppostcode_full || "").split(" ") || [""]).last,
log.prevloc,
log.prevloc, # 120
log.reasonpref,
log.rp_homeless,
log.rp_insan_unsat,
log.rp_medwel,
log.rp_hardship, # 110
log.rp_hardship,
log.rp_dontknow,
cbl,
chr,
cap,
accessible_register,
accessible_register, # 130
log.owning_organisation.la? ? log.referral_register : nil,
log.owning_organisation.prp? ? log.referral_register : nil,
log.referral_noms,
log.referral_org,
net_income_known,
log.incfreq,
log.earnings,
log.hb, # 120
log.hb,
log.benefits,
log.household_charge,
log.household_charge, # 140
log.period,
log.brent,
log.scharge,
@ -237,27 +257,6 @@ class BulkUpload::LettingsLogToCsv
log.supcharg,
log.hbrentshortfall,
log.tshortfall,
log.gender_same_as_sex1, # 130
log.gender_description1,
log.gender_same_as_sex2,
log.gender_description2,
log.gender_same_as_sex3,
log.gender_description3,
log.gender_same_as_sex4,
log.gender_description4,
log.gender_same_as_sex5,
log.gender_description5,
log.gender_same_as_sex6, # 140
log.gender_description6,
log.gender_same_as_sex7,
log.gender_description7,
log.gender_same_as_sex8,
log.gender_description8,
log.owning_organisation.prp? ? log.referral_register : nil,
log.referral_noms,
log.referral_org, # 148
]
end

2
app/services/bulk_upload/lettings/year2026/csv_parser.rb
Unescape View File

@ -4,7 +4,7 @@ class BulkUpload::Lettings::Year2026::CsvParser
include CollectionTimeHelper
# TODO: CLDC-4162: Update when 2026 format is known
FIELDS = 148
FIELDS = 147
FORM_YEAR = 2026
attr_reader :path

1089
app/services/bulk_upload/lettings/year2026/row_parser.rb
View File

File diff suppressed because it is too large Load Diff

70
spec/fixtures/files/2026_27_lettings_bulk_upload.csv vendored
Unescape View File

@ -1,5 +1,5 @@
Section,Setting up this lettings log,,,,,,,,,,,,,,,Property information,,,,,,,,,,,,,,,,,,,,,Tenancy information,,,,,Household characteristics,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,Household needs,,,,,,,,,,,,,,,,,,,,,Household situation,,,,,,,,,,,,,,,,,,,,,"Income, benefits and outgoings",,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
Question,Which organisation owns this property?,Which organisation manages this letting?,What is the CORE username of the account this letting log should be assigned to? ,What is the needs type?,What scheme does this letting belong to?,Which location is this letting for?,Is this letting a renewal of social housing to the same tenant in the same property?,What is the tenancy start date? - day DD,What is the tenancy start date? - month MM,What is the tenancy start date? - year YY,What is the rent type?,Which 'Other' type of Intermediate Rent is this letting?,What is the tenant code?,What is the property reference?,Has the tenant seen or been given access to the MHCLG privacy notice?,What is the reason for the property being vacant?,What type was the property most recently let as?,"If known, provide this property’s UPRN",Address Line 1,Address Line 2,Town or city,County,Part 1 of the property's postcode,Part 2 of the property's postcode,What is the property's local authority?,What type of unit is the property?,Which type of building is the property?,Is the property built or adapted to wheelchair-user standards?,How many bedrooms does the property have?,What is the void date? - day DD,What is the void date? - month MM,What is the void date? - year YY,What date were any major repairs completed on? - day DD,What date were any major repairs completed on? - month MM,What date were any major repairs completed on? - year YY,Is this property older people's housing?,Is this a joint tenancy?,Is this a starter tenancy?,What is the type of tenancy?,"If 'Other', what is the type of tenancy?",What is the length of the fixed-term tenancy to the nearest year?,What is the lead tenant’s age?,Which of these best describes the lead tenant’s gender identity? ,Which of these best describes the lead tenant's ethnic background?,What is the lead tenant’s nationality?,Which of these best describes the lead tenant’s working situation?,Is person 2 the partner of the lead tenant?,What is person 2's age?,Which of these best describes person 2's gender identity?,Which of these best describes person 2's working situation?,Is person 3 the partner of the lead tenant?,What is person 3's age?,Which of these best describes person 3's gender identity?,Which of these best describes person 3's working situation?,Is person 4 the partner of the lead tenant?,What is person 4's age?,Which of these best describes person 4's gender identity?,Which of these best describes person 4's working situation?,Is person 5 the partner of the lead tenant?,What is person 5's age?,Which of these best describes person 5's gender identity?,Which of these best describes person 5's working situation?,Is person 6 the partner of the lead tenant?,What is person 6's age?,Which of these best describes person 6's gender identity?,Which of these best describes person 6's working situation?,Is person 7 the partner of the lead tenant?,What is person 7's age?,Which of these best describes person 7's gender identity?,Which of these best describes person 7's working situation?,Is person 8 the partner of the lead tenant?,What is person 8's age?,Which of these best describes person 8's gender identity?,Which of these best describes person 8's working situation?,Does anybody in the household have links to the UK armed forces?,Is this person still serving in the UK armed forces?,Was this person seriously injured or ill as a result of serving in the UK armed forces?,Is anybody in the household pregnant?,"Disabled access needs
Section,Setting up this lettings log,,,,,,,,,,,,,,,Property information,,,,,,,,,,,,,,,,,,,,Tenancy information,,,,,Household characteristics,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,Household needs,,,,,,,,,,,,,,,,,,,,,Household situation,,,,,,,,,,,,,,,,,,,,,,,,"Income, benefits and outgoings",,,,,,,,,,,,
Question,Which organisation owns this property?,Which organisation manages this letting?,What is the CORE username of the account this letting log should be assigned to? ,What is the needs type?,What scheme does this letting belong to?,Which location is this letting for?,Is this letting a renewal of social housing to the same tenant in the same property?,What is the tenancy start date? - day DD,What is the tenancy start date? - month MM,What is the tenancy start date? - year YY,What is the rent type?,Which 'Other' type of Intermediate Rent is this letting?,What is the tenant code?,What is the property reference?,Has the tenant seen or been given access to the MHCLG privacy notice?,What is the reason for the property being vacant?,What type was the property most recently let as?,"If known, provide this property’s UPRN",Address Line 1,Address Line 2,Town or city,County,Part 1 of the property's postcode,Part 2 of the property's postcode,What is the property's local authority?,What type of unit is the property?,Is the property built or adapted to wheelchair-user standards?,How many bedrooms does the property have?,What is the void date? - day DD,What is the void date? - month MM,What is the void date? - year YY,What date were any major repairs completed on? - day DD,What date were any major repairs completed on? - month MM,What date were any major repairs completed on? - year YY,Is this property older people's housing?,Is this a joint tenancy?,Is this a starter tenancy?,What is the type of tenancy?,"If 'Other', what is the type of tenancy?",What is the length of the fixed-term tenancy to the nearest year?,What is the lead tenant’s age?,What is the lead tenant's sex?,Is the gender the lead tenant identifies with the same as their sex registered at birth?,"If 'No', enter lead tenant's gender identity",Which of these best describes the lead tenant's ethnic background?,What is the lead tenant’s nationality?,Which of these best describes the lead tenant’s working situation?,What is person 2's age?,Is person 2 the partner of the lead tenant?,What is person 2's sex?,Is the gender the person 2 identifies with the same as their sex registered at birth?,"If 'No', enter person 2's gender identity",Which of these best describes person 2's working situation?,What is person 3's age?,Is person 3 the partner of the lead tenant?,What is person 3's sex?,Is the gender the person 3 identifies with the same as their sex registered at birth?,"If 'No', enter person 3's gender identity",Which of these best describes person 3's working situation?,What is person 4's age?,Is person 4 the partner of the lead tenant?,What is person 4's sex?,Is the gender the person 4 identifies with the same as their sex registered at birth?,"If 'No', enter person 4's gender identity",Which of these best describes person 4's working situation?,What is person 5's age?,Is person 5 the partner of the lead tenant?,What is person 5's sex?,Is the gender the person 5 identifies with the same as their sex registered at birth?,"If 'No', enter person 5's gender identity",Which of these best describes person 5's working situation?,What is person 6's age?,Is person 6 the partner of the lead tenant?,What is person 6's sex?,Is the gender the person 6 identifies with the same as their sex registered at birth?,"If 'No', enter person 6's gender identity",Which of these best describes person 6's working situation?,What is person 7's age?,Is person 7 the partner of the lead tenant?,What is person 7's sex?,Is the gender the person 7 identifies with the same as their sex registered at birth?,"If 'No', enter person 7's gender identity",Which of these best describes person 7's working situation?,What is person 8's age?,Is person 8 the partner of the lead tenant?,What is person 8's sex?,Is the gender the person 8 identifies with the same as their sex registered at birth?,"If 'No', enter person 8's gender identity",Which of these best describes person 8's working situation?,Does anybody in the household have links to the UK armed forces?,Is this person still serving in the UK armed forces?,Was this person seriously injured or ill as a result of serving in the UK armed forces?,Is anybody in the household pregnant?,"Disabled access needs
a) Fully wheelchair-accessible housing","Disabled access needs
@ -29,59 +29,63 @@ Common Allocations Policy (CAP)","How was this letting allocated?
Common Housing Register (CHR)","How was this letting allocated?
Accessible Housing Register",What was the source of referral for this letting? - LA properties,Do you know the household's combined total income after tax?,How often does the household receive income?,How much income does the household have in total?,Is the tenant likely to be receiving any of these housing-related benefits?,"How much of the household's income is from Universal Credit, state pensions or benefits?",Does the household pay rent or other charges for the accommodation?,How often does the household pay rent and other charges?,What is the basic rent?,What is the service charge?,What is the personal service charge?,What is the support charge?,"After the household has received any housing-related benefits, will they still need to pay for rent and charges?",What do you expect the outstanding amount to be?,What was the lead tenant's sex at birth?,What was person 2's sex registered at birth?,What was person 3's sex registered at birth?,What was person 4's sex registered at birth?,What was person 5's sex registered at birth?,What was person 6's sex registered at birth?,What was person 7's sex registered at birth?,What was person 8's sex registered at birth?,Is the gender the lead tenant identifies with the same as their sex registered at birth?,"If 'No', enter lead tenant's gender identity",Is the gender the person 2 identifies with the same as their sex registered at birth?,"If 'No', enter person 2's gender identity",Is the gender the person 3 identifies with the same as their sex registered at birth?,"If 'No', enter person 3's gender identity",Is the gender the person 4 identifies with the same as their sex registered at birth?,"If 'No', enter person 4's gender identity",Is the gender the person 5 identifies with the same as their sex registered at birth?,"If 'No', enter person 5's gender identity",Is the gender the person 6 identifies with the same as their sex registered at birth?,"If 'No', enter person 6's gender identity",Is the gender the person 7 identifies with the same as their sex registered at birth?,"If 'No', enter person 7's gender identity",Is the gender the person 8 identifies with the same as their sex registered at birth?,"If 'No', enter person 8's gender identity",What was the source of referral for this letting? - PRP properties part 1,What was the source of referral for this letting? - PRP properties part 2,What was the source of referral for this letting? - PRP properties part 3
Additional info,"You can find the org ID on the CORE service under 'Stock owners' or, if your organisation is the stock owner, under 'About your organisation'","You can find the org ID on the CORE service under 'Managing agents' or, if your organisation is the managing agent, under 'About your organisation'","If left empty, the letting log will be assigned to the account used to upload the log.","General needs housing includes both self-contained and shared housing without support or specific adaptations. Supported housing includes direct access hostels, group homes, residential care and nursing homes.","Scheme code. Include the 'S' at the beginning if it has one.
Accessible Housing Register",What was the source of referral for this letting? - LA properties,What was the source of referral for this letting? - PRP properties part 1,What was the source of referral for this letting? - PRP properties part 2,What was the source of referral for this letting? - PRP properties part 3,Do you know the household's combined total income after tax?,How often does the household receive income?,How much income does the household have in total?,Is the tenant likely to be receiving any of these housing-related benefits?,"How much of the household's income is from Universal Credit, state pensions or benefits?",Does the household pay rent or other charges for the accommodation?,How often does the household pay rent and other charges?,What is the basic rent?,What is the service charge?,What is the personal service charge?,What is the support charge?,"After the household has received any housing-related benefits, will they still need to pay for rent and charges?",What do you expect the outstanding amount to be?
Additional info,"You can find the org ID on the CORE service under 'Stock owners' or, if your organisation is the stock owner, under 'About your organisation'","You can find the org ID on the CORE service under 'Managing agents' or, if your organisation is the managing agent, under 'About your organisation'","If left empty, the letting log will be assigned to the account used to upload the log.","General needs housing includes both self-contained and shared housing without support or specific adaptations.
Supported housing is housing with special design facilities or features targeted at a specific client group requiring support, for example housing designed for older people, sheltered accommodation, extra care housing. It can include direct access hostels, group homes, and purpose-built self-contained housing. We do not require CORE logs for residential care or nursing homes.","Scheme code. Include the 'S' at the beginning if it has one.
You can find the scheme code on the CORE service under 'Schemes', either by searching for the specific scheme or downloading a csv.","Location code.
You can find the location code on the CORE service under 'Schemes', either by searching for the specific location or downloading a csv.","If the property was previously being used as temporary accommodation, then answer 'no'.",,,,See specification for definitions,,This is how you usually refer to this tenancy on your own systems.,This is how you usually refer to this property on your own systems.,"Make sure the lead tenant has seen or been given access to the Ministry of Housing, Communities and Local Government (MHCLG) privacy notice before completing this log. This is a legal requirement under data protection legislation.","Internal transfer - Where a tenant moved from one social housing property to another property. Their landlord may be the same or may have changed.
Renewal of a fixed term tenancy - to the same tenant in the same property, except if was previously used as temporary accommodation.",This is the rent type of the previous tenancy in this property.,"The Unique Property Reference Number (UPRN) is a unique number system created by Ordnance Survey and used by housing providers and various industries across the UK. An example UPRN is 10010457355.
The UPRN may not be the same as the property reference assigned by your organisation.",,,,,Combined with field 22 it should be a postcode which lies within the local authority given in field 25.,Combined with field 21 it should be a postcode which lies within the local authority given in field 25.,,,,"This is whether someone who uses a wheelchair is able to make full use of all of the property’s rooms and facilities, including use of both inside and outside space, and entering and exiting the property.","If shared accommodation, enter the number of bedrooms occupied by this household. A bedsit has 1 bedroom.","Date the property was (legally/contractually) available to let, or for:
The UPRN may not be the same as the property reference assigned by your organisation.",,,,,Combined with field 22 it should be a postcode which lies within the local authority given in field 25.,Combined with field 21 it should be a postcode which lies within the local authority given in field 25.,,,"This is whether someone who uses a wheelchair is able to make full use of all of the property’s rooms and facilities, including use of both inside and outside space, and entering and exiting the property.","If shared accommodation, enter the number of bedrooms occupied by this household. A bedsit has 1 bedroom.","Date the property was (legally/contractually) available to let, or for:
- re-lets: the day after previous tenant’s contract end
- new-builds: the day the landlord legally owned the property ('completion date’)
- new conversions or acquisitions: the completion date, or the day after any rehabilitation work ended
- new leases: the day the landlord got contractual property rights, and could let it out to tenants.",,,"Major repairs are works that could not be reasonably carried out with a tenant living at the property. For example, structural repairs.",,,"This includes retirement living, sheltered housing and extra care housing. There is no national set limit for “older people”, please answer based on your own policies.
- new leases: the day the landlord got contractual property rights, and could let it out to tenants.",,,"Major repairs are works which could not reasonably be carried out with a tenant in occupation, and which need to be carried out in a property while it is vacant. They involve remedial works that are necessary for the property to remain habitable and include structural repairs, site works and service installations.",,,"This includes retirement living, sheltered housing and extra care housing. There is no national set limit for “older people”, please answer based on your own policies.
Extra care housing is for tenants with medium to high care and support needs, often with 24 hour access to support staff provided by an agency registered with the Care Quality Commission.",This is where two or more people are named on the tenancy agreement.,"If the tenancy has an ‘introductory period’ answer ‘yes’.
You should submit a CORE log at the beginning of the starter tenancy or introductory period, with the best information you have at the time. You do not need to submit a log when a tenant later rolls onto the main tenancy.",This is about the main tenancy after any starter or introductory period. See specification for definitions.,,Do not include the starter or introductory period. The minimum period is 2 years for social or affordable rent general needs logs. You do not need to submit CORE logs for these types of tenancies if they are shorter than 2 years.,"This is the household member who does the most paid work. If several people do the same amount of paid work, it's the oldest household member.",This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.,,"If the lead tenant is a dual national of the United Kingdom and another country, enter United Kingdom. If they are a dual national of two other countries, the tenant should decide which country to enter.","This is the household member who does the most paid work. If several people do the same amount of paid work, it's the oldest household member.",,Answer 1 for children aged under 1 year old,This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.,,,Answer 1 for children aged under 1 year old,This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.,,,Answer 1 for children aged under 1 year old,This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.,,,Answer 1 for children aged under 1 year old,This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.,,,Answer 1 for children aged under 1 year old,This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.,,,Answer 1 for children aged under 1 year old,This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.,,,Answer 1 for children aged under 1 year old,This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.,,"This excludes national service.
If several household members have these links, answer for regular first. If no regular, answer for reserve. If no reserve, answer for spouses or civil partners.",,,,,,,,,,,"For example, lifting and carrying objects, or using a keyboard",,"For example, deafness or partial hearing",,"For example, depression or anxiety","For example, walking short distances or climbing stairs","For example, anything associated with autism spectrum disorder (ASD), including Asperger’s or attention deficit hyperactivity disorder (ADHD)",,"For example, blindness or partial sight",,,,"The tenant's ‘last settled home' is their last long-standing home. For tenants who had temporary accommodation, sleeping rough or otherwise homeless, their last settled home is where they were living previously.",,,,"This is the tenant’s last long-standing home. It is where the tenant was living before any period in temporary accommodation, sleeping rough or otherwise homeless.","Combined with field 104, it should be a postcode which lies within the local authority given in field 105.","Combined with field 103, it should be a postcode which lies within the local authority given in field 105.","This is the tenant’s last long-standing home. It is where the tenant was living before any period in temporary accommodation, sleeping rough or otherwise homeless.",Households may be given ‘reasonable preference’ for social housing under one or more specific category by the local authority. This is also known as ‘priority need’.,,,,,,Where available vacant properties are advertised and applicants are able to bid for specific properties.,Where a common system agreed between a group of housing providers is used to determine applicants' priority for housing.,Where a single waiting list is used by a group of housing providers to receive and process housing applications. Providers may use different approaches to determine priority.,Where the 'access category' or another descriptor of whether an available vacant property meets a range of access needs is displayed to applicants during the allocations process.,,,,"Include any income after tax from employment, pensions, and Universal Credit. Don't include National Insurance (NI) contributions and tax, housing benefit, child benefit, or council tax support.","This is about when the tenant is in their new let. If they are unsure about the situation for their new let and their financial and working situation hasn’t changed significantly, answer based on what housing-related benefits they currently receive.",,"If rent is charged on the property then answer Yes, even if tenants do not pay it themselves.",,"This is the amount paid before any charges are added for services (for example, hot water or cleaning). Households may receive housing benefit or Universal Credit towards basic rent.","For example, cleaning. Households may get household benefits towards the service charge.",For example heating or hot water. This doesn’t include housing benefit or Universal Credit.,Any charges made to fund support services included in the tenancy agreement.,Also known as the 'outstanding amount',You only need to give an approximate figure.,This is the sex that was registered at birth.,This is the sex that was registered at birth.,This is the sex that was registered at birth.,This is the sex that was registered at birth.,This is the sex that was registered at birth.,This is the sex that was registered at birth.,This is the sex that was registered at birth.,This is the sex that was registered at birth.,,,,,,,,,,,,,,,,,,,
Values,Alphanumeric,,Email format,01-Feb,Alphanumeric,Numeric,01-Feb,Jan-31,01-Dec,25 - 26,01-Jul,Text,"Alphanumeric, max 13 characters","Alphanumeric, max 12 characters",1,"5 - 6, or 8 - 22",1 - 3 or 5 - 9,Numeric,Alphanumeric,,Text,,"Alphanumeric,
You should submit a CORE log at the beginning of the starter tenancy or introductory period, with the best information you have at the time. You do not need to submit a log when a tenant later rolls onto the main tenancy.",This is about the main tenancy after any starter or introductory period. See specification for definitions.,,Do not include the starter or introductory period. The minimum period is 2 years for social or affordable rent general needs logs. You do not need to submit CORE logs for these types of tenancies if they are shorter than 2 years.,"This is the household member who does the most paid work. If several people do the same amount of paid work, it's the oldest household member.",This is their sex as registered at birth. The next question will ask about gender identity.,,,,"If the lead tenant is a dual national of the United Kingdom and another country, enter United Kingdom. If they are a dual national of two other countries, the tenant should decide which country to enter.","This is the household member who does the most paid work. If several people do the same amount of paid work, it's the oldest household member.
People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer ""Not seeking work"".",Answer 1 for children aged under 1 year old,,This is their sex as registered at birth. The next question will ask about gender identity.,,,"People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer ""Not seeking work"".",Answer 1 for children aged under 1 year old,,This is their sex as registered at birth. The next question will ask about gender identity.,,,"People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer ""Not seeking work"".",Answer 1 for children aged under 1 year old,,This is their sex as registered at birth. The next question will ask about gender identity.,,,"People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer ""Not seeking work"".",Answer 1 for children aged under 1 year old,,This is their sex as registered at birth. The next question will ask about gender identity.,,,"People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer ""Not seeking work"".",Answer 1 for children aged under 1 year old,,This is their sex as registered at birth. The next question will ask about gender identity.,,,"People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer ""Not seeking work"".",Answer 1 for children aged under 1 year old,,This is their sex as registered at birth. The next question will ask about gender identity.,,,"People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer ""Not seeking work"".",Answer 1 for children aged under 1 year old,,This is their sex as registered at birth. The next question will ask about gender identity.,,,"People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer ""Not seeking work"".","This excludes national service.
If several household members have these links, answer for regular first. If no regular, answer for reserve. If no reserve, answer for spouses or civil partners.",,,,,,,,,,,"For example, lifting and carrying objects, or using a keyboard",,"For example, deafness or partial hearing",,"For example, depression or anxiety","For example, walking short distances or climbing stairs","For example, anything associated with autism spectrum disorder (ASD), including Asperger’s or attention deficit hyperactivity disorder (ADHD)",,"For example, blindness or partial sight",,,,"The tenant's ‘last settled home' is their last long-standing home. For tenants who had temporary accommodation, sleeping rough or otherwise homeless, their last settled home is where they were living immediately before that period.",,This is where the household was the night before they moved into this new let.,,"This is the tenant’s last long-standing home. It is where the tenant was living before any period in temporary accommodation, sleeping rough or otherwise homeless.","Combined with field 119, it should be a postcode which lies within the local authority given in field 120.","Combined with field 118, it should be a postcode which lies within the local authority given in field 120.","This is the tenant’s last long-standing home. It is where the tenant was living before any period in temporary accommodation, sleeping rough or otherwise homeless.",Households may be given ‘reasonable preference’ for social housing under one or more specific category by the local authority. This is also known as ‘priority need’.,,,,,,Where available vacant properties are advertised and applicants are able to bid for specific properties.,Where a common system agreed between a group of housing providers is used to determine applicants' priority for housing.,Where a single waiting list is used by a group of housing providers to receive and process housing applications. Providers may use different approaches to determine priority.,Where the 'access category' or another descriptor of whether an available vacant property meets a range of access needs is displayed to applicants during the allocations process.,,,Use code 3 for internal transfers from a housing register had LA involvement (if field 131 = 6) and code 5 for internal transfers from a housing register had no LA involvement (if field 132 = 7).,Use codes 1-10 for lettings from a housing register that had LA involvement (if field 131 = 6) and codes 11-20 for lettings from a housing register with no LA involvement (if field 132= 7).,,,"Include any income after tax from employment, pensions, and Universal Credit. Don't include National Insurance (NI) contributions and tax, housing benefit, child benefit, or council tax support.","This is about when the tenant is in their new let. If they are unsure about the situation for their new let and their financial and working situation hasn’t changed significantly, answer based on what housing-related benefits they currently receive.",,"If rent is charged on the property then answer Yes, even if tenants do not pay it themselves.","Only options relevant to your organisation will be accepted. To change these, go to the 'About your organisation' page or contact the CORE helpdesk.","This is the amount paid before any charges are added for services (for example, hot water or cleaning). Households may receive housing benefit or Universal Credit towards basic rent.","For example, cleaning. Households may get household benefits towards the service charge.",For example heating or hot water. This doesn’t include housing benefit or Universal Credit.,Any charges made to fund support services included in the tenancy agreement.,Also known as the 'outstanding amount',You only need to give an approximate figure.
Values,Alphanumeric,,Email format,1 - 2,Alphanumeric,Numeric,1 - 2,1 - 31,1 - 12,26 - 27,1 - 7,Text,"Alphanumeric, max 13 characters","Alphanumeric, max 12 characters",1,"5 - 6, or 8 - 22",1 - 3 or 5 - 9,Numeric,Alphanumeric,,Text,,"Alphanumeric,
2 - 4 characters","Alphanumeric,
3 characters","9 character ONS code, beginning with 'E' (https://www.get-information-schools.service.gov.uk/Guidance/LaNameCodes) ","1 - 2, 4 or 6 - 10",01-Feb,01-Feb,01-Jul,Jan-31,01-Dec,Jun-26,Jan-31,01-Dec,Jun-26,"2 - 4, 7 - 8",01-Mar,01-Feb,02-Aug,Text,"1 - 99, see specification for more detail",16 - 120 or R,"F, M, X or R",Jan-20,"3 digit ISO country code, see specification",0 - 10,01-Mar,"Numeric, range 1 - 120 or text (upper case 'R')
3 characters","9 character ONS code, beginning with 'E' (https://www.get-information-schools.service.gov.uk/Guidance/LaNameCodes) ","1 - 2, 4 or 6 - 10",1 - 2,1 - 7,1 - 31,1 - 12,07 - 27,1 - 31,1 - 12,07 - 27,"2 - 4, 7 - 8",1 - 3,1 - 2,2 - 8,Text,"1 - 99, see specification for more detail",16 - 120 or R,"F, M or R",1 - 3,Text,Text,"3 digit ISO country code, see specification",0 - 10,"Numeric, range 1 - 120 or text (upper case 'R')
Must be >= 16 if working situation = 1 - 8 or 0
Must be <16 if working situation = 9","F, M, X or R","0 - 10
Must be <16 if working situation = 9",1 - 3,"F, M or R",1 - 3,Text,"0 - 10
Must be 9 if age <16",01-Mar,"Numeric, range 1 - 120 or text (upper case 'R')
Must be 9 if age <16","Numeric, range 1 - 120 or text (upper case 'R')
Must be >= 16 if working situation = 1 - 8 or 0
Must be <16 if working situation = 9","F, M, X or R","0 - 10
Must be <16 if working situation = 9",1 - 3,"F, M or R",1 - 3,Text,"0 - 10
Must be 9 if age <16",01-Mar,"Numeric, range 1 - 120 or text (upper case 'R')
Must be 9 if age <16","Numeric, range 1 - 120 or text (upper case 'R')
Must be >= 16 if working situation = 1 - 8 or 0
Must be <16 if working situation = 9","F, M, X or R","0 - 10
Must be <16 if working situation = 9",1 - 3,"F, M or R",1 - 3,Text,"0 - 10
Must be 9 if age <16",01-Mar,"Numeric, range 1 - 120 or text (upper case 'R')
Must be 9 if age <16","Numeric, range 1 - 120 or text (upper case 'R')
Must be >= 16 if working situation = 1 - 8 or 0
Must be <16 if working situation = 9","F, M, X or R","0 - 10
Must be <16 if working situation = 9",1 - 3,"F, M or R",1 - 3,Text,"0 - 10
Must be 9 if age <16",01-Mar,"Numeric, range 1 - 120 or text (upper case 'R')
Must be 9 if age <16","Numeric, range 1 - 120 or text (upper case 'R')
Must be >= 16 if working situation = 1 - 8 or 0
Must be <16 if working situation = 9","F, M, X or R","0 - 10
Must be <16 if working situation = 9",1 - 3,"F, M or R",1 - 3,Text,"0 - 10
Must be 9 if age <16",01-Mar,"Numeric, range 1 - 120 or text (upper case 'R')
Must be 9 if age <16","Numeric, range 1 - 120 or text (upper case 'R')
Must be >= 16 if working situation = 1 - 8 or 0
Must be <16 if working situation = 9","F, M, X or R","0 - 10
Must be <16 if working situation = 9",1 - 3,"F, M or R",1 - 3,Text,"0 - 10
Must be 9 if age <16",01-Mar,"Numeric, range 1 - 120 or text (upper case 'R')
Must be 9 if age <16","Numeric, range 1 - 120 or text (upper case 'R')
Must be >= 16 if working situation = 1 - 8 or 0
Must be <16 if working situation = 9","F, M, X or R","0 - 10
Must be 9 if age <16",01-Jun,03-Jun,01-Mar,,1 or empty,,,,,,01-Mar,1 or empty,,,,,,,,,,1 - 2 or 6 - 12,2 or 6 - 13,"1 - 2, 4, 8 - 14, 16 - 20, 28 - 31, 34 or 44 - 55",Text,"3 - 4, 6 - 7, 9 - 10, 13 - 14, 18 - 19, 21, 23 - 33, 35, 37 - 39 ",1 or 11,01-Feb,"Alphanumeric, 2 - 4 characters","Alphanumeric,
3 characters","9 character ONS code, beginning with 'E' (https://www.get-information-schools.service.gov.uk/Guidance/LaNameCodes) ",01-Mar,1 or empty,,,,,01-Feb,,,,,01-Mar,01-Mar,0 - 99999,"1, 3, 6, 9 or 10",01-Apr,0 - 1,01-Oct,xxxx.xx,,,,01-Mar,xxxx.xx,"F, M or R","F, M or R","F, M or R","F, M or R","F, M or R","F, M or R","F, M or R","F, M or R",1 - 3,Text,1 - 3,Text,1 - 3,Text,1 - 3,Text,1 - 3,Text,1 - 3,Text,1 - 3,Text,1 - 3,Text,,,
Can be empty?,No,,Yes,No,"Yes, if letting is general needs (if field 4 = 1)","Yes, if letting is general needs (if field 4 = 1)",No,,,,,"Yes, if letting is not 'Other intermediate rent product' (if field 11 is not 6)",Yes,,No,"Yes, if letting is a renewal (if field 7 = 1)","Yes, if letting is a renewal (if field 7 = 1) or a first-time let (if field 16 = 15 - 17)","Yes, if letting is supported housing (if field 4 = 2) or if the property's postcode is not empty (if fields 23 and 24 contain full and valid entries)","Yes, if letting is supported housing (if field 4 = 2) or if property's UPRN and local authority are known (if fields 18 and 25 are not empty)",Yes,"Yes, if letting is supported housing (if field 4 = 2) or if property's UPRN and local authority are known (if fields 18 and 25 are not empty)",Yes,"Yes, if letting is supported housing (if field 4 = 2) or if property's UPRN and local authority are known (if fields 18 and 25 are not empty)",,"Yes, if letting is supported housing (if field 4 = 2)",,,,,"Yes, if letting is a renewal (if field 7 = 1)",,,Yes,,,"Yes, if letting is general needs (if field 4 = 1)",No,,,"Yes, if 'Other' is not selected for tenancy type (if field 39 is not 3)","Yes, if letting is not a fixed-term tenancy (if field 39 is not 4 or 6)",No,,,,,"Yes, if all fields about person 2 are empty (fields 47 - 50)",,,,"Yes, if all fields about person 3 are empty (fields 51 - 54)",,,,"Yes, if all fields about person 4 are empty (fields 55 - 58)",,,,"Yes, if all fields about person 5 are empty (fields 59 - 62)",,,,"Yes, if all fields about person 6 are empty (fields 63 - 66)",,,,"Yes, if all fields about person 7 are empty (fields 67 - 70)",,,,"Yes, if all fields about person 8 are empty (fields 71 - 74)",,,,No,"Yes, if no one in the household is a current or former regular (if field 75 is not 1)","Yes, if no one in the household is a current or former regular or reserve (if field 75 is not 1 or 4)",No,"Yes, if no household members have access needs or if it is unknown (if field 83 or 84 = 1)",,,,"Yes, if a household member has an access need (if at least one of fields 79 to 82 = 1)",,No,"Yes, if a household member has an access need (if at least one of fields 79 to 82 = 1)
If someone in the household does have such a condition (if field 89 = 1), then at least 1 of these fields must be 1.",,,,,,,,,,No,"Yes, if letting is a renewal (if field 7 = 1)",No,"Yes, if 'Other' is not selected for reason for leaving last settled home (if field 98 is not 20)",No,No,,"Yes, if postcode of household's last settled home is not known (if 102 = 2)",,Yes,No,"If household was given 'reasonable preference' (if field 107 = 1), at least one of these fields must be 1
If household was not given 'reasonable preference' (if field 106 = 2 or 3), these fields will be ignored.",,,,,No,,,,,No,"Yes, if household's income is unknown (if field 117 = 2 or 3)",,No,,"Yes, if letting is supported housing (if field 4 = 2)",No,"Yes, if the household does not pay rent (if field 122 = 1)",,,,"Yes, if the household doesn't receive housing benefits, or if it is unknown (if field 120 = 3, 9 or 10)","Yes, if the household does not need to pay rent or charges after receiving housing benefits (if field 128 is not 1)",,,,,,,,,,,,,,,,,,,,,,,,,,,
Type of letting the question applies to,,,,,Supported housing only,,,,,,,Other Intermediate Rent only,,,,,,General needs only,,,,,,,,,,,,,,,,,,Supported housing only,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,Supported housing only,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
Duplicate check field?,Yes,,,,Yes,,,Yes,,,,,Yes,,,,,,,,,,Yes,,,,,,,,,,,,,,,,,,,Yes,,,,Yes,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
Field number,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156
,ORG1,ORG1,support@example.com,1,,,2,1,4,26,1,,1,1,1,5,1,,a,a,a,a,a1,1aa,E09000001,1,1,1,1,1,4,25,,,,,3,1,2,,,20,F,1,GBR,1,,,,,,,,,,,,,,,,,,,,,,,,,,,,,1,6,3,1,1,,,,,,1,1,,,,,,,,,,1,2,50,,30,1,2,,,,1,1,,,,,1,1,1,1,1,2,,,1,2,1,1,50,0,0,0,3,,F,,,,,,,,1,,,,,,,,,,,,,,,,,,
Must be <16 if working situation = 9",1 - 3,"F, M or R",1 - 3,Text,"0 - 10
Must be 9 if age <16",1 - 6,3 - 6,1 - 3,,1 or empty,,,,,,1 - 3,1 or empty,,,,,,,,,,1 - 2 or 6 - 12,2 or 6 - 13,"1 - 2, 4, 8 - 14, 16 - 20, 28 - 31, 34 or 44 - 57",Text,"3 - 4, 6 - 7, 9 - 10, 13 - 14, 18 - 19, 21, 23 - 33, 35, 37 - 40",1 or 11,1 - 2,"Alphanumeric, 2 - 4 characters","Alphanumeric,
3 characters","9 character ONS code, beginning with 'E' (https://www.get-information-schools.service.gov.uk/Guidance/LaNameCodes) ",1 - 3,1 or empty,,,,,1 - 2,,,,1 - 4,5 - 9,1 - 8,1 - 20,1 - 3,1 - 3,0 - 99999,"1, 3, 6, 9 or 10",1 - 4,0 - 1,1 - 10,xxxx.xx,,,,1 - 3,xxxx.xx
Can be empty?,No,,Yes,No,"Yes, if letting is general needs (if field 4 = 1)","Yes, if letting is general needs (if field 4 = 1)",No,,,,,"Yes, if letting is not 'Other intermediate rent product' (if field 11 is not 6)",Yes,,No,"Yes, if letting is a renewal (if field 7 = 1)","Yes, if letting is a renewal (if field 7 = 1) or a first-time let (if field 16 = 15 - 17)","Yes, if the property's postcode is not empty (if fields 23 and 24 contain full and valid entries)","Yes, if property's UPRN and local authority are known (if fields 18 and 25 are not empty)",Yes,"Yes, if property's UPRN and local authority are known (if fields 18 and 25 are not empty)",Yes,"Yes, if property's UPRN and local authority are known (if fields 18 and 25 are not empty)",No,"Yes, if letting is supported housing (if field 4 = 2)",,,,"Yes, if letting is a renewal (if field 7 = 1)",,,Yes,,,"Yes, if letting is general needs (if field 4 = 1)",No,,,"Yes, if 'Other' is not selected for tenancy type (if field 38 is not 3)","Yes, if letting is not a fixed-term tenancy (if field 38 is not 4 or 6)",No,,,"Yes, if 'No' is not selected for gender same as sex (if field 43 is not 2)",No,,,"Yes, if all fields about person 2 are empty (fields 48 - 53)","Yes, if person 2 is aged under 16 (if field 46 < 16) or if all fields about person 2 are empty (fields 48 - 53)","Yes, if all fields about person 2 are empty (fields 48 - 53)",,"Yes, if 'No' is not selected for gender same as sex (if field 51 is not 2) or if all fields about person 2 are empty (fields 48 - 53)","Yes, if all fields about person 2 are empty (fields 48 - 53)","Yes, if all fields about person 3 are empty (fields 54 - 59)","Yes, if person 3 is aged under 16 (if field 54 < 16) or if all fields about person 2 are empty (fields 54 - 59)","Yes, if all fields about person 3 are empty (fields 54 - 59)",,"Yes, if 'No' is not selected for gender same as sex (if field 57 is not 2) or if all fields about person 3 are empty (fields 54 - 59)","Yes, if all fields about person 3 are empty (fields 54 - 59)","Yes, if all fields about person 4 are empty (fields 60 - 65)","Yes, if person 4 is aged under 16 (if field 60 < 16) or if all fields about person 2 are empty (fields 54 - 59)","Yes, if all fields about person 4 are empty (fields 60 - 65)",,"Yes, if 'No' is not selected for gender same as sex (if field 63 is not 2) or if all fields about person 4 are empty (fields 60 - 65)","Yes, if all fields about person 4 are empty (fields 60 - 65)","Yes, if all fields about person 5 are empty (fields 59 - 62)","Yes, if person 5 is aged under 16 (if field 66 < 16) or if all fields about person 5 are empty (fields 66 - 71)","Yes, if all fields about person 5 are empty (fields 59 - 62)",,"Yes, if 'No' is not selected for gender same as sex (if field 69 is not 2) or if all fields about person 5 are empty (fields 66 - 71)","Yes, if all fields about person 5 are empty (fields 59 - 62)","Yes, if all fields about person 6 are empty (fields 63 - 66)","Yes, if person 6 is aged under 16 (if field 72 < 16) or if all fields about person 6 are empty (fields 72 - 77)","Yes, if all fields about person 6 are empty (fields 63 - 66)",,"Yes, if 'No' is not selected for gender same as sex (if field 75 is not 2) or if all fields about person 6 are empty (fields 72 - 77)","Yes, if all fields about person 6 are empty (fields 63 - 66)","Yes, if all fields about person 7 are empty (fields 67 - 70)","Yes, if person 7 is aged under 16 (if field 78 < 16) or if all fields about person 7 are empty (fields 78 - 83)","Yes, if all fields about person 7 are empty (fields 67 - 70)",,"Yes, if 'No' is not selected for gender same as sex (if field 81 is not 2) or if all fields about person 7 are empty (fields 78 - 83)","Yes, if all fields about person 7 are empty (fields 67 - 70)","Yes, if all fields about person 8 are empty (fields 71 - 74)","Yes, if person 8 is aged under 16 (if field 84 < 16) or if all fields about person 8 are empty (fields 84 - 89)","Yes, if all fields about person 8 are empty (fields 71 - 74)",,"Yes, if 'No' is not selected for gender same as sex (if field 87 is not 2) or if all fields about person 8 are empty (fields 84 - 89)","Yes, if all fields about person 8 are empty (fields 71 - 74)",No,"Yes, if no one in the household is a current or former regular (if field 90 is not 1)","Yes, if no one in the household is a current or former regular or reserve (if field 90 is not 1 or 4)",No,"Yes, if no household members have access needs or if it is unknown (if field 98 or 99 = 1)",,,,"Yes, if a household member has an access need (if at least one of fields 94 to 97 = 1)",,No,"Yes, if no one in the household has a physical or mental health condition (if field 100 is 2 or 3).
If someone in the household does have such a condition (if field 100 = 1), then at least 1 of these fields must be 1.",,,,,,,,,,No,"Yes, if letting is a renewal (if field 7 = 1)",No,"Yes, if 'Other' is not selected for reason for leaving last settled home (if field 113 is not 20)",No,No,,"Yes, if postcode of household's last settled home is not known (if 117 = 2)",,Yes,No,"Yes, if household was not given 'reasonable preference' (if field 121 = 2 or 3)
",,,,,No,,,,"Yes, if the stock owner (field 1) is a PRP, or if the letting is a renewal (if field 7 = 1)","Yes, if the stock owner (field 1) is a local authority, or if the letting is a renewal (if field 7 = 1)","Yes, if the stock owner (field 1) is a local authority, or if the letting is a renewal (if field 7 = 1), or if field 132 is 5 or 8-9","Yes, if the stock owner (field 1) is a local authority, or if the letting is a renewal (if field 7 = 1), or if field 133 is 2-6 or 8",No,"Yes, if household's income is unknown (if field 135 = 2 or 3)",,No,,"Yes, if letting is supported housing (if field 4 = 2)",No,"Yes, if the household does not pay rent (if field 140 = 1)",,,,"Yes, if the household doesn't receive housing benefits, or if it is unknown (if field 139 = 3, 9 or 10)","Yes, if the household does not need to pay rent or charges after receiving housing benefits (if field 146 is not 1)"
Type of letting the question applies to,,,,,Supported housing only,,,,,,,Other Intermediate Rent only,,,,,,,,,,,,,,General needs only,,,,,,,,,Supported housing only,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,Local authority owned properties,PRP owned properties,,,,,,,,Supported housing only,,,,,,,
Duplicate check field?,Yes,,,,,,,Yes,,,,,Yes,,,,,"Yes, if UPRN provided instead of address","Yes, if address provided instead of UPRN",,,,"Yes, if address provided instead of UPRN",,,,,,,,,,,,,,,,,,Yes,,,,,,Yes,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,Yes,,,,,,
Field number,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147
,ORG1,ORG1,support@example.com,1,,,2,1,4,26,1,,1,1,1,5,1,,a,a,a,a,a1,1aa,E09000001,1,1,1,1,4,25,,,,,3,1,2,,,20,F,1,,1,GBR,1,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,1,6,3,1,1,,,,,,1,1,,,,,,,,,,1,2,50,,30,1,2,,,,1,1,,,,,1,1,1,1,1,,,,2,,,1,2,1,1,100,0,0,0,3,

1 Section Setting up this lettings log Property information Tenancy information Household characteristics Household needs Household situation Income, benefits and outgoings
2 Question Which organisation owns this property? Which organisation manages this letting? What is the CORE username of the account this letting log should be assigned to? What is the needs type? What scheme does this letting belong to? Which location is this letting for? Is this letting a renewal of social housing to the same tenant in the same property? What is the tenancy start date? - day DD What is the tenancy start date? - month MM What is the tenancy start date? - year YY What is the rent type? Which 'Other' type of Intermediate Rent is this letting? What is the tenant code? What is the property reference? Has the tenant seen or been given access to the MHCLG privacy notice? What is the reason for the property being vacant? What type was the property most recently let as? If known, provide this property’s UPRN Address Line 1 Address Line 2 Town or city County Part 1 of the property's postcode Part 2 of the property's postcode What is the property's local authority? What type of unit is the property? Which type of building is the property? Is the property built or adapted to wheelchair-user standards? Is the property built or adapted to wheelchair-user standards? How many bedrooms does the property have? How many bedrooms does the property have? What is the void date? - day DD What is the void date? - day DD What is the void date? - month MM What is the void date? - month MM What is the void date? - year YY What is the void date? - year YY What date were any major repairs completed on? - day DD What date were any major repairs completed on? - day DD What date were any major repairs completed on? - month MM What date were any major repairs completed on? - month MM What date were any major repairs completed on? - year YY What date were any major repairs completed on? - year YY Is this property older people's housing? Is this a joint tenancy? Is this property older people's housing? Is this a starter tenancy? Is this a starter tenancy? What is the type of tenancy? What is the type of tenancy? If 'Other', what is the type of tenancy? If 'Other', what is the type of tenancy? What is the length of the fixed-term tenancy to the nearest year? What is the lead tenant’s age? What is the length of the fixed-term tenancy to the nearest year? What is the lead tenant's sex? Which of these best describes the lead tenant’s gender identity? Is the gender the lead tenant identifies with the same as their sex registered at birth? Which of these best describes the lead tenant's ethnic background? If 'No', enter lead tenant's gender identity What is the lead tenant’s nationality? Which of these best describes the lead tenant's ethnic background? Which of these best describes the lead tenant’s working situation? What is the lead tenant’s nationality? Is person 2 the partner of the lead tenant? Which of these best describes the lead tenant’s working situation? What is person 2's age? Which of these best describes person 2's gender identity? Is person 2 the partner of the lead tenant? Which of these best describes person 2's working situation? What is person 2's sex? Is person 3 the partner of the lead tenant? Is the gender the person 2 identifies with the same as their sex registered at birth? What is person 3's age? If 'No', enter person 2's gender identity Which of these best describes person 3's gender identity? Which of these best describes person 2's working situation? Which of these best describes person 3's working situation? What is person 3's age? Is person 4 the partner of the lead tenant? Is person 3 the partner of the lead tenant? What is person 4's age? What is person 3's sex? Which of these best describes person 4's gender identity? Is the gender the person 3 identifies with the same as their sex registered at birth? Which of these best describes person 4's working situation? If 'No', enter person 3's gender identity Is person 5 the partner of the lead tenant? Which of these best describes person 3's working situation? What is person 5's age? What is person 4's age? Which of these best describes person 5's gender identity? Is person 4 the partner of the lead tenant? Which of these best describes person 5's working situation? What is person 4's sex? Is person 6 the partner of the lead tenant? Is the gender the person 4 identifies with the same as their sex registered at birth? What is person 6's age? If 'No', enter person 4's gender identity Which of these best describes person 6's gender identity? Which of these best describes person 4's working situation? Which of these best describes person 6's working situation? What is person 5's age? Is person 7 the partner of the lead tenant? Is person 5 the partner of the lead tenant? What is person 7's age? What is person 5's sex? Which of these best describes person 7's gender identity? Is the gender the person 5 identifies with the same as their sex registered at birth? Which of these best describes person 7's working situation? If 'No', enter person 5's gender identity Is person 8 the partner of the lead tenant? Which of these best describes person 5's working situation? What is person 8's age? What is person 6's age? Which of these best describes person 8's gender identity? Is person 6 the partner of the lead tenant? Which of these best describes person 8's working situation? What is person 6's sex? Is this person still serving in the UK armed forces? Is the gender the person 6 identifies with the same as their sex registered at birth? Was this person seriously injured or ill as a result of serving in the UK armed forces? If 'No', enter person 6's gender identity Is anybody in the household pregnant? Which of these best describes person 6's working situation? Disabled access needs a) Fully wheelchair-accessible housing What is person 7's age? Disabled access needs b) Wheelchair access to essential rooms Is person 7 the partner of the lead tenant? Disabled access needs c) Level access housing What is person 7's sex? Disabled access needs f) Other disabled access needs Is the gender the person 7 identifies with the same as their sex registered at birth? Disabled access needs g) No disabled access needs If 'No', enter person 7's gender identity Disabled access needs h) Don’t know Which of these best describes person 7's working situation? Does anybody in the household have a physical or mental health condition (or other illness) expected to last 12 months or more? What is person 8's age? Does this person's condition affect their dexterity? Is person 8 the partner of the lead tenant? Does this person's condition affect their learning or understanding or concentrating? What is person 8's sex? Does this person's condition affect their hearing? Is the gender the person 8 identifies with the same as their sex registered at birth? Does this person's condition affect their memory? If 'No', enter person 8's gender identity Does this person's condition affect their mental health? Which of these best describes person 8's working situation? Does anybody in the household have links to the UK armed forces? Does this person's condition affect their mobility? Is this person still serving in the UK armed forces? Does this person's condition affect them socially or behaviourally? Was this person seriously injured or ill as a result of serving in the UK armed forces? Does this person's condition affect their stamina or breathing or fatigue? Is anybody in the household pregnant? Does this person's condition affect their vision? Disabled access needs a) Fully wheelchair-accessible housing Does this person's condition affect them in another way? Disabled access needs b) Wheelchair access to essential rooms How long has the household been on the local authority housing register (or waiting list) for the area of the new letting? Disabled access needs c) Level access housing What is the tenant’s main reason for the household leaving their last settled home? Disabled access needs f) Other disabled access needs If 'Other', what was the main reason for leaving their last settled home? Disabled access needs g) No disabled access needs Where was the household immediately before this letting? Disabled access needs h) Don’t know Did the household experience homelessness immediately before this letting? Does anybody in the household have a physical or mental health condition (or other illness) expected to last 12 months or more? Do you know the postcode of the household's last settled home? Does this person's condition affect their dexterity? Part 1 of postcode of last settled home Does this person's condition affect their learning or understanding or concentrating? Part 2 of postcode of last settled home Does this person's condition affect their hearing? What is the local authority of the household's last settled home? Does this person's condition affect their memory? Was the household given 'reasonable preference' by the local authority? Does this person's condition affect their mental health? Reasonable preference reason They were homeless or about to lose their home (within 56 days) Does this person's condition affect their mobility? Reasonable preference reason They were living in unsanitary, overcrowded or unsatisfactory housing Does this person's condition affect them socially or behaviourally? Reasonable preference reason They needed to move due to medical and welfare reasons (including disability) Does this person's condition affect their stamina or breathing or fatigue? Reasonable preference reason They needed to move to avoid hardship to themselves or others Does this person's condition affect their vision? Reasonable preference reason Don't know Does this person's condition affect them in another way? How long has the household continuously lived in the local authority area of the new letting? How was this letting allocated? Choice based Lettings (CBL) How long has the household been on the local authority housing register (or waiting list) for the area of the new letting? How was this letting allocated? Common Allocations Policy (CAP) What is the tenant’s main reason for the household leaving their last settled home? How was this letting allocated? Common Housing Register (CHR) If 'Other', what was the main reason for leaving their last settled home? How was this letting allocated? Accessible Housing Register Where was the household immediately before this letting? What was the source of referral for this letting? - LA properties Did the household experience homelessness immediately before this letting? How often does the household receive income? Do you know the postcode of the household's last settled home? How much income does the household have in total? Part 1 of postcode of last settled home Is the tenant likely to be receiving any of these housing-related benefits? Part 2 of postcode of last settled home How much of the household's income is from Universal Credit, state pensions or benefits? What is the local authority of the household's last settled home? Does the household pay rent or other charges for the accommodation? Was the household given 'reasonable preference' by the local authority? How often does the household pay rent and other charges? Reasonable preference reason They were homeless or about to lose their home (within 56 days) What is the basic rent? Reasonable preference reason They were living in unsanitary, overcrowded or unsatisfactory housing What is the service charge? Reasonable preference reason They needed to move due to medical and welfare reasons (including disability) What is the personal service charge? Reasonable preference reason They needed to move to avoid hardship to themselves or others What is the support charge? Reasonable preference reason Don't know After the household has received any housing-related benefits, will they still need to pay for rent and charges? How was this letting allocated? Choice based Lettings (CBL) What do you expect the outstanding amount to be? How was this letting allocated? Common Allocations Policy (CAP) What was the lead tenant's sex at birth? How was this letting allocated? Common Housing Register (CHR) What was person 2's sex registered at birth? How was this letting allocated? Accessible Housing Register What was person 3's sex registered at birth? What was the source of referral for this letting? - LA properties What was person 4's sex registered at birth? What was the source of referral for this letting? - PRP properties part 1 What was person 5's sex registered at birth? What was the source of referral for this letting? - PRP properties part 2 What was person 6's sex registered at birth? What was the source of referral for this letting? - PRP properties part 3 Do you know the household's combined total income after tax? What was person 7's sex registered at birth? How often does the household receive income? What was person 8's sex registered at birth? How much income does the household have in total? Is the gender the lead tenant identifies with the same as their sex registered at birth? Is the tenant likely to be receiving any of these housing-related benefits? If 'No', enter lead tenant's gender identity How much of the household's income is from Universal Credit, state pensions or benefits? Is the gender the person 2 identifies with the same as their sex registered at birth? Does the household pay rent or other charges for the accommodation? If 'No', enter person 2's gender identity How often does the household pay rent and other charges? Is the gender the person 3 identifies with the same as their sex registered at birth? What is the basic rent? If 'No', enter person 3's gender identity What is the service charge? Is the gender the person 4 identifies with the same as their sex registered at birth? What is the personal service charge? If 'No', enter person 4's gender identity What is the support charge? Is the gender the person 5 identifies with the same as their sex registered at birth? After the household has received any housing-related benefits, will they still need to pay for rent and charges? If 'No', enter person 5's gender identity What do you expect the outstanding amount to be? Is the gender the person 6 identifies with the same as their sex registered at birth? If 'No', enter person 6's gender identity Is the gender the person 7 identifies with the same as their sex registered at birth? If 'No', enter person 7's gender identity Is the gender the person 8 identifies with the same as their sex registered at birth? If 'No', enter person 8's gender identity What was the source of referral for this letting? - PRP properties part 1 What was the source of referral for this letting? - PRP properties part 2 What was the source of referral for this letting? - PRP properties part 3
3 Additional info You can find the org ID on the CORE service under 'Stock owners' or, if your organisation is the stock owner, under 'About your organisation' You can find the org ID on the CORE service under 'Managing agents' or, if your organisation is the managing agent, under 'About your organisation' If left empty, the letting log will be assigned to the account used to upload the log. General needs housing includes both self-contained and shared housing without support or specific adaptations. Supported housing includes direct access hostels, group homes, residential care and nursing homes. General needs housing includes both self-contained and shared housing without support or specific adaptations. Supported housing is housing with special design facilities or features targeted at a specific client group requiring support, for example housing designed for older people, sheltered accommodation, extra care housing. It can include direct access hostels, group homes, and purpose-built self-contained housing. We do not require CORE logs for residential care or nursing homes. Scheme code. Include the 'S' at the beginning if it has one. You can find the scheme code on the CORE service under 'Schemes', either by searching for the specific scheme or downloading a csv. Location code. You can find the location code on the CORE service under 'Schemes', either by searching for the specific location or downloading a csv. If the property was previously being used as temporary accommodation, then answer 'no'. See specification for definitions This is how you usually refer to this tenancy on your own systems. This is how you usually refer to this property on your own systems. Make sure the lead tenant has seen or been given access to the Ministry of Housing, Communities and Local Government (MHCLG) privacy notice before completing this log. This is a legal requirement under data protection legislation. Internal transfer - Where a tenant moved from one social housing property to another property. Their landlord may be the same or may have changed. Renewal of a fixed term tenancy - to the same tenant in the same property, except if was previously used as temporary accommodation. This is the rent type of the previous tenancy in this property. The Unique Property Reference Number (UPRN) is a unique number system created by Ordnance Survey and used by housing providers and various industries across the UK. An example UPRN is 10010457355. The UPRN may not be the same as the property reference assigned by your organisation. Combined with field 22 it should be a postcode which lies within the local authority given in field 25. Combined with field 21 it should be a postcode which lies within the local authority given in field 25. This is whether someone who uses a wheelchair is able to make full use of all of the property’s rooms and facilities, including use of both inside and outside space, and entering and exiting the property. This is whether someone who uses a wheelchair is able to make full use of all of the property’s rooms and facilities, including use of both inside and outside space, and entering and exiting the property. If shared accommodation, enter the number of bedrooms occupied by this household. A bedsit has 1 bedroom. If shared accommodation, enter the number of bedrooms occupied by this household. A bedsit has 1 bedroom. Date the property was (legally/contractually) available to let, or for: - re-lets: the day after previous tenant’s contract end - new-builds: the day the landlord legally owned the property ('completion date’) - new conversions or acquisitions: the completion date, or the day after any rehabilitation work ended - new leases: the day the landlord got contractual property rights, and could let it out to tenants. Date the property was (legally/contractually) available to let, or for: - re-lets: the day after previous tenant’s contract end - new-builds: the day the landlord legally owned the property ('completion date’) - new conversions or acquisitions: the completion date, or the day after any rehabilitation work ended - new leases: the day the landlord got contractual property rights, and could let it out to tenants. Major repairs are works which could not reasonably be carried out with a tenant in occupation, and which need to be carried out in a property while it is vacant. They involve remedial works that are necessary for the property to remain habitable and include structural repairs, site works and service installations. Major repairs are works that could not be reasonably carried out with a tenant living at the property. For example, structural repairs. This includes retirement living, sheltered housing and extra care housing. There is no national set limit for “older people”, please answer based on your own policies. Extra care housing is for tenants with medium to high care and support needs, often with 24 hour access to support staff provided by an agency registered with the Care Quality Commission. This is where two or more people are named on the tenancy agreement. This includes retirement living, sheltered housing and extra care housing. There is no national set limit for “older people”, please answer based on your own policies. Extra care housing is for tenants with medium to high care and support needs, often with 24 hour access to support staff provided by an agency registered with the Care Quality Commission. If the tenancy has an ‘introductory period’ answer ‘yes’. You should submit a CORE log at the beginning of the starter tenancy or introductory period, with the best information you have at the time. You do not need to submit a log when a tenant later rolls onto the main tenancy. If the tenancy has an ‘introductory period’ answer ‘yes’. You should submit a CORE log at the beginning of the starter tenancy or introductory period, with the best information you have at the time. You do not need to submit a log when a tenant later rolls onto the main tenancy. This is about the main tenancy after any starter or introductory period. See specification for definitions. This is about the main tenancy after any starter or introductory period. See specification for definitions. Do not include the starter or introductory period. The minimum period is 2 years for social or affordable rent general needs logs. You do not need to submit CORE logs for these types of tenancies if they are shorter than 2 years. This is the household member who does the most paid work. If several people do the same amount of paid work, it's the oldest household member. Do not include the starter or introductory period. The minimum period is 2 years for social or affordable rent general needs logs. You do not need to submit CORE logs for these types of tenancies if they are shorter than 2 years. This is their sex as registered at birth. The next question will ask about gender identity. This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth. If the lead tenant is a dual national of the United Kingdom and another country, enter United Kingdom. If they are a dual national of two other countries, the tenant should decide which country to enter. This is the household member who does the most paid work. If several people do the same amount of paid work, it's the oldest household member. If the lead tenant is a dual national of the United Kingdom and another country, enter United Kingdom. If they are a dual national of two other countries, the tenant should decide which country to enter. This is the household member who does the most paid work. If several people do the same amount of paid work, it's the oldest household member. People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer "Not seeking work". Answer 1 for children aged under 1 year old This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth. This is their sex as registered at birth. The next question will ask about gender identity. Answer 1 for children aged under 1 year old This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth. People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer "Not seeking work". Answer 1 for children aged under 1 year old Answer 1 for children aged under 1 year old This is their sex as registered at birth. The next question will ask about gender identity. This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth. People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer "Not seeking work". Answer 1 for children aged under 1 year old This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth. This is their sex as registered at birth. The next question will ask about gender identity. Answer 1 for children aged under 1 year old This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth. People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer "Not seeking work". Answer 1 for children aged under 1 year old Answer 1 for children aged under 1 year old This is their sex as registered at birth. The next question will ask about gender identity. This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth. People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer "Not seeking work". Answer 1 for children aged under 1 year old This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth. This is their sex as registered at birth. The next question will ask about gender identity. People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer "Not seeking work". Answer 1 for children aged under 1 year old This is their sex as registered at birth. The next question will ask about gender identity. People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer "Not seeking work". Answer 1 for children aged under 1 year old For example, lifting and carrying objects, or using a keyboard This is their sex as registered at birth. The next question will ask about gender identity. For example, deafness or partial hearing For example, depression or anxiety People providing informal care for family and friends who are not in formal employment (but may receive carer's allowance) should answer "Not seeking work". This excludes national service. If several household members have these links, answer for regular first. If no regular, answer for reserve. If no reserve, answer for spouses or civil partners. For example, walking short distances or climbing stairs For example, anything associated with autism spectrum disorder (ASD), including Asperger’s or attention deficit hyperactivity disorder (ADHD) For example, blindness or partial sight The tenant's ‘last settled home' is their last long-standing home. For tenants who had temporary accommodation, sleeping rough or otherwise homeless, their last settled home is where they were living previously. This is the tenant’s last long-standing home. It is where the tenant was living before any period in temporary accommodation, sleeping rough or otherwise homeless. For example, lifting and carrying objects, or using a keyboard Combined with field 104, it should be a postcode which lies within the local authority given in field 105. Combined with field 103, it should be a postcode which lies within the local authority given in field 105. For example, deafness or partial hearing This is the tenant’s last long-standing home. It is where the tenant was living before any period in temporary accommodation, sleeping rough or otherwise homeless. Households may be given ‘reasonable preference’ for social housing under one or more specific category by the local authority. This is also known as ‘priority need’. For example, depression or anxiety For example, walking short distances or climbing stairs For example, anything associated with autism spectrum disorder (ASD), including Asperger’s or attention deficit hyperactivity disorder (ADHD) For example, blindness or partial sight Where available vacant properties are advertised and applicants are able to bid for specific properties. Where a common system agreed between a group of housing providers is used to determine applicants' priority for housing. The tenant's ‘last settled home' is their last long-standing home. For tenants who had temporary accommodation, sleeping rough or otherwise homeless, their last settled home is where they were living immediately before that period. Where a single waiting list is used by a group of housing providers to receive and process housing applications. Providers may use different approaches to determine priority. Where the 'access category' or another descriptor of whether an available vacant property meets a range of access needs is displayed to applicants during the allocations process. This is where the household was the night before they moved into this new let. This is the tenant’s last long-standing home. It is where the tenant was living before any period in temporary accommodation, sleeping rough or otherwise homeless. Include any income after tax from employment, pensions, and Universal Credit. Don't include National Insurance (NI) contributions and tax, housing benefit, child benefit, or council tax support. Combined with field 119, it should be a postcode which lies within the local authority given in field 120. This is about when the tenant is in their new let. If they are unsure about the situation for their new let and their financial and working situation hasn’t changed significantly, answer based on what housing-related benefits they currently receive. Combined with field 118, it should be a postcode which lies within the local authority given in field 120. This is the tenant’s last long-standing home. It is where the tenant was living before any period in temporary accommodation, sleeping rough or otherwise homeless. If rent is charged on the property then answer Yes, even if tenants do not pay it themselves. Households may be given ‘reasonable preference’ for social housing under one or more specific category by the local authority. This is also known as ‘priority need’. This is the amount paid before any charges are added for services (for example, hot water or cleaning). Households may receive housing benefit or Universal Credit towards basic rent. For example, cleaning. Households may get household benefits towards the service charge. For example heating or hot water. This doesn’t include housing benefit or Universal Credit. Any charges made to fund support services included in the tenancy agreement. Also known as the 'outstanding amount' Where available vacant properties are advertised and applicants are able to bid for specific properties. You only need to give an approximate figure. Where a common system agreed between a group of housing providers is used to determine applicants' priority for housing. This is the sex that was registered at birth. Where a single waiting list is used by a group of housing providers to receive and process housing applications. Providers may use different approaches to determine priority. This is the sex that was registered at birth. Where the 'access category' or another descriptor of whether an available vacant property meets a range of access needs is displayed to applicants during the allocations process. This is the sex that was registered at birth. This is the sex that was registered at birth. This is the sex that was registered at birth. Use code 3 for internal transfers from a housing register had LA involvement (if field 131 = 6) and code 5 for internal transfers from a housing register had no LA involvement (if field 132 = 7). This is the sex that was registered at birth. Use codes 1-10 for lettings from a housing register that had LA involvement (if field 131 = 6) and codes 11-20 for lettings from a housing register with no LA involvement (if field 132= 7). This is the sex that was registered at birth. This is the sex that was registered at birth. Include any income after tax from employment, pensions, and Universal Credit. Don't include National Insurance (NI) contributions and tax, housing benefit, child benefit, or council tax support. This is about when the tenant is in their new let. If they are unsure about the situation for their new let and their financial and working situation hasn’t changed significantly, answer based on what housing-related benefits they currently receive. If rent is charged on the property then answer Yes, even if tenants do not pay it themselves. Only options relevant to your organisation will be accepted. To change these, go to the 'About your organisation' page or contact the CORE helpdesk. This is the amount paid before any charges are added for services (for example, hot water or cleaning). Households may receive housing benefit or Universal Credit towards basic rent. For example, cleaning. Households may get household benefits towards the service charge. For example heating or hot water. This doesn’t include housing benefit or Universal Credit. Any charges made to fund support services included in the tenancy agreement. Also known as the 'outstanding amount' You only need to give an approximate figure.
4 Values Alphanumeric Email format 01-Feb 1 - 2 Alphanumeric Numeric 01-Feb 1 - 2 Jan-31 1 - 31 01-Dec 1 - 12 25 - 26 26 - 27 01-Jul 1 - 7 Text Alphanumeric, max 13 characters Alphanumeric, max 12 characters 1 5 - 6, or 8 - 22 1 - 3 or 5 - 9 Numeric Alphanumeric Text Alphanumeric, 2 - 4 characters Alphanumeric, 3 characters 9 character ONS code, beginning with 'E' (https://www.get-information-schools.service.gov.uk/Guidance/LaNameCodes) 1 - 2, 4 or 6 - 10 01-Feb 1 - 2 01-Feb 1 - 7 01-Jul 1 - 31 Jan-31 1 - 12 01-Dec 07 - 27 Jun-26 1 - 31 Jan-31 1 - 12 01-Dec 07 - 27 Jun-26 2 - 4, 7 - 8 01-Mar 1 - 3 2 - 4, 7 - 8 1 - 2 01-Feb 2 - 8 02-Aug Text Text 1 - 99, see specification for more detail 16 - 120 or R 1 - 99, see specification for more detail F, M or R F, M, X or R 1 - 3 Jan-20 Text 3 digit ISO country code, see specification Text 0 - 10 3 digit ISO country code, see specification 01-Mar 0 - 10 Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9 F, M, X or R 1 - 3 0 - 10 Must be 9 if age <16 F, M or R 01-Mar 1 - 3 Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9 Text F, M, X or R 0 - 10 Must be 9 if age <16 0 - 10 Must be 9 if age <16 Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9 01-Mar 1 - 3 Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9 F, M or R F, M, X or R 1 - 3 0 - 10 Must be 9 if age <16 Text 01-Mar 0 - 10 Must be 9 if age <16 Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9 F, M, X or R 1 - 3 0 - 10 Must be 9 if age <16 F, M or R 01-Mar 1 - 3 Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9 Text F, M, X or R 0 - 10 Must be 9 if age <16 0 - 10 Must be 9 if age <16 Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9 01-Mar 1 - 3 Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9 F, M or R F, M, X or R 1 - 3 0 - 10 Must be 9 if age <16 Text 01-Mar 0 - 10 Must be 9 if age <16 Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9 F, M, X or R 1 - 3 0 - 10 Must be 9 if age <16 F, M or R 03-Jun 1 - 3 01-Mar Text 0 - 10 Must be 9 if age <16 1 or empty Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9 1 - 3 F, M or R 1 - 3 Text 0 - 10 Must be 9 if age <16 01-Mar Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9 1 or empty 1 - 3 F, M or R 1 - 3 Text 0 - 10 Must be 9 if age <16 01-Jun 1 - 6 3 - 6 1 - 3 1 or empty 2 or 6 - 13 1 - 2, 4, 8 - 14, 16 - 20, 28 - 31, 34 or 44 - 55 Text 3 - 4, 6 - 7, 9 - 10, 13 - 14, 18 - 19, 21, 23 - 33, 35, 37 - 39 1 or 11 1 - 3 01-Feb 1 or empty Alphanumeric, 2 - 4 characters Alphanumeric, 3 characters 9 character ONS code, beginning with 'E' (https://www.get-information-schools.service.gov.uk/Guidance/LaNameCodes) 01-Mar 1 or empty 1 - 2 or 6 - 12 01-Feb 2 or 6 - 13 1 - 2, 4, 8 - 14, 16 - 20, 28 - 31, 34 or 44 - 57 Text 3 - 4, 6 - 7, 9 - 10, 13 - 14, 18 - 19, 21, 23 - 33, 35, 37 - 40 1 or 11 01-Mar 1 - 2 0 - 99999 Alphanumeric, 2 - 4 characters 1, 3, 6, 9 or 10 Alphanumeric, 3 characters 01-Apr 9 character ONS code, beginning with 'E' (https://www.get-information-schools.service.gov.uk/Guidance/LaNameCodes) 0 - 1 1 - 3 01-Oct 1 or empty xxxx.xx 01-Mar 1 - 2 xxxx.xx F, M or R F, M or R F, M or R 1 - 4 F, M or R 5 - 9 F, M or R 1 - 8 F, M or R 1 - 20 01-Mar 1 - 3 F, M or R 1 - 3 F, M or R 0 - 99999 1 - 3 1, 3, 6, 9 or 10 Text 1 - 4 1 - 3 0 - 1 Text 1 - 10 1 - 3 xxxx.xx Text 1 - 3 Text 1 - 3 Text xxxx.xx 1 - 3 Text 1 - 3 Text 1 - 3 Text
5 Can be empty? No Yes No Yes, if letting is general needs (if field 4 = 1) Yes, if letting is general needs (if field 4 = 1) No Yes, if letting is not 'Other intermediate rent product' (if field 11 is not 6) Yes No Yes, if letting is a renewal (if field 7 = 1) Yes, if letting is a renewal (if field 7 = 1) or a first-time let (if field 16 = 15 - 17) Yes, if letting is supported housing (if field 4 = 2) or if the property's postcode is not empty (if fields 23 and 24 contain full and valid entries) Yes, if the property's postcode is not empty (if fields 23 and 24 contain full and valid entries) Yes, if letting is supported housing (if field 4 = 2) or if property's UPRN and local authority are known (if fields 18 and 25 are not empty) Yes, if property's UPRN and local authority are known (if fields 18 and 25 are not empty) Yes Yes, if letting is supported housing (if field 4 = 2) or if property's UPRN and local authority are known (if fields 18 and 25 are not empty) Yes, if property's UPRN and local authority are known (if fields 18 and 25 are not empty) Yes Yes, if letting is supported housing (if field 4 = 2) or if property's UPRN and local authority are known (if fields 18 and 25 are not empty) Yes, if property's UPRN and local authority are known (if fields 18 and 25 are not empty) No Yes, if letting is supported housing (if field 4 = 2) Yes, if letting is a renewal (if field 7 = 1) Yes, if letting is a renewal (if field 7 = 1) Yes Yes Yes, if letting is general needs (if field 4 = 1) No Yes, if letting is general needs (if field 4 = 1) Yes, if 'Other' is not selected for tenancy type (if field 38 is not 3) Yes, if 'Other' is not selected for tenancy type (if field 39 is not 3) Yes, if letting is not a fixed-term tenancy (if field 38 is not 4 or 6) No Yes, if letting is not a fixed-term tenancy (if field 39 is not 4 or 6) Yes, if 'No' is not selected for gender same as sex (if field 43 is not 2) No Yes, if all fields about person 2 are empty (fields 47 - 50) Yes, if all fields about person 2 are empty (fields 48 - 53) Yes, if person 2 is aged under 16 (if field 46 < 16) or if all fields about person 2 are empty (fields 48 - 53) Yes, if all fields about person 2 are empty (fields 48 - 53) Yes, if all fields about person 3 are empty (fields 51 - 54) Yes, if 'No' is not selected for gender same as sex (if field 51 is not 2) or if all fields about person 2 are empty (fields 48 - 53) Yes, if all fields about person 2 are empty (fields 48 - 53) Yes, if all fields about person 3 are empty (fields 54 - 59) Yes, if all fields about person 4 are empty (fields 55 - 58) Yes, if person 3 is aged under 16 (if field 54 < 16) or if all fields about person 2 are empty (fields 54 - 59) Yes, if all fields about person 3 are empty (fields 54 - 59) Yes, if 'No' is not selected for gender same as sex (if field 57 is not 2) or if all fields about person 3 are empty (fields 54 - 59) Yes, if all fields about person 5 are empty (fields 59 - 62) Yes, if all fields about person 3 are empty (fields 54 - 59) Yes, if all fields about person 4 are empty (fields 60 - 65) Yes, if person 4 is aged under 16 (if field 60 < 16) or if all fields about person 2 are empty (fields 54 - 59) Yes, if all fields about person 4 are empty (fields 60 - 65) Yes, if all fields about person 6 are empty (fields 63 - 66) Yes, if 'No' is not selected for gender same as sex (if field 63 is not 2) or if all fields about person 4 are empty (fields 60 - 65) Yes, if all fields about person 4 are empty (fields 60 - 65) Yes, if all fields about person 5 are empty (fields 59 - 62) Yes, if all fields about person 7 are empty (fields 67 - 70) Yes, if person 5 is aged under 16 (if field 66 < 16) or if all fields about person 5 are empty (fields 66 - 71) Yes, if all fields about person 5 are empty (fields 59 - 62) Yes, if 'No' is not selected for gender same as sex (if field 69 is not 2) or if all fields about person 5 are empty (fields 66 - 71) Yes, if all fields about person 8 are empty (fields 71 - 74) Yes, if all fields about person 5 are empty (fields 59 - 62) Yes, if all fields about person 6 are empty (fields 63 - 66) Yes, if person 6 is aged under 16 (if field 72 < 16) or if all fields about person 6 are empty (fields 72 - 77) Yes, if all fields about person 6 are empty (fields 63 - 66) Yes, if no one in the household is a current or former regular (if field 75 is not 1) Yes, if no one in the household is a current or former regular or reserve (if field 75 is not 1 or 4) Yes, if 'No' is not selected for gender same as sex (if field 75 is not 2) or if all fields about person 6 are empty (fields 72 - 77) No Yes, if all fields about person 6 are empty (fields 63 - 66) Yes, if no household members have access needs or if it is unknown (if field 83 or 84 = 1) Yes, if all fields about person 7 are empty (fields 67 - 70) Yes, if person 7 is aged under 16 (if field 78 < 16) or if all fields about person 7 are empty (fields 78 - 83) Yes, if all fields about person 7 are empty (fields 67 - 70) Yes, if a household member has an access need (if at least one of fields 79 to 82 = 1) Yes, if 'No' is not selected for gender same as sex (if field 81 is not 2) or if all fields about person 7 are empty (fields 78 - 83) Yes, if all fields about person 7 are empty (fields 67 - 70) No Yes, if all fields about person 8 are empty (fields 71 - 74) Yes, if a household member has an access need (if at least one of fields 79 to 82 = 1) If someone in the household does have such a condition (if field 89 = 1), then at least 1 of these fields must be 1. Yes, if person 8 is aged under 16 (if field 84 < 16) or if all fields about person 8 are empty (fields 84 - 89) Yes, if all fields about person 8 are empty (fields 71 - 74) Yes, if 'No' is not selected for gender same as sex (if field 87 is not 2) or if all fields about person 8 are empty (fields 84 - 89) Yes, if all fields about person 8 are empty (fields 71 - 74) No Yes, if no one in the household is a current or former regular (if field 90 is not 1) Yes, if no one in the household is a current or former regular or reserve (if field 90 is not 1 or 4) No Yes, if no household members have access needs or if it is unknown (if field 98 or 99 = 1) Yes, if letting is a renewal (if field 7 = 1) No Yes, if 'Other' is not selected for reason for leaving last settled home (if field 98 is not 20) Yes, if a household member has an access need (if at least one of fields 94 to 97 = 1) No No Yes, if no one in the household has a physical or mental health condition (if field 100 is 2 or 3). If someone in the household does have such a condition (if field 100 = 1), then at least 1 of these fields must be 1. Yes, if postcode of household's last settled home is not known (if 102 = 2) Yes No If household was given 'reasonable preference' (if field 107 = 1), at least one of these fields must be 1 If household was not given 'reasonable preference' (if field 106 = 2 or 3), these fields will be ignored. No No Yes, if letting is a renewal (if field 7 = 1) No Yes, if 'Other' is not selected for reason for leaving last settled home (if field 113 is not 20) No No Yes, if household's income is unknown (if field 117 = 2 or 3) Yes, if postcode of household's last settled home is not known (if 117 = 2) No Yes Yes, if letting is supported housing (if field 4 = 2) No No Yes, if household was not given 'reasonable preference' (if field 121 = 2 or 3) Yes, if the household does not pay rent (if field 122 = 1) Yes, if the household doesn't receive housing benefits, or if it is unknown (if field 120 = 3, 9 or 10) No Yes, if the household does not need to pay rent or charges after receiving housing benefits (if field 128 is not 1) Yes, if the stock owner (field 1) is a PRP, or if the letting is a renewal (if field 7 = 1) Yes, if the stock owner (field 1) is a local authority, or if the letting is a renewal (if field 7 = 1) Yes, if the stock owner (field 1) is a local authority, or if the letting is a renewal (if field 7 = 1), or if field 132 is 5 or 8-9 Yes, if the stock owner (field 1) is a local authority, or if the letting is a renewal (if field 7 = 1), or if field 133 is 2-6 or 8 No Yes, if household's income is unknown (if field 135 = 2 or 3) No Yes, if letting is supported housing (if field 4 = 2) No Yes, if the household does not pay rent (if field 140 = 1) Yes, if the household doesn't receive housing benefits, or if it is unknown (if field 139 = 3, 9 or 10) Yes, if the household does not need to pay rent or charges after receiving housing benefits (if field 146 is not 1)
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

4
spec/services/bulk_upload/lettings/validator_spec.rb
Unescape View File

@ -190,8 +190,8 @@ RSpec.describe BulkUpload::Lettings::Validator do
expect(error.tenant_code).to eql(log.tenancycode)
expect(error.property_ref).to eql(log.propcode)
expect(error.row).to eql("2")
expect(error.cell).to eql("EB2") # this may change when adding a new field as the cols are in a random order
expect(error.col).to eql("EB") # this may change when adding a new field as the cols are in a random order
expect(error.cell).to eql("EA2") # this may change when adding a new field as the cols are in a random order
expect(error.col).to eql("EA") # this may change when adding a new field as the cols are in a random order
end
end
end

8
spec/services/bulk_upload/lettings/year2026/csv_parser_spec.rb
Unescape View File

@ -244,10 +244,10 @@ RSpec.describe BulkUpload::Lettings::Year2026::CsvParser do
end
it "returns correct column" do
expect(service.column_for_field("field_5")).to eql("AA")
expect(service.column_for_field("field_22")).to eql("BK")
expect(service.column_for_field("field_26")).to eql("BZ")
expect(service.column_for_field("field_25")).to eql("S")
expect(service.column_for_field("field_5")).to eql("T")
expect(service.column_for_field("field_22")).to eql("BG")
expect(service.column_for_field("field_26")).to eql("BX")
expect(service.column_for_field("field_25")).to eql("F")
end
end
end

1089
spec/services/bulk_upload/lettings/year2026/row_parser_spec.rb
View File

File diff suppressed because it is too large Load Diff
Write Preview
Loading…
Cancel
Save